@mhome/app-facade-protocol 1.10.0 → 1.11.0

package/README.md

@@ -88,3 +88,7 @@ from the Foundation root; omit `--write` to check conformance. Resource paths ar
 ## Shared messaging codes (1.10)
 
 Code creation may omit bot/account and group/surface identifiers. The receiving authenticated provider determines the bot; shared candidates are confirmed in the App. The existing actor link claim status/confirm/event endpoints carry both kinds, distinguished by `kind` (`link` by default, or `bind`). Bind code responses include `challengeId`; completed bind claims omit `linkId`. Private link completes on receipt. A code is single-use within its provider and service deployment, never a cross-provider or cross-Hub credential.
+
+## System inventory
+
+The system facade is executed by the local Space Hub, with Cloud relay allowed. All Space members may read it. The Hub reads its Host discovery snapshot and queries LAN Host info, service inventory and metrics. Host does not aggregate remote machines. Instances are derived exclusively from the authenticated tenant/Space commissioned records; disconnected does not mean unloaded. Client sessions use a separate endpoint. No remote Space lifecycle queries or graph coordinates are part of this contract. Legacy topology is deprecated; consumers migrate to system inventory.

package/fixtures/device-topology.graph-conformance.json

@@ -48,12 +48,10 @@
         }
       },
       {
-        "kind": "sourceDevice",
+        "kind": "matterBridge",
         "id": "source:matter:node-123",
-        "sourceType": "matter",
-        "sourceId": "node-123",
+        "nodeId": "node-123",
         "displayName": "Aqara Matter Bridge",
-        "role": "bridge",
         "runtime": {
           "state": "healthy",
           "updatedAtMs": 1777777777000
@@ -122,10 +120,10 @@
         }
       },
       {
-        "id": "edge:connection-source",
+        "id": "edge:connection-bridge",
         "source": "connection:mlinkMatter.device:matter-1",
         "target": "source:matter:node-123",
-        "relation": "connection-source",
+        "relation": "connection-bridge",
         "basis": "sourceProjection",
         "durability": "durable",
         "observation": {
@@ -134,10 +132,10 @@
         }
       },
       {
-        "id": "edge:source-device",
+        "id": "edge:bridge-device",
         "source": "source:matter:node-123",
         "target": "device:desk-light",
-        "relation": "source-device",
+        "relation": "bridge-device",
         "basis": "sourceProjection",
         "durability": "durable",
         "observation": {
@@ -922,22 +920,12 @@
       ]
     },
     {
-      "name": "missing /entities/4/sourceType",
+      "name": "missing /entities/4/nodeId",
       "valid": false,
       "mutations": [
         {
           "op": "remove",
-          "path": "/entities/4/sourceType"
-        }
-      ]
-    },
-    {
-      "name": "missing /entities/4/sourceId",
-      "valid": false,
-      "mutations": [
-        {
-          "op": "remove",
-          "path": "/entities/4/sourceId"
+          "path": "/entities/4/nodeId"
         }
       ]
     },
@@ -951,16 +939,6 @@
         }
       ]
     },
-    {
-      "name": "missing /entities/4/role",
-      "valid": false,
-      "mutations": [
-        {
-          "op": "remove",
-          "path": "/entities/4/role"
-        }
-      ]
-    },
     {
       "name": "missing /entities/4/runtime",
       "valid": false,
@@ -983,23 +961,12 @@
       ]
     },
     {
-      "name": "empty /entities/4/sourceType",
-      "valid": false,
-      "mutations": [
-        {
-          "op": "set",
-          "path": "/entities/4/sourceType",
-          "value": ""
-        }
-      ]
-    },
-    {
-      "name": "empty /entities/4/sourceId",
+      "name": "empty /entities/4/nodeId",
       "valid": false,
       "mutations": [
         {
           "op": "set",
-          "path": "/entities/4/sourceId",
+          "path": "/entities/4/nodeId",
           "value": ""
         }
       ]
@@ -1015,17 +982,6 @@
         }
       ]
     },
-    {
-      "name": "unknown /entities/4/role",
-      "valid": false,
-      "mutations": [
-        {
-          "op": "set",
-          "path": "/entities/4/role",
-          "value": "invalid"
-        }
-      ]
-    },
     {
       "name": "unknown field /entities/4",
       "valid": false,

package/fixtures/device-topology.snapshot.json

@@ -47,12 +47,10 @@
       }
     },
     {
-      "kind": "sourceDevice",
+      "kind": "matterBridge",
       "id": "source:matter:node-123",
-      "sourceType": "matter",
-      "sourceId": "node-123",
+      "nodeId": "node-123",
       "displayName": "Aqara Matter Bridge",
-      "role": "bridge",
       "runtime": {
         "state": "healthy",
         "updatedAtMs": 1777777777000
@@ -121,10 +119,10 @@
       }
     },
     {
-      "id": "edge:connection-source",
+      "id": "edge:connection-bridge",
       "source": "connection:mlinkMatter.device:matter-1",
       "target": "source:matter:node-123",
-      "relation": "connection-source",
+      "relation": "connection-bridge",
       "basis": "sourceProjection",
       "durability": "durable",
       "observation": {
@@ -133,10 +131,10 @@
       }
     },
     {
-      "id": "edge:source-device",
+      "id": "edge:bridge-device",
       "source": "source:matter:node-123",
       "target": "device:desk-light",
-      "relation": "source-device",
+      "relation": "bridge-device",
       "basis": "sourceProjection",
       "durability": "durable",
       "observation": {

package/manifest/app-facade.v1.json

@@ -1,13 +1,15 @@
 {
   "manifest": "mhome.app-facade.v1",
-  "contractVersion": "1.10.0",
+  "contractVersion": "1.11.0",
   "callSchema": "schema/facade-call.v1.schema.json",
   "routing": "manifest/routing.v1.json",
   "routingSchema": "schema/routing.v1.schema.json",
   "domains": {
     "artifact": {
       "contract": "mhome.artifact.v1",
-      "requestTargets": ["/app/artifact/resolve"]
+      "requestTargets": [
+        "/app/artifact/resolve"
+      ]
     },
     "hub": {
       "targets": "manifest/hub-targets.v1.json",
@@ -33,26 +35,31 @@
         "/app/plugin/remove",
         "/app/plugin/profile/update"
       ],
-      "eventTargets": ["/app/plugin/settings/changed"],
+      "eventTargets": [
+        "/app/plugin/settings/changed"
+      ],
       "extensionFamily": "/app/plugin/{nodeType}/{route...}",
       "extensionPriority": "after_exact"
     },
     "runtime": {
       "contract": "mhome.runtime.status.v1",
-      "resourceTypes": ["nodeInstance", "nodeRuntime"],
-      "requestTargets": ["/app/runtime/status/list"],
-      "eventTargets": ["/app/runtime/status/changed"]
-    },
-    "topology": {
-      "contract": "mhome.space.topology.v1",
-      "schema": "schema/topology.v1.schema.json",
-      "requestTargets": ["/app/topology/get"],
-      "eventTargets": ["/app/topology/changed"]
+      "resourceTypes": [
+        "nodeInstance",
+        "nodeRuntime"
+      ],
+      "requestTargets": [
+        "/app/runtime/status/list"
+      ],
+      "eventTargets": [
+        "/app/runtime/status/changed"
+      ]
     },
     "deviceTopology": {
       "contract": "mhome.device.topology.v1",
       "schema": "schema/device-topology.v1.schema.json",
-      "requestTargets": ["/app/device/topology/get"],
+      "requestTargets": [
+        "/app/device/topology/get"
+      ],
       "eventTargets": []
     },
     "interactionFlow": {
@@ -66,6 +73,21 @@
         "/app/interaction-flow/cancel"
       ],
       "sessionPersistence": "memory"
+    },
+    "system": {
+      "contract": "mhome.system.inventory.v1",
+      "schema": "schema/system-inventory.v1.schema.json",
+      "requestTargets": [
+        "/app/system/inventory/get",
+        "/app/system/clients/get",
+        "/app/system/host/metrics/get",
+        "/app/system/host/inspect",
+        "/app/system/host/plan",
+        "/app/system/host/start",
+        "/app/system/host/operation/get",
+        "/app/system/host/restart",
+        "/app/system/host/permissions/get"
+      ]
     }
   }
 }

package/manifest/routing.v1.json

@@ -1,6 +1,6 @@
 {
   "manifest": "mhome.app-facade.routing.v1",
-  "contractVersion": "1.10.0",
+  "contractVersion": "1.11.0",
   "targetPrefix": "/app/",
   "default": {
     "execution": "scopeMode",
@@ -32,7 +32,9 @@
       "/app/interaction-flow/",
       "/app/object-storage/",
       "/app/runtime/",
-      "/app/topology/"
+      "/app/system/inventory/",
+      "/app/system/clients/",
+      "/app/system/host/"
     ],
     "requestPlacementPrefixes": [
       "/app/messaging/"
@@ -47,7 +49,15 @@
       "/app/object-storage/folders/update",
       "/app/object-storage/folders/list",
       "/app/object-storage/settings/update",
-      "/app/topology/get"
+      "/app/system/inventory/get",
+      "/app/system/clients/get",
+      "/app/system/host/metrics/get",
+      "/app/system/host/inspect",
+      "/app/system/host/plan",
+      "/app/system/host/start",
+      "/app/system/host/operation/get",
+      "/app/system/host/restart",
+      "/app/system/host/permissions/get"
     ]
   }
 }

package/manifest/targets.v1.json

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

package/protocol.json

@@ -1,6 +1,6 @@
 {
   "protocol": "mhome.app-facade",
-  "contractVersion": "1.10.0",
+  "contractVersion": "1.11.0",
   "manifest": "manifest/app-facade.v1.json",
   "schemas": {
     "call": "schema/facade-call.v1.schema.json",
@@ -9,6 +9,10 @@
     "routing": "schema/routing.v1.schema.json",
     "hubState": "schema/hub-state.v1.schema.json",
     "localHubState": "schema/local-hub-state.v1.schema.json",
+    "systemClients": "schema/system-clients.v1.schema.json",
+    "systemPermissions": "schema/system-permissions.v1.schema.json",
+    "systemMetrics": "schema/system-metrics.v1.schema.json",
+    "systemInventory": "schema/system-inventory.v1.schema.json",
     "topology": "schema/topology.v1.schema.json",
     "deviceTopology": "schema/device-topology.v1.schema.json"
   },

package/schema/device-topology.v1.schema.json

@@ -186,19 +186,15 @@
           "required": [
             "id",
             "kind",
-            "sourceType",
-            "sourceId",
+            "nodeId",
             "displayName",
-            "role",
             "runtime"
           ],
           "properties": {
             "id": { "type": "string", "minLength": 1 },
-            "kind": { "const": "sourceDevice" },
-            "sourceType": { "type": "string", "minLength": 1 },
-            "sourceId": { "type": "string", "minLength": 1 },
+            "kind": { "const": "matterBridge" },
+            "nodeId": { "type": "string", "minLength": 1 },
             "displayName": { "type": "string", "minLength": 1 },
-            "role": { "enum": ["bridge", "device", "unknown"] },
             "runtime": { "$ref": "#/$defs/runtime" }
           }
         },
@@ -250,8 +246,8 @@
             "provider-connection",
             "provider-device",
             "connection-device",
-            "connection-source",
-            "source-device"
+            "connection-bridge",
+            "bridge-device"
           ]
         },
         "basis": {
@@ -298,7 +294,7 @@
         {
           "properties": {
             "relation": {
-              "enum": ["connection-source", "source-device"]
+              "enum": ["connection-bridge", "bridge-device"]
             },
             "basis": { "const": "sourceProjection" }
           }

package/schema/system-clients.v1.schema.json

@@ -0,0 +1,67 @@
+{
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "contract",
+    "scopeId",
+    "observedAtMs",
+    "sessions"
+  ],
+  "properties": {
+    "contract": {
+      "const": "mhome.system.clients.v1"
+    },
+    "scopeId": {
+      "type": "string"
+    },
+    "observedAtMs": {
+      "type": "integer",
+      "minimum": 0
+    },
+    "sessions": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "appClientId",
+          "sessionId",
+          "source",
+          "deviceType",
+          "isCurrent",
+          "routeKind"
+        ],
+        "properties": {
+          "appClientId": {
+            "type": "string"
+          },
+          "sessionId": {
+            "type": "string"
+          },
+          "source": {
+            "type": "string"
+          },
+          "deviceType": {
+            "type": "string"
+          },
+          "isCurrent": {
+            "type": "boolean"
+          },
+          "routeKind": {
+            "anyOf": [
+              {
+                "enum": [
+                  "localDirect",
+                  "cloudBridgeShadow"
+                ]
+              },
+              {
+                "type": "null"
+              }
+            ]
+          }
+        }
+      }
+    }
+  }
+}