@camstack/types 1.2.539 → 1.2.541

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 (58) hide show
  1. package/CHANGELOG.md +29 -0
  2. package/dist/addon.js +44 -12
  3. package/dist/addon.mjs +44 -12
  4. package/dist/capabilities/capability-definition.d.ts +4 -0
  5. package/dist/capabilities/climate-control.cap.d.ts +18 -6
  6. package/dist/capabilities/cluster-update.cap.d.ts +376 -0
  7. package/dist/capabilities/cover.cap.d.ts +9 -3
  8. package/dist/capabilities/device-manager.cap.d.ts +117 -0
  9. package/dist/capabilities/device-search.d.ts +168 -0
  10. package/dist/capabilities/fan-control.cap.d.ts +12 -4
  11. package/dist/capabilities/hero-layout.cap.d.ts +4 -0
  12. package/dist/capabilities/hub-address.d.ts +10 -0
  13. package/dist/capabilities/index.d.ts +8 -5
  14. package/dist/capabilities/lock-control.cap.d.ts +3 -1
  15. package/dist/capabilities/media-player.cap.d.ts +48 -16
  16. package/dist/capabilities/notification-output.cap.d.ts +40 -0
  17. package/dist/capabilities/notification-rules.cap.d.ts +366 -0
  18. package/dist/capabilities/osd-manager.cap.d.ts +40 -277
  19. package/dist/capabilities/valve.cap.d.ts +3 -1
  20. package/dist/client.d.ts +2 -1
  21. package/dist/client.js +94 -8
  22. package/dist/client.mjs +94 -9
  23. package/dist/{composed-stable-id-C3J6LxC9.js → composed-stable-id-BtaMj_W7.js} +4 -0
  24. package/dist/{composed-stable-id-DLcPInGv.mjs → composed-stable-id-jnvhwGoH.mjs} +4 -0
  25. package/dist/device/container-primary-child.d.ts +39 -4
  26. package/dist/device/device-binding.d.ts +6 -0
  27. package/dist/device/device-feature-requirements.d.ts +137 -0
  28. package/dist/device/device-management.d.ts +9 -0
  29. package/dist/device/device-type.d.ts +5 -1
  30. package/dist/device/hero/hero-model.d.ts +14 -0
  31. package/dist/device/implemented-methods.d.ts +6 -0
  32. package/dist/device/linked-device-resolve.d.ts +2 -0
  33. package/dist/expression/device-template.d.ts +31 -1
  34. package/dist/generated/addon-api.d.ts +50 -7
  35. package/dist/generated/capability-router-map.d.ts +5 -2
  36. package/dist/generated/collection-array-methods.d.ts +1 -1
  37. package/dist/generated/device-proxy.d.ts +2 -2
  38. package/dist/generated/method-access-map.d.ts +1 -1
  39. package/dist/generated/method-device-selectors.d.ts +2 -2
  40. package/dist/generated/system-proxy.d.ts +3 -1
  41. package/dist/{composition-BcVAbtBc.js → implemented-methods-C_iV6BiP.js} +17 -1
  42. package/dist/{composition-BFJq1Y88.mjs → implemented-methods-OitwyO1Y.mjs} +12 -2
  43. package/dist/index.d.ts +7 -3
  44. package/dist/index.js +1231 -444
  45. package/dist/index.mjs +944 -203
  46. package/dist/interfaces/addon.d.ts +7 -0
  47. package/dist/interfaces/event-bus.d.ts +2 -0
  48. package/dist/migrations/api/migration-api.v1.d.ts +11 -0
  49. package/dist/migrations/api/migration-api.v1.schema.d.ts +25 -0
  50. package/dist/node.d.ts +1 -0
  51. package/dist/node.js +26 -25
  52. package/dist/node.mjs +3 -3
  53. package/dist/notification/degrade-engine.d.ts +7 -1
  54. package/dist/notification/notification-fields.d.ts +69 -0
  55. package/dist/notification/timelapse-rule.d.ts +69 -0
  56. package/dist/{sleep-VrfKAAGN.mjs → sleep-Cw1uUXvl.mjs} +5 -2
  57. package/dist/{sleep-DgCXXFc3.js → sleep-PfAAmxV-.js} +5 -2
  58. package/package.json +1 -1
@@ -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, };
@@ -59,15 +59,21 @@ export declare const coverCapability: {
59
59
  }, z.core.$strip>, z.ZodVoid, "mutation">;
60
60
  readonly stop: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
61
61
  deviceId: z.ZodNumber;
62
- }, z.core.$strip>, z.ZodVoid, "mutation">;
62
+ }, z.core.$strip>, z.ZodVoid, "mutation"> & {
63
+ readonly providerOptional: true;
64
+ };
63
65
  readonly setPosition: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
64
66
  deviceId: z.ZodNumber;
65
67
  position: z.ZodNumber;
66
- }, z.core.$strip>, z.ZodVoid, "mutation">;
68
+ }, z.core.$strip>, z.ZodVoid, "mutation"> & {
69
+ readonly providerOptional: true;
70
+ };
67
71
  readonly setTiltPosition: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
68
72
  deviceId: z.ZodNumber;
69
73
  tiltPosition: z.ZodNumber;
70
- }, z.core.$strip>, z.ZodVoid, "mutation">;
74
+ }, z.core.$strip>, z.ZodVoid, "mutation"> & {
75
+ readonly providerOptional: true;
76
+ };
71
77
  };
72
78
  readonly status: {
73
79
  readonly schema: z.ZodObject<{
@@ -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>;
@@ -204,6 +205,7 @@ export declare const DeviceBindingsForDeviceSchema: z.ZodObject<{
204
205
  providerAddonId: z.ZodString;
205
206
  providerNodeId: z.ZodString;
206
207
  nativeAddonId: z.ZodString;
208
+ implementedMethods: z.ZodOptional<z.ZodArray<z.ZodString>>;
207
209
  }, z.core.$strip>>;
208
210
  }, z.core.$strip>;
209
211
  export type DeviceBindingsForDevice = z.infer<typeof DeviceBindingsForDeviceSchema>;
@@ -281,6 +283,7 @@ export declare const DeviceMetaSchema: z.ZodObject<{
281
283
  order: z.ZodOptional<z.ZodNumber>;
282
284
  collapsed: z.ZodOptional<z.ZodBoolean>;
283
285
  }, z.core.$strip>>>>;
286
+ primaryChildPreference: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
284
287
  role: z.ZodOptional<z.ZodNullable<z.ZodString>>;
285
288
  display: z.ZodOptional<z.ZodObject<{
286
289
  icon: z.ZodOptional<z.ZodString>;
@@ -588,6 +591,7 @@ export declare const deviceManagerCapability: {
588
591
  order: z.ZodOptional<z.ZodNumber>;
589
592
  collapsed: z.ZodOptional<z.ZodBoolean>;
590
593
  }, z.core.$strip>>>>;
594
+ primaryChildPreference: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
591
595
  role: z.ZodOptional<z.ZodNullable<z.ZodString>>;
592
596
  display: z.ZodOptional<z.ZodObject<{
593
597
  icon: z.ZodOptional<z.ZodString>;
@@ -641,6 +645,10 @@ export declare const deviceManagerCapability: {
641
645
  readonly renderDeviceTemplates: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
642
646
  templates: z.ZodArray<z.ZodString>;
643
647
  allowedDeviceIds: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
648
+ thisDevice: z.ZodOptional<z.ZodObject<{
649
+ deviceId: z.ZodNumber;
650
+ values: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
651
+ }, z.core.$strip>>;
644
652
  }, z.core.$strip>, z.ZodObject<{
645
653
  results: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
646
654
  ok: z.ZodLiteral<true>;
@@ -693,6 +701,10 @@ export declare const deviceManagerCapability: {
693
701
  readonly checkDeviceTemplates: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
694
702
  templates: z.ZodArray<z.ZodString>;
695
703
  allowedDeviceIds: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
704
+ thisDevice: z.ZodOptional<z.ZodObject<{
705
+ deviceId: z.ZodNumber;
706
+ values: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
707
+ }, z.core.$strip>>;
696
708
  }, z.core.$strip>, z.ZodObject<{
697
709
  results: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
698
710
  ok: z.ZodLiteral<true>;
@@ -700,7 +712,9 @@ export declare const deviceManagerCapability: {
700
712
  alias: z.ZodString;
701
713
  deviceId: z.ZodNullable<z.ZodNumber>;
702
714
  allowed: z.ZodBoolean;
715
+ reads: z.ZodArray<z.ZodString>;
703
716
  }, z.core.$strip>>;
717
+ readsClock: z.ZodBoolean;
704
718
  }, z.core.$strip>, z.ZodObject<{
705
719
  ok: z.ZodLiteral<false>;
706
720
  refusal: z.ZodObject<{
@@ -776,6 +790,14 @@ export declare const deviceManagerCapability: {
776
790
  collapsed: z.ZodOptional<z.ZodBoolean>;
777
791
  }, z.core.$strip>>>;
778
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">;
779
801
  /** Set (or clear) the per-device display override on the meta row. Mirrors
780
802
  * `setChildLayout` persistence; `null` clears the override entirely. The
781
803
  * override unit(s) are normalized (`normalizeUnit`) at write so the render
@@ -1128,6 +1150,7 @@ export declare const deviceManagerCapability: {
1128
1150
  order: z.ZodOptional<z.ZodNumber>;
1129
1151
  collapsed: z.ZodOptional<z.ZodBoolean>;
1130
1152
  }, z.core.$strip>>>>;
1153
+ primaryChildPreference: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
1131
1154
  display: z.ZodOptional<z.ZodObject<{
1132
1155
  icon: z.ZodOptional<z.ZodString>;
1133
1156
  label: z.ZodOptional<z.ZodString>;
@@ -1140,6 +1163,94 @@ export declare const deviceManagerCapability: {
1140
1163
  }, z.core.$strip>>>;
1141
1164
  }, z.core.$strip>>;
1142
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>;
1143
1254
  /** Get a single device by numeric deviceId. */
1144
1255
  readonly getDevice: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
1145
1256
  deviceId: z.ZodNumber;
@@ -1182,6 +1293,7 @@ export declare const deviceManagerCapability: {
1182
1293
  order: z.ZodOptional<z.ZodNumber>;
1183
1294
  collapsed: z.ZodOptional<z.ZodBoolean>;
1184
1295
  }, z.core.$strip>>>>;
1296
+ primaryChildPreference: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
1185
1297
  display: z.ZodOptional<z.ZodObject<{
1186
1298
  icon: z.ZodOptional<z.ZodString>;
1187
1299
  label: z.ZodOptional<z.ZodString>;
@@ -1236,6 +1348,7 @@ export declare const deviceManagerCapability: {
1236
1348
  order: z.ZodOptional<z.ZodNumber>;
1237
1349
  collapsed: z.ZodOptional<z.ZodBoolean>;
1238
1350
  }, z.core.$strip>>>>;
1351
+ primaryChildPreference: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
1239
1352
  display: z.ZodOptional<z.ZodObject<{
1240
1353
  icon: z.ZodOptional<z.ZodString>;
1241
1354
  label: z.ZodOptional<z.ZodString>;
@@ -1321,6 +1434,7 @@ export declare const deviceManagerCapability: {
1321
1434
  order: z.ZodOptional<z.ZodNumber>;
1322
1435
  collapsed: z.ZodOptional<z.ZodBoolean>;
1323
1436
  }, z.core.$strip>>>>;
1437
+ primaryChildPreference: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
1324
1438
  display: z.ZodOptional<z.ZodObject<{
1325
1439
  icon: z.ZodOptional<z.ZodString>;
1326
1440
  label: z.ZodOptional<z.ZodString>;
@@ -1540,6 +1654,7 @@ export declare const deviceManagerCapability: {
1540
1654
  providerAddonId: z.ZodString;
1541
1655
  providerNodeId: z.ZodString;
1542
1656
  nativeAddonId: z.ZodString;
1657
+ implementedMethods: z.ZodOptional<z.ZodArray<z.ZodString>>;
1543
1658
  }, z.core.$strip>>;
1544
1659
  }, z.core.$strip>, import("./capability-definition.js").CapabilityMethodKind>;
1545
1660
  /**
@@ -1569,6 +1684,7 @@ export declare const deviceManagerCapability: {
1569
1684
  providerAddonId: z.ZodString;
1570
1685
  providerNodeId: z.ZodString;
1571
1686
  nativeAddonId: z.ZodString;
1687
+ implementedMethods: z.ZodOptional<z.ZodArray<z.ZodString>>;
1572
1688
  }, z.core.$strip>>;
1573
1689
  }, z.core.$strip>>, import("./capability-definition.js").CapabilityMethodKind>;
1574
1690
  /**
@@ -1599,6 +1715,7 @@ export declare const deviceManagerCapability: {
1599
1715
  providerAddonId: z.ZodString;
1600
1716
  providerNodeId: z.ZodString;
1601
1717
  nativeAddonId: z.ZodString;
1718
+ implementedMethods: z.ZodOptional<z.ZodArray<z.ZodString>>;
1602
1719
  }, z.core.$strip>>;
1603
1720
  }, z.core.$strip>>, import("./capability-definition.js").CapabilityMethodKind>;
1604
1721
  /**