@mhome/app-facade-protocol 1.66.0 → 1.69.0

package/fixtures/presentation/cases.json

@@ -320,7 +320,8 @@
           "description": "duplicate",
           "singleUse": false
         }
-      ]
+      ],
+      "truncated": true
     },
     "essential": {
       "since": "10min",
@@ -337,12 +338,13 @@
           "threadId": 0,
           "singleUse": false
         }
-      ]
+      ],
+      "truncated": true
     }
   },
   {
-    "name": "automation-diagnostic-list",
-    "target": "/app/automation/diagnostic/list",
+    "name": "automation-diagnostic-get",
+    "target": "/app/automation/diagnostic/get",
     "status": "success",
     "data": {
       "diagnostics": [
@@ -364,7 +366,19 @@
           },
           "revision": 3,
           "startedAt": 90,
-          "finishedAt": 100
+          "finishedAt": 100,
+          "logs": [
+            {
+              "level": "INFO",
+              "message": "Invoked device",
+              "timestamp": 100
+            },
+            {
+              "level": "ERROR",
+              "message": "Timed out",
+              "timestamp": 100
+            }
+          ]
         }
       ]
     },
@@ -385,82 +399,22 @@
           "failure": {
             "message": "device unavailable",
             "code": "TIMEOUT"
-          }
-        }
-      ]
-    }
-  },
-  {
-    "name": "automation-diagnostic-detail",
-    "target": "/app/automation/diagnostic/detail",
-    "status": "success",
-    "data": {
-      "diagnostic": {
-        "automationId": "a1",
-        "name": "Morning",
-        "threadId": 0,
-        "instanceId": "run",
-        "timestamp": 100,
-        "status": "failed",
-        "reportMode": "STD",
-        "logCount": 2,
-        "omittedLogs": 1,
-        "truncated": true,
-        "logsMissing": false,
-        "failure": {
-          "message": "device unavailable",
-          "code": "TIMEOUT"
-        },
-        "revision": 3,
-        "startedAt": 90,
-        "finishedAt": 100
-      },
-      "logs": [
-        {
-          "level": "INFO",
-          "message": "Invoked device",
-          "context": {
-            "id": "light"
-          }
-        },
-        {
-          "level": "ERROR",
-          "message": "Timed out"
-        }
-      ]
-    },
-    "essential": {
-      "diagnostic": {
-        "automationId": "a1",
-        "name": "Morning",
-        "threadId": 0,
-        "instanceId": "run",
-        "timestamp": "1970-01-01 00:00:00 +00:00 (UTC)",
-        "status": "failed",
-        "reportMode": "STD",
-        "logCount": 2,
-        "omittedLogs": 1,
-        "truncated": true,
-        "logsMissing": false,
-        "failure": {
-          "message": "device unavailable",
-          "code": "TIMEOUT"
-        },
-        "revision": 3,
-        "startedAt": "1970-01-01 00:00:00 +00:00 (UTC)",
-        "finishedAt": "1970-01-01 00:00:00 +00:00 (UTC)"
-      },
-      "logs": [
-        {
-          "level": "INFO",
-          "message": "Invoked device",
-          "context": {
-            "id": "light"
-          }
-        },
-        {
-          "level": "ERROR",
-          "message": "Timed out"
+          },
+          "revision": 3,
+          "startedAt": "1970-01-01 00:00:00 +00:00 (UTC)",
+          "finishedAt": "1970-01-01 00:00:00 +00:00 (UTC)",
+          "logs": [
+            {
+              "level": "INFO",
+              "message": "Invoked device",
+              "timestamp": "1970-01-01 00:00:00 +00:00 (UTC)"
+            },
+            {
+              "level": "ERROR",
+              "message": "Timed out",
+              "timestamp": "1970-01-01 00:00:00 +00:00 (UTC)"
+            }
+          ]
         }
       ]
     }
@@ -496,7 +450,7 @@
     }
   },
   {
-    "name": "device-briefs-keep-discovery-and-unknown-state",
+    "name": "device-briefs-keep-discovery-definitions",
     "target": "/app/device/brief/list",
     "data": {
       "devices": [
@@ -515,7 +469,6 @@
           "connectId": "connection-1",
           "manufacturerId": "demo",
           "manufacturerName": "Example maker",
-          "online": false,
           "availabilityStatus": "unavailable",
           "twinTags": [
             "light"
@@ -550,7 +503,6 @@
           ],
           "group": false,
           "integration": "demo.device",
-          "online": false,
           "availabilityStatus": "unavailable",
           "twinTags": [
             "light"
@@ -583,7 +535,7 @@
     }
   },
   {
-    "name": "device-detail-retains-identity-state-and-missing-items",
+    "name": "device-detail-retains-identity-and-missing-items",
     "target": "/app/device/detail/get",
     "data": {
       "items": [
@@ -605,17 +557,10 @@
             "connectId": "connection-1",
             "manufacturerId": "demo",
             "manufacturerName": "Example maker",
-            "online": false,
             "availabilityStatus": "unavailable",
             "twinTags": [
               "light"
             ],
-            "states": [
-              {
-                "capabilityId": "state.onOff",
-                "value": "off"
-              }
-            ],
             "memberIds": []
           }
         },
@@ -633,7 +578,6 @@
             ],
             "group": true,
             "integration": "demo.device",
-            "states": [],
             "memberIds": [
               "d1"
             ]
@@ -667,17 +611,10 @@
             "connectId": "connection-1",
             "manufacturerId": "demo",
             "manufacturerName": "Example maker",
-            "online": false,
             "availabilityStatus": "unavailable",
             "twinTags": [
               "light"
             ],
-            "states": [
-              {
-                "capabilityId": "state.onOff",
-                "value": "off"
-              }
-            ],
             "memberIds": []
           }
         },
@@ -695,7 +632,6 @@
             ],
             "group": true,
             "integration": "demo.device",
-            "states": [],
             "memberIds": [
               "d1"
             ]
@@ -745,8 +681,7 @@
           "capabilityId": "command.onOff",
           "data": {
             "value": false,
-            "level": 0,
-            "optional": null
+            "level": 0
           },
           "traceSteps": [
             {
@@ -830,9 +765,7 @@
           "deviceName": "Button",
           "capabilityId": "event.click",
           "changedAt": "2026-10-27 01:59:58 +00:00 (UTC)",
-          "event": {
-            "value": null
-          }
+          "event": {}
         },
         {
           "deviceId": "d4",
@@ -1215,10 +1148,7 @@
     "status": "success",
     "essential": {
       "spaceId": "space-demo",
-      "configured": false,
-      "hub": null,
-      "operation": null,
-      "revocation": null
+      "configured": false
     }
   },
   {
@@ -1282,7 +1212,6 @@
           "issuedAt": 1800000000000,
           "activatedAt": 1800000001000,
           "connection": {
-            "spaceId": null,
             "state": "unknown",
             "source": "unavailable"
           }
@@ -1358,7 +1287,6 @@
           "displayName": "Example bot",
           "enabled": true,
           "status": "active",
-          "statusMessage": null,
           "providerData": {
             "botUsername": "ExampleBot"
           }
@@ -1423,7 +1351,6 @@
       "state": "succeeded",
       "phase": "completed",
       "updatedAtMs": 1800000000000,
-      "error": null,
       "result": {
         "changed": true,
         "warnings": [
@@ -1437,7 +1364,6 @@
             {
               "component": "node-camera",
               "action": "install",
-              "fromVersion": null,
               "toVersion": "1.0.0",
               "compatibility": {
                 "coreProtocol": 1
@@ -1466,9 +1392,7 @@
       "hostId": "host-demo",
       "state": "queued",
       "phase": "queued",
-      "updatedAtMs": 1800000000000,
-      "error": null,
-      "result": null
+      "updatedAtMs": 1800000000000
     }
   },
   {
@@ -1490,8 +1414,7 @@
       "state": "failed",
       "phase": "interrupted",
       "updatedAtMs": 1800000000000,
-      "error": "Host operation interrupted",
-      "result": null
+      "error": "Host operation interrupted"
     }
   },
   {
@@ -1653,11 +1576,9 @@
                   "serviceId": "camera",
                   "installed": true,
                   "installedVersion": "1.0.0",
-                  "enabled": null,
                   "controlError": "Control unavailable",
                   "toggleSupported": true,
                   "catalogLoading": false,
-                  "catalogError": null,
                   "availableVersion": "1.0.0",
                   "downloadSizeBytes": 1024,
                   "supported": true,
@@ -1685,7 +1606,6 @@
                   "state": "succeeded",
                   "phase": "completed",
                   "updatedAtMs": 1800000000000,
-                  "error": null,
                   "result": {
                     "changed": true,
                     "warnings": [
@@ -1699,7 +1619,6 @@
                         {
                           "component": "node-camera",
                           "action": "install",
-                          "fromVersion": null,
                           "toVersion": "1.0.0",
                           "compatibility": {
                             "coreProtocol": 1
@@ -1713,12 +1632,8 @@
               "protocolVersion": 1,
               "platform": "macos-arm64",
               "managementMode": "desktop",
-              "unsupportedReason": null,
-              "catalogError": null,
               "catalogLoading": false,
-              "pluginCatalogError": null,
-              "pluginCatalogLoading": false,
-              "runtimeError": null
+              "pluginCatalogLoading": false
             }
           }
         },
@@ -1729,7 +1644,6 @@
           "reachable": false,
           "detail": {
             "status": "unavailable",
-            "data": null,
             "error": "notObserved",
             "stale": false
           }
@@ -2066,9 +1980,7 @@
     "status": "success",
     "essential": {
       "name": "Example user",
-      "email": "user@example.com",
-      "avatarUrl": null,
-      "avatarExpiresAtMs": null
+      "email": "user@example.com"
     }
   },
   {
@@ -2373,10 +2285,6 @@
       "llmMode": "local",
       "effectiveMappings": [
         {
-          "temperature": null,
-          "reasoningEffort": null,
-          "thinking": null,
-          "fastMode": null,
           "useCase": "chat",
           "agentModelMode": "auto",
           "provider": "local_example",
@@ -2399,14 +2307,12 @@
         {
           "useCase": "chat",
           "displayName": "\u5bf9\u8bdd",
-          "description": null,
           "configurable": true,
           "active": true,
           "modes": [
             {
               "mode": "auto",
               "displayName": "\u81ea\u52a8",
-              "description": null,
               "requirements": {
                 "modelType": "chat",
                 "requiredInputModalities": [
@@ -2432,7 +2338,6 @@
               "modelType": "chat",
               "available": true,
               "deprecated": false,
-              "successor": null,
               "supportsTools": true,
               "supportsVision": false,
               "contextWindowTokens": 32768,
@@ -2477,15 +2382,13 @@
           "authenticated": true,
           "ready": true,
           "status": "ready",
-          "reason": null,
           "supportedUseCases": [
             "chat"
           ],
           "readinessByUseCase": {
             "chat": {
               "ready": true,
-              "modelCount": 1,
-              "reason": null
+              "modelCount": 1
             }
           }
         }
@@ -2735,7 +2638,6 @@
               "modelType": "chat",
               "available": true,
               "deprecated": false,
-              "successor": null,
               "supportsTools": true,
               "supportsVision": false,
               "contextWindowTokens": 32768,
@@ -2781,8 +2683,7 @@
           "readinessByUseCase": {
             "chat": {
               "ready": true,
-              "modelCount": 1,
-              "reason": null
+              "modelCount": 1
             }
           },
           "nodeType": "llm",
@@ -2889,7 +2790,6 @@
               "modelType": "chat",
               "available": true,
               "deprecated": false,
-              "successor": null,
               "supportsTools": true,
               "supportsVision": false,
               "contextWindowTokens": 32768,
@@ -2975,10 +2875,6 @@
     "essential": {
       "effectiveMappings": [
         {
-          "temperature": null,
-          "reasoningEffort": null,
-          "thinking": null,
-          "fastMode": null,
           "useCase": "chat",
           "agentModelMode": "auto",
           "provider": "local_example",
@@ -2995,14 +2891,12 @@
         {
           "useCase": "chat",
           "displayName": "\u5bf9\u8bdd",
-          "description": null,
           "configurable": true,
           "active": true,
           "modes": [
             {
               "mode": "auto",
               "displayName": "\u81ea\u52a8",
-              "description": null,
               "requirements": {
                 "modelType": "chat",
                 "requiredInputModalities": [
@@ -3312,8 +3206,7 @@
         },
         {
           "cardId": "card-2",
-          "title": "Unpositioned",
-          "layout": null
+          "title": "Unpositioned"
         }
       ]
     }
@@ -3535,31 +3428,6 @@
     "status": "error",
     "code": "INVALID_RESPONSE"
   },
-  {
-    "name": "/app/group/delete acknowledgement True",
-    "target": "/app/group/delete",
-    "data": {
-      "success": true
-    },
-    "status": "success",
-    "acknowledgement": true
-  },
-  {
-    "name": "/app/group/delete acknowledgement False",
-    "target": "/app/group/delete",
-    "data": {
-      "success": false
-    },
-    "status": "error",
-    "code": "OPERATION_FAILED"
-  },
-  {
-    "name": "/app/group/delete acknowledgement None",
-    "target": "/app/group/delete",
-    "data": {},
-    "status": "error",
-    "code": "INVALID_RESPONSE"
-  },
   {
     "name": "/app/widget/delete acknowledgement True",
     "target": "/app/widget/delete",
@@ -3710,5 +3578,389 @@
     "data": {},
     "status": "error",
     "code": "INVALID_RESPONSE"
+  },
+  {
+    "name": "essential omits null object fields recursively",
+    "target": "/app/test/read",
+    "status": "success",
+    "data": {
+      "missing": null,
+      "nested": {
+        "missing": null,
+        "active": false,
+        "count": 0,
+        "empty": "",
+        "list": [],
+        "object": {},
+        "text": "null",
+        "profile": "field: null\nKeep this line\n"
+      },
+      "rows": [
+        null,
+        {
+          "id": "row-1",
+          "missing": null
+        },
+        {}
+      ]
+    },
+    "essential": {
+      "nested": {
+        "active": false,
+        "count": 0,
+        "empty": "",
+        "list": [],
+        "object": {},
+        "text": "null",
+        "profile": "field: null\nKeep this line\n"
+      },
+      "rows": [
+        null,
+        {
+          "id": "row-1"
+        },
+        {}
+      ]
+    }
+  },
+  {
+    "name": "partial essential omits missing diagnostics",
+    "target": "/app/room/devices/move",
+    "status": "partial",
+    "data": {
+      "moved": [
+        "a"
+      ],
+      "notMoved": [
+        {
+          "deviceId": "b",
+          "reason": "offline",
+          "retryAfter": null
+        }
+      ],
+      "missing": null
+    },
+    "essential": {
+      "moved": [
+        "a"
+      ],
+      "notMoved": [
+        {
+          "deviceId": "b",
+          "reason": "offline"
+        }
+      ]
+    }
+  },
+  {
+    "name": "error essential omits missing diagnostics",
+    "target": "/app/automation/save",
+    "status": "error",
+    "code": "OPERATION_FAILED",
+    "data": {
+      "success": false,
+      "message": "Failed",
+      "retry": false,
+      "missing": null,
+      "details": {
+        "missing": null,
+        "remaining": []
+      }
+    },
+    "essential": {
+      "status": "error",
+      "error": {
+        "code": "OPERATION_FAILED",
+        "message": "Failed",
+        "details": {
+          "success": false,
+          "message": "Failed",
+          "retry": false,
+          "details": {
+            "remaining": []
+          }
+        }
+      }
+    }
+  },
+  {
+    "name": "group-list",
+    "target": "/app/group/list",
+    "data": {
+      "spaceId": "space",
+      "groups": [
+        {
+          "groupId": "g:11111111-1111-4111-8111-111111111111",
+          "name": "Lights",
+          "memberType": "basic.device.Device",
+          "memberCount": 2,
+          "revision": 3,
+          "applyState": "ready",
+          "createdAt": 1900000000000,
+          "updatedAt": 1900000001000
+        }
+      ]
+    },
+    "status": "success",
+    "essential": {
+      "spaceId": "space",
+      "groups": [
+        {
+          "groupId": "g:11111111-1111-4111-8111-111111111111",
+          "name": "Lights",
+          "memberType": "basic.device.Device",
+          "memberCount": 2,
+          "revision": 3,
+          "applyState": "ready",
+          "createdAt": "2030-03-17 17:46:40 +00:00 (UTC)",
+          "updatedAt": "2030-03-17 17:46:41 +00:00 (UTC)"
+        }
+      ]
+    }
+  },
+  {
+    "name": "group-detail",
+    "target": "/app/group/detail/get",
+    "data": {
+      "spaceId": "space",
+      "items": [
+        {
+          "requestedId": "g:11111111-1111-4111-8111-111111111111",
+          "found": true,
+          "group": {
+            "groupId": "g:11111111-1111-4111-8111-111111111111",
+            "name": "Lights",
+            "memberType": "basic.device.Device",
+            "memberCount": 2,
+            "revision": 3,
+            "applyState": "ready",
+            "createdAt": 1900000000000,
+            "updatedAt": 1900000001000,
+            "memberIds": [
+              "lamp-a",
+              "lamp-b"
+            ],
+            "capabilities": [
+              {
+                "id": "basic.device.command.onOff",
+                "memberCount": 1
+              }
+            ],
+            "memberProblems": [
+              {
+                "memberId": "lamp-b",
+                "code": "MEMBER_UNAVAILABLE",
+                "message": "Member is unavailable"
+              }
+            ]
+          }
+        },
+        {
+          "requestedId": "missing",
+          "found": false,
+          "reason": "not_found"
+        }
+      ]
+    },
+    "status": "success",
+    "essential": {
+      "spaceId": "space",
+      "items": [
+        {
+          "requestedId": "g:11111111-1111-4111-8111-111111111111",
+          "found": true,
+          "group": {
+            "groupId": "g:11111111-1111-4111-8111-111111111111",
+            "name": "Lights",
+            "memberType": "basic.device.Device",
+            "memberCount": 2,
+            "revision": 3,
+            "applyState": "ready",
+            "createdAt": "2030-03-17 17:46:40 +00:00 (UTC)",
+            "updatedAt": "2030-03-17 17:46:41 +00:00 (UTC)",
+            "memberIds": [
+              "lamp-a",
+              "lamp-b"
+            ],
+            "capabilities": [
+              {
+                "id": "basic.device.command.onOff",
+                "memberCount": 1
+              }
+            ],
+            "memberProblems": [
+              {
+                "memberId": "lamp-b",
+                "code": "MEMBER_UNAVAILABLE",
+                "message": "Member is unavailable"
+              }
+            ]
+          }
+        },
+        {
+          "requestedId": "missing",
+          "found": false,
+          "reason": "not_found"
+        }
+      ]
+    }
+  },
+  {
+    "name": "group-apply-partial",
+    "target": "/app/group/members/update",
+    "data": {
+      "groupId": "g:1",
+      "revision": 4,
+      "applyState": "failed",
+      "applicationProblem": {
+        "code": "GROUP_APPLY_FAILED",
+        "message": "Retry application"
+      }
+    },
+    "status": "partial",
+    "warningCode": "GROUP_APPLY_FAILED",
+    "essential": {
+      "groupId": "g:1",
+      "revision": 4,
+      "applyState": "failed",
+      "applicationProblem": {
+        "code": "GROUP_APPLY_FAILED",
+        "message": "Retry application"
+      }
+    }
+  },
+  {
+    "name": "group-delete",
+    "target": "/app/group/delete",
+    "data": {
+      "groupId": "g:1",
+      "deleted": true
+    },
+    "status": "success",
+    "essential": {
+      "groupId": "g:1",
+      "deleted": true
+    }
+  },
+  {
+    "name": "device-observation-empty-missing-and-false",
+    "target": "/app/device/state/get",
+    "data": {
+      "items": [
+        {
+          "requestedId": "d",
+          "found": true,
+          "resource": {
+            "entityId": "d",
+            "online": false,
+            "latest": []
+          }
+        },
+        {
+          "requestedId": "missing",
+          "found": false,
+          "reason": "not_found"
+        }
+      ]
+    },
+    "status": "success",
+    "essential": {
+      "items": [
+        {
+          "requestedId": "d",
+          "found": true,
+          "resource": {
+            "entityId": "d",
+            "online": false,
+            "latest": []
+          }
+        },
+        {
+          "requestedId": "missing",
+          "found": false,
+          "reason": "not_found"
+        }
+      ]
+    }
+  },
+  {
+    "name": "widget-value-is-independent",
+    "target": "/app/widget/value/get",
+    "data": {
+      "items": [
+        {
+          "requestedId": "w",
+          "found": true,
+          "resource": {
+            "widgetId": "w",
+            "revision": 3,
+            "value": false
+          }
+        }
+      ]
+    },
+    "status": "success",
+    "essential": {
+      "items": [
+        {
+          "requestedId": "w",
+          "found": true,
+          "resource": {
+            "widgetId": "w",
+            "revision": 3,
+            "value": false
+          }
+        }
+      ]
+    }
+  },
+  {
+    "name": "graph-keeps-direction-and-references",
+    "target": "/app/graph/relations/get",
+    "data": {
+      "resource": {
+        "kind": "device",
+        "id": "d"
+      },
+      "relations": [
+        {
+          "from": {
+            "kind": "automation",
+            "id": "a"
+          },
+          "relation": "uses",
+          "to": {
+            "kind": "device",
+            "id": "d"
+          },
+          "capabilityIds": [
+            "state.onOff"
+          ]
+        }
+      ]
+    },
+    "status": "success",
+    "essential": {
+      "resource": {
+        "kind": "device",
+        "id": "d"
+      },
+      "relations": [
+        {
+          "from": {
+            "kind": "automation",
+            "id": "a"
+          },
+          "relation": "uses",
+          "to": {
+            "kind": "device",
+            "id": "d"
+          },
+          "capabilityIds": [
+            "state.onOff"
+          ]
+        }
+      ]
+    }
   }
 ]