@mhome/app-facade-protocol 1.118.4 → 1.119.1

package/README.md

@@ -22,6 +22,8 @@ identity. Core-to-Node routes and provider runtime models belong to
 
 See [resource definition, observation, history and relationship reads](contract/resource-read-v1.md)
 for shared business reads and the separate UI rendering boundary.
+Device-only rendering, online rows and chart series use the
+[Device UI presentation contract](contract/device-presentation-v1.md).
 
 See [Agent LLM settings](contract/agent-llm-v1.md) for active-mode reads,
 independent saved configuration and Provider Operation boundaries.

package/contract/device-presentation-v1.md

@@ -0,0 +1,35 @@
+# Device UI presentation
+
+Device-specific UI adapters use `/app/presentation/device/*`. All three are
+read-only, use the standard App Facade envelope and follow Space-mode execution:
+cloud Spaces execute in the cloud; local Spaces execute on their selected Hub.
+They have no native Agent, external CLI Skill, MCP or CLI entrypoint. Shared
+`/app/device/state/get`, list, detail and bounded history remain domain APIs.
+
+- `/app/presentation/device/view/get`, `{deviceId}`: `{deviceId, primaryViewId, views, widgets, twin}`.
+  Reads the unique hidden Device render definition, preserving exact Widget/Twin
+  bindings. Disabled devices can have empty definitions. Multiple anchors fail rather
+  than choosing an arbitrary visible Card. Widgets contain configuration, never values. The optional `twin` metadata is
+  returned even when a known device has no render anchor.
+- `/app/presentation/device/history/series/get`, `{deviceId, capabilityIds?: []}`:
+  `{deviceId, series}` with per-capability decoded `states`, `events`, `logs`. Empty
+  capability selection reads all series. This preserves chart structure; the shared
+  Device history Facade remains a bounded, merged business timeline.
+- `/app/presentation/device/online/list`, `{entityIds?: []}`:
+  `{devices:[{entityId,online,updatedAtSec}]}`. Normalizes and deduplicates selected
+  IDs, preserves request order and returns only IDs with stored online records.
+  An empty selection returns no rows. This preserves the existing UI projection:
+  `online` is true for the stored `online` observation and false for other stored
+  states; an absent record is omitted. It never probes a device or reads capability
+  observations. The shared state API instead omits unknown `online` fields.
+
+Device details and Device Group State tabs read static bindings first, then use
+shared selected `/app/device/state/get` and `/app/widget/value/get` observations. Canvas
+content reuses static Card assembly; it does not call the single-device view API.
+History renderers request chart series only when needed. The Devices directory
+reads selected online rows after loading its catalog. These reads never refresh
+providers, change Twin lifecycle or initialize new business resources.
+
+The backend adapters own visibility, unique render-anchor validation and existing
+series filtering. Managers, persistence tables, group aggregation, generated
+Automations and push protocols are unchanged. Only the namespaced UI routes are registered.

package/contract/resource-read-v1.md

@@ -56,15 +56,10 @@ observation and graph reads preserve their bounded business fields in Essential.
 
 ## UI-only reads
 
-- `/app/device/view/get`, `{deviceId}`: `{deviceId, primaryViewId, views, widgets, twin}`.
-  Reads the unique hidden Device render definition, preserving exact Widget/Twin
-  bindings. Disabled devices can have empty definitions. Multiple anchors fail rather
-  than choosing an arbitrary visible Card. Widgets contain configuration, never values. The optional `twin` metadata is
-  returned even when a known device has no render anchor.
-- `/app/device/history/series/get`, `{deviceId, capabilityIds?: []}`:
-  `{deviceId, series}` with per-capability decoded `states`, `events`, `logs`. Empty
-  capability selection reads all series. This preserves chart structure; the shared
-  Device history Facade remains a bounded, merged business timeline.
+Device-specific rendering, chart series and selected online reads use the
+[`/app/presentation/device/*` contract](device-presentation-v1.md). They are UI
+adapters, separate from the shared definition/state/history contracts.
+
 - `/app/dashboard/canvas/content/get`, `{canvasId}`: Canvas metadata plus Cards' static
   titles, view bindings, layouts, settings, metadata and selected Widget definitions.
   Each entity Card includes the same `twin` metadata, loaded once per entity in the

package/manifest/app-facade.v1.json

@@ -1,6 +1,6 @@
 {
   "manifest": "mhome.app-facade.v1",
-  "contractVersion": "1.118.4",
+  "contractVersion": "1.119.1",
   "callSchema": "schema/facade-call.v1.schema.json",
   "routing": "manifest/routing.v1.json",
   "routingSchema": "schema/routing.v1.schema.json",
@@ -276,11 +276,7 @@
         "/app/automation/status",
         "/app/graph/relations/get"
       ],
-      "contract": "contract/resource-read-v1.md",
-      "uiRequestTargets": [
-        "/app/device/view/get",
-        "/app/device/history/series/get"
-      ]
+      "contract": "contract/resource-read-v1.md"
     },
     "agentLlm": {
       "schema": "schema/agent-llm.v1.schema.json",
@@ -425,6 +421,14 @@
       ],
       "owner": "cloudStandardCatalog",
       "transport": "authorizedHub"
+    },
+    "devicePresentation": {
+      "contract": "contract/device-presentation-v1.md",
+      "uiRequestTargets": [
+        "/app/presentation/device/view/get",
+        "/app/presentation/device/history/series/get",
+        "/app/presentation/device/online/list"
+      ]
     }
   },
   "authorization": "manifest/authorization.v1.json",

package/manifest/authorization.v1.json

@@ -1,5 +1,5 @@
 {
-  "contractVersion": "1.118.4",
+  "contractVersion": "1.119.1",
   "operations": {
     "/app/agent/context/get": "spaceRead",
     "/app/agent/credit/usage": "spaceRead",
@@ -84,12 +84,12 @@
     "/app/device/disable": "spaceWrite",
     "/app/device/enable": "spaceWrite",
     "/app/device/history/list": "spaceRead",
-    "/app/device/history/series/get": "spaceRead",
+    "/app/presentation/device/history/series/get": "spaceRead",
     "/app/device/list": "spaceRead",
-    "/app/device/online/list": "spaceRead",
+    "/app/presentation/device/online/list": "spaceRead",
     "/app/device/refresh": "spaceWrite",
     "/app/device/state/get": "spaceRead",
-    "/app/device/view/get": "spaceRead",
+    "/app/presentation/device/view/get": "spaceRead",
     "/app/dialog/get": "spaceRead",
     "/app/dialog/list": "spaceRead",
     "/app/dialog/reply": "spaceWrite",

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

@@ -1,6 +1,6 @@
 {
   "manifest": "mhome.host-provision.targets.v1",
-  "contractVersion": "1.118.4",
+  "contractVersion": "1.119.1",
   "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.118.4",
+  "contractVersion": "1.119.1",
   "appTargets": [
     "/app/hub/get",
     "/app/hub/remove",

package/manifest/pod-targets.v1.json

@@ -1,6 +1,6 @@
 {
   "manifest": "mhome.pod.targets.v1",
-  "contractVersion": "1.118.4",
+  "contractVersion": "1.119.1",
   "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.118.4",
+  "contractVersion": "1.119.1",
   "targetPrefix": "/app/",
   "default": {
     "execution": "scopeMode"

package/manifest/targets.v1.json

@@ -1,6 +1,6 @@
 {
   "manifest": "mhome.messaging.targets.v1",
-  "contractVersion": "1.118.4",
+  "contractVersion": "1.119.1",
   "requestTargets": [
     "/app/messaging/provider/list",
     "/app/messaging/provider-account/list",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mhome/app-facade-protocol",
-  "version": "1.118.4",
+  "version": "1.119.1",
   "description": "Build-time protocol artifacts for mhome.app-facade",
   "license": "Apache-2.0",
   "repository": {

package/protocol.json

@@ -1,6 +1,6 @@
 {
   "protocol": "mhome.app-facade",
-  "contractVersion": "1.118.4",
+  "contractVersion": "1.119.1",
   "manifest": "manifest/app-facade.v1.json",
   "schemas": {
     "storage": "schema/storage.v1.schema.json",