@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.
- package/dist/capabilities/face-gallery.cap.d.ts +60 -0
- package/dist/capabilities/index.d.ts +2 -2
- package/dist/capabilities/recording.cap.d.ts +18 -0
- package/dist/capabilities/system.cap.d.ts +618 -1
- package/dist/catalogs/index.d.ts +1 -0
- package/dist/catalogs/sensor-active-state.d.ts +130 -0
- package/dist/generated/addon-api.d.ts +21 -0
- package/dist/generated/method-access-map.d.ts +1 -1
- package/dist/generated/system-proxy.d.ts +1 -1
- package/dist/index.d.ts +7 -6
- package/dist/index.js +882 -107
- package/dist/index.mjs +850 -108
- package/dist/interfaces/recording-config.d.ts +44 -0
- package/dist/pipeline/native-lease.d.ts +9 -1
- package/dist/types/detection.d.ts +11 -2
- package/dist/types/labels.d.ts +26 -0
- package/package.json +1 -1
|
@@ -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, };
|
package/dist/catalogs/index.d.ts
CHANGED