@mhome/app-facade-protocol 1.62.0 → 1.64.0

package/README.md

@@ -73,7 +73,10 @@ App UI requests full and unwraps the envelope at its transport boundary. Agent
 and MCP public results use essential; internal workflow reads use full. The CLI
 uses `--response-detail full|essential`, and the bundled external Skill requests
 essential. Dashboard essential projection keeps card identity, title, type,
-layouts and view choices, excluding renderer configuration and resource payloads.
+view choices, excluding renderer configuration and resource payloads. Card list
+returns only ID/type/title; card detail essential omits layouts. Canvas layout get
+requires one sm/md/lg size and retains every card ID/title/layout in full and essential;
+uninitialized layouts or coordinates are null.
 Device brief-list essential retains identity, room, capability IDs, Integration and
 availability, omitting `connectId`, `manufacturerId` and `manufacturerName`.
 Selected Device detail, history, recent activity and mutation outcomes keep their
@@ -96,6 +99,10 @@ asset manifests and renderer configuration schemas. Selected release detail keep
 Revisions, installation IDs, existing override config and supported patterns remain.
 Empty mutation acknowledgements remain empty; they do not invent a new revision.
 
+Room uses one `/app/room/list` read. Every Room has `roomId`, `roomName`,
+`index`, `deviceCount`, and `deviceIds`; full and essential keep all five fields.
+Membership IDs include Device groups without expanding their members or state.
+
 Targets without a dedicated projection retain their business fields in YAML;
 essential does not promise a smaller field set for every domain. Targets own that selection.
 

package/contract/entity-presentation-v1.md

@@ -0,0 +1,22 @@
+# Entity UI presentation
+
+`/app/entity/presentation/get` is a read-only App Facade for the UI. Its direct
+input is `{entityType, entityId}`; tenant, Space and caller come from authenticated
+context. It requires Space read access. It is not an Agent or MCP catalog entry.
+
+The successful data object contains `entityEntry`, nullable `entityCard`, and
+`twinAutomations`. The entry and card reuse the existing UI renderer models;
+the schema owns this boundary without duplicating their nested widget/runtime
+contracts. A missing, deleted or differently typed Twin is not found. Device
+presentation reads reuse the device manager; other Twin entities reuse the general
+manager. Ordinary Entity business detail and Group detail retain their own APIs.
+
+Device card assembly is best effort. An absent card is `null`, with an empty
+association list. Association-read failures retain the existing execution policy:
+local Core returns an empty list; cloud propagates the error. No writes or repairs
+are performed. Current Twin states still have their separate read/subscription.
+
+UI uses `control: {mode: "direct", responseDetail: "full"}` and receives the shared
+`{status: "success", data: ...}` envelope. The generic essential projection returns
+`{status: "success", text: ...}` with the same business fields rendered as YAML;
+there is no domain field reduction. This is not the compact business detail API.

package/contract/pod-directory-v1.md

@@ -13,11 +13,11 @@ bridge. A cloud Space composes it in cloud. LLM placement does not change this
 owner. Cloud entrypoints forward local-Space business to Core; only an unavailable
 Hub transport permits the explicit read-only registration fallback below.
 
-The result contains `pods`, `scopeId`, `observedAtMs`, and `sourceErrors`.
+The result contains `pods`, `spaceId`, `observedAtMs`, and `sourceErrors`.
 Every row contains `registrationId`, `clientMode` (`user` or `space`), `registered`
-(true), and `connection` with `scopeId`, `state` (`connected`, `disconnected`, or
+(true), and `connection` with `spaceId`, `state` (`connected`, `disconnected`, or
 `unknown`), and `source` (`hub`, `cloud`, or `unavailable`). Space rows also contain
-`scopeId` and `appClientId`. Personal rows contain the saved `name`, `deviceId`,
+`spaceId` and `appClientId`. Personal rows contain the saved `name`, `deviceId`,
 `model`, `platform`, `firmwareVersion`, `issuedAt`, and `activatedAt`.
 No tokens, enrollment grants, credential IDs or private keys are returned.
 

package/fixtures/binding-list.response.json

@@ -9,7 +9,7 @@
         "placement": "local",
         "accountId": "bot",
         "conversationId": "group",
-        "scopeId": "home",
+        "spaceId": "home",
         "displayName": "Family",
         "createdAtMs": 1
       }

package/fixtures/entity-presentation.conformance.json

@@ -0,0 +1,54 @@
+{
+  "input": {
+    "valid": [
+      {
+        "entityType": "basic.device.Device",
+        "entityId": "device-1"
+      }
+    ],
+    "invalid": [
+      {},
+      {
+        "entityType": " ",
+        "entityId": "device-1"
+      },
+      {
+        "entityType": "basic.device.Device",
+        "entityId": ""
+      },
+      {
+        "entityType": "basic.device.Device",
+        "entityId": "device-1",
+        "scopeId": "other"
+      }
+    ]
+  },
+  "output": {
+    "valid": [
+      {
+        "entityEntry": {
+          "uid": "device-1",
+          "type": "basic.device.Device",
+          "integration": "example.device",
+          "name": "Desk lamp",
+          "active": false,
+          "data": {},
+          "capabilities": [],
+          "twinTags": [],
+          "cardCount": 0,
+          "issue": false
+        },
+        "entityCard": null,
+        "twinAutomations": []
+      }
+    ],
+    "invalid": [
+      {},
+      {
+        "entityEntry": null,
+        "entityCard": null,
+        "twinAutomations": []
+      }
+    ]
+  }
+}

package/fixtures/hub-state.configured.json

@@ -1,5 +1,5 @@
 {
-  "scopeId": "scope-1",
+  "spaceId": "scope-1",
   "configured": true,
   "hub": {
     "id": "hub-1",

package/fixtures/hub-state.revoked.json

@@ -1,5 +1,5 @@
 {
-  "scopeId": "scope-1",
+  "spaceId": "scope-1",
   "configured": false,
   "operation": {
     "kind": "REMOVE",

package/fixtures/presentation/cases.json

@@ -80,24 +80,28 @@
     }
   },
   {
-    "name": "brief-does-not-invent-view-count",
+    "name": "dashboard card list is a compact summary",
     "target": "/app/dashboard/card/list",
     "data": {
+      "spaceId": "space-1",
+      "canvasId": "canvas-1",
       "cards": [
         {
           "cardId": "card-1",
-          "type": "entity",
-          "title": "Lamp"
+          "type": "WIDGET",
+          "title": "Power"
         }
       ]
     },
     "status": "success",
     "essential": {
+      "spaceId": "space-1",
+      "canvasId": "canvas-1",
       "cards": [
         {
           "cardId": "card-1",
-          "type": "entity",
-          "title": "Lamp"
+          "type": "WIDGET",
+          "title": "Power"
         }
       ]
     }
@@ -183,13 +187,13 @@
           "id": "a1",
           "name": "Morning",
           "description": "Turn on light",
-          "type": "TASK_FLOW",
           "enabled": true,
           "singleUse": false,
           "createdAt": 1,
           "tags": [
             "internal"
-          ]
+          ],
+          "automationType": "TASK_FLOW"
         }
       ]
     },
@@ -199,9 +203,9 @@
           "id": "a1",
           "name": "Morning",
           "description": "Turn on light",
-          "type": "TASK_FLOW",
           "enabled": true,
-          "singleUse": false
+          "singleUse": false,
+          "automationType": "TASK_FLOW"
         }
       ]
     }
@@ -216,14 +220,12 @@
           "id": "a1",
           "name": "Morning",
           "description": "Turn on light",
-          "type": "TASK_FLOW",
           "enabled": true,
           "singleUse": false,
           "hasExpire": false,
           "usedCapabilities": [
             "light.command.on"
           ],
-          "memberIds": [],
           "inputVars": [
             {
               "name": "$room",
@@ -239,7 +241,8 @@
             }
           },
           "updatedAt": 2,
-          "descriptionTemplate": "Turn on {! $room !}"
+          "descriptionTemplate": "Turn on {! $room !}",
+          "automationType": "TASK_FLOW"
         }
       ]
     },
@@ -249,14 +252,12 @@
           "id": "a1",
           "name": "Morning",
           "description": "Turn on light",
-          "type": "TASK_FLOW",
           "enabled": true,
           "singleUse": false,
           "hasExpire": false,
           "usedCapabilities": [
             "light.command.on"
           ],
-          "memberIds": [],
           "inputVars": [
             {
               "name": "$room",
@@ -265,7 +266,8 @@
             }
           ],
           "scriptHash": "source-hash",
-          "descriptionTemplate": "Turn on {! $room !}"
+          "descriptionTemplate": "Turn on {! $room !}",
+          "automationType": "TASK_FLOW"
         }
       ]
     }
@@ -280,8 +282,8 @@
           "automationId": "a1",
           "automationName": "Morning",
           "automationType": "TASK_FLOW",
-          "origin": "RECURRING",
-          "description": "duplicate"
+          "description": "duplicate",
+          "singleUse": false
         }
       ]
     },
@@ -291,7 +293,7 @@
           "automationId": "a1",
           "automationName": "Morning",
           "automationType": "TASK_FLOW",
-          "origin": "RECURRING"
+          "singleUse": false
         }
       ]
     }
@@ -309,35 +311,31 @@
           "automationId": "a1",
           "automationName": "Morning",
           "automationType": "TASK_FLOW",
-          "origin": "RECURRING",
           "activityType": "RUN_FAILED",
           "timestamp": 100,
           "instanceId": "run",
           "threadId": 0,
-          "error": true,
-          "panic": false,
           "actorUserId": "user",
           "clientId": "client",
-          "description": "duplicate"
+          "description": "duplicate",
+          "singleUse": false
         }
       ]
     },
     "essential": {
       "since": "10min",
       "from": 0,
-      "until": 100,
+      "until": "1970-01-01 00:00:00 +00:00 (UTC)",
       "activities": [
         {
           "automationId": "a1",
           "automationName": "Morning",
           "automationType": "TASK_FLOW",
-          "origin": "RECURRING",
           "activityType": "RUN_FAILED",
-          "timestamp": 100,
+          "timestamp": "1970-01-01 00:00:00 +00:00 (UTC)",
           "instanceId": "run",
           "threadId": 0,
-          "error": true,
-          "panic": false
+          "singleUse": false
         }
       ]
     }
@@ -377,7 +375,7 @@
           "name": "Morning",
           "threadId": 0,
           "instanceId": "run",
-          "timestamp": 100,
+          "timestamp": "1970-01-01 00:00:00 +00:00 (UTC)",
           "status": "failed",
           "reportMode": "STD",
           "logCount": 2,
@@ -437,7 +435,7 @@
         "name": "Morning",
         "threadId": 0,
         "instanceId": "run",
-        "timestamp": 100,
+        "timestamp": "1970-01-01 00:00:00 +00:00 (UTC)",
         "status": "failed",
         "reportMode": "STD",
         "logCount": 2,
@@ -449,8 +447,8 @@
           "code": "TIMEOUT"
         },
         "revision": 3,
-        "startedAt": 90,
-        "finishedAt": 100
+        "startedAt": "1970-01-01 00:00:00 +00:00 (UTC)",
+        "finishedAt": "1970-01-01 00:00:00 +00:00 (UTC)"
       },
       "logs": [
         {
@@ -478,10 +476,10 @@
           "snapshotId": "v1",
           "createdAt": 90,
           "description": "Prior behavior",
-          "type": "TASK_FLOW",
           "script": {
             "script": "private"
-          }
+          },
+          "automationType": "TASK_FLOW"
         }
       ]
     },
@@ -490,79 +488,9 @@
       "snapshots": [
         {
           "snapshotId": "v1",
-          "createdAt": 90,
+          "createdAt": "1970-01-01 00:00:00 +00:00 (UTC)",
           "description": "Prior behavior",
-          "type": "TASK_FLOW"
-        }
-      ]
-    }
-  },
-  {
-    "name": "dashboard card list retains canvas layout",
-    "target": "/app/dashboard/card/brief/list",
-    "status": "success",
-    "data": {
-      "canvasId": "canvas",
-      "cards": [
-        {
-          "cardId": "card-1",
-          "type": "widget",
-          "title": "Power",
-          "layouts": {
-            "sm": {
-              "x": 0,
-              "y": 0,
-              "width": 2,
-              "height": 2
-            }
-          },
-          "views": [
-            {
-              "id": "power",
-              "name": "Power",
-              "source": {
-                "type": "widget",
-                "baseId": "automation-1",
-                "widgetId": "widget-1"
-              },
-              "pattern": "default"
-            }
-          ],
-          "primaryViewId": "power",
-          "widgets": [
-            {
-              "widgetId": "widget-1",
-              "name": "Power",
-              "widgetType": "DATA",
-              "dataType": "NUMBER"
-            }
-          ]
-        }
-      ]
-    },
-    "essential": {
-      "canvasId": "canvas",
-      "cards": [
-        {
-          "cardId": "card-1",
-          "type": "widget",
-          "title": "Power",
-          "primaryViewId": "power",
-          "views": [
-            {
-              "id": "power",
-              "name": "Power"
-            }
-          ],
-          "viewCount": 1,
-          "layouts": {
-            "sm": {
-              "x": 0,
-              "y": 0,
-              "width": 2,
-              "height": 2
-            }
-          }
+          "automationType": "TASK_FLOW"
         }
       ]
     }
@@ -879,29 +807,29 @@
     "status": "success",
     "essential": {
       "since": "10min",
-      "from": 1793065800000,
-      "until": 1793066400000,
+      "from": "2026-10-27 01:50:00 +00:00 (UTC)",
+      "until": "2026-10-27 02:00:00 +00:00 (UTC)",
       "truncated": true,
       "updates": [
         {
           "deviceId": "d1",
           "deviceName": "Lamp",
           "capabilityId": "state.onOff",
-          "changedAt": 1793066400000,
+          "changedAt": "2026-10-27 02:00:00 +00:00 (UTC)",
           "state": false
         },
         {
           "deviceId": "d2",
           "deviceName": "Dimmer",
           "capabilityId": "state.level",
-          "changedAt": 1793066399000,
+          "changedAt": "2026-10-27 01:59:59 +00:00 (UTC)",
           "state": 0
         },
         {
           "deviceId": "d3",
           "deviceName": "Button",
           "capabilityId": "event.click",
-          "changedAt": 1793066398000,
+          "changedAt": "2026-10-27 01:59:58 +00:00 (UTC)",
           "event": {
             "value": null
           }
@@ -910,7 +838,7 @@
           "deviceId": "d4",
           "deviceName": "Lamp",
           "capabilityId": "command.onOff",
-          "changedAt": 1793066397000,
+          "changedAt": "2026-10-27 01:59:57 +00:00 (UTC)",
           "log": {
             "source": "Automation",
             "data": {
@@ -1278,7 +1206,7 @@
     "name": "hub-unconfigured",
     "target": "/app/hub/get",
     "data": {
-      "scopeId": "space-demo",
+      "spaceId": "space-demo",
       "configured": false,
       "hub": null,
       "operation": null,
@@ -1286,7 +1214,7 @@
     },
     "status": "success",
     "essential": {
-      "scopeId": "space-demo",
+      "spaceId": "space-demo",
       "configured": false,
       "hub": null,
       "operation": null,
@@ -1312,7 +1240,7 @@
     "name": "pod-directory-unknown",
     "target": "/app/pod/list",
     "data": {
-      "scopeId": "space-demo",
+      "spaceId": "space-demo",
       "observedAtMs": 1800000000000,
       "pods": [
         {
@@ -1327,7 +1255,7 @@
           "issuedAt": 1800000000000,
           "activatedAt": 1800000001000,
           "connection": {
-            "scopeId": null,
+            "spaceId": null,
             "state": "unknown",
             "source": "unavailable"
           }
@@ -1339,7 +1267,7 @@
     },
     "status": "success",
     "essential": {
-      "scopeId": "space-demo",
+      "spaceId": "space-demo",
       "observedAtMs": 1800000000000,
       "pods": [
         {
@@ -1354,7 +1282,7 @@
           "issuedAt": 1800000000000,
           "activatedAt": 1800000001000,
           "connection": {
-            "scopeId": null,
+            "spaceId": null,
             "state": "unknown",
             "source": "unavailable"
           }
@@ -3284,5 +3212,129 @@
     "essential": {
       "llmMode": "local"
     }
+  },
+  {
+    "name": "room-list-complete-membership",
+    "target": "/app/room/list",
+    "data": {
+      "rooms": [
+        {
+          "roomId": "r1",
+          "roomName": "Living",
+          "index": 0,
+          "deviceCount": 2,
+          "deviceIds": [
+            "d1",
+            "g:1"
+          ]
+        },
+        {
+          "roomId": "r2",
+          "roomName": "Empty",
+          "index": 1,
+          "deviceCount": 0,
+          "deviceIds": []
+        }
+      ]
+    },
+    "status": "success",
+    "essential": {
+      "rooms": [
+        {
+          "roomId": "r1",
+          "roomName": "Living",
+          "index": 0,
+          "deviceCount": 2,
+          "deviceIds": [
+            "d1",
+            "g:1"
+          ]
+        },
+        {
+          "roomId": "r2",
+          "roomName": "Empty",
+          "index": 1,
+          "deviceCount": 0,
+          "deviceIds": []
+        }
+      ]
+    }
+  },
+  {
+    "name": "room-list-empty",
+    "target": "/app/room/list",
+    "data": {
+      "rooms": []
+    },
+    "status": "success",
+    "essential": {
+      "rooms": []
+    }
+  },
+  {
+    "name": "dashboard layout get stored and missing layouts",
+    "target": "/app/dashboard/canvas/layout/get",
+    "status": "success",
+    "data": {
+      "spaceId": "space-1",
+      "canvasId": "canvas-1",
+      "layoutSize": "md",
+      "cards": [
+        {
+          "cardId": "card-1",
+          "title": "Power",
+          "layout": {
+            "x": 0,
+            "y": 1,
+            "width": 2,
+            "height": 2
+          }
+        },
+        {
+          "cardId": "card-2",
+          "title": "Unpositioned",
+          "layout": null
+        }
+      ]
+    },
+    "essential": {
+      "spaceId": "space-1",
+      "canvasId": "canvas-1",
+      "layoutSize": "md",
+      "cards": [
+        {
+          "cardId": "card-1",
+          "title": "Power",
+          "layout": {
+            "x": 0,
+            "y": 1,
+            "width": 2,
+            "height": 2
+          }
+        },
+        {
+          "cardId": "card-2",
+          "title": "Unpositioned",
+          "layout": null
+        }
+      ]
+    }
+  },
+  {
+    "name": "dashboard layout get empty canvas",
+    "target": "/app/dashboard/canvas/layout/get",
+    "status": "success",
+    "data": {
+      "spaceId": "space-1",
+      "canvasId": "canvas-1",
+      "layoutSize": "md",
+      "cards": []
+    },
+    "essential": {
+      "spaceId": "space-1",
+      "canvasId": "canvas-1",
+      "layoutSize": "md",
+      "cards": []
+    }
   }
 ]

package/fixtures/route-list.response.json

@@ -13,7 +13,7 @@
         "externalActorId": "user-1",
         "tenantId": "tenant-1",
         "userId": "mhome-user-1",
-        "scopeId": "scope-1",
+        "spaceId": "scope-1",
         "displayName": "Telegram",
         "projections": {
           "notification": {
@@ -37,7 +37,7 @@
         "conversationId": "chat-2",
         "audience": "shared",
         "tenantId": "tenant-1",
-        "scopeId": "scope-2",
+        "spaceId": "scope-2",
         "boundByUserId": "mhome-user-1",
         "displayName": "Project room",
         "projections": {

package/fixtures/route-update.request.json

@@ -6,7 +6,7 @@
     "provider": "telegram",
     "placement": "cloud",
     "routeId": "route-1",
-    "scopeId": "scope-1",
+    "spaceId": "scope-1",
     "projections": {
       "notification": {
         "enabled": true,

package/fixtures/route-update.response.json

@@ -12,7 +12,7 @@
       "externalActorId": "user-1",
       "tenantId": "tenant-1",
       "userId": "mhome-user-1",
-      "scopeId": "scope-1",
+      "spaceId": "scope-1",
       "projections": {
         "notification": {
           "enabled": true,

package/fixtures/shared-account-grant-list.response.json

@@ -8,7 +8,7 @@
         "placement": "local",
         "accountId": "123456",
         "tenantId": "tenant-1",
-        "scopeId": "scope-1",
+        "spaceId": "scope-1",
         "grantedByUserId": "user-1",
         "createdAtMs": 1787961600000,
         "updatedAtMs": 1787961600000

package/manifest/app-facade.v1.json

@@ -1,6 +1,6 @@
 {
   "manifest": "mhome.app-facade.v1",
-  "contractVersion": "1.62.0",
+  "contractVersion": "1.64.0",
   "callSchema": "schema/facade-call.v1.schema.json",
   "routing": "manifest/routing.v1.json",
   "routingSchema": "schema/routing.v1.schema.json",
@@ -230,6 +230,13 @@
         "/app/card-skins/override/set": "#/definitions/empty",
         "/app/card-skins/override/reset": "#/definitions/empty"
       }
+    },
+    "entityPresentation": {
+      "schema": "schema/entity-presentation.v1.schema.json",
+      "contract": "contract/entity-presentation-v1.md",
+      "requestTargets": [
+        "/app/entity/presentation/get"
+      ]
     }
   },
   "authorization": "manifest/authorization.v1.json",

package/manifest/authorization.v1.json

@@ -1,5 +1,5 @@
 {
-  "contractVersion": "1.62.0",
+  "contractVersion": "1.64.0",
   "operations": {
     "/app/agent/context/get": "spaceRead",
     "/app/agent/credit/usage": "spaceRead",
@@ -64,21 +64,21 @@
     "/app/client/page/list": "spaceRead",
     "/app/client/page/open": "spaceWrite",
     "/app/client/page/report": "spaceRead",
-    "/app/dashboard/canvas/brief/list": "spaceRead",
+    "/app/dashboard/canvas/list": "spaceRead",
     "/app/dashboard/canvas/content/get": "spaceRead",
     "/app/dashboard/canvas/create": "spaceWrite",
     "/app/dashboard/canvas/delete": "spaceWrite",
+    "/app/dashboard/canvas/layout/get": "spaceRead",
     "/app/dashboard/canvas/layout/update": "spaceWrite",
     "/app/dashboard/canvas/rename": "spaceWrite",
     "/app/dashboard/canvas/reorder": "spaceWrite",
     "/app/dashboard/card/add": "spaceWrite",
-    "/app/dashboard/card/brief/list": "spaceRead",
+    "/app/dashboard/card/list": "spaceRead",
     "/app/dashboard/card/copy": "spaceWrite",
     "/app/dashboard/card/delete": "spaceWrite",
     "/app/dashboard/card/detail/get": "spaceRead",
     "/app/dashboard/card/main-view/update": "spaceWrite",
     "/app/dashboard/card/move": "spaceWrite",
-    "/app/dashboard/list": "spaceRead",
     "/app/device/activity/recent/list": "spaceRead",
     "/app/device/brief/list": "spaceRead",
     "/app/device/detail/get": "spaceRead",
@@ -94,6 +94,7 @@
     "/app/entity/detail/get": "spaceRead",
     "/app/entity/history/list": "spaceRead",
     "/app/entity/list": "spaceRead",
+    "/app/entity/presentation/get": "spaceRead",
     "/app/group/brief/list": "spaceRead",
     "/app/group/delete": "spaceWrite",
     "/app/group/detail/get": "spaceRead",
@@ -212,10 +213,8 @@
     "/app/pod/space/list": "spaceRead",
     "/app/quickword/list": "spaceRead",
     "/app/quickword/run": "spaceWrite",
-    "/app/room/brief/list": "spaceRead",
     "/app/room/create": "spaceWrite",
     "/app/room/delete": "spaceWrite",
-    "/app/room/detail/get": "spaceRead",
     "/app/room/devices/move": "spaceWrite",
     "/app/room/devices/remove": "spaceWrite",
     "/app/room/list": "spaceRead",
@@ -316,7 +315,6 @@
     "/integration/composite/refresh": "spaceWrite",
     "/integration/disconnect": "spaceWrite",
     "/integration/entity/batchGetName": "spaceRead",
-    "/integration/entity/get": "spaceRead",
     "/integration/entity/getHistory": "spaceRead",
     "/integration/group/get": "spaceRead",
     "/integration/install": "spaceWrite",

package/manifest/host-provision-targets.v1.json

@@ -1,6 +1,6 @@
 {
   "manifest": "mhome.host-provision.targets.v1",
-  "contractVersion": "1.62.0",
+  "contractVersion": "1.64.0",
   "contract": "contract/host-provisioning-v1.md",
   "localTargets": [
     "/local/host/provision/start",

package/manifest/hub-targets.v1.json

@@ -1,6 +1,6 @@
 {
   "manifest": "mhome.hub.targets.v1",
-  "contractVersion": "1.62.0",
+  "contractVersion": "1.64.0",
   "appTargets": [
     "/app/hub/get",
     "/app/hub/remove",

package/manifest/pod-targets.v1.json

@@ -1,6 +1,6 @@
 {
   "manifest": "mhome.pod.targets.v1",
-  "contractVersion": "1.62.0",
+  "contractVersion": "1.64.0",
   "contract": "contract/pod-commissioning-v1.md",
   "localTargets": [
     "/local/pod/discovery/start",

package/manifest/routing.v1.json

@@ -1,6 +1,6 @@
 {
   "manifest": "mhome.app-facade.routing.v1",
-  "contractVersion": "1.62.0",
+  "contractVersion": "1.64.0",
   "targetPrefix": "/app/",
   "default": {
     "execution": "scopeMode"

package/manifest/targets.v1.json

@@ -1,6 +1,6 @@
 {
   "manifest": "mhome.messaging.targets.v1",
-  "contractVersion": "1.62.0",
+  "contractVersion": "1.64.0",
   "requestTargets": [
     "/app/messaging/provider/list",
     "/app/messaging/provider-account/list",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mhome/app-facade-protocol",
-  "version": "1.62.0",
+  "version": "1.64.0",
   "description": "Build-time protocol artifacts for mhome.app-facade",
   "license": "MIT",
   "repository": {

package/protocol.json

@@ -1,10 +1,11 @@
 {
   "protocol": "mhome.app-facade",
-  "contractVersion": "1.62.0",
+  "contractVersion": "1.64.0",
   "manifest": "manifest/app-facade.v1.json",
   "schemas": {
     "hostAuthorization": "schema/host-authorization.v1.schema.json",
     "hostAccess": "schema/host-access.v1.schema.json",
+    "entityPresentation": "schema/entity-presentation.v1.schema.json",
     "capabilityDescriptor": "schema/capability-descriptor.v1.schema.json",
     "cardSkinPackage": "schema/card-skin-package.v1.schema.json",
     "cardSkins": "schema/card-skins.v1.schema.json",
@@ -26,6 +27,7 @@
     "person": "schema/person.v1.schema.json"
   },
   "fixtures": {
+    "entityPresentation": "fixtures/entity-presentation.conformance.json",
     "valid": "fixtures",
     "invalid": "fixtures/invalid",
     "hostAccess": "schema/host-access.v1.schema.json",

package/schema/entity-presentation.v1.schema.json

@@ -0,0 +1,83 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://mhome.ai/schema/entity-presentation.v1.schema.json",
+  "$defs": {
+    "input": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "entityType",
+        "entityId"
+      ],
+      "properties": {
+        "entityType": {
+          "type": "string",
+          "pattern": "\\S"
+        },
+        "entityId": {
+          "type": "string",
+          "pattern": "\\S"
+        }
+      }
+    },
+    "output": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "entityEntry",
+        "entityCard",
+        "twinAutomations"
+      ],
+      "properties": {
+        "entityEntry": {
+          "type": "object",
+          "required": [
+            "uid",
+            "type"
+          ],
+          "properties": {
+            "uid": {
+              "type": "string"
+            },
+            "type": {
+              "type": "string"
+            },
+            "integration": {
+              "type": [
+                "string",
+                "null"
+              ]
+            }
+          },
+          "additionalProperties": true
+        },
+        "entityCard": {
+          "type": [
+            "object",
+            "null"
+          ],
+          "additionalProperties": true
+        },
+        "twinAutomations": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": [
+              "id",
+              "name"
+            ],
+            "properties": {
+              "id": {
+                "type": "string"
+              },
+              "name": {
+                "type": "string"
+              }
+            },
+            "additionalProperties": false
+          }
+        }
+      }
+    }
+  }
+}

package/schema/hub-state.v1.schema.json

@@ -4,9 +4,9 @@
   "title": "Authoritative cloud Hub lifecycle state",
   "type": "object",
   "additionalProperties": false,
-  "required": ["scopeId", "configured"],
+  "required": ["spaceId", "configured"],
   "properties": {
-    "scopeId": { "type": "string", "minLength": 1 },
+    "spaceId": { "type": "string", "minLength": 1 },
     "configured": { "type": "boolean" },
     "hub": { "$ref": "#/$defs/hub" },
     "operation": { "$ref": "#/$defs/operation" },

package/schema/messaging-frame.v3.schema.json

@@ -380,7 +380,7 @@
         "placement",
         "accountId",
         "tenantId",
-        "scopeId",
+        "spaceId",
         "grantedByUserId",
         "createdAtMs",
         "updatedAtMs"
@@ -398,7 +398,7 @@
         "tenantId": {
           "$ref": "#/$defs/id"
         },
-        "scopeId": {
+        "spaceId": {
           "$ref": "#/$defs/id"
         },
         "grantedByUserId": {
@@ -427,7 +427,7 @@
             "externalActorId",
             "tenantId",
             "userId",
-            "scopeId",
+            "spaceId",
             "projections",
             "providerData"
           ],
@@ -453,7 +453,7 @@
             "tenantId": {
               "$ref": "#/$defs/id"
             },
-            "scopeId": {
+            "spaceId": {
               "$ref": "#/$defs/id"
             },
             "displayName": {
@@ -484,7 +484,7 @@
             "accountId",
             "conversationId",
             "tenantId",
-            "scopeId",
+            "spaceId",
             "boundByUserId",
             "projections",
             "providerData"
@@ -511,7 +511,7 @@
             "tenantId": {
               "$ref": "#/$defs/id"
             },
-            "scopeId": {
+            "spaceId": {
               "$ref": "#/$defs/id"
             },
             "displayName": {
@@ -863,7 +863,7 @@
             "routeId": {
               "$ref": "#/$defs/id"
             },
-            "scopeId": {
+            "spaceId": {
               "$ref": "#/$defs/id"
             },
             "projections": {
@@ -2516,7 +2516,7 @@
         "conversationId": {
           "$ref": "#/$defs/id"
         },
-        "scopeId": {
+        "spaceId": {
           "$ref": "#/$defs/id"
         },
         "createdAtMs": {
@@ -2533,7 +2533,7 @@
         "placement",
         "accountId",
         "conversationId",
-        "scopeId",
+        "spaceId",
         "createdAtMs"
       ]
     },

package/schema/system-clients.v1.schema.json

@@ -3,7 +3,7 @@
   "additionalProperties": false,
   "required": [
     "contract",
-    "scopeId",
+    "spaceId",
     "observedAtMs",
     "sessions"
   ],
@@ -11,7 +11,7 @@
     "contract": {
       "const": "mhome.system.clients.v1"
     },
-    "scopeId": {
+    "spaceId": {
       "type": "string"
     },
     "observedAtMs": {

package/schema/system-hosts-runtime.v1.schema.json

@@ -3,7 +3,7 @@
   "additionalProperties": false,
   "required": [
     "contract",
-    "scopeId",
+    "spaceId",
     "hostId",
     "result"
   ],
@@ -11,7 +11,7 @@
     "contract": {
       "const": "mhome.system.hosts.runtime.v1"
     },
-    "scopeId": {
+    "spaceId": {
       "type": "string"
     },
     "hostId": {

package/schema/system-hosts.v1.schema.json

@@ -3,7 +3,7 @@
   "additionalProperties": false,
   "required": [
     "contract",
-    "scopeId",
+    "spaceId",
     "observedAtMs",
     "hosts"
   ],
@@ -11,7 +11,7 @@
     "contract": {
       "const": "mhome.system.hosts.v1"
     },
-    "scopeId": {
+    "spaceId": {
       "type": "string"
     },
     "observedAtMs": {

package/schema/system-instances.v1.schema.json

@@ -3,7 +3,7 @@
   "additionalProperties": false,
   "required": [
     "contract",
-    "scopeId",
+    "spaceId",
     "observedAtMs",
     "instances"
   ],
@@ -11,7 +11,7 @@
     "contract": {
       "const": "mhome.system.instances.v1"
     },
-    "scopeId": {
+    "spaceId": {
       "type": "string"
     },
     "observedAtMs": {

package/schema/topology.v1.schema.json

@@ -6,7 +6,7 @@
   "additionalProperties": false,
   "required": [
     "contract",
-    "scopeId",
+    "spaceId",
     "generation",
     "revision",
     "observedAtMs",
@@ -15,7 +15,7 @@
   ],
   "properties": {
     "contract": { "const": "mhome.space.topology.v1" },
-    "scopeId": { "type": "string", "minLength": 1 },
+    "spaceId": { "type": "string", "minLength": 1 },
     "generation": { "type": "string", "minLength": 1 },
     "revision": { "type": "integer", "minimum": 0 },
     "observedAtMs": { "type": "integer", "minimum": 0 },