@mhome/app-facade-protocol 1.118.4 → 1.125.0

package/manifest/navigation-cards.v1.json

@@ -0,0 +1,29 @@
+{
+  "contract": "mhome.user.navigation.v1",
+  "layouts": [
+    "compact",
+    "wide"
+  ],
+  "requiredCardIds": [
+    "dashboard",
+    "now",
+    "menu"
+  ],
+  "cardIds": [
+    "dashboard",
+    "now",
+    "menu",
+    "automation",
+    "device",
+    "integrationsList",
+    "messaging",
+    "house-floor-plan",
+    "storage",
+    "phone-setting",
+    "nfc",
+    "matter",
+    "person",
+    "camera",
+    "widgets"
+  ]
+}

package/manifest/pod-targets.v1.json

@@ -1,6 +1,6 @@
 {
   "manifest": "mhome.pod.targets.v1",
-  "contractVersion": "1.118.4",
+  "contractVersion": "1.125.0",
   "contract": "contract/pod-commissioning-v1.md",
   "localTargets": [
     "/local/pod/discovery/start",
@@ -92,7 +92,7 @@
     "invalid_wifi",
     "bluetooth_unavailable",
     "not_signed_in",
-    "scope_not_offered",
+    "space_not_offered",
     "cloud_unreachable_for_device",
     "busy"
   ],

package/manifest/presentation-times.v1.json

@@ -27,9 +27,6 @@
   "/app/widget/history/list": {
     "sec": [
       "history.*.timestamp"
-    ],
-    "typedMs": [
-      "history.*.value"
     ]
   },
   "/app/notification/list": {
@@ -72,10 +69,6 @@
   "/app/widget/value/get": {
     "ms": [
       "items.*.resource.nextTimestamp"
-    ],
-    "typedMs": [
-      "items.*.resource.value",
-      "items.*.resource.next"
     ]
   },
   "/app/device/state/get": {
@@ -86,14 +79,6 @@
       "items.*.resource.latest.*.log.timestamp"
     ]
   },
-  "/app/widget/detail/get": {
-    "typedMs": [
-      "items.*.widget.options",
-      "items.*.widget.min",
-      "items.*.widget.max",
-      "items.*.widget.offset"
-    ]
-  },
   "/app/now/attention/list": {
     "ms": [
       "evaluatedAt",
@@ -117,25 +102,11 @@
   "/app/presentation/widget/list": {
     "ms": [
       "items.*.nextTimestamp"
-    ],
-    "typedMs": [
-      "items.*.value",
-      "items.*.next",
-      "items.*.options",
-      "items.*.min",
-      "items.*.max"
     ]
   },
   "/app/presentation/widget/defaults/get": {
     "ms": [
       "items.*.nextTimestamp"
-    ],
-    "typedMs": [
-      "items.*.value",
-      "items.*.next",
-      "items.*.options",
-      "items.*.min",
-      "items.*.max"
     ]
   },
   "/app/presentation/automation/summaries/get": {
@@ -153,5 +124,382 @@
       "nfcTags.*.createdAt",
       "nfcTags.*.lastUsedAt"
     ]
+  },
+  "/app/entity/state/get": {
+    "sec": [
+      "items.*.resource.latest.*.state.timestamp",
+      "items.*.resource.latest.*.event.timestamp",
+      "items.*.resource.latest.*.log.timestamp"
+    ]
+  },
+  "/app/device/history/list": {
+    "unixMs": [
+      "timeline.*.timestamp"
+    ]
+  },
+  "/app/entity/history/list": {
+    "unixMs": [
+      "timeline.*.timestamp"
+    ]
+  },
+  "/app/automation/list": {
+    "ms": [
+      "automations.*.createdAt",
+      "automations.*.updatedAt",
+      "automations.*.enabledAt"
+    ]
+  },
+  "/app/automation/detail/get": {
+    "ms": [
+      "items.*.automation.createdAt",
+      "items.*.automation.updatedAt",
+      "items.*.automation.enabledAt"
+    ]
+  },
+  "/app/presentation/device/online/list": {
+    "sec": [
+      "devices.*.updatedAtSec"
+    ]
+  },
+  "/app/runtime/status/list": {
+    "ms": [
+      "observedAtMs",
+      "resources.*.observedAtMs"
+    ]
+  },
+  "/app/system/clients/get": {
+    "ms": [
+      "observedAtMs"
+    ]
+  },
+  "/app/system/instances/get": {
+    "ms": [
+      "observedAtMs",
+      "instances.*.health.observedAtMs",
+      "instances.*.health.lastAttemptAtMs"
+    ]
+  },
+  "/app/system/hosts/get": {
+    "ms": [
+      "observedAtMs",
+      "hosts.*.info.observedAtMs",
+      "hosts.*.info.lastAttemptAtMs"
+    ]
+  },
+  "/app/agent/llm/summary": {
+    "ms": [
+      "providers.*.configuration.expiresAtMs",
+      "defaultProviders.*.updatedAtMs",
+      "llmUseCases.*.updatedAtMs",
+      "llmUseCases.*.lastSeenAtMs"
+    ]
+  },
+  "/app/agent/llm/provider/list": {
+    "ms": [
+      "providers.*.configuration.expiresAtMs"
+    ]
+  },
+  "/app/agent/llm/provider/get": {
+    "ms": [
+      "provider.configuration.expiresAtMs"
+    ]
+  },
+  "/app/agent/llm/mapping/list": {
+    "ms": [
+      "defaultProviders.*.updatedAtMs",
+      "llmUseCases.*.updatedAtMs",
+      "llmUseCases.*.lastSeenAtMs"
+    ]
+  },
+  "/app/agent/llm/provider/auth/start": {
+    "ms": [
+      "expiresAtMs"
+    ]
+  },
+  "/app/agent/llm/provider/auth/complete": {
+    "ms": [
+      "expiresAtMs",
+      "nextPollAfterMs"
+    ]
+  },
+  "/app/agent/llm/provider/auth/status": {
+    "ms": [
+      "expiresAtMs",
+      "nextPollAfterMs"
+    ]
+  },
+  "/app/user/profile/get": {
+    "ms": [
+      "avatarExpiresAtMs"
+    ]
+  },
+  "/app/user/profile/update": {
+    "ms": [
+      "avatarExpiresAtMs"
+    ]
+  },
+  "/app/user/profile/avatar/commit": {
+    "ms": [
+      "avatarExpiresAtMs"
+    ]
+  },
+  "/app/user/profile/avatar/clear": {
+    "ms": [
+      "avatarExpiresAtMs"
+    ]
+  },
+  "/app/user/profile/avatar/prepare": {
+    "ms": [
+      "expiresAtMs"
+    ]
+  },
+  "/app/hub/get": {
+    "ms": [
+      "cloud.lastConnectedAt"
+    ]
+  },
+  "/app/billing/summary/get": {
+    "ms": [
+      "nextRefreshTimestamp"
+    ]
+  },
+  "/app/billing/payment/list": {
+    "ms": [
+      "payments.*.timestamp"
+    ]
+  },
+  "/app/billing/subscription/cancel": {
+    "ms": [
+      "currentPeriodEndTimestamp",
+      "scheduledTierStartTimestamp"
+    ]
+  },
+  "/app/billing/subscription/resume": {
+    "ms": [
+      "currentPeriodEndTimestamp",
+      "scheduledTierStartTimestamp"
+    ]
+  },
+  "/app/billing/subscription/change": {
+    "ms": [
+      "currentPeriodEndTimestamp",
+      "scheduledTierStartTimestamp"
+    ]
+  },
+  "/app/artifact/resolve": {
+    "ms": [
+      "expiresAtUnixMs"
+    ]
+  },
+  "/app/artifact/external/resolve": {
+    "ms": [
+      "expiresAtUnixMs"
+    ]
+  },
+  "/app/artifact/upload/start": {
+    "ms": [
+      "expiresAtUnixMs"
+    ]
+  },
+  "/app/integration/install": {
+    "ms": [
+      "expiresAt"
+    ]
+  },
+  "/app/integration/connect": {
+    "ms": [
+      "expiresAt"
+    ]
+  },
+  "/app/trace/get": {
+    "ms": [
+      "traces.*.*.timestamp"
+    ]
+  },
+  "/app/messaging/setup/start": {
+    "ms": [
+      "setup.expiresAtMs"
+    ]
+  },
+  "/app/messaging/setup/status": {
+    "ms": [
+      "setup.expiresAtMs"
+    ]
+  },
+  "/app/messaging/setup/submit": {
+    "ms": [
+      "setup.expiresAtMs"
+    ]
+  },
+  "/app/messaging/setup/cancel": {
+    "ms": [
+      "setup.expiresAtMs"
+    ]
+  },
+  "/app/messaging/bind/code/create": {
+    "ms": [
+      "challenge.expiresAtMs"
+    ]
+  },
+  "/app/messaging/link/code/create": {
+    "ms": [
+      "challenge.expiresAtMs"
+    ]
+  },
+  "/app/messaging/code/status": {
+    "ms": [
+      "status.expiresAtMs"
+    ]
+  },
+  "/app/messaging/shared-account-grant/list": {
+    "ms": [
+      "grants.*.createdAtMs",
+      "grants.*.updatedAtMs"
+    ]
+  },
+  "/app/messaging/binding/list": {
+    "ms": [
+      "bindings.*.createdAtMs"
+    ]
+  },
+  "/app/messaging/link/list": {
+    "ms": [
+      "links.*.createdAtMs",
+      "links.*.updatedAtMs"
+    ]
+  },
+  "/app/ui/customize/cards/catalog/publish/prepare": {
+    "ms": [
+      "expiresAt"
+    ]
+  },
+  "/app/host/directory/list": {
+    "ms": [
+      "observedAtMs"
+    ]
+  },
+  "/app/host/list": {
+    "ms": [
+      "observedAtMs",
+      "hosts.*.info.observedAtMs",
+      "hosts.*.info.lastAttemptAtMs",
+      "hosts.*.detail.data.services.observedAtMs",
+      "hosts.*.detail.data.operations.*.updatedAtMs"
+    ]
+  },
+  "/app/host/metrics": {
+    "ms": [
+      "sampledAtMs"
+    ]
+  },
+  "/app/host/permissions/get": {
+    "ms": [
+      "observedAtMs",
+      "permissions.*.observation.observedAtMs"
+    ]
+  },
+  "/app/system/hosts/permissions": {
+    "ms": [
+      "observedAtMs",
+      "permissions.*.observation.observedAtMs"
+    ]
+  },
+  "/app/person/list": {
+    "ms": [
+      "items.*.createdAtMs",
+      "items.*.updatedAtMs"
+    ]
+  },
+  "/app/person/get": {
+    "ms": [
+      "createdAtMs",
+      "updatedAtMs"
+    ]
+  },
+  "/app/object-storage/folders/list": {
+    "decimalMs": [
+      "folders.*.createdAtMs",
+      "folders.*.updatedAtMs"
+    ]
+  },
+  "/app/object-storage/folders/get": {
+    "decimalMs": [
+      "createdAtMs",
+      "updatedAtMs"
+    ]
+  },
+  "/app/object-storage/folders/create": {
+    "decimalMs": [
+      "createdAtMs",
+      "updatedAtMs"
+    ]
+  },
+  "/app/object-storage/folders/set-limit": {
+    "decimalMs": [
+      "createdAtMs",
+      "updatedAtMs"
+    ]
+  },
+  "/app/object-storage/session/acquire": {
+    "decimalMs": [
+      "expiresAtMs",
+      "folder.createdAtMs",
+      "folder.updatedAtMs"
+    ]
+  },
+  "/app/host/service/install": {
+    "ms": [
+      "updatedAtMs"
+    ]
+  },
+  "/app/host/service/restart": {
+    "ms": [
+      "updatedAtMs"
+    ]
+  },
+  "/app/ui/customize/cards/catalog/package/get": {
+    "ms": [
+      "value.createdAt"
+    ]
+  },
+  "/app/plugin/install/prepare": {
+    "ms": [
+      "expiresAtMs"
+    ]
+  },
+  "/app/plugin/install/start": {
+    "ms": [
+      "expiresAtMs"
+    ]
+  },
+  "/app/plugin/install/status": {
+    "ms": [
+      "expiresAtMs"
+    ]
+  },
+  "/app/artifact/put": {
+    "ms": [
+      "expiresAtUnixMs"
+    ]
+  },
+  "/app/artifact/import": {
+    "ms": [
+      "expiresAtUnixMs"
+    ]
+  },
+  "/app/artifact/upload/complete": {
+    "ms": [
+      "expiresAtUnixMs"
+    ]
+  },
+  "/app/timeline/entity/latest/list": {
+    "sec": [
+      "results.*.since",
+      "results.*.until",
+      "results.*.items.*.lastDataChangedAt",
+      "results.*.items.*.latest.state.timestamp",
+      "results.*.items.*.latest.event.timestamp",
+      "results.*.items.*.latest.log.timestamp"
+    ]
   }
 }

package/manifest/recording.v1.json

@@ -270,13 +270,16 @@
       "mode",
       "speed"
     ],
-    "coverOpenClose": [
+    "controlCover": [
       "device",
+      "latch",
       "command",
       "position",
-      "transitionDuration"
+      "tiltPosition",
+      "positionTransitionDuration",
+      "tiltTransitionDuration"
     ],
-    "lockUnlock": [
+    "doorLock": [
       "device",
       "command"
     ],
@@ -352,9 +355,9 @@
     "basic.device.command.cameraPtz": "cameraPtz",
     "basic.device.command.chime": "chime",
     "basic.device.command.controlMediaPlayback": "controlMediaPlayback",
-    "basic.device.command.coverOpenClose": "coverOpenClose",
+    "basic.device.command.controlCover": "controlCover",
     "basic.device.command.dispensePetFood": "dispensePetFood",
-    "basic.device.command.lockUnlock": "lockUnlock",
+    "basic.device.command.doorLock": "doorLock",
     "basic.device.command.onOff": "onOff",
     "basic.device.command.playMedia": "playMedia",
     "basic.device.command.seekMediaPlayback": "seekMediaPlayback",
@@ -381,8 +384,8 @@
     "mlinkHomeAssistant.device.command.broadcastAudio": "broadcastAudio",
     "mlinkHomeAssistant.device.command.chime": "chime",
     "mlinkHomeAssistant.device.command.controlMediaPlayback": "controlMediaPlayback",
-    "mlinkHomeAssistant.device.command.coverOpenClose": "coverOpenClose",
-    "mlinkHomeAssistant.device.command.lockUnlock": "lockUnlock",
+    "mlinkHomeAssistant.device.command.controlCover": "controlCover",
+    "mlinkHomeAssistant.device.command.doorLock": "doorLock",
     "mlinkHomeAssistant.device.command.onOff": "onOff",
     "mlinkHomeAssistant.device.command.playMedia": "playMedia",
     "mlinkHomeAssistant.device.command.setAudioMute": "setAudioMute",
@@ -397,12 +400,12 @@
     "mlinkHue.device.command.setBrightness": "setBrightness",
     "mlinkHue.device.command.setColorRGB": "setColorRGB",
     "mlinkHue.device.command.setColorTemperature": "setColorTemperature",
-    "mlinkLutron.device.command.coverOpenClose": "coverOpenClose",
+    "mlinkLutron.device.command.controlCover": "controlCover",
     "mlinkLutron.device.command.onOff": "onOff",
     "mlinkLutron.device.command.setBrightness": "setBrightness",
     "mlinkLutron.device.command.setFan": "setFan",
-    "mlinkMatter.device.command.coverOpenClose": "coverOpenClose",
-    "mlinkMatter.device.command.lockUnlock": "lockUnlock",
+    "mlinkMatter.device.command.controlCover": "controlCover",
+    "mlinkMatter.device.command.doorLock": "doorLock",
     "mlinkMatter.device.command.onOff": "onOff",
     "mlinkMatter.device.command.setAudioMute": "setAudioMute",
     "mlinkMatter.device.command.setAudioVolume": "setAudioVolume",
@@ -412,7 +415,7 @@
     "mlinkMatter.device.command.setFan": "setFan",
     "mlinkMatter.device.command.setThermostatMode": "setThermostatMode",
     "mlinkMatter.device.command.setThermostatTemperature": "setThermostatTemperature",
-    "mlinkShelly.device.command.coverOpenClose": "coverOpenClose",
+    "mlinkShelly.device.command.controlCover": "controlCover",
     "mlinkShelly.device.command.onOff": "onOff",
     "mlinkShelly.device.command.setBrightness": "setBrightness",
     "mlinkShelly.device.command.setColorRGB": "setColorRGB",
@@ -420,8 +423,8 @@
     "mlinkSmartThings.device.command.broadcastAudio": "broadcastAudio",
     "mlinkSmartThings.device.command.chime": "chime",
     "mlinkSmartThings.device.command.controlMediaPlayback": "controlMediaPlayback",
-    "mlinkSmartThings.device.command.coverOpenClose": "coverOpenClose",
-    "mlinkSmartThings.device.command.lockUnlock": "lockUnlock",
+    "mlinkSmartThings.device.command.controlCover": "controlCover",
+    "mlinkSmartThings.device.command.doorLock": "doorLock",
     "mlinkSmartThings.device.command.onOff": "onOff",
     "mlinkSmartThings.device.command.setAudioMute": "setAudioMute",
     "mlinkSmartThings.device.command.setAudioVolume": "setAudioVolume",
@@ -439,8 +442,8 @@
     "playground.device.command.broadcastAudio": "broadcastAudio",
     "playground.device.command.chime": "chime",
     "playground.device.command.controlMediaPlayback": "controlMediaPlayback",
-    "playground.device.command.coverOpenClose": "coverOpenClose",
-    "playground.device.command.lockUnlock": "lockUnlock",
+    "playground.device.command.controlCover": "controlCover",
+    "playground.device.command.doorLock": "doorLock",
     "playground.device.command.onOff": "onOff",
     "playground.device.command.playMedia": "playMedia",
     "playground.device.command.setAudioMute": "setAudioMute",

package/manifest/routing.v1.json

@@ -1,9 +1,9 @@
 {
   "manifest": "mhome.app-facade.routing.v1",
-  "contractVersion": "1.118.4",
+  "contractVersion": "1.125.0",
   "targetPrefix": "/app/",
   "default": {
-    "execution": "scopeMode"
+    "execution": "spaceMode"
   },
   "matching": "exactBeforePrefix",
   "placementJsonPointer": "/input/placement",
@@ -47,7 +47,7 @@
       "/app/billing/subscription/resume",
       "/app/billing/subscription/change"
     ],
-    "scopeModeTargets": [
+    "spaceModeTargets": [
       "/app/artifact/resolve",
       "/app/space/context/get",
       "/app/artifact/put",
@@ -73,7 +73,8 @@
       "/app/host/service/restart",
       "/app/pod/list",
       "/app/now/attention/list",
-      "/app/space/location/list"
+      "/app/space/location/list",
+      "/app/trace/get"
     ],
     "hubPrefixes": [
       "/app/plugin/",

package/manifest/targets.v1.json

@@ -1,6 +1,6 @@
 {
   "manifest": "mhome.messaging.targets.v1",
-  "contractVersion": "1.118.4",
+  "contractVersion": "1.125.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.118.4",
+  "version": "1.125.0",
   "description": "Build-time protocol artifacts for mhome.app-facade",
   "license": "Apache-2.0",
   "repository": {

package/protocol.json

@@ -1,12 +1,13 @@
 {
   "protocol": "mhome.app-facade",
-  "contractVersion": "1.118.4",
+  "contractVersion": "1.125.0",
   "manifest": "manifest/app-facade.v1.json",
   "schemas": {
     "storage": "schema/storage.v1.schema.json",
     "householdRecording": "schema/household-recording.v1.schema.json",
     "nowAttention": "schema/now-attention.v1.schema.json",
     "billing": "schema/billing.v1.schema.json",
+    "userNavigation": "schema/user-navigation.v1.schema.json",
     "pluginInstall": "schema/plugin-install.v1.schema.json",
     "hostAuthorization": "schema/host-authorization.v1.schema.json",
     "hostAccess": "schema/host-access.v1.schema.json",

package/schema/delegated-call.v1.schema.json

@@ -58,7 +58,7 @@
                   "required": [
                     "kind",
                     "tenantId",
-                    "scopeId"
+                    "spaceId"
                   ],
                   "properties": {
                     "kind": {
@@ -68,7 +68,7 @@
                       "type": "string",
                       "minLength": 1
                     },
-                    "scopeId": {
+                    "spaceId": {
                       "type": "string",
                       "minLength": 1
                     }

package/schema/local-hub-state.v1.schema.json

@@ -4,9 +4,9 @@
   "title": "Native-client composite Hub 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/localHub" },
     "operation": { "$ref": "hub-state.v1.schema.json#/$defs/operation" },