@camstack/addon-provider-homematic 1.2.188 → 1.2.189

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.
package/dist/addon.js CHANGED
@@ -6035,7 +6035,7 @@ var ZodIssueCode = {
6035
6035
  var ZodFirstPartyTypeKind;
6036
6036
  ZodFirstPartyTypeKind || (ZodFirstPartyTypeKind = {});
6037
6037
  //#endregion
6038
- //#region ../types/dist/sleep-Dz1P6--1.mjs
6038
+ //#region ../types/dist/sleep-Cw1uUXvl.mjs
6039
6039
  /**
6040
6040
  * The audio chunk plane's byte format, and the ONE expansion from a coded
6041
6041
  * window to float samples (D455).
@@ -15016,6 +15016,7 @@ var SYSTEM_CAP_VOCABULARY = {
15016
15016
  backup: system("system backups — run and restored from the Backups page"),
15017
15017
  broker: system("message-broker connections — configured, not actuated"),
15018
15018
  "calendar-source": system(INTERNAL),
15019
+ "cluster-update": system(CLUSTER),
15019
15020
  calendars: system("calendars feed schedules and conditions, not device actions"),
15020
15021
  composer: system("device composition — an authoring tool, not an action"),
15021
15022
  "core-blocks": system(INTERNAL),
@@ -15322,6 +15323,7 @@ var CAP_NAMES = Object.freeze([
15322
15323
  "camera-streams",
15323
15324
  "carbon-monoxide",
15324
15325
  "climate-control",
15326
+ "cluster-update",
15325
15327
  "color",
15326
15328
  "composer",
15327
15329
  "connectivity",
@@ -44078,6 +44080,62 @@ var WeekdayKeySchema = _enum([
44078
44080
  "sat",
44079
44081
  "sun"
44080
44082
  ]);
44083
+ /**
44084
+ * Hold semantics — "for N seconds" on a leaf of the `when` tree (#498).
44085
+ *
44086
+ * ONE primitive, `for: { ms, mode, tolerance? }`, shared by `device-becomes`,
44087
+ * `device-is` and `expression`:
44088
+ *
44089
+ * - `held`: the condition stays true for `ms`;
44090
+ * - `stable`: the value does not move by more than `tolerance` (absolute, in
44091
+ * the field's base unit) for `ms` while the condition holds.
44092
+ *
44093
+ * {@link HoldCore} is the pure state machine (an input observation → a reading).
44094
+ * {@link HoldTracker} keys cores by a leaf path for the STATE leaves the tree
44095
+ * evaluator judges. {@link BecomesWatch} wraps a core with a timer for the
44096
+ * `device-becomes` EVENT leaf: the deadline is armed when the hold starts and
44097
+ * cancelled when it breaks, and the leaf fires ONCE per episode.
44098
+ *
44099
+ * Hold state is memory only. A hold that is already running when the watcher
44100
+ * first looks (a restart) is INHERITED: nobody knows when it began, so it never
44101
+ * fires for that episode and a state leaf reads it as unknown until the window
44102
+ * has elapsed from the moment the watcher started (D49: not-known is not false).
44103
+ */
44104
+ var HOLD_MAX_MS = 864e5;
44105
+ var HoldModeSchema = _enum(["held", "stable"]);
44106
+ var HoldSpecSchema = object({
44107
+ /** How long the condition (or the value) must hold. */
44108
+ ms: number$1().int().min(1).max(HOLD_MAX_MS),
44109
+ mode: HoldModeSchema,
44110
+ /** `stable` only: the largest move of the value that still counts as unchanged (absolute, base unit). */
44111
+ tolerance: number$1().min(0).optional()
44112
+ });
44113
+ /** What a trace says about a hold. */
44114
+ var HoldTraceSchema = object({
44115
+ phase: _enum([
44116
+ "pending",
44117
+ "cancelled",
44118
+ "fired",
44119
+ "reseeded"
44120
+ ]),
44121
+ ms: number$1().int(),
44122
+ mode: HoldModeSchema,
44123
+ /** When the hold started (ms epoch). */
44124
+ since: number$1().optional(),
44125
+ /** When it completes (ms epoch), for a pending hold. */
44126
+ deadline: number$1().optional()
44127
+ });
44128
+ /** The operators a `device-becomes` leaf may carry: a threshold or a range. */
44129
+ var BecomesOperatorSchema = _enum([
44130
+ "eq",
44131
+ "ne",
44132
+ "gt",
44133
+ "gte",
44134
+ "lt",
44135
+ "lte",
44136
+ "between",
44137
+ "outside"
44138
+ ]);
44081
44139
  /** How a state leaf compares a device field to a value. Derived from the
44082
44140
  * field's `kind` in `deviceManager.getWireableFields`, never hand-maintained. */
44083
44141
  var AutomationConditionOperatorSchema = _enum([
@@ -44101,18 +44159,52 @@ var DeviceBecomesLeafSchema = object({
44101
44159
  deviceId: number$1().int().nonnegative(),
44102
44160
  cap: string().min(1),
44103
44161
  fieldPath: string().min(1),
44104
- /** Fire when the field takes this value. Omit to fire on any change. */
44162
+ /** Fire when the field takes this value. Omit (with no `operator`) to fire on any change. */
44105
44163
  becomes: union([
44106
44164
  string(),
44107
44165
  number$1(),
44108
44166
  boolean()
44109
44167
  ]).optional(),
44110
- /** Only on a CHANGE of value, not on every re-report. */
44168
+ /**
44169
+ * A threshold or a range instead of an equality: "crosses above 3000", "enters
44170
+ * 18..24". The leaf fires on the TRANSITION into the predicate, never on a re-report.
44171
+ * `value` is in the field's base unit; `between` / `outside` take `[low, high]`.
44172
+ */
44173
+ operator: BecomesOperatorSchema.optional(),
44174
+ value: union([
44175
+ number$1(),
44176
+ string(),
44177
+ boolean(),
44178
+ array(number$1()).length(2)
44179
+ ]).optional(),
44180
+ /**
44181
+ * Hold: the transition (or, with no predicate, the new value) must stay for
44182
+ * `for.ms` before the leaf fires, ONCE per episode. See `hold.ts`.
44183
+ */
44184
+ for: HoldSpecSchema.optional(),
44185
+ /** @deprecated every leaf fires on a transition now; read as always on. */
44111
44186
  edge: boolean().optional(),
44112
- /** The new value must hold this long before it counts. */
44113
- forMs: number$1().int().min(0).max(864e5).optional(),
44187
+ /** @deprecated legacy `held` window — read through `holdOf` as `for: { ms, mode: 'held' }`. */
44188
+ forMs: number$1().int().min(0).max(HOLD_MAX_MS).optional(),
44114
44189
  /** Collapse a burst into one occurrence. */
44115
44190
  debounceMs: number$1().int().min(0).max(6e5).optional()
44191
+ }).superRefine((leaf, ctx) => {
44192
+ if (leaf.becomes !== void 0 && leaf.operator !== void 0) ctx.addIssue({
44193
+ code: "custom",
44194
+ message: "a leaf names `becomes` or `operator`, not both",
44195
+ path: ["operator"]
44196
+ });
44197
+ if (leaf.operator !== void 0 && leaf.value === void 0) ctx.addIssue({
44198
+ code: "custom",
44199
+ message: "an operator needs the value to compare to",
44200
+ path: ["value"]
44201
+ });
44202
+ const range = leaf.operator === "between" || leaf.operator === "outside";
44203
+ if (leaf.operator !== void 0 && range !== Array.isArray(leaf.value)) ctx.addIssue({
44204
+ code: "custom",
44205
+ message: range ? "a range takes [low, high]" : "only a range takes [low, high]",
44206
+ path: ["value"]
44207
+ });
44116
44208
  });
44117
44209
  var DeviceEventLeafSchema = object({
44118
44210
  kind: literal("device-event"),
@@ -44177,7 +44269,9 @@ var DeviceIsLeafSchema = object({
44177
44269
  QuantityValueSchema
44178
44270
  ]),
44179
44271
  /** The unit the person picked for `value` (display only; `value` is in the base unit). */
44180
- unit: string().min(1).optional()
44272
+ unit: string().min(1).optional(),
44273
+ /** The comparison must hold (`held`) or the value stay put (`stable`) this long. */
44274
+ for: HoldSpecSchema.optional()
44181
44275
  });
44182
44276
  /**
44183
44277
  * True when the camera currently has a PARKED object matching `subjects` in at
@@ -44200,7 +44294,9 @@ var StationaryPresentLeafSchema = object({
44200
44294
  var ExpressionLeafSchema = object({
44201
44295
  kind: literal("expression"),
44202
44296
  expr: string().min(1).max(MAX_EXPRESSION_SOURCE_LENGTH),
44203
- bindings: record(string().regex(EXPRESSION_IDENTIFIER_RE), ExpressionBindingSourceSchema)
44297
+ bindings: record(string().regex(EXPRESSION_IDENTIFIER_RE), ExpressionBindingSourceSchema),
44298
+ /** The expression must stay true this long. An expression has no single value, so only `held`. */
44299
+ for: HoldSpecSchema.optional()
44204
44300
  }).superRefine((src, ctx) => {
44205
44301
  const err = validateExpressionSource(src);
44206
44302
  if (err !== null) ctx.addIssue({
@@ -44208,6 +44304,11 @@ var ExpressionLeafSchema = object({
44208
44304
  message: err,
44209
44305
  path: ["expr"]
44210
44306
  });
44307
+ if (src.for?.mode === "stable") ctx.addIssue({
44308
+ code: "custom",
44309
+ message: "an expression is held, not stable: it has no single value to keep still",
44310
+ path: ["for", "mode"]
44311
+ });
44211
44312
  });
44212
44313
  var AutomationWhenSchema = lazy(() => discriminatedUnion("kind", [
44213
44314
  object({
@@ -44967,7 +45068,9 @@ var AutomationTriggerTraceSchema = object({
44967
45068
  /** Why an event was rejected ("class person not in [dog]") or what fired. */
44968
45069
  reason: string(),
44969
45070
  /** deviceId, className, trackId, score … — only what the trigger exposes. */
44970
- vars: record(string(), TraceValueSchema)
45071
+ vars: record(string(), TraceValueSchema),
45072
+ /** A hold (`for`) this occurrence went through: pending, cancelled, fired or re-seeded. */
45073
+ hold: HoldTraceSchema.optional()
44971
45074
  });
44972
45075
  var AutomationConditionTraceNodeSchema = object({
44973
45076
  /** `when` for the root, `when.<i>` for its i-th child, … (`conditions…` on an old trace). */
@@ -49484,6 +49587,140 @@ var climateControlCapability = {
49484
49587
  } }
49485
49588
  };
49486
49589
  /**
49590
+ * cluster-update — the ONE flow that brings the whole cluster to a release
49591
+ * (planning#493). Hub-provided (`server-provided`), hub-only: the hub runs
49592
+ * the sequence itself, so the admin UI, the MCP and the CLI all start the same
49593
+ * job and read the same report instead of each driving their own loop.
49594
+ *
49595
+ * 1. backup (`backup.trigger`) — skipped only when the caller says so
49596
+ * 2. the hub's server closure (`applyServerUpdate`); the hub restarts and the
49597
+ * job RESUMES on the new boot, verified against the hub's running version
49598
+ * 3. every online agent behind the target, one at a time, verified: runs the
49599
+ * target, settled, online, and its capabilities registered (D848) — an
49600
+ * agent that comes back capless is a FAILED step, never a done one
49601
+ * 4. every stale addon on the hub (`addons.updatePackage`); agents follow by
49602
+ * reconciliation, which is verified, never pushed
49603
+ *
49604
+ * The job stops on the first failed step with a typed reason (D877). Its state
49605
+ * is durable on the hub and read by RPC (`getClusterUpdateJob`) — events are
49606
+ * telemetry and never carry it (D8, D11).
49607
+ */
49608
+ /** The steps, in the order they run. */
49609
+ var ClusterUpdateStepKindSchema = _enum([
49610
+ "backup",
49611
+ "hub-server",
49612
+ "agent-server",
49613
+ "addons"
49614
+ ]);
49615
+ /**
49616
+ * - `pending` — not reached yet.
49617
+ * - `running` — in progress (for `hub-server`: possibly across the restart).
49618
+ * - `ok` — done AND verified.
49619
+ * - `failed` — did not land; `reason` + `detail` say why. Stops the job.
49620
+ * - `skipped` — not run: nothing to do, opted out, the node is offline, or a
49621
+ * step before it failed. `detail` says which.
49622
+ */
49623
+ var ClusterUpdateStepStatusSchema = _enum([
49624
+ "pending",
49625
+ "running",
49626
+ "ok",
49627
+ "failed",
49628
+ "skipped"
49629
+ ]);
49630
+ /**
49631
+ * Why a step (and with it the job) failed. Stable, greppable; `detail` carries
49632
+ * the prose.
49633
+ */
49634
+ var ClusterUpdateFailureReasonSchema = _enum([
49635
+ "backup-unavailable",
49636
+ "backup-failed",
49637
+ "server-refused",
49638
+ "server-not-on-target",
49639
+ "node-capless",
49640
+ "status-unreadable",
49641
+ "addon-update-failed",
49642
+ "addons-not-converged",
49643
+ "interrupted"
49644
+ ]);
49645
+ var ClusterUpdateStepSchema = object({
49646
+ kind: ClusterUpdateStepKindSchema,
49647
+ /** The node the step acts on; absent for `backup` and `addons`. */
49648
+ nodeId: string().optional(),
49649
+ status: ClusterUpdateStepStatusSchema,
49650
+ /** One line for the operator: what happened, or why not. */
49651
+ detail: string(),
49652
+ reason: ClusterUpdateFailureReasonSchema.optional(),
49653
+ /** `hub-server` / `agent-server`: the version the node ran before. */
49654
+ fromVersion: string().nullable().optional(),
49655
+ /** `addons`: the packages this step updates, `name from -> to`. */
49656
+ packages: array(string()).readonly().optional(),
49657
+ startedAt: number$1().optional(),
49658
+ finishedAt: number$1().optional()
49659
+ });
49660
+ var ClusterUpdateJobStateSchema = _enum([
49661
+ "running",
49662
+ "succeeded",
49663
+ "failed"
49664
+ ]);
49665
+ var ClusterUpdateJobSchema = object({
49666
+ id: string(),
49667
+ state: ClusterUpdateJobStateSchema,
49668
+ /** The server version every node is brought to. */
49669
+ targetVersion: string(),
49670
+ /** Who started it (the user name, or `system`). */
49671
+ requestedBy: string(),
49672
+ startedAt: number$1(),
49673
+ finishedAt: number$1().optional(),
49674
+ /** Every step, in run order; later steps stay `pending` while it runs. */
49675
+ steps: array(ClusterUpdateStepSchema).readonly(),
49676
+ /** On `failed`: the step that stopped it (`nodeId` or the step kind). */
49677
+ stoppedAt: string().optional(),
49678
+ reason: ClusterUpdateFailureReasonSchema.optional(),
49679
+ /** Agents offline when the plan was read: never touched. */
49680
+ skippedOffline: array(string()).readonly()
49681
+ });
49682
+ var ClusterUpdateOptionsSchema = object({
49683
+ /** Explicit server target; omitted = the hub's latest registry check. */
49684
+ version: string().optional(),
49685
+ /** Update the addons too (default true). */
49686
+ addons: boolean().optional(),
49687
+ /**
49688
+ * Back up before touching anything (default true). `false` is an explicit
49689
+ * operator opt-out; a missing backup provider is otherwise a failure.
49690
+ */
49691
+ backup: boolean().optional()
49692
+ });
49693
+ /** Why a plan cannot start. */
49694
+ var ClusterUpdateBlockerSchema = _enum([
49695
+ "no-target",
49696
+ "node-busy",
49697
+ "job-running",
49698
+ "nothing-to-do",
49699
+ "status-unreadable"
49700
+ ]);
49701
+ var ClusterUpdatePlanSchema = object({
49702
+ /** `null` when no target could be resolved (`blocker: 'no-target'`). */
49703
+ targetVersion: string().nullable(),
49704
+ /** The steps the job WOULD run, all `pending` (or `skipped` with a reason). */
49705
+ steps: array(ClusterUpdateStepSchema).readonly(),
49706
+ skippedOffline: array(string()).readonly(),
49707
+ /** `null` = the plan can start. */
49708
+ blocker: ClusterUpdateBlockerSchema.nullable(),
49709
+ /** Prose for `blocker`. */
49710
+ blockerDetail: string().nullable()
49711
+ });
49712
+ var StartClusterUpdateResultSchema = object({
49713
+ accepted: boolean(),
49714
+ /** The job to follow with `getClusterUpdateJob`; `null` when refused. */
49715
+ jobId: string().nullable(),
49716
+ blocker: ClusterUpdateBlockerSchema.nullable(),
49717
+ message: string()
49718
+ });
49719
+ method(ClusterUpdateOptionsSchema, ClusterUpdatePlanSchema, { auth: "admin" }), method(ClusterUpdateOptionsSchema, StartClusterUpdateResultSchema, {
49720
+ kind: "mutation",
49721
+ auth: "admin"
49722
+ }), method(object({ jobId: string().optional() }), ClusterUpdateJobSchema.nullable(), { auth: "admin" });
49723
+ /**
49487
49724
  * Color-light cap. Coexists with `switch` (on/off) and `brightness`
49488
49725
  * (level) on the same device — `switch` toggles the bulb, `brightness`
49489
49726
  * sets the dim level, this cap sets the chromaticity.
@@ -52956,6 +53193,90 @@ var SiteZoneSchema = object({
52956
53193
  * the ones that most want grouping. */
52957
53194
  locationKeys: array(string())
52958
53195
  });
53196
+ var DeviceSearchRequiresSchema = object({
53197
+ /** Capability names the field wants a value of. */
53198
+ caps: array(string()).readonly(),
53199
+ /** `any` (default): a device with one of them is compatible. `all`: it must hold every one. */
53200
+ mode: _enum(["any", "all"]).optional()
53201
+ });
53202
+ var DeviceSearchFiltersSchema = object({
53203
+ locations: array(string()).readonly().optional(),
53204
+ integrationIds: array(string()).readonly().optional(),
53205
+ types: array(string()).readonly().optional()
53206
+ });
53207
+ var DeviceSearchInputSchema = object({
53208
+ /** Matches name, location, type, integration (id and label) and id. Case-insensitive. */
53209
+ text: string().optional(),
53210
+ requires: DeviceSearchRequiresSchema.optional(),
53211
+ filters: DeviceSearchFiltersSchema.optional(),
53212
+ /** List the devices that do not provide the required cap too (greyed, not pickable). */
53213
+ includeIncompatible: boolean().optional(),
53214
+ /** The device the field belongs to: its location drives `suggested`. */
53215
+ contextDeviceId: number$1().optional(),
53216
+ /**
53217
+ * Resolve exactly these devices, regardless of every filter, so a picked
53218
+ * value can be rendered. When given, `items` is these devices in the order
53219
+ * asked (no paging, `nextCursor` null) and the ones that do not exist are
53220
+ * listed in `missingIds`.
53221
+ */
53222
+ ids: array(number$1()).readonly().optional(),
53223
+ cursor: string().nullable().optional(),
53224
+ limit: number$1().int().min(1).max(200).optional()
53225
+ });
53226
+ var DeviceValueOptionSchema = object({
53227
+ cap: string(),
53228
+ /** Status-schema field path inside the cap (same paths as `getWireableFields`). */
53229
+ path: string(),
53230
+ label: string(),
53231
+ /** The current value as text; `null` when it is unknown or the read FAILED — never `0`. */
53232
+ reading: string().nullable(),
53233
+ unit: string().nullable().optional(),
53234
+ /** The field's measured quantity, when the cap declares one, so a client can format the reading. */
53235
+ quantity: ReadingQuantitySchema.optional()
53236
+ });
53237
+ var DeviceSearchItemSchema = object({
53238
+ id: number$1(),
53239
+ name: string(),
53240
+ type: _enum(DeviceType),
53241
+ location: string().nullable(),
53242
+ integrationId: string().nullable(),
53243
+ integrationLabel: string().nullable(),
53244
+ online: boolean().nullable(),
53245
+ disabled: boolean(),
53246
+ compatible: boolean(),
53247
+ /** Only the required caps' fields; empty when nothing was required or the device is incompatible. */
53248
+ values: array(DeviceValueOptionSchema).readonly()
53249
+ });
53250
+ var DeviceSearchFacetValueSchema = object({
53251
+ value: string(),
53252
+ count: number$1()
53253
+ });
53254
+ var DeviceSearchFacetIntegrationSchema = object({
53255
+ id: string(),
53256
+ label: string(),
53257
+ count: number$1()
53258
+ });
53259
+ var DeviceSearchFacetsSchema = object({
53260
+ locations: array(DeviceSearchFacetValueSchema).readonly(),
53261
+ integrations: array(DeviceSearchFacetIntegrationSchema).readonly(),
53262
+ types: array(DeviceSearchFacetValueSchema).readonly()
53263
+ });
53264
+ var DeviceSearchResultSchema = object({
53265
+ items: array(DeviceSearchItemSchema).readonly(),
53266
+ nextCursor: string().nullable(),
53267
+ /** Devices listed by this query across all pages (filters + text applied; incompatible counted only when `includeIncompatible`). */
53268
+ total: number$1(),
53269
+ /** Compatible devices after filters + text. */
53270
+ compatibleTotal: number$1(),
53271
+ /** Every device the caller's fleet holds, before anything is applied. */
53272
+ fleetTotal: number$1(),
53273
+ /** Incompatible devices after filters + text — the K of "show the K that don't". */
53274
+ hiddenIncompatible: number$1(),
53275
+ facets: DeviceSearchFacetsSchema,
53276
+ /** Same location as `contextDeviceId`; first page only. */
53277
+ suggested: array(DeviceSearchItemSchema).readonly(),
53278
+ missingIds: array(number$1()).readonly()
53279
+ });
52959
53280
  var ProviderStatusSchema = object({
52960
53281
  connected: boolean(),
52961
53282
  deviceCount: number$1(),
@@ -53441,6 +53762,9 @@ var DeviceInfoSchema = object({
53441
53762
  * named accordion sections (with optional intra-section order). See
53442
53763
  * `DeviceMeta.childLayout`. Absent ⇒ no layout declared. */
53443
53764
  childLayout: array(ChildLayoutEntrySchema).readonly().optional(),
53765
+ /** The children a container stands for, most preferred first, by accessory
53766
+ * `childKey`. Provider-declared. See `DeviceMeta.primaryChildPreference`. */
53767
+ primaryChildPreference: array(string()).readonly().optional(),
53444
53768
  /** Operator-authored per-device display override. See `DeviceMeta.display`. */
53445
53769
  display: DeviceDisplayOverrideSchema.optional()
53446
53770
  });
@@ -53589,6 +53913,9 @@ var DeviceMetaSchema = object({
53589
53913
  * accordion sections (with optional intra-section order). See
53590
53914
  * `DeviceMeta.childLayout`. Absent ⇒ no layout declared. */
53591
53915
  childLayout: array(ChildLayoutEntrySchema).readonly().optional(),
53916
+ /** The children a container stands for, most preferred first, by accessory
53917
+ * `childKey`. Provider-declared. See `DeviceMeta.primaryChildPreference`. */
53918
+ primaryChildPreference: array(string()).readonly().optional(),
53592
53919
  /** Semantic role string (`DeviceRole`) — propagated from the spawn pre-seed.
53593
53920
  * Optional: only present for accessory children that carry a known role. */
53594
53921
  role: string().nullable().optional(),
@@ -53804,6 +54131,12 @@ method(object({
53804
54131
  }), _void(), {
53805
54132
  kind: "mutation",
53806
54133
  auth: "admin"
54134
+ }), method(object({
54135
+ deviceId: number$1(),
54136
+ primaryChildPreference: array(string()).readonly()
54137
+ }), _void(), {
54138
+ kind: "mutation",
54139
+ auth: "admin"
53807
54140
  }), method(object({
53808
54141
  deviceId: number$1(),
53809
54142
  display: DeviceDisplayOverrideSchema.nullable()
@@ -53941,7 +54274,7 @@ method(object({
53941
54274
  * it answers today and the caller filters as it already does.
53942
54275
  */
53943
54276
  deviceIds: array(number$1()).optional()
53944
- }), array(DeviceInfoSchema), { role: "viewer" }), method(object({ deviceId: number$1() }), DeviceInfoSchema.nullable()), method(object({ parentDeviceId: number$1() }), array(DeviceInfoSchema), { role: "viewer" }), method(object({ parentDeviceIds: array(number$1()).max(256) }), record(string(), array(DeviceInfoSchema))), method(object({ deviceId: number$1() }), object({
54277
+ }), array(DeviceInfoSchema), { role: "viewer" }), method(DeviceSearchInputSchema, DeviceSearchResultSchema, { role: "viewer" }), method(object({ deviceId: number$1() }), DeviceInfoSchema.nullable()), method(object({ parentDeviceId: number$1() }), array(DeviceInfoSchema), { role: "viewer" }), method(object({ parentDeviceIds: array(number$1()).max(256) }), record(string(), array(DeviceInfoSchema))), method(object({ deviceId: number$1() }), object({
53945
54278
  mode: LinkedDevicesModeSchema,
53946
54279
  devices: array(LinkedDeviceSchema)
53947
54280
  }), { role: "viewer" }), method(object({ deviceIds: array(number$1()) }), array(LinkedDevicesForDeviceSchema), { role: "viewer" }), method(object({ deviceId: number$1() }), array(StreamSourceEntrySchema$1)), method(object({ deviceId: number$1() }), array(ConfigEntrySchema)), method(object({ deviceId: number$1() }), ConfigUISchemaOutput), method(object({
@@ -57582,13 +57915,11 @@ var HeroConfirmSchema = _enum([
57582
57915
  "press"
57583
57916
  ]);
57584
57917
  var HeroActionSchema = object({
57585
- /** Unique within the model; the `gated` list and the specs name it. */
57586
57918
  id: string(),
57587
57919
  label: HeroTextSchema,
57588
57920
  icon: IconKeySchema,
57589
57921
  call: HeroCallSchema,
57590
57922
  emphasis: _enum(["primary", "normal"]),
57591
- /** Ask before running it. */
57592
57923
  confirm: HeroConfirmSchema.nullable()
57593
57924
  });
57594
57925
  var HeroControlSchema = discriminatedUnion("kind", [
@@ -57639,6 +57970,8 @@ var HeroPillSchema = object({
57639
57970
  });
57640
57971
  var HeroRowSchema = object({
57641
57972
  id: HeroRowIdSchema,
57973
+ /** `scene`: the row's action and slider controls are drawn on the scene. Absent: an ordinary row. */
57974
+ placement: _enum(["row", "scene"]).optional(),
57642
57975
  /** The row's own name when the kind's label would not tell rows of one kind apart (a circuit's label). */
57643
57976
  label: HeroTextSchema.optional(),
57644
57977
  /** A group header drawn above the row when it differs from the previous row's ("System"). */
@@ -57669,9 +58002,16 @@ var HeroBadgeSchema = object({
57669
58002
  value: number$1().nullable(),
57670
58003
  label: HeroTextSchema
57671
58004
  });
57672
- var HeroRemoteSlotSchema = object({
57673
- /** Saved commands; `null` = not known yet (the button still shows). */
57674
- commands: number$1().int().nullable() });
58005
+ var HeroRemoteSlotSchema = object({
58006
+ /** Saved commands; `null` = not known yet (the button still shows). */
58007
+ commands: number$1().int().nullable(),
58008
+ /**
58009
+ * The control a list row draws as the "open the remote" icon. Recognised by its id
58010
+ * ({@link REMOTE_OPEN_ACTION_ID}); it changes no state, so a client opens the remote
58011
+ * instead of running `call`. Absent on a model from an older server.
58012
+ */
58013
+ open: HeroActionSchema.optional()
58014
+ });
57675
58015
  var HeroConsumablesSlotSchema = object({
57676
58016
  items: array(object({
57677
58017
  key: string(),
@@ -57839,6 +58179,8 @@ var HeroModelSchema = object({
57839
58179
  * the FIRST row that has any (a later row's control is never promoted). When
57840
58180
  * the model lists that part in `gated`, the row has no inline control: the
57841
58181
  * projection never falls through to another control the caller could use.
58182
+ * - a climate or thermostat row's primary is its `climate.mode` control (no power
58183
+ * toggle: "off" is a mode); when the model gates it the rule above applies as before;
57842
58184
  * - a timed run, when the model carries the slot, sits beside that primary:
57843
58185
  * Run while idle, Stop while armed. Gating the slot hides the control.
57844
58186
  * - the status line is the head (what plays, else the state) plus at most
@@ -57846,6 +58188,13 @@ var HeroModelSchema = object({
57846
58188
  * time left on an armed timed run;
57847
58189
  * - the trailing fact is the first of power, battery, consumables.
57848
58190
  *
58191
+ * - `extras` are the further inline controls of the types that carry more than one
58192
+ * ({@link ROW_EXTRAS_BY_TYPE}): climate setpoint, a robot's return to base,
58193
+ * a player's volume and remote. Each is a control the model already has, named by id,
58194
+ * in that order and at most {@link ROW_EXTRAS_MAX}; one the model lacks, or lists in
58195
+ * `gated`, is absent, and the one `primary` already is never repeats. Empty = the
58196
+ * row of an older server: `primary` alone.
58197
+ *
57849
58198
  * `projectDeviceRow` is pure and computes nothing: it selects from a
57850
58199
  * {@link HeroModel}. A row that needed a value the hero lacks would mean the
57851
58200
  * model is missing it, so the fix goes in the model.
@@ -57877,8 +58226,16 @@ var HeroRowModelSchema = object({
57877
58226
  * while armed. `null` when there is no slot, or the caller may not act.
57878
58227
  */
57879
58228
  timedRun: HeroRowTimedRunSchema.nullable(),
58229
+ /**
58230
+ * The further inline controls after `primary`, in order (see the header). The remote
58231
+ * is an `action` with id `remote.open`: the client opens the remote, it does not run
58232
+ * the call. Absent or empty = `primary` alone.
58233
+ */
58234
+ extras: array(HeroControlSchema).max(2).optional(),
57880
58235
  trailing: HeroFactSchema.nullable()
57881
58236
  });
58237
+ DeviceType.Climate, DeviceType.Thermostat;
58238
+ DeviceType.Climate, DeviceType.Thermostat, DeviceType.Vacuum, DeviceType.LawnMower, DeviceType.MediaPlayer;
57882
58239
  /**
57883
58240
  * hero-layout — what a device's hero says (D1023). Read-only: the FIXED
57884
58241
  * layouts live in `@camstack/types` and nothing here stores or edits one.
@@ -69428,13 +69785,23 @@ var NcRuleTargetSchema = object({
69428
69785
  */
69429
69786
  params: record(string(), unknown()).optional()
69430
69787
  });
69788
+ /** Which picture kind one target receives (#487). */
69789
+ var NcTargetAttachmentSchema = _enum([
69790
+ "none",
69791
+ "image",
69792
+ "clip",
69793
+ "gif"
69794
+ ]);
69431
69795
  var NcTargetOverrideSchema = object({
69432
69796
  template: object({
69433
69797
  title: string().max(500).optional(),
69434
69798
  body: string().max(2e3).optional()
69435
69799
  }).optional(),
69436
69800
  schedule: NcScheduleSchema.optional(),
69437
- priority: number$1().int().min(1).max(5).optional()
69801
+ priority: number$1().int().min(1).max(5).optional(),
69802
+ attachment: NcTargetAttachmentSchema.optional(),
69803
+ /** `false` = no buttons for this target; `true` is the same as absent. */
69804
+ actions: boolean().optional()
69438
69805
  });
69439
69806
  /** Per-target settings keyed by target id (#487). */
69440
69807
  var NcTargetOverridesSchema = record(string(), NcTargetOverrideSchema);
@@ -73472,18 +73839,18 @@ var powerSourceCapability = {
73472
73839
  mode: "singleton",
73473
73840
  deviceTypes: POWER_SOURCE_DEVICE_TYPES,
73474
73841
  methods: {
73475
- getStatus: systemMethod(deviceInput$1, PowerSourceInfoSchema, { auth: "admin" }),
73842
+ getStatus: systemMethod(deviceInput$1, PowerSourceInfoSchema, { auth: "protected" }),
73476
73843
  powerOn: systemMethod(deviceInput$1, PowerSourceActionResultSchema, {
73477
73844
  kind: "mutation",
73478
- auth: "admin"
73845
+ auth: "protected"
73479
73846
  }),
73480
73847
  powerOff: systemMethod(deviceInput$1, PowerSourceActionResultSchema, {
73481
73848
  kind: "mutation",
73482
- auth: "admin"
73849
+ auth: "protected"
73483
73850
  }),
73484
73851
  forceRestart: systemMethod(deviceInput$1, PowerSourceActionResultSchema, {
73485
73852
  kind: "mutation",
73486
- auth: "admin"
73853
+ auth: "protected"
73487
73854
  })
73488
73855
  },
73489
73856
  runtimeState: PowerSourceStateSchema,
@@ -88233,6 +88600,27 @@ Object.freeze({
88233
88600
  access: "create",
88234
88601
  role: "viewer"
88235
88602
  },
88603
+ "clusterUpdate.getClusterUpdateJob": {
88604
+ capName: "cluster-update",
88605
+ capScope: "system",
88606
+ addonId: null,
88607
+ access: "view",
88608
+ role: "admin"
88609
+ },
88610
+ "clusterUpdate.previewClusterUpdate": {
88611
+ capName: "cluster-update",
88612
+ capScope: "system",
88613
+ addonId: null,
88614
+ access: "view",
88615
+ role: "admin"
88616
+ },
88617
+ "clusterUpdate.startClusterUpdate": {
88618
+ capName: "cluster-update",
88619
+ capScope: "system",
88620
+ addonId: null,
88621
+ access: "create",
88622
+ role: "admin"
88623
+ },
88236
88624
  "color.getStatus": {
88237
88625
  capName: "color",
88238
88626
  capScope: "device",
@@ -89605,6 +89993,13 @@ Object.freeze({
89605
89993
  access: "create",
89606
89994
  role: "admin"
89607
89995
  },
89996
+ "deviceManager.search": {
89997
+ capName: "device-manager",
89998
+ capScope: "system",
89999
+ addonId: null,
90000
+ access: "view",
90001
+ role: "viewer"
90002
+ },
89608
90003
  "deviceManager.setAlias": {
89609
90004
  capName: "device-manager",
89610
90005
  capScope: "system",
@@ -89696,6 +90091,13 @@ Object.freeze({
89696
90091
  access: "create",
89697
90092
  role: "admin"
89698
90093
  },
90094
+ "deviceManager.setPrimaryChildPreference": {
90095
+ capName: "device-manager",
90096
+ capScope: "system",
90097
+ addonId: null,
90098
+ access: "create",
90099
+ role: "admin"
90100
+ },
89699
90101
  "deviceManager.setRole": {
89700
90102
  capName: "device-manager",
89701
90103
  capScope: "system",
@@ -94335,28 +94737,28 @@ Object.freeze({
94335
94737
  capScope: "device",
94336
94738
  addonId: null,
94337
94739
  access: "create",
94338
- role: "admin"
94740
+ role: "viewer"
94339
94741
  },
94340
94742
  "powerSource.getStatus": {
94341
94743
  capName: "power-source",
94342
94744
  capScope: "device",
94343
94745
  addonId: null,
94344
94746
  access: "view",
94345
- role: "admin"
94747
+ role: "viewer"
94346
94748
  },
94347
94749
  "powerSource.powerOff": {
94348
94750
  capName: "power-source",
94349
94751
  capScope: "device",
94350
94752
  addonId: null,
94351
94753
  access: "create",
94352
- role: "admin"
94754
+ role: "viewer"
94353
94755
  },
94354
94756
  "powerSource.powerOn": {
94355
94757
  capName: "power-source",
94356
94758
  capScope: "device",
94357
94759
  addonId: null,
94358
94760
  access: "create",
94359
- role: "admin"
94761
+ role: "viewer"
94360
94762
  },
94361
94763
  "presence.getStatus": {
94362
94764
  capName: "presence",
@@ -98220,6 +98622,11 @@ Object.freeze({
98220
98622
  form: "single",
98221
98623
  optional: false
98222
98624
  }],
98625
+ "deviceManager.setPrimaryChildPreference": [{
98626
+ name: "deviceId",
98627
+ form: "single",
98628
+ optional: false
98629
+ }],
98223
98630
  "deviceManager.setRole": [{
98224
98631
  name: "deviceId",
98225
98632
  form: "single",
@@ -101688,7 +102095,9 @@ var TimelapseRuleInputSchema = object({
101688
102095
  /** Classes the notification counts — see {@link ReportClassesField}. */
101689
102096
  reportClasses: ReportClassesField.optional(),
101690
102097
  /** Canonical notification priority ordinal (1..5); per-target overridable. */
101691
- priority: PriorityField.default(3)
102098
+ priority: PriorityField.default(3),
102099
+ /** Per-target settings keyed by target id (D1032) — absent = every target follows the rule. */
102100
+ targetOverrides: NcTargetOverridesSchema.optional()
101692
102101
  });
101693
102102
  object({
101694
102103
  name: NameField.optional(),
@@ -101704,7 +102113,9 @@ object({
101704
102113
  previewText: PreviewTextField.optional(),
101705
102114
  previewMode: PreviewModeField.optional(),
101706
102115
  reportClasses: ReportClassesField.optional(),
101707
- priority: PriorityField.optional()
102116
+ priority: PriorityField.optional(),
102117
+ /** Per-target settings keyed by target id (D1032) — absent = every target follows the rule. */
102118
+ targetOverrides: NcTargetOverridesSchema.optional()
101708
102119
  });
101709
102120
  TimelapseRuleInputSchema.extend({
101710
102121
  id: string(),