@mhome/app-facade-protocol 1.64.0 → 1.69.0

package/fixtures/routing/cases.json

@@ -638,5 +638,37 @@
     "hubReady": false,
     "cloudReady": false,
     "entry": "unavailable"
+  },
+  {
+    "target": "/app/artifact/external/resolve",
+    "execution": "cloud",
+    "placement": null,
+    "hubReady": true,
+    "cloudReady": true,
+    "entry": "cloud"
+  },
+  {
+    "target": "/app/artifact/external/resolve",
+    "execution": "cloud",
+    "placement": null,
+    "hubReady": true,
+    "cloudReady": false,
+    "entry": "unavailable"
+  },
+  {
+    "target": "/app/artifact/external/resolve",
+    "execution": "cloud",
+    "placement": null,
+    "hubReady": false,
+    "cloudReady": true,
+    "entry": "cloud"
+  },
+  {
+    "target": "/app/artifact/external/resolve",
+    "execution": "cloud",
+    "placement": null,
+    "hubReady": false,
+    "cloudReady": false,
+    "entry": "unavailable"
   }
 ]

package/manifest/app-facade.v1.json

@@ -1,6 +1,6 @@
 {
   "manifest": "mhome.app-facade.v1",
-  "contractVersion": "1.64.0",
+  "contractVersion": "1.69.0",
   "callSchema": "schema/facade-call.v1.schema.json",
   "routing": "manifest/routing.v1.json",
   "routingSchema": "schema/routing.v1.schema.json",
@@ -9,6 +9,7 @@
       "contract": "mhome.artifact.v1",
       "requestTargets": [
         "/app/artifact/resolve",
+        "/app/artifact/external/resolve",
         "/app/artifact/put",
         "/app/artifact/import",
         "/app/artifact/delete",
@@ -237,6 +238,38 @@
       "requestTargets": [
         "/app/entity/presentation/get"
       ]
+    },
+    "integrationPresentation": {
+      "schema": "schema/integration-presentation.v1.schema.json",
+      "contract": "contract/integration-presentation-v1.md",
+      "requestTargets": [
+        "/app/integration/presentation/get"
+      ]
+    },
+    "group": {
+      "schema": "schema/group.v1.schema.json",
+      "requestTargets": [
+        "/app/group/list",
+        "/app/group/detail/get",
+        "/app/group/create",
+        "/app/group/rename",
+        "/app/group/members/update",
+        "/app/group/delete",
+        "/app/group/presentation/get"
+      ]
+    },
+    "resourceRead": {
+      "requestTargets": [
+        "/app/device/state/get",
+        "/app/widget/value/get",
+        "/app/automation/status",
+        "/app/graph/relations/get"
+      ],
+      "contract": "contract/resource-read-v1.md",
+      "uiRequestTargets": [
+        "/app/device/view/get",
+        "/app/device/history/series/get"
+      ]
     }
   },
   "authorization": "manifest/authorization.v1.json",

package/manifest/authorization.v1.json

@@ -1,5 +1,5 @@
 {
-  "contractVersion": "1.64.0",
+  "contractVersion": "1.69.0",
   "operations": {
     "/app/agent/context/get": "spaceRead",
     "/app/agent/credit/usage": "spaceRead",
@@ -26,6 +26,7 @@
     "/app/artifact/import": "spaceWrite",
     "/app/artifact/put": "spaceWrite",
     "/app/artifact/resolve": "spaceRead",
+    "/app/artifact/external/resolve": "spaceRead",
     "/app/artifact/upload/cancel": "spaceWrite",
     "/app/artifact/upload/complete": "spaceWrite",
     "/app/artifact/upload/start": "spaceWrite",
@@ -34,8 +35,7 @@
     "/app/automation/delete": "spaceWrite",
     "/app/automation/description/update": "spaceWrite",
     "/app/automation/detail/get": "spaceRead",
-    "/app/automation/diagnostic/detail": "spaceRead",
-    "/app/automation/diagnostic/list": "spaceRead",
+    "/app/automation/diagnostic/get": "spaceRead",
     "/app/automation/list": "spaceRead",
     "/app/automation/save": "spaceWrite",
     "/app/automation/snapshot/list": "spaceRead",
@@ -64,19 +64,19 @@
     "/app/client/page/list": "spaceRead",
     "/app/client/page/open": "spaceWrite",
     "/app/client/page/report": "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/list": "spaceRead",
     "/app/dashboard/canvas/rename": "spaceWrite",
     "/app/dashboard/canvas/reorder": "spaceWrite",
     "/app/dashboard/card/add": "spaceWrite",
-    "/app/dashboard/card/list": "spaceRead",
     "/app/dashboard/card/copy": "spaceWrite",
     "/app/dashboard/card/delete": "spaceWrite",
     "/app/dashboard/card/detail/get": "spaceRead",
+    "/app/dashboard/card/list": "spaceRead",
     "/app/dashboard/card/main-view/update": "spaceWrite",
     "/app/dashboard/card/move": "spaceWrite",
     "/app/device/activity/recent/list": "spaceRead",
@@ -95,11 +95,9 @@
     "/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",
     "/app/group/list": "spaceRead",
-    "/app/group/upsert": "spaceWrite",
     "/app/host/access/issue": "userWrite",
     "/app/host/administrator/approve": "userWrite",
     "/app/host/administrator/cancel": "userWrite",
@@ -128,12 +126,12 @@
     "/app/integration/disconnect": "spaceWrite",
     "/app/integration/entity/list": "spaceRead",
     "/app/integration/entity/refresh": "spaceWrite",
-    "/app/integration/group/get": "spaceRead",
     "/app/integration/install": "spaceWrite",
     "/app/integration/installed/check": "spaceRead",
     "/app/integration/installed/list": "spaceRead",
     "/app/integration/list": "spaceRead",
     "/app/integration/official/list": "spaceRead",
+    "/app/integration/presentation/get": "spaceRead",
     "/app/integration/scope/list": "spaceRead",
     "/app/integration/uninstall": "spaceWrite",
     "/app/interaction-flow/back": "spaceWrite",
@@ -318,7 +316,6 @@
     "/integration/entity/getHistory": "spaceRead",
     "/integration/group/get": "spaceRead",
     "/integration/install": "spaceWrite",
-    "/integration/meta/get": "spaceRead",
     "/integration/model/get": "spaceRead",
     "/integration/providerEnv/refresh": "spaceWrite",
     "/integration/uninstall": "spaceWrite",
@@ -399,7 +396,16 @@
     "/widget/history/list": "spaceRead",
     "/widget/list": "spaceRead",
     "/widget/names": "spaceRead",
-    "/widget/setting/update": "spaceWrite"
+    "/widget/setting/update": "spaceWrite",
+    "/app/group/create": "spaceWrite",
+    "/app/group/rename": "spaceWrite",
+    "/app/group/members/update": "spaceWrite",
+    "/app/group/presentation/get": "spaceRead",
+    "/app/device/state/get": "spaceRead",
+    "/app/device/history/series/get": "spaceRead",
+    "/app/widget/value/get": "spaceRead",
+    "/app/graph/relations/get": "spaceRead",
+    "/app/device/view/get": "spaceRead"
   },
   "nodePrefix": "/app/plugin/",
   "serviceOperations": [

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

@@ -1,6 +1,6 @@
 {
   "manifest": "mhome.host-provision.targets.v1",
-  "contractVersion": "1.64.0",
+  "contractVersion": "1.69.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.64.0",
+  "contractVersion": "1.69.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.64.0",
+  "contractVersion": "1.69.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.64.0",
+  "contractVersion": "1.69.0",
   "targetPrefix": "/app/",
   "default": {
     "execution": "scopeMode"
@@ -34,7 +34,8 @@
       "/app/messaging/unbind",
       "/app/pod/enrollment/get",
       "/app/host/directory/list",
-      "/app/pod/rename"
+      "/app/pod/rename",
+      "/app/artifact/external/resolve"
     ],
     "scopeModeTargets": [
       "/app/artifact/resolve",

package/manifest/targets.v1.json

@@ -1,6 +1,6 @@
 {
   "manifest": "mhome.messaging.targets.v1",
-  "contractVersion": "1.64.0",
+  "contractVersion": "1.69.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.64.0",
+  "version": "1.69.0",
   "description": "Build-time protocol artifacts for mhome.app-facade",
   "license": "MIT",
   "repository": {

package/protocol.json

@@ -1,16 +1,18 @@
 {
   "protocol": "mhome.app-facade",
-  "contractVersion": "1.64.0",
+  "contractVersion": "1.69.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",
+    "integrationPresentation": "schema/integration-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",
     "call": "schema/facade-call.v1.schema.json",
     "response": "schema/facade-response.v1.schema.json",
+    "group": "schema/group.v1.schema.json",
     "frame": "schema/messaging-frame.v3.schema.json",
     "interactionFlow": "schema/interaction-flow-app.v1.schema.json",
     "routing": "schema/routing.v1.schema.json",
@@ -28,6 +30,8 @@
   },
   "fixtures": {
     "entityPresentation": "fixtures/entity-presentation.conformance.json",
+    "integrationPresentation": "fixtures/integration-presentation.conformance.json",
+    "group": "fixtures/group.conformance.json",
     "valid": "fixtures",
     "invalid": "fixtures/invalid",
     "hostAccess": "schema/host-access.v1.schema.json",

package/schema/facade-response.v1.schema.json

@@ -13,74 +13,33 @@
           "const": "success"
         },
         "data": true,
-        "text": {
-          "type": "string"
-        },
         "warnings": {
           "type": "array",
           "items": {
             "$ref": "#/$defs/problem"
           }
         }
-      },
-      "oneOf": [
-        {
-          "required": [
-            "data"
-          ],
-          "properties": {
-            "data": true
-          }
-        },
-        {
-          "required": [
-            "text"
-          ],
-          "properties": {
-            "text": true
-          }
-        }
-      ]
+      }
     },
     {
       "type": "object",
       "additionalProperties": false,
       "required": [
-        "status"
+        "status",
+        "data"
       ],
       "properties": {
         "status": {
           "const": "partial"
         },
         "data": true,
-        "text": {
-          "type": "string"
-        },
         "warnings": {
           "type": "array",
           "items": {
             "$ref": "#/$defs/problem"
           }
         }
-      },
-      "oneOf": [
-        {
-          "required": [
-            "data"
-          ],
-          "properties": {
-            "data": true
-          }
-        },
-        {
-          "required": [
-            "text"
-          ],
-          "properties": {
-            "text": true
-          }
-        }
-      ]
+      }
     },
     {
       "type": "object",
@@ -95,6 +54,9 @@
         },
         "error": {
           "$ref": "#/$defs/problem"
+        },
+        "data": {
+          "type": "string"
         }
       }
     },