@mhome/app-facade-protocol 1.93.0 → 1.109.2

package/fixtures/presentation/cases.json

@@ -3028,56 +3028,6 @@
     "status": "error",
     "code": "INVALID_RESPONSE"
   },
-  {
-    "name": "/app/automation/start acknowledgement True",
-    "target": "/app/automation/start",
-    "data": {
-      "success": true
-    },
-    "status": "success",
-    "acknowledgement": true
-  },
-  {
-    "name": "/app/automation/start acknowledgement False",
-    "target": "/app/automation/start",
-    "data": {
-      "success": false
-    },
-    "status": "error",
-    "code": "OPERATION_FAILED"
-  },
-  {
-    "name": "/app/automation/start acknowledgement None",
-    "target": "/app/automation/start",
-    "data": {},
-    "status": "error",
-    "code": "INVALID_RESPONSE"
-  },
-  {
-    "name": "/app/automation/stop acknowledgement True",
-    "target": "/app/automation/stop",
-    "data": {
-      "success": true
-    },
-    "status": "success",
-    "acknowledgement": true
-  },
-  {
-    "name": "/app/automation/stop acknowledgement False",
-    "target": "/app/automation/stop",
-    "data": {
-      "success": false
-    },
-    "status": "error",
-    "code": "OPERATION_FAILED"
-  },
-  {
-    "name": "/app/automation/stop acknowledgement None",
-    "target": "/app/automation/stop",
-    "data": {},
-    "status": "error",
-    "code": "INVALID_RESPONSE"
-  },
   {
     "name": "/app/widget/delete acknowledgement True",
     "target": "/app/widget/delete",
@@ -3908,5 +3858,53 @@
         }
       ]
     }
+  },
+  {
+    "name": "/app/automation/start control state",
+    "target": "/app/automation/start",
+    "data": {
+      "automationId": "a",
+      "enabled": true,
+      "running": false
+    },
+    "status": "success",
+    "essential": {
+      "automationId": "a",
+      "enabled": true,
+      "running": false
+    }
+  },
+  {
+    "name": "/app/automation/start rejects acknowledgement",
+    "target": "/app/automation/start",
+    "data": {
+      "success": true
+    },
+    "status": "error",
+    "code": "INVALID_RESPONSE"
+  },
+  {
+    "name": "/app/automation/stop control state",
+    "target": "/app/automation/stop",
+    "data": {
+      "automationId": "a",
+      "enabled": false,
+      "running": false
+    },
+    "status": "success",
+    "essential": {
+      "automationId": "a",
+      "enabled": false,
+      "running": false
+    }
+  },
+  {
+    "name": "/app/automation/stop rejects acknowledgement",
+    "target": "/app/automation/stop",
+    "data": {
+      "success": true
+    },
+    "status": "error",
+    "code": "INVALID_RESPONSE"
   }
 ]

package/fixtures/reference-presentation.v1.json

@@ -0,0 +1,5 @@
+{
+  "description": "Fictional picker business DTOs, excluding the Facade result envelope.",
+  "types": {"types":[{"entityType":"basic.device.Device","name":"Device","category":"device"},{"entityType":"basic.widget.ButtonWidget","name":"Button","category":"widget"}]},
+  "items": {"items":[{"id":"example:lamp","name":"Desk lamp","entityType":"basic.device.Device","category":"device","capabilities":["switch"],"group":false},{"id":"g:example-lights","name":"All lights","entityType":"basic.device.Device","category":"device","capabilities":[],"group":true}]}
+}

package/fixtures/routing/cases.json

@@ -702,5 +702,197 @@
     "hubReady": false,
     "cloudReady": false,
     "entry": "unavailable"
+  },
+  {
+    "target": "/app/presentation/space/list",
+    "execution": "cloud",
+    "placement": null,
+    "hubReady": true,
+    "cloudReady": true,
+    "entry": "cloud"
+  },
+  {
+    "target": "/app/presentation/space/list",
+    "execution": "cloud",
+    "placement": null,
+    "hubReady": true,
+    "cloudReady": false,
+    "entry": "unavailable"
+  },
+  {
+    "target": "/app/presentation/space/list",
+    "execution": "cloud",
+    "placement": null,
+    "hubReady": false,
+    "cloudReady": true,
+    "entry": "cloud"
+  },
+  {
+    "target": "/app/presentation/space/list",
+    "execution": "cloud",
+    "placement": null,
+    "hubReady": false,
+    "cloudReady": false,
+    "entry": "unavailable"
+  },
+  {
+    "target": "/app/presentation/space/get",
+    "execution": "cloud",
+    "placement": null,
+    "hubReady": true,
+    "cloudReady": true,
+    "entry": "cloud"
+  },
+  {
+    "target": "/app/presentation/space/get",
+    "execution": "cloud",
+    "placement": null,
+    "hubReady": true,
+    "cloudReady": false,
+    "entry": "unavailable"
+  },
+  {
+    "target": "/app/presentation/space/get",
+    "execution": "cloud",
+    "placement": null,
+    "hubReady": false,
+    "cloudReady": true,
+    "entry": "cloud"
+  },
+  {
+    "target": "/app/presentation/space/get",
+    "execution": "cloud",
+    "placement": null,
+    "hubReady": false,
+    "cloudReady": false,
+    "entry": "unavailable"
+  },
+  {
+    "target": "/app/space/location/list",
+    "execution": "scopeMode",
+    "placement": null,
+    "hubReady": true,
+    "cloudReady": true,
+    "entry": "hub"
+  },
+  {
+    "target": "/app/space/location/list",
+    "execution": "scopeMode",
+    "placement": null,
+    "hubReady": true,
+    "cloudReady": false,
+    "entry": "hub"
+  },
+  {
+    "target": "/app/space/location/list",
+    "execution": "scopeMode",
+    "placement": null,
+    "hubReady": false,
+    "cloudReady": true,
+    "entry": "cloud"
+  },
+  {
+    "target": "/app/space/location/list",
+    "execution": "scopeMode",
+    "placement": null,
+    "hubReady": false,
+    "cloudReady": false,
+    "entry": "unavailable"
+  },
+  {
+    "target": "/app/space/delete/status",
+    "execution": "cloud",
+    "placement": null,
+    "hubReady": true,
+    "cloudReady": true,
+    "entry": "cloud"
+  },
+  {
+    "target": "/app/space/delete/status",
+    "execution": "cloud",
+    "placement": null,
+    "hubReady": true,
+    "cloudReady": false,
+    "entry": "unavailable"
+  },
+  {
+    "target": "/app/space/delete/status",
+    "execution": "cloud",
+    "placement": null,
+    "hubReady": false,
+    "cloudReady": true,
+    "entry": "cloud"
+  },
+  {
+    "target": "/app/space/delete/status",
+    "execution": "cloud",
+    "placement": null,
+    "hubReady": false,
+    "cloudReady": false,
+    "entry": "unavailable"
+  },
+  {
+    "target": "/app/space/beta/update",
+    "execution": "cloud",
+    "placement": null,
+    "hubReady": true,
+    "cloudReady": true,
+    "entry": "cloud"
+  },
+  {
+    "target": "/app/space/beta/update",
+    "execution": "cloud",
+    "placement": null,
+    "hubReady": true,
+    "cloudReady": false,
+    "entry": "unavailable"
+  },
+  {
+    "target": "/app/space/beta/update",
+    "execution": "cloud",
+    "placement": null,
+    "hubReady": false,
+    "cloudReady": true,
+    "entry": "cloud"
+  },
+  {
+    "target": "/app/space/beta/update",
+    "execution": "cloud",
+    "placement": null,
+    "hubReady": false,
+    "cloudReady": false,
+    "entry": "unavailable"
+  },
+  {
+    "target": "/app/client/space/focus",
+    "execution": "connection",
+    "placement": null,
+    "hubReady": true,
+    "cloudReady": true,
+    "entry": "hub"
+  },
+  {
+    "target": "/app/client/space/focus",
+    "execution": "connection",
+    "placement": null,
+    "hubReady": true,
+    "cloudReady": false,
+    "entry": "hub"
+  },
+  {
+    "target": "/app/client/space/focus",
+    "execution": "connection",
+    "placement": null,
+    "hubReady": false,
+    "cloudReady": true,
+    "entry": "cloud"
+  },
+  {
+    "target": "/app/client/space/focus",
+    "execution": "connection",
+    "placement": null,
+    "hubReady": false,
+    "cloudReady": false,
+    "entry": "unavailable"
   }
 ]

package/fixtures/widget-presentation.v1.json

@@ -0,0 +1,96 @@
+{
+  "description": "Fictional Widget presentation conformance examples; expectedFields are business-field excerpts.",
+  "cases": [
+    {
+      "type": "data",
+      "id": "flags-d",
+      "displayName": "Flags",
+      "value": false,
+      "expectedFields": {
+        "id": "flags-d",
+        "type": "data",
+        "displayName": "Flags",
+        "source": "widget",
+        "baseId": "flags-d",
+        "global": true,
+        "revision": 7,
+        "dataType": "Bool",
+        "repeated": false,
+        "value": false
+      },
+      "absentFields": [
+        "schedules",
+        "location",
+        "tenantId",
+        "scopeId",
+        "items"
+      ]
+    },
+    {
+      "type": "button",
+      "id": "run-b",
+      "displayName": "Run",
+      "expectedFields": {
+        "id": "run-b",
+        "type": "button",
+        "displayName": "Run",
+        "label": "Run",
+        "value": null
+      },
+      "absentFields": [
+        "dataType",
+        "repeated",
+        "schedules",
+        "location",
+        "tenantId",
+        "scopeId",
+        "items"
+      ]
+    },
+    {
+      "type": "circadian",
+      "id": "day-c",
+      "displayName": "Day",
+      "value": 0.0,
+      "preview": [
+        {
+          "time": {
+            "hour": 6.0,
+            "minute": 0.0
+          },
+          "value": 10.0,
+          "transition": "linear"
+        }
+      ],
+      "expectedFields": {
+        "id": "day-c",
+        "type": "circadian",
+        "displayName": "Day",
+        "dataType": "Number",
+        "value": 0.0,
+        "next": 10.0,
+        "nextTimestamp": 1794000000000,
+        "curve": "Day",
+        "curvePreview": [
+          {
+            "time": {
+              "hour": 6.0,
+              "minute": 0.0
+            },
+            "value": 10.0,
+            "transition": "linear"
+          }
+        ]
+      },
+      "absentFields": [
+        "repeated",
+        "schedules",
+        "location",
+        "tenantId",
+        "scopeId",
+        "items",
+        "offsetPrev"
+      ]
+    }
+  ]
+}

package/manifest/app-facade.v1.json

@@ -1,6 +1,6 @@
 {
   "manifest": "mhome.app-facade.v1",
-  "contractVersion": "1.93.0",
+  "contractVersion": "1.109.2",
   "callSchema": "schema/facade-call.v1.schema.json",
   "routing": "manifest/routing.v1.json",
   "routingSchema": "schema/routing.v1.schema.json",
@@ -57,7 +57,8 @@
         "/app/plugin/profile/update",
         "/app/plugin/install/prepare",
         "/app/plugin/install/start",
-        "/app/plugin/install/status"
+        "/app/plugin/install/status",
+        "/app/plugin/preview/check"
       ],
       "eventTargets": [
         "/app/plugin/settings/changed"
@@ -65,7 +66,8 @@
       "extensionFamily": "/app/plugin/{nodeType}/{route...}",
       "extensionPriority": "after_exact",
       "installSchema": "schema/plugin-install.v1.schema.json",
-      "installContract": "contract/plugin-install-v1.md"
+      "installContract": "contract/plugin-install-v1.md",
+      "previewContract": "contract/plugin-preview-v1.md"
     },
     "runtime": {
       "contract": "mhome.runtime.status.v1",
@@ -120,7 +122,9 @@
         "/app/integration/connect",
         "/app/integration/disconnect",
         "/app/integration/installed/list",
-        "/app/integration/capability/detail/get"
+        "/app/integration/capability/detail/get",
+        "/app/integration/preview/apply",
+        "/app/integration/preview/status"
       ],
       "includeDocumentationDefault": true
     },
@@ -243,14 +247,15 @@
       "schema": "schema/entity-presentation.v1.schema.json",
       "contract": "contract/entity-presentation-v1.md",
       "requestTargets": [
-        "/app/entity/presentation/get"
+        "/app/presentation/entity/get",
+        "/app/presentation/entity/meta/get"
       ]
     },
     "integrationPresentation": {
       "schema": "schema/integration-presentation.v1.schema.json",
       "contract": "contract/integration-presentation-v1.md",
       "requestTargets": [
-        "/app/integration/presentation/get"
+        "/app/presentation/integration/get"
       ]
     },
     "group": {
@@ -318,6 +323,82 @@
         "/app/object-storage/folders/set-limit",
         "/app/object-storage/session/acquire"
       ]
+    },
+    "spacePresentation": {
+      "contract": "contract/space-presentation-v1.md",
+      "requestTargets": [
+        "/app/presentation/space/list",
+        "/app/presentation/space/get",
+        "/app/space/delete/status",
+        "/app/space/beta/update",
+        "/app/space/location/list"
+      ]
+    },
+    "automationPresentation": {
+      "schema": "schema/automation-presentation.v1.schema.json",
+      "contract": "contract/automation-presentation-v1.md",
+      "uiRequestTargets": [
+        "/app/presentation/automation/names/get",
+        "/app/presentation/automation/list",
+        "/app/presentation/automation/overview/get",
+        "/app/presentation/automation/placements/get",
+        "/app/presentation/automation/summaries/get",
+        "/app/presentation/automation/overview/init",
+        "/app/presentation/automation/overview/config/update",
+        "/app/presentation/automation/overview/config/provide",
+        "/app/presentation/automation/overview/save",
+        "/app/presentation/automation/overview/cancel",
+        "/app/presentation/automation/copy",
+        "/app/presentation/automation/enroll",
+        "/app/presentation/automation/share",
+        "/app/presentation/automation/generated/enable",
+        "/app/presentation/automation/generated/disable",
+        "/app/presentation/automation/generated/run"
+      ]
+    },
+    "resourceTransfer": {
+      "requestTargets": [
+        "/app/resource/transfer/prepare"
+      ]
+    },
+    "widgetPresentation": {
+      "contract": "contract/widget-presentation-v1.md",
+      "uiRequestTargets": [
+        "/app/presentation/widget/list",
+        "/app/presentation/widget/names/get",
+        "/app/presentation/widget/defaults/get"
+      ]
+    },
+    "clientSpace": {
+      "requestTargets": [
+        "/app/client/space/focus"
+      ],
+      "contract": "contract/client-space-focus-v1.md"
+    },
+    "automation": {
+      "schema": "schema/automation.v1.schema.json",
+      "contract": "contract/automation-v1.md",
+      "requestTargets": [
+        "/app/automation/start",
+        "/app/automation/stop",
+        "/app/automation/rename",
+        "/app/automation/description/update"
+      ]
+    },
+    "widgetWrites": {
+      "contract": "contract/widget-writes-v1.md",
+      "requestTargets": [
+        "/app/widget/data/create",
+        "/app/widget/button/create",
+        "/app/widget/circadian/create",
+        "/app/widget/data/config/update",
+        "/app/widget/button/config/update",
+        "/app/widget/circadian/config/update",
+        "/app/widget/circadian/runtime/update",
+        "/app/widget/data/update",
+        "/app/widget/button/trigger",
+        "/app/widget/delete"
+      ]
     }
   },
   "authorization": "manifest/authorization.v1.json",