@mhome/app-facade-protocol 1.57.0 → 1.59.0

package/README.md

@@ -53,8 +53,12 @@ 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.
-Other targets currently retain their business fields in YAML; essential does not
-promise a smaller field set for every domain. Targets own that selection.
+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
+public business fields. Device bulk list remains a CLI-only surface.
+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.
 
 The [response schema](schema/facade-response.v1.schema.json) and shared
 [presentation fixtures](fixtures/presentation/cases.json) define the wire

package/contract/pod-directory-v1.md

@@ -0,0 +1,51 @@
+# Pod directory
+
+`/app/pod/list` is a Space-mode-routed, direct, read-only Facade call with empty
+input. It requires a personal User and read access to the current Space. It combines
+all completed personal Pod registrations owned by that User with registered
+Space-owned Pods in that Space. Another User's personal Pods and other Spaces'
+Pods are excluded. Offline registrations remain; incomplete commissioning attempts
+and nearby discovery candidates are not registrations.
+
+A local Space composes this result in Core, reading its own Space inventory and
+obtaining personal registrations through the authenticated private cloud control
+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`.
+Every row contains `registrationId`, `clientMode` (`user` or `space`), `registered`
+(true), and `connection` with `scopeId`, `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`,
+`model`, `platform`, `firmwareVersion`, `issuedAt`, and `activatedAt`.
+No tokens, enrollment grants, credential IDs or private keys are returned.
+
+Connection is an observation in the indicated Space, not global power state.
+Personal registration IDs are keyed by User and device public-key fingerprint;
+personal connection IDs do not carry that fingerprint. The directory does not
+join them by name or hardware ID. Personal connection state is therefore unknown.
+Space registration IDs are their authenticated appClientId and can be correlated.
+When a local Hub cannot be queried, the cloud's persisted Space registrations
+remain visible with unknown connection state and `sourceErrors.space`. The cache
+may omit registrations not yet synchronized; it must not imply a complete live
+snapshot. Cloud presence lookup failures likewise retain saved Space records
+as unknown, with an explicit source error. A successful empty presence lookup
+can establish disconnection. Registration read failures fail the call instead
+of fabricating an empty inventory; authorization and request failures remain errors.
+
+`/app/pod/space/list` is an internal composition target, not a separate Agent,
+MCP or CLI operation. Scope-mode routing reads the Hub for a local Space or cloud
+inventory for a cloud Space. It returns only Space-owned Pod registrations.
+UI, Agent, MCP and CLI all use `/app/pod/list`; UI groups by clientMode.
+
+`/app/pod/rename` is a direct, idempotent write with exactly `registrationId` and
+`name` (trimmed, 1–64 characters). The authenticated User is the owner; request
+input cannot select a User. It updates only that personal registration's display
+name and returns `{registrationId,name}`. It works while the Pod is offline and
+does not change credentials, ownership, networking or the Pod's local settings.
+It has no prepare/commit or HITL requirement. Space Pod rename is not provided.
+The CLI is `meow pod rename <registrationId> <name>`; Agent/MCP use `pod_rename`.
+
+Personal login approve/redeem and Space commissioning retain their existing
+protocols. Factory reset is available only on the Pod itself, not remotely.

package/fixtures/presentation/cases.json

@@ -61,14 +61,6 @@
             "cardId": "card-1",
             "type": "widget",
             "title": "Power",
-            "layouts": {
-              "sm": {
-                "x": 0,
-                "y": 0,
-                "width": 2,
-                "height": 2
-              }
-            },
             "primaryViewId": "power",
             "views": [
               {
@@ -504,5 +496,583 @@
         }
       ]
     }
+  },
+  {
+    "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
+            }
+          }
+        }
+      ]
+    }
+  },
+  {
+    "name": "device-briefs-keep-discovery-and-unknown-state",
+    "target": "/app/device/brief/list",
+    "data": {
+      "devices": [
+        {
+          "entityId": "d1",
+          "name": "Lamp",
+          "active": false,
+          "roomId": "r1",
+          "roomName": "Living room",
+          "capabilities": [
+            "state.onOff",
+            "command.onOff"
+          ],
+          "group": false,
+          "integration": "demo.device",
+          "connectId": "connection-1",
+          "manufacturerId": "demo",
+          "manufacturerName": "Example maker",
+          "online": false,
+          "availabilityStatus": "unavailable",
+          "twinTags": [
+            "light"
+          ]
+        },
+        {
+          "entityId": "g:1",
+          "name": "Lights",
+          "active": true,
+          "roomId": "",
+          "roomName": "",
+          "capabilities": [
+            "command.onOff"
+          ],
+          "group": true,
+          "integration": "demo.device"
+        }
+      ]
+    },
+    "status": "success",
+    "essential": {
+      "devices": [
+        {
+          "entityId": "d1",
+          "name": "Lamp",
+          "active": false,
+          "roomId": "r1",
+          "roomName": "Living room",
+          "capabilities": [
+            "state.onOff",
+            "command.onOff"
+          ],
+          "group": false,
+          "integration": "demo.device",
+          "online": false,
+          "availabilityStatus": "unavailable",
+          "twinTags": [
+            "light"
+          ]
+        },
+        {
+          "entityId": "g:1",
+          "name": "Lights",
+          "active": true,
+          "roomId": "",
+          "roomName": "",
+          "capabilities": [
+            "command.onOff"
+          ],
+          "group": true,
+          "integration": "demo.device"
+        }
+      ]
+    }
+  },
+  {
+    "name": "device-empty-briefs",
+    "target": "/app/device/brief/list",
+    "data": {
+      "devices": []
+    },
+    "status": "success",
+    "essential": {
+      "devices": []
+    }
+  },
+  {
+    "name": "device-detail-retains-identity-state-and-missing-items",
+    "target": "/app/device/detail/get",
+    "data": {
+      "items": [
+        {
+          "requestedId": "d1",
+          "found": true,
+          "device": {
+            "entityId": "d1",
+            "name": "Lamp",
+            "active": false,
+            "roomId": "r1",
+            "roomName": "Living room",
+            "capabilities": [
+              "state.onOff",
+              "command.onOff"
+            ],
+            "group": false,
+            "integration": "demo.device",
+            "connectId": "connection-1",
+            "manufacturerId": "demo",
+            "manufacturerName": "Example maker",
+            "online": false,
+            "availabilityStatus": "unavailable",
+            "twinTags": [
+              "light"
+            ],
+            "states": [
+              {
+                "capabilityId": "state.onOff",
+                "value": "off"
+              }
+            ],
+            "memberIds": []
+          }
+        },
+        {
+          "requestedId": "g:1",
+          "found": true,
+          "device": {
+            "entityId": "g:1",
+            "name": "Lights",
+            "active": true,
+            "roomId": "",
+            "roomName": "",
+            "capabilities": [
+              "command.onOff"
+            ],
+            "group": true,
+            "integration": "demo.device",
+            "states": [],
+            "memberIds": [
+              "d1"
+            ]
+          }
+        },
+        {
+          "requestedId": "gone",
+          "found": false,
+          "reason": "not_found"
+        }
+      ]
+    },
+    "status": "success",
+    "essential": {
+      "items": [
+        {
+          "requestedId": "d1",
+          "found": true,
+          "device": {
+            "entityId": "d1",
+            "name": "Lamp",
+            "active": false,
+            "roomId": "r1",
+            "roomName": "Living room",
+            "capabilities": [
+              "state.onOff",
+              "command.onOff"
+            ],
+            "group": false,
+            "integration": "demo.device",
+            "connectId": "connection-1",
+            "manufacturerId": "demo",
+            "manufacturerName": "Example maker",
+            "online": false,
+            "availabilityStatus": "unavailable",
+            "twinTags": [
+              "light"
+            ],
+            "states": [
+              {
+                "capabilityId": "state.onOff",
+                "value": "off"
+              }
+            ],
+            "memberIds": []
+          }
+        },
+        {
+          "requestedId": "g:1",
+          "found": true,
+          "device": {
+            "entityId": "g:1",
+            "name": "Lights",
+            "active": true,
+            "roomId": "",
+            "roomName": "",
+            "capabilities": [
+              "command.onOff"
+            ],
+            "group": true,
+            "integration": "demo.device",
+            "states": [],
+            "memberIds": [
+              "d1"
+            ]
+          }
+        },
+        {
+          "requestedId": "gone",
+          "found": false,
+          "reason": "not_found"
+        }
+      ]
+    }
+  },
+  {
+    "name": "device-cli-full-list-keeps-details",
+    "target": "/app/device/list",
+    "data": {
+      "devices": [
+        {
+          "entityId": "d1",
+          "name": "Lamp",
+          "active": false,
+          "roomId": "r1",
+          "roomName": "Living room",
+          "capabilities": [
+            "state.onOff",
+            "command.onOff"
+          ],
+          "group": false,
+          "integration": "demo.device",
+          "connectId": "connection-1",
+          "manufacturerId": "demo",
+          "manufacturerName": "Example maker",
+          "online": false,
+          "availabilityStatus": "unavailable",
+          "twinTags": [
+            "light"
+          ],
+          "states": [
+            {
+              "capabilityId": "state.onOff",
+              "value": "off"
+            }
+          ],
+          "memberIds": []
+        }
+      ]
+    },
+    "status": "success",
+    "essential": {
+      "devices": [
+        {
+          "entityId": "d1",
+          "name": "Lamp",
+          "active": false,
+          "roomId": "r1",
+          "roomName": "Living room",
+          "capabilities": [
+            "state.onOff",
+            "command.onOff"
+          ],
+          "group": false,
+          "integration": "demo.device",
+          "connectId": "connection-1",
+          "manufacturerId": "demo",
+          "manufacturerName": "Example maker",
+          "online": false,
+          "availabilityStatus": "unavailable",
+          "twinTags": [
+            "light"
+          ],
+          "states": [
+            {
+              "capabilityId": "state.onOff",
+              "value": "off"
+            }
+          ],
+          "memberIds": []
+        }
+      ]
+    }
+  },
+  {
+    "name": "device-history-preserves-evidence",
+    "target": "/app/device/history/list",
+    "data": {
+      "deviceId": "d1",
+      "timeline": [
+        {
+          "time": "2026-10-27 10:00:00",
+          "type": "command",
+          "entityId": "d1",
+          "capabilityId": "command.onOff",
+          "data": {
+            "value": false,
+            "level": 0,
+            "optional": null
+          },
+          "traceSteps": [
+            {
+              "type": "Automation",
+              "value": "automation-1"
+            }
+          ]
+        }
+      ]
+    },
+    "status": "success",
+    "essential": {
+      "deviceId": "d1",
+      "timeline": [
+        {
+          "time": "2026-10-27 10:00:00",
+          "type": "command",
+          "entityId": "d1",
+          "capabilityId": "command.onOff",
+          "data": {
+            "value": false,
+            "level": 0,
+            "optional": null
+          },
+          "traceSteps": [
+            {
+              "type": "Automation",
+              "value": "automation-1"
+            }
+          ]
+        }
+      ]
+    }
+  },
+  {
+    "name": "device-recent-preserves-window-truncation-and-values",
+    "target": "/app/device/activity/recent/list",
+    "data": {
+      "since": "10min",
+      "from": 1793065800000,
+      "until": 1793066400000,
+      "truncated": true,
+      "updates": [
+        {
+          "deviceId": "d1",
+          "deviceName": "Lamp",
+          "capabilityId": "state.onOff",
+          "changedAt": 1793066400000,
+          "state": false
+        },
+        {
+          "deviceId": "d2",
+          "deviceName": "Dimmer",
+          "capabilityId": "state.level",
+          "changedAt": 1793066399000,
+          "state": 0
+        },
+        {
+          "deviceId": "d3",
+          "deviceName": "Button",
+          "capabilityId": "event.click",
+          "changedAt": 1793066398000,
+          "event": {
+            "value": null
+          }
+        },
+        {
+          "deviceId": "d4",
+          "deviceName": "Lamp",
+          "capabilityId": "command.onOff",
+          "changedAt": 1793066397000,
+          "log": {
+            "source": "Automation",
+            "data": {
+              "onOff": false
+            }
+          }
+        }
+      ]
+    },
+    "status": "success",
+    "essential": {
+      "since": "10min",
+      "from": 1793065800000,
+      "until": 1793066400000,
+      "truncated": true,
+      "updates": [
+        {
+          "deviceId": "d1",
+          "deviceName": "Lamp",
+          "capabilityId": "state.onOff",
+          "changedAt": 1793066400000,
+          "state": false
+        },
+        {
+          "deviceId": "d2",
+          "deviceName": "Dimmer",
+          "capabilityId": "state.level",
+          "changedAt": 1793066399000,
+          "state": 0
+        },
+        {
+          "deviceId": "d3",
+          "deviceName": "Button",
+          "capabilityId": "event.click",
+          "changedAt": 1793066398000,
+          "event": {
+            "value": null
+          }
+        },
+        {
+          "deviceId": "d4",
+          "deviceName": "Lamp",
+          "capabilityId": "command.onOff",
+          "changedAt": 1793066397000,
+          "log": {
+            "source": "Automation",
+            "data": {
+              "onOff": false
+            }
+          }
+        }
+      ]
+    }
+  },
+  {
+    "name": "device-enable-retains-pending",
+    "target": "/app/device/enable",
+    "data": {
+      "requestedIds": [
+        "d1",
+        "d2",
+        "d3"
+      ],
+      "enabledIds": [
+        "d1"
+      ],
+      "alreadyEnabledIds": [
+        "d2"
+      ],
+      "pendingIds": [
+        "d3"
+      ]
+    },
+    "status": "partial",
+    "essential": {
+      "requestedIds": [
+        "d1",
+        "d2",
+        "d3"
+      ],
+      "enabledIds": [
+        "d1"
+      ],
+      "alreadyEnabledIds": [
+        "d2"
+      ],
+      "pendingIds": [
+        "d3"
+      ]
+    }
+  },
+  {
+    "name": "device-disable-retains-pending",
+    "target": "/app/device/disable",
+    "data": {
+      "requestedIds": [
+        "d1",
+        "d2",
+        "d3"
+      ],
+      "disabledIds": [
+        "d1"
+      ],
+      "alreadyDisabledIds": [
+        "d2"
+      ],
+      "pendingIds": [
+        "d3"
+      ]
+    },
+    "status": "partial",
+    "essential": {
+      "requestedIds": [
+        "d1",
+        "d2",
+        "d3"
+      ],
+      "disabledIds": [
+        "d1"
+      ],
+      "alreadyDisabledIds": [
+        "d2"
+      ],
+      "pendingIds": [
+        "d3"
+      ]
+    }
+  },
+  {
+    "name": "device-refresh-not-applicable-is-resource-status",
+    "target": "/app/device/refresh",
+    "data": {
+      "status": "notApplicable"
+    },
+    "status": "success",
+    "essential": {
+      "status": "notApplicable"
+    }
   }
 ]

package/manifest/app-facade.v1.json

@@ -1,6 +1,6 @@
 {
   "manifest": "mhome.app-facade.v1",
-  "contractVersion": "1.57.0",
+  "contractVersion": "1.59.0",
   "callSchema": "schema/facade-call.v1.schema.json",
   "routing": "manifest/routing.v1.json",
   "routingSchema": "schema/routing.v1.schema.json",