@mhome/app-facade-protocol 1.62.0 → 1.66.0

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.66.0",
   "callSchema": "schema/facade-call.v1.schema.json",
   "routing": "manifest/routing.v1.json",
   "routingSchema": "schema/routing.v1.schema.json",
@@ -230,6 +230,20 @@
         "/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"
+      ]
+    },
+    "integrationPresentation": {
+      "schema": "schema/integration-presentation.v1.schema.json",
+      "contract": "contract/integration-presentation-v1.md",
+      "requestTargets": [
+        "/app/integration/presentation/get"
+      ]
     }
   },
   "authorization": "manifest/authorization.v1.json",

package/manifest/authorization.v1.json

@@ -1,5 +1,5 @@
 {
-  "contractVersion": "1.62.0",
+  "contractVersion": "1.66.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,8 @@
     "/app/entity/detail/get": "spaceRead",
     "/app/entity/history/list": "spaceRead",
     "/app/entity/list": "spaceRead",
+    "/app/entity/presentation/get": "spaceRead",
+    "/app/integration/presentation/get": "spaceRead",
     "/app/group/brief/list": "spaceRead",
     "/app/group/delete": "spaceWrite",
     "/app/group/detail/get": "spaceRead",
@@ -212,10 +214,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,11 +316,9 @@
     "/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",
-    "/integration/meta/get": "spaceRead",
     "/integration/model/get": "spaceRead",
     "/integration/providerEnv/refresh": "spaceWrite",
     "/integration/uninstall": "spaceWrite",

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

@@ -1,6 +1,6 @@
 {
   "manifest": "mhome.host-provision.targets.v1",
-  "contractVersion": "1.62.0",
+  "contractVersion": "1.66.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.66.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.66.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.66.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.66.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.66.0",
   "description": "Build-time protocol artifacts for mhome.app-facade",
   "license": "MIT",
   "repository": {

package/protocol.json

@@ -1,10 +1,12 @@
 {
   "protocol": "mhome.app-facade",
-  "contractVersion": "1.62.0",
+  "contractVersion": "1.66.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",
@@ -26,6 +28,8 @@
     "person": "schema/person.v1.schema.json"
   },
   "fixtures": {
+    "entityPresentation": "fixtures/entity-presentation.conformance.json",
+    "integrationPresentation": "fixtures/integration-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/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"
         }
       }
     },

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/integration-presentation.v1.schema.json

@@ -0,0 +1,81 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://mhome.ai/schema/integration-presentation.v1.schema.json",
+  "$defs": {
+    "input": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "integrationId"
+      ],
+      "properties": {
+        "integrationId": {
+          "type": "string",
+          "pattern": "\\S"
+        }
+      }
+    },
+    "output": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "integrationId",
+        "integrationNames",
+        "integrationIconUrls",
+        "typeNames",
+        "twinNames",
+        "entityStandalone",
+        "groupSupported",
+        "capabilities"
+      ],
+      "properties": {
+        "integrationId": {
+          "type": "string",
+          "pattern": "\\S"
+        },
+        "integrationNames": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "string"
+          }
+        },
+        "integrationIconUrls": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "string"
+          }
+        },
+        "typeNames": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "string"
+          }
+        },
+        "twinNames": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "string"
+          }
+        },
+        "entityStandalone": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "boolean"
+          }
+        },
+        "groupSupported": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "boolean"
+          }
+        },
+        "capabilities": {
+          "type": "array",
+          "items": {
+            "$ref": "https://mhome.ai/schema/capability-descriptor.v1.schema.json"
+          }
+        }
+      }
+    }
+  }
+}

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 },