@camstack/types 1.2.112 → 1.2.114

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.
@@ -102,6 +102,424 @@ declare const SetSiteLocationInputSchema: z.ZodNullable<z.ZodObject<{
102
102
  latitude: z.ZodNumber;
103
103
  longitude: z.ZodNumber;
104
104
  }, z.core.$strip>>;
105
+ /**
106
+ * The TRANSPORT a call arrived on.
107
+ *
108
+ * Every counted call carries exactly one of these, and `unknown` is a PLANE
109
+ * rather than a gap: a plane that cannot attribute a call declares it here, so
110
+ * the call lands in a named bucket instead of vanishing. `planes` summing to
111
+ * `procedureCalls` is what makes "the sum of the planes explains the total"
112
+ * checkable rather than asserted.
113
+ *
114
+ * - `http` — the Fastify tRPC plugin (`/trpc/*`), one context per request.
115
+ * - `ws` — `applyWSSHandler`, counted per OPERATION rather than per
116
+ * connection; the viewer talks to the hub over `wsLink`
117
+ * exclusively, so this is the plane the HTTP census could not see.
118
+ * - `mesh` — the in-process `$core-caps` bridge (`createCaller`), which
119
+ * never touches a socket and therefore never touched a census.
120
+ * - `unknown` — counted, plane undecidable. No hook produces it today, and
121
+ * that is exactly what its `0` asserts: every plane the hub has can name
122
+ * itself. It is an output bucket, never a knob — a call that arrives on a
123
+ * plane nobody instrumented lands here instead of vanishing from the total.
124
+ */
125
+ declare const TransportPlaneSchema: z.ZodEnum<{
126
+ unknown: "unknown";
127
+ mesh: "mesh";
128
+ http: "http";
129
+ ws: "ws";
130
+ }>;
131
+ /**
132
+ * Calls per plane. Every key is always present, `0` included — an absent plane
133
+ * reads as "not instrumented", which is the one thing this census must never
134
+ * make an operator wonder about.
135
+ */
136
+ declare const TransportPlaneCountsSchema: z.ZodObject<{
137
+ http: z.ZodNumber;
138
+ ws: z.ZodNumber;
139
+ mesh: z.ZodNumber;
140
+ unknown: z.ZodNumber;
141
+ }, z.core.$strip>;
142
+ /**
143
+ * One `(plane, procedure, user-agent, ip, principal)` tuple of the transport
144
+ * census. `principal` is the DERIVED identity (`apocaliss92 (admin)`,
145
+ * `scoped:1a2b3c4d (scoped-token)`, `anonymous`) that the tRPC error log
146
+ * already prints - never a token, never an `Authorization` header.
147
+ *
148
+ * `subscriptions` is counted APART from `calls`: a subscription is opened once
149
+ * and lives for hours, so folding it into a call count makes one long-lived
150
+ * stream look like a storm.
151
+ */
152
+ declare const RequestCensusGroupSchema: z.ZodObject<{
153
+ plane: z.ZodEnum<{
154
+ unknown: "unknown";
155
+ mesh: "mesh";
156
+ http: "http";
157
+ ws: "ws";
158
+ }>;
159
+ procedure: z.ZodString;
160
+ userAgent: z.ZodString;
161
+ ip: z.ZodString;
162
+ principal: z.ZodString;
163
+ calls: z.ZodNumber;
164
+ subscriptions: z.ZodNumber;
165
+ perMin: z.ZodNumber;
166
+ }, z.core.$strip>;
167
+ /**
168
+ * A procedure's TOTAL over the window, across every caller.
169
+ *
170
+ * This block, not the group list, is what answers "did these calls arrive over
171
+ * HTTP at all". A total far BELOW what a store-side census counted over the
172
+ * same window excludes the HTTP plane, which is a result, not a failure.
173
+ */
174
+ declare const RequestCensusProcedureSchema: z.ZodObject<{
175
+ procedure: z.ZodString;
176
+ calls: z.ZodNumber;
177
+ planes: z.ZodObject<{
178
+ http: z.ZodNumber;
179
+ ws: z.ZodNumber;
180
+ mesh: z.ZodNumber;
181
+ unknown: z.ZodNumber;
182
+ }, z.core.$strip>;
183
+ subscriptions: z.ZodNumber;
184
+ perMin: z.ZodNumber;
185
+ }, z.core.$strip>;
186
+ /** What one armed window measured. Mirrors `TransportCensus.snapshot()`. */
187
+ declare const RequestCensusSnapshotSchema: z.ZodObject<{
188
+ armed: z.ZodBoolean;
189
+ elapsedMs: z.ZodNumber;
190
+ windowMs: z.ZodNumber;
191
+ armedUntilMs: z.ZodNumber;
192
+ httpRequests: z.ZodNumber;
193
+ batchedRequests: z.ZodNumber;
194
+ procedureCalls: z.ZodNumber;
195
+ planes: z.ZodObject<{
196
+ http: z.ZodNumber;
197
+ ws: z.ZodNumber;
198
+ mesh: z.ZodNumber;
199
+ unknown: z.ZodNumber;
200
+ }, z.core.$strip>;
201
+ planesExplainTotal: z.ZodBoolean;
202
+ wsConnections: z.ZodNumber;
203
+ wsMessages: z.ZodNumber;
204
+ subscriptions: z.ZodNumber;
205
+ subscriptionStops: z.ZodNumber;
206
+ distinctGroups: z.ZodNumber;
207
+ unattributedCalls: z.ZodNumber;
208
+ procedures: z.ZodReadonly<z.ZodArray<z.ZodObject<{
209
+ procedure: z.ZodString;
210
+ calls: z.ZodNumber;
211
+ planes: z.ZodObject<{
212
+ http: z.ZodNumber;
213
+ ws: z.ZodNumber;
214
+ mesh: z.ZodNumber;
215
+ unknown: z.ZodNumber;
216
+ }, z.core.$strip>;
217
+ subscriptions: z.ZodNumber;
218
+ perMin: z.ZodNumber;
219
+ }, z.core.$strip>>>;
220
+ groups: z.ZodReadonly<z.ZodArray<z.ZodObject<{
221
+ plane: z.ZodEnum<{
222
+ unknown: "unknown";
223
+ mesh: "mesh";
224
+ http: "http";
225
+ ws: "ws";
226
+ }>;
227
+ procedure: z.ZodString;
228
+ userAgent: z.ZodString;
229
+ ip: z.ZodString;
230
+ principal: z.ZodString;
231
+ calls: z.ZodNumber;
232
+ subscriptions: z.ZodNumber;
233
+ perMin: z.ZodNumber;
234
+ }, z.core.$strip>>>;
235
+ }, z.core.$strip>;
236
+ /**
237
+ * The census as an operator sees it.
238
+ *
239
+ * `persisted` is the honest answer to "will this survive the restart I am
240
+ * about to do": the arm deadline is written to `system-settings` so a window
241
+ * armed now can measure the NEXT boot, and a write that failed must not look
242
+ * like one that succeeded.
243
+ */
244
+ declare const RequestCensusStatusSchema: z.ZodObject<{
245
+ armed: z.ZodBoolean;
246
+ elapsedMs: z.ZodNumber;
247
+ windowMs: z.ZodNumber;
248
+ armedUntilMs: z.ZodNumber;
249
+ httpRequests: z.ZodNumber;
250
+ batchedRequests: z.ZodNumber;
251
+ procedureCalls: z.ZodNumber;
252
+ planes: z.ZodObject<{
253
+ http: z.ZodNumber;
254
+ ws: z.ZodNumber;
255
+ mesh: z.ZodNumber;
256
+ unknown: z.ZodNumber;
257
+ }, z.core.$strip>;
258
+ planesExplainTotal: z.ZodBoolean;
259
+ wsConnections: z.ZodNumber;
260
+ wsMessages: z.ZodNumber;
261
+ subscriptions: z.ZodNumber;
262
+ subscriptionStops: z.ZodNumber;
263
+ distinctGroups: z.ZodNumber;
264
+ unattributedCalls: z.ZodNumber;
265
+ procedures: z.ZodReadonly<z.ZodArray<z.ZodObject<{
266
+ procedure: z.ZodString;
267
+ calls: z.ZodNumber;
268
+ planes: z.ZodObject<{
269
+ http: z.ZodNumber;
270
+ ws: z.ZodNumber;
271
+ mesh: z.ZodNumber;
272
+ unknown: z.ZodNumber;
273
+ }, z.core.$strip>;
274
+ subscriptions: z.ZodNumber;
275
+ perMin: z.ZodNumber;
276
+ }, z.core.$strip>>>;
277
+ groups: z.ZodReadonly<z.ZodArray<z.ZodObject<{
278
+ plane: z.ZodEnum<{
279
+ unknown: "unknown";
280
+ mesh: "mesh";
281
+ http: "http";
282
+ ws: "ws";
283
+ }>;
284
+ procedure: z.ZodString;
285
+ userAgent: z.ZodString;
286
+ ip: z.ZodString;
287
+ principal: z.ZodString;
288
+ calls: z.ZodNumber;
289
+ subscriptions: z.ZodNumber;
290
+ perMin: z.ZodNumber;
291
+ }, z.core.$strip>>>;
292
+ persisted: z.ZodBoolean;
293
+ }, z.core.$strip>;
294
+ /** Severity vocabulary. Mirrors `LogLevel` in `interfaces/logging.ts`. */
295
+ declare const LogLevelSchema: z.ZodEnum<{
296
+ error: "error";
297
+ debug: "debug";
298
+ info: "info";
299
+ warn: "warn";
300
+ }>;
301
+ /**
302
+ * The diagnostics that can be ARMED for a window. Exactly one today.
303
+ *
304
+ * A diagnostic is anything whose cost is only worth paying while a question is
305
+ * open. It never persists as a boolean: see {@link DiagnosticWindowSchema}.
306
+ */
307
+ declare const DiagnosticIdSchema: z.ZodEnum<{
308
+ "request-census": "request-census";
309
+ }>;
310
+ /**
311
+ * The layers of the level hierarchy, general → specific. The most specific
312
+ * layer that carries an explicit value wins.
313
+ *
314
+ * `component` is DECLARED and not yet resolvable: the per-component channels
315
+ * are a later slice of the same plan, and a `levelSource` enum that has to
316
+ * grow later would force every consumer of this document to change with it.
317
+ * Nothing returns `component` today.
318
+ */
319
+ declare const LoggingScopeKindSchema: z.ZodEnum<{
320
+ node: "node";
321
+ cluster: "cluster";
322
+ component: "component";
323
+ }>;
324
+ /** Where an effective level came from. `default` = nothing is set anywhere. */
325
+ declare const LoggingLevelSourceSchema: z.ZodEnum<{
326
+ default: "default";
327
+ node: "node";
328
+ cluster: "cluster";
329
+ component: "component";
330
+ }>;
331
+ /**
332
+ * One layer of the hierarchy as it actually STANDS.
333
+ *
334
+ * `level: null` is the whole reason this array is returned: it is the
335
+ * difference between "this node is at `info` because I decided it" and
336
+ * "...because it inherits". An operator who clears an override believing they
337
+ * are clearing an inherited value has been handed the same defect as the two
338
+ * contradicting knobs this document exists to remove, moved one floor up.
339
+ */
340
+ declare const LoggingLevelLayerSchema: z.ZodObject<{
341
+ scope: z.ZodEnum<{
342
+ node: "node";
343
+ cluster: "cluster";
344
+ component: "component";
345
+ }>;
346
+ nodeId: z.ZodNullable<z.ZodString>;
347
+ level: z.ZodNullable<z.ZodEnum<{
348
+ error: "error";
349
+ debug: "debug";
350
+ info: "info";
351
+ warn: "warn";
352
+ }>>;
353
+ }, z.core.$strip>;
354
+ /** What a line is judged against, and WHICH layer decided it. */
355
+ declare const LoggingEffectiveSchema: z.ZodObject<{
356
+ level: z.ZodEnum<{
357
+ error: "error";
358
+ debug: "debug";
359
+ info: "info";
360
+ warn: "warn";
361
+ }>;
362
+ levelSource: z.ZodEnum<{
363
+ default: "default";
364
+ node: "node";
365
+ cluster: "cluster";
366
+ component: "component";
367
+ }>;
368
+ }, z.core.$strip>;
369
+ /** Every layer, general → specific. Never collapsed into the effective value. */
370
+ declare const LoggingExplicitSchema: z.ZodObject<{
371
+ layers: z.ZodReadonly<z.ZodArray<z.ZodObject<{
372
+ scope: z.ZodEnum<{
373
+ node: "node";
374
+ cluster: "cluster";
375
+ component: "component";
376
+ }>;
377
+ nodeId: z.ZodNullable<z.ZodString>;
378
+ level: z.ZodNullable<z.ZodEnum<{
379
+ error: "error";
380
+ debug: "debug";
381
+ info: "info";
382
+ warn: "warn";
383
+ }>>;
384
+ }, z.core.$strip>>>;
385
+ }, z.core.$strip>;
386
+ /**
387
+ * An armed diagnostic, with its DEADLINE.
388
+ *
389
+ * The shape of ADR-0244: what is stored is a deadline and never a flag, so a
390
+ * diagnostic somebody forgot expires by itself, and a boot-window measurement
391
+ * survives the restart it exists to measure. `remainingMs` is 0 whenever
392
+ * `armed` is false — a window is never reported as slightly expired.
393
+ */
394
+ declare const DiagnosticWindowSchema: z.ZodObject<{
395
+ id: z.ZodEnum<{
396
+ "request-census": "request-census";
397
+ }>;
398
+ armed: z.ZodBoolean;
399
+ armedUntilMs: z.ZodNumber;
400
+ remainingMs: z.ZodNumber;
401
+ persisted: z.ZodBoolean;
402
+ }, z.core.$strip>;
403
+ /**
404
+ * `armMs: 0` DISARMS. Any positive value arms for that long, clamped by the
405
+ * server — there is no maximum here on purpose: a bound repeated in a schema
406
+ * is a second knob that disagrees with the first the day one of them moves.
407
+ */
408
+ declare const DiagnosticWindowPatchSchema: z.ZodObject<{
409
+ id: z.ZodEnum<{
410
+ "request-census": "request-census";
411
+ }>;
412
+ armMs: z.ZodNumber;
413
+ reportEveryMs: z.ZodOptional<z.ZodNumber>;
414
+ }, z.core.$strip>;
415
+ /**
416
+ * A PATCH, and patches MERGE.
417
+ *
418
+ * A field absent from the patch is left exactly as it was — arming a
419
+ * diagnostic never resets a level, and setting a level never disarms a window.
420
+ * The provider must not reconstruct the document as `{ ...snapshot, ...patch }`:
421
+ * `setAll` already merges, and rebuilding the object is how an absent field
422
+ * turns into an erased one.
423
+ */
424
+ declare const LoggingSettingsPatchSchema: z.ZodObject<{
425
+ level: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
426
+ error: "error";
427
+ debug: "debug";
428
+ info: "info";
429
+ warn: "warn";
430
+ }>>>;
431
+ diagnostics: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodObject<{
432
+ id: z.ZodEnum<{
433
+ "request-census": "request-census";
434
+ }>;
435
+ armMs: z.ZodNumber;
436
+ reportEveryMs: z.ZodOptional<z.ZodNumber>;
437
+ }, z.core.$strip>>>>;
438
+ }, z.core.$strip>;
439
+ /**
440
+ * Which LAYER of the hierarchy is addressed. Absent = the cluster layer.
441
+ *
442
+ * Deliberately NOT called `nodeId`: that key is reserved on every cap method
443
+ * input — the generated router strips it and uses it to resolve the PROVIDER
444
+ * on that node (`resolveProvider(cap, nodeId, …)`). A document about
445
+ * `agent-1` addressed as `nodeId` would be forwarded to agent-1 and answered
446
+ * by an agent that holds no cluster document at all. The hub is the single
447
+ * authority over the whole hierarchy and answers for every layer, so the
448
+ * layer selector needs a name the transport does not already own.
449
+ */
450
+ declare const GetLoggingSettingsInputSchema: z.ZodObject<{
451
+ scopeNodeId: z.ZodOptional<z.ZodString>;
452
+ }, z.core.$strip>;
453
+ declare const SetLoggingSettingsInputSchema: z.ZodObject<{
454
+ scopeNodeId: z.ZodOptional<z.ZodString>;
455
+ patch: z.ZodObject<{
456
+ level: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
457
+ error: "error";
458
+ debug: "debug";
459
+ info: "info";
460
+ warn: "warn";
461
+ }>>>;
462
+ diagnostics: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodObject<{
463
+ id: z.ZodEnum<{
464
+ "request-census": "request-census";
465
+ }>;
466
+ armMs: z.ZodNumber;
467
+ reportEveryMs: z.ZodOptional<z.ZodNumber>;
468
+ }, z.core.$strip>>>>;
469
+ }, z.core.$strip>;
470
+ }, z.core.$strip>;
471
+ /**
472
+ * The whole document, as read and as returned after every write.
473
+ *
474
+ * `persisted: false` means the settings store could not be read or written.
475
+ * The in-memory mirror still governs behaviour and is unchanged by the
476
+ * failure — a read that fails neither switches a level nor disarms a window
477
+ * (D49) — but the operator is told that what they are looking at would not
478
+ * survive a restart.
479
+ */
480
+ declare const LoggingSettingsStateSchema: z.ZodObject<{
481
+ scopeNodeId: z.ZodNullable<z.ZodString>;
482
+ effective: z.ZodObject<{
483
+ level: z.ZodEnum<{
484
+ error: "error";
485
+ debug: "debug";
486
+ info: "info";
487
+ warn: "warn";
488
+ }>;
489
+ levelSource: z.ZodEnum<{
490
+ default: "default";
491
+ node: "node";
492
+ cluster: "cluster";
493
+ component: "component";
494
+ }>;
495
+ }, z.core.$strip>;
496
+ explicit: z.ZodObject<{
497
+ layers: z.ZodReadonly<z.ZodArray<z.ZodObject<{
498
+ scope: z.ZodEnum<{
499
+ node: "node";
500
+ cluster: "cluster";
501
+ component: "component";
502
+ }>;
503
+ nodeId: z.ZodNullable<z.ZodString>;
504
+ level: z.ZodNullable<z.ZodEnum<{
505
+ error: "error";
506
+ debug: "debug";
507
+ info: "info";
508
+ warn: "warn";
509
+ }>>;
510
+ }, z.core.$strip>>>;
511
+ }, z.core.$strip>;
512
+ activeWindows: z.ZodReadonly<z.ZodArray<z.ZodObject<{
513
+ id: z.ZodEnum<{
514
+ "request-census": "request-census";
515
+ }>;
516
+ armed: z.ZodBoolean;
517
+ armedUntilMs: z.ZodNumber;
518
+ remainingMs: z.ZodNumber;
519
+ persisted: z.ZodBoolean;
520
+ }, z.core.$strip>>>;
521
+ persisted: z.ZodBoolean;
522
+ }, z.core.$strip>;
105
523
  export declare const systemCapability: {
106
524
  readonly name: "system";
107
525
  readonly scope: "system";
@@ -204,6 +622,187 @@ export declare const systemCapability: {
204
622
  derivationAttemptedAt: z.ZodNullable<z.ZodNumber>;
205
623
  derivationError: z.ZodNullable<z.ZodString>;
206
624
  }, z.core.$strip>, "mutation">;
625
+ /**
626
+ * Read the HTTP request census - which caller, from which address, with
627
+ * which user-agent, invoked which tRPC procedure, and how often.
628
+ *
629
+ * Reading NEVER re-arms: re-arming clears the counts, which would throw
630
+ * away exactly the numbers being asked for. A closed window may be read as
631
+ * many times as the operator likes and always describes the same window.
632
+ *
633
+ * Admin-only: the rows carry source addresses and principal names.
634
+ */
635
+ readonly getRequestCensus: import("./capability-definition.js").CapabilityMethodSchema<z.ZodVoid, z.ZodObject<{
636
+ armed: z.ZodBoolean;
637
+ elapsedMs: z.ZodNumber;
638
+ windowMs: z.ZodNumber;
639
+ armedUntilMs: z.ZodNumber;
640
+ httpRequests: z.ZodNumber;
641
+ batchedRequests: z.ZodNumber;
642
+ procedureCalls: z.ZodNumber;
643
+ planes: z.ZodObject<{
644
+ http: z.ZodNumber;
645
+ ws: z.ZodNumber;
646
+ mesh: z.ZodNumber;
647
+ unknown: z.ZodNumber;
648
+ }, z.core.$strip>;
649
+ planesExplainTotal: z.ZodBoolean;
650
+ wsConnections: z.ZodNumber;
651
+ wsMessages: z.ZodNumber;
652
+ subscriptions: z.ZodNumber;
653
+ subscriptionStops: z.ZodNumber;
654
+ distinctGroups: z.ZodNumber;
655
+ unattributedCalls: z.ZodNumber;
656
+ procedures: z.ZodReadonly<z.ZodArray<z.ZodObject<{
657
+ procedure: z.ZodString;
658
+ calls: z.ZodNumber;
659
+ planes: z.ZodObject<{
660
+ http: z.ZodNumber;
661
+ ws: z.ZodNumber;
662
+ mesh: z.ZodNumber;
663
+ unknown: z.ZodNumber;
664
+ }, z.core.$strip>;
665
+ subscriptions: z.ZodNumber;
666
+ perMin: z.ZodNumber;
667
+ }, z.core.$strip>>>;
668
+ groups: z.ZodReadonly<z.ZodArray<z.ZodObject<{
669
+ plane: z.ZodEnum<{
670
+ unknown: "unknown";
671
+ mesh: "mesh";
672
+ http: "http";
673
+ ws: "ws";
674
+ }>;
675
+ procedure: z.ZodString;
676
+ userAgent: z.ZodString;
677
+ ip: z.ZodString;
678
+ principal: z.ZodString;
679
+ calls: z.ZodNumber;
680
+ subscriptions: z.ZodNumber;
681
+ perMin: z.ZodNumber;
682
+ }, z.core.$strip>>>;
683
+ persisted: z.ZodBoolean;
684
+ }, z.core.$strip>, import("./capability-definition.js").CapabilityMethodKind>;
685
+ /**
686
+ * The logging settings document — levels and armed diagnostics — resolved
687
+ * for `nodeId`, or for the cluster when `nodeId` is absent.
688
+ *
689
+ * Returns BOTH `effective` and `explicit`. See
690
+ * {@link LoggingLevelLayerSchema} for why collapsing them is the defect.
691
+ */
692
+ readonly getLoggingSettings: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
693
+ scopeNodeId: z.ZodOptional<z.ZodString>;
694
+ }, z.core.$strip>, z.ZodObject<{
695
+ scopeNodeId: z.ZodNullable<z.ZodString>;
696
+ effective: z.ZodObject<{
697
+ level: z.ZodEnum<{
698
+ error: "error";
699
+ debug: "debug";
700
+ info: "info";
701
+ warn: "warn";
702
+ }>;
703
+ levelSource: z.ZodEnum<{
704
+ default: "default";
705
+ node: "node";
706
+ cluster: "cluster";
707
+ component: "component";
708
+ }>;
709
+ }, z.core.$strip>;
710
+ explicit: z.ZodObject<{
711
+ layers: z.ZodReadonly<z.ZodArray<z.ZodObject<{
712
+ scope: z.ZodEnum<{
713
+ node: "node";
714
+ cluster: "cluster";
715
+ component: "component";
716
+ }>;
717
+ nodeId: z.ZodNullable<z.ZodString>;
718
+ level: z.ZodNullable<z.ZodEnum<{
719
+ error: "error";
720
+ debug: "debug";
721
+ info: "info";
722
+ warn: "warn";
723
+ }>>;
724
+ }, z.core.$strip>>>;
725
+ }, z.core.$strip>;
726
+ activeWindows: z.ZodReadonly<z.ZodArray<z.ZodObject<{
727
+ id: z.ZodEnum<{
728
+ "request-census": "request-census";
729
+ }>;
730
+ armed: z.ZodBoolean;
731
+ armedUntilMs: z.ZodNumber;
732
+ remainingMs: z.ZodNumber;
733
+ persisted: z.ZodBoolean;
734
+ }, z.core.$strip>>>;
735
+ persisted: z.ZodBoolean;
736
+ }, z.core.$strip>, import("./capability-definition.js").CapabilityMethodKind>;
737
+ /**
738
+ * Write the logging settings document. The ONLY write authority over log
739
+ * levels and diagnostic windows — arming the request census went through
740
+ * `system.setRequestCensus` until 2026-08-27 and no longer does, because
741
+ * two writes that disagree about the same window is exactly the defect
742
+ * this document exists to remove (D245).
743
+ *
744
+ * The patch MERGES: see {@link LoggingSettingsPatchSchema}.
745
+ */
746
+ readonly setLoggingSettings: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
747
+ scopeNodeId: z.ZodOptional<z.ZodString>;
748
+ patch: z.ZodObject<{
749
+ level: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
750
+ error: "error";
751
+ debug: "debug";
752
+ info: "info";
753
+ warn: "warn";
754
+ }>>>;
755
+ diagnostics: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodObject<{
756
+ id: z.ZodEnum<{
757
+ "request-census": "request-census";
758
+ }>;
759
+ armMs: z.ZodNumber;
760
+ reportEveryMs: z.ZodOptional<z.ZodNumber>;
761
+ }, z.core.$strip>>>>;
762
+ }, z.core.$strip>;
763
+ }, z.core.$strip>, z.ZodObject<{
764
+ scopeNodeId: z.ZodNullable<z.ZodString>;
765
+ effective: z.ZodObject<{
766
+ level: z.ZodEnum<{
767
+ error: "error";
768
+ debug: "debug";
769
+ info: "info";
770
+ warn: "warn";
771
+ }>;
772
+ levelSource: z.ZodEnum<{
773
+ default: "default";
774
+ node: "node";
775
+ cluster: "cluster";
776
+ component: "component";
777
+ }>;
778
+ }, z.core.$strip>;
779
+ explicit: z.ZodObject<{
780
+ layers: z.ZodReadonly<z.ZodArray<z.ZodObject<{
781
+ scope: z.ZodEnum<{
782
+ node: "node";
783
+ cluster: "cluster";
784
+ component: "component";
785
+ }>;
786
+ nodeId: z.ZodNullable<z.ZodString>;
787
+ level: z.ZodNullable<z.ZodEnum<{
788
+ error: "error";
789
+ debug: "debug";
790
+ info: "info";
791
+ warn: "warn";
792
+ }>>;
793
+ }, z.core.$strip>>>;
794
+ }, z.core.$strip>;
795
+ activeWindows: z.ZodReadonly<z.ZodArray<z.ZodObject<{
796
+ id: z.ZodEnum<{
797
+ "request-census": "request-census";
798
+ }>;
799
+ armed: z.ZodBoolean;
800
+ armedUntilMs: z.ZodNumber;
801
+ remainingMs: z.ZodNumber;
802
+ persisted: z.ZodBoolean;
803
+ }, z.core.$strip>>>;
804
+ persisted: z.ZodBoolean;
805
+ }, z.core.$strip>, "mutation">;
207
806
  };
208
807
  /** BIG PLAN 2: declarative mount hint — read by `@camstack/system` `buildCapRouters`. */
209
808
  readonly mount: {
@@ -211,8 +810,26 @@ export declare const systemCapability: {
211
810
  };
212
811
  };
213
812
  export type ISystemProvider = InferProvider<typeof systemCapability>;
813
+ export type RequestCensusGroup = z.infer<typeof RequestCensusGroupSchema>;
814
+ export type RequestCensusProcedure = z.infer<typeof RequestCensusProcedureSchema>;
815
+ export type RequestCensusSnapshot = z.infer<typeof RequestCensusSnapshotSchema>;
816
+ export type RequestCensusStatus = z.infer<typeof RequestCensusStatusSchema>;
817
+ export type TransportPlane = z.infer<typeof TransportPlaneSchema>;
818
+ export type TransportPlaneCounts = z.infer<typeof TransportPlaneCountsSchema>;
819
+ export type DiagnosticId = z.infer<typeof DiagnosticIdSchema>;
820
+ export type DiagnosticWindow = z.infer<typeof DiagnosticWindowSchema>;
821
+ export type DiagnosticWindowPatch = z.infer<typeof DiagnosticWindowPatchSchema>;
822
+ export type GetLoggingSettingsInput = z.infer<typeof GetLoggingSettingsInputSchema>;
823
+ export type LoggingEffective = z.infer<typeof LoggingEffectiveSchema>;
824
+ export type LoggingExplicit = z.infer<typeof LoggingExplicitSchema>;
825
+ export type LoggingLevelLayer = z.infer<typeof LoggingLevelLayerSchema>;
826
+ export type LoggingLevelSource = z.infer<typeof LoggingLevelSourceSchema>;
827
+ export type LoggingScopeKind = z.infer<typeof LoggingScopeKindSchema>;
828
+ export type LoggingSettingsPatch = z.infer<typeof LoggingSettingsPatchSchema>;
829
+ export type LoggingSettingsState = z.infer<typeof LoggingSettingsStateSchema>;
830
+ export type SetLoggingSettingsInput = z.infer<typeof SetLoggingSettingsInputSchema>;
214
831
  export type SiteLocation = z.infer<typeof SiteLocationSchema>;
215
832
  export type SiteLocationSource = z.infer<typeof SiteLocationSourceSchema>;
216
833
  export type SiteLocationStatus = z.infer<typeof SiteLocationStatusSchema>;
217
834
  export type SetSiteLocationInput = z.infer<typeof SetSiteLocationInputSchema>;
218
- export { FeatureManifestSchema, HealthStatusSchema, NetworkAddressSchema, SetSiteLocationInputSchema, SiteLocationSchema, SiteLocationSourceSchema, SiteLocationStatusSchema, };
835
+ export { DiagnosticIdSchema, DiagnosticWindowPatchSchema, DiagnosticWindowSchema, FeatureManifestSchema, GetLoggingSettingsInputSchema, HealthStatusSchema, LoggingEffectiveSchema, LoggingExplicitSchema, LoggingLevelLayerSchema, LoggingLevelSourceSchema, LoggingScopeKindSchema, LoggingSettingsPatchSchema, LoggingSettingsStateSchema, LogLevelSchema, NetworkAddressSchema, RequestCensusGroupSchema, RequestCensusProcedureSchema, RequestCensusSnapshotSchema, RequestCensusStatusSchema, SetLoggingSettingsInputSchema, SetSiteLocationInputSchema, SiteLocationSchema, SiteLocationSourceSchema, SiteLocationStatusSchema, TransportPlaneCountsSchema, TransportPlaneSchema, };
@@ -1,3 +1,4 @@
1
1
  export * from './coco-classmap.js';
2
+ export * from './sensor-active-state.js';
2
3
  export * from './audio-classmap.js';
3
4
  export * from './event-taxonomy.js';