@camstack/types 1.2.534 → 1.2.536

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 (61) hide show
  1. package/CHANGELOG.md +18 -3
  2. package/dist/addon.js +2 -2
  3. package/dist/addon.mjs +2 -2
  4. package/dist/automation/action.d.ts +105 -0
  5. package/dist/automation/index.d.ts +1 -0
  6. package/dist/automation/recipe.d.ts +450 -6
  7. package/dist/automation/scheduler.d.ts +208 -0
  8. package/dist/automation/step-condition.d.ts +19 -0
  9. package/dist/automation/step-runner.d.ts +50 -5
  10. package/dist/automation/trace.d.ts +129 -0
  11. package/dist/capabilities/action-source.cap.d.ts +52 -0
  12. package/dist/capabilities/actions.cap.d.ts +406 -0
  13. package/dist/capabilities/core-blocks.cap.d.ts +3782 -120
  14. package/dist/capabilities/device-manager.cap.d.ts +96 -0
  15. package/dist/capabilities/fan-presets.cap.d.ts +312 -0
  16. package/dist/capabilities/heat-pump-control.cap.d.ts +83 -0
  17. package/dist/capabilities/heat-pump-status.cap.d.ts +517 -0
  18. package/dist/capabilities/hero-layout.cap.d.ts +58 -0
  19. package/dist/capabilities/index.d.ts +6 -2
  20. package/dist/capabilities/schedulers.cap.d.ts +458 -0
  21. package/dist/capabilities/timed-run.cap.d.ts +5 -0
  22. package/dist/client.js +26 -0
  23. package/dist/client.mjs +26 -0
  24. package/dist/{composition-BjHGoicU.js → composition-BxalDSTt.js} +1 -1
  25. package/dist/{composition-CXCX78IR.mjs → composition-C6TZGqUb.mjs} +1 -1
  26. package/dist/device/cap-vocabulary/entries/heat-pump.d.ts +4 -0
  27. package/dist/device/device-type.d.ts +5 -1
  28. package/dist/device/hero/build-hero-model.d.ts +2 -0
  29. package/dist/device/hero/climate-view.d.ts +4 -0
  30. package/dist/device/hero/hero-contributions-heat-pump.d.ts +2 -0
  31. package/dist/device/hero/hero-fragment.d.ts +4 -0
  32. package/dist/device/hero/hero-layout.d.ts +1 -0
  33. package/dist/device/hero/hero-look.d.ts +6 -0
  34. package/dist/device/hero/hero-model.d.ts +82 -1
  35. package/dist/device/hero/hero-row.d.ts +38 -2
  36. package/dist/device/hero/hero-scene.d.ts +4 -1
  37. package/dist/device/hero/index.d.ts +1 -1
  38. package/dist/{device-type-BaYa0UGS.js → device-type-BfvqqzRp.js} +4 -0
  39. package/dist/{device-type-CbDhVwFP.mjs → device-type-DTTZKB2I.mjs} +4 -0
  40. package/dist/expression/device-template.d.ts +80 -19
  41. package/dist/generated/addon-api.d.ts +134 -0
  42. package/dist/generated/addon-cap-facts.d.ts +1 -1
  43. package/dist/generated/cap-status-types.d.ts +3 -1
  44. package/dist/generated/capability-router-map.d.ts +8 -2
  45. package/dist/generated/customize-catalog.d.ts +1 -1
  46. package/dist/generated/device-local-state.d.ts +3 -0
  47. package/dist/generated/device-proxy.d.ts +5 -0
  48. package/dist/generated/device-scoped-caps.d.ts +1 -1
  49. package/dist/generated/history-catalog.d.ts +2 -2
  50. package/dist/generated/method-access-map.d.ts +1 -1
  51. package/dist/generated/method-device-selectors.d.ts +1 -1
  52. package/dist/generated/runtime-state-durability.d.ts +1 -1
  53. package/dist/generated/system-proxy.d.ts +1 -1
  54. package/dist/index.d.ts +2 -1
  55. package/dist/index.js +2021 -293
  56. package/dist/index.mjs +1996 -294
  57. package/dist/node.js +2 -2
  58. package/dist/node.mjs +2 -2
  59. package/dist/{sleep-DhZXJtPH.js → sleep-CCAQ_PEp.js} +201 -5
  60. package/dist/{sleep-CkinsFFb.mjs → sleep-DnVqHJc4.mjs} +201 -5
  61. package/package.json +1 -1
@@ -158,6 +158,32 @@ export declare const SchedulerPointSchema: z.ZodObject<{
158
158
  steps: z.ZodDefault<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
159
159
  kind: z.ZodLiteral<"wait">;
160
160
  seconds: z.ZodNumber;
161
+ if: z.ZodOptional<z.ZodType<AutomationWhen, unknown, z.core.$ZodTypeInternals<AutomationWhen, unknown>>>;
162
+ else: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
163
+ kind: z.ZodLiteral<"wait">;
164
+ seconds: z.ZodNumber;
165
+ }, z.core.$strip>, z.ZodObject<{
166
+ kind: z.ZodLiteral<"cap">;
167
+ actionId: z.ZodOptional<z.ZodString>;
168
+ target: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
169
+ kind: z.ZodLiteral<"devices">;
170
+ ids: z.ZodArray<z.ZodNumber>;
171
+ }, z.core.$strip>, z.ZodObject<{
172
+ kind: z.ZodLiteral<"domain">;
173
+ deviceType: z.ZodOptional<z.ZodEnum<typeof import("../index.js").DeviceType>>;
174
+ roomId: z.ZodOptional<z.ZodString>;
175
+ }, z.core.$strip>, z.ZodObject<{
176
+ kind: z.ZodLiteral<"var">;
177
+ name: z.ZodString;
178
+ }, z.core.$strip>], "kind">>;
179
+ deviceId: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodArray<z.ZodNumber>, z.ZodObject<{
180
+ $var: z.ZodString;
181
+ }, z.core.$strip>]>>;
182
+ cap: z.ZodString;
183
+ method: z.ZodString;
184
+ args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
185
+ argUnits: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
186
+ }, z.core.$strip>], "kind">>>;
161
187
  }, z.core.$strip>, z.ZodObject<{
162
188
  kind: z.ZodLiteral<"cap">;
163
189
  actionId: z.ZodOptional<z.ZodString>;
@@ -179,6 +205,32 @@ export declare const SchedulerPointSchema: z.ZodObject<{
179
205
  method: z.ZodString;
180
206
  args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
181
207
  argUnits: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
208
+ if: z.ZodOptional<z.ZodType<AutomationWhen, unknown, z.core.$ZodTypeInternals<AutomationWhen, unknown>>>;
209
+ else: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
210
+ kind: z.ZodLiteral<"wait">;
211
+ seconds: z.ZodNumber;
212
+ }, z.core.$strip>, z.ZodObject<{
213
+ kind: z.ZodLiteral<"cap">;
214
+ actionId: z.ZodOptional<z.ZodString>;
215
+ target: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
216
+ kind: z.ZodLiteral<"devices">;
217
+ ids: z.ZodArray<z.ZodNumber>;
218
+ }, z.core.$strip>, z.ZodObject<{
219
+ kind: z.ZodLiteral<"domain">;
220
+ deviceType: z.ZodOptional<z.ZodEnum<typeof import("../index.js").DeviceType>>;
221
+ roomId: z.ZodOptional<z.ZodString>;
222
+ }, z.core.$strip>, z.ZodObject<{
223
+ kind: z.ZodLiteral<"var">;
224
+ name: z.ZodString;
225
+ }, z.core.$strip>], "kind">>;
226
+ deviceId: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodArray<z.ZodNumber>, z.ZodObject<{
227
+ $var: z.ZodString;
228
+ }, z.core.$strip>]>>;
229
+ cap: z.ZodString;
230
+ method: z.ZodString;
231
+ args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
232
+ argUnits: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
233
+ }, z.core.$strip>], "kind">>>;
182
234
  }, z.core.$strip>], "kind">>>;
183
235
  conditions: z.ZodOptional<z.ZodType<AutomationWhen, unknown, z.core.$ZodTypeInternals<AutomationWhen, unknown>>>;
184
236
  override: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -269,6 +321,32 @@ export declare const SchedulerProfileSchema: z.ZodObject<{
269
321
  steps: z.ZodDefault<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
270
322
  kind: z.ZodLiteral<"wait">;
271
323
  seconds: z.ZodNumber;
324
+ if: z.ZodOptional<z.ZodType<AutomationWhen, unknown, z.core.$ZodTypeInternals<AutomationWhen, unknown>>>;
325
+ else: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
326
+ kind: z.ZodLiteral<"wait">;
327
+ seconds: z.ZodNumber;
328
+ }, z.core.$strip>, z.ZodObject<{
329
+ kind: z.ZodLiteral<"cap">;
330
+ actionId: z.ZodOptional<z.ZodString>;
331
+ target: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
332
+ kind: z.ZodLiteral<"devices">;
333
+ ids: z.ZodArray<z.ZodNumber>;
334
+ }, z.core.$strip>, z.ZodObject<{
335
+ kind: z.ZodLiteral<"domain">;
336
+ deviceType: z.ZodOptional<z.ZodEnum<typeof import("../index.js").DeviceType>>;
337
+ roomId: z.ZodOptional<z.ZodString>;
338
+ }, z.core.$strip>, z.ZodObject<{
339
+ kind: z.ZodLiteral<"var">;
340
+ name: z.ZodString;
341
+ }, z.core.$strip>], "kind">>;
342
+ deviceId: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodArray<z.ZodNumber>, z.ZodObject<{
343
+ $var: z.ZodString;
344
+ }, z.core.$strip>]>>;
345
+ cap: z.ZodString;
346
+ method: z.ZodString;
347
+ args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
348
+ argUnits: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
349
+ }, z.core.$strip>], "kind">>>;
272
350
  }, z.core.$strip>, z.ZodObject<{
273
351
  kind: z.ZodLiteral<"cap">;
274
352
  actionId: z.ZodOptional<z.ZodString>;
@@ -290,6 +368,32 @@ export declare const SchedulerProfileSchema: z.ZodObject<{
290
368
  method: z.ZodString;
291
369
  args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
292
370
  argUnits: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
371
+ if: z.ZodOptional<z.ZodType<AutomationWhen, unknown, z.core.$ZodTypeInternals<AutomationWhen, unknown>>>;
372
+ else: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
373
+ kind: z.ZodLiteral<"wait">;
374
+ seconds: z.ZodNumber;
375
+ }, z.core.$strip>, z.ZodObject<{
376
+ kind: z.ZodLiteral<"cap">;
377
+ actionId: z.ZodOptional<z.ZodString>;
378
+ target: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
379
+ kind: z.ZodLiteral<"devices">;
380
+ ids: z.ZodArray<z.ZodNumber>;
381
+ }, z.core.$strip>, z.ZodObject<{
382
+ kind: z.ZodLiteral<"domain">;
383
+ deviceType: z.ZodOptional<z.ZodEnum<typeof import("../index.js").DeviceType>>;
384
+ roomId: z.ZodOptional<z.ZodString>;
385
+ }, z.core.$strip>, z.ZodObject<{
386
+ kind: z.ZodLiteral<"var">;
387
+ name: z.ZodString;
388
+ }, z.core.$strip>], "kind">>;
389
+ deviceId: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodArray<z.ZodNumber>, z.ZodObject<{
390
+ $var: z.ZodString;
391
+ }, z.core.$strip>]>>;
392
+ cap: z.ZodString;
393
+ method: z.ZodString;
394
+ args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
395
+ argUnits: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
396
+ }, z.core.$strip>], "kind">>>;
293
397
  }, z.core.$strip>], "kind">>>;
294
398
  conditions: z.ZodOptional<z.ZodType<AutomationWhen, unknown, z.core.$ZodTypeInternals<AutomationWhen, unknown>>>;
295
399
  override: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -388,6 +492,32 @@ export declare const SchedulerInputSchema: z.ZodObject<{
388
492
  steps: z.ZodDefault<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
389
493
  kind: z.ZodLiteral<"wait">;
390
494
  seconds: z.ZodNumber;
495
+ if: z.ZodOptional<z.ZodType<AutomationWhen, unknown, z.core.$ZodTypeInternals<AutomationWhen, unknown>>>;
496
+ else: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
497
+ kind: z.ZodLiteral<"wait">;
498
+ seconds: z.ZodNumber;
499
+ }, z.core.$strip>, z.ZodObject<{
500
+ kind: z.ZodLiteral<"cap">;
501
+ actionId: z.ZodOptional<z.ZodString>;
502
+ target: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
503
+ kind: z.ZodLiteral<"devices">;
504
+ ids: z.ZodArray<z.ZodNumber>;
505
+ }, z.core.$strip>, z.ZodObject<{
506
+ kind: z.ZodLiteral<"domain">;
507
+ deviceType: z.ZodOptional<z.ZodEnum<typeof import("../index.js").DeviceType>>;
508
+ roomId: z.ZodOptional<z.ZodString>;
509
+ }, z.core.$strip>, z.ZodObject<{
510
+ kind: z.ZodLiteral<"var">;
511
+ name: z.ZodString;
512
+ }, z.core.$strip>], "kind">>;
513
+ deviceId: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodArray<z.ZodNumber>, z.ZodObject<{
514
+ $var: z.ZodString;
515
+ }, z.core.$strip>]>>;
516
+ cap: z.ZodString;
517
+ method: z.ZodString;
518
+ args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
519
+ argUnits: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
520
+ }, z.core.$strip>], "kind">>>;
391
521
  }, z.core.$strip>, z.ZodObject<{
392
522
  kind: z.ZodLiteral<"cap">;
393
523
  actionId: z.ZodOptional<z.ZodString>;
@@ -409,6 +539,32 @@ export declare const SchedulerInputSchema: z.ZodObject<{
409
539
  method: z.ZodString;
410
540
  args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
411
541
  argUnits: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
542
+ if: z.ZodOptional<z.ZodType<AutomationWhen, unknown, z.core.$ZodTypeInternals<AutomationWhen, unknown>>>;
543
+ else: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
544
+ kind: z.ZodLiteral<"wait">;
545
+ seconds: z.ZodNumber;
546
+ }, z.core.$strip>, z.ZodObject<{
547
+ kind: z.ZodLiteral<"cap">;
548
+ actionId: z.ZodOptional<z.ZodString>;
549
+ target: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
550
+ kind: z.ZodLiteral<"devices">;
551
+ ids: z.ZodArray<z.ZodNumber>;
552
+ }, z.core.$strip>, z.ZodObject<{
553
+ kind: z.ZodLiteral<"domain">;
554
+ deviceType: z.ZodOptional<z.ZodEnum<typeof import("../index.js").DeviceType>>;
555
+ roomId: z.ZodOptional<z.ZodString>;
556
+ }, z.core.$strip>, z.ZodObject<{
557
+ kind: z.ZodLiteral<"var">;
558
+ name: z.ZodString;
559
+ }, z.core.$strip>], "kind">>;
560
+ deviceId: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodArray<z.ZodNumber>, z.ZodObject<{
561
+ $var: z.ZodString;
562
+ }, z.core.$strip>]>>;
563
+ cap: z.ZodString;
564
+ method: z.ZodString;
565
+ args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
566
+ argUnits: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
567
+ }, z.core.$strip>], "kind">>>;
412
568
  }, z.core.$strip>], "kind">>>;
413
569
  conditions: z.ZodOptional<z.ZodType<AutomationWhen, unknown, z.core.$ZodTypeInternals<AutomationWhen, unknown>>>;
414
570
  override: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -507,6 +663,32 @@ export declare const SchedulerSchema: z.ZodObject<{
507
663
  steps: z.ZodDefault<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
508
664
  kind: z.ZodLiteral<"wait">;
509
665
  seconds: z.ZodNumber;
666
+ if: z.ZodOptional<z.ZodType<AutomationWhen, unknown, z.core.$ZodTypeInternals<AutomationWhen, unknown>>>;
667
+ else: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
668
+ kind: z.ZodLiteral<"wait">;
669
+ seconds: z.ZodNumber;
670
+ }, z.core.$strip>, z.ZodObject<{
671
+ kind: z.ZodLiteral<"cap">;
672
+ actionId: z.ZodOptional<z.ZodString>;
673
+ target: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
674
+ kind: z.ZodLiteral<"devices">;
675
+ ids: z.ZodArray<z.ZodNumber>;
676
+ }, z.core.$strip>, z.ZodObject<{
677
+ kind: z.ZodLiteral<"domain">;
678
+ deviceType: z.ZodOptional<z.ZodEnum<typeof import("../index.js").DeviceType>>;
679
+ roomId: z.ZodOptional<z.ZodString>;
680
+ }, z.core.$strip>, z.ZodObject<{
681
+ kind: z.ZodLiteral<"var">;
682
+ name: z.ZodString;
683
+ }, z.core.$strip>], "kind">>;
684
+ deviceId: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodArray<z.ZodNumber>, z.ZodObject<{
685
+ $var: z.ZodString;
686
+ }, z.core.$strip>]>>;
687
+ cap: z.ZodString;
688
+ method: z.ZodString;
689
+ args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
690
+ argUnits: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
691
+ }, z.core.$strip>], "kind">>>;
510
692
  }, z.core.$strip>, z.ZodObject<{
511
693
  kind: z.ZodLiteral<"cap">;
512
694
  actionId: z.ZodOptional<z.ZodString>;
@@ -528,6 +710,32 @@ export declare const SchedulerSchema: z.ZodObject<{
528
710
  method: z.ZodString;
529
711
  args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
530
712
  argUnits: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
713
+ if: z.ZodOptional<z.ZodType<AutomationWhen, unknown, z.core.$ZodTypeInternals<AutomationWhen, unknown>>>;
714
+ else: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
715
+ kind: z.ZodLiteral<"wait">;
716
+ seconds: z.ZodNumber;
717
+ }, z.core.$strip>, z.ZodObject<{
718
+ kind: z.ZodLiteral<"cap">;
719
+ actionId: z.ZodOptional<z.ZodString>;
720
+ target: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
721
+ kind: z.ZodLiteral<"devices">;
722
+ ids: z.ZodArray<z.ZodNumber>;
723
+ }, z.core.$strip>, z.ZodObject<{
724
+ kind: z.ZodLiteral<"domain">;
725
+ deviceType: z.ZodOptional<z.ZodEnum<typeof import("../index.js").DeviceType>>;
726
+ roomId: z.ZodOptional<z.ZodString>;
727
+ }, z.core.$strip>, z.ZodObject<{
728
+ kind: z.ZodLiteral<"var">;
729
+ name: z.ZodString;
730
+ }, z.core.$strip>], "kind">>;
731
+ deviceId: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodArray<z.ZodNumber>, z.ZodObject<{
732
+ $var: z.ZodString;
733
+ }, z.core.$strip>]>>;
734
+ cap: z.ZodString;
735
+ method: z.ZodString;
736
+ args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
737
+ argUnits: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
738
+ }, z.core.$strip>], "kind">>>;
531
739
  }, z.core.$strip>], "kind">>>;
532
740
  conditions: z.ZodOptional<z.ZodType<AutomationWhen, unknown, z.core.$ZodTypeInternals<AutomationWhen, unknown>>>;
533
741
  override: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -0,0 +1,19 @@
1
+ /**
2
+ * The guard of a conditional step (#472): the step's `if` is the ONE `when`
3
+ * tree (D980), read on a {@link ConditionMirror} filled for exactly the leaves
4
+ * the tree names, at the moment the step is reached. A state that cannot be
5
+ * read is UNKNOWN, and unknown runs neither side (D49: a failed read changes
6
+ * nothing, and never decides a branch).
7
+ */
8
+ import { type MirrorRefreshFetchers } from './condition-eval.js';
9
+ import type { AutomationWhen } from './when.js';
10
+ export type StepConditionResult = 'true' | 'false' | 'unknown';
11
+ export interface StepConditionVerdict {
12
+ readonly result: StepConditionResult;
13
+ /** Why, in the evaluator's own words (the failing leaf for a false, the unread state for an unknown). */
14
+ readonly reason: string;
15
+ }
16
+ /** What a consumer provides to evaluate a step's `if`. */
17
+ export type EvaluateStepCondition = (when: AutomationWhen) => Promise<StepConditionVerdict>;
18
+ /** Fill a mirror for the tree's leaves from `fetchers` and judge it NOW. */
19
+ export declare function evaluateStepCondition(when: AutomationWhen, fetchers: MirrorRefreshFetchers, now?: () => number): Promise<StepConditionVerdict>;
@@ -9,8 +9,10 @@
9
9
  * after a failure, or after an abort, are `not-run` with the reason.
10
10
  */
11
11
  import type { CommandOriginClaim } from '../audit/device-transition.js';
12
+ import type { DeviceTemplateRender } from '../expression/device-template.js';
12
13
  import type { ActionTarget, ResolvedTarget, ResolveOrigin } from './action-target.js';
13
14
  import { type ActionStep } from './recipe.js';
15
+ import type { EvaluateStepCondition, StepConditionVerdict } from './step-condition.js';
14
16
  import { type AutomationStepTrace, type StepDeviceTrace } from './trace.js';
15
17
  /** Static facts about a step, known before it runs. */
16
18
  export interface StepMeta {
@@ -30,11 +32,17 @@ export interface StepScope {
30
32
  markEmpty(reason: string): void;
31
33
  /** The parameters the step is sending NOW (substituted), for its trace. */
32
34
  setArgs(args: Readonly<Record<string, unknown>>): void;
35
+ /** The device values the step's templates printed as `—`, with the reason (D1021). */
36
+ setTemplateNotes(notes: readonly string[]): void;
33
37
  }
34
38
  /** One step as the runner sees it: its meta and a closure that does the work. */
35
39
  export interface RunnableStep {
36
40
  readonly meta: StepMeta;
37
41
  run(scope: StepScope): Promise<void>;
42
+ /** The step's own `if` (#472): read when the step is reached. Absent = always runs. */
43
+ readonly guard?: () => Promise<StepConditionVerdict>;
44
+ /** Run when the guard reads `false`; never when it reads `unknown`. */
45
+ readonly otherwise?: readonly RunnableStep[];
38
46
  }
39
47
  export interface StepFailure {
40
48
  readonly index: number;
@@ -42,6 +50,13 @@ export interface StepFailure {
42
50
  readonly message: string;
43
51
  readonly deviceId: number | undefined;
44
52
  }
53
+ /** A guarded step that was skipped because its condition could not be read (D49). */
54
+ export interface StepGuardUnknown {
55
+ readonly index: number;
56
+ readonly path: string;
57
+ readonly reason: string;
58
+ readonly deviceId: number | undefined;
59
+ }
45
60
  export interface RunStepsOptions {
46
61
  /** `actions` for an automation, `steps` for an Action run. */
47
62
  readonly pathPrefix: string;
@@ -51,6 +66,8 @@ export interface RunStepsOptions {
51
66
  readonly now: () => number;
52
67
  /** Called once, for the step that failed. */
53
68
  readonly onFailure: (failure: StepFailure) => void;
69
+ /** Called for a step skipped because its `if` read unknown: a branch that drops work says so (#472). */
70
+ readonly onGuardUnknown?: (skipped: StepGuardUnknown) => void;
54
71
  }
55
72
  export interface RunStepsResult {
56
73
  readonly steps: readonly AutomationStepTrace[];
@@ -71,6 +88,35 @@ export type StepVars = Readonly<Record<string, unknown>>;
71
88
  * the hole is reported through `onMissing` and rendered empty.)
72
89
  */
73
90
  export declare function resolveStepArgs(value: unknown, vars: StepVars, onMissing: (name: string) => void): unknown;
91
+ /**
92
+ * Renders device templates (D1021) — the hub's `device-manager` does the work;
93
+ * a consumer reaches it through `ctx.api`. One call carries every template of a
94
+ * step, and the answer is index-aligned with the question.
95
+ */
96
+ export type RenderStepTemplates = (templates: readonly string[]) => Promise<readonly DeviceTemplateRender[]>;
97
+ /** A device template that did not render: the step fails with this, never throws past `runSteps`. */
98
+ export declare class StepTemplateError extends Error {
99
+ readonly reason: string;
100
+ constructor(reason: string, message: string);
101
+ }
102
+ /** True when a string, once its `{{vars.x}}` slots are set aside, still carries template markup. */
103
+ export declare function carriesDeviceTemplate(text: string): boolean;
104
+ /** Every string in `value` that is a device template (D1021), de-duplicated, in walk order. */
105
+ export declare function collectDeviceTemplates(value: unknown): string[];
106
+ export interface TemplatedArgs {
107
+ readonly value: unknown;
108
+ /** `ref: reason` per value that printed `—`, in render order, de-duplicated. */
109
+ readonly notes: readonly string[];
110
+ }
111
+ /**
112
+ * {@link resolveStepArgs} plus the device templates of a step (D1021). A string
113
+ * that carries `{{ … }}` / `{% … %}` beyond a `{{vars.x}}` slot is rendered by
114
+ * `render` BEFORE the variables are put in, so a variable's value is data and
115
+ * never template source (an action variable can come from a non-admin caller).
116
+ * A refused render, or no renderer, throws {@link StepTemplateError}: the step
117
+ * fails with the typed reason and nothing is dispatched.
118
+ */
119
+ export declare function resolveStepArgsWithTemplates(value: unknown, vars: StepVars, onMissing: (name: string) => void, render: RenderStepTemplates | undefined): Promise<TemplatedArgs>;
74
120
  /** A `{ $var }` device target, resolved from the bag BEFORE dispatch. */
75
121
  export declare function resolveDeviceTarget(vars: StepVars, name: string): number;
76
122
  export interface CapCall {
@@ -87,6 +133,10 @@ export interface ActionStepDeps {
87
133
  invokeCap(call: CapCall): Promise<void>;
88
134
  sleep(ms: number): Promise<void>;
89
135
  onMissingVar(name: string): void;
136
+ /** Renders the device templates of a step's args (D1021); absent on a node that has none. */
137
+ readonly renderTemplates?: RenderStepTemplates;
138
+ /** Reads a step's `if` (#472) on the state mirror; absent = a guarded step reads `unknown`. */
139
+ readonly evaluateCondition?: EvaluateStepCondition;
90
140
  /** Turn a step's target into device ids (an empty answer is logged by the resolver). */
91
141
  resolveTarget(target: ActionTarget, actionId: string | undefined, vars: StepVars, origin: ResolveOrigin): Promise<ResolvedTarget>;
92
142
  /** The action / automation the steps belong to, for the log line of an empty target. */
@@ -98,9 +148,4 @@ export interface ActionStepDeps {
98
148
  * the step's trace, in device order, and the step fails afterwards if any did.
99
149
  */
100
150
  export declare function runForDevices(deviceIds: readonly number[], scope: StepScope, work: (deviceId: number) => Promise<void>, concurrency?: number): Promise<void>;
101
- /**
102
- * The runnable form of an internal Action's steps, bound to one run's
103
- * variables. Variables are substituted per step, at the moment it runs, so a
104
- * missing one fails THAT step (traced) and leaves the later ones not-run.
105
- */
106
151
  export declare function buildActionSteps(steps: readonly ActionStep[], vars: StepVars, deps: ActionStepDeps): RunnableStep[];
@@ -117,6 +117,9 @@ export declare const StepDeviceTraceSchema: z.ZodObject<{
117
117
  message: z.ZodOptional<z.ZodString>;
118
118
  }, z.core.$strip>;
119
119
  export type StepDeviceTrace = z.infer<typeof StepDeviceTraceSchema>;
120
+ /** How many unknown-value notes one step trace keeps. */
121
+ export declare const MAX_STEP_TEMPLATE_NOTES = 20;
122
+ /** A step trace; the `else` steps that ran are one level of the same shape (the nesting is bounded at one). */
120
123
  export declare const AutomationStepTraceSchema: z.ZodObject<{
121
124
  path: z.ZodString;
122
125
  kind: z.ZodString;
@@ -135,13 +138,55 @@ export declare const AutomationStepTraceSchema: z.ZodObject<{
135
138
  startedAt: z.ZodOptional<z.ZodNumber>;
136
139
  endedAt: z.ZodOptional<z.ZodNumber>;
137
140
  args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>]>>>;
141
+ templates: z.ZodOptional<z.ZodArray<z.ZodString>>;
142
+ condition: z.ZodOptional<z.ZodEnum<{
143
+ false: "false";
144
+ true: "true";
145
+ unknown: "unknown";
146
+ }>>;
147
+ conditionReason: z.ZodOptional<z.ZodString>;
138
148
  outcome: z.ZodEnum<{
139
149
  empty: "empty";
140
150
  error: "error";
141
151
  "not-run": "not-run";
142
152
  ok: "ok";
153
+ skipped: "skipped";
143
154
  }>;
144
155
  message: z.ZodOptional<z.ZodString>;
156
+ else: z.ZodOptional<z.ZodArray<z.ZodObject<{
157
+ path: z.ZodString;
158
+ kind: z.ZodString;
159
+ cap: z.ZodOptional<z.ZodString>;
160
+ method: z.ZodOptional<z.ZodString>;
161
+ actionId: z.ZodOptional<z.ZodString>;
162
+ deviceId: z.ZodOptional<z.ZodNumber>;
163
+ devices: z.ZodOptional<z.ZodArray<z.ZodObject<{
164
+ deviceId: z.ZodNumber;
165
+ outcome: z.ZodEnum<{
166
+ error: "error";
167
+ ok: "ok";
168
+ }>;
169
+ message: z.ZodOptional<z.ZodString>;
170
+ }, z.core.$strip>>>;
171
+ startedAt: z.ZodOptional<z.ZodNumber>;
172
+ endedAt: z.ZodOptional<z.ZodNumber>;
173
+ args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>]>>>;
174
+ templates: z.ZodOptional<z.ZodArray<z.ZodString>>;
175
+ condition: z.ZodOptional<z.ZodEnum<{
176
+ false: "false";
177
+ true: "true";
178
+ unknown: "unknown";
179
+ }>>;
180
+ conditionReason: z.ZodOptional<z.ZodString>;
181
+ outcome: z.ZodEnum<{
182
+ empty: "empty";
183
+ error: "error";
184
+ "not-run": "not-run";
185
+ ok: "ok";
186
+ skipped: "skipped";
187
+ }>;
188
+ message: z.ZodOptional<z.ZodString>;
189
+ }, z.core.$strip>>>;
145
190
  }, z.core.$strip>;
146
191
  export type AutomationStepTrace = z.infer<typeof AutomationStepTraceSchema>;
147
192
  export declare const AutomationRunTraceSchema: z.ZodObject<{
@@ -232,13 +277,55 @@ export declare const AutomationRunTraceSchema: z.ZodObject<{
232
277
  startedAt: z.ZodOptional<z.ZodNumber>;
233
278
  endedAt: z.ZodOptional<z.ZodNumber>;
234
279
  args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>]>>>;
280
+ templates: z.ZodOptional<z.ZodArray<z.ZodString>>;
281
+ condition: z.ZodOptional<z.ZodEnum<{
282
+ false: "false";
283
+ true: "true";
284
+ unknown: "unknown";
285
+ }>>;
286
+ conditionReason: z.ZodOptional<z.ZodString>;
235
287
  outcome: z.ZodEnum<{
236
288
  empty: "empty";
237
289
  error: "error";
238
290
  "not-run": "not-run";
239
291
  ok: "ok";
292
+ skipped: "skipped";
240
293
  }>;
241
294
  message: z.ZodOptional<z.ZodString>;
295
+ else: z.ZodOptional<z.ZodArray<z.ZodObject<{
296
+ path: z.ZodString;
297
+ kind: z.ZodString;
298
+ cap: z.ZodOptional<z.ZodString>;
299
+ method: z.ZodOptional<z.ZodString>;
300
+ actionId: z.ZodOptional<z.ZodString>;
301
+ deviceId: z.ZodOptional<z.ZodNumber>;
302
+ devices: z.ZodOptional<z.ZodArray<z.ZodObject<{
303
+ deviceId: z.ZodNumber;
304
+ outcome: z.ZodEnum<{
305
+ error: "error";
306
+ ok: "ok";
307
+ }>;
308
+ message: z.ZodOptional<z.ZodString>;
309
+ }, z.core.$strip>>>;
310
+ startedAt: z.ZodOptional<z.ZodNumber>;
311
+ endedAt: z.ZodOptional<z.ZodNumber>;
312
+ args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>]>>>;
313
+ templates: z.ZodOptional<z.ZodArray<z.ZodString>>;
314
+ condition: z.ZodOptional<z.ZodEnum<{
315
+ false: "false";
316
+ true: "true";
317
+ unknown: "unknown";
318
+ }>>;
319
+ conditionReason: z.ZodOptional<z.ZodString>;
320
+ outcome: z.ZodEnum<{
321
+ empty: "empty";
322
+ error: "error";
323
+ "not-run": "not-run";
324
+ ok: "ok";
325
+ skipped: "skipped";
326
+ }>;
327
+ message: z.ZodOptional<z.ZodString>;
328
+ }, z.core.$strip>>>;
242
329
  }, z.core.$strip>>;
243
330
  outcome: z.ZodEnum<{
244
331
  aborted: "aborted";
@@ -359,13 +446,55 @@ export declare const AutomationStateDocSchema: z.ZodObject<{
359
446
  startedAt: z.ZodOptional<z.ZodNumber>;
360
447
  endedAt: z.ZodOptional<z.ZodNumber>;
361
448
  args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>]>>>;
449
+ templates: z.ZodOptional<z.ZodArray<z.ZodString>>;
450
+ condition: z.ZodOptional<z.ZodEnum<{
451
+ false: "false";
452
+ true: "true";
453
+ unknown: "unknown";
454
+ }>>;
455
+ conditionReason: z.ZodOptional<z.ZodString>;
362
456
  outcome: z.ZodEnum<{
363
457
  empty: "empty";
364
458
  error: "error";
365
459
  "not-run": "not-run";
366
460
  ok: "ok";
461
+ skipped: "skipped";
367
462
  }>;
368
463
  message: z.ZodOptional<z.ZodString>;
464
+ else: z.ZodOptional<z.ZodArray<z.ZodObject<{
465
+ path: z.ZodString;
466
+ kind: z.ZodString;
467
+ cap: z.ZodOptional<z.ZodString>;
468
+ method: z.ZodOptional<z.ZodString>;
469
+ actionId: z.ZodOptional<z.ZodString>;
470
+ deviceId: z.ZodOptional<z.ZodNumber>;
471
+ devices: z.ZodOptional<z.ZodArray<z.ZodObject<{
472
+ deviceId: z.ZodNumber;
473
+ outcome: z.ZodEnum<{
474
+ error: "error";
475
+ ok: "ok";
476
+ }>;
477
+ message: z.ZodOptional<z.ZodString>;
478
+ }, z.core.$strip>>>;
479
+ startedAt: z.ZodOptional<z.ZodNumber>;
480
+ endedAt: z.ZodOptional<z.ZodNumber>;
481
+ args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>]>>>;
482
+ templates: z.ZodOptional<z.ZodArray<z.ZodString>>;
483
+ condition: z.ZodOptional<z.ZodEnum<{
484
+ false: "false";
485
+ true: "true";
486
+ unknown: "unknown";
487
+ }>>;
488
+ conditionReason: z.ZodOptional<z.ZodString>;
489
+ outcome: z.ZodEnum<{
490
+ empty: "empty";
491
+ error: "error";
492
+ "not-run": "not-run";
493
+ ok: "ok";
494
+ skipped: "skipped";
495
+ }>;
496
+ message: z.ZodOptional<z.ZodString>;
497
+ }, z.core.$strip>>>;
369
498
  }, z.core.$strip>>;
370
499
  outcome: z.ZodEnum<{
371
500
  aborted: "aborted";
@@ -34,6 +34,32 @@ export declare const actionSourceCapability: {
34
34
  steps: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
35
35
  kind: z.ZodLiteral<"wait">;
36
36
  seconds: z.ZodNumber;
37
+ if: z.ZodOptional<z.ZodType<import("../index.js").AutomationWhen, unknown, z.core.$ZodTypeInternals<import("../index.js").AutomationWhen, unknown>>>;
38
+ else: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
39
+ kind: z.ZodLiteral<"wait">;
40
+ seconds: z.ZodNumber;
41
+ }, z.core.$strip>, z.ZodObject<{
42
+ kind: z.ZodLiteral<"cap">;
43
+ actionId: z.ZodOptional<z.ZodString>;
44
+ target: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
45
+ kind: z.ZodLiteral<"devices">;
46
+ ids: z.ZodArray<z.ZodNumber>;
47
+ }, z.core.$strip>, z.ZodObject<{
48
+ kind: z.ZodLiteral<"domain">;
49
+ deviceType: z.ZodOptional<z.ZodEnum<typeof import("../index.js").DeviceType>>;
50
+ roomId: z.ZodOptional<z.ZodString>;
51
+ }, z.core.$strip>, z.ZodObject<{
52
+ kind: z.ZodLiteral<"var">;
53
+ name: z.ZodString;
54
+ }, z.core.$strip>], "kind">>;
55
+ deviceId: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodArray<z.ZodNumber>, z.ZodObject<{
56
+ $var: z.ZodString;
57
+ }, z.core.$strip>]>>;
58
+ cap: z.ZodString;
59
+ method: z.ZodString;
60
+ args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
61
+ argUnits: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
62
+ }, z.core.$strip>], "kind">>>;
37
63
  }, z.core.$strip>, z.ZodObject<{
38
64
  kind: z.ZodLiteral<"cap">;
39
65
  actionId: z.ZodOptional<z.ZodString>;
@@ -55,6 +81,32 @@ export declare const actionSourceCapability: {
55
81
  method: z.ZodString;
56
82
  args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
57
83
  argUnits: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
84
+ if: z.ZodOptional<z.ZodType<import("../index.js").AutomationWhen, unknown, z.core.$ZodTypeInternals<import("../index.js").AutomationWhen, unknown>>>;
85
+ else: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
86
+ kind: z.ZodLiteral<"wait">;
87
+ seconds: z.ZodNumber;
88
+ }, z.core.$strip>, z.ZodObject<{
89
+ kind: z.ZodLiteral<"cap">;
90
+ actionId: z.ZodOptional<z.ZodString>;
91
+ target: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
92
+ kind: z.ZodLiteral<"devices">;
93
+ ids: z.ZodArray<z.ZodNumber>;
94
+ }, z.core.$strip>, z.ZodObject<{
95
+ kind: z.ZodLiteral<"domain">;
96
+ deviceType: z.ZodOptional<z.ZodEnum<typeof import("../index.js").DeviceType>>;
97
+ roomId: z.ZodOptional<z.ZodString>;
98
+ }, z.core.$strip>, z.ZodObject<{
99
+ kind: z.ZodLiteral<"var">;
100
+ name: z.ZodString;
101
+ }, z.core.$strip>], "kind">>;
102
+ deviceId: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodArray<z.ZodNumber>, z.ZodObject<{
103
+ $var: z.ZodString;
104
+ }, z.core.$strip>]>>;
105
+ cap: z.ZodString;
106
+ method: z.ZodString;
107
+ args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
108
+ argUnits: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
109
+ }, z.core.$strip>], "kind">>>;
58
110
  }, z.core.$strip>], "kind">>>;
59
111
  variables: z.ZodOptional<z.ZodArray<z.ZodObject<{
60
112
  name: z.ZodString;