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