@mhome/app-facade-protocol 1.85.0 → 1.90.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (23) hide show
  1. package/README.md +8 -4
  2. package/contract/card-skins-v1.md +63 -41
  3. package/contract/host-provisioning-v1.md +39 -26
  4. package/contract/now-attention-v1.md +56 -0
  5. package/fixtures/attention/conformance.json +263 -0
  6. package/fixtures/authorization/decisions.json +88 -0
  7. package/fixtures/card-skins/space.json +6 -3
  8. package/fixtures/presentation/cases.json +222 -51
  9. package/fixtures/routing/cases.json +32 -0
  10. package/manifest/app-facade.v1.json +35 -27
  11. package/manifest/attention-policy.v1.json +18 -0
  12. package/manifest/authorization.v1.json +16 -15
  13. package/manifest/host-provision-targets.v1.json +1 -1
  14. package/manifest/hub-targets.v1.json +1 -1
  15. package/manifest/pod-targets.v1.json +1 -1
  16. package/manifest/presentation-times.v1.json +12 -0
  17. package/manifest/routing.v1.json +4 -3
  18. package/manifest/targets.v1.json +1 -1
  19. package/package.json +1 -1
  20. package/protocol.json +3 -1
  21. package/schema/card-skin-package.v1.schema.json +13 -1
  22. package/schema/card-skins.v1.schema.json +62 -23
  23. package/schema/now-attention.v1.schema.json +259 -0
package/fixtures/routing/cases.json CHANGED
@@ -670,5 +670,37 @@
670
670
  "hubReady": false,
671
671
  "cloudReady": false,
672
672
  "entry": "unavailable"
673
+ },
674
+ {
675
+ "target": "/app/now/attention/list",
676
+ "execution": "scopeMode",
677
+ "placement": null,
678
+ "hubReady": true,
679
+ "cloudReady": true,
680
+ "entry": "hub"
681
+ },
682
+ {
683
+ "target": "/app/now/attention/list",
684
+ "execution": "scopeMode",
685
+ "placement": null,
686
+ "hubReady": true,
687
+ "cloudReady": false,
688
+ "entry": "hub"
689
+ },
690
+ {
691
+ "target": "/app/now/attention/list",
692
+ "execution": "scopeMode",
693
+ "placement": null,
694
+ "hubReady": false,
695
+ "cloudReady": true,
696
+ "entry": "cloud"
697
+ },
698
+ {
699
+ "target": "/app/now/attention/list",
700
+ "execution": "scopeMode",
701
+ "placement": null,
702
+ "hubReady": false,
703
+ "cloudReady": false,
704
+ "entry": "unavailable"
673
705
  }
674
706
  ]
package/manifest/app-facade.v1.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "manifest": "mhome.app-facade.v1",
3
- "contractVersion": "1.85.0",
3
+ "contractVersion": "1.90.1",
4
4
  "callSchema": "schema/facade-call.v1.schema.json",
5
5
  "routing": "manifest/routing.v1.json",
6
6
  "routingSchema": "schema/routing.v1.schema.json",
@@ -209,34 +209,34 @@
209
209
  "packageSchema": "schema/card-skin-package.v1.schema.json",
210
210
  "requestSchema": "schema/card-skins.v1.schema.json",
211
211
  "requests": {
212
- "/app/card-skins/catalog/package/get": "#/definitions/packageGet",
213
- "/app/card-skins/catalog/package/create": "#/definitions/packageCreate",
214
- "/app/card-skins/catalog/package/update": "#/definitions/packageUpdate",
215
- "/app/card-skins/catalog/release/list": "#/definitions/packageGet",
216
- "/app/card-skins/catalog/release/get": "#/definitions/releaseGet",
217
- "/app/card-skins/catalog/publish/prepare": "#/definitions/publishPrepare",
218
- "/app/card-skins/catalog/publish/complete": "#/definitions/publishComplete",
219
- "/app/card-skins/selection/get": "#/definitions/empty",
220
- "/app/card-skins/install": "#/definitions/install",
221
- "/app/card-skins/uninstall": "#/definitions/uninstall",
222
- "/app/card-skins/upgrade": "#/definitions/upgrade",
223
- "/app/card-skins/override/set": "#/definitions/overrideSet",
224
- "/app/card-skins/override/reset": "#/definitions/overrideReset"
212
+ "/app/ui/customize/cards/catalog/package/get": "#/definitions/packageGet",
213
+ "/app/ui/customize/cards/catalog/package/create": "#/definitions/packageCreate",
214
+ "/app/ui/customize/cards/catalog/package/update": "#/definitions/packageUpdate",
215
+ "/app/ui/customize/cards/catalog/release/list": "#/definitions/packageGet",
216
+ "/app/ui/customize/cards/catalog/release/get": "#/definitions/releaseGet",
217
+ "/app/ui/customize/cards/catalog/publish/prepare": "#/definitions/publishPrepare",
218
+ "/app/ui/customize/cards/catalog/publish/complete": "#/definitions/publishComplete",
219
+ "/app/ui/customize/cards/selection/get": "#/definitions/empty",
220
+ "/app/ui/customize/cards/install": "#/definitions/install",
221
+ "/app/ui/customize/cards/uninstall": "#/definitions/uninstall",
222
+ "/app/ui/customize/cards/upgrade": "#/definitions/upgrade",
223
+ "/app/ui/customize/cards/override/set": "#/definitions/overrideSet",
224
+ "/app/ui/customize/cards/override/reset": "#/definitions/overrideReset"
225
225
  },
226
226
  "responses": {
227
- "/app/card-skins/catalog/package/get": "#/definitions/packageSnapshot",
228
- "/app/card-skins/catalog/package/create": "#/definitions/empty",
229
- "/app/card-skins/catalog/package/update": "#/definitions/empty",
230
- "/app/card-skins/catalog/release/list": "#/definitions/releaseList",
231
- "/app/card-skins/catalog/release/get": "#/definitions/release",
232
- "/app/card-skins/catalog/publish/prepare": "#/definitions/prepared",
233
- "/app/card-skins/catalog/publish/complete": "#/definitions/release",
234
- "/app/card-skins/selection/get": "#/definitions/selectionView",
235
- "/app/card-skins/install": "#/definitions/empty",
236
- "/app/card-skins/uninstall": "#/definitions/empty",
237
- "/app/card-skins/upgrade": "#/definitions/empty",
238
- "/app/card-skins/override/set": "#/definitions/empty",
239
- "/app/card-skins/override/reset": "#/definitions/empty"
227
+ "/app/ui/customize/cards/catalog/package/get": "#/definitions/packageSnapshot",
228
+ "/app/ui/customize/cards/catalog/package/create": "#/definitions/empty",
229
+ "/app/ui/customize/cards/catalog/package/update": "#/definitions/empty",
230
+ "/app/ui/customize/cards/catalog/release/list": "#/definitions/releaseList",
231
+ "/app/ui/customize/cards/catalog/release/get": "#/definitions/release",
232
+ "/app/ui/customize/cards/catalog/publish/prepare": "#/definitions/prepared",
233
+ "/app/ui/customize/cards/catalog/publish/complete": "#/definitions/release",
234
+ "/app/ui/customize/cards/selection/get": "#/definitions/selectionView",
235
+ "/app/ui/customize/cards/install": "#/definitions/empty",
236
+ "/app/ui/customize/cards/uninstall": "#/definitions/empty",
237
+ "/app/ui/customize/cards/upgrade": "#/definitions/empty",
238
+ "/app/ui/customize/cards/override/set": "#/definitions/empty",
239
+ "/app/ui/customize/cards/override/reset": "#/definitions/empty"
240
240
  }
241
241
  },
242
242
  "entityPresentation": {
@@ -295,6 +295,14 @@
295
295
  ],
296
296
  "owner": "authenticatedClient",
297
297
  "persistence": "connection lease only"
298
+ },
299
+ "nowAttention": {
300
+ "schema": "schema/now-attention.v1.schema.json",
301
+ "contract": "contract/now-attention-v1.md",
302
+ "requestTargets": [
303
+ "/app/now/attention/list"
304
+ ],
305
+ "policy": "manifest/attention-policy.v1.json"
298
306
  }
299
307
  },
300
308
  "authorization": "manifest/authorization.v1.json",
package/manifest/attention-policy.v1.json ADDED
@@ -0,0 +1,18 @@
1
+ {
2
+ "version": "attention.v1",
3
+ "threshold": 20.0,
4
+ "impactWeight": 0.625,
5
+ "necessityWeight": 0.375,
6
+ "defaultHalfLifeMs": 900000,
7
+ "refreshIntervalMs": 30000,
8
+ "rules": {
9
+ "dialog.pending": { "impact": 0.4, "necessity": 1.0 },
10
+ "task.userDecision": { "impact": 0.7, "necessity": 1.0 },
11
+ "task.manualRecovery": { "impact": 0.7, "necessity": 0.8 },
12
+ "schedule.decisionRequired": { "impact": 0.4, "necessity": 1.0 },
13
+ "device.waterDetected": { "impact": 1.0, "necessity": 0.8 },
14
+ "device.smokeDetected": { "impact": 1.0, "necessity": 0.8 },
15
+ "device.maintenanceRequired": { "impact": 0.2, "necessity": 0.5 },
16
+ "system.manualRecovery": { "impact": 0.7, "necessity": 0.8 }
17
+ }
18
+ }
package/manifest/authorization.v1.json CHANGED
@@ -1,5 +1,5 @@
1
1
  {
2
- "contractVersion": "1.85.0",
2
+ "contractVersion": "1.90.1",
3
3
  "operations": {
4
4
  "/app/agent/context/get": "spaceRead",
5
5
  "/app/agent/credit/usage": "spaceRead",
@@ -47,19 +47,19 @@
47
47
  "/app/automation/verify": "spaceWrite",
48
48
  "/app/capability/invoke": "spaceWrite",
49
49
  "/app/capability/invoke/json": "spaceWrite",
50
- "/app/card-skins/catalog/package/create": "userWrite",
51
- "/app/card-skins/catalog/package/get": "userRead",
52
- "/app/card-skins/catalog/package/update": "userWrite",
53
- "/app/card-skins/catalog/publish/complete": "userWrite",
54
- "/app/card-skins/catalog/publish/prepare": "userWrite",
55
- "/app/card-skins/catalog/release/get": "userRead",
56
- "/app/card-skins/catalog/release/list": "userRead",
57
- "/app/card-skins/install": "spaceWrite",
58
- "/app/card-skins/override/reset": "spaceWrite",
59
- "/app/card-skins/override/set": "spaceWrite",
60
- "/app/card-skins/selection/get": "spaceRead",
61
- "/app/card-skins/uninstall": "spaceWrite",
62
- "/app/card-skins/upgrade": "spaceWrite",
50
+ "/app/ui/customize/cards/catalog/package/create": "userWrite",
51
+ "/app/ui/customize/cards/catalog/package/get": "userRead",
52
+ "/app/ui/customize/cards/catalog/package/update": "userWrite",
53
+ "/app/ui/customize/cards/catalog/publish/complete": "userWrite",
54
+ "/app/ui/customize/cards/catalog/publish/prepare": "userWrite",
55
+ "/app/ui/customize/cards/catalog/release/get": "userRead",
56
+ "/app/ui/customize/cards/catalog/release/list": "userRead",
57
+ "/app/ui/customize/cards/install": "spaceWrite",
58
+ "/app/ui/customize/cards/override/reset": "spaceWrite",
59
+ "/app/ui/customize/cards/override/set": "spaceWrite",
60
+ "/app/ui/customize/cards/selection/get": "spaceRead",
61
+ "/app/ui/customize/cards/uninstall": "spaceWrite",
62
+ "/app/ui/customize/cards/upgrade": "spaceWrite",
63
63
  "/app/client/appearance/report": "spaceRead",
64
64
  "/app/client/page/current": "spaceRead",
65
65
  "/app/client/page/list": "spaceRead",
@@ -401,7 +401,8 @@
401
401
  "/app/widget/value/get": "spaceRead",
402
402
  "/app/graph/relations/get": "spaceRead",
403
403
  "/app/device/view/get": "spaceRead",
404
- "/app/client/screenshot/report": "spaceRead"
404
+ "/app/client/screenshot/report": "spaceRead",
405
+ "/app/now/attention/list": "spaceRead"
405
406
  },
406
407
  "nodePrefix": "/app/plugin/",
407
408
  "serviceOperations": [
package/manifest/host-provision-targets.v1.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "manifest": "mhome.host-provision.targets.v1",
3
- "contractVersion": "1.85.0",
3
+ "contractVersion": "1.90.1",
4
4
  "contract": "contract/host-provisioning-v1.md",
5
5
  "localTargets": [
6
6
  "/local/host/provision/start",
package/manifest/hub-targets.v1.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "manifest": "mhome.hub.targets.v1",
3
- "contractVersion": "1.85.0",
3
+ "contractVersion": "1.90.1",
4
4
  "appTargets": [
5
5
  "/app/hub/get",
6
6
  "/app/hub/remove",
package/manifest/pod-targets.v1.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "manifest": "mhome.pod.targets.v1",
3
- "contractVersion": "1.85.0",
3
+ "contractVersion": "1.90.1",
4
4
  "contract": "contract/pod-commissioning-v1.md",
5
5
  "localTargets": [
6
6
  "/local/pod/discovery/start",
package/manifest/presentation-times.v1.json CHANGED
@@ -92,5 +92,17 @@
92
92
  "items.*.widget.max",
93
93
  "items.*.widget.offset"
94
94
  ]
95
+ },
96
+ "/app/now/attention/list": {
97
+ "ms": [
98
+ "evaluatedAt",
99
+ "nextRefreshAt",
100
+ "items.*.sourceUpdatedAt",
101
+ "items.*.validUntil",
102
+ "items.*.time.occurredAt",
103
+ "items.*.time.start",
104
+ "items.*.time.peak",
105
+ "items.*.time.deadline"
106
+ ]
95
107
  }
96
108
  }
package/manifest/routing.v1.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "manifest": "mhome.app-facade.routing.v1",
3
- "contractVersion": "1.85.0",
3
+ "contractVersion": "1.90.1",
4
4
  "targetPrefix": "/app/",
5
5
  "default": {
6
6
  "execution": "scopeMode"
@@ -12,7 +12,7 @@
12
12
  "/app/space/",
13
13
  "/app/inspire/",
14
14
  "/app/user/",
15
- "/app/card-skins/catalog/"
15
+ "/app/ui/customize/cards/catalog/"
16
16
  ],
17
17
  "cloudTargets": [
18
18
  "/app/agent/context/get",
@@ -61,7 +61,8 @@
61
61
  "/app/host/permissions/get",
62
62
  "/app/host/service/install",
63
63
  "/app/host/service/restart",
64
- "/app/pod/list"
64
+ "/app/pod/list",
65
+ "/app/now/attention/list"
65
66
  ],
66
67
  "hubPrefixes": [
67
68
  "/app/plugin/",
package/manifest/targets.v1.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "manifest": "mhome.messaging.targets.v1",
3
- "contractVersion": "1.85.0",
3
+ "contractVersion": "1.90.1",
4
4
  "requestTargets": [
5
5
  "/app/messaging/provider/list",
6
6
  "/app/messaging/provider-account/list",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@mhome/app-facade-protocol",
3
- "version": "1.85.0",
3
+ "version": "1.90.1",
4
4
  "description": "Build-time protocol artifacts for mhome.app-facade",
5
5
  "license": "MIT",
6
6
  "repository": {
package/protocol.json CHANGED
@@ -1,8 +1,9 @@
1
1
  {
2
2
  "protocol": "mhome.app-facade",
3
- "contractVersion": "1.85.0",
3
+ "contractVersion": "1.90.1",
4
4
  "manifest": "manifest/app-facade.v1.json",
5
5
  "schemas": {
6
+ "nowAttention": "schema/now-attention.v1.schema.json",
6
7
  "pluginInstall": "schema/plugin-install.v1.schema.json",
7
8
  "hostAuthorization": "schema/host-authorization.v1.schema.json",
8
9
  "hostAccess": "schema/host-access.v1.schema.json",
@@ -31,6 +32,7 @@
31
32
  "person": "schema/person.v1.schema.json"
32
33
  },
33
34
  "fixtures": {
35
+ "attention": "fixtures/attention/conformance.json",
34
36
  "agentLlm": "fixtures/agent-llm.conformance.json",
35
37
  "entityPresentation": "fixtures/entity-presentation.conformance.json",
36
38
  "integrationPresentation": "fixtures/integration-presentation.conformance.json",
package/schema/card-skin-package.v1.schema.json CHANGED
@@ -7,6 +7,7 @@
7
7
  "required": [
8
8
  "schemaVersion",
9
9
  "packageId",
10
+ "baseUi",
10
11
  "version",
11
12
  "name",
12
13
  "description",
@@ -60,6 +61,11 @@
60
61
  "$ref": "#/definitions/file"
61
62
  },
62
63
  "maxItems": 128
64
+ },
65
+ "baseUi": {
66
+ "type": "string",
67
+ "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
68
+ "maxLength": 128
63
69
  }
64
70
  },
65
71
  "definitions": {
@@ -192,7 +198,8 @@
192
198
  "description",
193
199
  "apiVersion",
194
200
  "renderers",
195
- "entry"
201
+ "entry",
202
+ "baseUi"
196
203
  ],
197
204
  "properties": {
198
205
  "schemaVersion": {
@@ -231,6 +238,11 @@
231
238
  "entry": {
232
239
  "type": "string",
233
240
  "minLength": 1
241
+ },
242
+ "baseUi": {
243
+ "type": "string",
244
+ "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
245
+ "maxLength": 128
234
246
  }
235
247
  }
236
248
  }
package/schema/card-skins.v1.schema.json CHANGED
@@ -39,12 +39,18 @@
39
39
  "description": {
40
40
  "type": "string",
41
41
  "maxLength": 2000
42
+ },
43
+ "baseUi": {
44
+ "type": "string",
45
+ "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
46
+ "maxLength": 128
42
47
  }
43
48
  },
44
49
  "required": [
45
50
  "packageId",
46
51
  "name",
47
- "description"
52
+ "description",
53
+ "baseUi"
48
54
  ]
49
55
  },
50
56
  "packageUpdate": {
@@ -144,12 +150,18 @@
144
150
  "type": "string",
145
151
  "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-]+)*)?$",
146
152
  "maxLength": 128
153
+ },
154
+ "baseUi": {
155
+ "type": "string",
156
+ "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
157
+ "maxLength": 128
147
158
  }
148
159
  },
149
160
  "required": [
150
161
  "expectedRevision",
151
162
  "packageId",
152
- "version"
163
+ "version",
164
+ "baseUi"
153
165
  ]
154
166
  },
155
167
  "uninstall": {
@@ -233,6 +245,11 @@
233
245
  },
234
246
  "config": {
235
247
  "type": "object"
248
+ },
249
+ "baseUi": {
250
+ "type": "string",
251
+ "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
252
+ "maxLength": 128
236
253
  }
237
254
  },
238
255
  "required": [
@@ -240,7 +257,8 @@
240
257
  "patternId",
241
258
  "installationId",
242
259
  "rendererId",
243
- "config"
260
+ "config",
261
+ "baseUi"
244
262
  ]
245
263
  },
246
264
  "overrideReset": {
@@ -259,11 +277,17 @@
259
277
  "type": "string",
260
278
  "minLength": 1,
261
279
  "maxLength": 512
280
+ },
281
+ "baseUi": {
282
+ "type": "string",
283
+ "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
284
+ "maxLength": 128
262
285
  }
263
286
  },
264
287
  "required": [
265
288
  "expectedRevision",
266
- "patternId"
289
+ "patternId",
290
+ "baseUi"
267
291
  ]
268
292
  },
269
293
  "packageInfo": {
@@ -274,7 +298,8 @@
274
298
  "authorUserId",
275
299
  "name",
276
300
  "description",
277
- "createdAt"
301
+ "createdAt",
302
+ "baseUi"
278
303
  ],
279
304
  "properties": {
280
305
  "packageId": {
@@ -299,6 +324,11 @@
299
324
  "createdAt": {
300
325
  "type": "integer",
301
326
  "minimum": 0
327
+ },
328
+ "baseUi": {
329
+ "type": "string",
330
+ "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
331
+ "maxLength": 128
302
332
  }
303
333
  }
304
334
  },
@@ -365,7 +395,8 @@
365
395
  "required": [
366
396
  "id",
367
397
  "spaceId",
368
- "releaseId"
398
+ "releaseId",
399
+ "baseUi"
369
400
  ],
370
401
  "properties": {
371
402
  "id": {
@@ -382,6 +413,11 @@
382
413
  "type": "string",
383
414
  "minLength": 1,
384
415
  "maxLength": 512
416
+ },
417
+ "baseUi": {
418
+ "type": "string",
419
+ "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
420
+ "maxLength": 128
385
421
  }
386
422
  }
387
423
  },
@@ -393,7 +429,8 @@
393
429
  "patternId",
394
430
  "installationId",
395
431
  "rendererId",
396
- "config"
432
+ "config",
433
+ "baseUi"
397
434
  ],
398
435
  "properties": {
399
436
  "spaceId": {
@@ -418,6 +455,11 @@
418
455
  },
419
456
  "config": {
420
457
  "type": "object"
458
+ },
459
+ "baseUi": {
460
+ "type": "string",
461
+ "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
462
+ "maxLength": 128
421
463
  }
422
464
  }
423
465
  },
@@ -510,22 +552,19 @@
510
552
  },
511
553
  "headers": {
512
554
  "type": "object",
513
- "additionalProperties": false,
514
- "required": [
515
- "Authorization",
516
- "Content-Type"
517
- ],
518
- "properties": {
519
- "Authorization": {
520
- "type": "string",
521
- "minLength": 1,
522
- "maxLength": 512
523
- },
524
- "Content-Type": {
525
- "type": "string",
526
- "minLength": 1,
527
- "maxLength": 512
528
- }
555
+ "minProperties": 1,
556
+ "maxProperties": 32,
557
+ "propertyNames": {
558
+ "type": "string",
559
+ "minLength": 1,
560
+ "maxLength": 128,
561
+ "pattern": "^[!#$%&'*+.^_`|~0-9A-Za-z-]+$"
562
+ },
563
+ "additionalProperties": {
564
+ "type": "string",
565
+ "minLength": 1,
566
+ "maxLength": 8192,
567
+ "pattern": "^[^\\r\\n]*$"
529
568
  }
530
569
  }
531
570
  }