@camstack/types 1.2.560 → 1.2.562

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 (263) hide show
  1. package/CHANGELOG.md +22 -0
  2. package/dist/addon/instances-of-cap.d.ts +7 -2
  3. package/dist/addon.js +2 -2
  4. package/dist/addon.mjs +2 -2
  5. package/dist/automation/codegen.d.ts +6 -0
  6. package/dist/automation/recipe-literal.d.ts +35 -0
  7. package/dist/automation/recipe.d.ts +166 -120
  8. package/dist/automation/template-link.d.ts +206 -0
  9. package/dist/capabilities/accessories.cap.d.ts +6 -0
  10. package/dist/capabilities/action-source.cap.d.ts +3 -0
  11. package/dist/capabilities/actions.cap.d.ts +3 -0
  12. package/dist/capabilities/addon-pages-source.cap.d.ts +3 -0
  13. package/dist/capabilities/addon-pages.cap.d.ts +3 -0
  14. package/dist/capabilities/addon-routes.cap.d.ts +3 -0
  15. package/dist/capabilities/addon-settings.cap.d.ts +3 -0
  16. package/dist/capabilities/addon-widgets-source.cap.d.ts +3 -0
  17. package/dist/capabilities/addon-widgets.cap.d.ts +3 -0
  18. package/dist/capabilities/addons.cap.d.ts +3 -0
  19. package/dist/capabilities/admin-ui.cap.d.ts +3 -0
  20. package/dist/capabilities/air-quality-sensor.cap.d.ts +39 -0
  21. package/dist/capabilities/alarm-panel.cap.d.ts +60 -14
  22. package/dist/capabilities/alerts.cap.d.ts +3 -0
  23. package/dist/capabilities/ambient-light-sensor.cap.d.ts +12 -0
  24. package/dist/capabilities/audio-analysis.cap.d.ts +4 -0
  25. package/dist/capabilities/audio-analyzer.cap.d.ts +3 -0
  26. package/dist/capabilities/audio-codec.cap.d.ts +3 -0
  27. package/dist/capabilities/audio-metrics.cap.d.ts +4 -0
  28. package/dist/capabilities/auth-provider.cap.d.ts +3 -0
  29. package/dist/capabilities/automation-control.cap.d.ts +19 -0
  30. package/dist/capabilities/backup.cap.d.ts +3 -0
  31. package/dist/capabilities/battery.cap.d.ts +53 -0
  32. package/dist/capabilities/binary.cap.d.ts +136 -0
  33. package/dist/capabilities/board-key-source.cap.d.ts +3 -0
  34. package/dist/capabilities/brightness.cap.d.ts +13 -0
  35. package/dist/capabilities/broker.cap.d.ts +3 -0
  36. package/dist/capabilities/button.cap.d.ts +4 -0
  37. package/dist/capabilities/calendar-source.cap.d.ts +3 -0
  38. package/dist/capabilities/calendars.cap.d.ts +3 -0
  39. package/dist/capabilities/camera-credentials.cap.d.ts +4 -0
  40. package/dist/capabilities/camera-grid-layout.cap.d.ts +4 -0
  41. package/dist/capabilities/camera-pipeline-config.cap.d.ts +4 -0
  42. package/dist/capabilities/camera-streams.cap.d.ts +4 -0
  43. package/dist/capabilities/capability-definition.d.ts +37 -8
  44. package/dist/capabilities/carbon-monoxide.cap.d.ts +12 -0
  45. package/dist/capabilities/climate-control.cap.d.ts +68 -12
  46. package/dist/capabilities/cluster-update.cap.d.ts +3 -0
  47. package/dist/capabilities/color.cap.d.ts +21 -0
  48. package/dist/capabilities/composer.cap.d.ts +3 -0
  49. package/dist/capabilities/connectivity.cap.d.ts +12 -0
  50. package/dist/capabilities/consumables.cap.d.ts +4 -0
  51. package/dist/capabilities/contact.cap.d.ts +12 -0
  52. package/dist/capabilities/control.cap.d.ts +15 -0
  53. package/dist/capabilities/core-blocks.cap.d.ts +3 -0
  54. package/dist/capabilities/cover.cap.d.ts +110 -0
  55. package/dist/capabilities/custom-model-registry.cap.d.ts +3 -0
  56. package/dist/capabilities/data-store-provider.cap.d.ts +3 -0
  57. package/dist/capabilities/database-snapshot.cap.d.ts +3 -0
  58. package/dist/capabilities/day-night.cap.d.ts +25 -0
  59. package/dist/capabilities/decoder.cap.d.ts +3 -0
  60. package/dist/capabilities/detection-pipeline.cap.d.ts +4 -0
  61. package/dist/capabilities/device-admin-link.cap.d.ts +4 -0
  62. package/dist/capabilities/device-adoption.cap.d.ts +3 -0
  63. package/dist/capabilities/device-credentials.cap.d.ts +3 -0
  64. package/dist/capabilities/device-export.cap.d.ts +3 -0
  65. package/dist/capabilities/device-extension.cap.d.ts +4 -0
  66. package/dist/capabilities/device-history.cap.d.ts +3 -0
  67. package/dist/capabilities/device-manager.cap.d.ts +3 -0
  68. package/dist/capabilities/device-ops.cap.d.ts +4 -0
  69. package/dist/capabilities/device-provider.cap.d.ts +3 -0
  70. package/dist/capabilities/device-removal-hook.cap.d.ts +3 -0
  71. package/dist/capabilities/device-runs.cap.d.ts +6 -0
  72. package/dist/capabilities/device-state.cap.d.ts +3 -0
  73. package/dist/capabilities/device-status.cap.d.ts +25 -0
  74. package/dist/capabilities/device-transitions.cap.d.ts +4 -0
  75. package/dist/capabilities/dishwasher.cap.d.ts +60 -0
  76. package/dist/capabilities/display-palette.cap.d.ts +3 -0
  77. package/dist/capabilities/do-not-disturb.cap.d.ts +12 -0
  78. package/dist/capabilities/doorbell.cap.d.ts +11 -0
  79. package/dist/capabilities/embedding-encoder.cap.d.ts +3 -0
  80. package/dist/capabilities/energy-system.cap.d.ts +281 -0
  81. package/dist/capabilities/enum-sensor.cap.d.ts +10 -0
  82. package/dist/capabilities/event-emitter.cap.d.ts +11 -0
  83. package/dist/capabilities/face-gallery.cap.d.ts +3 -0
  84. package/dist/capabilities/failure-contribution.cap.d.ts +3 -0
  85. package/dist/capabilities/fan-control.cap.d.ts +19 -0
  86. package/dist/capabilities/fan-presets.cap.d.ts +3 -0
  87. package/dist/capabilities/feature-probe.cap.d.ts +5 -0
  88. package/dist/capabilities/filesystem-browse.cap.d.ts +3 -0
  89. package/dist/capabilities/flood.cap.d.ts +12 -0
  90. package/dist/capabilities/gas.cap.d.ts +12 -0
  91. package/dist/capabilities/group-active.cap.d.ts +4 -0
  92. package/dist/capabilities/group-commands.cap.d.ts +4 -0
  93. package/dist/capabilities/group-status.cap.d.ts +23 -0
  94. package/dist/capabilities/heat-pump-control.cap.d.ts +4 -0
  95. package/dist/capabilities/heat-pump-status.cap.d.ts +4 -0
  96. package/dist/capabilities/heating-valve.cap.d.ts +12 -0
  97. package/dist/capabilities/hero-layout.cap.d.ts +3 -0
  98. package/dist/capabilities/humidifier.cap.d.ts +19 -0
  99. package/dist/capabilities/humidity-sensor.cap.d.ts +12 -0
  100. package/dist/capabilities/image-settings.cap.d.ts +4 -0
  101. package/dist/capabilities/image.cap.d.ts +4 -0
  102. package/dist/capabilities/index.d.ts +5 -3
  103. package/dist/capabilities/integration-instances.cap.d.ts +12 -0
  104. package/dist/capabilities/integrations.cap.d.ts +3 -0
  105. package/dist/capabilities/intercom.cap.d.ts +13 -0
  106. package/dist/capabilities/ir-transmitter.cap.d.ts +101 -0
  107. package/dist/capabilities/keychain-admin.cap.d.ts +3 -0
  108. package/dist/capabilities/keychain.cap.d.ts +3 -0
  109. package/dist/capabilities/lawn-mower-control.cap.d.ts +36 -0
  110. package/dist/capabilities/llm-runtime.cap.d.ts +3 -0
  111. package/dist/capabilities/llm.cap.d.ts +3 -0
  112. package/dist/capabilities/load-contribution.cap.d.ts +3 -0
  113. package/dist/capabilities/local-network.cap.d.ts +3 -0
  114. package/dist/capabilities/lock-control.cap.d.ts +35 -0
  115. package/dist/capabilities/log-channels.cap.d.ts +3 -0
  116. package/dist/capabilities/log-destination.cap.d.ts +3 -0
  117. package/dist/capabilities/login-method.cap.d.ts +3 -0
  118. package/dist/capabilities/media-player.cap.d.ts +66 -6
  119. package/dist/capabilities/mesh-network.cap.d.ts +3 -0
  120. package/dist/capabilities/meter.cap.d.ts +11 -0
  121. package/dist/capabilities/metrics-provider.cap.d.ts +3 -0
  122. package/dist/capabilities/migrations.cap.d.ts +3 -0
  123. package/dist/capabilities/model-convert.cap.d.ts +3 -0
  124. package/dist/capabilities/model-distributor.cap.d.ts +3 -0
  125. package/dist/capabilities/motion-detection.cap.d.ts +5 -0
  126. package/dist/capabilities/motion-trigger.cap.d.ts +13 -0
  127. package/dist/capabilities/motion-zones.cap.d.ts +4 -0
  128. package/dist/capabilities/motion.cap.d.ts +13 -0
  129. package/dist/capabilities/mqtt-broker.cap.d.ts +3 -0
  130. package/dist/capabilities/native-object-detection.cap.d.ts +19 -0
  131. package/dist/capabilities/navigation.cap.d.ts +36 -0
  132. package/dist/capabilities/network-access.cap.d.ts +3 -0
  133. package/dist/capabilities/network-link.cap.d.ts +31 -0
  134. package/dist/capabilities/network-quality.cap.d.ts +3 -0
  135. package/dist/capabilities/node-certificates.cap.d.ts +3 -0
  136. package/dist/capabilities/node-removal-hook.cap.d.ts +3 -0
  137. package/dist/capabilities/nodes.cap.d.ts +3 -0
  138. package/dist/capabilities/notification-output.cap.d.ts +3 -0
  139. package/dist/capabilities/notification-rules.cap.d.ts +3 -0
  140. package/dist/capabilities/notifier.cap.d.ts +5 -0
  141. package/dist/capabilities/numeric-sensor.cap.d.ts +11 -0
  142. package/dist/capabilities/oauth-integration.cap.d.ts +3 -0
  143. package/dist/capabilities/osd-manager.cap.d.ts +3 -0
  144. package/dist/capabilities/osd.cap.d.ts +5 -0
  145. package/dist/capabilities/pet-feeder.cap.d.ts +35 -9
  146. package/dist/capabilities/pet-fountain.cap.d.ts +19 -0
  147. package/dist/capabilities/pipeline-analytics.cap.d.ts +35 -0
  148. package/dist/capabilities/pipeline-executor.cap.d.ts +3 -0
  149. package/dist/capabilities/pipeline-orchestrator.cap.d.ts +3 -0
  150. package/dist/capabilities/pipeline-runner.cap.d.ts +3 -0
  151. package/dist/capabilities/plate-gallery.cap.d.ts +3 -0
  152. package/dist/capabilities/platform-probe.cap.d.ts +3 -0
  153. package/dist/capabilities/power-meter.cap.d.ts +33 -0
  154. package/dist/capabilities/power-source.cap.d.ts +12 -0
  155. package/dist/capabilities/presence.cap.d.ts +11 -0
  156. package/dist/capabilities/pressure-sensor.cap.d.ts +12 -0
  157. package/dist/capabilities/privacy-mask.cap.d.ts +19 -0
  158. package/dist/capabilities/ptz-autotrack.cap.d.ts +13 -0
  159. package/dist/capabilities/ptz.cap.d.ts +11 -7
  160. package/dist/capabilities/pump-cycle.cap.d.ts +12 -0
  161. package/dist/capabilities/reboot.cap.d.ts +4 -0
  162. package/dist/capabilities/record-entries.cap.d.ts +3 -0
  163. package/dist/capabilities/recording-archive.cap.d.ts +3 -0
  164. package/dist/capabilities/recording-export.cap.d.ts +3 -0
  165. package/dist/capabilities/recording-onboard.cap.d.ts +12 -0
  166. package/dist/capabilities/recording-signal.cap.d.ts +12 -0
  167. package/dist/capabilities/recording.cap.d.ts +4 -0
  168. package/dist/capabilities/records.cap.d.ts +3 -0
  169. package/dist/capabilities/remote-layout-components.cap.d.ts +3 -0
  170. package/dist/capabilities/remote.cap.d.ts +3 -0
  171. package/dist/capabilities/running-state.cap.d.ts +77 -0
  172. package/dist/capabilities/scene-monitor.cap.d.ts +11 -0
  173. package/dist/capabilities/schedulers.cap.d.ts +3 -0
  174. package/dist/capabilities/script-runner.cap.d.ts +12 -0
  175. package/dist/capabilities/server-management.cap.d.ts +3 -0
  176. package/dist/capabilities/settings-store.cap.d.ts +3 -0
  177. package/dist/capabilities/smoke.cap.d.ts +12 -0
  178. package/dist/capabilities/smtp-provider.cap.d.ts +3 -0
  179. package/dist/capabilities/snapshot.cap.d.ts +4 -0
  180. package/dist/capabilities/sso-bridge.cap.d.ts +3 -0
  181. package/dist/capabilities/storage-admin.cap.d.ts +3 -0
  182. package/dist/capabilities/storage-evictable.cap.d.ts +3 -0
  183. package/dist/capabilities/storage-migration.cap.d.ts +3 -0
  184. package/dist/capabilities/storage-occupancy.cap.d.ts +3 -0
  185. package/dist/capabilities/storage-provider.cap.d.ts +3 -0
  186. package/dist/capabilities/storage.cap.d.ts +3 -0
  187. package/dist/capabilities/stream-broker.cap.d.ts +3 -0
  188. package/dist/capabilities/stream-catalog.cap.d.ts +4 -0
  189. package/dist/capabilities/stream-params.cap.d.ts +4 -0
  190. package/dist/capabilities/stream-signals.cap.d.ts +4 -0
  191. package/dist/capabilities/switch.cap.d.ts +208 -0
  192. package/dist/capabilities/system.cap.d.ts +3 -0
  193. package/dist/capabilities/tamper.cap.d.ts +12 -0
  194. package/dist/capabilities/temperature-sensor.cap.d.ts +12 -0
  195. package/dist/capabilities/template.cap.d.ts +42 -2
  196. package/dist/capabilities/terminal-session.cap.d.ts +3 -0
  197. package/dist/capabilities/timed-run.cap.d.ts +4 -0
  198. package/dist/capabilities/toast.cap.d.ts +3 -0
  199. package/dist/capabilities/training-provider.cap.d.ts +3 -0
  200. package/dist/capabilities/training.cap.d.ts +3 -0
  201. package/dist/capabilities/turn-provider.cap.d.ts +3 -0
  202. package/dist/capabilities/update.cap.d.ts +19 -0
  203. package/dist/capabilities/user-management.cap.d.ts +3 -0
  204. package/dist/capabilities/user-passkeys.cap.d.ts +3 -0
  205. package/dist/capabilities/vacuum-control.cap.d.ts +43 -0
  206. package/dist/capabilities/valve.cap.d.ts +38 -0
  207. package/dist/capabilities/vector-store.cap.d.ts +3 -0
  208. package/dist/capabilities/vibration.cap.d.ts +12 -0
  209. package/dist/capabilities/videoclips.cap.d.ts +4 -0
  210. package/dist/capabilities/viewer-ui.cap.d.ts +3 -0
  211. package/dist/capabilities/water-heater.cap.d.ts +33 -4
  212. package/dist/capabilities/weather.cap.d.ts +39 -0
  213. package/dist/capabilities/webrtc-session.cap.d.ts +4 -0
  214. package/dist/capabilities/zone-analytics.cap.d.ts +11 -0
  215. package/dist/capabilities/zone-rules.cap.d.ts +4 -0
  216. package/dist/capabilities/zones.cap.d.ts +4 -0
  217. package/dist/client.js +186 -29
  218. package/dist/client.mjs +186 -29
  219. package/dist/{composed-stable-id-iddnCQ51.mjs → composed-stable-id-B3wcvtvW.mjs} +4 -0
  220. package/dist/{composed-stable-id-BmJ_5GiE.js → composed-stable-id-Bp33yrYi.js} +4 -0
  221. package/dist/device/cap-vocabulary/declaration.d.ts +107 -0
  222. package/dist/device/cap-vocabulary/index.d.ts +4 -2
  223. package/dist/device/cap-vocabulary/system-reasons.d.ts +17 -0
  224. package/dist/device/cap-vocabulary/types.d.ts +24 -6
  225. package/dist/device/cap-vocabulary/vocabulary.d.ts +15 -3
  226. package/dist/device/device-control-resolution.d.ts +1 -1
  227. package/dist/device/device-icon.d.ts +1 -0
  228. package/dist/device/device-type.d.ts +5 -1
  229. package/dist/device/hero/hero-layout.d.ts +1 -0
  230. package/dist/device/hero/hero-look.d.ts +6 -0
  231. package/dist/device/hero/hero-scene.d.ts +1 -0
  232. package/dist/generated/addon-api.d.ts +66 -52
  233. package/dist/generated/addon-cap-facts.d.ts +1 -1
  234. package/dist/generated/cap-status-types.d.ts +3 -1
  235. package/dist/generated/cap-vocabulary.d.ts +7 -0
  236. package/dist/generated/capability-router-map.d.ts +5 -2
  237. package/dist/generated/customize-catalog.d.ts +1 -1
  238. package/dist/generated/device-local-state.d.ts +6 -0
  239. package/dist/generated/device-proxy.d.ts +4 -0
  240. package/dist/generated/device-scoped-caps.d.ts +1 -1
  241. package/dist/generated/history-catalog.d.ts +1 -1
  242. package/dist/generated/method-access-map.d.ts +1 -1
  243. package/dist/generated/method-device-selectors.d.ts +1 -1
  244. package/dist/generated/runtime-state-durability.d.ts +1 -1
  245. package/dist/{implemented-methods-CfaRR_ki.js → implemented-methods-CDYOCn9a.js} +1 -1
  246. package/dist/{implemented-methods-CSTk6zYK.mjs → implemented-methods-CgUBu6uM.mjs} +1 -1
  247. package/dist/index.d.ts +6 -2
  248. package/dist/index.js +6739 -765
  249. package/dist/index.mjs +6685 -766
  250. package/dist/node.js +2 -2
  251. package/dist/node.mjs +2 -2
  252. package/dist/{sleep-CyWfD1LJ.js → sleep-Cb2px0Nb.js} +5706 -1620
  253. package/dist/{sleep-BvVGLl30.mjs → sleep-Cykc2bzi.mjs} +5701 -1621
  254. package/dist/template/automation-template.d.ts +782 -0
  255. package/dist/template/builtin-automation-templates.d.ts +17 -0
  256. package/dist/template/template-kinds.d.ts +4 -3
  257. package/package.json +1 -1
  258. package/dist/device/cap-vocabulary/entries/actuators.d.ts +0 -5
  259. package/dist/device/cap-vocabulary/entries/appliances.d.ts +0 -5
  260. package/dist/device/cap-vocabulary/entries/camera.d.ts +0 -5
  261. package/dist/device/cap-vocabulary/entries/heat-pump.d.ts +0 -4
  262. package/dist/device/cap-vocabulary/entries/sensors.d.ts +0 -5
  263. package/dist/device/cap-vocabulary/entries/system.d.ts +0 -8
@@ -1,6 +1,7 @@
1
1
  import { z } from 'zod';
2
2
  import { type InferProvider } from './capability-definition.js';
3
3
  import { DeviceType } from '../device/device-type.js';
4
+ import { EventCategory } from '../enums/event-category.js';
4
5
  /**
5
6
  * Battery status snapshot. Emitted by providers whose device is
6
7
  * battery-operated (cameras with `DeviceFeature.BatteryOperated`,
@@ -96,6 +97,7 @@ export declare const batteryCapability: {
96
97
  binary: z.ZodOptional<z.ZodBoolean>;
97
98
  }, z.core.$strip>;
98
99
  }, z.core.$strip>;
100
+ readonly notOperatorFacing: 'the level / sleeping / charging state triggers each read one field of this change';
99
101
  };
100
102
  };
101
103
  readonly status: {
@@ -217,5 +219,56 @@ export declare const batteryCapability: {
217
219
  /** Clock fields: written, but excluded from the compare that decides
218
220
  * whether persisting is worth a SQLite commit. */
219
221
  readonly volatileStateFields: readonly ["lastUpdated"];
222
+ readonly vocabulary: {
223
+ readonly noun: import("../index.js").VocabL10n;
224
+ readonly order: 5240;
225
+ readonly state: readonly [{
226
+ readonly kind: 'numeric';
227
+ readonly field: 'level';
228
+ readonly quantity: import("../index.js").VocabL10n;
229
+ readonly label: import("../index.js").VocabL10n;
230
+ readonly unit: '%';
231
+ readonly icon: 'battery';
232
+ }, {
233
+ readonly kind: 'boolean';
234
+ readonly field: 'sleeping';
235
+ readonly label: import("../index.js").VocabL10n;
236
+ readonly whenTrue: import("../index.js").VocabL10n;
237
+ readonly whenFalse: import("../index.js").VocabL10n;
238
+ readonly icon: 'moon';
239
+ }, {
240
+ readonly kind: 'enum';
241
+ readonly field: 'charging';
242
+ readonly label: import("../index.js").VocabL10n;
243
+ readonly values: readonly [{
244
+ readonly value: 'dc';
245
+ readonly label: import("../index.js").VocabL10n;
246
+ readonly phrase: import("../index.js").VocabL10n;
247
+ }, {
248
+ readonly value: 'solar';
249
+ readonly label: import("../index.js").VocabL10n;
250
+ readonly phrase: import("../index.js").VocabL10n;
251
+ }, {
252
+ readonly value: 'none';
253
+ readonly label: import("../index.js").VocabL10n;
254
+ readonly phrase: import("../index.js").VocabL10n;
255
+ }, {
256
+ readonly value: 'unknown';
257
+ readonly label: import("../index.js").VocabL10n;
258
+ }];
259
+ readonly icon: 'battery-charging';
260
+ }];
261
+ readonly extraEvents: readonly [{
262
+ readonly category: EventCategory.DeviceAwake;
263
+ readonly label: import("../index.js").VocabL10n;
264
+ readonly phrase: import("../index.js").VocabL10n;
265
+ readonly icon: 'sun';
266
+ }, {
267
+ readonly category: EventCategory.DeviceSleeping;
268
+ readonly label: import("../index.js").VocabL10n;
269
+ readonly phrase: import("../index.js").VocabL10n;
270
+ readonly icon: 'moon';
271
+ }];
272
+ };
220
273
  };
221
274
  export type IBatteryProvider = InferProvider<typeof batteryCapability>;
@@ -55,5 +55,141 @@ export declare const binaryCapability: {
55
55
  /** Clock fields: written, but excluded from the compare that decides
56
56
  * whether persisting is worth a SQLite commit. */
57
57
  readonly volatileStateFields: readonly ["lastChangedAt"];
58
+ readonly vocabulary: {
59
+ readonly noun: import("../index.js").VocabL10n;
60
+ readonly order: 5020;
61
+ readonly state: readonly [{
62
+ readonly kind: 'boolean';
63
+ readonly field: 'on';
64
+ readonly label: import("../index.js").VocabL10n;
65
+ readonly whenTrue: import("../index.js").VocabL10n;
66
+ readonly whenFalse: import("../index.js").VocabL10n;
67
+ readonly icon: 'toggle-right';
68
+ }];
69
+ readonly overrides: {
70
+ readonly byRole: {
71
+ readonly "motion-sensor": {
72
+ readonly state: {
73
+ readonly on: {
74
+ readonly label: import("../index.js").VocabL10n;
75
+ readonly whenTrue: import("../index.js").VocabL10n;
76
+ readonly whenFalse: import("../index.js").VocabL10n;
77
+ readonly icon: 'activity';
78
+ };
79
+ };
80
+ };
81
+ readonly "contact-sensor": {
82
+ readonly state: {
83
+ readonly on: {
84
+ readonly label: import("../index.js").VocabL10n;
85
+ readonly whenTrue: import("../index.js").VocabL10n;
86
+ readonly whenFalse: import("../index.js").VocabL10n;
87
+ readonly icon: 'door-open';
88
+ };
89
+ };
90
+ };
91
+ readonly "leak-sensor": {
92
+ readonly state: {
93
+ readonly on: {
94
+ readonly label: import("../index.js").VocabL10n;
95
+ readonly whenTrue: import("../index.js").VocabL10n;
96
+ readonly whenFalse: import("../index.js").VocabL10n;
97
+ readonly icon: 'droplets';
98
+ };
99
+ };
100
+ };
101
+ readonly "smoke-sensor": {
102
+ readonly state: {
103
+ readonly on: {
104
+ readonly label: import("../index.js").VocabL10n;
105
+ readonly whenTrue: import("../index.js").VocabL10n;
106
+ readonly whenFalse: import("../index.js").VocabL10n;
107
+ readonly icon: 'alarm-smoke';
108
+ };
109
+ };
110
+ };
111
+ readonly "co-sensor": {
112
+ readonly state: {
113
+ readonly on: {
114
+ readonly label: import("../index.js").VocabL10n;
115
+ readonly whenTrue: import("../index.js").VocabL10n;
116
+ readonly whenFalse: import("../index.js").VocabL10n;
117
+ readonly icon: 'cloud-alert';
118
+ };
119
+ };
120
+ };
121
+ readonly "gas-sensor": {
122
+ readonly state: {
123
+ readonly on: {
124
+ readonly label: import("../index.js").VocabL10n;
125
+ readonly whenTrue: import("../index.js").VocabL10n;
126
+ readonly whenFalse: import("../index.js").VocabL10n;
127
+ readonly icon: 'flame';
128
+ };
129
+ };
130
+ };
131
+ readonly "tamper-sensor": {
132
+ readonly state: {
133
+ readonly on: {
134
+ readonly label: import("../index.js").VocabL10n;
135
+ readonly whenTrue: import("../index.js").VocabL10n;
136
+ readonly whenFalse: import("../index.js").VocabL10n;
137
+ readonly icon: 'shield-alert';
138
+ };
139
+ };
140
+ };
141
+ readonly "vibration-sensor": {
142
+ readonly state: {
143
+ readonly on: {
144
+ readonly label: import("../index.js").VocabL10n;
145
+ readonly whenTrue: import("../index.js").VocabL10n;
146
+ readonly whenFalse: import("../index.js").VocabL10n;
147
+ readonly icon: 'vibrate';
148
+ };
149
+ };
150
+ };
151
+ readonly "connectivity-sensor": {
152
+ readonly state: {
153
+ readonly on: {
154
+ readonly label: import("../index.js").VocabL10n;
155
+ readonly whenTrue: import("../index.js").VocabL10n;
156
+ readonly whenFalse: import("../index.js").VocabL10n;
157
+ readonly icon: 'wifi';
158
+ };
159
+ };
160
+ };
161
+ readonly "sound-sensor": {
162
+ readonly state: {
163
+ readonly on: {
164
+ readonly label: import("../index.js").VocabL10n;
165
+ readonly whenTrue: import("../index.js").VocabL10n;
166
+ readonly whenFalse: import("../index.js").VocabL10n;
167
+ readonly icon: 'ear';
168
+ };
169
+ };
170
+ };
171
+ readonly "battery-sensor": {
172
+ readonly state: {
173
+ readonly on: {
174
+ readonly label: import("../index.js").VocabL10n;
175
+ readonly whenTrue: import("../index.js").VocabL10n;
176
+ readonly whenFalse: import("../index.js").VocabL10n;
177
+ readonly icon: 'battery-low';
178
+ };
179
+ };
180
+ };
181
+ readonly "binary-helper": {
182
+ readonly state: {
183
+ readonly on: {
184
+ readonly label: import("../index.js").VocabL10n;
185
+ readonly whenTrue: import("../index.js").VocabL10n;
186
+ readonly whenFalse: import("../index.js").VocabL10n;
187
+ readonly icon: 'toggle-right';
188
+ };
189
+ };
190
+ };
191
+ };
192
+ };
193
+ };
58
194
  };
59
195
  export type IBinaryProvider = InferProvider<typeof binaryCapability>;
@@ -124,6 +124,9 @@ export declare const boardKeySourceCapability: {
124
124
  detail: z.ZodOptional<z.ZodString>;
125
125
  }, z.core.$strip>], "ok">, import("./capability-definition.js").CapabilityMethodKind>;
126
126
  };
127
+ readonly vocabulary: {
128
+ readonly notOperatorFacing: "internal plumbing between addons — never operator-facing";
129
+ };
127
130
  };
128
131
  export type IBoardKeySourceProvider = InferProvider<typeof boardKeySourceCapability>;
129
132
  export {};
@@ -42,6 +42,7 @@ export declare const brightnessCapability: {
42
42
  level: z.ZodNumber;
43
43
  lastChangedAt: z.ZodNumber;
44
44
  }, z.core.$strip>;
45
+ readonly notOperatorFacing: 'the `level` state trigger reads the same change';
45
46
  };
46
47
  };
47
48
  readonly status: {
@@ -79,5 +80,17 @@ export declare const brightnessCapability: {
79
80
  };
80
81
  };
81
82
  };
83
+ readonly vocabulary: {
84
+ readonly noun: import("../index.js").VocabL10n;
85
+ readonly order: 1010;
86
+ readonly state: readonly [{
87
+ readonly kind: 'numeric';
88
+ readonly field: 'level';
89
+ readonly quantity: import("../index.js").VocabL10n;
90
+ readonly label: import("../index.js").VocabL10n;
91
+ readonly unit: '%';
92
+ readonly icon: 'sun';
93
+ }];
94
+ };
82
95
  };
83
96
  export type IBrightnessProvider = InferProvider<typeof brightnessCapability>;
@@ -99,6 +99,9 @@ export declare const brokerCapability: {
99
99
  connectedCount: z.ZodNumber;
100
100
  }, z.core.$strip>, import("./capability-definition.js").CapabilityMethodKind>;
101
101
  };
102
+ readonly vocabulary: {
103
+ readonly notOperatorFacing: 'message-broker connections — configured, not actuated';
104
+ };
102
105
  };
103
106
  export type IBrokerProvider = InferProvider<typeof brokerCapability>;
104
107
  export { RegistryStatusSchema as BrokerRegistryStatusSchema, PublishInputSchema as BrokerPublishInputSchema, SubscribeInputSchema as BrokerSubscribeInputSchema, SubscribeResultSchema as BrokerSubscribeResultSchema, UnsubscribeInputSchema as BrokerUnsubscribeInputSchema, GetStateInputSchema as BrokerGetStateInputSchema, };
@@ -22,5 +22,9 @@ export declare const buttonCapability: {
22
22
  deviceId: z.ZodNumber;
23
23
  }, z.core.$strip>, z.ZodVoid, "mutation">;
24
24
  };
25
+ readonly vocabulary: {
26
+ readonly noun: import("../index.js").VocabL10n;
27
+ readonly order: 1130;
28
+ };
25
29
  };
26
30
  export type IButtonProvider = InferProvider<typeof buttonCapability>;
@@ -86,6 +86,9 @@ export declare const calendarSourceCapability: {
86
86
  location: z.ZodOptional<z.ZodString>;
87
87
  }, z.core.$strip>>>, import("./capability-definition.js").CapabilityMethodKind>;
88
88
  };
89
+ readonly vocabulary: {
90
+ readonly notOperatorFacing: "internal plumbing between addons — never operator-facing";
91
+ };
89
92
  };
90
93
  export type ICalendarSourceProvider = InferProvider<typeof calendarSourceCapability>;
91
94
  /** A half-open `[startMs, endMs)` interval of local instants. */
@@ -104,6 +104,9 @@ export declare const calendarsCapability: {
104
104
  readonly caller: 'required';
105
105
  };
106
106
  };
107
+ readonly vocabulary: {
108
+ readonly notOperatorFacing: 'calendars feed schedules and conditions, not device actions';
109
+ };
107
110
  };
108
111
  export type ICalendarsProvider = InferProvider<typeof calendarsCapability>;
109
112
  export { CalendarEventSchema, CalendarInfoSchema, CalendarListEventsInputSchema, CalendarSourceKindSchema, };
@@ -98,5 +98,9 @@ export declare const cameraCredentialsCapability: {
98
98
  }, z.core.$strip>;
99
99
  readonly kind: 'command-driven';
100
100
  };
101
+ readonly vocabulary: {
102
+ readonly noun: import("../index.js").VocabL10n;
103
+ readonly order: 3030;
104
+ };
101
105
  };
102
106
  export type ICameraCredentialsProvider = InferProvider<typeof cameraCredentialsCapability>;
@@ -278,6 +278,10 @@ export declare const cameraGridLayoutCapability: {
278
278
  }, z.core.$strip>>;
279
279
  }, z.core.$strip>, "mutation">;
280
280
  };
281
+ readonly vocabulary: {
282
+ readonly noun: import("../index.js").VocabL10n;
283
+ readonly order: 3040;
284
+ };
281
285
  };
282
286
  /**
283
287
  * The DEVICE's provider: the data methods only.
@@ -38,5 +38,9 @@ export declare const cameraPipelineConfigCapability: {
38
38
  readonly deviceTypes: readonly [DeviceType.Camera];
39
39
  readonly exposesDeviceSettings: true;
40
40
  readonly methods: {};
41
+ readonly vocabulary: {
42
+ readonly noun: import("../index.js").VocabL10n;
43
+ readonly order: 3050;
44
+ };
41
45
  };
42
46
  export type ICameraPipelineConfigProvider = InferProvider<typeof cameraPipelineConfigCapability>;
@@ -407,5 +407,9 @@ export declare const cameraStreamsCapability: {
407
407
  * History (D850): none — `online` duplicates device-status.online (one authority); slot data is nested enum/string.
408
408
  */
409
409
  readonly history: 'none';
410
+ readonly vocabulary: {
411
+ readonly noun: import("../index.js").VocabL10n;
412
+ readonly order: 3060;
413
+ };
410
414
  };
411
415
  export type ICameraStreamsProvider = InferProvider<typeof cameraStreamsCapability>;
@@ -17,6 +17,8 @@ import type { ConfigUISchemaWithValues } from '../interfaces/config-ui.js';
17
17
  import type { ExtensionSlotDescriptor } from '../device-extension/slot-descriptor.js';
18
18
  import type { MethodRoleDecl } from '../auth/viewer-access.js';
19
19
  import type { CapabilityCustomizeSpec } from './customize-spec.js';
20
+ import type { CapVocabularyDecl, EventVocabularyDecl, LooseMethodActionDecl, MethodActionDecl } from '../device/cap-vocabulary/declaration.js';
21
+ import type { VocabEventTrigger } from '../device/cap-vocabulary/types.js';
20
22
  /**
21
23
  * tRPC procedure kind.
22
24
  * - 'query': read-only, no side effects
@@ -160,6 +162,14 @@ export interface CapabilityMethodSchema<TInput extends z.ZodType = z.ZodType, TO
160
162
  * the provider input untyped).
161
163
  */
162
164
  readonly caller?: CapabilityMethodCaller;
165
+ /**
166
+ * The operator-facing actions this method offers (D1050): what a step, a
167
+ * remote button or the MCP can make a device do through it. Codegen
168
+ * projects them into the cap vocabulary (`generated/cap-vocabulary.ts`).
169
+ */
170
+ readonly actions?: readonly LooseMethodActionDecl[];
171
+ /** Why this mutation is never a step (D1050) — the alternative to `actions`. */
172
+ readonly notOperatorFacing?: string;
163
173
  }
164
174
  export declare const CapabilityEventFromStateSchema: z.ZodObject<{
165
175
  field: z.ZodString;
@@ -171,6 +181,10 @@ export interface CapabilityEventSchema<TData extends z.ZodType = z.ZodType> {
171
181
  readonly data: TData;
172
182
  /** A strict numeric state advance derives this one-shot event (D670). */
173
183
  readonly fromState?: CapabilityEventFromState;
184
+ /** The automation trigger this event is (D1050), phrased. */
185
+ readonly trigger?: VocabEventTrigger;
186
+ /** Why this event is not an automation trigger (D1050) — the alternative to `trigger`. */
187
+ readonly notOperatorFacing?: string;
174
188
  }
175
189
  export type CapabilityStatusKind = 'push' | 'poll' | 'command-driven';
176
190
  /**
@@ -709,6 +723,14 @@ export interface CapabilityDefinition<TName extends string = string, TMethods ex
709
723
  * `generated/history-catalog.ts`.
710
724
  */
711
725
  readonly history?: CapabilityHistory;
726
+ /**
727
+ * The cap's vocabulary block (D1050): noun, state triggers, wording
728
+ * overrides, picker order — or, for a system cap, why it is no device's
729
+ * vocabulary. Actions sit on their methods, event wording on the events.
730
+ * Mandatory for every cap (`scripts/check-cap-vocabulary.ts`); codegen
731
+ * projects it into `generated/cap-vocabulary.ts`.
732
+ */
733
+ readonly vocabulary?: CapVocabularyDecl;
712
734
  /**
713
735
  * Generic Customize override (D936). When present, admin-ui offers the
714
736
  * declared targets instead of a cap-specific card. Codegen projects it
@@ -1211,7 +1233,7 @@ export type InferRuntimeState<T extends CapabilityDefinition> = T extends {
1211
1233
  readonly _output: infer Out;
1212
1234
  } ? Out : unknown : unknown;
1213
1235
  /** Options for a capability method definition. */
1214
- export interface CapabilityMethodOptions<TKind extends CapabilityMethodKind = CapabilityMethodKind> {
1236
+ export interface CapabilityMethodOptions<TKind extends CapabilityMethodKind = CapabilityMethodKind, TIn extends z.ZodType = z.ZodType> {
1215
1237
  /** tRPC procedure kind. Default: 'query'. */
1216
1238
  readonly kind?: TKind;
1217
1239
  /** Auth level. Default: 'protected'. */
@@ -1229,6 +1251,13 @@ export interface CapabilityMethodOptions<TKind extends CapabilityMethodKind = Ca
1229
1251
  * {@link CapabilityMethodSchema.caller}.
1230
1252
  */
1231
1253
  readonly caller?: CapabilityMethodCaller;
1254
+ /**
1255
+ * The operator-facing actions this method offers (D1050), typed against
1256
+ * its input: fixed `args` and `openArgs` keys are the input's own keys.
1257
+ */
1258
+ readonly actions?: readonly MethodActionDecl<z.input<NoInfer<TIn>>>[];
1259
+ /** Why this mutation is never a step (D1050) — the alternative to `actions`. */
1260
+ readonly notOperatorFacing?: string;
1232
1261
  }
1233
1262
  /**
1234
1263
  * Shorthand to define a method schema.
@@ -1239,24 +1268,24 @@ export interface CapabilityMethodOptions<TKind extends CapabilityMethodKind = Ca
1239
1268
  * add the injected `caller: CapCaller` field to the provider's input
1240
1269
  * type. Same pattern as `systemMethod()`'s `systemOnly: true` literal.
1241
1270
  */
1242
- export declare function method<TIn extends z.ZodType, TOut extends z.ZodType, TKind extends CapabilityMethodKind = 'query'>(input: TIn, output: TOut, options: CapabilityMethodOptions<TKind> & {
1271
+ export declare function method<TIn extends z.ZodType, TOut extends z.ZodType, TKind extends CapabilityMethodKind = 'query'>(input: TIn, output: TOut, options: CapabilityMethodOptions<TKind, TIn> & {
1243
1272
  readonly caller: 'required';
1244
1273
  }): CapabilityMethodSchema<TIn, TOut, TKind> & {
1245
1274
  readonly caller: 'required';
1246
1275
  };
1247
- export declare function method<TIn extends z.ZodType, TOut extends z.ZodType, TKind extends CapabilityMethodKind = 'query'>(input: TIn, output: TOut, options: CapabilityMethodOptions<TKind> & {
1276
+ export declare function method<TIn extends z.ZodType, TOut extends z.ZodType, TKind extends CapabilityMethodKind = 'query'>(input: TIn, output: TOut, options: CapabilityMethodOptions<TKind, TIn> & {
1248
1277
  readonly caller: 'scoped';
1249
1278
  }): CapabilityMethodSchema<TIn, TOut, TKind> & {
1250
1279
  readonly caller: 'scoped';
1251
1280
  };
1252
- export declare function method<TIn extends z.ZodType, TOut extends z.ZodType, TKind extends CapabilityMethodKind = 'query'>(input: TIn, output: TOut, options?: CapabilityMethodOptions<TKind>): CapabilityMethodSchema<TIn, TOut, TKind>;
1281
+ export declare function method<TIn extends z.ZodType, TOut extends z.ZodType, TKind extends CapabilityMethodKind = 'query'>(input: TIn, output: TOut, options?: CapabilityMethodOptions<TKind, TIn>): CapabilityMethodSchema<TIn, TOut, TKind>;
1253
1282
  /**
1254
1283
  * A wrapper/system-only method: served exclusively by the cap's system-level
1255
1284
  * provider (`InferProvider`), and OPTIONAL on `InferNativeProvider` so per-device
1256
1285
  * driver natives don't stub out a wrapper concern (e.g. a cross-device cache
1257
1286
  * overview). The `systemOnly: true` literal is what `InferNativeProvider` keys on.
1258
1287
  */
1259
- export declare function systemMethod<TIn extends z.ZodType, TOut extends z.ZodType, TKind extends CapabilityMethodKind = 'query'>(input: TIn, output: TOut, options?: CapabilityMethodOptions<TKind>): CapabilityMethodSchema<TIn, TOut, TKind> & {
1288
+ export declare function systemMethod<TIn extends z.ZodType, TOut extends z.ZodType, TKind extends CapabilityMethodKind = 'query'>(input: TIn, output: TOut, options?: CapabilityMethodOptions<TKind, TIn>): CapabilityMethodSchema<TIn, TOut, TKind> & {
1260
1289
  readonly systemOnly: true;
1261
1290
  };
1262
1291
  /**
@@ -1265,17 +1294,17 @@ export declare function systemMethod<TIn extends z.ZodType, TOut extends z.ZodTy
1265
1294
  * `InferProvider` keys on; see {@link CapabilityMethodSchema.providerOptional}
1266
1295
  * for when this is the honest answer and when it is a soft stub.
1267
1296
  */
1268
- export declare function optionalMethod<TIn extends z.ZodType, TOut extends z.ZodType, TKind extends CapabilityMethodKind = 'query'>(input: TIn, output: TOut, options: CapabilityMethodOptions<TKind> & {
1297
+ export declare function optionalMethod<TIn extends z.ZodType, TOut extends z.ZodType, TKind extends CapabilityMethodKind = 'query'>(input: TIn, output: TOut, options: CapabilityMethodOptions<TKind, TIn> & {
1269
1298
  readonly caller: 'scoped';
1270
1299
  }): CapabilityMethodSchema<TIn, TOut, TKind> & {
1271
1300
  readonly providerOptional: true;
1272
1301
  readonly caller: 'scoped';
1273
1302
  };
1274
- export declare function optionalMethod<TIn extends z.ZodType, TOut extends z.ZodType, TKind extends CapabilityMethodKind = 'query'>(input: TIn, output: TOut, options?: CapabilityMethodOptions<TKind>): CapabilityMethodSchema<TIn, TOut, TKind> & {
1303
+ export declare function optionalMethod<TIn extends z.ZodType, TOut extends z.ZodType, TKind extends CapabilityMethodKind = 'query'>(input: TIn, output: TOut, options?: CapabilityMethodOptions<TKind, TIn>): CapabilityMethodSchema<TIn, TOut, TKind> & {
1275
1304
  readonly providerOptional: true;
1276
1305
  };
1277
1306
  /** Shorthand to define an event schema */
1278
- export declare function event<TData extends z.ZodType>(data: TData): CapabilityEventSchema<TData>;
1307
+ export declare function event<TData extends z.ZodType>(data: TData, vocabulary?: EventVocabularyDecl): CapabilityEventSchema<TData>;
1279
1308
  /** Type guard: does this cap declare the D14 device-config archetype? */
1280
1309
  export declare function isDeviceConfigCap(def: CapabilityDefinition | undefined): def is CapabilityDefinition & {
1281
1310
  deviceConfig: DeviceConfigSpec;
@@ -48,5 +48,17 @@ export declare const carbonMonoxideCapability: {
48
48
  /** Clock fields: written, but excluded from the compare that decides
49
49
  * whether persisting is worth a SQLite commit. */
50
50
  readonly volatileStateFields: readonly ["lastChangedAt"];
51
+ readonly vocabulary: {
52
+ readonly noun: import("../index.js").VocabL10n;
53
+ readonly order: 5030;
54
+ readonly state: readonly [{
55
+ readonly kind: 'boolean';
56
+ readonly field: 'detected';
57
+ readonly label: import("../index.js").VocabL10n;
58
+ readonly whenTrue: import("../index.js").VocabL10n;
59
+ readonly whenFalse: import("../index.js").VocabL10n;
60
+ readonly icon: 'cloud-alert';
61
+ }];
62
+ };
51
63
  };
52
64
  export type ICarbonMonoxideProvider = InferProvider<typeof carbonMonoxideCapability>;
@@ -113,18 +113,6 @@ export declare const climateControlCapability: {
113
113
  off: "off";
114
114
  }>;
115
115
  }, z.core.$strip>, z.ZodVoid, "mutation">;
116
- readonly setFanMode: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
117
- deviceId: z.ZodNumber;
118
- fanMode: z.ZodString;
119
- }, z.core.$strip>, z.ZodVoid, "mutation"> & {
120
- readonly providerOptional: true;
121
- };
122
- readonly setPreset: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
123
- deviceId: z.ZodNumber;
124
- preset: z.ZodString;
125
- }, z.core.$strip>, z.ZodVoid, "mutation"> & {
126
- readonly providerOptional: true;
127
- };
128
116
  readonly setTarget: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
129
117
  deviceId: z.ZodNumber;
130
118
  target: z.ZodNumber;
@@ -142,6 +130,18 @@ export declare const climateControlCapability: {
142
130
  }, z.core.$strip>, z.ZodVoid, "mutation"> & {
143
131
  readonly providerOptional: true;
144
132
  };
133
+ readonly setFanMode: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
134
+ deviceId: z.ZodNumber;
135
+ fanMode: z.ZodString;
136
+ }, z.core.$strip>, z.ZodVoid, "mutation"> & {
137
+ readonly providerOptional: true;
138
+ };
139
+ readonly setPreset: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
140
+ deviceId: z.ZodNumber;
141
+ preset: z.ZodString;
142
+ }, z.core.$strip>, z.ZodVoid, "mutation"> & {
143
+ readonly providerOptional: true;
144
+ };
145
145
  readonly setSwingVertical: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
146
146
  deviceId: z.ZodNumber;
147
147
  on: z.ZodBoolean;
@@ -291,5 +291,61 @@ export declare const climateControlCapability: {
291
291
  };
292
292
  };
293
293
  };
294
+ readonly vocabulary: {
295
+ readonly noun: import("../index.js").VocabL10n;
296
+ readonly order: 1070;
297
+ readonly state: readonly [{
298
+ readonly kind: 'enum';
299
+ readonly field: 'mode';
300
+ readonly label: import("../index.js").VocabL10n;
301
+ readonly values: readonly [{
302
+ readonly value: 'off';
303
+ readonly label: import("../index.js").VocabL10n;
304
+ readonly phrase: import("../index.js").VocabL10n;
305
+ }, {
306
+ readonly value: 'heat';
307
+ readonly label: import("../index.js").VocabL10n;
308
+ readonly phrase: import("../index.js").VocabL10n;
309
+ }, {
310
+ readonly value: 'cool';
311
+ readonly label: import("../index.js").VocabL10n;
312
+ readonly phrase: import("../index.js").VocabL10n;
313
+ }, {
314
+ readonly value: 'auto';
315
+ readonly label: import("../index.js").VocabL10n;
316
+ }, {
317
+ readonly value: 'heat_cool';
318
+ readonly label: import("../index.js").VocabL10n;
319
+ }, {
320
+ readonly value: 'fan_only';
321
+ readonly label: import("../index.js").VocabL10n;
322
+ }, {
323
+ readonly value: 'dry';
324
+ readonly label: import("../index.js").VocabL10n;
325
+ }];
326
+ readonly icon: 'thermometer';
327
+ }, {
328
+ readonly kind: 'numeric';
329
+ readonly field: 'currentTemp';
330
+ readonly quantity: import("../index.js").VocabL10n;
331
+ readonly label: import("../index.js").VocabL10n;
332
+ readonly unit: '°C';
333
+ readonly icon: 'thermometer';
334
+ }, {
335
+ readonly kind: 'numeric';
336
+ readonly field: 'currentHumidity';
337
+ readonly quantity: import("../index.js").VocabL10n;
338
+ readonly label: import("../index.js").VocabL10n;
339
+ readonly unit: '%';
340
+ readonly icon: 'droplets';
341
+ }, {
342
+ readonly kind: 'numeric';
343
+ readonly field: 'target';
344
+ readonly quantity: import("../index.js").VocabL10n;
345
+ readonly label: import("../index.js").VocabL10n;
346
+ readonly unit: '°C';
347
+ readonly icon: 'thermometer';
348
+ }];
349
+ };
294
350
  };
295
351
  export type IClimateControlProvider = InferProvider<typeof climateControlCapability>;
@@ -361,6 +361,9 @@ export declare const clusterUpdateCapability: {
361
361
  readonly mount: {
362
362
  readonly kind: 'server-provided';
363
363
  };
364
+ readonly vocabulary: {
365
+ readonly notOperatorFacing: "cluster administration — nodes, server package, metrics";
366
+ };
364
367
  };
365
368
  export type IClusterUpdateProvider = InferProvider<typeof clusterUpdateCapability>;
366
369
  export type ClusterUpdateStepKind = z.infer<typeof ClusterUpdateStepKindSchema>;
@@ -133,6 +133,7 @@ export declare const colorCapability: {
133
133
  colorTemperature: z.ZodOptional<z.ZodNumber>;
134
134
  lastChangedAt: z.ZodNumber;
135
135
  }, z.core.$strip>;
136
+ readonly notOperatorFacing: 'a colour change is read through the `mode` state trigger';
136
137
  };
137
138
  };
138
139
  readonly status: {
@@ -192,6 +193,26 @@ export declare const colorCapability: {
192
193
  * History (D850): none — nested and cosmetic.
193
194
  */
194
195
  readonly history: 'none';
196
+ readonly vocabulary: {
197
+ readonly noun: import("../index.js").VocabL10n;
198
+ readonly order: 1020;
199
+ readonly state: readonly [{
200
+ readonly kind: 'enum';
201
+ readonly field: 'mode';
202
+ readonly label: import("../index.js").VocabL10n;
203
+ readonly values: readonly [{
204
+ readonly value: 'rgb';
205
+ readonly label: import("../index.js").VocabL10n;
206
+ }, {
207
+ readonly value: 'hsv';
208
+ readonly label: import("../index.js").VocabL10n;
209
+ }, {
210
+ readonly value: 'mired';
211
+ readonly label: import("../index.js").VocabL10n;
212
+ }];
213
+ readonly icon: 'palette';
214
+ }];
215
+ };
195
216
  };
196
217
  export type IColorProvider = InferProvider<typeof colorCapability>;
197
218
  export {};
@@ -813,5 +813,8 @@ export declare const composerCapability: {
813
813
  }, z.core.$strip>>;
814
814
  }, z.core.$strip>, import("./capability-definition.js").CapabilityMethodKind>;
815
815
  };
816
+ readonly vocabulary: {
817
+ readonly notOperatorFacing: 'device composition — an authoring tool, not an action';
818
+ };
816
819
  };
817
820
  export type IComposerProvider = InferProvider<typeof composerCapability>;
@@ -54,5 +54,17 @@ export declare const connectivityCapability: {
54
54
  /** Clock fields: written, but excluded from the compare that decides
55
55
  * whether persisting is worth a SQLite commit. */
56
56
  readonly volatileStateFields: readonly ["lastChangedAt"];
57
+ readonly vocabulary: {
58
+ readonly noun: import("../index.js").VocabL10n;
59
+ readonly order: 5040;
60
+ readonly state: readonly [{
61
+ readonly kind: 'boolean';
62
+ readonly field: 'connected';
63
+ readonly label: import("../index.js").VocabL10n;
64
+ readonly whenTrue: import("../index.js").VocabL10n;
65
+ readonly whenFalse: import("../index.js").VocabL10n;
66
+ readonly icon: 'wifi';
67
+ }];
68
+ };
57
69
  };
58
70
  export type IConnectivityProvider = InferProvider<typeof connectivityCapability>;