@mhome/app-facade-protocol 1.18.2 → 1.19.0

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 (11) hide show
  1. package/README.md +0 -12
  2. package/manifest/app-facade.v1.json +6 -14
  3. package/manifest/hub-targets.v1.json +1 -1
  4. package/manifest/routing.v1.json +2 -2
  5. package/manifest/targets.v1.json +1 -1
  6. package/package.json +1 -1
  7. package/protocol.json +2 -3
  8. package/fixtures/device-topology.graph-conformance.json +0 -3309
  9. package/fixtures/device-topology.partial.json +0 -111
  10. package/fixtures/device-topology.snapshot.json +0 -170
  11. package/schema/device-topology.v1.schema.json +0 -305
package/fixtures/device-topology.partial.json DELETED
@@ -1,111 +0,0 @@
1
- {
2
- "contract": "mhome.device.topology.v1",
3
- "scopeId": "space-1",
4
- "generation": "generation-1",
5
- "revision": 8,
6
- "observedAtMs": 1777777778000,
7
- "completeness": "partial",
8
- "issues": [
9
- {
10
- "code": "matterUnavailable",
11
- "message": "Matter device details are temporarily unavailable",
12
- "entityId": "connection:mlinkMatter.device:matter-1"
13
- }
14
- ],
15
- "entities": [
16
- {
17
- "kind": "deviceIntegration",
18
- "id": "integration:basic.device",
19
- "integrationId": "basic.device",
20
- "displayName": "Devices"
21
- },
22
- {
23
- "kind": "provider",
24
- "id": "provider:mlinkMatter.device",
25
- "integrationId": "mlinkMatter.device",
26
- "displayName": "Matter",
27
- "mode": "local",
28
- "multiConnect": false
29
- },
30
- {
31
- "kind": "connection",
32
- "id": "connection:mlinkMatter.device:matter-1",
33
- "integrationId": "mlinkMatter.device",
34
- "connectionId": "matter-1",
35
- "displayName": "Living Room Mac",
36
- "runtime": {
37
- "state": "offline",
38
- "reason": "Service unavailable",
39
- "updatedAtMs": 1777777778000
40
- }
41
- },
42
- {
43
- "kind": "pluginInstance",
44
- "id": "plugin:matter-1",
45
- "nodeId": "matter-1",
46
- "nodeType": "matter",
47
- "hostId": "host-1",
48
- "serviceInstanceId": "service-1",
49
- "displayName": "Matter Service",
50
- "hostDisplayName": "Living Room Mac",
51
- "runtime": {
52
- "state": "offline",
53
- "reason": "Service unavailable",
54
- "updatedAtMs": 1777777778000
55
- }
56
- }
57
- ],
58
- "edges": [
59
- {
60
- "id": "edge:integration-provider",
61
- "source": "integration:basic.device",
62
- "target": "provider:mlinkMatter.device",
63
- "relation": "integration-provider",
64
- "basis": "integrationInstall",
65
- "durability": "durable",
66
- "observation": {
67
- "state": "connected",
68
- "observedAtMs": 1777777778000
69
- }
70
- },
71
- {
72
- "id": "edge:provider-connection",
73
- "source": "provider:mlinkMatter.device",
74
- "target": "connection:mlinkMatter.device:matter-1",
75
- "relation": "provider-connection",
76
- "basis": "connectionOwnership",
77
- "durability": "durable",
78
- "observation": {
79
- "state": "disconnected",
80
- "observedAtMs": 1777777778000,
81
- "reason": "Service unavailable"
82
- }
83
- },
84
- {
85
- "id": "edge:plugin-provider",
86
- "source": "plugin:matter-1",
87
- "target": "provider:mlinkMatter.device",
88
- "relation": "plugin-provider",
89
- "basis": "pluginBinding",
90
- "durability": "durable",
91
- "observation": {
92
- "state": "disconnected",
93
- "observedAtMs": 1777777778000,
94
- "reason": "Service unavailable"
95
- }
96
- },
97
- {
98
- "id": "edge:plugin-connection",
99
- "source": "plugin:matter-1",
100
- "target": "connection:mlinkMatter.device:matter-1",
101
- "relation": "plugin-connection",
102
- "basis": "pluginBinding",
103
- "durability": "durable",
104
- "observation": {
105
- "state": "disconnected",
106
- "observedAtMs": 1777777778000,
107
- "reason": "Service unavailable"
108
- }
109
- }
110
- ]
111
- }
package/fixtures/device-topology.snapshot.json DELETED
@@ -1,170 +0,0 @@
1
- {
2
- "contract": "mhome.device.topology.v1",
3
- "scopeId": "space-1",
4
- "generation": "generation-1",
5
- "revision": 7,
6
- "observedAtMs": 1777777777000,
7
- "completeness": "complete",
8
- "issues": [],
9
- "entities": [
10
- {
11
- "kind": "deviceIntegration",
12
- "id": "integration:basic.device",
13
- "integrationId": "basic.device",
14
- "displayName": "Devices"
15
- },
16
- {
17
- "kind": "provider",
18
- "id": "provider:mlinkMatter.device",
19
- "integrationId": "mlinkMatter.device",
20
- "displayName": "Matter",
21
- "mode": "local",
22
- "multiConnect": false
23
- },
24
- {
25
- "kind": "connection",
26
- "id": "connection:mlinkMatter.device:matter-1",
27
- "integrationId": "mlinkMatter.device",
28
- "connectionId": "matter-1",
29
- "displayName": "Living Room Mac",
30
- "runtime": {
31
- "state": "healthy",
32
- "updatedAtMs": 1777777777000
33
- }
34
- },
35
- {
36
- "kind": "pluginInstance",
37
- "id": "plugin:matter-1",
38
- "nodeId": "matter-1",
39
- "nodeType": "matter",
40
- "hostId": "host-1",
41
- "serviceInstanceId": "service-1",
42
- "displayName": "Matter Service",
43
- "hostDisplayName": "Living Room Mac",
44
- "runtime": {
45
- "state": "healthy",
46
- "updatedAtMs": 1777777777000
47
- }
48
- },
49
- {
50
- "kind": "matterBridge",
51
- "id": "source:matter:node-123",
52
- "nodeId": "node-123",
53
- "displayName": "Aqara Matter Bridge",
54
- "runtime": {
55
- "state": "healthy",
56
- "updatedAtMs": 1777777777000
57
- }
58
- },
59
- {
60
- "kind": "device",
61
- "id": "device:desk-light",
62
- "entityId": "desk-light",
63
- "integrationId": "mlinkMatter.device",
64
- "displayName": "Desk Light",
65
- "enabled": true,
66
- "runtime": {
67
- "state": "healthy",
68
- "updatedAtMs": 1777777777000
69
- }
70
- }
71
- ],
72
- "edges": [
73
- {
74
- "id": "edge:integration-provider",
75
- "source": "integration:basic.device",
76
- "target": "provider:mlinkMatter.device",
77
- "relation": "integration-provider",
78
- "basis": "integrationInstall",
79
- "durability": "durable",
80
- "observation": {
81
- "state": "connected",
82
- "observedAtMs": 1777777777000
83
- }
84
- },
85
- {
86
- "id": "edge:plugin-provider",
87
- "source": "plugin:matter-1",
88
- "target": "provider:mlinkMatter.device",
89
- "relation": "plugin-provider",
90
- "basis": "pluginBinding",
91
- "durability": "durable",
92
- "observation": {
93
- "state": "connected",
94
- "observedAtMs": 1777777777000
95
- }
96
- },
97
- {
98
- "id": "edge:plugin-connection",
99
- "source": "plugin:matter-1",
100
- "target": "connection:mlinkMatter.device:matter-1",
101
- "relation": "plugin-connection",
102
- "basis": "pluginBinding",
103
- "durability": "durable",
104
- "observation": {
105
- "state": "connected",
106
- "observedAtMs": 1777777777000
107
- }
108
- },
109
- {
110
- "id": "edge:provider-connection",
111
- "source": "provider:mlinkMatter.device",
112
- "target": "connection:mlinkMatter.device:matter-1",
113
- "relation": "provider-connection",
114
- "basis": "connectionOwnership",
115
- "durability": "durable",
116
- "observation": {
117
- "state": "connected",
118
- "observedAtMs": 1777777777000
119
- }
120
- },
121
- {
122
- "id": "edge:connection-bridge",
123
- "source": "connection:mlinkMatter.device:matter-1",
124
- "target": "source:matter:node-123",
125
- "relation": "connection-bridge",
126
- "basis": "sourceProjection",
127
- "durability": "durable",
128
- "observation": {
129
- "state": "connected",
130
- "observedAtMs": 1777777777000
131
- }
132
- },
133
- {
134
- "id": "edge:bridge-device",
135
- "source": "source:matter:node-123",
136
- "target": "device:desk-light",
137
- "relation": "bridge-device",
138
- "basis": "sourceProjection",
139
- "durability": "durable",
140
- "observation": {
141
- "state": "connected",
142
- "observedAtMs": 1777777777000
143
- }
144
- },
145
- {
146
- "id": "edge:provider-device",
147
- "source": "provider:mlinkMatter.device",
148
- "target": "device:desk-light",
149
- "relation": "provider-device",
150
- "basis": "twinSource",
151
- "durability": "durable",
152
- "observation": {
153
- "state": "connected",
154
- "observedAtMs": 1777777777000
155
- }
156
- },
157
- {
158
- "id": "edge:connection-device",
159
- "source": "connection:mlinkMatter.device:matter-1",
160
- "target": "device:desk-light",
161
- "relation": "connection-device",
162
- "basis": "twinSource",
163
- "durability": "durable",
164
- "observation": {
165
- "state": "connected",
166
- "observedAtMs": 1777777777000
167
- }
168
- }
169
- ]
170
- }
package/schema/device-topology.v1.schema.json DELETED
@@ -1,305 +0,0 @@
1
- {
2
- "$schema": "https://json-schema.org/draft/2020-12/schema",
3
- "$id": "https://mhome.ai/schema/device-topology.v1.schema.json",
4
- "title": "MeowLink Device Topology",
5
- "description": "A Device Integration relationship graph. Edge direction is semantic and does not imply hierarchy, containment, single-parent ownership, or acyclicity.",
6
- "type": "object",
7
- "additionalProperties": false,
8
- "required": [
9
- "contract",
10
- "scopeId",
11
- "generation",
12
- "revision",
13
- "observedAtMs",
14
- "completeness",
15
- "issues",
16
- "entities",
17
- "edges"
18
- ],
19
- "properties": {
20
- "contract": { "const": "mhome.device.topology.v1" },
21
- "scopeId": { "type": "string", "minLength": 1 },
22
- "generation": { "type": "string", "minLength": 1 },
23
- "revision": { "type": "integer", "minimum": 0 },
24
- "observedAtMs": { "type": "integer", "minimum": 0 },
25
- "completeness": { "enum": ["complete", "partial"] },
26
- "issues": {
27
- "type": "array",
28
- "items": { "$ref": "#/$defs/issue" }
29
- },
30
- "entities": {
31
- "type": "array",
32
- "items": { "$ref": "#/$defs/entity" },
33
- "contains": {
34
- "type": "object",
35
- "required": ["kind"],
36
- "properties": {
37
- "kind": { "const": "deviceIntegration" }
38
- }
39
- },
40
- "minContains": 1,
41
- "maxContains": 1
42
- },
43
- "edges": {
44
- "type": "array",
45
- "items": { "$ref": "#/$defs/edge" }
46
- }
47
- },
48
- "allOf": [
49
- {
50
- "if": {
51
- "properties": {
52
- "completeness": { "const": "complete" }
53
- }
54
- },
55
- "then": {
56
- "properties": {
57
- "issues": { "maxItems": 0 }
58
- }
59
- }
60
- },
61
- {
62
- "if": {
63
- "properties": {
64
- "completeness": { "const": "partial" }
65
- }
66
- },
67
- "then": {
68
- "properties": {
69
- "issues": { "minItems": 1 }
70
- }
71
- }
72
- }
73
- ],
74
- "$defs": {
75
- "runtime": {
76
- "type": "object",
77
- "additionalProperties": false,
78
- "required": ["state"],
79
- "properties": {
80
- "state": { "enum": ["healthy", "degraded", "offline", "unknown"] },
81
- "reason": { "type": "string" },
82
- "updatedAtMs": { "type": "integer", "minimum": 0 }
83
- }
84
- },
85
- "observation": {
86
- "type": "object",
87
- "additionalProperties": false,
88
- "required": ["state", "observedAtMs"],
89
- "properties": {
90
- "state": { "enum": ["connected", "disconnected", "unknown"] },
91
- "observedAtMs": { "type": "integer", "minimum": 0 },
92
- "reason": { "type": "string" }
93
- }
94
- },
95
- "issue": {
96
- "type": "object",
97
- "additionalProperties": false,
98
- "required": ["code", "message"],
99
- "properties": {
100
- "code": { "type": "string", "minLength": 1 },
101
- "message": { "type": "string", "minLength": 1 },
102
- "entityId": { "type": "string", "minLength": 1 }
103
- }
104
- },
105
- "entity": {
106
- "oneOf": [
107
- {
108
- "type": "object",
109
- "additionalProperties": false,
110
- "required": ["id", "kind", "integrationId", "displayName"],
111
- "properties": {
112
- "id": { "type": "string", "minLength": 1 },
113
- "kind": { "const": "deviceIntegration" },
114
- "integrationId": { "type": "string", "minLength": 1 },
115
- "displayName": { "type": "string", "minLength": 1 }
116
- }
117
- },
118
- {
119
- "type": "object",
120
- "additionalProperties": false,
121
- "required": [
122
- "id",
123
- "kind",
124
- "integrationId",
125
- "displayName",
126
- "mode",
127
- "multiConnect"
128
- ],
129
- "properties": {
130
- "id": { "type": "string", "minLength": 1 },
131
- "kind": { "const": "provider" },
132
- "integrationId": { "type": "string", "minLength": 1 },
133
- "displayName": { "type": "string", "minLength": 1 },
134
- "mode": { "type": "string", "minLength": 1 },
135
- "multiConnect": { "type": "boolean" }
136
- }
137
- },
138
- {
139
- "type": "object",
140
- "additionalProperties": false,
141
- "required": [
142
- "id",
143
- "kind",
144
- "integrationId",
145
- "connectionId",
146
- "displayName",
147
- "runtime"
148
- ],
149
- "properties": {
150
- "id": { "type": "string", "minLength": 1 },
151
- "kind": { "const": "connection" },
152
- "integrationId": { "type": "string", "minLength": 1 },
153
- "connectionId": { "type": "string", "minLength": 1 },
154
- "displayName": { "type": "string", "minLength": 1 },
155
- "runtime": { "$ref": "#/$defs/runtime" }
156
- }
157
- },
158
- {
159
- "type": "object",
160
- "additionalProperties": false,
161
- "required": [
162
- "id",
163
- "kind",
164
- "nodeId",
165
- "nodeType",
166
- "hostId",
167
- "serviceInstanceId",
168
- "displayName",
169
- "runtime"
170
- ],
171
- "properties": {
172
- "id": { "type": "string", "minLength": 1 },
173
- "kind": { "const": "pluginInstance" },
174
- "nodeId": { "type": "string", "minLength": 1 },
175
- "nodeType": { "type": "string", "minLength": 1 },
176
- "hostId": { "type": "string", "minLength": 1 },
177
- "serviceInstanceId": { "type": "string", "minLength": 1 },
178
- "displayName": { "type": "string", "minLength": 1 },
179
- "hostDisplayName": { "type": "string", "minLength": 1 },
180
- "runtime": { "$ref": "#/$defs/runtime" }
181
- }
182
- },
183
- {
184
- "type": "object",
185
- "additionalProperties": false,
186
- "required": [
187
- "id",
188
- "kind",
189
- "nodeId",
190
- "displayName",
191
- "runtime"
192
- ],
193
- "properties": {
194
- "id": { "type": "string", "minLength": 1 },
195
- "kind": { "const": "matterBridge" },
196
- "nodeId": { "type": "string", "minLength": 1 },
197
- "displayName": { "type": "string", "minLength": 1 },
198
- "runtime": { "$ref": "#/$defs/runtime" }
199
- }
200
- },
201
- {
202
- "type": "object",
203
- "additionalProperties": false,
204
- "required": [
205
- "id",
206
- "kind",
207
- "entityId",
208
- "integrationId",
209
- "displayName",
210
- "enabled",
211
- "runtime"
212
- ],
213
- "properties": {
214
- "id": { "type": "string", "minLength": 1 },
215
- "kind": { "const": "device" },
216
- "entityId": { "type": "string", "minLength": 1 },
217
- "integrationId": { "type": "string", "minLength": 1 },
218
- "displayName": { "type": "string", "minLength": 1 },
219
- "enabled": { "type": "boolean" },
220
- "runtime": { "$ref": "#/$defs/runtime" }
221
- }
222
- }
223
- ]
224
- },
225
- "edge": {
226
- "type": "object",
227
- "additionalProperties": false,
228
- "required": [
229
- "id",
230
- "source",
231
- "target",
232
- "relation",
233
- "basis",
234
- "durability",
235
- "observation"
236
- ],
237
- "properties": {
238
- "id": { "type": "string", "minLength": 1 },
239
- "source": { "type": "string", "minLength": 1 },
240
- "target": { "type": "string", "minLength": 1 },
241
- "relation": {
242
- "enum": [
243
- "integration-provider",
244
- "plugin-provider",
245
- "plugin-connection",
246
- "provider-connection",
247
- "provider-device",
248
- "connection-device",
249
- "connection-bridge",
250
- "bridge-device"
251
- ]
252
- },
253
- "basis": {
254
- "enum": [
255
- "integrationInstall",
256
- "pluginBinding",
257
- "connectionOwnership",
258
- "twinSource",
259
- "sourceProjection"
260
- ]
261
- },
262
- "durability": { "enum": ["durable", "ephemeral"] },
263
- "observation": { "$ref": "#/$defs/observation" }
264
- },
265
- "oneOf": [
266
- {
267
- "properties": {
268
- "relation": { "const": "integration-provider" },
269
- "basis": { "const": "integrationInstall" }
270
- }
271
- },
272
- {
273
- "properties": {
274
- "relation": {
275
- "enum": ["plugin-provider", "plugin-connection"]
276
- },
277
- "basis": { "const": "pluginBinding" }
278
- }
279
- },
280
- {
281
- "properties": {
282
- "relation": { "const": "provider-connection" },
283
- "basis": { "const": "connectionOwnership" }
284
- }
285
- },
286
- {
287
- "properties": {
288
- "relation": {
289
- "enum": ["provider-device", "connection-device"]
290
- },
291
- "basis": { "const": "twinSource" }
292
- }
293
- },
294
- {
295
- "properties": {
296
- "relation": {
297
- "enum": ["connection-bridge", "bridge-device"]
298
- },
299
- "basis": { "const": "sourceProjection" }
300
- }
301
- }
302
- ]
303
- }
304
- }
305
- }