@camstack/types 1.2.560 → 1.2.561

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 (237) hide show
  1. package/CHANGELOG.md +10 -0
  2. package/dist/addon.js +1 -1
  3. package/dist/addon.mjs +1 -1
  4. package/dist/automation/recipe.d.ts +120 -120
  5. package/dist/capabilities/accessories.cap.d.ts +6 -0
  6. package/dist/capabilities/action-source.cap.d.ts +3 -0
  7. package/dist/capabilities/actions.cap.d.ts +3 -0
  8. package/dist/capabilities/addon-pages-source.cap.d.ts +3 -0
  9. package/dist/capabilities/addon-pages.cap.d.ts +3 -0
  10. package/dist/capabilities/addon-routes.cap.d.ts +3 -0
  11. package/dist/capabilities/addon-settings.cap.d.ts +3 -0
  12. package/dist/capabilities/addon-widgets-source.cap.d.ts +3 -0
  13. package/dist/capabilities/addon-widgets.cap.d.ts +3 -0
  14. package/dist/capabilities/addons.cap.d.ts +3 -0
  15. package/dist/capabilities/admin-ui.cap.d.ts +3 -0
  16. package/dist/capabilities/air-quality-sensor.cap.d.ts +39 -0
  17. package/dist/capabilities/alarm-panel.cap.d.ts +60 -14
  18. package/dist/capabilities/alerts.cap.d.ts +3 -0
  19. package/dist/capabilities/ambient-light-sensor.cap.d.ts +12 -0
  20. package/dist/capabilities/audio-analysis.cap.d.ts +4 -0
  21. package/dist/capabilities/audio-analyzer.cap.d.ts +3 -0
  22. package/dist/capabilities/audio-codec.cap.d.ts +3 -0
  23. package/dist/capabilities/audio-metrics.cap.d.ts +4 -0
  24. package/dist/capabilities/auth-provider.cap.d.ts +3 -0
  25. package/dist/capabilities/automation-control.cap.d.ts +19 -0
  26. package/dist/capabilities/backup.cap.d.ts +3 -0
  27. package/dist/capabilities/battery.cap.d.ts +53 -0
  28. package/dist/capabilities/binary.cap.d.ts +136 -0
  29. package/dist/capabilities/board-key-source.cap.d.ts +3 -0
  30. package/dist/capabilities/brightness.cap.d.ts +13 -0
  31. package/dist/capabilities/broker.cap.d.ts +3 -0
  32. package/dist/capabilities/button.cap.d.ts +4 -0
  33. package/dist/capabilities/calendar-source.cap.d.ts +3 -0
  34. package/dist/capabilities/calendars.cap.d.ts +3 -0
  35. package/dist/capabilities/camera-credentials.cap.d.ts +4 -0
  36. package/dist/capabilities/camera-grid-layout.cap.d.ts +4 -0
  37. package/dist/capabilities/camera-pipeline-config.cap.d.ts +4 -0
  38. package/dist/capabilities/camera-streams.cap.d.ts +4 -0
  39. package/dist/capabilities/capability-definition.d.ts +37 -8
  40. package/dist/capabilities/carbon-monoxide.cap.d.ts +12 -0
  41. package/dist/capabilities/climate-control.cap.d.ts +68 -12
  42. package/dist/capabilities/cluster-update.cap.d.ts +3 -0
  43. package/dist/capabilities/color.cap.d.ts +21 -0
  44. package/dist/capabilities/composer.cap.d.ts +3 -0
  45. package/dist/capabilities/connectivity.cap.d.ts +12 -0
  46. package/dist/capabilities/consumables.cap.d.ts +4 -0
  47. package/dist/capabilities/contact.cap.d.ts +12 -0
  48. package/dist/capabilities/control.cap.d.ts +15 -0
  49. package/dist/capabilities/core-blocks.cap.d.ts +3 -0
  50. package/dist/capabilities/cover.cap.d.ts +110 -0
  51. package/dist/capabilities/custom-model-registry.cap.d.ts +3 -0
  52. package/dist/capabilities/data-store-provider.cap.d.ts +3 -0
  53. package/dist/capabilities/database-snapshot.cap.d.ts +3 -0
  54. package/dist/capabilities/day-night.cap.d.ts +25 -0
  55. package/dist/capabilities/decoder.cap.d.ts +3 -0
  56. package/dist/capabilities/detection-pipeline.cap.d.ts +4 -0
  57. package/dist/capabilities/device-admin-link.cap.d.ts +4 -0
  58. package/dist/capabilities/device-adoption.cap.d.ts +3 -0
  59. package/dist/capabilities/device-credentials.cap.d.ts +3 -0
  60. package/dist/capabilities/device-export.cap.d.ts +3 -0
  61. package/dist/capabilities/device-extension.cap.d.ts +4 -0
  62. package/dist/capabilities/device-history.cap.d.ts +3 -0
  63. package/dist/capabilities/device-manager.cap.d.ts +3 -0
  64. package/dist/capabilities/device-ops.cap.d.ts +4 -0
  65. package/dist/capabilities/device-provider.cap.d.ts +3 -0
  66. package/dist/capabilities/device-removal-hook.cap.d.ts +3 -0
  67. package/dist/capabilities/device-runs.cap.d.ts +6 -0
  68. package/dist/capabilities/device-state.cap.d.ts +3 -0
  69. package/dist/capabilities/device-status.cap.d.ts +25 -0
  70. package/dist/capabilities/device-transitions.cap.d.ts +4 -0
  71. package/dist/capabilities/dishwasher.cap.d.ts +60 -0
  72. package/dist/capabilities/display-palette.cap.d.ts +3 -0
  73. package/dist/capabilities/do-not-disturb.cap.d.ts +12 -0
  74. package/dist/capabilities/doorbell.cap.d.ts +11 -0
  75. package/dist/capabilities/embedding-encoder.cap.d.ts +3 -0
  76. package/dist/capabilities/enum-sensor.cap.d.ts +10 -0
  77. package/dist/capabilities/event-emitter.cap.d.ts +11 -0
  78. package/dist/capabilities/face-gallery.cap.d.ts +3 -0
  79. package/dist/capabilities/failure-contribution.cap.d.ts +3 -0
  80. package/dist/capabilities/fan-control.cap.d.ts +19 -0
  81. package/dist/capabilities/fan-presets.cap.d.ts +3 -0
  82. package/dist/capabilities/feature-probe.cap.d.ts +5 -0
  83. package/dist/capabilities/filesystem-browse.cap.d.ts +3 -0
  84. package/dist/capabilities/flood.cap.d.ts +12 -0
  85. package/dist/capabilities/gas.cap.d.ts +12 -0
  86. package/dist/capabilities/group-active.cap.d.ts +4 -0
  87. package/dist/capabilities/group-commands.cap.d.ts +4 -0
  88. package/dist/capabilities/group-status.cap.d.ts +23 -0
  89. package/dist/capabilities/heat-pump-control.cap.d.ts +4 -0
  90. package/dist/capabilities/heat-pump-status.cap.d.ts +4 -0
  91. package/dist/capabilities/heating-valve.cap.d.ts +12 -0
  92. package/dist/capabilities/hero-layout.cap.d.ts +3 -0
  93. package/dist/capabilities/humidifier.cap.d.ts +19 -0
  94. package/dist/capabilities/humidity-sensor.cap.d.ts +12 -0
  95. package/dist/capabilities/image-settings.cap.d.ts +4 -0
  96. package/dist/capabilities/image.cap.d.ts +4 -0
  97. package/dist/capabilities/index.d.ts +1 -1
  98. package/dist/capabilities/integration-instances.cap.d.ts +3 -0
  99. package/dist/capabilities/integrations.cap.d.ts +3 -0
  100. package/dist/capabilities/intercom.cap.d.ts +13 -0
  101. package/dist/capabilities/ir-transmitter.cap.d.ts +101 -0
  102. package/dist/capabilities/keychain-admin.cap.d.ts +3 -0
  103. package/dist/capabilities/keychain.cap.d.ts +3 -0
  104. package/dist/capabilities/lawn-mower-control.cap.d.ts +36 -0
  105. package/dist/capabilities/llm-runtime.cap.d.ts +3 -0
  106. package/dist/capabilities/llm.cap.d.ts +3 -0
  107. package/dist/capabilities/load-contribution.cap.d.ts +3 -0
  108. package/dist/capabilities/local-network.cap.d.ts +3 -0
  109. package/dist/capabilities/lock-control.cap.d.ts +35 -0
  110. package/dist/capabilities/log-channels.cap.d.ts +3 -0
  111. package/dist/capabilities/log-destination.cap.d.ts +3 -0
  112. package/dist/capabilities/login-method.cap.d.ts +3 -0
  113. package/dist/capabilities/media-player.cap.d.ts +66 -6
  114. package/dist/capabilities/mesh-network.cap.d.ts +3 -0
  115. package/dist/capabilities/meter.cap.d.ts +11 -0
  116. package/dist/capabilities/metrics-provider.cap.d.ts +3 -0
  117. package/dist/capabilities/migrations.cap.d.ts +3 -0
  118. package/dist/capabilities/model-convert.cap.d.ts +3 -0
  119. package/dist/capabilities/model-distributor.cap.d.ts +3 -0
  120. package/dist/capabilities/motion-detection.cap.d.ts +5 -0
  121. package/dist/capabilities/motion-trigger.cap.d.ts +13 -0
  122. package/dist/capabilities/motion-zones.cap.d.ts +4 -0
  123. package/dist/capabilities/motion.cap.d.ts +13 -0
  124. package/dist/capabilities/mqtt-broker.cap.d.ts +3 -0
  125. package/dist/capabilities/native-object-detection.cap.d.ts +19 -0
  126. package/dist/capabilities/navigation.cap.d.ts +36 -0
  127. package/dist/capabilities/network-access.cap.d.ts +3 -0
  128. package/dist/capabilities/network-link.cap.d.ts +31 -0
  129. package/dist/capabilities/network-quality.cap.d.ts +3 -0
  130. package/dist/capabilities/node-certificates.cap.d.ts +3 -0
  131. package/dist/capabilities/node-removal-hook.cap.d.ts +3 -0
  132. package/dist/capabilities/nodes.cap.d.ts +3 -0
  133. package/dist/capabilities/notification-output.cap.d.ts +3 -0
  134. package/dist/capabilities/notification-rules.cap.d.ts +3 -0
  135. package/dist/capabilities/notifier.cap.d.ts +5 -0
  136. package/dist/capabilities/numeric-sensor.cap.d.ts +11 -0
  137. package/dist/capabilities/oauth-integration.cap.d.ts +3 -0
  138. package/dist/capabilities/osd-manager.cap.d.ts +3 -0
  139. package/dist/capabilities/osd.cap.d.ts +5 -0
  140. package/dist/capabilities/pet-feeder.cap.d.ts +35 -9
  141. package/dist/capabilities/pet-fountain.cap.d.ts +19 -0
  142. package/dist/capabilities/pipeline-analytics.cap.d.ts +35 -0
  143. package/dist/capabilities/pipeline-executor.cap.d.ts +3 -0
  144. package/dist/capabilities/pipeline-orchestrator.cap.d.ts +3 -0
  145. package/dist/capabilities/pipeline-runner.cap.d.ts +3 -0
  146. package/dist/capabilities/plate-gallery.cap.d.ts +3 -0
  147. package/dist/capabilities/platform-probe.cap.d.ts +3 -0
  148. package/dist/capabilities/power-meter.cap.d.ts +33 -0
  149. package/dist/capabilities/power-source.cap.d.ts +12 -0
  150. package/dist/capabilities/presence.cap.d.ts +11 -0
  151. package/dist/capabilities/pressure-sensor.cap.d.ts +12 -0
  152. package/dist/capabilities/privacy-mask.cap.d.ts +19 -0
  153. package/dist/capabilities/ptz-autotrack.cap.d.ts +13 -0
  154. package/dist/capabilities/ptz.cap.d.ts +11 -7
  155. package/dist/capabilities/pump-cycle.cap.d.ts +12 -0
  156. package/dist/capabilities/reboot.cap.d.ts +4 -0
  157. package/dist/capabilities/record-entries.cap.d.ts +3 -0
  158. package/dist/capabilities/recording-archive.cap.d.ts +3 -0
  159. package/dist/capabilities/recording-export.cap.d.ts +3 -0
  160. package/dist/capabilities/recording-onboard.cap.d.ts +12 -0
  161. package/dist/capabilities/recording-signal.cap.d.ts +12 -0
  162. package/dist/capabilities/recording.cap.d.ts +4 -0
  163. package/dist/capabilities/records.cap.d.ts +3 -0
  164. package/dist/capabilities/remote-layout-components.cap.d.ts +3 -0
  165. package/dist/capabilities/remote.cap.d.ts +3 -0
  166. package/dist/capabilities/running-state.cap.d.ts +77 -0
  167. package/dist/capabilities/scene-monitor.cap.d.ts +11 -0
  168. package/dist/capabilities/schedulers.cap.d.ts +3 -0
  169. package/dist/capabilities/script-runner.cap.d.ts +12 -0
  170. package/dist/capabilities/server-management.cap.d.ts +3 -0
  171. package/dist/capabilities/settings-store.cap.d.ts +3 -0
  172. package/dist/capabilities/smoke.cap.d.ts +12 -0
  173. package/dist/capabilities/smtp-provider.cap.d.ts +3 -0
  174. package/dist/capabilities/snapshot.cap.d.ts +4 -0
  175. package/dist/capabilities/sso-bridge.cap.d.ts +3 -0
  176. package/dist/capabilities/storage-admin.cap.d.ts +3 -0
  177. package/dist/capabilities/storage-evictable.cap.d.ts +3 -0
  178. package/dist/capabilities/storage-migration.cap.d.ts +3 -0
  179. package/dist/capabilities/storage-occupancy.cap.d.ts +3 -0
  180. package/dist/capabilities/storage-provider.cap.d.ts +3 -0
  181. package/dist/capabilities/storage.cap.d.ts +3 -0
  182. package/dist/capabilities/stream-broker.cap.d.ts +3 -0
  183. package/dist/capabilities/stream-catalog.cap.d.ts +4 -0
  184. package/dist/capabilities/stream-params.cap.d.ts +4 -0
  185. package/dist/capabilities/stream-signals.cap.d.ts +4 -0
  186. package/dist/capabilities/switch.cap.d.ts +208 -0
  187. package/dist/capabilities/system.cap.d.ts +3 -0
  188. package/dist/capabilities/tamper.cap.d.ts +12 -0
  189. package/dist/capabilities/temperature-sensor.cap.d.ts +12 -0
  190. package/dist/capabilities/template.cap.d.ts +3 -0
  191. package/dist/capabilities/terminal-session.cap.d.ts +3 -0
  192. package/dist/capabilities/timed-run.cap.d.ts +4 -0
  193. package/dist/capabilities/toast.cap.d.ts +3 -0
  194. package/dist/capabilities/training-provider.cap.d.ts +3 -0
  195. package/dist/capabilities/training.cap.d.ts +3 -0
  196. package/dist/capabilities/turn-provider.cap.d.ts +3 -0
  197. package/dist/capabilities/update.cap.d.ts +19 -0
  198. package/dist/capabilities/user-management.cap.d.ts +3 -0
  199. package/dist/capabilities/user-passkeys.cap.d.ts +3 -0
  200. package/dist/capabilities/vacuum-control.cap.d.ts +43 -0
  201. package/dist/capabilities/valve.cap.d.ts +38 -0
  202. package/dist/capabilities/vector-store.cap.d.ts +3 -0
  203. package/dist/capabilities/vibration.cap.d.ts +12 -0
  204. package/dist/capabilities/videoclips.cap.d.ts +4 -0
  205. package/dist/capabilities/viewer-ui.cap.d.ts +3 -0
  206. package/dist/capabilities/water-heater.cap.d.ts +33 -4
  207. package/dist/capabilities/weather.cap.d.ts +39 -0
  208. package/dist/capabilities/webrtc-session.cap.d.ts +4 -0
  209. package/dist/capabilities/zone-analytics.cap.d.ts +11 -0
  210. package/dist/capabilities/zone-rules.cap.d.ts +4 -0
  211. package/dist/capabilities/zones.cap.d.ts +4 -0
  212. package/dist/client.js +178 -29
  213. package/dist/client.mjs +178 -29
  214. package/dist/device/cap-vocabulary/declaration.d.ts +107 -0
  215. package/dist/device/cap-vocabulary/index.d.ts +4 -2
  216. package/dist/device/cap-vocabulary/system-reasons.d.ts +17 -0
  217. package/dist/device/cap-vocabulary/types.d.ts +24 -6
  218. package/dist/device/cap-vocabulary/vocabulary.d.ts +15 -3
  219. package/dist/generated/addon-api.d.ts +52 -52
  220. package/dist/generated/addon-cap-facts.d.ts +1 -1
  221. package/dist/generated/cap-vocabulary.d.ts +7 -0
  222. package/dist/generated/device-local-state.d.ts +3 -0
  223. package/dist/generated/device-proxy.d.ts +1 -0
  224. package/dist/generated/history-catalog.d.ts +1 -1
  225. package/dist/generated/runtime-state-durability.d.ts +1 -1
  226. package/dist/index.d.ts +2 -2
  227. package/dist/index.js +5238 -598
  228. package/dist/index.mjs +5232 -599
  229. package/dist/{sleep-BvVGLl30.mjs → sleep-C9PbO6Nb.mjs} +5669 -1691
  230. package/dist/{sleep-CyWfD1LJ.js → sleep-CcUFeK6k.js} +5674 -1690
  231. package/package.json +1 -1
  232. package/dist/device/cap-vocabulary/entries/actuators.d.ts +0 -5
  233. package/dist/device/cap-vocabulary/entries/appliances.d.ts +0 -5
  234. package/dist/device/cap-vocabulary/entries/camera.d.ts +0 -5
  235. package/dist/device/cap-vocabulary/entries/heat-pump.d.ts +0 -4
  236. package/dist/device/cap-vocabulary/entries/sensors.d.ts +0 -5
  237. package/dist/device/cap-vocabulary/entries/system.d.ts +0 -8
@@ -375,6 +375,9 @@ export declare const integrationInstancesCapability: {
375
375
  readonly caller: 'scoped';
376
376
  };
377
377
  };
378
+ readonly vocabulary: {
379
+ readonly notOperatorFacing: "internal plumbing between addons — never operator-facing";
380
+ };
378
381
  };
379
382
  export type IntegrationInstanceStatus = z.infer<typeof IntegrationInstanceStatusSchema>;
380
383
  export type IIntegrationInstancesProvider = InferProvider<typeof integrationInstancesCapability>;
@@ -219,6 +219,9 @@ export declare const integrationsCapability: {
219
219
  readonly mount: {
220
220
  readonly kind: 'server-provided';
221
221
  };
222
+ readonly vocabulary: {
223
+ readonly notOperatorFacing: "addon administration — installed and configured from the Addons page";
224
+ };
222
225
  };
223
226
  export type IIntegrationsProvider = InferProvider<typeof integrationsCapability>;
224
227
  export type IntegrationTestConnectionStatus = z.infer<typeof TestConnectionStatusEnum>;
@@ -186,6 +186,7 @@ export declare const intercomCapability: {
186
186
  }, z.core.$strip>>;
187
187
  }, z.core.$strip>;
188
188
  }, z.core.$strip>;
189
+ readonly notOperatorFacing: 'the `talking` state trigger phrases both edges of this change';
189
190
  };
190
191
  };
191
192
  readonly status: {
@@ -254,5 +255,17 @@ export declare const intercomCapability: {
254
255
  * History (D850): none — talk sessions are a ledger concern, not a trend.
255
256
  */
256
257
  readonly history: 'none';
258
+ readonly vocabulary: {
259
+ readonly noun: import("../index.js").VocabL10n;
260
+ readonly order: 3150;
261
+ readonly state: readonly [{
262
+ readonly kind: 'boolean';
263
+ readonly field: 'talking';
264
+ readonly label: import("../index.js").VocabL10n;
265
+ readonly whenTrue: import("../index.js").VocabL10n;
266
+ readonly whenFalse: import("../index.js").VocabL10n;
267
+ readonly icon: 'mic';
268
+ }];
269
+ };
257
270
  };
258
271
  export type IIntercomProvider = InferProvider<typeof intercomCapability>;
@@ -50,6 +50,66 @@ export declare const IrLearnResultSchema: z.ZodObject<{
50
50
  carrierHz: z.ZodNullable<z.ZodNumber>;
51
51
  }, z.core.$strip>;
52
52
  export type IrLearnResult = z.infer<typeof IrLearnResultSchema>;
53
+ /** One finished learn: when, whether it landed, and the typed refusal code. */
54
+ export declare const IrTransmitterAttemptSchema: z.ZodObject<{
55
+ at: z.ZodNumber;
56
+ ok: z.ZodBoolean;
57
+ error: z.ZodNullable<z.ZodString>;
58
+ }, z.core.$strip>;
59
+ export type IrTransmitterAttempt = z.infer<typeof IrTransmitterAttemptSchema>;
60
+ /** One finished send. `medium` is the transmitter's declared medium for that call. */
61
+ export declare const IrTransmitterSendRecordSchema: z.ZodObject<{
62
+ at: z.ZodNumber;
63
+ ok: z.ZodBoolean;
64
+ error: z.ZodNullable<z.ZodString>;
65
+ medium: z.ZodEnum<{
66
+ ir: "ir";
67
+ rf: "rf";
68
+ }>;
69
+ }, z.core.$strip>;
70
+ export type IrTransmitterSendRecord = z.infer<typeof IrTransmitterSendRecordSchema>;
71
+ /**
72
+ * Last send and last learn. Null means the slice was read and that action has
73
+ * not happened; an absent slice means the read has not answered.
74
+ */
75
+ export declare const IrTransmitterRuntimeStateSchema: z.ZodObject<{
76
+ lastSend: z.ZodNullable<z.ZodObject<{
77
+ at: z.ZodNumber;
78
+ ok: z.ZodBoolean;
79
+ error: z.ZodNullable<z.ZodString>;
80
+ medium: z.ZodEnum<{
81
+ ir: "ir";
82
+ rf: "rf";
83
+ }>;
84
+ }, z.core.$strip>>;
85
+ lastLearn: z.ZodNullable<z.ZodObject<{
86
+ at: z.ZodNumber;
87
+ ok: z.ZodBoolean;
88
+ error: z.ZodNullable<z.ZodString>;
89
+ }, z.core.$strip>>;
90
+ lastFetchedAt: z.ZodNumber;
91
+ }, z.core.$strip>;
92
+ export type IrTransmitterRuntimeState = z.infer<typeof IrTransmitterRuntimeStateSchema>;
93
+ /** A send or a learn to fold into the slice. */
94
+ export type IrTransmitterStateUpdate = {
95
+ readonly kind: 'send';
96
+ readonly ok: boolean;
97
+ readonly error: string | null;
98
+ readonly medium: IrMedium;
99
+ } | {
100
+ readonly kind: 'learn';
101
+ readonly ok: boolean;
102
+ readonly error: string | null;
103
+ };
104
+ /**
105
+ * A learn the transmitter cannot do is not an attempt. Recording it would show
106
+ * a failed learn for a device that never started one.
107
+ */
108
+ export declare function irTransmitterRecordsUpdate(update: IrTransmitterStateUpdate): boolean;
109
+ /** The next slice after one send or learn. The other record is left as it was. */
110
+ export declare function irTransmitterStateAfter(previous: IrTransmitterRuntimeState | null, update: IrTransmitterStateUpdate, now: number): IrTransmitterRuntimeState;
111
+ /** The typed refusal code on an error, or null when the failure has none. */
112
+ export declare function irTransmitterErrorCode(err: unknown): string | null;
53
113
  /**
54
114
  * ir-transmitter — emit a pulse train (infrared or RF) with settings. One cap
55
115
  * for both media: everything medium-specific is a per-call setting, validated
@@ -125,5 +185,46 @@ export declare const irTransmitterCapability: {
125
185
  }>>>;
126
186
  }, z.core.$strip>, "query">;
127
187
  };
188
+ /**
189
+ * Last send and last learn, for the device card. Written by the provider
190
+ * on every attempt, including a typed refusal. A `learn-unsupported`
191
+ * refusal is not an attempt and is not written.
192
+ */
193
+ readonly runtimeState: z.ZodObject<{
194
+ lastSend: z.ZodNullable<z.ZodObject<{
195
+ at: z.ZodNumber;
196
+ ok: z.ZodBoolean;
197
+ error: z.ZodNullable<z.ZodString>;
198
+ medium: z.ZodEnum<{
199
+ ir: "ir";
200
+ rf: "rf";
201
+ }>;
202
+ }, z.core.$strip>>;
203
+ lastLearn: z.ZodNullable<z.ZodObject<{
204
+ at: z.ZodNumber;
205
+ ok: z.ZodBoolean;
206
+ error: z.ZodNullable<z.ZodString>;
207
+ }, z.core.$strip>>;
208
+ lastFetchedAt: z.ZodNumber;
209
+ }, z.core.$strip>;
210
+ /**
211
+ * Runtime-state durability: **restored** — a last send and a last learn are
212
+ * facts of what already happened. Restoring them is the card's content
213
+ * after a restart; they are not a live reading that would lie.
214
+ *
215
+ * See `RuntimeStateDurability`. Enforced by
216
+ * `scripts/check-runtime-state-durability.ts`.
217
+ */
218
+ readonly durability: 'restored';
219
+ /**
220
+ * History (D850): none — two event records, not a numeric series.
221
+ */
222
+ readonly history: 'none';
223
+ /** Clock field: written, but not on its own worth a SQLite commit. */
224
+ readonly volatileStateFields: readonly ["lastFetchedAt"];
225
+ readonly vocabulary: {
226
+ readonly noun: import("../index.js").VocabL10n;
227
+ readonly order: 1140;
228
+ };
128
229
  };
129
230
  export type IIrTransmitterProvider = InferProvider<typeof irTransmitterCapability>;
@@ -436,5 +436,8 @@ export declare const keychainAdminCapability: {
436
436
  readonly caller: 'required';
437
437
  };
438
438
  };
439
+ readonly vocabulary: {
440
+ readonly notOperatorFacing: "identity and access administration — users, sign-in and secrets";
441
+ };
439
442
  };
440
443
  export type IKeychainAdminProvider = InferProvider<typeof keychainAdminCapability>;
@@ -199,5 +199,8 @@ export declare const keychainCapability: {
199
199
  }>;
200
200
  }, z.core.$strip>], "state">, import("./capability-definition.js").CapabilityMethodKind>;
201
201
  };
202
+ readonly vocabulary: {
203
+ readonly notOperatorFacing: "identity and access administration — users, sign-in and secrets";
204
+ };
202
205
  };
203
206
  export type IKeychainProvider = InferProvider<typeof keychainCapability>;
@@ -128,5 +128,41 @@ export declare const lawnMowerControlCapability: {
128
128
  };
129
129
  };
130
130
  };
131
+ readonly vocabulary: {
132
+ readonly noun: import("../index.js").VocabL10n;
133
+ readonly order: 2010;
134
+ readonly state: readonly [{
135
+ readonly kind: 'enum';
136
+ readonly field: 'activity';
137
+ readonly label: import("../index.js").VocabL10n;
138
+ readonly values: readonly [{
139
+ readonly value: 'idle';
140
+ readonly label: import("../index.js").VocabL10n;
141
+ }, {
142
+ readonly value: 'mowing';
143
+ readonly label: import("../index.js").VocabL10n;
144
+ readonly phrase: import("../index.js").VocabL10n;
145
+ }, {
146
+ readonly value: 'paused';
147
+ readonly label: import("../index.js").VocabL10n;
148
+ }, {
149
+ readonly value: 'docked';
150
+ readonly label: import("../index.js").VocabL10n;
151
+ readonly phrase: import("../index.js").VocabL10n;
152
+ }, {
153
+ readonly value: 'error';
154
+ readonly label: import("../index.js").VocabL10n;
155
+ readonly phrase: import("../index.js").VocabL10n;
156
+ }];
157
+ readonly icon: 'bot';
158
+ }, {
159
+ readonly kind: 'numeric';
160
+ readonly field: 'batteryLevel';
161
+ readonly quantity: import("../index.js").VocabL10n;
162
+ readonly label: import("../index.js").VocabL10n;
163
+ readonly unit: '%';
164
+ readonly icon: 'battery';
165
+ }];
166
+ };
131
167
  };
132
168
  export type ILawnMowerControlProvider = InferProvider<typeof lawnMowerControlCapability>;
@@ -713,5 +713,8 @@ export declare const llmRuntimeCapability: {
713
713
  }>>;
714
714
  }, z.core.$strip>], "ok">, "mutation">;
715
715
  };
716
+ readonly vocabulary: {
717
+ readonly notOperatorFacing: "model and training machinery — no device action";
718
+ };
716
719
  };
717
720
  export type ILlmRuntimeProvider = InferProvider<typeof llmRuntimeCapability>;
@@ -830,5 +830,8 @@ export declare const llmCapability: {
830
830
  profileId: z.ZodString;
831
831
  }, z.core.$strip>, z.ZodVoid, "mutation">;
832
832
  };
833
+ readonly vocabulary: {
834
+ readonly notOperatorFacing: "model and training machinery — no device action";
835
+ };
833
836
  };
834
837
  export type ILlmProvider = InferProvider<typeof llmCapability>;
@@ -141,6 +141,9 @@ export declare const loadContributionCapability: {
141
141
  readonly mount: {
142
142
  readonly kind: 'skip';
143
143
  };
144
+ readonly vocabulary: {
145
+ readonly notOperatorFacing: "internal plumbing between addons — never operator-facing";
146
+ };
144
147
  };
145
148
  export type ILoadContributionProvider = InferProvider<typeof loadContributionCapability>;
146
149
  export { LoadContributionSchema };
@@ -1269,6 +1269,9 @@ export declare const localNetworkCapability: {
1269
1269
  readonly mount: {
1270
1270
  readonly kind: 'hub-only';
1271
1271
  };
1272
+ readonly vocabulary: {
1273
+ readonly notOperatorFacing: "network administration of the cluster — addresses, mesh, tunnels";
1274
+ };
1272
1275
  };
1273
1276
  export type ScanNetworkResult = z.infer<typeof ScanNetworkResultSchema>;
1274
1277
  export type ScanRequest = z.infer<typeof ScanRequestSchema>;
@@ -155,5 +155,40 @@ export declare const lockControlCapability: {
155
155
  /** Clock fields: written, but excluded from the compare that decides
156
156
  * whether persisting is worth a SQLite commit. */
157
157
  readonly volatileStateFields: readonly ["lastChangedAt"];
158
+ readonly vocabulary: {
159
+ readonly noun: import("../index.js").VocabL10n;
160
+ readonly order: 1060;
161
+ readonly state: readonly [{
162
+ readonly kind: 'enum';
163
+ readonly field: 'state';
164
+ readonly label: import("../index.js").VocabL10n;
165
+ readonly values: readonly [{
166
+ readonly value: 'locked';
167
+ readonly label: import("../index.js").VocabL10n;
168
+ readonly phrase: import("../index.js").VocabL10n;
169
+ }, {
170
+ readonly value: 'unlocked';
171
+ readonly label: import("../index.js").VocabL10n;
172
+ readonly phrase: import("../index.js").VocabL10n;
173
+ }, {
174
+ readonly value: 'locking';
175
+ readonly label: import("../index.js").VocabL10n;
176
+ readonly phrase: import("../index.js").VocabL10n;
177
+ }, {
178
+ readonly value: 'unlocking';
179
+ readonly label: import("../index.js").VocabL10n;
180
+ readonly phrase: import("../index.js").VocabL10n;
181
+ }, {
182
+ readonly value: 'jammed';
183
+ readonly label: import("../index.js").VocabL10n;
184
+ readonly phrase: import("../index.js").VocabL10n;
185
+ }, {
186
+ readonly value: 'door-open';
187
+ readonly label: import("../index.js").VocabL10n;
188
+ readonly phrase: import("../index.js").VocabL10n;
189
+ }];
190
+ readonly icon: 'lock';
191
+ }];
192
+ };
158
193
  };
159
194
  export type ILockControlProvider = InferProvider<typeof lockControlCapability>;
@@ -91,6 +91,9 @@ export declare const logChannelsCapability: {
91
91
  readonly mount: {
92
92
  readonly kind: 'skip';
93
93
  };
94
+ readonly vocabulary: {
95
+ readonly notOperatorFacing: "internal plumbing between addons — never operator-facing";
96
+ };
94
97
  };
95
98
  export type ILogChannelsProvider = InferProvider<typeof logChannelsCapability>;
96
99
  export type LogChannelApplyResult = z.infer<typeof LogChannelApplyResultSchema>;
@@ -197,6 +197,9 @@ export declare const logDestinationCapability: {
197
197
  readonly mount: {
198
198
  readonly kind: 'skip';
199
199
  };
200
+ readonly vocabulary: {
201
+ readonly notOperatorFacing: "internal plumbing between addons — never operator-facing";
202
+ };
200
203
  };
201
204
  export type ILogDestinationProvider = InferProvider<typeof logDestinationCapability>;
202
205
  export type LogReadQuery = z.infer<typeof LogReadQuerySchema>;
@@ -238,6 +238,9 @@ export declare const loginMethodCapability: {
238
238
  readonly mount: {
239
239
  readonly kind: 'skip';
240
240
  };
241
+ readonly vocabulary: {
242
+ readonly notOperatorFacing: "identity and access administration — users, sign-in and secrets";
243
+ };
241
244
  };
242
245
  export type ILoginMethodProvider = InferProvider<typeof loginMethodCapability>;
243
246
  /** A single login-method contribution (redirect | widget | passkey). */
@@ -180,12 +180,6 @@ export declare const mediaPlayerCapability: {
180
180
  }, z.core.$strip>, z.ZodVoid, "mutation"> & {
181
181
  readonly providerOptional: true;
182
182
  };
183
- readonly seek: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
184
- deviceId: z.ZodNumber;
185
- position: z.ZodNumber;
186
- }, z.core.$strip>, z.ZodVoid, "mutation"> & {
187
- readonly providerOptional: true;
188
- };
189
183
  readonly setVolume: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
190
184
  deviceId: z.ZodNumber;
191
185
  volumeLevel: z.ZodNumber;
@@ -220,6 +214,12 @@ export declare const mediaPlayerCapability: {
220
214
  }, z.core.$strip>, z.ZodVoid, "mutation"> & {
221
215
  readonly providerOptional: true;
222
216
  };
217
+ readonly seek: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
218
+ deviceId: z.ZodNumber;
219
+ position: z.ZodNumber;
220
+ }, z.core.$strip>, z.ZodVoid, "mutation"> & {
221
+ readonly providerOptional: true;
222
+ };
223
223
  readonly playMedia: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
224
224
  deviceId: z.ZodNumber;
225
225
  mediaId: z.ZodString;
@@ -362,6 +362,66 @@ export declare const mediaPlayerCapability: {
362
362
  };
363
363
  };
364
364
  };
365
+ readonly vocabulary: {
366
+ readonly noun: import("../index.js").VocabL10n;
367
+ readonly order: 2060;
368
+ readonly state: readonly [{
369
+ readonly kind: 'enum';
370
+ readonly field: 'state';
371
+ readonly label: import("../index.js").VocabL10n;
372
+ readonly values: readonly [{
373
+ readonly value: 'off';
374
+ readonly label: import("../index.js").VocabL10n;
375
+ readonly phrase: import("../index.js").VocabL10n;
376
+ }, {
377
+ readonly value: 'on';
378
+ readonly label: import("../index.js").VocabL10n;
379
+ readonly phrase: import("../index.js").VocabL10n;
380
+ }, {
381
+ readonly value: 'idle';
382
+ readonly label: import("../index.js").VocabL10n;
383
+ }, {
384
+ readonly value: 'playing';
385
+ readonly label: import("../index.js").VocabL10n;
386
+ readonly phrase: import("../index.js").VocabL10n;
387
+ }, {
388
+ readonly value: 'paused';
389
+ readonly label: import("../index.js").VocabL10n;
390
+ readonly phrase: import("../index.js").VocabL10n;
391
+ }, {
392
+ readonly value: 'buffering';
393
+ readonly label: import("../index.js").VocabL10n;
394
+ }, {
395
+ readonly value: 'standby';
396
+ readonly label: import("../index.js").VocabL10n;
397
+ }];
398
+ readonly icon: 'music';
399
+ }, {
400
+ readonly kind: 'numeric';
401
+ readonly field: 'volumeLevel';
402
+ readonly quantity: import("../index.js").VocabL10n;
403
+ readonly label: import("../index.js").VocabL10n;
404
+ readonly unit: '%';
405
+ readonly icon: 'volume-2';
406
+ }, {
407
+ readonly kind: 'boolean';
408
+ readonly field: 'isMuted';
409
+ readonly label: import("../index.js").VocabL10n;
410
+ readonly whenTrue: import("../index.js").VocabL10n;
411
+ readonly whenFalse: import("../index.js").VocabL10n;
412
+ readonly icon: 'volume-x';
413
+ }, {
414
+ readonly kind: 'value';
415
+ readonly field: 'source';
416
+ readonly label: import("../index.js").VocabL10n;
417
+ readonly offer: {
418
+ readonly kind: 'dynamic';
419
+ readonly from: 'status';
420
+ readonly field: 'availableSources';
421
+ };
422
+ readonly icon: 'cast';
423
+ }];
424
+ };
365
425
  };
366
426
  export type IMediaPlayerProvider = InferProvider<typeof mediaPlayerCapability>;
367
427
  export {};
@@ -210,6 +210,9 @@ export declare const meshNetworkCapability: {
210
210
  }, z.core.$strip>>>;
211
211
  }, z.core.$strip>, import("./capability-definition.js").CapabilityMethodKind>;
212
212
  };
213
+ readonly vocabulary: {
214
+ readonly notOperatorFacing: "network administration of the cluster — addresses, mesh, tunnels";
215
+ };
213
216
  };
214
217
  export type IMeshNetworkProvider = InferProvider<typeof meshNetworkCapability>;
215
218
  export {};
@@ -49,5 +49,16 @@ export declare const meterCapability: {
49
49
  };
50
50
  };
51
51
  readonly volatileStateFields: readonly ["lastFetchedAt"];
52
+ readonly vocabulary: {
53
+ readonly noun: import("../index.js").VocabL10n;
54
+ readonly order: 5140;
55
+ readonly state: readonly [{
56
+ readonly kind: 'numeric';
57
+ readonly field: 'value';
58
+ readonly quantity: import("../index.js").VocabL10n;
59
+ readonly label: import("../index.js").VocabL10n;
60
+ readonly icon: 'gauge';
61
+ }];
62
+ };
52
63
  };
53
64
  export type IMeterProvider = InferProvider<typeof meterCapability>;
@@ -706,6 +706,9 @@ export declare const metricsProviderCapability: {
706
706
  durable: z.ZodBoolean;
707
707
  }, z.core.$strip>, import("./capability-definition.js").CapabilityMethodKind>;
708
708
  };
709
+ readonly vocabulary: {
710
+ readonly notOperatorFacing: "cluster administration — nodes, server package, metrics";
711
+ };
709
712
  };
710
713
  export type IMetricsProvider = InferProvider<typeof metricsProviderCapability>;
711
714
  export { SystemMetricsSchema, SystemResourceSnapshotSchema, DiskSpaceInfoSchema, MetricsGpuInfoSchema, PidResourceStatsSchema, AddonInstanceSchema, NodeProcessSchema, LoadPointSchema, LoadFunctionSeriesSchema, ContainerMemorySnapshotSchema, ContainerMemoryPointSchema, NodeLoadSeriesSchema, GetLoadSeriesInputSchema, CpuBreakdownSchema, MemoryInfoSchema, DiskIoSnapshotSchema, NetworkIoSnapshotSchema, ProcessResourceInfoSchema, PressureInfoSchema, };
@@ -532,5 +532,8 @@ export declare const migrationsCapability: {
532
532
  removed: z.ZodRecord<z.ZodString, z.ZodUnknown>;
533
533
  }, z.core.$strip>, "mutation">;
534
534
  };
535
+ readonly vocabulary: {
536
+ readonly notOperatorFacing: "internal plumbing between addons — never operator-facing";
537
+ };
535
538
  };
536
539
  export type IMigrationsProvider = InferProvider<typeof migrationsCapability>;
@@ -351,5 +351,8 @@ export declare const modelConvertCapability: {
351
351
  }, z.core.$strip>>>;
352
352
  }, z.core.$strip>, "mutation">;
353
353
  };
354
+ readonly vocabulary: {
355
+ readonly notOperatorFacing: "model and training machinery — no device action";
356
+ };
354
357
  };
355
358
  export type IModelConvertProvider = InferProvider<typeof modelConvertCapability>;
@@ -464,6 +464,9 @@ export declare const modelDistributorCapability: {
464
464
  path: z.ZodString;
465
465
  }, z.core.$strip>, "mutation">;
466
466
  };
467
+ readonly vocabulary: {
468
+ readonly notOperatorFacing: "model and training machinery — no device action";
469
+ };
467
470
  };
468
471
  export type IModelDistributorProvider = InferProvider<typeof modelDistributorCapability>;
469
472
  export type ModelDistributeInput = z.infer<typeof ModelDistributeInputSchema>;
@@ -122,8 +122,13 @@ export declare const motionDetectionCapability: {
122
122
  detected: z.ZodBoolean;
123
123
  regionCount: z.ZodNumber;
124
124
  }, z.core.$strip>;
125
+ readonly notOperatorFacing: 'the analyzer’s raw verdict; the operator signal is the `motion` cap’s `detected` state';
125
126
  };
126
127
  };
128
+ readonly vocabulary: {
129
+ readonly noun: import("../index.js").VocabL10n;
130
+ readonly order: 3160;
131
+ };
127
132
  };
128
133
  export type IMotionDetectionProvider = InferProvider<typeof motionDetectionCapability>;
129
134
  export type MotionRegion = z.infer<typeof MotionRegionSchema>;
@@ -60,6 +60,7 @@ export declare const motionTriggerCapability: {
60
60
  enabled: z.ZodBoolean;
61
61
  lastChangedAt: z.ZodNumber;
62
62
  }, z.core.$strip>;
63
+ readonly notOperatorFacing: 'the `enabled` state trigger phrases both edges of this change';
63
64
  };
64
65
  };
65
66
  readonly status: {
@@ -85,5 +86,17 @@ export declare const motionTriggerCapability: {
85
86
  * History (D850): none — configuration switch.
86
87
  */
87
88
  readonly history: 'none';
89
+ readonly vocabulary: {
90
+ readonly noun: import("../index.js").VocabL10n;
91
+ readonly order: 1160;
92
+ readonly state: readonly [{
93
+ readonly kind: 'boolean';
94
+ readonly field: 'enabled';
95
+ readonly label: import("../index.js").VocabL10n;
96
+ readonly whenTrue: import("../index.js").VocabL10n;
97
+ readonly whenFalse: import("../index.js").VocabL10n;
98
+ readonly icon: 'activity';
99
+ }];
100
+ };
88
101
  };
89
102
  export type IMotionTriggerProvider = InferProvider<typeof motionTriggerCapability>;
@@ -174,5 +174,9 @@ export declare const motionZonesCapability: {
174
174
  /** Clock fields: written, but excluded from the compare that decides
175
175
  * whether persisting is worth a SQLite commit. */
176
176
  readonly volatileStateFields: readonly ["lastFetchedAt"];
177
+ readonly vocabulary: {
178
+ readonly noun: import("../index.js").VocabL10n;
179
+ readonly order: 3170;
180
+ };
177
181
  };
178
182
  export type IMotionZonesProvider = InferNativeProvider<typeof motionZonesCapability>;
@@ -149,6 +149,7 @@ export declare const motionCapability: {
149
149
  deviceId: z.ZodNumber;
150
150
  }, z.core.$strip>], "kind">>;
151
151
  }, z.core.$strip>;
152
+ readonly notOperatorFacing: 'the `detected` state trigger phrases both edges, from the mirror that survives a dropped event (D49)';
152
153
  };
153
154
  };
154
155
  readonly status: {
@@ -226,5 +227,17 @@ export declare const motionCapability: {
226
227
  readonly advancedExpression: false;
227
228
  }];
228
229
  };
230
+ readonly vocabulary: {
231
+ readonly noun: import("../index.js").VocabL10n;
232
+ readonly order: 5130;
233
+ readonly state: readonly [{
234
+ readonly kind: 'boolean';
235
+ readonly field: 'detected';
236
+ readonly label: import("../index.js").VocabL10n;
237
+ readonly whenTrue: import("../index.js").VocabL10n;
238
+ readonly whenFalse: import("../index.js").VocabL10n;
239
+ readonly icon: 'activity';
240
+ }];
241
+ };
229
242
  };
230
243
  export type IMotionProvider = InferProvider<typeof motionCapability>;
@@ -138,6 +138,9 @@ export declare const mqttBrokerCapability: {
138
138
  embeddedRunning: z.ZodBoolean;
139
139
  }, z.core.$strip>, import("./capability-definition.js").CapabilityMethodKind>;
140
140
  };
141
+ readonly vocabulary: {
142
+ readonly notOperatorFacing: "network administration of the cluster — addresses, mesh, tunnels";
143
+ };
141
144
  };
142
145
  export type IMqttBrokerProvider = InferProvider<typeof mqttBrokerCapability>;
143
146
  export { AddBrokerInputSchema, BrokerConnectionDetailsSchema, BrokerInfoSchema, StartEmbeddedInputSchema, StatusSchema as MqttBrokerStatusSchema, };
@@ -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
  * On-camera AI object detection cap. Surfaces per-device the classes
6
7
  * the firmware can detect and the last-seen instance of each. The
@@ -195,6 +196,12 @@ export declare const nativeObjectDetectionCapability: {
195
196
  confidence: z.ZodOptional<z.ZodNumber>;
196
197
  }, z.core.$strip>;
197
198
  }, z.core.$strip>;
199
+ readonly trigger: {
200
+ readonly category: EventCategory.DetectionCameraNative;
201
+ readonly label: import("../index.js").VocabL10n;
202
+ readonly phrase: import("../index.js").VocabL10n;
203
+ readonly icon: 'scan-eye';
204
+ };
198
205
  };
199
206
  };
200
207
  readonly status: {
@@ -275,5 +282,17 @@ export declare const nativeObjectDetectionCapability: {
275
282
  /** Clock fields: written, but excluded from the compare that decides
276
283
  * whether persisting is worth a SQLite commit. */
277
284
  readonly volatileStateFields: readonly ["lastFetchedAt"];
285
+ readonly vocabulary: {
286
+ readonly noun: import("../index.js").VocabL10n;
287
+ readonly order: 3180;
288
+ readonly state: readonly [{
289
+ readonly kind: 'boolean';
290
+ readonly field: 'enabled';
291
+ readonly label: import("../index.js").VocabL10n;
292
+ readonly whenTrue: import("../index.js").VocabL10n;
293
+ readonly whenFalse: import("../index.js").VocabL10n;
294
+ readonly icon: 'scan-eye';
295
+ }];
296
+ };
278
297
  };
279
298
  export type INativeObjectDetectionProvider = InferProvider<typeof nativeObjectDetectionCapability>;