@camstack/types 1.2.592 → 1.2.594

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 (43) hide show
  1. package/CHANGELOG.md +17 -0
  2. package/dist/addon.js +2 -2
  3. package/dist/addon.mjs +2 -2
  4. package/dist/capabilities/composer.cap.d.ts +9 -0
  5. package/dist/capabilities/core-blocks.cap.d.ts +64 -0
  6. package/dist/capabilities/device-manager.cap.d.ts +681 -48
  7. package/dist/capabilities/device-state-refresh.cap.d.ts +58 -0
  8. package/dist/capabilities/index.d.ts +3 -1
  9. package/dist/capabilities/power-source.cap.d.ts +10 -0
  10. package/dist/client.js +10 -0
  11. package/dist/client.mjs +10 -0
  12. package/dist/composition/composition-report.d.ts +3 -0
  13. package/dist/composition/composition.d.ts +14 -0
  14. package/dist/composition/power-source-link.d.ts +8 -0
  15. package/dist/device/base-device.d.ts +8 -0
  16. package/dist/device/command-hold.d.ts +6 -0
  17. package/dist/device/device-management.d.ts +4 -0
  18. package/dist/device/identity-links.d.ts +310 -0
  19. package/dist/device/index.d.ts +2 -0
  20. package/dist/device/state-refresh.d.ts +51 -0
  21. package/dist/enums/event-category.d.ts +14 -0
  22. package/dist/enums.js +1 -1
  23. package/dist/enums.mjs +1 -1
  24. package/dist/{event-category-CY27-fF0.mjs → event-category-7P4A3bYA.mjs} +14 -0
  25. package/dist/{event-category-BKxXXxnV.js → event-category-CMA0-jGW.js} +14 -0
  26. package/dist/generated/addon-api.d.ts +57 -0
  27. package/dist/generated/cap-vocabulary.d.ts +1 -1
  28. package/dist/generated/capability-router-map.d.ts +5 -2
  29. package/dist/generated/device-proxy.d.ts +3 -1
  30. package/dist/generated/device-scoped-caps.d.ts +1 -1
  31. package/dist/generated/method-access-map.d.ts +1 -1
  32. package/dist/generated/method-device-selectors.d.ts +2 -2
  33. package/dist/generated/system-proxy.d.ts +1 -1
  34. package/dist/{implemented-methods-k3KProJd.mjs → implemented-methods-DXeNAPAS.mjs} +11 -2
  35. package/dist/{implemented-methods-BarLh7tc.js → implemented-methods-Dj_2fX8-.js} +16 -1
  36. package/dist/index.d.ts +3 -0
  37. package/dist/index.js +442 -12
  38. package/dist/index.mjs +416 -13
  39. package/dist/node.js +1 -1
  40. package/dist/node.mjs +1 -1
  41. package/dist/{sleep-D2Ny6tvi.js → sleep-Bgzv_TCG.js} +23 -3
  42. package/dist/{sleep-dgC2VKW4.mjs → sleep-C9eelFbV.mjs} +23 -3
  43. package/package.json +1 -1
@@ -128,6 +128,56 @@ export declare const DeviceInfoSchema: z.ZodObject<{
128
128
  readAt: z.ZodNumber;
129
129
  }, z.core.$strict>>;
130
130
  }, z.core.$strict>>;
131
+ attachedIdentifiers: z.ZodOptional<z.ZodObject<{
132
+ mac: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodObject<{
133
+ value: z.ZodString;
134
+ origin: z.ZodEnum<{
135
+ derived: "derived";
136
+ read: "read";
137
+ }>;
138
+ readAt: z.ZodNumber;
139
+ }, z.core.$strict>>>>;
140
+ serial: z.ZodOptional<z.ZodObject<{
141
+ value: z.ZodString;
142
+ origin: z.ZodEnum<{
143
+ derived: "derived";
144
+ read: "read";
145
+ }>;
146
+ readAt: z.ZodNumber;
147
+ }, z.core.$strict>>;
148
+ 'machine-uuid': z.ZodOptional<z.ZodObject<{
149
+ value: z.ZodString;
150
+ origin: z.ZodEnum<{
151
+ derived: "derived";
152
+ read: "read";
153
+ }>;
154
+ readAt: z.ZodNumber;
155
+ }, z.core.$strict>>;
156
+ 'vendor-uid': z.ZodOptional<z.ZodObject<{
157
+ value: z.ZodString;
158
+ origin: z.ZodEnum<{
159
+ derived: "derived";
160
+ read: "read";
161
+ }>;
162
+ readAt: z.ZodNumber;
163
+ }, z.core.$strict>>;
164
+ hostname: z.ZodOptional<z.ZodObject<{
165
+ value: z.ZodString;
166
+ origin: z.ZodEnum<{
167
+ derived: "derived";
168
+ read: "read";
169
+ }>;
170
+ readAt: z.ZodNumber;
171
+ }, z.core.$strict>>;
172
+ ip: z.ZodOptional<z.ZodObject<{
173
+ value: z.ZodUnion<readonly [z.ZodIPv4, z.ZodIPv6]>;
174
+ origin: z.ZodEnum<{
175
+ derived: "derived";
176
+ read: "read";
177
+ }>;
178
+ readAt: z.ZodNumber;
179
+ }, z.core.$strict>>;
180
+ }, z.core.$strict>>;
131
181
  sourceInfo: z.ZodOptional<z.ZodObject<{
132
182
  id: z.ZodString;
133
183
  system: z.ZodString;
@@ -365,6 +415,56 @@ export declare const DeviceMetaSchema: z.ZodObject<{
365
415
  readAt: z.ZodNumber;
366
416
  }, z.core.$strict>>;
367
417
  }, z.core.$strict>>;
418
+ attachedIdentifiers: z.ZodOptional<z.ZodObject<{
419
+ mac: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodObject<{
420
+ value: z.ZodString;
421
+ origin: z.ZodEnum<{
422
+ derived: "derived";
423
+ read: "read";
424
+ }>;
425
+ readAt: z.ZodNumber;
426
+ }, z.core.$strict>>>>;
427
+ serial: z.ZodOptional<z.ZodObject<{
428
+ value: z.ZodString;
429
+ origin: z.ZodEnum<{
430
+ derived: "derived";
431
+ read: "read";
432
+ }>;
433
+ readAt: z.ZodNumber;
434
+ }, z.core.$strict>>;
435
+ 'machine-uuid': z.ZodOptional<z.ZodObject<{
436
+ value: z.ZodString;
437
+ origin: z.ZodEnum<{
438
+ derived: "derived";
439
+ read: "read";
440
+ }>;
441
+ readAt: z.ZodNumber;
442
+ }, z.core.$strict>>;
443
+ 'vendor-uid': z.ZodOptional<z.ZodObject<{
444
+ value: z.ZodString;
445
+ origin: z.ZodEnum<{
446
+ derived: "derived";
447
+ read: "read";
448
+ }>;
449
+ readAt: z.ZodNumber;
450
+ }, z.core.$strict>>;
451
+ hostname: z.ZodOptional<z.ZodObject<{
452
+ value: z.ZodString;
453
+ origin: z.ZodEnum<{
454
+ derived: "derived";
455
+ read: "read";
456
+ }>;
457
+ readAt: z.ZodNumber;
458
+ }, z.core.$strict>>;
459
+ ip: z.ZodOptional<z.ZodObject<{
460
+ value: z.ZodUnion<readonly [z.ZodIPv4, z.ZodIPv6]>;
461
+ origin: z.ZodEnum<{
462
+ derived: "derived";
463
+ read: "read";
464
+ }>;
465
+ readAt: z.ZodNumber;
466
+ }, z.core.$strict>>;
467
+ }, z.core.$strict>>;
368
468
  sourceInfo: z.ZodOptional<z.ZodObject<{
369
469
  id: z.ZodString;
370
470
  system: z.ZodString;
@@ -724,6 +824,56 @@ export declare const deviceManagerCapability: {
724
824
  readAt: z.ZodNumber;
725
825
  }, z.core.$strict>>;
726
826
  }, z.core.$strict>>;
827
+ attachedIdentifiers: z.ZodOptional<z.ZodObject<{
828
+ mac: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodObject<{
829
+ value: z.ZodString;
830
+ origin: z.ZodEnum<{
831
+ derived: "derived";
832
+ read: "read";
833
+ }>;
834
+ readAt: z.ZodNumber;
835
+ }, z.core.$strict>>>>;
836
+ serial: z.ZodOptional<z.ZodObject<{
837
+ value: z.ZodString;
838
+ origin: z.ZodEnum<{
839
+ derived: "derived";
840
+ read: "read";
841
+ }>;
842
+ readAt: z.ZodNumber;
843
+ }, z.core.$strict>>;
844
+ 'machine-uuid': z.ZodOptional<z.ZodObject<{
845
+ value: z.ZodString;
846
+ origin: z.ZodEnum<{
847
+ derived: "derived";
848
+ read: "read";
849
+ }>;
850
+ readAt: z.ZodNumber;
851
+ }, z.core.$strict>>;
852
+ 'vendor-uid': z.ZodOptional<z.ZodObject<{
853
+ value: z.ZodString;
854
+ origin: z.ZodEnum<{
855
+ derived: "derived";
856
+ read: "read";
857
+ }>;
858
+ readAt: z.ZodNumber;
859
+ }, z.core.$strict>>;
860
+ hostname: z.ZodOptional<z.ZodObject<{
861
+ value: z.ZodString;
862
+ origin: z.ZodEnum<{
863
+ derived: "derived";
864
+ read: "read";
865
+ }>;
866
+ readAt: z.ZodNumber;
867
+ }, z.core.$strict>>;
868
+ ip: z.ZodOptional<z.ZodObject<{
869
+ value: z.ZodUnion<readonly [z.ZodIPv4, z.ZodIPv6]>;
870
+ origin: z.ZodEnum<{
871
+ derived: "derived";
872
+ read: "read";
873
+ }>;
874
+ readAt: z.ZodNumber;
875
+ }, z.core.$strict>>;
876
+ }, z.core.$strict>>;
727
877
  sourceInfo: z.ZodOptional<z.ZodObject<{
728
878
  id: z.ZodString;
729
879
  system: z.ZodString;
@@ -1189,55 +1339,338 @@ export declare const deviceManagerCapability: {
1189
1339
  }, z.core.$strip>>>;
1190
1340
  undeclaredDeviceIds: z.ZodReadonly<z.ZodArray<z.ZodNumber>>;
1191
1341
  }, z.core.$strip>], "status">, "query">;
1192
- /** Operator-curated location registry. Returns the union of:
1193
- * (1) labels persisted in the registry via `addLocation`, and
1194
- * (2) labels currently in use on at least one device's
1195
- * `meta.location` field.
1196
- * Sorted case-insensitively + deduped + trimmed of empty strings.
1197
- * Drives the autocomplete in the Device Info location editor. */
1198
- readonly listLocations: import("./capability-definition.js").CapabilityMethodSchema<z.ZodVoid, z.ZodArray<z.ZodString>, import("./capability-definition.js").CapabilityMethodKind>;
1199
- /** Add a label to the curated location registry. No-op when the
1200
- * label (case-insensitive, trimmed) is already present. Empty
1201
- * / whitespace-only inputs throw. */
1202
- readonly addLocation: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
1203
- name: z.ZodString;
1204
- }, z.core.$strip>, z.ZodVoid, "mutation">;
1205
- /** Remove a label from the curated registry. Devices that still
1206
- * reference this label keep their `meta.location` value — the
1207
- * registry is purely a suggestion list. To purge from devices,
1208
- * iterate them and call `setLocation(deviceId, null)`
1209
- * separately (or pass `cascade: true` to do it in one shot).
1210
- *
1211
- * The room's ICON goes with it, always — a key left behind survives in a
1212
- * map nobody lists, and a room later re-created under the same name would
1213
- * silently inherit an icon the operator never chose for it. */
1214
- readonly removeLocation: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
1215
- name: z.ZodString;
1216
- cascade: z.ZodOptional<z.ZodBoolean>;
1342
+ /** Declare the identity of the device at the FAR END of this device's
1343
+ * physical link (D1063 amending D1059) — a PoE port's wired client: its MAC,
1344
+ * its IP. Same owner check, normalisation and merge as `setIdentifiers`
1345
+ * (`unread` keeps the stored value), its own column. It never makes the two
1346
+ * devices the same device: it feeds directional identity links only. */
1347
+ readonly setAttachedIdentifiers: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
1348
+ deviceId: z.ZodNumber;
1349
+ identifiers: z.ZodNullable<z.ZodObject<{
1350
+ mac: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodObject<{
1351
+ value: z.ZodString;
1352
+ origin: z.ZodEnum<{
1353
+ derived: "derived";
1354
+ read: "read";
1355
+ }>;
1356
+ readAt: z.ZodNumber;
1357
+ }, z.core.$strict>>>>;
1358
+ serial: z.ZodOptional<z.ZodObject<{
1359
+ value: z.ZodString;
1360
+ origin: z.ZodEnum<{
1361
+ derived: "derived";
1362
+ read: "read";
1363
+ }>;
1364
+ readAt: z.ZodNumber;
1365
+ }, z.core.$strict>>;
1366
+ 'machine-uuid': z.ZodOptional<z.ZodObject<{
1367
+ value: z.ZodString;
1368
+ origin: z.ZodEnum<{
1369
+ derived: "derived";
1370
+ read: "read";
1371
+ }>;
1372
+ readAt: z.ZodNumber;
1373
+ }, z.core.$strict>>;
1374
+ 'vendor-uid': z.ZodOptional<z.ZodObject<{
1375
+ value: z.ZodString;
1376
+ origin: z.ZodEnum<{
1377
+ derived: "derived";
1378
+ read: "read";
1379
+ }>;
1380
+ readAt: z.ZodNumber;
1381
+ }, z.core.$strict>>;
1382
+ hostname: z.ZodOptional<z.ZodObject<{
1383
+ value: z.ZodString;
1384
+ origin: z.ZodEnum<{
1385
+ derived: "derived";
1386
+ read: "read";
1387
+ }>;
1388
+ readAt: z.ZodNumber;
1389
+ }, z.core.$strict>>;
1390
+ ip: z.ZodOptional<z.ZodObject<{
1391
+ value: z.ZodUnion<readonly [z.ZodIPv4, z.ZodIPv6]>;
1392
+ origin: z.ZodEnum<{
1393
+ derived: "derived";
1394
+ read: "read";
1395
+ }>;
1396
+ readAt: z.ZodNumber;
1397
+ }, z.core.$strict>>;
1398
+ }, z.core.$strict>>;
1399
+ unread: z.ZodOptional<z.ZodArray<z.ZodEnum<{
1400
+ hostname: "hostname";
1401
+ ip: "ip";
1402
+ mac: "mac";
1403
+ "machine-uuid": "machine-uuid";
1404
+ serial: "serial";
1405
+ "vendor-uid": "vendor-uid";
1406
+ }>>>;
1217
1407
  }, z.core.$strip>, z.ZodVoid, "mutation">;
1218
- /** Rename a room: replace the label in the registry IN PLACE and move
1219
- * every device that carried it, as ONE server operation.
1220
- *
1221
- * The admin UI used to do this as `addLocation(to)` → N ×
1222
- * `setLocation(device, to)` → `removeLocation(from)` from the browser.
1223
- * Nothing bound those three together, so a closed tab left the fleet
1224
- * split across two rooms — one of which the operator believed was gone.
1225
- *
1226
- * `from` is matched the way the registry matches everywhere else
1227
- * (trimmed, case-insensitive) and need NOT be registered: the registry is
1228
- * a suggestion list, and the devices that most need a rename are exactly
1229
- * the ones carrying a label nobody registered. `to` renames onto an
1230
- * existing room by MERGING into it, leaving no duplicate label. An empty
1231
- * `to` throws before anything is written.
1232
- *
1233
- * The room's ICON travels with the rename, including when `from` was
1234
- * never registered — otherwise it orphans on a key no location carries
1235
- * any more. A merge keeps the TARGET's icon when it has one: renaming
1236
- * "Sala" into "Hall" moves devices into Hall, it does not restyle
1237
- * it. */
1238
- readonly renameLocation: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
1239
- from: z.ZodString;
1240
- to: z.ZodString;
1408
+ /** Identity links (D1063): `proposed`, `linked` and `dismissed` relations
1409
+ * between devices of different integrations, decided from their declared
1410
+ * identifiers. With `deviceId`, only the links naming that device.
1411
+ * `not-loaded` until the links have been read — never an empty list. */
1412
+ readonly listIdentityLinks: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
1413
+ deviceId: z.ZodOptional<z.ZodNumber>;
1414
+ }, z.core.$strip>, z.ZodDiscriminatedUnion<[z.ZodObject<{
1415
+ status: z.ZodLiteral<"not-loaded">;
1416
+ reason: z.ZodString;
1417
+ }, z.core.$strip>, z.ZodObject<{
1418
+ status: z.ZodLiteral<"answered">;
1419
+ links: z.ZodReadonly<z.ZodArray<z.ZodObject<{
1420
+ kind: z.ZodEnum<{
1421
+ "poe-power": "poe-power";
1422
+ "same-device": "same-device";
1423
+ }>;
1424
+ a: z.ZodObject<{
1425
+ addonId: z.ZodString;
1426
+ stableId: z.ZodString;
1427
+ deviceId: z.ZodNumber;
1428
+ }, z.core.$strip>;
1429
+ b: z.ZodObject<{
1430
+ addonId: z.ZodString;
1431
+ stableId: z.ZodString;
1432
+ deviceId: z.ZodNumber;
1433
+ }, z.core.$strip>;
1434
+ state: z.ZodEnum<{
1435
+ dismissed: "dismissed";
1436
+ linked: "linked";
1437
+ proposed: "proposed";
1438
+ }>;
1439
+ origin: z.ZodEnum<{
1440
+ auto: "auto";
1441
+ operator: "operator";
1442
+ }>;
1443
+ evidence: z.ZodReadonly<z.ZodArray<z.ZodObject<{
1444
+ key: z.ZodEnum<{
1445
+ hostname: "hostname";
1446
+ ip: "ip";
1447
+ mac: "mac";
1448
+ "machine-uuid": "machine-uuid";
1449
+ serial: "serial";
1450
+ "vendor-uid": "vendor-uid";
1451
+ }>;
1452
+ value: z.ZodString;
1453
+ }, z.core.$strip>>>;
1454
+ evidenceGone: z.ZodOptional<z.ZodLiteral<true>>;
1455
+ createdAt: z.ZodNumber;
1456
+ decidedAt: z.ZodOptional<z.ZodNumber>;
1457
+ id: z.ZodString;
1458
+ }, z.core.$strip>>>;
1459
+ }, z.core.$strip>], "status">, "query">;
1460
+ /** Confirm a `proposed` link: it becomes `linked` by the operator and its
1461
+ * default contributions are added. Refused by name when the link is unknown
1462
+ * or not `proposed`. */
1463
+ readonly confirmIdentityLink: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
1464
+ linkId: z.ZodString;
1465
+ }, z.core.$strip>, z.ZodDiscriminatedUnion<[z.ZodObject<{
1466
+ ok: z.ZodLiteral<true>;
1467
+ link: z.ZodObject<{
1468
+ kind: z.ZodEnum<{
1469
+ "poe-power": "poe-power";
1470
+ "same-device": "same-device";
1471
+ }>;
1472
+ a: z.ZodObject<{
1473
+ addonId: z.ZodString;
1474
+ stableId: z.ZodString;
1475
+ deviceId: z.ZodNumber;
1476
+ }, z.core.$strip>;
1477
+ b: z.ZodObject<{
1478
+ addonId: z.ZodString;
1479
+ stableId: z.ZodString;
1480
+ deviceId: z.ZodNumber;
1481
+ }, z.core.$strip>;
1482
+ state: z.ZodEnum<{
1483
+ dismissed: "dismissed";
1484
+ linked: "linked";
1485
+ proposed: "proposed";
1486
+ }>;
1487
+ origin: z.ZodEnum<{
1488
+ auto: "auto";
1489
+ operator: "operator";
1490
+ }>;
1491
+ evidence: z.ZodReadonly<z.ZodArray<z.ZodObject<{
1492
+ key: z.ZodEnum<{
1493
+ hostname: "hostname";
1494
+ ip: "ip";
1495
+ mac: "mac";
1496
+ "machine-uuid": "machine-uuid";
1497
+ serial: "serial";
1498
+ "vendor-uid": "vendor-uid";
1499
+ }>;
1500
+ value: z.ZodString;
1501
+ }, z.core.$strip>>>;
1502
+ evidenceGone: z.ZodOptional<z.ZodLiteral<true>>;
1503
+ createdAt: z.ZodNumber;
1504
+ decidedAt: z.ZodOptional<z.ZodNumber>;
1505
+ id: z.ZodString;
1506
+ }, z.core.$strip>;
1507
+ }, z.core.$strip>, z.ZodObject<{
1508
+ ok: z.ZodLiteral<false>;
1509
+ reason: z.ZodEnum<{
1510
+ "not-loaded": "not-loaded";
1511
+ "unknown-link": "unknown-link";
1512
+ "wrong-state": "wrong-state";
1513
+ }>;
1514
+ message: z.ZodString;
1515
+ }, z.core.$strip>], "ok">, "mutation">;
1516
+ /** Dismiss a `proposed` link: sticky, never proposed again. */
1517
+ readonly dismissIdentityLink: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
1518
+ linkId: z.ZodString;
1519
+ }, z.core.$strip>, z.ZodDiscriminatedUnion<[z.ZodObject<{
1520
+ ok: z.ZodLiteral<true>;
1521
+ link: z.ZodObject<{
1522
+ kind: z.ZodEnum<{
1523
+ "poe-power": "poe-power";
1524
+ "same-device": "same-device";
1525
+ }>;
1526
+ a: z.ZodObject<{
1527
+ addonId: z.ZodString;
1528
+ stableId: z.ZodString;
1529
+ deviceId: z.ZodNumber;
1530
+ }, z.core.$strip>;
1531
+ b: z.ZodObject<{
1532
+ addonId: z.ZodString;
1533
+ stableId: z.ZodString;
1534
+ deviceId: z.ZodNumber;
1535
+ }, z.core.$strip>;
1536
+ state: z.ZodEnum<{
1537
+ dismissed: "dismissed";
1538
+ linked: "linked";
1539
+ proposed: "proposed";
1540
+ }>;
1541
+ origin: z.ZodEnum<{
1542
+ auto: "auto";
1543
+ operator: "operator";
1544
+ }>;
1545
+ evidence: z.ZodReadonly<z.ZodArray<z.ZodObject<{
1546
+ key: z.ZodEnum<{
1547
+ hostname: "hostname";
1548
+ ip: "ip";
1549
+ mac: "mac";
1550
+ "machine-uuid": "machine-uuid";
1551
+ serial: "serial";
1552
+ "vendor-uid": "vendor-uid";
1553
+ }>;
1554
+ value: z.ZodString;
1555
+ }, z.core.$strip>>>;
1556
+ evidenceGone: z.ZodOptional<z.ZodLiteral<true>>;
1557
+ createdAt: z.ZodNumber;
1558
+ decidedAt: z.ZodOptional<z.ZodNumber>;
1559
+ id: z.ZodString;
1560
+ }, z.core.$strip>;
1561
+ }, z.core.$strip>, z.ZodObject<{
1562
+ ok: z.ZodLiteral<false>;
1563
+ reason: z.ZodEnum<{
1564
+ "not-loaded": "not-loaded";
1565
+ "unknown-link": "unknown-link";
1566
+ "wrong-state": "wrong-state";
1567
+ }>;
1568
+ message: z.ZodString;
1569
+ }, z.core.$strip>], "ok">, "mutation">;
1570
+ /** Unlink a `linked` link: it becomes `dismissed` (sticky) and its stamped
1571
+ * contributions are removed. */
1572
+ readonly unlinkIdentity: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
1573
+ linkId: z.ZodString;
1574
+ }, z.core.$strip>, z.ZodDiscriminatedUnion<[z.ZodObject<{
1575
+ ok: z.ZodLiteral<true>;
1576
+ link: z.ZodObject<{
1577
+ kind: z.ZodEnum<{
1578
+ "poe-power": "poe-power";
1579
+ "same-device": "same-device";
1580
+ }>;
1581
+ a: z.ZodObject<{
1582
+ addonId: z.ZodString;
1583
+ stableId: z.ZodString;
1584
+ deviceId: z.ZodNumber;
1585
+ }, z.core.$strip>;
1586
+ b: z.ZodObject<{
1587
+ addonId: z.ZodString;
1588
+ stableId: z.ZodString;
1589
+ deviceId: z.ZodNumber;
1590
+ }, z.core.$strip>;
1591
+ state: z.ZodEnum<{
1592
+ dismissed: "dismissed";
1593
+ linked: "linked";
1594
+ proposed: "proposed";
1595
+ }>;
1596
+ origin: z.ZodEnum<{
1597
+ auto: "auto";
1598
+ operator: "operator";
1599
+ }>;
1600
+ evidence: z.ZodReadonly<z.ZodArray<z.ZodObject<{
1601
+ key: z.ZodEnum<{
1602
+ hostname: "hostname";
1603
+ ip: "ip";
1604
+ mac: "mac";
1605
+ "machine-uuid": "machine-uuid";
1606
+ serial: "serial";
1607
+ "vendor-uid": "vendor-uid";
1608
+ }>;
1609
+ value: z.ZodString;
1610
+ }, z.core.$strip>>>;
1611
+ evidenceGone: z.ZodOptional<z.ZodLiteral<true>>;
1612
+ createdAt: z.ZodNumber;
1613
+ decidedAt: z.ZodOptional<z.ZodNumber>;
1614
+ id: z.ZodString;
1615
+ }, z.core.$strip>;
1616
+ }, z.core.$strip>, z.ZodObject<{
1617
+ ok: z.ZodLiteral<false>;
1618
+ reason: z.ZodEnum<{
1619
+ "not-loaded": "not-loaded";
1620
+ "unknown-link": "unknown-link";
1621
+ "wrong-state": "wrong-state";
1622
+ }>;
1623
+ message: z.ZodString;
1624
+ }, z.core.$strip>], "ok">, "mutation">;
1625
+ /** Operator-curated location registry. Returns the union of:
1626
+ * (1) labels persisted in the registry via `addLocation`, and
1627
+ * (2) labels currently in use on at least one device's
1628
+ * `meta.location` field.
1629
+ * Sorted case-insensitively + deduped + trimmed of empty strings.
1630
+ * Drives the autocomplete in the Device Info location editor. */
1631
+ readonly listLocations: import("./capability-definition.js").CapabilityMethodSchema<z.ZodVoid, z.ZodArray<z.ZodString>, import("./capability-definition.js").CapabilityMethodKind>;
1632
+ /** Add a label to the curated location registry. No-op when the
1633
+ * label (case-insensitive, trimmed) is already present. Empty
1634
+ * / whitespace-only inputs throw. */
1635
+ readonly addLocation: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
1636
+ name: z.ZodString;
1637
+ }, z.core.$strip>, z.ZodVoid, "mutation">;
1638
+ /** Remove a label from the curated registry. Devices that still
1639
+ * reference this label keep their `meta.location` value — the
1640
+ * registry is purely a suggestion list. To purge from devices,
1641
+ * iterate them and call `setLocation(deviceId, null)`
1642
+ * separately (or pass `cascade: true` to do it in one shot).
1643
+ *
1644
+ * The room's ICON goes with it, always — a key left behind survives in a
1645
+ * map nobody lists, and a room later re-created under the same name would
1646
+ * silently inherit an icon the operator never chose for it. */
1647
+ readonly removeLocation: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
1648
+ name: z.ZodString;
1649
+ cascade: z.ZodOptional<z.ZodBoolean>;
1650
+ }, z.core.$strip>, z.ZodVoid, "mutation">;
1651
+ /** Rename a room: replace the label in the registry IN PLACE and move
1652
+ * every device that carried it, as ONE server operation.
1653
+ *
1654
+ * The admin UI used to do this as `addLocation(to)` → N ×
1655
+ * `setLocation(device, to)` → `removeLocation(from)` from the browser.
1656
+ * Nothing bound those three together, so a closed tab left the fleet
1657
+ * split across two rooms — one of which the operator believed was gone.
1658
+ *
1659
+ * `from` is matched the way the registry matches everywhere else
1660
+ * (trimmed, case-insensitive) and need NOT be registered: the registry is
1661
+ * a suggestion list, and the devices that most need a rename are exactly
1662
+ * the ones carrying a label nobody registered. `to` renames onto an
1663
+ * existing room by MERGING into it, leaving no duplicate label. An empty
1664
+ * `to` throws before anything is written.
1665
+ *
1666
+ * The room's ICON travels with the rename, including when `from` was
1667
+ * never registered — otherwise it orphans on a key no location carries
1668
+ * any more. A merge keeps the TARGET's icon when it has one: renaming
1669
+ * "Sala" into "Hall" moves devices into Hall, it does not restyle
1670
+ * it. */
1671
+ readonly renameLocation: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
1672
+ from: z.ZodString;
1673
+ to: z.ZodString;
1241
1674
  }, z.core.$strip>, z.ZodObject<{
1242
1675
  moved: z.ZodNumber;
1243
1676
  }, z.core.$strip>, "mutation">;
@@ -1464,6 +1897,56 @@ export declare const deviceManagerCapability: {
1464
1897
  readAt: z.ZodNumber;
1465
1898
  }, z.core.$strict>>;
1466
1899
  }, z.core.$strict>>;
1900
+ attachedIdentifiers: z.ZodOptional<z.ZodObject<{
1901
+ mac: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodObject<{
1902
+ value: z.ZodString;
1903
+ origin: z.ZodEnum<{
1904
+ derived: "derived";
1905
+ read: "read";
1906
+ }>;
1907
+ readAt: z.ZodNumber;
1908
+ }, z.core.$strict>>>>;
1909
+ serial: z.ZodOptional<z.ZodObject<{
1910
+ value: z.ZodString;
1911
+ origin: z.ZodEnum<{
1912
+ derived: "derived";
1913
+ read: "read";
1914
+ }>;
1915
+ readAt: z.ZodNumber;
1916
+ }, z.core.$strict>>;
1917
+ 'machine-uuid': z.ZodOptional<z.ZodObject<{
1918
+ value: z.ZodString;
1919
+ origin: z.ZodEnum<{
1920
+ derived: "derived";
1921
+ read: "read";
1922
+ }>;
1923
+ readAt: z.ZodNumber;
1924
+ }, z.core.$strict>>;
1925
+ 'vendor-uid': z.ZodOptional<z.ZodObject<{
1926
+ value: z.ZodString;
1927
+ origin: z.ZodEnum<{
1928
+ derived: "derived";
1929
+ read: "read";
1930
+ }>;
1931
+ readAt: z.ZodNumber;
1932
+ }, z.core.$strict>>;
1933
+ hostname: z.ZodOptional<z.ZodObject<{
1934
+ value: z.ZodString;
1935
+ origin: z.ZodEnum<{
1936
+ derived: "derived";
1937
+ read: "read";
1938
+ }>;
1939
+ readAt: z.ZodNumber;
1940
+ }, z.core.$strict>>;
1941
+ ip: z.ZodOptional<z.ZodObject<{
1942
+ value: z.ZodUnion<readonly [z.ZodIPv4, z.ZodIPv6]>;
1943
+ origin: z.ZodEnum<{
1944
+ derived: "derived";
1945
+ read: "read";
1946
+ }>;
1947
+ readAt: z.ZodNumber;
1948
+ }, z.core.$strict>>;
1949
+ }, z.core.$strict>>;
1467
1950
  sourceInfo: z.ZodOptional<z.ZodObject<{
1468
1951
  id: z.ZodString;
1469
1952
  system: z.ZodString;
@@ -1659,6 +2142,56 @@ export declare const deviceManagerCapability: {
1659
2142
  readAt: z.ZodNumber;
1660
2143
  }, z.core.$strict>>;
1661
2144
  }, z.core.$strict>>;
2145
+ attachedIdentifiers: z.ZodOptional<z.ZodObject<{
2146
+ mac: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodObject<{
2147
+ value: z.ZodString;
2148
+ origin: z.ZodEnum<{
2149
+ derived: "derived";
2150
+ read: "read";
2151
+ }>;
2152
+ readAt: z.ZodNumber;
2153
+ }, z.core.$strict>>>>;
2154
+ serial: z.ZodOptional<z.ZodObject<{
2155
+ value: z.ZodString;
2156
+ origin: z.ZodEnum<{
2157
+ derived: "derived";
2158
+ read: "read";
2159
+ }>;
2160
+ readAt: z.ZodNumber;
2161
+ }, z.core.$strict>>;
2162
+ 'machine-uuid': z.ZodOptional<z.ZodObject<{
2163
+ value: z.ZodString;
2164
+ origin: z.ZodEnum<{
2165
+ derived: "derived";
2166
+ read: "read";
2167
+ }>;
2168
+ readAt: z.ZodNumber;
2169
+ }, z.core.$strict>>;
2170
+ 'vendor-uid': z.ZodOptional<z.ZodObject<{
2171
+ value: z.ZodString;
2172
+ origin: z.ZodEnum<{
2173
+ derived: "derived";
2174
+ read: "read";
2175
+ }>;
2176
+ readAt: z.ZodNumber;
2177
+ }, z.core.$strict>>;
2178
+ hostname: z.ZodOptional<z.ZodObject<{
2179
+ value: z.ZodString;
2180
+ origin: z.ZodEnum<{
2181
+ derived: "derived";
2182
+ read: "read";
2183
+ }>;
2184
+ readAt: z.ZodNumber;
2185
+ }, z.core.$strict>>;
2186
+ ip: z.ZodOptional<z.ZodObject<{
2187
+ value: z.ZodUnion<readonly [z.ZodIPv4, z.ZodIPv6]>;
2188
+ origin: z.ZodEnum<{
2189
+ derived: "derived";
2190
+ read: "read";
2191
+ }>;
2192
+ readAt: z.ZodNumber;
2193
+ }, z.core.$strict>>;
2194
+ }, z.core.$strict>>;
1662
2195
  sourceInfo: z.ZodOptional<z.ZodObject<{
1663
2196
  id: z.ZodString;
1664
2197
  system: z.ZodString;
@@ -1765,6 +2298,56 @@ export declare const deviceManagerCapability: {
1765
2298
  readAt: z.ZodNumber;
1766
2299
  }, z.core.$strict>>;
1767
2300
  }, z.core.$strict>>;
2301
+ attachedIdentifiers: z.ZodOptional<z.ZodObject<{
2302
+ mac: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodObject<{
2303
+ value: z.ZodString;
2304
+ origin: z.ZodEnum<{
2305
+ derived: "derived";
2306
+ read: "read";
2307
+ }>;
2308
+ readAt: z.ZodNumber;
2309
+ }, z.core.$strict>>>>;
2310
+ serial: z.ZodOptional<z.ZodObject<{
2311
+ value: z.ZodString;
2312
+ origin: z.ZodEnum<{
2313
+ derived: "derived";
2314
+ read: "read";
2315
+ }>;
2316
+ readAt: z.ZodNumber;
2317
+ }, z.core.$strict>>;
2318
+ 'machine-uuid': z.ZodOptional<z.ZodObject<{
2319
+ value: z.ZodString;
2320
+ origin: z.ZodEnum<{
2321
+ derived: "derived";
2322
+ read: "read";
2323
+ }>;
2324
+ readAt: z.ZodNumber;
2325
+ }, z.core.$strict>>;
2326
+ 'vendor-uid': z.ZodOptional<z.ZodObject<{
2327
+ value: z.ZodString;
2328
+ origin: z.ZodEnum<{
2329
+ derived: "derived";
2330
+ read: "read";
2331
+ }>;
2332
+ readAt: z.ZodNumber;
2333
+ }, z.core.$strict>>;
2334
+ hostname: z.ZodOptional<z.ZodObject<{
2335
+ value: z.ZodString;
2336
+ origin: z.ZodEnum<{
2337
+ derived: "derived";
2338
+ read: "read";
2339
+ }>;
2340
+ readAt: z.ZodNumber;
2341
+ }, z.core.$strict>>;
2342
+ ip: z.ZodOptional<z.ZodObject<{
2343
+ value: z.ZodUnion<readonly [z.ZodIPv4, z.ZodIPv6]>;
2344
+ origin: z.ZodEnum<{
2345
+ derived: "derived";
2346
+ read: "read";
2347
+ }>;
2348
+ readAt: z.ZodNumber;
2349
+ }, z.core.$strict>>;
2350
+ }, z.core.$strict>>;
1768
2351
  sourceInfo: z.ZodOptional<z.ZodObject<{
1769
2352
  id: z.ZodString;
1770
2353
  system: z.ZodString;
@@ -1902,6 +2485,56 @@ export declare const deviceManagerCapability: {
1902
2485
  readAt: z.ZodNumber;
1903
2486
  }, z.core.$strict>>;
1904
2487
  }, z.core.$strict>>;
2488
+ attachedIdentifiers: z.ZodOptional<z.ZodObject<{
2489
+ mac: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodObject<{
2490
+ value: z.ZodString;
2491
+ origin: z.ZodEnum<{
2492
+ derived: "derived";
2493
+ read: "read";
2494
+ }>;
2495
+ readAt: z.ZodNumber;
2496
+ }, z.core.$strict>>>>;
2497
+ serial: z.ZodOptional<z.ZodObject<{
2498
+ value: z.ZodString;
2499
+ origin: z.ZodEnum<{
2500
+ derived: "derived";
2501
+ read: "read";
2502
+ }>;
2503
+ readAt: z.ZodNumber;
2504
+ }, z.core.$strict>>;
2505
+ 'machine-uuid': z.ZodOptional<z.ZodObject<{
2506
+ value: z.ZodString;
2507
+ origin: z.ZodEnum<{
2508
+ derived: "derived";
2509
+ read: "read";
2510
+ }>;
2511
+ readAt: z.ZodNumber;
2512
+ }, z.core.$strict>>;
2513
+ 'vendor-uid': z.ZodOptional<z.ZodObject<{
2514
+ value: z.ZodString;
2515
+ origin: z.ZodEnum<{
2516
+ derived: "derived";
2517
+ read: "read";
2518
+ }>;
2519
+ readAt: z.ZodNumber;
2520
+ }, z.core.$strict>>;
2521
+ hostname: z.ZodOptional<z.ZodObject<{
2522
+ value: z.ZodString;
2523
+ origin: z.ZodEnum<{
2524
+ derived: "derived";
2525
+ read: "read";
2526
+ }>;
2527
+ readAt: z.ZodNumber;
2528
+ }, z.core.$strict>>;
2529
+ ip: z.ZodOptional<z.ZodObject<{
2530
+ value: z.ZodUnion<readonly [z.ZodIPv4, z.ZodIPv6]>;
2531
+ origin: z.ZodEnum<{
2532
+ derived: "derived";
2533
+ read: "read";
2534
+ }>;
2535
+ readAt: z.ZodNumber;
2536
+ }, z.core.$strict>>;
2537
+ }, z.core.$strict>>;
1905
2538
  sourceInfo: z.ZodOptional<z.ZodObject<{
1906
2539
  id: z.ZodString;
1907
2540
  system: z.ZodString;