@camstack/types 1.2.540 → 1.2.542

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 (34) hide show
  1. package/CHANGELOG.md +18 -4
  2. package/dist/addon.js +1 -1
  3. package/dist/addon.mjs +1 -1
  4. package/dist/capabilities/cluster-update.cap.d.ts +376 -0
  5. package/dist/capabilities/device-manager.cap.d.ts +103 -0
  6. package/dist/capabilities/device-search.d.ts +168 -0
  7. package/dist/capabilities/hero-layout.cap.d.ts +69 -299
  8. package/dist/capabilities/hub-address.d.ts +10 -0
  9. package/dist/capabilities/index.d.ts +6 -3
  10. package/dist/capabilities/notification-rules.cap.d.ts +115 -1
  11. package/dist/client.d.ts +2 -1
  12. package/dist/client.js +54 -8
  13. package/dist/client.mjs +54 -9
  14. package/dist/device/container-primary-child.d.ts +39 -4
  15. package/dist/device/device-management.d.ts +9 -0
  16. package/dist/device/hero/hero-model.d.ts +57 -553
  17. package/dist/device/hero/hero-row.d.ts +76 -69
  18. package/dist/device/hero/index.d.ts +1 -1
  19. package/dist/device/linked-device-resolve.d.ts +2 -0
  20. package/dist/generated/addon-api.d.ts +43 -0
  21. package/dist/generated/capability-router-map.d.ts +5 -2
  22. package/dist/generated/device-proxy.d.ts +1 -1
  23. package/dist/generated/method-access-map.d.ts +1 -1
  24. package/dist/generated/method-device-selectors.d.ts +2 -2
  25. package/dist/generated/system-proxy.d.ts +3 -1
  26. package/dist/index.d.ts +2 -2
  27. package/dist/index.js +592 -29
  28. package/dist/index.mjs +562 -30
  29. package/dist/notification/degrade-engine.d.ts +7 -1
  30. package/dist/notification/notification-fields.d.ts +20 -2
  31. package/dist/notification/timelapse-rule.d.ts +69 -0
  32. package/dist/{sleep-Dz1P6--1.mjs → sleep-Cw1uUXvl.mjs} +3 -0
  33. package/dist/{sleep-DPMn-Sik.js → sleep-PfAAmxV-.js} +3 -0
  34. package/package.json +1 -1
package/CHANGELOG.md CHANGED
@@ -7,6 +7,24 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
7
7
 
8
8
  ## [Unreleased]
9
9
 
10
+ ## [1.2.542] - 2026-11-10
11
+
12
+ ### Changed
13
+
14
+ - Device rows can carry extra inline controls: climate mode and temperature, a robot's return to base, a player's volume and remote
15
+
16
+ ## [1.2.541] - 2026-11-10
17
+
18
+ ### Changed
19
+
20
+ - Hub id format and the hubId key of the hub's LAN announcement
21
+ - New deviceManager.search contract (DeviceSearchInput, DeviceSearchResult, DeviceValueOption) for the device-to-value picker
22
+ - A power source (switch, restart) can now be driven by any user who has access to the camera it powers, not only by administrators
23
+ - New cluster-update capability: preview, start and follow one cluster update job
24
+ - A notification rule's per-target settings now also carry the picture kind (none, image, clip, GIF) and a no-buttons switch, and timelapse, summary and calendar rules accept them.
25
+ - A container can declare which children stand for it, most preferred first (primaryChildPreference); the framework uses it after the operator's own pick and before the type rule
26
+ - The hero model marks scene-placed rows so a client draws their controls beside the animation instead of as rows
27
+
10
28
  ## [1.2.540] - 2026-11-10
11
29
 
12
30
  ### Added
@@ -28,12 +46,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
28
46
 
29
47
  ### Added
30
48
 
31
-
32
49
  ### Changed
33
50
 
34
-
35
-
36
-
37
51
  ## [1.2.538] - 2026-11-10
38
52
 
39
53
  ### Changed
package/dist/addon.js CHANGED
@@ -1,5 +1,5 @@
1
1
  Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
2
- const require_sleep = require("./sleep-DPMn-Sik.js");
2
+ const require_sleep = require("./sleep-PfAAmxV-.js");
3
3
  const require_event_category = require("./event-category-BC4RRerT.js");
4
4
  const require_composed_stable_id = require("./composed-stable-id-BtaMj_W7.js");
5
5
  //#region src/generated/cap-input-defaults.ts
package/dist/addon.mjs CHANGED
@@ -1,4 +1,4 @@
1
- import { $ as DEVICE_CHILDREN_BATCH_MAX, $r as RECORD_DATABASES, A as CAP_ADVANCE_FIELDS, Ai as RecordSecretUnavailableError, An as CALLER_USERNAME_HEADER, Ar as nodeIdOfScopedKey, Bn as RecordKindNameSchema, Ci as FilterRequiredError, Cn as scrubKnownSecrets, Ct as createDebugEmitter, Di as PlaintextSecretError, Dn as PEER_BYTES_STALL_MS, Ei as NoCallerError, En as PEER_BYTES_MAX_OUTSTANDING, F as withoutCallerStamp, Fi as TransactRefusedError, Fn as entryBody, G as readNodePin, Gn as defineRecordKinds, Gr as parseSecretPath, H as commandOrigin, Hn as StoredRecordKindDeclarationSchema, Hr as REMOVE_LEAF, I as customAction, Ii as UnindexedFilterError, In as EntryDescriptorSchema, J as PipelineRunResultBridge, Jn as isZodSecret, Jr as recordSecretRef, Kr as recordArrayItemPath, L as defineCustomActions, Li as UnknownRecordKindError, Ln as RecordFieldPathSchema, Mi as RecordUniqueViolationError, Mr as resolvedValues, N as CAP_STATE_LEAVES, Ni as RecordsError, Nn as DisposerChain, O as HF_REPO, Oi as RECORDS_ERROR_CODES, On as PEER_BYTES_TICKET_TTL_MS, P as CALLER_STAMPED_CAPABILITIES, Pi as RevConflictError, Pn as defineEntryKind, Q as deviceOpsCapability, Qr as RECORD_CLASSES, R as describeCustomActions, Ri as asRecordsError, Rn as RecordIndexSchema, Sa as findMigrationsBlocked, Si as DeclarationRefusedError, Sn as registerKnownSecret, T as isCommand, Ti as InvalidRecordError, Tn as PEER_BYTES_CHUNK_BYTES, U as nodePin, Un as assertValidDeclaration, Ur as collectSecretLeaves, Vn as RecordRetentionSchema, Vr as secretViewsOf, W as readCommandOrigin, Wn as declarationsOf, Wr as mapSecretLeaves, X as MIGRATION_API_VERSION, Xi as emitReadiness, Xr as RECORD_BATCH_MAX, Y as PipelineStepInputSchema, Yi as createEvent, Yr as secretArrayPrefixes, Zr as RECORD_BATCH_MAX_BYTES, _i as parseSecretRef, _n as createSecretsAccess, ai as RECORD_MAX_INDEX_FIELDS, bn as forgetKnownSecret, c as asString, ca as isSecretClear, ci as RECORD_SETTINGS_MAX_ROWS, d as parseJsonUnknown, da as isSecretMarkerLike, di as arrayItemFieldPath, dn as ruleFireOfClaim, dr as ErrorI18nPayloadSchema, dt as ReadinessRegistry, ei as RECORD_DEFAULT_MAX_DATA_BYTES, et as adminUiCapability, f as hfModelUrl, fa as makeSecretMarker, fi as buildSecretRef, fn as makeInMemoryRecords, ft as ReadinessTimeoutError, g as createDeviceProxy, gi as normalizeSecretOwner, gn as REVALIDATE_AFTER_MS, gr as BaseAddon, h as isDeviceScopedCap, hi as isSecretRef, hn as resolveSecretViewsIn, ht as scopeKey, ii as RECORD_MAX_INDEXES, j as CAP_METHOD_TIMEOUTS_MS, ji as RecordTooLargeError, jn as DATAPLANE_SECRET_HEADER, jr as resolveDeviceSettings, ki as RecordNotFoundError, kr as SCOPED_SETTINGS_SCOPES, la as isSecretFieldView, li as RECORD_SWEEP_INTERVAL_MS, ln as CommandOriginClaimSchema, m as DEVICE_SCOPED_CAPS, mi as globalSecretScope, mn as assertTransactScope, mr as readErrorI18n, ni as RECORD_ID_MAX_LENGTH, nr as expandCapMethods, nt as addonPagesSourceCapability, o as asJsonObject, oa as SECRET_CLEAR, oi as RECORD_QUERY_MAX, p as BOOT_RECOVERY_BACKOFF_MS, pa as toSecretFieldView, pi as formatSecretScope, pn as createRecordsAccess, q as viewerUiCapability, qn as collectZodSecretPaths, qr as recordSecretCollection, r as maskUrlCredentials, ri as RECORD_MAX_DATA_BYTES, sa as classifySecretWrite, si as RECORD_SECRET_COLLECTION_PREFIX, t as sleep, ti as RECORD_DELETE_BATCH, ua as isSecretMarker, ui as SECRET_REF_SCHEME, un as RuleFireOriginSchema, ut as MODEL_FORMATS, v as addonSliceHandleApi, vn as MIN_SCRUBBED_LENGTH, wi as ForeignSecretMarkerError, wn as shortSecretRefHash, xa as AddonMigrationsBlockedError, xi as BatchTooLargeError, xn as knownSecretCount, y as createEventBusSliceSource, yn as clearKnownSecrets, yr as normalizeAddonInitResult, zi as recordsErrorFromMessage, zn as RecordKindDeclarationSchema } from "./sleep-Dz1P6--1.mjs";
1
+ import { $ as DEVICE_CHILDREN_BATCH_MAX, $r as RECORD_DATABASES, A as CAP_ADVANCE_FIELDS, Ai as RecordSecretUnavailableError, An as CALLER_USERNAME_HEADER, Ar as nodeIdOfScopedKey, Bn as RecordKindNameSchema, Ci as FilterRequiredError, Cn as scrubKnownSecrets, Ct as createDebugEmitter, Di as PlaintextSecretError, Dn as PEER_BYTES_STALL_MS, Ei as NoCallerError, En as PEER_BYTES_MAX_OUTSTANDING, F as withoutCallerStamp, Fi as TransactRefusedError, Fn as entryBody, G as readNodePin, Gn as defineRecordKinds, Gr as parseSecretPath, H as commandOrigin, Hn as StoredRecordKindDeclarationSchema, Hr as REMOVE_LEAF, I as customAction, Ii as UnindexedFilterError, In as EntryDescriptorSchema, J as PipelineRunResultBridge, Jn as isZodSecret, Jr as recordSecretRef, Kr as recordArrayItemPath, L as defineCustomActions, Li as UnknownRecordKindError, Ln as RecordFieldPathSchema, Mi as RecordUniqueViolationError, Mr as resolvedValues, N as CAP_STATE_LEAVES, Ni as RecordsError, Nn as DisposerChain, O as HF_REPO, Oi as RECORDS_ERROR_CODES, On as PEER_BYTES_TICKET_TTL_MS, P as CALLER_STAMPED_CAPABILITIES, Pi as RevConflictError, Pn as defineEntryKind, Q as deviceOpsCapability, Qr as RECORD_CLASSES, R as describeCustomActions, Ri as asRecordsError, Rn as RecordIndexSchema, Sa as findMigrationsBlocked, Si as DeclarationRefusedError, Sn as registerKnownSecret, T as isCommand, Ti as InvalidRecordError, Tn as PEER_BYTES_CHUNK_BYTES, U as nodePin, Un as assertValidDeclaration, Ur as collectSecretLeaves, Vn as RecordRetentionSchema, Vr as secretViewsOf, W as readCommandOrigin, Wn as declarationsOf, Wr as mapSecretLeaves, X as MIGRATION_API_VERSION, Xi as emitReadiness, Xr as RECORD_BATCH_MAX, Y as PipelineStepInputSchema, Yi as createEvent, Yr as secretArrayPrefixes, Zr as RECORD_BATCH_MAX_BYTES, _i as parseSecretRef, _n as createSecretsAccess, ai as RECORD_MAX_INDEX_FIELDS, bn as forgetKnownSecret, c as asString, ca as isSecretClear, ci as RECORD_SETTINGS_MAX_ROWS, d as parseJsonUnknown, da as isSecretMarkerLike, di as arrayItemFieldPath, dn as ruleFireOfClaim, dr as ErrorI18nPayloadSchema, dt as ReadinessRegistry, ei as RECORD_DEFAULT_MAX_DATA_BYTES, et as adminUiCapability, f as hfModelUrl, fa as makeSecretMarker, fi as buildSecretRef, fn as makeInMemoryRecords, ft as ReadinessTimeoutError, g as createDeviceProxy, gi as normalizeSecretOwner, gn as REVALIDATE_AFTER_MS, gr as BaseAddon, h as isDeviceScopedCap, hi as isSecretRef, hn as resolveSecretViewsIn, ht as scopeKey, ii as RECORD_MAX_INDEXES, j as CAP_METHOD_TIMEOUTS_MS, ji as RecordTooLargeError, jn as DATAPLANE_SECRET_HEADER, jr as resolveDeviceSettings, ki as RecordNotFoundError, kr as SCOPED_SETTINGS_SCOPES, la as isSecretFieldView, li as RECORD_SWEEP_INTERVAL_MS, ln as CommandOriginClaimSchema, m as DEVICE_SCOPED_CAPS, mi as globalSecretScope, mn as assertTransactScope, mr as readErrorI18n, ni as RECORD_ID_MAX_LENGTH, nr as expandCapMethods, nt as addonPagesSourceCapability, o as asJsonObject, oa as SECRET_CLEAR, oi as RECORD_QUERY_MAX, p as BOOT_RECOVERY_BACKOFF_MS, pa as toSecretFieldView, pi as formatSecretScope, pn as createRecordsAccess, q as viewerUiCapability, qn as collectZodSecretPaths, qr as recordSecretCollection, r as maskUrlCredentials, ri as RECORD_MAX_DATA_BYTES, sa as classifySecretWrite, si as RECORD_SECRET_COLLECTION_PREFIX, t as sleep, ti as RECORD_DELETE_BATCH, ua as isSecretMarker, ui as SECRET_REF_SCHEME, un as RuleFireOriginSchema, ut as MODEL_FORMATS, v as addonSliceHandleApi, vn as MIN_SCRUBBED_LENGTH, wi as ForeignSecretMarkerError, wn as shortSecretRefHash, xa as AddonMigrationsBlockedError, xi as BatchTooLargeError, xn as knownSecretCount, y as createEventBusSliceSource, yn as clearKnownSecrets, yr as normalizeAddonInitResult, zi as recordsErrorFromMessage, zn as RecordKindDeclarationSchema } from "./sleep-Cw1uUXvl.mjs";
2
2
  import { t as EventCategory } from "./event-category-78tcBemo.mjs";
3
3
  import { a as DeviceType, s as errMsg, t as COMPOSED_DEVICE_STABLE_ID_PREFIX } from "./composed-stable-id-jnvhwGoH.mjs";
4
4
  //#region src/generated/cap-input-defaults.ts
@@ -0,0 +1,376 @@
1
+ import { z } from 'zod';
2
+ import { type InferProvider } from './capability-definition.js';
3
+ /**
4
+ * cluster-update — the ONE flow that brings the whole cluster to a release
5
+ * (planning#493). Hub-provided (`server-provided`), hub-only: the hub runs
6
+ * the sequence itself, so the admin UI, the MCP and the CLI all start the same
7
+ * job and read the same report instead of each driving their own loop.
8
+ *
9
+ * 1. backup (`backup.trigger`) — skipped only when the caller says so
10
+ * 2. the hub's server closure (`applyServerUpdate`); the hub restarts and the
11
+ * job RESUMES on the new boot, verified against the hub's running version
12
+ * 3. every online agent behind the target, one at a time, verified: runs the
13
+ * target, settled, online, and its capabilities registered (D848) — an
14
+ * agent that comes back capless is a FAILED step, never a done one
15
+ * 4. every stale addon on the hub (`addons.updatePackage`); agents follow by
16
+ * reconciliation, which is verified, never pushed
17
+ *
18
+ * The job stops on the first failed step with a typed reason (D877). Its state
19
+ * is durable on the hub and read by RPC (`getClusterUpdateJob`) — events are
20
+ * telemetry and never carry it (D8, D11).
21
+ */
22
+ /** The steps, in the order they run. */
23
+ declare const ClusterUpdateStepKindSchema: z.ZodEnum<{
24
+ addons: "addons";
25
+ "agent-server": "agent-server";
26
+ backup: "backup";
27
+ "hub-server": "hub-server";
28
+ }>;
29
+ /**
30
+ * - `pending` — not reached yet.
31
+ * - `running` — in progress (for `hub-server`: possibly across the restart).
32
+ * - `ok` — done AND verified.
33
+ * - `failed` — did not land; `reason` + `detail` say why. Stops the job.
34
+ * - `skipped` — not run: nothing to do, opted out, the node is offline, or a
35
+ * step before it failed. `detail` says which.
36
+ */
37
+ declare const ClusterUpdateStepStatusSchema: z.ZodEnum<{
38
+ failed: "failed";
39
+ ok: "ok";
40
+ pending: "pending";
41
+ running: "running";
42
+ skipped: "skipped";
43
+ }>;
44
+ /**
45
+ * Why a step (and with it the job) failed. Stable, greppable; `detail` carries
46
+ * the prose.
47
+ */
48
+ declare const ClusterUpdateFailureReasonSchema: z.ZodEnum<{
49
+ "addon-update-failed": "addon-update-failed";
50
+ "addons-not-converged": "addons-not-converged";
51
+ "backup-failed": "backup-failed";
52
+ "backup-unavailable": "backup-unavailable";
53
+ interrupted: "interrupted";
54
+ "node-capless": "node-capless";
55
+ "server-not-on-target": "server-not-on-target";
56
+ "server-refused": "server-refused";
57
+ "status-unreadable": "status-unreadable";
58
+ }>;
59
+ declare const ClusterUpdateStepSchema: z.ZodObject<{
60
+ kind: z.ZodEnum<{
61
+ addons: "addons";
62
+ "agent-server": "agent-server";
63
+ backup: "backup";
64
+ "hub-server": "hub-server";
65
+ }>;
66
+ nodeId: z.ZodOptional<z.ZodString>;
67
+ status: z.ZodEnum<{
68
+ failed: "failed";
69
+ ok: "ok";
70
+ pending: "pending";
71
+ running: "running";
72
+ skipped: "skipped";
73
+ }>;
74
+ detail: z.ZodString;
75
+ reason: z.ZodOptional<z.ZodEnum<{
76
+ "addon-update-failed": "addon-update-failed";
77
+ "addons-not-converged": "addons-not-converged";
78
+ "backup-failed": "backup-failed";
79
+ "backup-unavailable": "backup-unavailable";
80
+ interrupted: "interrupted";
81
+ "node-capless": "node-capless";
82
+ "server-not-on-target": "server-not-on-target";
83
+ "server-refused": "server-refused";
84
+ "status-unreadable": "status-unreadable";
85
+ }>>;
86
+ fromVersion: z.ZodOptional<z.ZodNullable<z.ZodString>>;
87
+ packages: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
88
+ startedAt: z.ZodOptional<z.ZodNumber>;
89
+ finishedAt: z.ZodOptional<z.ZodNumber>;
90
+ }, z.core.$strip>;
91
+ declare const ClusterUpdateJobStateSchema: z.ZodEnum<{
92
+ failed: "failed";
93
+ running: "running";
94
+ succeeded: "succeeded";
95
+ }>;
96
+ declare const ClusterUpdateJobSchema: z.ZodObject<{
97
+ id: z.ZodString;
98
+ state: z.ZodEnum<{
99
+ failed: "failed";
100
+ running: "running";
101
+ succeeded: "succeeded";
102
+ }>;
103
+ targetVersion: z.ZodString;
104
+ requestedBy: z.ZodString;
105
+ startedAt: z.ZodNumber;
106
+ finishedAt: z.ZodOptional<z.ZodNumber>;
107
+ steps: z.ZodReadonly<z.ZodArray<z.ZodObject<{
108
+ kind: z.ZodEnum<{
109
+ addons: "addons";
110
+ "agent-server": "agent-server";
111
+ backup: "backup";
112
+ "hub-server": "hub-server";
113
+ }>;
114
+ nodeId: z.ZodOptional<z.ZodString>;
115
+ status: z.ZodEnum<{
116
+ failed: "failed";
117
+ ok: "ok";
118
+ pending: "pending";
119
+ running: "running";
120
+ skipped: "skipped";
121
+ }>;
122
+ detail: z.ZodString;
123
+ reason: z.ZodOptional<z.ZodEnum<{
124
+ "addon-update-failed": "addon-update-failed";
125
+ "addons-not-converged": "addons-not-converged";
126
+ "backup-failed": "backup-failed";
127
+ "backup-unavailable": "backup-unavailable";
128
+ interrupted: "interrupted";
129
+ "node-capless": "node-capless";
130
+ "server-not-on-target": "server-not-on-target";
131
+ "server-refused": "server-refused";
132
+ "status-unreadable": "status-unreadable";
133
+ }>>;
134
+ fromVersion: z.ZodOptional<z.ZodNullable<z.ZodString>>;
135
+ packages: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
136
+ startedAt: z.ZodOptional<z.ZodNumber>;
137
+ finishedAt: z.ZodOptional<z.ZodNumber>;
138
+ }, z.core.$strip>>>;
139
+ stoppedAt: z.ZodOptional<z.ZodString>;
140
+ reason: z.ZodOptional<z.ZodEnum<{
141
+ "addon-update-failed": "addon-update-failed";
142
+ "addons-not-converged": "addons-not-converged";
143
+ "backup-failed": "backup-failed";
144
+ "backup-unavailable": "backup-unavailable";
145
+ interrupted: "interrupted";
146
+ "node-capless": "node-capless";
147
+ "server-not-on-target": "server-not-on-target";
148
+ "server-refused": "server-refused";
149
+ "status-unreadable": "status-unreadable";
150
+ }>>;
151
+ skippedOffline: z.ZodReadonly<z.ZodArray<z.ZodString>>;
152
+ }, z.core.$strip>;
153
+ declare const ClusterUpdateOptionsSchema: z.ZodObject<{
154
+ version: z.ZodOptional<z.ZodString>;
155
+ addons: z.ZodOptional<z.ZodBoolean>;
156
+ backup: z.ZodOptional<z.ZodBoolean>;
157
+ }, z.core.$strip>;
158
+ /** Why a plan cannot start. */
159
+ declare const ClusterUpdateBlockerSchema: z.ZodEnum<{
160
+ "job-running": "job-running";
161
+ "no-target": "no-target";
162
+ "node-busy": "node-busy";
163
+ "nothing-to-do": "nothing-to-do";
164
+ "status-unreadable": "status-unreadable";
165
+ }>;
166
+ declare const ClusterUpdatePlanSchema: z.ZodObject<{
167
+ targetVersion: z.ZodNullable<z.ZodString>;
168
+ steps: z.ZodReadonly<z.ZodArray<z.ZodObject<{
169
+ kind: z.ZodEnum<{
170
+ addons: "addons";
171
+ "agent-server": "agent-server";
172
+ backup: "backup";
173
+ "hub-server": "hub-server";
174
+ }>;
175
+ nodeId: z.ZodOptional<z.ZodString>;
176
+ status: z.ZodEnum<{
177
+ failed: "failed";
178
+ ok: "ok";
179
+ pending: "pending";
180
+ running: "running";
181
+ skipped: "skipped";
182
+ }>;
183
+ detail: z.ZodString;
184
+ reason: z.ZodOptional<z.ZodEnum<{
185
+ "addon-update-failed": "addon-update-failed";
186
+ "addons-not-converged": "addons-not-converged";
187
+ "backup-failed": "backup-failed";
188
+ "backup-unavailable": "backup-unavailable";
189
+ interrupted: "interrupted";
190
+ "node-capless": "node-capless";
191
+ "server-not-on-target": "server-not-on-target";
192
+ "server-refused": "server-refused";
193
+ "status-unreadable": "status-unreadable";
194
+ }>>;
195
+ fromVersion: z.ZodOptional<z.ZodNullable<z.ZodString>>;
196
+ packages: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
197
+ startedAt: z.ZodOptional<z.ZodNumber>;
198
+ finishedAt: z.ZodOptional<z.ZodNumber>;
199
+ }, z.core.$strip>>>;
200
+ skippedOffline: z.ZodReadonly<z.ZodArray<z.ZodString>>;
201
+ blocker: z.ZodNullable<z.ZodEnum<{
202
+ "job-running": "job-running";
203
+ "no-target": "no-target";
204
+ "node-busy": "node-busy";
205
+ "nothing-to-do": "nothing-to-do";
206
+ "status-unreadable": "status-unreadable";
207
+ }>>;
208
+ blockerDetail: z.ZodNullable<z.ZodString>;
209
+ }, z.core.$strip>;
210
+ declare const StartClusterUpdateResultSchema: z.ZodObject<{
211
+ accepted: z.ZodBoolean;
212
+ jobId: z.ZodNullable<z.ZodString>;
213
+ blocker: z.ZodNullable<z.ZodEnum<{
214
+ "job-running": "job-running";
215
+ "no-target": "no-target";
216
+ "node-busy": "node-busy";
217
+ "nothing-to-do": "nothing-to-do";
218
+ "status-unreadable": "status-unreadable";
219
+ }>>;
220
+ message: z.ZodString;
221
+ }, z.core.$strip>;
222
+ export declare const clusterUpdateCapability: {
223
+ readonly name: 'cluster-update';
224
+ readonly scope: 'system';
225
+ readonly mode: 'singleton';
226
+ readonly methods: {
227
+ /** What `startClusterUpdate` would do now, and whether it can start. Reads only. */
228
+ readonly previewClusterUpdate: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
229
+ version: z.ZodOptional<z.ZodString>;
230
+ addons: z.ZodOptional<z.ZodBoolean>;
231
+ backup: z.ZodOptional<z.ZodBoolean>;
232
+ }, z.core.$strip>, z.ZodObject<{
233
+ targetVersion: z.ZodNullable<z.ZodString>;
234
+ steps: z.ZodReadonly<z.ZodArray<z.ZodObject<{
235
+ kind: z.ZodEnum<{
236
+ addons: "addons";
237
+ "agent-server": "agent-server";
238
+ backup: "backup";
239
+ "hub-server": "hub-server";
240
+ }>;
241
+ nodeId: z.ZodOptional<z.ZodString>;
242
+ status: z.ZodEnum<{
243
+ failed: "failed";
244
+ ok: "ok";
245
+ pending: "pending";
246
+ running: "running";
247
+ skipped: "skipped";
248
+ }>;
249
+ detail: z.ZodString;
250
+ reason: z.ZodOptional<z.ZodEnum<{
251
+ "addon-update-failed": "addon-update-failed";
252
+ "addons-not-converged": "addons-not-converged";
253
+ "backup-failed": "backup-failed";
254
+ "backup-unavailable": "backup-unavailable";
255
+ interrupted: "interrupted";
256
+ "node-capless": "node-capless";
257
+ "server-not-on-target": "server-not-on-target";
258
+ "server-refused": "server-refused";
259
+ "status-unreadable": "status-unreadable";
260
+ }>>;
261
+ fromVersion: z.ZodOptional<z.ZodNullable<z.ZodString>>;
262
+ packages: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
263
+ startedAt: z.ZodOptional<z.ZodNumber>;
264
+ finishedAt: z.ZodOptional<z.ZodNumber>;
265
+ }, z.core.$strip>>>;
266
+ skippedOffline: z.ZodReadonly<z.ZodArray<z.ZodString>>;
267
+ blocker: z.ZodNullable<z.ZodEnum<{
268
+ "job-running": "job-running";
269
+ "no-target": "no-target";
270
+ "node-busy": "node-busy";
271
+ "nothing-to-do": "nothing-to-do";
272
+ "status-unreadable": "status-unreadable";
273
+ }>>;
274
+ blockerDetail: z.ZodNullable<z.ZodString>;
275
+ }, z.core.$strip>, import("./capability-definition.js").CapabilityMethodKind>;
276
+ /**
277
+ * Start the job and return at once with its id; the job runs on the hub
278
+ * (minutes to hours, across the hub's own restart). Refused, with a
279
+ * `blocker`, when the plan cannot start — one job at a time.
280
+ */
281
+ readonly startClusterUpdate: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
282
+ version: z.ZodOptional<z.ZodString>;
283
+ addons: z.ZodOptional<z.ZodBoolean>;
284
+ backup: z.ZodOptional<z.ZodBoolean>;
285
+ }, z.core.$strip>, z.ZodObject<{
286
+ accepted: z.ZodBoolean;
287
+ jobId: z.ZodNullable<z.ZodString>;
288
+ blocker: z.ZodNullable<z.ZodEnum<{
289
+ "job-running": "job-running";
290
+ "no-target": "no-target";
291
+ "node-busy": "node-busy";
292
+ "nothing-to-do": "nothing-to-do";
293
+ "status-unreadable": "status-unreadable";
294
+ }>>;
295
+ message: z.ZodString;
296
+ }, z.core.$strip>, "mutation">;
297
+ /**
298
+ * A job's state. Without `jobId`: the latest job, or `null` when none ever
299
+ * ran. Survives the hub restart the job itself causes.
300
+ */
301
+ readonly getClusterUpdateJob: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
302
+ jobId: z.ZodOptional<z.ZodString>;
303
+ }, z.core.$strip>, z.ZodNullable<z.ZodObject<{
304
+ id: z.ZodString;
305
+ state: z.ZodEnum<{
306
+ failed: "failed";
307
+ running: "running";
308
+ succeeded: "succeeded";
309
+ }>;
310
+ targetVersion: z.ZodString;
311
+ requestedBy: z.ZodString;
312
+ startedAt: z.ZodNumber;
313
+ finishedAt: z.ZodOptional<z.ZodNumber>;
314
+ steps: z.ZodReadonly<z.ZodArray<z.ZodObject<{
315
+ kind: z.ZodEnum<{
316
+ addons: "addons";
317
+ "agent-server": "agent-server";
318
+ backup: "backup";
319
+ "hub-server": "hub-server";
320
+ }>;
321
+ nodeId: z.ZodOptional<z.ZodString>;
322
+ status: z.ZodEnum<{
323
+ failed: "failed";
324
+ ok: "ok";
325
+ pending: "pending";
326
+ running: "running";
327
+ skipped: "skipped";
328
+ }>;
329
+ detail: z.ZodString;
330
+ reason: z.ZodOptional<z.ZodEnum<{
331
+ "addon-update-failed": "addon-update-failed";
332
+ "addons-not-converged": "addons-not-converged";
333
+ "backup-failed": "backup-failed";
334
+ "backup-unavailable": "backup-unavailable";
335
+ interrupted: "interrupted";
336
+ "node-capless": "node-capless";
337
+ "server-not-on-target": "server-not-on-target";
338
+ "server-refused": "server-refused";
339
+ "status-unreadable": "status-unreadable";
340
+ }>>;
341
+ fromVersion: z.ZodOptional<z.ZodNullable<z.ZodString>>;
342
+ packages: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
343
+ startedAt: z.ZodOptional<z.ZodNumber>;
344
+ finishedAt: z.ZodOptional<z.ZodNumber>;
345
+ }, z.core.$strip>>>;
346
+ stoppedAt: z.ZodOptional<z.ZodString>;
347
+ reason: z.ZodOptional<z.ZodEnum<{
348
+ "addon-update-failed": "addon-update-failed";
349
+ "addons-not-converged": "addons-not-converged";
350
+ "backup-failed": "backup-failed";
351
+ "backup-unavailable": "backup-unavailable";
352
+ interrupted: "interrupted";
353
+ "node-capless": "node-capless";
354
+ "server-not-on-target": "server-not-on-target";
355
+ "server-refused": "server-refused";
356
+ "status-unreadable": "status-unreadable";
357
+ }>>;
358
+ skippedOffline: z.ZodReadonly<z.ZodArray<z.ZodString>>;
359
+ }, z.core.$strip>>, import("./capability-definition.js").CapabilityMethodKind>;
360
+ };
361
+ readonly mount: {
362
+ readonly kind: 'server-provided';
363
+ };
364
+ };
365
+ export type IClusterUpdateProvider = InferProvider<typeof clusterUpdateCapability>;
366
+ export type ClusterUpdateStepKind = z.infer<typeof ClusterUpdateStepKindSchema>;
367
+ export type ClusterUpdateStepStatus = z.infer<typeof ClusterUpdateStepStatusSchema>;
368
+ export type ClusterUpdateFailureReason = z.infer<typeof ClusterUpdateFailureReasonSchema>;
369
+ export type ClusterUpdateStep = z.infer<typeof ClusterUpdateStepSchema>;
370
+ export type ClusterUpdateJobState = z.infer<typeof ClusterUpdateJobStateSchema>;
371
+ export type ClusterUpdateJob = z.infer<typeof ClusterUpdateJobSchema>;
372
+ export type ClusterUpdateOptions = z.infer<typeof ClusterUpdateOptionsSchema>;
373
+ export type ClusterUpdateBlocker = z.infer<typeof ClusterUpdateBlockerSchema>;
374
+ export type ClusterUpdatePlan = z.infer<typeof ClusterUpdatePlanSchema>;
375
+ export type StartClusterUpdateResult = z.infer<typeof StartClusterUpdateResultSchema>;
376
+ export { ClusterUpdateStepKindSchema, ClusterUpdateStepStatusSchema, ClusterUpdateFailureReasonSchema, ClusterUpdateStepSchema, ClusterUpdateJobStateSchema, ClusterUpdateJobSchema, ClusterUpdateOptionsSchema, ClusterUpdateBlockerSchema, ClusterUpdatePlanSchema, StartClusterUpdateResultSchema, };
@@ -98,6 +98,7 @@ export declare const DeviceInfoSchema: z.ZodObject<{
98
98
  order: z.ZodOptional<z.ZodNumber>;
99
99
  collapsed: z.ZodOptional<z.ZodBoolean>;
100
100
  }, z.core.$strip>>>>;
101
+ primaryChildPreference: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
101
102
  display: z.ZodOptional<z.ZodObject<{
102
103
  icon: z.ZodOptional<z.ZodString>;
103
104
  label: z.ZodOptional<z.ZodString>;
@@ -282,6 +283,7 @@ export declare const DeviceMetaSchema: z.ZodObject<{
282
283
  order: z.ZodOptional<z.ZodNumber>;
283
284
  collapsed: z.ZodOptional<z.ZodBoolean>;
284
285
  }, z.core.$strip>>>>;
286
+ primaryChildPreference: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
285
287
  role: z.ZodOptional<z.ZodNullable<z.ZodString>>;
286
288
  display: z.ZodOptional<z.ZodObject<{
287
289
  icon: z.ZodOptional<z.ZodString>;
@@ -589,6 +591,7 @@ export declare const deviceManagerCapability: {
589
591
  order: z.ZodOptional<z.ZodNumber>;
590
592
  collapsed: z.ZodOptional<z.ZodBoolean>;
591
593
  }, z.core.$strip>>>>;
594
+ primaryChildPreference: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
592
595
  role: z.ZodOptional<z.ZodNullable<z.ZodString>>;
593
596
  display: z.ZodOptional<z.ZodObject<{
594
597
  icon: z.ZodOptional<z.ZodString>;
@@ -787,6 +790,14 @@ export declare const deviceManagerCapability: {
787
790
  collapsed: z.ZodOptional<z.ZodBoolean>;
788
791
  }, z.core.$strip>>>;
789
792
  }, z.core.$strip>, z.ZodVoid, "mutation">;
793
+ /** Set (or replace) a container's provider-declared primary-child
794
+ * preference: accessory `childKey`s, most preferred first. Mirrors
795
+ * `setChildLayout`; the operator's `primaryChildEntityId` still wins.
796
+ * Persisted, projected, and preserved across re-register/restore. Idempotent. */
797
+ readonly setPrimaryChildPreference: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
798
+ deviceId: z.ZodNumber;
799
+ primaryChildPreference: z.ZodReadonly<z.ZodArray<z.ZodString>>;
800
+ }, z.core.$strip>, z.ZodVoid, "mutation">;
790
801
  /** Set (or clear) the per-device display override on the meta row. Mirrors
791
802
  * `setChildLayout` persistence; `null` clears the override entirely. The
792
803
  * override unit(s) are normalized (`normalizeUnit`) at write so the render
@@ -1139,6 +1150,7 @@ export declare const deviceManagerCapability: {
1139
1150
  order: z.ZodOptional<z.ZodNumber>;
1140
1151
  collapsed: z.ZodOptional<z.ZodBoolean>;
1141
1152
  }, z.core.$strip>>>>;
1153
+ primaryChildPreference: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
1142
1154
  display: z.ZodOptional<z.ZodObject<{
1143
1155
  icon: z.ZodOptional<z.ZodString>;
1144
1156
  label: z.ZodOptional<z.ZodString>;
@@ -1151,6 +1163,94 @@ export declare const deviceManagerCapability: {
1151
1163
  }, z.core.$strip>>>;
1152
1164
  }, z.core.$strip>>;
1153
1165
  }, z.core.$strip>>, import("./capability-definition.js").CapabilityMethodKind>;
1166
+ /**
1167
+ * The device → value picker's one query: filter by text, capability and
1168
+ * location / integration / type, with faceted counts, cursor pagination,
1169
+ * the live reading of each matching value, suggestions by the context
1170
+ * device's location, and `ids` resolution for already-picked values.
1171
+ * See `device-search.ts`. Not in `DEVICE_ENUMERATION_METHODS`: a
1172
+ * device-scoped token is refused rather than shown the whole fleet.
1173
+ */
1174
+ readonly search: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
1175
+ text: z.ZodOptional<z.ZodString>;
1176
+ requires: z.ZodOptional<z.ZodObject<{
1177
+ caps: z.ZodReadonly<z.ZodArray<z.ZodString>>;
1178
+ mode: z.ZodOptional<z.ZodEnum<{
1179
+ all: "all";
1180
+ any: "any";
1181
+ }>>;
1182
+ }, z.core.$strip>>;
1183
+ filters: z.ZodOptional<z.ZodObject<{
1184
+ locations: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
1185
+ integrationIds: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
1186
+ types: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
1187
+ }, z.core.$strip>>;
1188
+ includeIncompatible: z.ZodOptional<z.ZodBoolean>;
1189
+ contextDeviceId: z.ZodOptional<z.ZodNumber>;
1190
+ ids: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodNumber>>>;
1191
+ cursor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
1192
+ limit: z.ZodOptional<z.ZodNumber>;
1193
+ }, z.core.$strip>, z.ZodObject<{
1194
+ items: z.ZodReadonly<z.ZodArray<z.ZodObject<{
1195
+ id: z.ZodNumber;
1196
+ name: z.ZodString;
1197
+ type: z.ZodEnum<typeof DeviceType>;
1198
+ location: z.ZodNullable<z.ZodString>;
1199
+ integrationId: z.ZodNullable<z.ZodString>;
1200
+ integrationLabel: z.ZodNullable<z.ZodString>;
1201
+ online: z.ZodNullable<z.ZodBoolean>;
1202
+ disabled: z.ZodBoolean;
1203
+ compatible: z.ZodBoolean;
1204
+ values: z.ZodReadonly<z.ZodArray<z.ZodObject<{
1205
+ cap: z.ZodString;
1206
+ path: z.ZodString;
1207
+ label: z.ZodString;
1208
+ reading: z.ZodNullable<z.ZodString>;
1209
+ unit: z.ZodOptional<z.ZodNullable<z.ZodString>>;
1210
+ quantity: z.ZodOptional<z.ZodType<"angle" | "apparent-power" | "area" | "bitrate" | "colour-temperature" | "concentration-mass" | "concentration-ppb" | "concentration-volume" | "count" | "current" | "device" | "duration" | "duration-ms" | "energy" | "humidity" | "illuminance" | "index" | "information" | "irradiance" | "length" | "mass" | "none" | "percentage" | "power" | "precipitation" | "precipitation-rate" | "pressure" | "rate" | "ratio" | "signal-level" | "sound-level" | "speed" | "temperature" | "voltage" | "volume", unknown, z.core.$ZodTypeInternals<"angle" | "apparent-power" | "area" | "bitrate" | "colour-temperature" | "concentration-mass" | "concentration-ppb" | "concentration-volume" | "count" | "current" | "device" | "duration" | "duration-ms" | "energy" | "humidity" | "illuminance" | "index" | "information" | "irradiance" | "length" | "mass" | "none" | "percentage" | "power" | "precipitation" | "precipitation-rate" | "pressure" | "rate" | "ratio" | "signal-level" | "sound-level" | "speed" | "temperature" | "voltage" | "volume", unknown>>>;
1211
+ }, z.core.$strip>>>;
1212
+ }, z.core.$strip>>>;
1213
+ nextCursor: z.ZodNullable<z.ZodString>;
1214
+ total: z.ZodNumber;
1215
+ compatibleTotal: z.ZodNumber;
1216
+ fleetTotal: z.ZodNumber;
1217
+ hiddenIncompatible: z.ZodNumber;
1218
+ facets: z.ZodObject<{
1219
+ locations: z.ZodReadonly<z.ZodArray<z.ZodObject<{
1220
+ value: z.ZodString;
1221
+ count: z.ZodNumber;
1222
+ }, z.core.$strip>>>;
1223
+ integrations: z.ZodReadonly<z.ZodArray<z.ZodObject<{
1224
+ id: z.ZodString;
1225
+ label: z.ZodString;
1226
+ count: z.ZodNumber;
1227
+ }, z.core.$strip>>>;
1228
+ types: z.ZodReadonly<z.ZodArray<z.ZodObject<{
1229
+ value: z.ZodString;
1230
+ count: z.ZodNumber;
1231
+ }, z.core.$strip>>>;
1232
+ }, z.core.$strip>;
1233
+ suggested: z.ZodReadonly<z.ZodArray<z.ZodObject<{
1234
+ id: z.ZodNumber;
1235
+ name: z.ZodString;
1236
+ type: z.ZodEnum<typeof DeviceType>;
1237
+ location: z.ZodNullable<z.ZodString>;
1238
+ integrationId: z.ZodNullable<z.ZodString>;
1239
+ integrationLabel: z.ZodNullable<z.ZodString>;
1240
+ online: z.ZodNullable<z.ZodBoolean>;
1241
+ disabled: z.ZodBoolean;
1242
+ compatible: z.ZodBoolean;
1243
+ values: z.ZodReadonly<z.ZodArray<z.ZodObject<{
1244
+ cap: z.ZodString;
1245
+ path: z.ZodString;
1246
+ label: z.ZodString;
1247
+ reading: z.ZodNullable<z.ZodString>;
1248
+ unit: z.ZodOptional<z.ZodNullable<z.ZodString>>;
1249
+ quantity: z.ZodOptional<z.ZodType<"angle" | "apparent-power" | "area" | "bitrate" | "colour-temperature" | "concentration-mass" | "concentration-ppb" | "concentration-volume" | "count" | "current" | "device" | "duration" | "duration-ms" | "energy" | "humidity" | "illuminance" | "index" | "information" | "irradiance" | "length" | "mass" | "none" | "percentage" | "power" | "precipitation" | "precipitation-rate" | "pressure" | "rate" | "ratio" | "signal-level" | "sound-level" | "speed" | "temperature" | "voltage" | "volume", unknown, z.core.$ZodTypeInternals<"angle" | "apparent-power" | "area" | "bitrate" | "colour-temperature" | "concentration-mass" | "concentration-ppb" | "concentration-volume" | "count" | "current" | "device" | "duration" | "duration-ms" | "energy" | "humidity" | "illuminance" | "index" | "information" | "irradiance" | "length" | "mass" | "none" | "percentage" | "power" | "precipitation" | "precipitation-rate" | "pressure" | "rate" | "ratio" | "signal-level" | "sound-level" | "speed" | "temperature" | "voltage" | "volume", unknown>>>;
1250
+ }, z.core.$strip>>>;
1251
+ }, z.core.$strip>>>;
1252
+ missingIds: z.ZodReadonly<z.ZodArray<z.ZodNumber>>;
1253
+ }, z.core.$strip>, import("./capability-definition.js").CapabilityMethodKind>;
1154
1254
  /** Get a single device by numeric deviceId. */
1155
1255
  readonly getDevice: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
1156
1256
  deviceId: z.ZodNumber;
@@ -1193,6 +1293,7 @@ export declare const deviceManagerCapability: {
1193
1293
  order: z.ZodOptional<z.ZodNumber>;
1194
1294
  collapsed: z.ZodOptional<z.ZodBoolean>;
1195
1295
  }, z.core.$strip>>>>;
1296
+ primaryChildPreference: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
1196
1297
  display: z.ZodOptional<z.ZodObject<{
1197
1298
  icon: z.ZodOptional<z.ZodString>;
1198
1299
  label: z.ZodOptional<z.ZodString>;
@@ -1247,6 +1348,7 @@ export declare const deviceManagerCapability: {
1247
1348
  order: z.ZodOptional<z.ZodNumber>;
1248
1349
  collapsed: z.ZodOptional<z.ZodBoolean>;
1249
1350
  }, z.core.$strip>>>>;
1351
+ primaryChildPreference: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
1250
1352
  display: z.ZodOptional<z.ZodObject<{
1251
1353
  icon: z.ZodOptional<z.ZodString>;
1252
1354
  label: z.ZodOptional<z.ZodString>;
@@ -1332,6 +1434,7 @@ export declare const deviceManagerCapability: {
1332
1434
  order: z.ZodOptional<z.ZodNumber>;
1333
1435
  collapsed: z.ZodOptional<z.ZodBoolean>;
1334
1436
  }, z.core.$strip>>>>;
1437
+ primaryChildPreference: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
1335
1438
  display: z.ZodOptional<z.ZodObject<{
1336
1439
  icon: z.ZodOptional<z.ZodString>;
1337
1440
  label: z.ZodOptional<z.ZodString>;