@exponential_app/eui 0.0.0-stage → 0.2.0

package/fixtures/host-router.json

@@ -0,0 +1,2034 @@
+{
+  "$comment": "VAPP-91: the host router (catalog/host.json ops): server messages in, ops out, in order. Inputs hand-written; `expected` filled by the generator from src/host/router.ts. A conformance runner creates ONE router per flow with `extensionIds`, installs `packages` (their install issues are `installIssues`), then routes every step's message and compares the ops. VAPP-122: `records` = validateRecord(packages[package].records[kind].schema, data) → issues; `acme.hours` declares two kinds, `acme.badrecords` every schema mistake. Keys of `records` and of every `properties` are written in sorted order: the Rust core iterates its maps sorted, so the issue order is the same on every platform. VAPP-161 (format version 2): `acme.v2` uses every new key validly (formatVersion, a records: binding, the records.* functions, the three tool transports, an empty extensions list); `acme.charts` declares an extension: not available under the default catalogs, installed by the VAPP-161 flow that registers it; `acme.v2broken` makes every tools / extensions / records-source mistake; `acme.future` is a newer format version; `acme.v1` is a version-1 package that stays valid.",
+  "packages": {
+    "acme.devices": {
+      "id": "acme.devices",
+      "name": "Devices",
+      "version": "1.0.0",
+      "catalogId": "https://ui.exponential.at/catalogs/core/v1",
+      "templates": {
+        "list": {
+          "components": [
+            {
+              "id": "root",
+              "component": "Column",
+              "children": [
+                "title"
+              ]
+            },
+            {
+              "id": "title",
+              "component": "Text",
+              "text": {
+                "path": "/title"
+              }
+            }
+          ],
+          "data": {
+            "title": "Devices",
+            "filter": "all"
+          },
+          "bindings": [
+            {
+              "path": "/devices",
+              "source": "exp:devices"
+            }
+          ]
+        }
+      },
+      "functions": [
+        "harness.toast"
+      ]
+    },
+    "broken": {
+      "id": "broken",
+      "name": "",
+      "version": "1",
+      "catalogId": "https://other.example/v9",
+      "templates": {
+        "t": {
+          "components": [
+            {
+              "id": "a",
+              "component": "Text"
+            },
+            {
+              "id": "a",
+              "component": "Text"
+            },
+            {
+              "component": "Text"
+            }
+          ],
+          "bindings": [
+            {
+              "path": "no-slash",
+              "source": "nope"
+            }
+          ]
+        }
+      },
+      "functions": [
+        "",
+        3
+      ],
+      "sources": [
+        "",
+        3
+      ]
+    },
+    "acme.scoped": {
+      "id": "acme.scoped",
+      "name": "Scoped",
+      "version": "1.0.0",
+      "catalogId": "https://ui.exponential.at/catalogs/core/v1",
+      "templates": {
+        "list": {
+          "components": [
+            {
+              "id": "root",
+              "component": "Text",
+              "text": {
+                "path": "/devices/count"
+              }
+            }
+          ],
+          "bindings": [
+            {
+              "path": "/devices",
+              "source": "exp:devices"
+            }
+          ]
+        }
+      },
+      "functions": [
+        "harness.toast"
+      ],
+      "sources": [
+        "exp:devices",
+        "acme.*"
+      ]
+    },
+    "acme.leaky": {
+      "id": "acme.leaky",
+      "name": "Leaky",
+      "version": "1.0.0",
+      "catalogId": "https://ui.exponential.at/catalogs/core/v1",
+      "templates": {
+        "list": {
+          "components": [
+            {
+              "id": "root",
+              "component": "Text"
+            }
+          ],
+          "bindings": [
+            {
+              "path": "/devices",
+              "source": "exp:devices"
+            },
+            {
+              "path": "/issues",
+              "source": "EXP:issues?board=b1"
+            }
+          ]
+        }
+      },
+      "sources": [
+        "exp:devices"
+      ]
+    },
+    "acme.hours": {
+      "id": "acme.hours",
+      "name": "Working hours",
+      "version": "1.0.0",
+      "catalogId": "https://ui.exponential.at/catalogs/core/v1",
+      "templates": {
+        "month": {
+          "components": [
+            {
+              "id": "root",
+              "component": "Column",
+              "children": [
+                "title"
+              ]
+            },
+            {
+              "id": "title",
+              "component": "Text",
+              "text": {
+                "path": "/entries/month/label"
+              }
+            }
+          ],
+          "data": {
+            "entries": {
+              "rows": [],
+              "count": 0
+            }
+          },
+          "bindings": [
+            {
+              "path": "/entries",
+              "source": "exp:records?kind=entry&mine=1&by=date&sum=hours"
+            }
+          ]
+        }
+      },
+      "functions": [
+        "harness.records.*",
+        "bind"
+      ],
+      "sources": [
+        "exp:records"
+      ],
+      "records": {
+        "entry": {
+          "title": "Hours entry",
+          "schema": {
+            "type": "object",
+            "properties": {
+              "date": {
+                "type": "string",
+                "format": "date"
+              },
+              "hours": {
+                "type": "number",
+                "minimum": 0,
+                "maximum": 24
+              },
+              "issues": {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                },
+                "maxLength": 20
+              },
+              "kind": {
+                "type": "string",
+                "enum": [
+                  "work",
+                  "meeting",
+                  "support"
+                ]
+              },
+              "note": {
+                "type": "string",
+                "maxLength": 500
+              }
+            },
+            "required": [
+              "date",
+              "hours"
+            ]
+          }
+        },
+        "target": {
+          "schema": {
+            "type": "object",
+            "properties": {
+              "hours": {
+                "type": "integer",
+                "minimum": 0
+              },
+              "month": {
+                "type": "string"
+              }
+            },
+            "required": [
+              "month",
+              "hours"
+            ],
+            "additionalProperties": true
+          }
+        }
+      }
+    },
+    "acme.badrecords": {
+      "id": "acme.badrecords",
+      "name": "Bad records",
+      "version": "1.0.0",
+      "catalogId": "https://ui.exponential.at/catalogs/core/v1",
+      "templates": {
+        "t": {
+          "components": [
+            {
+              "id": "root",
+              "component": "Column"
+            }
+          ]
+        }
+      },
+      "records": {
+        "Entry": {
+          "schema": {
+            "type": "object",
+            "properties": {
+              "id": {
+                "type": "string"
+              },
+              "mood": {
+                "type": "number",
+                "enum": [
+                  "a"
+                ]
+              },
+              "name": {
+                "type": "string",
+                "items": {
+                  "type": "string"
+                },
+                "format": "email"
+              },
+              "size": {
+                "type": "number",
+                "maximum": "big"
+              },
+              "tags": {
+                "type": "array"
+              },
+              "when": {
+                "type": "datetime"
+              }
+            },
+            "required": [
+              "name",
+              "missing"
+            ],
+            "additionalProperties": "no"
+          }
+        },
+        "list": "nope",
+        "ok_kind": {
+          "title": "No schema"
+        }
+      }
+    },
+    "acme.v2": {
+      "formatVersion": 2,
+      "id": "acme.v2",
+      "name": "Hours v2",
+      "version": "2.0.0",
+      "catalogId": "https://ui.exponential.at/catalogs/core/v1",
+      "templates": {
+        "list": {
+          "components": [
+            {
+              "id": "root",
+              "component": "Text",
+              "text": {
+                "path": "/entries/count"
+              }
+            }
+          ],
+          "bindings": [
+            {
+              "path": "/entries",
+              "source": "records:entry?mine=1&sort=date"
+            }
+          ]
+        }
+      },
+      "functions": [
+        "records.*",
+        "tools.weather.*",
+        "tools.lint",
+        "tools.files.read"
+      ],
+      "sources": [
+        "records:*"
+      ],
+      "records": {
+        "entry": {
+          "schema": {
+            "type": "object",
+            "properties": {
+              "date": {
+                "type": "string",
+                "format": "date"
+              },
+              "hours": {
+                "type": "number"
+              }
+            },
+            "required": [
+              "date"
+            ]
+          }
+        }
+      },
+      "tools": {
+        "files": {
+          "kind": "mcp",
+          "title": "Files",
+          "command": "npx",
+          "args": [
+            "-y",
+            "@modelcontextprotocol/server-filesystem",
+            "/tmp/my notes"
+          ]
+        },
+        "lint": {
+          "kind": "script",
+          "title": "Lint",
+          "description": "Checks an entry",
+          "command": "bun",
+          "args": [
+            "lint.ts"
+          ],
+          "env": [
+            "LINT_LEVEL"
+          ]
+        },
+        "weather": {
+          "kind": "mcp",
+          "title": "Weather",
+          "url": "https://mcp.example.com/weather"
+        }
+      },
+      "extensions": []
+    },
+    "acme.v2broken": {
+      "formatVersion": 0,
+      "id": "acme.v2broken",
+      "name": "Broken v2",
+      "version": "1",
+      "catalogId": "https://ui.exponential.at/catalogs/core/v1",
+      "templates": {
+        "t": {
+          "components": [
+            {
+              "id": "root",
+              "component": "Text"
+            }
+          ],
+          "bindings": [
+            {
+              "path": "/a",
+              "source": "records:missing"
+            },
+            {
+              "path": "/b",
+              "source": "records:entry"
+            }
+          ]
+        }
+      },
+      "records": {
+        "entry": {
+          "schema": {
+            "type": "object",
+            "properties": {
+              "n": {
+                "type": "number"
+              }
+            }
+          }
+        }
+      },
+      "tools": {
+        "Bad": {
+          "kind": "mcp",
+          "title": "x",
+          "url": "https://a.example"
+        },
+        "both": {
+          "kind": "mcp",
+          "title": "Both",
+          "url": "https://a.example",
+          "command": "x"
+        },
+        "neither": {
+          "kind": "mcp",
+          "title": "Neither"
+        },
+        "notool": 3,
+        "rel": {
+          "kind": "mcp",
+          "title": "Relative",
+          "url": "/mcp",
+          "args": [
+            "a"
+          ]
+        },
+        "script": {
+          "kind": "script",
+          "title": "",
+          "url": "https://a.example",
+          "env": [
+            "OK",
+            "1BAD"
+          ]
+        },
+        "weird": {
+          "kind": "plugin",
+          "title": "Weird",
+          "description": 5,
+          "command": "  ",
+          "args": "a b"
+        }
+      },
+      "extensions": [
+        {
+          "id": "https://acme.example/catalogs/charts/v1",
+          "version": "1.0"
+        },
+        {
+          "id": "",
+          "version": "1.0.0",
+          "components": [
+            "Gantt",
+            ""
+          ]
+        },
+        {
+          "id": "https://ui.exponential.at/catalogs/core/v1",
+          "version": "1.0.0"
+        },
+        {
+          "id": "https://ui.exponential.at/catalogs/core/v1",
+          "version": "1.0.0"
+        },
+        "nope"
+      ]
+    },
+    "acme.future": {
+      "formatVersion": 3,
+      "id": "acme.future",
+      "name": "Future",
+      "version": "1.0.0",
+      "catalogId": "https://ui.exponential.at/catalogs/core/v1",
+      "templates": {
+        "t": {
+          "components": [
+            {
+              "id": "root",
+              "component": "Text",
+              "text": "Hi"
+            }
+          ]
+        }
+      }
+    },
+    "acme.v1": {
+      "id": "acme.v1",
+      "name": "Plain",
+      "version": "1.0.0",
+      "catalogId": "https://ui.exponential.at/catalogs/core/v1",
+      "templates": {
+        "t": {
+          "components": [
+            {
+              "id": "root",
+              "component": "Text",
+              "text": "Hi"
+            }
+          ]
+        }
+      },
+      "functions": [
+        "harness.toast"
+      ]
+    },
+    "acme.charts": {
+      "formatVersion": 2,
+      "id": "acme.charts",
+      "name": "Charts",
+      "version": "1.0.0",
+      "catalogId": "https://ui.exponential.at/catalogs/core/v1",
+      "templates": {
+        "t": {
+          "components": [
+            {
+              "id": "root",
+              "component": "Text",
+              "text": "Hi"
+            }
+          ]
+        }
+      },
+      "extensions": [
+        {
+          "id": "https://acme.example/catalogs/charts/v1",
+          "version": "1.4.0",
+          "components": [
+            "Gantt"
+          ]
+        }
+      ]
+    }
+  },
+  "flows": [
+    {
+      "name": "the A2UI lifecycle",
+      "steps": [
+        {
+          "message": {
+            "version": "v0.9",
+            "createSurface": {
+              "surfaceId": "s1",
+              "catalogId": "https://ui.exponential.at/catalogs/core/v1"
+            }
+          },
+          "expected": [
+            {
+              "op": "create",
+              "surfaceId": "s1",
+              "catalogId": "https://ui.exponential.at/catalogs/core/v1"
+            }
+          ]
+        },
+        {
+          "message": {
+            "version": "v0.9",
+            "updateComponents": {
+              "surfaceId": "s1",
+              "components": [
+                {
+                  "id": "root",
+                  "component": "Text",
+                  "text": "Hi"
+                }
+              ]
+            }
+          },
+          "expected": [
+            {
+              "op": "components",
+              "surfaceId": "s1",
+              "components": [
+                {
+                  "id": "root",
+                  "component": "Text",
+                  "text": "Hi"
+                }
+              ]
+            }
+          ]
+        },
+        {
+          "message": {
+            "version": "v0.9",
+            "updateDataModel": {
+              "surfaceId": "s1",
+              "path": "/user/name",
+              "value": "Ada"
+            }
+          },
+          "expected": [
+            {
+              "op": "data",
+              "surfaceId": "s1",
+              "path": "/user/name",
+              "value": "Ada"
+            }
+          ]
+        },
+        {
+          "message": {
+            "version": "v0.9",
+            "updateDataModel": {
+              "surfaceId": "s1",
+              "path": "/user/name"
+            }
+          },
+          "expected": [
+            {
+              "op": "data",
+              "surfaceId": "s1",
+              "path": "/user/name"
+            }
+          ]
+        },
+        {
+          "message": {
+            "version": "v0.9",
+            "updateDataModel": {
+              "surfaceId": "s1",
+              "value": {
+                "a": 1
+              }
+            }
+          },
+          "expected": [
+            {
+              "op": "data",
+              "surfaceId": "s1",
+              "path": "",
+              "value": {
+                "a": 1
+              }
+            }
+          ]
+        },
+        {
+          "message": {
+            "version": "v0.9",
+            "updateDataModel": {
+              "surfaceId": "s1",
+              "path": "/",
+              "value": {
+                "b": 2
+              }
+            }
+          },
+          "expected": [
+            {
+              "op": "data",
+              "surfaceId": "s1",
+              "path": "",
+              "value": {
+                "b": 2
+              }
+            }
+          ]
+        },
+        {
+          "message": {
+            "version": "v0.9",
+            "deleteSurface": {
+              "surfaceId": "s1"
+            }
+          },
+          "expected": [
+            {
+              "op": "delete",
+              "surfaceId": "s1"
+            }
+          ]
+        },
+        {
+          "message": {
+            "version": "v0.9",
+            "deleteSurface": {
+              "surfaceId": "s1"
+            }
+          },
+          "expected": [
+            {
+              "op": "send",
+              "message": {
+                "version": "v0.9",
+                "error": {
+                  "code": "SURFACE_NOT_FOUND",
+                  "surfaceId": "s1",
+                  "message": "no surface s1; send createSurface first"
+                }
+              }
+            }
+          ]
+        }
+      ]
+    },
+    {
+      "name": "createSurface keeps theme and sendDataModel",
+      "steps": [
+        {
+          "message": {
+            "version": "v0.9",
+            "createSurface": {
+              "surfaceId": "s2",
+              "catalogId": "https://ui.exponential.at/catalogs/core/v1",
+              "theme": {
+                "primaryColor": "#ff0000"
+              },
+              "sendDataModel": true
+            }
+          },
+          "expected": [
+            {
+              "op": "create",
+              "surfaceId": "s2",
+              "catalogId": "https://ui.exponential.at/catalogs/core/v1",
+              "theme": {
+                "primaryColor": "#ff0000"
+              },
+              "sendDataModel": true
+            }
+          ]
+        },
+        {
+          "message": {
+            "createSurface": {
+              "surfaceId": "s3",
+              "catalogId": "https://a2ui.org/specification/v0_9/basic_catalog.json",
+              "sendDataModel": false
+            }
+          },
+          "expected": [
+            {
+              "op": "create",
+              "surfaceId": "s3",
+              "catalogId": "https://a2ui.org/specification/v0_9/basic_catalog.json"
+            }
+          ]
+        }
+      ]
+    },
+    {
+      "name": "errors",
+      "steps": [
+        {
+          "message": {
+            "version": "v0.9",
+            "updateComponents": {
+              "surfaceId": "ghost",
+              "components": [
+                {
+                  "id": "root",
+                  "component": "Text",
+                  "text": "Hi"
+                }
+              ]
+            }
+          },
+          "expected": [
+            {
+              "op": "send",
+              "message": {
+                "version": "v0.9",
+                "error": {
+                  "code": "SURFACE_NOT_FOUND",
+                  "surfaceId": "ghost",
+                  "message": "no surface ghost; send createSurface first"
+                }
+              }
+            }
+          ]
+        },
+        {
+          "message": {
+            "version": "v0.9",
+            "updateDataModel": {
+              "surfaceId": "ghost",
+              "value": 1
+            }
+          },
+          "expected": [
+            {
+              "op": "send",
+              "message": {
+                "version": "v0.9",
+                "error": {
+                  "code": "SURFACE_NOT_FOUND",
+                  "surfaceId": "ghost",
+                  "message": "no surface ghost; send createSurface first"
+                }
+              }
+            }
+          ]
+        },
+        {
+          "message": {
+            "version": "v0.9",
+            "createSurface": {
+              "surfaceId": "s1",
+              "catalogId": "https://ui.exponential.at/catalogs/core/v2"
+            }
+          },
+          "expected": [
+            {
+              "op": "send",
+              "message": {
+                "version": "v0.9",
+                "error": {
+                  "code": "UNSUPPORTED_CATALOG",
+                  "surfaceId": "s1",
+                  "message": "catalog https://ui.exponential.at/catalogs/core/v2 is not supported"
+                }
+              }
+            }
+          ]
+        },
+        {
+          "message": {
+            "version": "v0.8",
+            "createSurface": {
+              "surfaceId": "s1",
+              "catalogId": "https://ui.exponential.at/catalogs/core/v1"
+            }
+          },
+          "expected": [
+            {
+              "op": "send",
+              "message": {
+                "version": "v0.9",
+                "error": {
+                  "code": "INVALID_MESSAGE",
+                  "surfaceId": "s1",
+                  "message": "unsupported version v0.8"
+                }
+              }
+            }
+          ]
+        },
+        {
+          "message": {
+            "version": "v0.9"
+          },
+          "expected": [
+            {
+              "op": "send",
+              "message": {
+                "version": "v0.9",
+                "error": {
+                  "code": "INVALID_MESSAGE",
+                  "surfaceId": "",
+                  "message": "expected exactly one of createSurface, updateComponents, updateDataModel, deleteSurface, applyTemplate, bindDataModel"
+                }
+              }
+            }
+          ]
+        },
+        {
+          "message": {
+            "version": "v0.9",
+            "createSurface": {
+              "surfaceId": "s1",
+              "catalogId": "https://ui.exponential.at/catalogs/core/v1"
+            },
+            "deleteSurface": {
+              "surfaceId": "s1"
+            }
+          },
+          "expected": [
+            {
+              "op": "send",
+              "message": {
+                "version": "v0.9",
+                "error": {
+                  "code": "INVALID_MESSAGE",
+                  "surfaceId": "s1",
+                  "message": "expected exactly one of createSurface, updateComponents, updateDataModel, deleteSurface, applyTemplate, bindDataModel"
+                }
+              }
+            }
+          ]
+        },
+        {
+          "message": {
+            "version": "v0.9",
+            "beginRendering": {
+              "surfaceId": "s1"
+            }
+          },
+          "expected": [
+            {
+              "op": "send",
+              "message": {
+                "version": "v0.9",
+                "error": {
+                  "code": "INVALID_MESSAGE",
+                  "surfaceId": "s1",
+                  "message": "expected exactly one of createSurface, updateComponents, updateDataModel, deleteSurface, applyTemplate, bindDataModel"
+                }
+              }
+            }
+          ]
+        },
+        {
+          "message": {
+            "version": "v0.9",
+            "createSurface": {
+              "catalogId": "https://ui.exponential.at/catalogs/core/v1"
+            }
+          },
+          "expected": [
+            {
+              "op": "send",
+              "message": {
+                "version": "v0.9",
+                "error": {
+                  "code": "INVALID_MESSAGE",
+                  "surfaceId": "",
+                  "message": "createSurface.surfaceId is required"
+                }
+              }
+            }
+          ]
+        },
+        {
+          "message": [
+            1,
+            2
+          ],
+          "expected": [
+            {
+              "op": "send",
+              "message": {
+                "version": "v0.9",
+                "error": {
+                  "code": "INVALID_MESSAGE",
+                  "surfaceId": "",
+                  "message": "a message is a JSON object"
+                }
+              }
+            }
+          ]
+        },
+        {
+          "message": {
+            "version": "v0.9",
+            "createSurface": {
+              "surfaceId": "s1",
+              "catalogId": "https://ui.exponential.at/catalogs/core/v1"
+            }
+          },
+          "expected": [
+            {
+              "op": "create",
+              "surfaceId": "s1",
+              "catalogId": "https://ui.exponential.at/catalogs/core/v1"
+            }
+          ]
+        },
+        {
+          "message": {
+            "version": "v0.9",
+            "updateComponents": {
+              "surfaceId": "s1"
+            }
+          },
+          "expected": [
+            {
+              "op": "send",
+              "message": {
+                "version": "v0.9",
+                "error": {
+                  "code": "INVALID_MESSAGE",
+                  "surfaceId": "s1",
+                  "message": "updateComponents.components is required"
+                }
+              }
+            }
+          ]
+        },
+        {
+          "message": {
+            "version": "v0.9",
+            "updateDataModel": {
+              "surfaceId": "s1",
+              "path": 3
+            }
+          },
+          "expected": [
+            {
+              "op": "send",
+              "message": {
+                "version": "v0.9",
+                "error": {
+                  "code": "INVALID_MESSAGE",
+                  "surfaceId": "s1",
+                  "message": "updateDataModel.path is a string"
+                }
+              }
+            }
+          ]
+        }
+      ]
+    },
+    {
+      "name": "extension catalogs negotiate",
+      "extensionIds": [
+        "https://acme.example/catalog/v1"
+      ],
+      "steps": [
+        {
+          "message": {
+            "version": "v0.9",
+            "createSurface": {
+              "surfaceId": "x",
+              "catalogId": "https://acme.example/catalog/v1"
+            }
+          },
+          "expected": [
+            {
+              "op": "create",
+              "surfaceId": "x",
+              "catalogId": "https://acme.example/catalog/v1"
+            }
+          ]
+        },
+        {
+          "message": {
+            "version": "v0.9",
+            "createSurface": {
+              "surfaceId": "y",
+              "catalogId": "https://other.example/catalog/v1"
+            }
+          },
+          "expected": [
+            {
+              "op": "send",
+              "message": {
+                "version": "v0.9",
+                "error": {
+                  "code": "UNSUPPORTED_CATALOG",
+                  "surfaceId": "y",
+                  "message": "catalog https://other.example/catalog/v1 is not supported"
+                }
+              }
+            }
+          ]
+        }
+      ]
+    },
+    {
+      "name": "bindDataModel",
+      "steps": [
+        {
+          "message": {
+            "version": "v0.9",
+            "createSurface": {
+              "surfaceId": "s1",
+              "catalogId": "https://ui.exponential.at/catalogs/core/v1"
+            }
+          },
+          "expected": [
+            {
+              "op": "create",
+              "surfaceId": "s1",
+              "catalogId": "https://ui.exponential.at/catalogs/core/v1"
+            }
+          ]
+        },
+        {
+          "message": {
+            "version": "v0.9",
+            "bindDataModel": {
+              "surfaceId": "s1",
+              "path": "/devices",
+              "source": "exp:devices?team=t1"
+            }
+          },
+          "expected": [
+            {
+              "op": "bind",
+              "surfaceId": "s1",
+              "path": "/devices",
+              "source": "exp:devices?team=t1"
+            }
+          ]
+        },
+        {
+          "message": {
+            "version": "v0.9",
+            "bindDataModel": {
+              "surfaceId": "s1",
+              "path": "/x",
+              "source": "not a source"
+            }
+          },
+          "expected": [
+            {
+              "op": "send",
+              "message": {
+                "version": "v0.9",
+                "error": {
+                  "code": "INVALID_MESSAGE",
+                  "surfaceId": "s1",
+                  "message": "bindDataModel needs a path and a scheme:name source"
+                }
+              }
+            }
+          ]
+        },
+        {
+          "message": {
+            "version": "v0.9",
+            "bindDataModel": {
+              "surfaceId": "nope",
+              "path": "/x",
+              "source": "exp:devices"
+            }
+          },
+          "expected": [
+            {
+              "op": "send",
+              "message": {
+                "version": "v0.9",
+                "error": {
+                  "code": "SURFACE_NOT_FOUND",
+                  "surfaceId": "nope",
+                  "message": "no surface nope; send createSurface first"
+                }
+              }
+            }
+          ]
+        }
+      ]
+    },
+    {
+      "name": "applyTemplate",
+      "packages": [
+        "acme.devices",
+        "broken"
+      ],
+      "installIssues": {
+        "acme.devices": [],
+        "broken": [
+          {
+            "path": "/name",
+            "message": "name is a required string"
+          },
+          {
+            "path": "/catalogId",
+            "message": "unsupported catalog https://other.example/v9"
+          },
+          {
+            "path": "/templates/t/components/1/id",
+            "message": "duplicate id a"
+          },
+          {
+            "path": "/templates/t/components/2",
+            "message": "a component needs an id and a component"
+          },
+          {
+            "path": "/templates/t/components",
+            "message": "no component has the id root"
+          },
+          {
+            "path": "/templates/t/bindings/0/path",
+            "message": "path is a JSON pointer"
+          },
+          {
+            "path": "/templates/t/bindings/0/source",
+            "message": "source is a scheme:name URI"
+          },
+          {
+            "path": "/functions",
+            "message": "functions is a list of names or prefix* patterns"
+          },
+          {
+            "path": "/sources",
+            "message": "sources is a list of scheme:name sources or prefix* patterns"
+          }
+        ]
+      },
+      "steps": [
+        {
+          "message": {
+            "version": "v0.9",
+            "applyTemplate": {
+              "surfaceId": "d1",
+              "templateId": "list",
+              "data": {
+                "filter": "online"
+              }
+            }
+          },
+          "expected": [
+            {
+              "op": "create",
+              "surfaceId": "d1",
+              "catalogId": "https://ui.exponential.at/catalogs/core/v1"
+            },
+            {
+              "op": "components",
+              "surfaceId": "d1",
+              "components": [
+                {
+                  "id": "root",
+                  "component": "Column",
+                  "children": [
+                    "title"
+                  ]
+                },
+                {
+                  "id": "title",
+                  "component": "Text",
+                  "text": {
+                    "path": "/title"
+                  }
+                }
+              ]
+            },
+            {
+              "op": "data",
+              "surfaceId": "d1",
+              "path": "",
+              "value": {
+                "title": "Devices",
+                "filter": "online"
+              }
+            },
+            {
+              "op": "bind",
+              "surfaceId": "d1",
+              "path": "/devices",
+              "source": "exp:devices"
+            }
+          ]
+        },
+        {
+          "message": {
+            "version": "v0.9",
+            "applyTemplate": {
+              "surfaceId": "d2",
+              "templateId": "list",
+              "packageId": "acme.devices"
+            }
+          },
+          "expected": [
+            {
+              "op": "create",
+              "surfaceId": "d2",
+              "catalogId": "https://ui.exponential.at/catalogs/core/v1"
+            },
+            {
+              "op": "components",
+              "surfaceId": "d2",
+              "components": [
+                {
+                  "id": "root",
+                  "component": "Column",
+                  "children": [
+                    "title"
+                  ]
+                },
+                {
+                  "id": "title",
+                  "component": "Text",
+                  "text": {
+                    "path": "/title"
+                  }
+                }
+              ]
+            },
+            {
+              "op": "data",
+              "surfaceId": "d2",
+              "path": "",
+              "value": {
+                "title": "Devices",
+                "filter": "all"
+              }
+            },
+            {
+              "op": "bind",
+              "surfaceId": "d2",
+              "path": "/devices",
+              "source": "exp:devices"
+            }
+          ]
+        },
+        {
+          "message": {
+            "version": "v0.9",
+            "applyTemplate": {
+              "surfaceId": "d3",
+              "templateId": "missing"
+            }
+          },
+          "expected": [
+            {
+              "op": "send",
+              "message": {
+                "version": "v0.9",
+                "error": {
+                  "code": "TEMPLATE_NOT_FOUND",
+                  "surfaceId": "d3",
+                  "message": "no installed package has the template missing"
+                }
+              }
+            }
+          ]
+        },
+        {
+          "message": {
+            "version": "v0.9",
+            "applyTemplate": {
+              "surfaceId": "d4",
+              "templateId": "t",
+              "packageId": "broken"
+            }
+          },
+          "expected": [
+            {
+              "op": "send",
+              "message": {
+                "version": "v0.9",
+                "error": {
+                  "code": "TEMPLATE_NOT_FOUND",
+                  "surfaceId": "d4",
+                  "message": "no installed package has the template t"
+                }
+              }
+            }
+          ]
+        }
+      ]
+    },
+    {
+      "name": "VAPP-107: a package surface follows only its listed sources",
+      "packages": [
+        "acme.scoped",
+        "acme.leaky"
+      ],
+      "installIssues": {
+        "acme.scoped": [],
+        "acme.leaky": [
+          {
+            "path": "/templates/list/bindings/1/source",
+            "message": "source EXP:issues?board=b1 is not in the package's sources"
+          }
+        ]
+      },
+      "steps": [
+        {
+          "message": {
+            "version": "v0.9",
+            "applyTemplate": {
+              "surfaceId": "s",
+              "templateId": "list",
+              "packageId": "acme.scoped"
+            }
+          },
+          "expected": [
+            {
+              "op": "create",
+              "surfaceId": "s",
+              "catalogId": "https://ui.exponential.at/catalogs/core/v1"
+            },
+            {
+              "op": "components",
+              "surfaceId": "s",
+              "components": [
+                {
+                  "id": "root",
+                  "component": "Text",
+                  "text": {
+                    "path": "/devices/count"
+                  }
+                }
+              ]
+            },
+            {
+              "op": "bind",
+              "surfaceId": "s",
+              "path": "/devices",
+              "source": "exp:devices"
+            }
+          ]
+        },
+        {
+          "message": {
+            "version": "v0.9",
+            "bindDataModel": {
+              "surfaceId": "s",
+              "path": "/issues",
+              "source": "exp:issues?board=b1"
+            }
+          },
+          "expected": [
+            {
+              "op": "send",
+              "message": {
+                "version": "v0.9",
+                "error": {
+                  "code": "SOURCE_DENIED",
+                  "surfaceId": "s",
+                  "message": "source exp:issues?board=b1 is not in package acme.scoped's sources",
+                  "path": "/issues"
+                }
+              }
+            }
+          ]
+        },
+        {
+          "message": {
+            "version": "v0.9",
+            "bindDataModel": {
+              "surfaceId": "s",
+              "path": "/devices",
+              "source": "EXP:devices?limit=5"
+            }
+          },
+          "expected": [
+            {
+              "op": "bind",
+              "surfaceId": "s",
+              "path": "/devices",
+              "source": "EXP:devices?limit=5"
+            }
+          ]
+        },
+        {
+          "message": {
+            "version": "v0.9",
+            "bindDataModel": {
+              "surfaceId": "s",
+              "path": "/extra",
+              "source": "acme.data:list/items"
+            }
+          },
+          "expected": [
+            {
+              "op": "bind",
+              "surfaceId": "s",
+              "path": "/extra",
+              "source": "acme.data:list/items"
+            }
+          ]
+        },
+        {
+          "message": {
+            "version": "v0.9",
+            "createSurface": {
+              "surfaceId": "free",
+              "catalogId": "https://ui.exponential.at/catalogs/core/v1"
+            }
+          },
+          "expected": [
+            {
+              "op": "create",
+              "surfaceId": "free",
+              "catalogId": "https://ui.exponential.at/catalogs/core/v1"
+            }
+          ]
+        },
+        {
+          "message": {
+            "version": "v0.9",
+            "bindDataModel": {
+              "surfaceId": "free",
+              "path": "/issues",
+              "source": "exp:issues"
+            }
+          },
+          "expected": [
+            {
+              "op": "bind",
+              "surfaceId": "free",
+              "path": "/issues",
+              "source": "exp:issues"
+            }
+          ]
+        }
+      ]
+    },
+    {
+      "name": "VAPP-122: the bind action re-follows a path through the package's allowlist",
+      "packages": [
+        "acme.hours"
+      ],
+      "installIssues": {
+        "acme.hours": []
+      },
+      "steps": [
+        {
+          "message": {
+            "version": "v0.9",
+            "applyTemplate": {
+              "surfaceId": "h",
+              "templateId": "month"
+            }
+          },
+          "expected": [
+            {
+              "op": "create",
+              "surfaceId": "h",
+              "catalogId": "https://ui.exponential.at/catalogs/core/v1"
+            },
+            {
+              "op": "components",
+              "surfaceId": "h",
+              "components": [
+                {
+                  "id": "root",
+                  "component": "Column",
+                  "children": [
+                    "title"
+                  ]
+                },
+                {
+                  "id": "title",
+                  "component": "Text",
+                  "text": {
+                    "path": "/entries/month/label"
+                  }
+                }
+              ]
+            },
+            {
+              "op": "data",
+              "surfaceId": "h",
+              "path": "",
+              "value": {
+                "entries": {
+                  "rows": [],
+                  "count": 0
+                }
+              }
+            },
+            {
+              "op": "bind",
+              "surfaceId": "h",
+              "path": "/entries",
+              "source": "exp:records?kind=entry&mine=1&by=date&sum=hours"
+            }
+          ]
+        },
+        {
+          "message": {
+            "version": "v0.9",
+            "bindDataModel": {
+              "surfaceId": "h",
+              "path": "/entries",
+              "source": "exp:records?kind=entry&mine=1&by=date&sum=hours&month=2026-09"
+            }
+          },
+          "expected": [
+            {
+              "op": "bind",
+              "surfaceId": "h",
+              "path": "/entries",
+              "source": "exp:records?kind=entry&mine=1&by=date&sum=hours&month=2026-09"
+            }
+          ]
+        },
+        {
+          "message": {
+            "version": "v0.9",
+            "bindDataModel": {
+              "surfaceId": "h",
+              "path": "/entries",
+              "source": "exp:issues?board=b1"
+            }
+          },
+          "expected": [
+            {
+              "op": "send",
+              "message": {
+                "version": "v0.9",
+                "error": {
+                  "code": "SOURCE_DENIED",
+                  "surfaceId": "h",
+                  "message": "source exp:issues?board=b1 is not in package acme.hours's sources",
+                  "path": "/entries"
+                }
+              }
+            }
+          ]
+        }
+      ]
+    },
+    {
+      "name": "VAPP-161: a version-2 package with a registered extension installs; a newer format does not",
+      "extensionIds": [
+        "https://acme.example/catalogs/charts/v1"
+      ],
+      "packages": [
+        "acme.v2",
+        "acme.charts",
+        "acme.future",
+        "acme.v1"
+      ],
+      "installIssues": {
+        "acme.v2": [],
+        "acme.charts": [],
+        "acme.future": [
+          {
+            "path": "/formatVersion",
+            "message": "format version 3 is newer than this host (2)"
+          }
+        ],
+        "acme.v1": []
+      },
+      "steps": [
+        {
+          "message": {
+            "version": "v0.9",
+            "applyTemplate": {
+              "surfaceId": "h",
+              "packageId": "acme.v2",
+              "templateId": "list"
+            }
+          },
+          "expected": [
+            {
+              "op": "create",
+              "surfaceId": "h",
+              "catalogId": "https://ui.exponential.at/catalogs/core/v1"
+            },
+            {
+              "op": "components",
+              "surfaceId": "h",
+              "components": [
+                {
+                  "id": "root",
+                  "component": "Text",
+                  "text": {
+                    "path": "/entries/count"
+                  }
+                }
+              ]
+            },
+            {
+              "op": "bind",
+              "surfaceId": "h",
+              "path": "/entries",
+              "source": "records:entry?mine=1&sort=date"
+            }
+          ]
+        }
+      ]
+    }
+  ],
+  "validation": [
+    {
+      "package": "acme.devices",
+      "expected": []
+    },
+    {
+      "package": "broken",
+      "expected": [
+        {
+          "path": "/name",
+          "message": "name is a required string"
+        },
+        {
+          "path": "/catalogId",
+          "message": "unsupported catalog https://other.example/v9"
+        },
+        {
+          "path": "/templates/t/components/1/id",
+          "message": "duplicate id a"
+        },
+        {
+          "path": "/templates/t/components/2",
+          "message": "a component needs an id and a component"
+        },
+        {
+          "path": "/templates/t/components",
+          "message": "no component has the id root"
+        },
+        {
+          "path": "/templates/t/bindings/0/path",
+          "message": "path is a JSON pointer"
+        },
+        {
+          "path": "/templates/t/bindings/0/source",
+          "message": "source is a scheme:name URI"
+        },
+        {
+          "path": "/functions",
+          "message": "functions is a list of names or prefix* patterns"
+        },
+        {
+          "path": "/sources",
+          "message": "sources is a list of scheme:name sources or prefix* patterns"
+        }
+      ]
+    },
+    {
+      "package": "acme.scoped",
+      "expected": []
+    },
+    {
+      "package": "acme.leaky",
+      "expected": [
+        {
+          "path": "/templates/list/bindings/1/source",
+          "message": "source EXP:issues?board=b1 is not in the package's sources"
+        }
+      ]
+    },
+    {
+      "package": "acme.hours",
+      "expected": []
+    },
+    {
+      "package": "acme.badrecords",
+      "expected": [
+        {
+          "path": "/records/Entry",
+          "message": "a kind is lowercase letters, digits and underscores"
+        },
+        {
+          "path": "/records/Entry/schema/properties/id",
+          "message": "id is a reserved record key"
+        },
+        {
+          "path": "/records/Entry/schema/properties/mood/enum",
+          "message": "enum is a non-empty list of strings on a string field"
+        },
+        {
+          "path": "/records/Entry/schema/properties/name/items",
+          "message": "items belongs to an array field"
+        },
+        {
+          "path": "/records/Entry/schema/properties/name/format",
+          "message": "format is date|date-time|time on a string field"
+        },
+        {
+          "path": "/records/Entry/schema/properties/size/maximum",
+          "message": "maximum is a number"
+        },
+        {
+          "path": "/records/Entry/schema/properties/tags/items",
+          "message": "items is {type: string|number|integer|boolean}"
+        },
+        {
+          "path": "/records/Entry/schema/properties/when",
+          "message": "a field is {type: string|number|integer|boolean|array}"
+        },
+        {
+          "path": "/records/Entry/schema/required/1",
+          "message": "missing is not a declared field"
+        },
+        {
+          "path": "/records/Entry/schema/additionalProperties",
+          "message": "additionalProperties is a boolean"
+        },
+        {
+          "path": "/records/list",
+          "message": "a kind is {schema, title?}"
+        },
+        {
+          "path": "/records/ok_kind/schema",
+          "message": "a record schema is {type: \"object\", properties}"
+        }
+      ]
+    },
+    {
+      "package": "acme.v2",
+      "expected": []
+    },
+    {
+      "package": "acme.v2broken",
+      "expected": [
+        {
+          "path": "/formatVersion",
+          "message": "formatVersion is a positive integer"
+        },
+        {
+          "path": "/templates/t/bindings/0/source",
+          "message": "records:missing names no declared kind"
+        },
+        {
+          "path": "/tools/Bad",
+          "message": "a tool id is lowercase letters, digits, - and _"
+        },
+        {
+          "path": "/tools/both",
+          "message": "an mcp tool has a url or a command"
+        },
+        {
+          "path": "/tools/neither",
+          "message": "an mcp tool has a url or a command"
+        },
+        {
+          "path": "/tools/notool",
+          "message": "a tool is {kind, title, url | command}"
+        },
+        {
+          "path": "/tools/rel/url",
+          "message": "url is an absolute http(s) url"
+        },
+        {
+          "path": "/tools/rel/args",
+          "message": "args is a list of strings beside a command"
+        },
+        {
+          "path": "/tools/script/title",
+          "message": "title is a required string"
+        },
+        {
+          "path": "/tools/script/url",
+          "message": "a script runs a command, not a url"
+        },
+        {
+          "path": "/tools/script/command",
+          "message": "command is a non-empty string"
+        },
+        {
+          "path": "/tools/script/env",
+          "message": "env is a list of variable names beside a command"
+        },
+        {
+          "path": "/tools/weird/kind",
+          "message": "kind is mcp or script"
+        },
+        {
+          "path": "/tools/weird/description",
+          "message": "description is a string"
+        },
+        {
+          "path": "/tools/weird/command",
+          "message": "command is a non-empty string"
+        },
+        {
+          "path": "/tools/weird/args",
+          "message": "args is a list of strings beside a command"
+        },
+        {
+          "path": "/extensions/0/version",
+          "message": "version is MAJOR.MINOR.PATCH"
+        },
+        {
+          "path": "/extensions/0/id",
+          "message": "extension https://acme.example/catalogs/charts/v1 is not available on this host"
+        },
+        {
+          "path": "/extensions/1/id",
+          "message": "id is a required string"
+        },
+        {
+          "path": "/extensions/1/components",
+          "message": "components is a list of component names"
+        },
+        {
+          "path": "/extensions/3/id",
+          "message": "duplicate extension https://ui.exponential.at/catalogs/core/v1"
+        },
+        {
+          "path": "/extensions/4",
+          "message": "an extension is {id, version, components?}"
+        }
+      ]
+    },
+    {
+      "package": "acme.future",
+      "expected": [
+        {
+          "path": "/formatVersion",
+          "message": "format version 3 is newer than this host (2)"
+        }
+      ]
+    },
+    {
+      "package": "acme.v1",
+      "expected": []
+    },
+    {
+      "package": "acme.charts",
+      "expected": [
+        {
+          "path": "/extensions/0/id",
+          "message": "extension https://acme.example/catalogs/charts/v1 is not available on this host"
+        }
+      ]
+    }
+  ],
+  "records": [
+    {
+      "name": "a full entry passes",
+      "package": "acme.hours",
+      "kind": "entry",
+      "data": {
+        "date": "2026-10-05",
+        "hours": 3,
+        "note": "leaderboard, meet",
+        "issues": [
+          "MET-1437",
+          "MET-1440"
+        ],
+        "kind": "work"
+      },
+      "expected": []
+    },
+    {
+      "name": "the required fields alone pass; null clears an optional one",
+      "package": "acme.hours",
+      "kind": "entry",
+      "data": {
+        "date": "2026-10-05",
+        "hours": 0,
+        "note": null
+      },
+      "expected": []
+    },
+    {
+      "name": "every check fires",
+      "package": "acme.hours",
+      "kind": "entry",
+      "data": {
+        "date": "5.10.2026",
+        "hours": 25,
+        "note": "x",
+        "issues": [
+          "a",
+          2
+        ],
+        "kind": "play",
+        "extra": 1
+      },
+      "expected": [
+        {
+          "path": "/date",
+          "message": "a date (YYYY-MM-DD)"
+        },
+        {
+          "path": "/hours",
+          "message": "at most 24"
+        },
+        {
+          "path": "/issues/1",
+          "message": "a string"
+        },
+        {
+          "path": "/kind",
+          "message": "one of work|meeting|support"
+        },
+        {
+          "path": "/extra",
+          "message": "not in the schema"
+        }
+      ]
+    },
+    {
+      "name": "a required field missing, a wrong type",
+      "package": "acme.hours",
+      "kind": "entry",
+      "data": {
+        "hours": "3",
+        "issues": "MET-1"
+      },
+      "expected": [
+        {
+          "path": "/date",
+          "message": "required"
+        },
+        {
+          "path": "/hours",
+          "message": "a number"
+        },
+        {
+          "path": "/issues",
+          "message": "a list"
+        }
+      ]
+    },
+    {
+      "name": "not an object",
+      "package": "acme.hours",
+      "kind": "entry",
+      "data": [
+        1
+      ],
+      "expected": [
+        {
+          "path": "",
+          "message": "a record is an object"
+        }
+      ]
+    },
+    {
+      "name": "additionalProperties true keeps extra keys; an integer check",
+      "package": "acme.hours",
+      "kind": "target",
+      "data": {
+        "month": "2026-10",
+        "hours": 40.5,
+        "carry": 11.75
+      },
+      "expected": [
+        {
+          "path": "/hours",
+          "message": "an integer"
+        }
+      ]
+    }
+  ]
+}