@camstack/addon-pipeline-orchestrator 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/index.js CHANGED
@@ -8344,6 +8344,111 @@ function composeSwitchedOff(input) {
8344
8344
  };
8345
8345
  }
8346
8346
  /**
8347
+ * Per-component log CHANNELS — the gate a hot path consults, and the registry
8348
+ * an addon declares its channels in.
8349
+ *
8350
+ * ## Two axes, deliberately separated
8351
+ *
8352
+ * - **DECLARATION** — which channels exist. Only the addon knows:
8353
+ * `stream-broker` knows webrtc/ICE/RTP, `provider-reolink` knows
8354
+ * baichuan/handshake. A hand-wired central list rots at the first addition,
8355
+ * and rots silently. So a channel is declared where it is consulted, and the
8356
+ * `log-channels` capability enumerates the declarations.
8357
+ * - **VALUE** — at which level, for which scope, until when. That stays ONE
8358
+ * thing: the logging settings document on the `system` cap. Two authorities
8359
+ * over the values is the exact defect
8360
+ * `docs/design/plans/2026-08-26-logging-per-componente.md` was written to
8361
+ * remove; re-introducing it from the cure side would be grotesque.
8362
+ *
8363
+ * Nothing in this file reads a clock, an env var or a store. The registry is
8364
+ * a MIRROR: it is moved only by {@link LogChannelRegistry.apply}, called off
8365
+ * the hot path with a value somebody actually read, and by
8366
+ * {@link LogChannelRegistry.tick}, called on a timer. A store read that fails
8367
+ * never reaches here, so it can neither disarm an armed channel nor arm a
8368
+ * disarmed one (D49).
8369
+ *
8370
+ * ## The canonical call shape
8371
+ *
8372
+ * ```ts
8373
+ * if (CH_RTP.on && CH_RTP.wants(deviceId)) {
8374
+ * CH_RTP.log(logger, 'rtp subscriber added', { tags: { deviceId }, meta: { ssrc } })
8375
+ * }
8376
+ * ```
8377
+ *
8378
+ * `on` is a plain boolean FIELD — never a getter — and it is the FIRST thing
8379
+ * read. Disarmed, a call site costs one load and one branch, and the `extras`
8380
+ * object literal is never constructed because it lives inside the branch. It
8381
+ * is the same shape already proven in production at `stream-broker.ts:1650`,
8382
+ * and the same discipline `LoggingGate.allowsDestination` uses for the
8383
+ * destination floor (measured at 1.93 ns/call when off).
8384
+ *
8385
+ * ## Why a channel emits at `info`
8386
+ *
8387
+ * `loki-logging.addon.ts` pins the destination default at `info` and
8388
+ * `loki-destination.ts` drops everything below it, so a line emitted at
8389
+ * `debug` never reaches Loki and the hub's in-memory ring only holds ~35
8390
+ * minutes. A diagnostic that cannot be read an hour later is worse than no
8391
+ * diagnostic, because it looks done. {@link LogChannelGate.log} therefore
8392
+ * emits at the channel's declared level, whose schema floor is `info`.
8393
+ */
8394
+ /**
8395
+ * The level a channel writes at once armed.
8396
+ *
8397
+ * `debug` is absent ON PURPOSE and not by omission: below `info` the line does
8398
+ * not leave the process for Loki, and the whole point of arming a channel is
8399
+ * to read it later.
8400
+ */
8401
+ var LogChannelLevelSchema = _enum([
8402
+ "info",
8403
+ "warn",
8404
+ "error"
8405
+ ]);
8406
+ /**
8407
+ * What an addon declares about one channel. No value, no state — a
8408
+ * declaration is inert.
8409
+ */
8410
+ var LogChannelDescriptorSchema = object({
8411
+ /**
8412
+ * Dotted `area.thing`, unique across the workspace. `area` is conventionally
8413
+ * the addon's short name so an operator reading a channel list can tell who
8414
+ * owns it without a second lookup.
8415
+ */
8416
+ name: string().min(3).regex(/^[a-z0-9-]+(\.[a-z0-9-]+)+$/, "a channel name is dotted lower-kebab, e.g. area.thing"),
8417
+ /** One sentence: what the operator will SEE after arming it. */
8418
+ description: string().min(1),
8419
+ /** The level its lines are emitted at. Never below `info`. */
8420
+ defaultLevel: LogChannelLevelSchema,
8421
+ /**
8422
+ * Whether this channel can be narrowed to a camera.
8423
+ *
8424
+ * `true` is a PROMISE with two halves, and both must hold: the gate is
8425
+ * consulted with the numeric device id, AND every line the channel admits
8426
+ * carries `tags: { deviceId }` with that same numeric id. The second half is
8427
+ * what makes `| json | deviceId="617"` work in Loki — `loki-payload.ts`
8428
+ * keeps `deviceId` out of the stream labels for cardinality, so the tag in
8429
+ * the body is the only way to filter.
8430
+ *
8431
+ * A channel whose lines carry the device only in `meta` (or not at all) is
8432
+ * declared `false`. Declaring it `true` anyway would be a lie the UI repeats:
8433
+ * the operator narrows to one camera, sees nothing, and concludes the code
8434
+ * path was never taken.
8435
+ */
8436
+ perDevice: boolean()
8437
+ });
8438
+ /**
8439
+ * An armed window over one channel, as the document hands it to a mirror.
8440
+ *
8441
+ * A window is a DEADLINE, never a flag (ADR-0244): a channel somebody forgot
8442
+ * expires by itself, which is the one failure a boolean cannot avoid.
8443
+ */
8444
+ var LogChannelWindowSchema = object({
8445
+ channel: string().min(1),
8446
+ /** Epoch ms the window closes at. */
8447
+ armedUntilMs: number(),
8448
+ /** `null` = every camera. A non-empty list narrows to those numeric ids. */
8449
+ deviceIds: array(number().int()).readonly().nullable()
8450
+ });
8451
+ /**
8347
8452
  * Ops-log — the durable, append-only operations audit shared by the
8348
8453
  * recordings and events management surfaces.
8349
8454
  *
@@ -11941,6 +12046,35 @@ var MutationFilterSchema = object({
11941
12046
  whereBetween: record(string(), tuple([unknown(), unknown()])).optional(),
11942
12047
  whereNot: record(string(), unknown()).optional()
11943
12048
  });
12049
+ /**
12050
+ * One scalar an {@link settingsStoreCapability.methods.aggregate} call asks for.
12051
+ *
12052
+ * `as` names the slot in the result, so the SAME column may be asked twice with
12053
+ * two operations (`MIN(startMs)` and `MAX(startMs)` in one round trip) — which
12054
+ * a `Record<column, op>` shape could not express.
12055
+ */
12056
+ var AggregateFieldSchema = object({
12057
+ /** Result key. */
12058
+ as: string().min(1),
12059
+ /** Column to aggregate. Must be a real column of a declared collection. */
12060
+ field: string().min(1),
12061
+ op: _enum([
12062
+ "sum",
12063
+ "min",
12064
+ "max"
12065
+ ])
12066
+ });
12067
+ /**
12068
+ * `COUNT(*)` plus one number per requested field.
12069
+ *
12070
+ * `null` means NO ROW MATCHED, never zero: a `SUM` over an empty set and a sum
12071
+ * that really is 0 are different facts, and an accounting caller that renders
12072
+ * "0 bytes, oldest = 0" for "nothing here" reports a lie about a disk.
12073
+ */
12074
+ var AggregateResultSchema = object({
12075
+ count: number().int(),
12076
+ values: record(string(), number().nullable())
12077
+ });
11944
12078
  /** A single stored record: `{ id, data }`. */
11945
12079
  var SettingsRecordSchema = object({
11946
12080
  id: string(),
@@ -12025,6 +12159,11 @@ method(object({
12025
12159
  collection: string(),
12026
12160
  filter: QueryFilterSchema.optional()
12027
12161
  }), number()), method(object({
12162
+ namespace: string().optional(),
12163
+ collection: string(),
12164
+ fields: array(AggregateFieldSchema).readonly(),
12165
+ filter: QueryFilterSchema.optional()
12166
+ }), AggregateResultSchema), method(object({
12028
12167
  namespace: string().optional(),
12029
12168
  collection: string(),
12030
12169
  field: string(),
@@ -12141,6 +12280,11 @@ method(_void(), EngineInfoSchema, { auth: "admin" }), method(object({
12141
12280
  collection: string(),
12142
12281
  filter: QueryFilterSchema.optional()
12143
12282
  }), number(), { auth: "admin" }), method(object({
12283
+ namespace: string().optional(),
12284
+ collection: string(),
12285
+ fields: array(AggregateFieldSchema).readonly(),
12286
+ filter: QueryFilterSchema.optional()
12287
+ }), AggregateResultSchema, { auth: "admin" }), method(object({
12144
12288
  namespace: string().optional(),
12145
12289
  collection: string(),
12146
12290
  field: string(),
@@ -12702,24 +12846,6 @@ method(_void(), _void(), { kind: "mutation" }), method(_void(), _void(), { kind:
12702
12846
  kind: "mutation",
12703
12847
  auth: "admin"
12704
12848
  });
12705
- /**
12706
- * Device Manager capability — hub-side singleton that unifies device persistence,
12707
- * live registry access, and all management operations into a single tRPC surface.
12708
- *
12709
- * Replaces:
12710
- * - `device-persistence` capability (persistence methods absorbed here)
12711
- * - `device-management.router.ts` (deleted in Phase 2)
12712
- * - `device-ops.router.ts` (compat layer — deleted; device-provider ops absorbed here)
12713
- *
12714
- * All device provider addons (rtsp, onvif, frigate, …) are hub-local: they may
12715
- * fork into separate processes but never run on remote cluster agents. Therefore:
12716
- * - No nodeId routing needed — this is a pure hub singleton.
12717
- * - The hub's DeviceRegistry is the single source of truth for all live devices.
12718
- * - No shadow registry or cross-node aggregation required.
12719
- *
12720
- * Forked workers register devices back to the hub via `ctx.devices`
12721
- * (DeviceManagerApi → ctx.api.deviceManager.registerDevice), same as today.
12722
- */
12723
12849
  /** One child-placement directive on a container's `childLayout`. Structurally
12724
12850
  * identical to `ChildLayoutEntry` in `device-management.ts` — the cap wire
12725
12851
  * shape for the same field. The child is identified by its re-sync-stable
@@ -13088,7 +13214,7 @@ method(object({
13088
13214
  * it answers today and the caller filters as it already does.
13089
13215
  */
13090
13216
  deviceIds: array(number()).optional()
13091
- }), array(DeviceInfoSchema)), method(object({ deviceId: number() }), DeviceInfoSchema.nullable()), method(object({ parentDeviceId: number() }), array(DeviceInfoSchema)), method(object({ deviceId: number() }), object({
13217
+ }), array(DeviceInfoSchema)), method(object({ deviceId: number() }), DeviceInfoSchema.nullable()), method(object({ parentDeviceId: number() }), array(DeviceInfoSchema)), method(object({ parentDeviceIds: array(number()).max(256) }), record(string(), array(DeviceInfoSchema))), method(object({ deviceId: number() }), object({
13092
13218
  mode: LinkedDevicesModeSchema,
13093
13219
  devices: array(LinkedDeviceSchema)
13094
13220
  })), method(object({ deviceIds: array(number()) }), array(LinkedDevicesForDeviceSchema)), method(object({ deviceId: number() }), array(StreamSourceEntrySchema$1)), method(object({ deviceId: number() }), array(ConfigEntrySchema)), method(object({ deviceId: number() }), ConfigUISchemaOutput), method(object({
@@ -13812,6 +13938,59 @@ method(LlmGenerateBaseInputSchema, LlmGenerateResultSchema, { kind: "mutation" }
13812
13938
  kind: "mutation",
13813
13939
  auth: "admin"
13814
13940
  });
13941
+ /**
13942
+ * `log-channels` — the capability an addon DECLARES its diagnostic channels
13943
+ * through. It stores nothing.
13944
+ *
13945
+ * ## Why a capability at all, and why this shape
13946
+ *
13947
+ * Which channels exist is knowledge only the addon has: `stream-broker` knows
13948
+ * webrtc/ICE/RTP, `provider-reolink` knows baichuan/handshake. A central list
13949
+ * maintained by hand rots at the first addition and rots INVISIBLY — nothing
13950
+ * fails, an operator just never sees the channel somebody added. So the list
13951
+ * is assembled from declarations at runtime.
13952
+ *
13953
+ * The shape is copied from `log-destination.cap.ts`, which already does
13954
+ * exactly this job: `mode: 'collection'`, `internal: true`,
13955
+ * `mount: { kind: 'skip' }` — no tRPC route, no generated hooks — while
13956
+ * `addons.listCapabilityProviders` still enumerates it, and the hub's
13957
+ * `CapabilityRegistry` still holds an RPC proxy per provider so a forked
13958
+ * runner's declarations reach hub-main over the transport that already exists.
13959
+ * No new UDS message, no second registry.
13960
+ *
13961
+ * ## What it deliberately does NOT own
13962
+ *
13963
+ * The VALUES — which channel is armed, for which cameras, until when — live in
13964
+ * ONE place: the logging settings document on the `system` cap
13965
+ * (`getLoggingSettings` / `setLoggingSettings`). Two authorities over the same
13966
+ * value is the defect the plan behind this work exists to remove, and
13967
+ * `setRequestCensus` was retired (D245) rather than allowed to be a second
13968
+ * one. {@link logChannelsCapability} therefore has no getter for a level, no
13969
+ * setter for a window and no persistence of any kind.
13970
+ *
13971
+ * ## Why `apply` is here even so
13972
+ *
13973
+ * The gate lives in the addon's PROCESS; the document lives in hub-main. Some
13974
+ * seam has to carry the value from the authority to the mirror, and a channel
13975
+ * that cannot be reached is precisely the dead knob this whole slice exists to
13976
+ * make impossible (D62 — `audioThresholdDbfs`, the HA entities with no source).
13977
+ * `apply` is that seam and nothing more: it writes an in-memory mirror, it
13978
+ * persists nothing, it is never the source of a value, and it is called only
13979
+ * with a set the hub actually read (D49 — a read that fails does not call it
13980
+ * at all, so no channel is silently disarmed by a bad read).
13981
+ */
13982
+ /** What `apply` reports back — enough to log, not enough to be a second state. */
13983
+ var LogChannelApplyResultSchema = object({
13984
+ /** How many declared channels are armed in this process after the call. */
13985
+ armed: number().int().min(0),
13986
+ /**
13987
+ * Names the document armed that this process does not declare. Reported
13988
+ * rather than swallowed: a name here is either a typo or an addon that has
13989
+ * not booted, and both deserve a line instead of silence.
13990
+ */
13991
+ unknown: array(string()).readonly()
13992
+ });
13993
+ method(_void(), array(LogChannelDescriptorSchema).readonly()), method(object({ windows: array(LogChannelWindowSchema).readonly() }), LogChannelApplyResultSchema, { kind: "mutation" });
13815
13994
  var LogLevelSchema = _enum([
13816
13995
  "debug",
13817
13996
  "info",
@@ -27772,17 +27951,60 @@ var SetSiteLocationInputSchema = object({
27772
27951
  longitude: number().min(-180).max(180)
27773
27952
  }).nullable();
27774
27953
  /**
27775
- * One `(procedure, user-agent, ip, principal)` tuple of the HTTP request
27954
+ * The TRANSPORT a call arrived on.
27955
+ *
27956
+ * Every counted call carries exactly one of these, and `unknown` is a PLANE
27957
+ * rather than a gap: a plane that cannot attribute a call declares it here, so
27958
+ * the call lands in a named bucket instead of vanishing. `planes` summing to
27959
+ * `procedureCalls` is what makes "the sum of the planes explains the total"
27960
+ * checkable rather than asserted.
27961
+ *
27962
+ * - `http` — the Fastify tRPC plugin (`/trpc/*`), one context per request.
27963
+ * - `ws` — `applyWSSHandler`, counted per OPERATION rather than per
27964
+ * connection; the viewer talks to the hub over `wsLink`
27965
+ * exclusively, so this is the plane the HTTP census could not see.
27966
+ * - `mesh` — the in-process `$core-caps` bridge (`createCaller`), which
27967
+ * never touches a socket and therefore never touched a census.
27968
+ * - `unknown` — counted, plane undecidable. No hook produces it today, and
27969
+ * that is exactly what its `0` asserts: every plane the hub has can name
27970
+ * itself. It is an output bucket, never a knob — a call that arrives on a
27971
+ * plane nobody instrumented lands here instead of vanishing from the total.
27972
+ */
27973
+ var TransportPlaneSchema = _enum([
27974
+ "http",
27975
+ "ws",
27976
+ "mesh",
27977
+ "unknown"
27978
+ ]);
27979
+ /**
27980
+ * Calls per plane. Every key is always present, `0` included — an absent plane
27981
+ * reads as "not instrumented", which is the one thing this census must never
27982
+ * make an operator wonder about.
27983
+ */
27984
+ var TransportPlaneCountsSchema = object({
27985
+ http: number(),
27986
+ ws: number(),
27987
+ mesh: number(),
27988
+ unknown: number()
27989
+ });
27990
+ /**
27991
+ * One `(plane, procedure, user-agent, ip, principal)` tuple of the transport
27776
27992
  * census. `principal` is the DERIVED identity (`apocaliss92 (admin)`,
27777
27993
  * `scoped:1a2b3c4d (scoped-token)`, `anonymous`) that the tRPC error log
27778
27994
  * already prints - never a token, never an `Authorization` header.
27995
+ *
27996
+ * `subscriptions` is counted APART from `calls`: a subscription is opened once
27997
+ * and lives for hours, so folding it into a call count makes one long-lived
27998
+ * stream look like a storm.
27779
27999
  */
27780
28000
  var RequestCensusGroupSchema = object({
28001
+ plane: TransportPlaneSchema,
27781
28002
  procedure: string(),
27782
28003
  userAgent: string(),
27783
28004
  ip: string(),
27784
28005
  principal: string(),
27785
28006
  calls: number(),
28007
+ subscriptions: number(),
27786
28008
  perMin: number()
27787
28009
  });
27788
28010
  /**
@@ -27795,6 +28017,14 @@ var RequestCensusGroupSchema = object({
27795
28017
  var RequestCensusProcedureSchema = object({
27796
28018
  procedure: string(),
27797
28019
  calls: number(),
28020
+ /**
28021
+ * The same total, split by transport. THIS is the row that answers the
28022
+ * question the census exists for: one look at `deviceManager.listAll` says
28023
+ * which plane carried the 4 960, without joining two log lines by eye.
28024
+ */
28025
+ planes: TransportPlaneCountsSchema,
28026
+ /** Subscription STARTS on this procedure. Never folded into `calls`. */
28027
+ subscriptions: number(),
27798
28028
  perMin: number()
27799
28029
  });
27800
28030
  /**
@@ -27822,14 +28052,45 @@ var RequestCensusStatusSchema = object({
27822
28052
  */
27823
28053
  procedureCalls: number(),
27824
28054
  /**
28055
+ * `procedureCalls` split by transport. The four keys sum to
28056
+ * `procedureCalls` by construction - {@link RequestCensusSnapshotSchema}'s
28057
+ * `planesExplainTotal` is that identity, checked rather than assumed.
28058
+ */
28059
+ planes: TransportPlaneCountsSchema,
28060
+ /**
28061
+ * True iff `planes` sums to `procedureCalls`. False means a call was counted
28062
+ * on no plane at all - which is a RESULT (a plane is missing from the
28063
+ * instrument), not a failure, and it has to be visible to be read as one.
28064
+ */
28065
+ planesExplainTotal: boolean(),
28066
+ /**
27825
28067
  * tRPC WebSocket connections opened during the window. NOT calls - the WS
27826
- * transport resolves one context per connection - but the number that says
27827
- * whether a plane this census cannot see was busy while HTTP was quiet.
28068
+ * adapter resolves one context per connection - kept because a plane's call
28069
+ * count of zero against 37 open connections says something different from a
28070
+ * plane with no connections at all.
27828
28071
  */
27829
28072
  wsConnections: number(),
28073
+ /**
28074
+ * Client frames the WS plane looked at. `wsMessages` far above
28075
+ * `planes.ws + subscriptions` means most traffic is not operations
28076
+ * (keepalives, connection params) - which is itself an answer.
28077
+ */
28078
+ wsMessages: number(),
28079
+ /**
28080
+ * Subscription STARTS across every plane, excluded from `procedureCalls` on
28081
+ * purpose: one live-events stream opened at boot and held for six hours is
28082
+ * one subscription, and counting it as a call would let a quiet plane
28083
+ * masquerade as the storm.
28084
+ */
28085
+ subscriptions: number(),
28086
+ /** `subscription.stop` frames. Starts minus stops is what is still open. */
28087
+ subscriptionStops: number(),
27830
28088
  distinctGroups: number(),
27831
- /** Calls counted in the totals whose group attribution was shed at the
27832
- * cardinality bound. */
28089
+ /**
28090
+ * Operations counted in the totals whose CALLER attribution was shed at the
28091
+ * cardinality bound. Unrelated to the `unknown` PLANE: these calls know
28092
+ * which transport they arrived on, they just lost their group row.
28093
+ */
27833
28094
  unattributedCalls: number(),
27834
28095
  procedures: array(RequestCensusProcedureSchema).readonly(),
27835
28096
  groups: array(RequestCensusGroupSchema).readonly()
@@ -27852,10 +28113,11 @@ var DiagnosticIdSchema = _enum(["request-census"]);
27852
28113
  * The layers of the level hierarchy, general → specific. The most specific
27853
28114
  * layer that carries an explicit value wins.
27854
28115
  *
27855
- * `component` is DECLARED and not yet resolvable: the per-component channels
27856
- * are a later slice of the same plan, and a `levelSource` enum that has to
27857
- * grow later would force every consumer of this document to change with it.
27858
- * Nothing returns `component` today.
28116
+ * `component` became RESOLVABLE on 2026-08-27: a component is a declared log
28117
+ * CHANNEL (`stream-broker.webrtc`, `provider-reolink.baichuan`), named by
28118
+ * `scopeComponent`. It was declared-but-dark in the first slice precisely so
28119
+ * that turning it on would not force every consumer of this document to widen
28120
+ * a `levelSource` enum — which is what has now not happened.
27859
28121
  */
27860
28122
  var LoggingScopeKindSchema = _enum([
27861
28123
  "cluster",
@@ -27882,6 +28144,14 @@ var LoggingLevelLayerSchema = object({
27882
28144
  scope: LoggingScopeKindSchema,
27883
28145
  /** The node this layer speaks for; `null` on the cluster layer. */
27884
28146
  nodeId: string().nullable(),
28147
+ /**
28148
+ * The declared channel this layer speaks for; `null` on every layer but
28149
+ * `component`. Never folded into `nodeId`: a component level is CLUSTER-WIDE
28150
+ * by design — the convention this repo settled on is one orchestrator-wide
28151
+ * setting, never per node (D52) — so a component layer that carried a node
28152
+ * would invite a per-node copy of a value that has no per-node meaning.
28153
+ */
28154
+ component: string().nullable(),
27885
28155
  /** Explicitly set here, or `null` when this layer inherits. */
27886
28156
  level: LogLevelSchema$1.nullable()
27887
28157
  });
@@ -27923,6 +28193,49 @@ var DiagnosticWindowPatchSchema = object({
27923
28193
  reportEveryMs: number().int().positive().optional()
27924
28194
  });
27925
28195
  /**
28196
+ * A channel ARMED, as the document reports it.
28197
+ *
28198
+ * `armMs` is not echoed back: what an operator needs to see is the deadline
28199
+ * and the time left, because a diagnostic left running is itself an incident
28200
+ * and "armed for 10 minutes" said an hour ago is not an answer.
28201
+ */
28202
+ var LogChannelWindowStateSchema = object({
28203
+ channel: string(),
28204
+ armed: boolean(),
28205
+ /** Epoch ms the window closes at. 0 when disarmed. */
28206
+ armedUntilMs: number(),
28207
+ /** Ms left before it expires on its own. 0 when disarmed. */
28208
+ remainingMs: number(),
28209
+ /**
28210
+ * The cameras it is narrowed to, or `null` for every camera.
28211
+ *
28212
+ * A channel declared `perDevice: false` can only ever report `null` here:
28213
+ * its lines do not carry `tags: { deviceId }`, so narrowing them would
28214
+ * produce a filter that silently matches nothing. The server REFUSES such a
28215
+ * patch rather than quietly widening it — ignoring the request would teach
28216
+ * the operator that per-camera filtering works on that channel when it does
28217
+ * not.
28218
+ */
28219
+ deviceIds: array(number().int()).readonly().nullable()
28220
+ });
28221
+ /**
28222
+ * `armMs: 0` DISARMS. Same grammar as {@link DiagnosticWindowPatchSchema}, and
28223
+ * for the same reason: a channel is a window with a deadline, never a switch.
28224
+ */
28225
+ var LogChannelWindowPatchSchema = object({
28226
+ channel: string().min(1),
28227
+ armMs: number().int().min(0),
28228
+ /**
28229
+ * Narrow to these numeric device ids. Absent or `null` = every camera.
28230
+ *
28231
+ * Numeric because the repo's own rule makes it possible: every log line
28232
+ * about a device carries `tags: { deviceId }` with the numeric id. That rule
28233
+ * was paid for with a 22% thumbnail gap and a 3-hour media blackout both
28234
+ * diagnosed by hand, and this is the first thing that collects on it.
28235
+ */
28236
+ deviceIds: array(number().int()).readonly().nullable().optional()
28237
+ });
28238
+ /**
27926
28239
  * A PATCH, and patches MERGE.
27927
28240
  *
27928
28241
  * A field absent from the patch is left exactly as it was — arming a
@@ -27941,7 +28254,14 @@ var LoggingSettingsPatchSchema = object({
27941
28254
  * Only the diagnostics NAMED here change. An armed window that is not listed
27942
28255
  * keeps running — a patch is never a full replacement.
27943
28256
  */
27944
- diagnostics: array(DiagnosticWindowPatchSchema).readonly().optional()
28257
+ diagnostics: array(DiagnosticWindowPatchSchema).readonly().optional(),
28258
+ /**
28259
+ * Only the channels NAMED here change. An armed channel that is not listed
28260
+ * keeps running — same rule as `diagnostics`, because a patch that silently
28261
+ * disarmed the channels it did not mention would make the Levels page and
28262
+ * the Diagnostics page fight over the same value.
28263
+ */
28264
+ channels: array(LogChannelWindowPatchSchema).readonly().optional()
27945
28265
  });
27946
28266
  /**
27947
28267
  * Which LAYER of the hierarchy is addressed. Absent = the cluster layer.
@@ -27954,9 +28274,22 @@ var LoggingSettingsPatchSchema = object({
27954
28274
  * authority over the whole hierarchy and answers for every layer, so the
27955
28275
  * layer selector needs a name the transport does not already own.
27956
28276
  */
27957
- var GetLoggingSettingsInputSchema = object({ scopeNodeId: string().optional() });
28277
+ var GetLoggingSettingsInputSchema = object({
28278
+ scopeNodeId: string().optional(),
28279
+ /**
28280
+ * The declared CHANNEL this document is addressed at, when the caller wants
28281
+ * the `component` layer. Absent = the node/cluster hierarchy only.
28282
+ *
28283
+ * Naming it separately rather than overloading `scopeNodeId` keeps the two
28284
+ * axes from collapsing: a component level is cluster-wide, a node level is
28285
+ * not, and one selector for both would make "which of these two did I just
28286
+ * set" unanswerable — the exact ambiguity `explicit` exists to remove.
28287
+ */
28288
+ scopeComponent: string().optional()
28289
+ });
27958
28290
  var SetLoggingSettingsInputSchema = object({
27959
28291
  scopeNodeId: string().optional(),
28292
+ scopeComponent: string().optional(),
27960
28293
  patch: LoggingSettingsPatchSchema
27961
28294
  });
27962
28295
  /**
@@ -27971,9 +28304,20 @@ var SetLoggingSettingsInputSchema = object({
27971
28304
  var LoggingSettingsStateSchema = object({
27972
28305
  /** The layer this document was read at. `null` = the cluster layer. */
27973
28306
  scopeNodeId: string().nullable(),
28307
+ /** The channel this document was read at. `null` = no component layer. */
28308
+ scopeComponent: string().nullable(),
27974
28309
  effective: LoggingEffectiveSchema,
27975
28310
  explicit: LoggingExplicitSchema,
27976
28311
  activeWindows: array(DiagnosticWindowSchema).readonly(),
28312
+ /**
28313
+ * Every channel the cluster's addons DECLARE, gathered from the
28314
+ * `log-channels` providers. Not stored anywhere: assembled per read, so a
28315
+ * channel added by a redeployed addon appears without anybody editing a
28316
+ * list, and a channel whose addon is gone stops being offered.
28317
+ */
28318
+ channels: array(LogChannelDescriptorSchema).readonly(),
28319
+ /** The channels ARMED right now, each with its deadline. */
28320
+ activeChannels: array(LogChannelWindowStateSchema).readonly(),
27977
28321
  persisted: boolean()
27978
28322
  });
27979
28323
  method(_void(), FeatureManifestSchema), method(_void(), HealthStatusSchema), method(_void(), FeatureManifestSchema), method(_void(), array(NetworkAddressSchema).readonly()), method(_void(), unknown().nullable(), { auth: "admin" }), method(record(string(), unknown()), _null(), {
@@ -29634,6 +29978,12 @@ Object.freeze({
29634
29978
  addonId: null,
29635
29979
  access: "view"
29636
29980
  },
29981
+ "dataStoreProvider.aggregate": {
29982
+ capName: "data-store-provider",
29983
+ capScope: "system",
29984
+ addonId: null,
29985
+ access: "view"
29986
+ },
29637
29987
  "dataStoreProvider.count": {
29638
29988
  capName: "data-store-provider",
29639
29989
  capScope: "system",
@@ -30048,6 +30398,12 @@ Object.freeze({
30048
30398
  addonId: null,
30049
30399
  access: "view"
30050
30400
  },
30401
+ "deviceManager.getChildrenBatch": {
30402
+ capName: "device-manager",
30403
+ capScope: "system",
30404
+ addonId: null,
30405
+ access: "view"
30406
+ },
30051
30407
  "deviceManager.getConfigSchema": {
30052
30408
  capName: "device-manager",
30053
30409
  capScope: "system",
@@ -31098,6 +31454,18 @@ Object.freeze({
31098
31454
  addonId: null,
31099
31455
  access: "create"
31100
31456
  },
31457
+ "logChannels.apply": {
31458
+ capName: "log-channels",
31459
+ capScope: "system",
31460
+ addonId: null,
31461
+ access: "create"
31462
+ },
31463
+ "logChannels.list": {
31464
+ capName: "log-channels",
31465
+ capScope: "system",
31466
+ addonId: null,
31467
+ access: "view"
31468
+ },
31101
31469
  "logDestination.query": {
31102
31470
  capName: "log-destination",
31103
31471
  capScope: "system",
@@ -33252,6 +33620,12 @@ Object.freeze({
33252
33620
  addonId: null,
33253
33621
  access: "create"
33254
33622
  },
33623
+ "settingsStore.aggregate": {
33624
+ capName: "settings-store",
33625
+ capScope: "system",
33626
+ addonId: null,
33627
+ access: "view"
33628
+ },
33255
33629
  "settingsStore.count": {
33256
33630
  capName: "settings-store",
33257
33631
  capScope: "system",
@@ -34831,6 +35205,11 @@ Object.freeze({
34831
35205
  form: "single",
34832
35206
  optional: false
34833
35207
  }],
35208
+ "deviceManager.getChildrenBatch": [{
35209
+ name: "parentDeviceIds",
35210
+ form: "array",
35211
+ optional: false
35212
+ }],
34834
35213
  "deviceManager.getConfigSchema": [{
34835
35214
  name: "deviceId",
34836
35215
  form: "single",