@mhome/app-facade-protocol 1.84.1 → 1.89.0

package/fixtures/routing/cases.json

@@ -670,5 +670,37 @@
     "hubReady": false,
     "cloudReady": false,
     "entry": "unavailable"
+  },
+  {
+    "target": "/app/now/attention/list",
+    "execution": "scopeMode",
+    "placement": null,
+    "hubReady": true,
+    "cloudReady": true,
+    "entry": "hub"
+  },
+  {
+    "target": "/app/now/attention/list",
+    "execution": "scopeMode",
+    "placement": null,
+    "hubReady": true,
+    "cloudReady": false,
+    "entry": "hub"
+  },
+  {
+    "target": "/app/now/attention/list",
+    "execution": "scopeMode",
+    "placement": null,
+    "hubReady": false,
+    "cloudReady": true,
+    "entry": "cloud"
+  },
+  {
+    "target": "/app/now/attention/list",
+    "execution": "scopeMode",
+    "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.84.1",
+  "contractVersion": "1.89.0",
   "callSchema": "schema/facade-call.v1.schema.json",
   "routing": "manifest/routing.v1.json",
   "routingSchema": "schema/routing.v1.schema.json",
@@ -209,34 +209,34 @@
       "packageSchema": "schema/card-skin-package.v1.schema.json",
       "requestSchema": "schema/card-skins.v1.schema.json",
       "requests": {
-        "/app/card-skins/catalog/package/get": "#/definitions/packageGet",
-        "/app/card-skins/catalog/package/create": "#/definitions/packageCreate",
-        "/app/card-skins/catalog/package/update": "#/definitions/packageUpdate",
-        "/app/card-skins/catalog/release/list": "#/definitions/packageGet",
-        "/app/card-skins/catalog/release/get": "#/definitions/releaseGet",
-        "/app/card-skins/catalog/publish/prepare": "#/definitions/publishPrepare",
-        "/app/card-skins/catalog/publish/complete": "#/definitions/publishComplete",
-        "/app/card-skins/selection/get": "#/definitions/empty",
-        "/app/card-skins/install": "#/definitions/install",
-        "/app/card-skins/uninstall": "#/definitions/uninstall",
-        "/app/card-skins/upgrade": "#/definitions/upgrade",
-        "/app/card-skins/override/set": "#/definitions/overrideSet",
-        "/app/card-skins/override/reset": "#/definitions/overrideReset"
+        "/app/ui/customize/cards/catalog/package/get": "#/definitions/packageGet",
+        "/app/ui/customize/cards/catalog/package/create": "#/definitions/packageCreate",
+        "/app/ui/customize/cards/catalog/package/update": "#/definitions/packageUpdate",
+        "/app/ui/customize/cards/catalog/release/list": "#/definitions/packageGet",
+        "/app/ui/customize/cards/catalog/release/get": "#/definitions/releaseGet",
+        "/app/ui/customize/cards/catalog/publish/prepare": "#/definitions/publishPrepare",
+        "/app/ui/customize/cards/catalog/publish/complete": "#/definitions/publishComplete",
+        "/app/ui/customize/cards/selection/get": "#/definitions/empty",
+        "/app/ui/customize/cards/install": "#/definitions/install",
+        "/app/ui/customize/cards/uninstall": "#/definitions/uninstall",
+        "/app/ui/customize/cards/upgrade": "#/definitions/upgrade",
+        "/app/ui/customize/cards/override/set": "#/definitions/overrideSet",
+        "/app/ui/customize/cards/override/reset": "#/definitions/overrideReset"
       },
       "responses": {
-        "/app/card-skins/catalog/package/get": "#/definitions/packageSnapshot",
-        "/app/card-skins/catalog/package/create": "#/definitions/empty",
-        "/app/card-skins/catalog/package/update": "#/definitions/empty",
-        "/app/card-skins/catalog/release/list": "#/definitions/releaseList",
-        "/app/card-skins/catalog/release/get": "#/definitions/release",
-        "/app/card-skins/catalog/publish/prepare": "#/definitions/prepared",
-        "/app/card-skins/catalog/publish/complete": "#/definitions/release",
-        "/app/card-skins/selection/get": "#/definitions/selectionView",
-        "/app/card-skins/install": "#/definitions/empty",
-        "/app/card-skins/uninstall": "#/definitions/empty",
-        "/app/card-skins/upgrade": "#/definitions/empty",
-        "/app/card-skins/override/set": "#/definitions/empty",
-        "/app/card-skins/override/reset": "#/definitions/empty"
+        "/app/ui/customize/cards/catalog/package/get": "#/definitions/packageSnapshot",
+        "/app/ui/customize/cards/catalog/package/create": "#/definitions/empty",
+        "/app/ui/customize/cards/catalog/package/update": "#/definitions/empty",
+        "/app/ui/customize/cards/catalog/release/list": "#/definitions/releaseList",
+        "/app/ui/customize/cards/catalog/release/get": "#/definitions/release",
+        "/app/ui/customize/cards/catalog/publish/prepare": "#/definitions/prepared",
+        "/app/ui/customize/cards/catalog/publish/complete": "#/definitions/release",
+        "/app/ui/customize/cards/selection/get": "#/definitions/selectionView",
+        "/app/ui/customize/cards/install": "#/definitions/empty",
+        "/app/ui/customize/cards/uninstall": "#/definitions/empty",
+        "/app/ui/customize/cards/upgrade": "#/definitions/empty",
+        "/app/ui/customize/cards/override/set": "#/definitions/empty",
+        "/app/ui/customize/cards/override/reset": "#/definitions/empty"
       }
     },
     "entityPresentation": {
@@ -295,6 +295,14 @@
       ],
       "owner": "authenticatedClient",
       "persistence": "connection lease only"
+    },
+    "nowAttention": {
+      "schema": "schema/now-attention.v1.schema.json",
+      "contract": "contract/now-attention-v1.md",
+      "requestTargets": [
+        "/app/now/attention/list"
+      ],
+      "policy": "manifest/attention-policy.v1.json"
     }
   },
   "authorization": "manifest/authorization.v1.json",

package/manifest/attention-policy.v1.json

@@ -0,0 +1,18 @@
+{
+  "version": "attention.v1",
+  "threshold": 20.0,
+  "impactWeight": 0.625,
+  "necessityWeight": 0.375,
+  "defaultHalfLifeMs": 900000,
+  "refreshIntervalMs": 30000,
+  "rules": {
+    "dialog.pending": { "impact": 0.4, "necessity": 1.0 },
+    "task.userDecision": { "impact": 0.7, "necessity": 1.0 },
+    "task.manualRecovery": { "impact": 0.7, "necessity": 0.8 },
+    "schedule.decisionRequired": { "impact": 0.4, "necessity": 1.0 },
+    "device.waterDetected": { "impact": 1.0, "necessity": 0.8 },
+    "device.smokeDetected": { "impact": 1.0, "necessity": 0.8 },
+    "device.maintenanceRequired": { "impact": 0.2, "necessity": 0.5 },
+    "system.manualRecovery": { "impact": 0.7, "necessity": 0.8 }
+  }
+}

package/manifest/authorization.v1.json

@@ -1,5 +1,5 @@
 {
-  "contractVersion": "1.84.1",
+  "contractVersion": "1.89.0",
   "operations": {
     "/app/agent/context/get": "spaceRead",
     "/app/agent/credit/usage": "spaceRead",
@@ -47,19 +47,19 @@
     "/app/automation/verify": "spaceWrite",
     "/app/capability/invoke": "spaceWrite",
     "/app/capability/invoke/json": "spaceWrite",
-    "/app/card-skins/catalog/package/create": "userWrite",
-    "/app/card-skins/catalog/package/get": "userRead",
-    "/app/card-skins/catalog/package/update": "userWrite",
-    "/app/card-skins/catalog/publish/complete": "userWrite",
-    "/app/card-skins/catalog/publish/prepare": "userWrite",
-    "/app/card-skins/catalog/release/get": "userRead",
-    "/app/card-skins/catalog/release/list": "userRead",
-    "/app/card-skins/install": "spaceWrite",
-    "/app/card-skins/override/reset": "spaceWrite",
-    "/app/card-skins/override/set": "spaceWrite",
-    "/app/card-skins/selection/get": "spaceRead",
-    "/app/card-skins/uninstall": "spaceWrite",
-    "/app/card-skins/upgrade": "spaceWrite",
+    "/app/ui/customize/cards/catalog/package/create": "userWrite",
+    "/app/ui/customize/cards/catalog/package/get": "userRead",
+    "/app/ui/customize/cards/catalog/package/update": "userWrite",
+    "/app/ui/customize/cards/catalog/publish/complete": "userWrite",
+    "/app/ui/customize/cards/catalog/publish/prepare": "userWrite",
+    "/app/ui/customize/cards/catalog/release/get": "userRead",
+    "/app/ui/customize/cards/catalog/release/list": "userRead",
+    "/app/ui/customize/cards/install": "spaceWrite",
+    "/app/ui/customize/cards/override/reset": "spaceWrite",
+    "/app/ui/customize/cards/override/set": "spaceWrite",
+    "/app/ui/customize/cards/selection/get": "spaceRead",
+    "/app/ui/customize/cards/uninstall": "spaceWrite",
+    "/app/ui/customize/cards/upgrade": "spaceWrite",
     "/app/client/appearance/report": "spaceRead",
     "/app/client/page/current": "spaceRead",
     "/app/client/page/list": "spaceRead",
@@ -401,7 +401,8 @@
     "/app/widget/value/get": "spaceRead",
     "/app/graph/relations/get": "spaceRead",
     "/app/device/view/get": "spaceRead",
-    "/app/client/screenshot/report": "spaceRead"
+    "/app/client/screenshot/report": "spaceRead",
+    "/app/now/attention/list": "spaceRead"
   },
   "nodePrefix": "/app/plugin/",
   "serviceOperations": [

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

@@ -1,13 +1,14 @@
 {
   "manifest": "mhome.host-provision.targets.v1",
-  "contractVersion": "1.84.1",
+  "contractVersion": "1.89.0",
   "contract": "contract/host-provisioning-v1.md",
   "localTargets": [
     "/local/host/provision/start",
     "/local/host/provision/code",
     "/local/host/provision/wifi",
     "/local/host/provision/wifi/scan",
-    "/local/host/provision/status"
+    "/local/host/provision/status",
+    "/local/host/provision/cancel"
   ],
   "eventTargets": [
     "/local/host/provision/changed"

package/manifest/hub-targets.v1.json

@@ -1,6 +1,6 @@
 {
   "manifest": "mhome.hub.targets.v1",
-  "contractVersion": "1.84.1",
+  "contractVersion": "1.89.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.84.1",
+  "contractVersion": "1.89.0",
   "contract": "contract/pod-commissioning-v1.md",
   "localTargets": [
     "/local/pod/discovery/start",

package/manifest/presentation-times.v1.json

@@ -92,5 +92,17 @@
       "items.*.widget.max",
       "items.*.widget.offset"
     ]
+  },
+  "/app/now/attention/list": {
+    "ms": [
+      "evaluatedAt",
+      "nextRefreshAt",
+      "items.*.sourceUpdatedAt",
+      "items.*.validUntil",
+      "items.*.time.occurredAt",
+      "items.*.time.start",
+      "items.*.time.peak",
+      "items.*.time.deadline"
+    ]
   }
 }

package/manifest/routing.v1.json

@@ -1,6 +1,6 @@
 {
   "manifest": "mhome.app-facade.routing.v1",
-  "contractVersion": "1.84.1",
+  "contractVersion": "1.89.0",
   "targetPrefix": "/app/",
   "default": {
     "execution": "scopeMode"
@@ -12,7 +12,7 @@
       "/app/space/",
       "/app/inspire/",
       "/app/user/",
-      "/app/card-skins/catalog/"
+      "/app/ui/customize/cards/catalog/"
     ],
     "cloudTargets": [
       "/app/agent/context/get",
@@ -61,7 +61,8 @@
       "/app/host/permissions/get",
       "/app/host/service/install",
       "/app/host/service/restart",
-      "/app/pod/list"
+      "/app/pod/list",
+      "/app/now/attention/list"
     ],
     "hubPrefixes": [
       "/app/plugin/",

package/manifest/targets.v1.json

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

package/protocol.json

@@ -1,8 +1,9 @@
 {
   "protocol": "mhome.app-facade",
-  "contractVersion": "1.84.1",
+  "contractVersion": "1.89.0",
   "manifest": "manifest/app-facade.v1.json",
   "schemas": {
+    "nowAttention": "schema/now-attention.v1.schema.json",
     "pluginInstall": "schema/plugin-install.v1.schema.json",
     "hostAuthorization": "schema/host-authorization.v1.schema.json",
     "hostAccess": "schema/host-access.v1.schema.json",
@@ -31,6 +32,7 @@
     "person": "schema/person.v1.schema.json"
   },
   "fixtures": {
+    "attention": "fixtures/attention/conformance.json",
     "agentLlm": "fixtures/agent-llm.conformance.json",
     "entityPresentation": "fixtures/entity-presentation.conformance.json",
     "integrationPresentation": "fixtures/integration-presentation.conformance.json",

package/schema/card-skin-package.v1.schema.json

@@ -7,6 +7,7 @@
   "required": [
     "schemaVersion",
     "packageId",
+    "baseUi",
     "version",
     "name",
     "description",
@@ -60,6 +61,11 @@
         "$ref": "#/definitions/file"
       },
       "maxItems": 128
+    },
+    "baseUi": {
+      "type": "string",
+      "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
+      "maxLength": 128
     }
   },
   "definitions": {
@@ -192,7 +198,8 @@
         "description",
         "apiVersion",
         "renderers",
-        "entry"
+        "entry",
+        "baseUi"
       ],
       "properties": {
         "schemaVersion": {
@@ -231,6 +238,11 @@
         "entry": {
           "type": "string",
           "minLength": 1
+        },
+        "baseUi": {
+          "type": "string",
+          "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
+          "maxLength": 128
         }
       }
     }

package/schema/card-skins.v1.schema.json

@@ -39,12 +39,18 @@
         "description": {
           "type": "string",
           "maxLength": 2000
+        },
+        "baseUi": {
+          "type": "string",
+          "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
+          "maxLength": 128
         }
       },
       "required": [
         "packageId",
         "name",
-        "description"
+        "description",
+        "baseUi"
       ]
     },
     "packageUpdate": {
@@ -144,12 +150,18 @@
           "type": "string",
           "pattern": "^(0|[1-9][0-9]*)\\.(0|[1-9][0-9]*)\\.(0|[1-9][0-9]*)(-((0|[1-9][0-9]*|[0-9]*[A-Za-z-][0-9A-Za-z-]*)(\\.(0|[1-9][0-9]*|[0-9]*[A-Za-z-][0-9A-Za-z-]*))*))?(\\+[0-9A-Za-z-]+(\\.[0-9A-Za-z-]+)*)?$",
           "maxLength": 128
+        },
+        "baseUi": {
+          "type": "string",
+          "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
+          "maxLength": 128
         }
       },
       "required": [
         "expectedRevision",
         "packageId",
-        "version"
+        "version",
+        "baseUi"
       ]
     },
     "uninstall": {
@@ -233,6 +245,11 @@
         },
         "config": {
           "type": "object"
+        },
+        "baseUi": {
+          "type": "string",
+          "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
+          "maxLength": 128
         }
       },
       "required": [
@@ -240,7 +257,8 @@
         "patternId",
         "installationId",
         "rendererId",
-        "config"
+        "config",
+        "baseUi"
       ]
     },
     "overrideReset": {
@@ -259,11 +277,17 @@
           "type": "string",
           "minLength": 1,
           "maxLength": 512
+        },
+        "baseUi": {
+          "type": "string",
+          "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
+          "maxLength": 128
         }
       },
       "required": [
         "expectedRevision",
-        "patternId"
+        "patternId",
+        "baseUi"
       ]
     },
     "packageInfo": {
@@ -274,7 +298,8 @@
         "authorUserId",
         "name",
         "description",
-        "createdAt"
+        "createdAt",
+        "baseUi"
       ],
       "properties": {
         "packageId": {
@@ -299,6 +324,11 @@
         "createdAt": {
           "type": "integer",
           "minimum": 0
+        },
+        "baseUi": {
+          "type": "string",
+          "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
+          "maxLength": 128
         }
       }
     },
@@ -365,7 +395,8 @@
       "required": [
         "id",
         "spaceId",
-        "releaseId"
+        "releaseId",
+        "baseUi"
       ],
       "properties": {
         "id": {
@@ -382,6 +413,11 @@
           "type": "string",
           "minLength": 1,
           "maxLength": 512
+        },
+        "baseUi": {
+          "type": "string",
+          "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
+          "maxLength": 128
         }
       }
     },
@@ -393,7 +429,8 @@
         "patternId",
         "installationId",
         "rendererId",
-        "config"
+        "config",
+        "baseUi"
       ],
       "properties": {
         "spaceId": {
@@ -418,6 +455,11 @@
         },
         "config": {
           "type": "object"
+        },
+        "baseUi": {
+          "type": "string",
+          "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
+          "maxLength": 128
         }
       }
     },

package/schema/host-provision.v1.schema.json

@@ -16,6 +16,8 @@
         "reading_info",
         "awaiting_wifi",
         "joining_wifi",
+        "cancelling",
+        "cancelled",
         "completed",
         "failed",
         "timed_out"