@camstack/addon-notifiers 1.2.42 → 1.2.45

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/addon.js CHANGED
@@ -13377,6 +13377,114 @@ method(LogEntrySchema, _void(), { kind: "mutation" }), method(object({
13377
13377
  limit: number().optional(),
13378
13378
  tags: record(string(), string()).optional()
13379
13379
  }), array(LogEntrySchema).readonly());
13380
+ /**
13381
+ * `failure-contribution` — the capability an addon reports its OWN losses
13382
+ * through, per camera, with the denominator attached. It stores nothing.
13383
+ *
13384
+ * ## The twin of `load-contribution`, and why it is a twin and not a field
13385
+ *
13386
+ * `load-contribution` answers *what did this camera COST*. This answers *what
13387
+ * did this camera LOSE*. The reporting discipline is identical and deliberately
13388
+ * copied: the contributor reports what it already knows, hub-main adds only
13389
+ * `addonId`, nothing needs global knowledge, and there is no central list for
13390
+ * somebody to forget to edit.
13391
+ *
13392
+ * They are not merged, because their invariants are opposites:
13393
+ *
13394
+ * - a `load-contribution` measurement is **absent, never zero** — a zero would
13395
+ * claim a camera cost nothing, which is a measurement nobody made;
13396
+ * - a `failure-contribution` zero is the **most valuable value on the
13397
+ * surface** — `attempts: 400, succeeded: 400` is the proof a fix landed,
13398
+ * and it is exactly what an absent entry cannot say.
13399
+ *
13400
+ * Putting a loss counter on a cost entry would also break the reconciliation
13401
+ * that gives `load-contribution` its point: contributions are subtracted from
13402
+ * `metrics.node-processes-snapshot` to find processes nobody claims. A failure
13403
+ * has no process.
13404
+ *
13405
+ * ## Why not a log line, since the counters already exist
13406
+ *
13407
+ * Several of these paths already counted themselves — `CaptureScheduler`'s
13408
+ * per-device window, `KeyFrameCaptureLog`, `bumpCropMetric`. Every one of them
13409
+ * ends in a log line, and a log line is the thing the operator asked to stop
13410
+ * needing: *"possiamo armare questi errori intanto? Così al prossimo giro
13411
+ * ricontrolliamo tutti questi punti"*. Reading them meant grepping Loki and
13412
+ * hand-correlating timestamps, which is how a 22% thumbnail gap and a 3-hour
13413
+ * media blackout were both diagnosed. The counters stay; this is where they can
13414
+ * be READ.
13415
+ *
13416
+ * ## The rate is served with its denominator or not at all
13417
+ *
13418
+ * Every entry carries `attempts` and `succeeded`. A miss count alone is
13419
+ * unreadable: on 2026-08-28 the enrichment-crop miss count read as "35x worse
13420
+ * than yesterday" and was **flat across twelve hours** once divided by the
13421
+ * successes on the same path. A surface that publishes only the numerator
13422
+ * reproduces that mistake on every read.
13423
+ *
13424
+ * ## Shape
13425
+ *
13426
+ * Copied from `load-contribution.cap.ts` (`mode: 'collection'`,
13427
+ * `internal: true`, `mount: { kind: 'skip' }`): no tRPC route of its own and no
13428
+ * generated hooks, while `addons.listCapabilityProviders` still enumerates it
13429
+ * and the hub's `CapabilityRegistry` still holds an RPC proxy per provider — so
13430
+ * a forked runner's entries reach hub-main over transport that already exists.
13431
+ * No new UDS message, no second registry (D3). The operator reads the assembled
13432
+ * result through `system.getFailureContributions`.
13433
+ */
13434
+ var FailureReasonCountSchema = object({
13435
+ /**
13436
+ * Why the attempt did not land, in the contributor's own vocabulary —
13437
+ * `worker-lease-gone`, `queue-overflow`, `timeout`, `empty-read`. The same
13438
+ * strings that already appear in this repo's logs and, where one exists, the
13439
+ * same string the per-track `previewMissReason` records (D276): a second
13440
+ * vocabulary for the same loss would make the row and the counter
13441
+ * un-joinable.
13442
+ */
13443
+ reason: string(),
13444
+ count: number().int().nonnegative()
13445
+ });
13446
+ var FailureContributionSchema = object({
13447
+ /**
13448
+ * The failing path — `enrichment-crop`, `inference`, `plate-ocr`,
13449
+ * `person-over-vehicle`. Free text, for the reason `load-contribution` keeps
13450
+ * `unit` free: the families are owned by different addons and a shared enum
13451
+ * is a central list that rots invisibly.
13452
+ */
13453
+ family: string(),
13454
+ /**
13455
+ * The NUMERIC device id — the same value every log line carries as
13456
+ * `tags.deviceId`. Never nullable and never absent: a contributor that
13457
+ * cannot name the camera must not emit the entry, because a fleet total
13458
+ * cannot answer the only question anybody asks of this surface.
13459
+ */
13460
+ deviceId: number().int().positive(),
13461
+ /**
13462
+ * A second dimension inside the family: the model / step id for an inference
13463
+ * timeout, so "which camera AND which model" is one read. Absent when the
13464
+ * family has a single variant.
13465
+ */
13466
+ variant: string().optional(),
13467
+ /**
13468
+ * Epoch ms this counter started — the INCARNATION MARKER. A consumer
13469
+ * differencing two reads must drop the interval when it changes, because the
13470
+ * counter restarted from zero in a respawned runner. Same discipline as
13471
+ * `LoadContribution.startedAtMs`.
13472
+ */
13473
+ sinceMs: number(),
13474
+ /** Epoch ms it was read. `atMs - sinceMs` is the interval this covers. */
13475
+ atMs: number(),
13476
+ /**
13477
+ * THE DENOMINATOR — every attempt on this path for this camera in the
13478
+ * window. A failure count published without it is the mistake this schema
13479
+ * exists to make impossible.
13480
+ */
13481
+ attempts: number().int().nonnegative(),
13482
+ /** Attempts that landed. `attempts - succeeded` is the loss. */
13483
+ succeeded: number().int().nonnegative(),
13484
+ /** The loss, partitioned. Sums to `attempts - succeeded`. */
13485
+ reasons: array(FailureReasonCountSchema).readonly()
13486
+ });
13487
+ method(_void(), array(FailureContributionSchema).readonly());
13380
13488
  var LoadContributionSchema = object({
13381
13489
  role: _enum([
13382
13490
  "decode",
@@ -13684,6 +13792,50 @@ var NodeProcessSchema = object({
13684
13792
  /** Wall-clock uptime (seconds). Parsed from `ps etime`. */
13685
13793
  uptimeSec: number()
13686
13794
  });
13795
+ /**
13796
+ * One retained container-memory reading.
13797
+ *
13798
+ * `atMs` is the timestamp of the PROCESS snapshot taken in the same tick, not
13799
+ * a second clock: that is what makes "processes sum to X, container says Y"
13800
+ * subtractable per point rather than an eyeballed comparison of two series
13801
+ * sampled at different instants.
13802
+ *
13803
+ * A reduced window keeps the sample with the LARGEST `currentBytes` in each
13804
+ * bucket, WHOLE. Taking a per-field maximum would synthesise a row whose parts
13805
+ * never coexisted, and a mean would smear away the peak this exists to find.
13806
+ */
13807
+ var ContainerMemoryPointSchema = object({
13808
+ /** Which hierarchy answered, so a reading is never ambiguous. */
13809
+ source: _enum(["cgroup-v2", "cgroup-v1"]),
13810
+ /** `memory.current` (v2) / `memory.usage_in_bytes` (v1). Always known. */
13811
+ currentBytes: number(),
13812
+ /** The cgroup's ceiling. `null` = NO LIMIT — never a sentinel, never zero. */
13813
+ limitBytes: number().nullable(),
13814
+ /** Anonymous pages: the closest thing to "what the processes allocated". */
13815
+ anonBytes: number().nullable(),
13816
+ /** Page cache. Charged to the cgroup, owned by no process. */
13817
+ fileBytes: number().nullable(),
13818
+ /**
13819
+ * Shared memory — and the field that explained the largest single surprise.
13820
+ * The i915 driver backs GPU buffers with shmem, so an inference pool or a
13821
+ * hardware-decode session holding DRM objects is charged HERE and appears
13822
+ * nowhere in a `ps` scan.
13823
+ */
13824
+ shmemBytes: number().nullable(),
13825
+ /** Kernel slab charged to this cgroup. `null` on v1, which never publishes it. */
13826
+ slabBytes: number().nullable(),
13827
+ /**
13828
+ * Shrinkable i915 GEM object bytes, from debugfs.
13829
+ *
13830
+ * **Host-wide across every DRM client, NOT cgroup-scoped.** It is not a
13831
+ * component of `currentBytes` and must not be subtracted from it; it says
13832
+ * what put the shmem there, where `shmemBytes` only says how much.
13833
+ *
13834
+ * `null` wherever debugfs is not mounted — which is inside every camstack
13835
+ * container today — and on any node with no Intel GPU.
13836
+ */
13837
+ gpuShmemBytes: number().nullable()
13838
+ }).extend({ atMs: number() });
13687
13839
  var DumpHeapSnapshotInputSchema = object({
13688
13840
  /** The addon whose runner should dump a heap snapshot. */
13689
13841
  addonId: string() });
@@ -13747,6 +13899,21 @@ var NodeLoadSeriesSchema = object({
13747
13899
  /** One entry per function seen in the window, heaviest-first. */
13748
13900
  series: array(LoadFunctionSeriesSchema).readonly(),
13749
13901
  /**
13902
+ * The CONTAINER's memory over the same window, oldest-first.
13903
+ *
13904
+ * Sits next to `series` rather than in a method of its own because the whole
13905
+ * question is a subtraction: the per-process rows in `series` sum to one
13906
+ * number and this one is another, and an operator who has to issue two calls
13907
+ * to compare them will compare two different instants. Same reader, same
13908
+ * `sinceMs`, same `bucketMs`, same timestamps.
13909
+ *
13910
+ * **EMPTY means ABSENT, never zero.** A node with no cgroup — a developer
13911
+ * Mac, a bare-metal host, a container with the hierarchy hidden — reports no
13912
+ * points at all. A zero here would be indistinguishable from a healthy
13913
+ * container and is precisely the lie this field exists to avoid.
13914
+ */
13915
+ containerMemory: array(ContainerMemoryPointSchema).readonly(),
13916
+ /**
13750
13917
  * Width of one returned bucket, in ms. Equals the sampling cadence when no
13751
13918
  * reduction was needed — so a caller can always say what one point covers
13752
13919
  * without having to know whether it was reduced.
@@ -17903,6 +18070,20 @@ var TrackSchema = object({
17903
18070
  * `=== true` and render nothing otherwise — never infer "no rider".
17904
18071
  */
17905
18072
  hasRider: boolean().optional(),
18073
+ /**
18074
+ * WHY this track ended without a NATIVE best-shot tile
18075
+ * ([D276](../decisions/adr-0276-a-stand-in-tile-is-provisional-and-a-close-says-why.md)) —
18076
+ * a composed token line (`no-key-frame capture=keyframe:native-missx4`,
18077
+ * `derive-returned-null tile=standin`, …) written at close and CLEARED by
18078
+ * the late-keyFrame upgrade when a native tile lands after all. The
18079
+ * operator-facing answer to "perché manca l'immagine?" on a track whose
18080
+ * tile is a face/plate stand-in, a raster crop, or an icon.
18081
+ *
18082
+ * **Absent ≠ "missed silently"**: a row written before the column, a hub
18083
+ * that predates the field, and every track whose tile landed native all
18084
+ * omit it. Render nothing when absent.
18085
+ */
18086
+ previewMissReason: string().optional(),
17906
18087
  ...TrackFlagFields,
17907
18088
  ...TrackRetrainFields
17908
18089
  });
@@ -25676,10 +25857,10 @@ DeviceType.Camera, DeviceType.Sensor, DeviceType.Switch, method(object({ deviceI
25676
25857
  * recording config. NOTE on events (source of truth, R5/C3): this cap carries
25677
25858
  * NO event surface — `getPlaybackManifest` returns playlist URLs only. Timeline
25678
25859
  * events (motion/object/audio) come from `pipelineAnalytics` (durable SQLite
25679
- * rows); the recorder's internal EventMap markers are ephemeral in-RAM
25680
- * annotations that are not exposed here and must not be treated as an event
25681
- * feed. Event<->footage joins are by time, padded with the shared `EVENT_PAD_MS`
25682
- * (`interfaces/recording-config.ts`).
25860
+ * rows) and are the ONLY event surface — the recorder has none. The in-RAM
25861
+ * playback markers it used to build were deleted on 2026-08-29 because nothing
25862
+ * ever read them. Event<->footage joins are by time, padded with the shared
25863
+ * `EVENT_PAD_MS` (`interfaces/recording-config.ts`).
25683
25864
  */
25684
25865
  var RecordingStatusSchema = object({
25685
25866
  deviceId: number(),
@@ -27129,6 +27310,13 @@ var LoggingSettingsPatchSchema = object({
27129
27310
  * anyone but its owner.
27130
27311
  */
27131
27312
  var ReportedLoadContributionSchema = LoadContributionSchema.extend({ addonId: string() });
27313
+ /**
27314
+ * One per-camera failure counter, plus WHO reported it.
27315
+ *
27316
+ * Same rule as {@link ReportedLoadContributionSchema}: `addonId` is stamped by
27317
+ * the hub as it enumerates providers, never by the contributor.
27318
+ */
27319
+ var ReportedFailureContributionSchema = FailureContributionSchema.extend({ addonId: string() });
27132
27320
  var GetLoggingSettingsInputSchema = object({
27133
27321
  scopeNodeId: string().optional(),
27134
27322
  /**
@@ -27187,7 +27375,7 @@ method(_void(), FeatureManifestSchema), method(_void(), HealthStatusSchema), met
27187
27375
  }), method(_void(), SiteLocationStatusSchema, {
27188
27376
  kind: "mutation",
27189
27377
  auth: "admin"
27190
- }), method(_void(), RequestCensusStatusSchema, { auth: "admin" }), method(_void(), array(ReportedLoadContributionSchema).readonly(), { auth: "admin" }), method(GetLoggingSettingsInputSchema, LoggingSettingsStateSchema, { auth: "admin" }), method(SetLoggingSettingsInputSchema, LoggingSettingsStateSchema, {
27378
+ }), method(_void(), RequestCensusStatusSchema, { auth: "admin" }), method(_void(), array(ReportedLoadContributionSchema).readonly(), { auth: "admin" }), method(_void(), array(ReportedFailureContributionSchema).readonly(), { auth: "admin" }), method(GetLoggingSettingsInputSchema, LoggingSettingsStateSchema, { auth: "admin" }), method(SetLoggingSettingsInputSchema, LoggingSettingsStateSchema, {
27191
27379
  kind: "mutation",
27192
27380
  auth: "admin"
27193
27381
  });
@@ -29769,6 +29957,12 @@ Object.freeze({
29769
29957
  addonId: null,
29770
29958
  access: "create"
29771
29959
  },
29960
+ "failureContribution.list": {
29961
+ capName: "failure-contribution",
29962
+ capScope: "system",
29963
+ addonId: null,
29964
+ access: "view"
29965
+ },
29772
29966
  "fanControl.setDirection": {
29773
29967
  capName: "fan-control",
29774
29968
  capScope: "device",
@@ -33075,6 +33269,12 @@ Object.freeze({
33075
33269
  addonId: null,
33076
33270
  access: "create"
33077
33271
  },
33272
+ "system.getFailureContributions": {
33273
+ capName: "system",
33274
+ capScope: "system",
33275
+ addonId: null,
33276
+ access: "view"
33277
+ },
33078
33278
  "system.getLoadContributions": {
33079
33279
  capName: "system",
33080
33280
  capScope: "system",
package/dist/addon.mjs CHANGED
@@ -13350,6 +13350,114 @@ method(LogEntrySchema, _void(), { kind: "mutation" }), method(object({
13350
13350
  limit: number().optional(),
13351
13351
  tags: record(string(), string()).optional()
13352
13352
  }), array(LogEntrySchema).readonly());
13353
+ /**
13354
+ * `failure-contribution` — the capability an addon reports its OWN losses
13355
+ * through, per camera, with the denominator attached. It stores nothing.
13356
+ *
13357
+ * ## The twin of `load-contribution`, and why it is a twin and not a field
13358
+ *
13359
+ * `load-contribution` answers *what did this camera COST*. This answers *what
13360
+ * did this camera LOSE*. The reporting discipline is identical and deliberately
13361
+ * copied: the contributor reports what it already knows, hub-main adds only
13362
+ * `addonId`, nothing needs global knowledge, and there is no central list for
13363
+ * somebody to forget to edit.
13364
+ *
13365
+ * They are not merged, because their invariants are opposites:
13366
+ *
13367
+ * - a `load-contribution` measurement is **absent, never zero** — a zero would
13368
+ * claim a camera cost nothing, which is a measurement nobody made;
13369
+ * - a `failure-contribution` zero is the **most valuable value on the
13370
+ * surface** — `attempts: 400, succeeded: 400` is the proof a fix landed,
13371
+ * and it is exactly what an absent entry cannot say.
13372
+ *
13373
+ * Putting a loss counter on a cost entry would also break the reconciliation
13374
+ * that gives `load-contribution` its point: contributions are subtracted from
13375
+ * `metrics.node-processes-snapshot` to find processes nobody claims. A failure
13376
+ * has no process.
13377
+ *
13378
+ * ## Why not a log line, since the counters already exist
13379
+ *
13380
+ * Several of these paths already counted themselves — `CaptureScheduler`'s
13381
+ * per-device window, `KeyFrameCaptureLog`, `bumpCropMetric`. Every one of them
13382
+ * ends in a log line, and a log line is the thing the operator asked to stop
13383
+ * needing: *"possiamo armare questi errori intanto? Così al prossimo giro
13384
+ * ricontrolliamo tutti questi punti"*. Reading them meant grepping Loki and
13385
+ * hand-correlating timestamps, which is how a 22% thumbnail gap and a 3-hour
13386
+ * media blackout were both diagnosed. The counters stay; this is where they can
13387
+ * be READ.
13388
+ *
13389
+ * ## The rate is served with its denominator or not at all
13390
+ *
13391
+ * Every entry carries `attempts` and `succeeded`. A miss count alone is
13392
+ * unreadable: on 2026-08-28 the enrichment-crop miss count read as "35x worse
13393
+ * than yesterday" and was **flat across twelve hours** once divided by the
13394
+ * successes on the same path. A surface that publishes only the numerator
13395
+ * reproduces that mistake on every read.
13396
+ *
13397
+ * ## Shape
13398
+ *
13399
+ * Copied from `load-contribution.cap.ts` (`mode: 'collection'`,
13400
+ * `internal: true`, `mount: { kind: 'skip' }`): no tRPC route of its own and no
13401
+ * generated hooks, while `addons.listCapabilityProviders` still enumerates it
13402
+ * and the hub's `CapabilityRegistry` still holds an RPC proxy per provider — so
13403
+ * a forked runner's entries reach hub-main over transport that already exists.
13404
+ * No new UDS message, no second registry (D3). The operator reads the assembled
13405
+ * result through `system.getFailureContributions`.
13406
+ */
13407
+ var FailureReasonCountSchema = object({
13408
+ /**
13409
+ * Why the attempt did not land, in the contributor's own vocabulary —
13410
+ * `worker-lease-gone`, `queue-overflow`, `timeout`, `empty-read`. The same
13411
+ * strings that already appear in this repo's logs and, where one exists, the
13412
+ * same string the per-track `previewMissReason` records (D276): a second
13413
+ * vocabulary for the same loss would make the row and the counter
13414
+ * un-joinable.
13415
+ */
13416
+ reason: string(),
13417
+ count: number().int().nonnegative()
13418
+ });
13419
+ var FailureContributionSchema = object({
13420
+ /**
13421
+ * The failing path — `enrichment-crop`, `inference`, `plate-ocr`,
13422
+ * `person-over-vehicle`. Free text, for the reason `load-contribution` keeps
13423
+ * `unit` free: the families are owned by different addons and a shared enum
13424
+ * is a central list that rots invisibly.
13425
+ */
13426
+ family: string(),
13427
+ /**
13428
+ * The NUMERIC device id — the same value every log line carries as
13429
+ * `tags.deviceId`. Never nullable and never absent: a contributor that
13430
+ * cannot name the camera must not emit the entry, because a fleet total
13431
+ * cannot answer the only question anybody asks of this surface.
13432
+ */
13433
+ deviceId: number().int().positive(),
13434
+ /**
13435
+ * A second dimension inside the family: the model / step id for an inference
13436
+ * timeout, so "which camera AND which model" is one read. Absent when the
13437
+ * family has a single variant.
13438
+ */
13439
+ variant: string().optional(),
13440
+ /**
13441
+ * Epoch ms this counter started — the INCARNATION MARKER. A consumer
13442
+ * differencing two reads must drop the interval when it changes, because the
13443
+ * counter restarted from zero in a respawned runner. Same discipline as
13444
+ * `LoadContribution.startedAtMs`.
13445
+ */
13446
+ sinceMs: number(),
13447
+ /** Epoch ms it was read. `atMs - sinceMs` is the interval this covers. */
13448
+ atMs: number(),
13449
+ /**
13450
+ * THE DENOMINATOR — every attempt on this path for this camera in the
13451
+ * window. A failure count published without it is the mistake this schema
13452
+ * exists to make impossible.
13453
+ */
13454
+ attempts: number().int().nonnegative(),
13455
+ /** Attempts that landed. `attempts - succeeded` is the loss. */
13456
+ succeeded: number().int().nonnegative(),
13457
+ /** The loss, partitioned. Sums to `attempts - succeeded`. */
13458
+ reasons: array(FailureReasonCountSchema).readonly()
13459
+ });
13460
+ method(_void(), array(FailureContributionSchema).readonly());
13353
13461
  var LoadContributionSchema = object({
13354
13462
  role: _enum([
13355
13463
  "decode",
@@ -13657,6 +13765,50 @@ var NodeProcessSchema = object({
13657
13765
  /** Wall-clock uptime (seconds). Parsed from `ps etime`. */
13658
13766
  uptimeSec: number()
13659
13767
  });
13768
+ /**
13769
+ * One retained container-memory reading.
13770
+ *
13771
+ * `atMs` is the timestamp of the PROCESS snapshot taken in the same tick, not
13772
+ * a second clock: that is what makes "processes sum to X, container says Y"
13773
+ * subtractable per point rather than an eyeballed comparison of two series
13774
+ * sampled at different instants.
13775
+ *
13776
+ * A reduced window keeps the sample with the LARGEST `currentBytes` in each
13777
+ * bucket, WHOLE. Taking a per-field maximum would synthesise a row whose parts
13778
+ * never coexisted, and a mean would smear away the peak this exists to find.
13779
+ */
13780
+ var ContainerMemoryPointSchema = object({
13781
+ /** Which hierarchy answered, so a reading is never ambiguous. */
13782
+ source: _enum(["cgroup-v2", "cgroup-v1"]),
13783
+ /** `memory.current` (v2) / `memory.usage_in_bytes` (v1). Always known. */
13784
+ currentBytes: number(),
13785
+ /** The cgroup's ceiling. `null` = NO LIMIT — never a sentinel, never zero. */
13786
+ limitBytes: number().nullable(),
13787
+ /** Anonymous pages: the closest thing to "what the processes allocated". */
13788
+ anonBytes: number().nullable(),
13789
+ /** Page cache. Charged to the cgroup, owned by no process. */
13790
+ fileBytes: number().nullable(),
13791
+ /**
13792
+ * Shared memory — and the field that explained the largest single surprise.
13793
+ * The i915 driver backs GPU buffers with shmem, so an inference pool or a
13794
+ * hardware-decode session holding DRM objects is charged HERE and appears
13795
+ * nowhere in a `ps` scan.
13796
+ */
13797
+ shmemBytes: number().nullable(),
13798
+ /** Kernel slab charged to this cgroup. `null` on v1, which never publishes it. */
13799
+ slabBytes: number().nullable(),
13800
+ /**
13801
+ * Shrinkable i915 GEM object bytes, from debugfs.
13802
+ *
13803
+ * **Host-wide across every DRM client, NOT cgroup-scoped.** It is not a
13804
+ * component of `currentBytes` and must not be subtracted from it; it says
13805
+ * what put the shmem there, where `shmemBytes` only says how much.
13806
+ *
13807
+ * `null` wherever debugfs is not mounted — which is inside every camstack
13808
+ * container today — and on any node with no Intel GPU.
13809
+ */
13810
+ gpuShmemBytes: number().nullable()
13811
+ }).extend({ atMs: number() });
13660
13812
  var DumpHeapSnapshotInputSchema = object({
13661
13813
  /** The addon whose runner should dump a heap snapshot. */
13662
13814
  addonId: string() });
@@ -13720,6 +13872,21 @@ var NodeLoadSeriesSchema = object({
13720
13872
  /** One entry per function seen in the window, heaviest-first. */
13721
13873
  series: array(LoadFunctionSeriesSchema).readonly(),
13722
13874
  /**
13875
+ * The CONTAINER's memory over the same window, oldest-first.
13876
+ *
13877
+ * Sits next to `series` rather than in a method of its own because the whole
13878
+ * question is a subtraction: the per-process rows in `series` sum to one
13879
+ * number and this one is another, and an operator who has to issue two calls
13880
+ * to compare them will compare two different instants. Same reader, same
13881
+ * `sinceMs`, same `bucketMs`, same timestamps.
13882
+ *
13883
+ * **EMPTY means ABSENT, never zero.** A node with no cgroup — a developer
13884
+ * Mac, a bare-metal host, a container with the hierarchy hidden — reports no
13885
+ * points at all. A zero here would be indistinguishable from a healthy
13886
+ * container and is precisely the lie this field exists to avoid.
13887
+ */
13888
+ containerMemory: array(ContainerMemoryPointSchema).readonly(),
13889
+ /**
13723
13890
  * Width of one returned bucket, in ms. Equals the sampling cadence when no
13724
13891
  * reduction was needed — so a caller can always say what one point covers
13725
13892
  * without having to know whether it was reduced.
@@ -17876,6 +18043,20 @@ var TrackSchema = object({
17876
18043
  * `=== true` and render nothing otherwise — never infer "no rider".
17877
18044
  */
17878
18045
  hasRider: boolean().optional(),
18046
+ /**
18047
+ * WHY this track ended without a NATIVE best-shot tile
18048
+ * ([D276](../decisions/adr-0276-a-stand-in-tile-is-provisional-and-a-close-says-why.md)) —
18049
+ * a composed token line (`no-key-frame capture=keyframe:native-missx4`,
18050
+ * `derive-returned-null tile=standin`, …) written at close and CLEARED by
18051
+ * the late-keyFrame upgrade when a native tile lands after all. The
18052
+ * operator-facing answer to "perché manca l'immagine?" on a track whose
18053
+ * tile is a face/plate stand-in, a raster crop, or an icon.
18054
+ *
18055
+ * **Absent ≠ "missed silently"**: a row written before the column, a hub
18056
+ * that predates the field, and every track whose tile landed native all
18057
+ * omit it. Render nothing when absent.
18058
+ */
18059
+ previewMissReason: string().optional(),
17879
18060
  ...TrackFlagFields,
17880
18061
  ...TrackRetrainFields
17881
18062
  });
@@ -25649,10 +25830,10 @@ DeviceType.Camera, DeviceType.Sensor, DeviceType.Switch, method(object({ deviceI
25649
25830
  * recording config. NOTE on events (source of truth, R5/C3): this cap carries
25650
25831
  * NO event surface — `getPlaybackManifest` returns playlist URLs only. Timeline
25651
25832
  * events (motion/object/audio) come from `pipelineAnalytics` (durable SQLite
25652
- * rows); the recorder's internal EventMap markers are ephemeral in-RAM
25653
- * annotations that are not exposed here and must not be treated as an event
25654
- * feed. Event<->footage joins are by time, padded with the shared `EVENT_PAD_MS`
25655
- * (`interfaces/recording-config.ts`).
25833
+ * rows) and are the ONLY event surface — the recorder has none. The in-RAM
25834
+ * playback markers it used to build were deleted on 2026-08-29 because nothing
25835
+ * ever read them. Event<->footage joins are by time, padded with the shared
25836
+ * `EVENT_PAD_MS` (`interfaces/recording-config.ts`).
25656
25837
  */
25657
25838
  var RecordingStatusSchema = object({
25658
25839
  deviceId: number(),
@@ -27102,6 +27283,13 @@ var LoggingSettingsPatchSchema = object({
27102
27283
  * anyone but its owner.
27103
27284
  */
27104
27285
  var ReportedLoadContributionSchema = LoadContributionSchema.extend({ addonId: string() });
27286
+ /**
27287
+ * One per-camera failure counter, plus WHO reported it.
27288
+ *
27289
+ * Same rule as {@link ReportedLoadContributionSchema}: `addonId` is stamped by
27290
+ * the hub as it enumerates providers, never by the contributor.
27291
+ */
27292
+ var ReportedFailureContributionSchema = FailureContributionSchema.extend({ addonId: string() });
27105
27293
  var GetLoggingSettingsInputSchema = object({
27106
27294
  scopeNodeId: string().optional(),
27107
27295
  /**
@@ -27160,7 +27348,7 @@ method(_void(), FeatureManifestSchema), method(_void(), HealthStatusSchema), met
27160
27348
  }), method(_void(), SiteLocationStatusSchema, {
27161
27349
  kind: "mutation",
27162
27350
  auth: "admin"
27163
- }), method(_void(), RequestCensusStatusSchema, { auth: "admin" }), method(_void(), array(ReportedLoadContributionSchema).readonly(), { auth: "admin" }), method(GetLoggingSettingsInputSchema, LoggingSettingsStateSchema, { auth: "admin" }), method(SetLoggingSettingsInputSchema, LoggingSettingsStateSchema, {
27351
+ }), method(_void(), RequestCensusStatusSchema, { auth: "admin" }), method(_void(), array(ReportedLoadContributionSchema).readonly(), { auth: "admin" }), method(_void(), array(ReportedFailureContributionSchema).readonly(), { auth: "admin" }), method(GetLoggingSettingsInputSchema, LoggingSettingsStateSchema, { auth: "admin" }), method(SetLoggingSettingsInputSchema, LoggingSettingsStateSchema, {
27164
27352
  kind: "mutation",
27165
27353
  auth: "admin"
27166
27354
  });
@@ -29742,6 +29930,12 @@ Object.freeze({
29742
29930
  addonId: null,
29743
29931
  access: "create"
29744
29932
  },
29933
+ "failureContribution.list": {
29934
+ capName: "failure-contribution",
29935
+ capScope: "system",
29936
+ addonId: null,
29937
+ access: "view"
29938
+ },
29745
29939
  "fanControl.setDirection": {
29746
29940
  capName: "fan-control",
29747
29941
  capScope: "device",
@@ -33048,6 +33242,12 @@ Object.freeze({
33048
33242
  addonId: null,
33049
33243
  access: "create"
33050
33244
  },
33245
+ "system.getFailureContributions": {
33246
+ capName: "system",
33247
+ capScope: "system",
33248
+ addonId: null,
33249
+ access: "view"
33250
+ },
33051
33251
  "system.getLoadContributions": {
33052
33252
  capName: "system",
33053
33253
  capScope: "system",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@camstack/addon-notifiers",
3
- "version": "1.2.42",
3
+ "version": "1.2.45",
4
4
  "description": "System notifiers addon for CamStack — a `notification-output` collection provider hosting per-kind notifier adapters (ntfy, pushover, gotify, telegram, discord, webhook, zentik).",
5
5
  "keywords": [
6
6
  "camstack",