@camstack/addon-provider-rademacher 0.2.37 → 0.2.40

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
@@ -14452,6 +14452,114 @@ method(LogEntrySchema, _void(), { kind: "mutation" }), method(object({
14452
14452
  limit: number().optional(),
14453
14453
  tags: record(string(), string()).optional()
14454
14454
  }), array(LogEntrySchema).readonly());
14455
+ /**
14456
+ * `failure-contribution` — the capability an addon reports its OWN losses
14457
+ * through, per camera, with the denominator attached. It stores nothing.
14458
+ *
14459
+ * ## The twin of `load-contribution`, and why it is a twin and not a field
14460
+ *
14461
+ * `load-contribution` answers *what did this camera COST*. This answers *what
14462
+ * did this camera LOSE*. The reporting discipline is identical and deliberately
14463
+ * copied: the contributor reports what it already knows, hub-main adds only
14464
+ * `addonId`, nothing needs global knowledge, and there is no central list for
14465
+ * somebody to forget to edit.
14466
+ *
14467
+ * They are not merged, because their invariants are opposites:
14468
+ *
14469
+ * - a `load-contribution` measurement is **absent, never zero** — a zero would
14470
+ * claim a camera cost nothing, which is a measurement nobody made;
14471
+ * - a `failure-contribution` zero is the **most valuable value on the
14472
+ * surface** — `attempts: 400, succeeded: 400` is the proof a fix landed,
14473
+ * and it is exactly what an absent entry cannot say.
14474
+ *
14475
+ * Putting a loss counter on a cost entry would also break the reconciliation
14476
+ * that gives `load-contribution` its point: contributions are subtracted from
14477
+ * `metrics.node-processes-snapshot` to find processes nobody claims. A failure
14478
+ * has no process.
14479
+ *
14480
+ * ## Why not a log line, since the counters already exist
14481
+ *
14482
+ * Several of these paths already counted themselves — `CaptureScheduler`'s
14483
+ * per-device window, `KeyFrameCaptureLog`, `bumpCropMetric`. Every one of them
14484
+ * ends in a log line, and a log line is the thing the operator asked to stop
14485
+ * needing: *"possiamo armare questi errori intanto? Così al prossimo giro
14486
+ * ricontrolliamo tutti questi punti"*. Reading them meant grepping Loki and
14487
+ * hand-correlating timestamps, which is how a 22% thumbnail gap and a 3-hour
14488
+ * media blackout were both diagnosed. The counters stay; this is where they can
14489
+ * be READ.
14490
+ *
14491
+ * ## The rate is served with its denominator or not at all
14492
+ *
14493
+ * Every entry carries `attempts` and `succeeded`. A miss count alone is
14494
+ * unreadable: on 2026-08-28 the enrichment-crop miss count read as "35x worse
14495
+ * than yesterday" and was **flat across twelve hours** once divided by the
14496
+ * successes on the same path. A surface that publishes only the numerator
14497
+ * reproduces that mistake on every read.
14498
+ *
14499
+ * ## Shape
14500
+ *
14501
+ * Copied from `load-contribution.cap.ts` (`mode: 'collection'`,
14502
+ * `internal: true`, `mount: { kind: 'skip' }`): no tRPC route of its own and no
14503
+ * generated hooks, while `addons.listCapabilityProviders` still enumerates it
14504
+ * and the hub's `CapabilityRegistry` still holds an RPC proxy per provider — so
14505
+ * a forked runner's entries reach hub-main over transport that already exists.
14506
+ * No new UDS message, no second registry (D3). The operator reads the assembled
14507
+ * result through `system.getFailureContributions`.
14508
+ */
14509
+ var FailureReasonCountSchema = object({
14510
+ /**
14511
+ * Why the attempt did not land, in the contributor's own vocabulary —
14512
+ * `worker-lease-gone`, `queue-overflow`, `timeout`, `empty-read`. The same
14513
+ * strings that already appear in this repo's logs and, where one exists, the
14514
+ * same string the per-track `previewMissReason` records (D276): a second
14515
+ * vocabulary for the same loss would make the row and the counter
14516
+ * un-joinable.
14517
+ */
14518
+ reason: string(),
14519
+ count: number().int().nonnegative()
14520
+ });
14521
+ var FailureContributionSchema = object({
14522
+ /**
14523
+ * The failing path — `enrichment-crop`, `inference`, `plate-ocr`,
14524
+ * `person-over-vehicle`. Free text, for the reason `load-contribution` keeps
14525
+ * `unit` free: the families are owned by different addons and a shared enum
14526
+ * is a central list that rots invisibly.
14527
+ */
14528
+ family: string(),
14529
+ /**
14530
+ * The NUMERIC device id — the same value every log line carries as
14531
+ * `tags.deviceId`. Never nullable and never absent: a contributor that
14532
+ * cannot name the camera must not emit the entry, because a fleet total
14533
+ * cannot answer the only question anybody asks of this surface.
14534
+ */
14535
+ deviceId: number().int().positive(),
14536
+ /**
14537
+ * A second dimension inside the family: the model / step id for an inference
14538
+ * timeout, so "which camera AND which model" is one read. Absent when the
14539
+ * family has a single variant.
14540
+ */
14541
+ variant: string().optional(),
14542
+ /**
14543
+ * Epoch ms this counter started — the INCARNATION MARKER. A consumer
14544
+ * differencing two reads must drop the interval when it changes, because the
14545
+ * counter restarted from zero in a respawned runner. Same discipline as
14546
+ * `LoadContribution.startedAtMs`.
14547
+ */
14548
+ sinceMs: number(),
14549
+ /** Epoch ms it was read. `atMs - sinceMs` is the interval this covers. */
14550
+ atMs: number(),
14551
+ /**
14552
+ * THE DENOMINATOR — every attempt on this path for this camera in the
14553
+ * window. A failure count published without it is the mistake this schema
14554
+ * exists to make impossible.
14555
+ */
14556
+ attempts: number().int().nonnegative(),
14557
+ /** Attempts that landed. `attempts - succeeded` is the loss. */
14558
+ succeeded: number().int().nonnegative(),
14559
+ /** The loss, partitioned. Sums to `attempts - succeeded`. */
14560
+ reasons: array(FailureReasonCountSchema).readonly()
14561
+ });
14562
+ method(_void(), array(FailureContributionSchema).readonly());
14455
14563
  var LoadContributionSchema = object({
14456
14564
  role: _enum([
14457
14565
  "decode",
@@ -14759,6 +14867,50 @@ var NodeProcessSchema = object({
14759
14867
  /** Wall-clock uptime (seconds). Parsed from `ps etime`. */
14760
14868
  uptimeSec: number()
14761
14869
  });
14870
+ /**
14871
+ * One retained container-memory reading.
14872
+ *
14873
+ * `atMs` is the timestamp of the PROCESS snapshot taken in the same tick, not
14874
+ * a second clock: that is what makes "processes sum to X, container says Y"
14875
+ * subtractable per point rather than an eyeballed comparison of two series
14876
+ * sampled at different instants.
14877
+ *
14878
+ * A reduced window keeps the sample with the LARGEST `currentBytes` in each
14879
+ * bucket, WHOLE. Taking a per-field maximum would synthesise a row whose parts
14880
+ * never coexisted, and a mean would smear away the peak this exists to find.
14881
+ */
14882
+ var ContainerMemoryPointSchema = object({
14883
+ /** Which hierarchy answered, so a reading is never ambiguous. */
14884
+ source: _enum(["cgroup-v2", "cgroup-v1"]),
14885
+ /** `memory.current` (v2) / `memory.usage_in_bytes` (v1). Always known. */
14886
+ currentBytes: number(),
14887
+ /** The cgroup's ceiling. `null` = NO LIMIT — never a sentinel, never zero. */
14888
+ limitBytes: number().nullable(),
14889
+ /** Anonymous pages: the closest thing to "what the processes allocated". */
14890
+ anonBytes: number().nullable(),
14891
+ /** Page cache. Charged to the cgroup, owned by no process. */
14892
+ fileBytes: number().nullable(),
14893
+ /**
14894
+ * Shared memory — and the field that explained the largest single surprise.
14895
+ * The i915 driver backs GPU buffers with shmem, so an inference pool or a
14896
+ * hardware-decode session holding DRM objects is charged HERE and appears
14897
+ * nowhere in a `ps` scan.
14898
+ */
14899
+ shmemBytes: number().nullable(),
14900
+ /** Kernel slab charged to this cgroup. `null` on v1, which never publishes it. */
14901
+ slabBytes: number().nullable(),
14902
+ /**
14903
+ * Shrinkable i915 GEM object bytes, from debugfs.
14904
+ *
14905
+ * **Host-wide across every DRM client, NOT cgroup-scoped.** It is not a
14906
+ * component of `currentBytes` and must not be subtracted from it; it says
14907
+ * what put the shmem there, where `shmemBytes` only says how much.
14908
+ *
14909
+ * `null` wherever debugfs is not mounted — which is inside every camstack
14910
+ * container today — and on any node with no Intel GPU.
14911
+ */
14912
+ gpuShmemBytes: number().nullable()
14913
+ }).extend({ atMs: number() });
14762
14914
  var DumpHeapSnapshotInputSchema = object({
14763
14915
  /** The addon whose runner should dump a heap snapshot. */
14764
14916
  addonId: string() });
@@ -14822,6 +14974,21 @@ var NodeLoadSeriesSchema = object({
14822
14974
  /** One entry per function seen in the window, heaviest-first. */
14823
14975
  series: array(LoadFunctionSeriesSchema).readonly(),
14824
14976
  /**
14977
+ * The CONTAINER's memory over the same window, oldest-first.
14978
+ *
14979
+ * Sits next to `series` rather than in a method of its own because the whole
14980
+ * question is a subtraction: the per-process rows in `series` sum to one
14981
+ * number and this one is another, and an operator who has to issue two calls
14982
+ * to compare them will compare two different instants. Same reader, same
14983
+ * `sinceMs`, same `bucketMs`, same timestamps.
14984
+ *
14985
+ * **EMPTY means ABSENT, never zero.** A node with no cgroup — a developer
14986
+ * Mac, a bare-metal host, a container with the hierarchy hidden — reports no
14987
+ * points at all. A zero here would be indistinguishable from a healthy
14988
+ * container and is precisely the lie this field exists to avoid.
14989
+ */
14990
+ containerMemory: array(ContainerMemoryPointSchema).readonly(),
14991
+ /**
14825
14992
  * Width of one returned bucket, in ms. Equals the sampling cadence when no
14826
14993
  * reduction was needed — so a caller can always say what one point covers
14827
14994
  * without having to know whether it was reduced.
@@ -19042,6 +19209,20 @@ var TrackSchema = object({
19042
19209
  * `=== true` and render nothing otherwise — never infer "no rider".
19043
19210
  */
19044
19211
  hasRider: boolean().optional(),
19212
+ /**
19213
+ * WHY this track ended without a NATIVE best-shot tile
19214
+ * ([D276](../decisions/adr-0276-a-stand-in-tile-is-provisional-and-a-close-says-why.md)) —
19215
+ * a composed token line (`no-key-frame capture=keyframe:native-missx4`,
19216
+ * `derive-returned-null tile=standin`, …) written at close and CLEARED by
19217
+ * the late-keyFrame upgrade when a native tile lands after all. The
19218
+ * operator-facing answer to "perché manca l'immagine?" on a track whose
19219
+ * tile is a face/plate stand-in, a raster crop, or an icon.
19220
+ *
19221
+ * **Absent ≠ "missed silently"**: a row written before the column, a hub
19222
+ * that predates the field, and every track whose tile landed native all
19223
+ * omit it. Render nothing when absent.
19224
+ */
19225
+ previewMissReason: string().optional(),
19045
19226
  ...TrackFlagFields,
19046
19227
  ...TrackRetrainFields
19047
19228
  });
@@ -28503,10 +28684,10 @@ DeviceType.Camera, DeviceType.Sensor, DeviceType.Switch, method(object({ deviceI
28503
28684
  * recording config. NOTE on events (source of truth, R5/C3): this cap carries
28504
28685
  * NO event surface — `getPlaybackManifest` returns playlist URLs only. Timeline
28505
28686
  * events (motion/object/audio) come from `pipelineAnalytics` (durable SQLite
28506
- * rows); the recorder's internal EventMap markers are ephemeral in-RAM
28507
- * annotations that are not exposed here and must not be treated as an event
28508
- * feed. Event<->footage joins are by time, padded with the shared `EVENT_PAD_MS`
28509
- * (`interfaces/recording-config.ts`).
28687
+ * rows) and are the ONLY event surface the recorder has none. The in-RAM
28688
+ * playback markers it used to build were deleted on 2026-08-29 because nothing
28689
+ * ever read them. Event<->footage joins are by time, padded with the shared
28690
+ * `EVENT_PAD_MS` (`interfaces/recording-config.ts`).
28510
28691
  */
28511
28692
  var RecordingStatusSchema = object({
28512
28693
  deviceId: number(),
@@ -30217,6 +30398,13 @@ var LoggingSettingsPatchSchema = object({
30217
30398
  * anyone but its owner.
30218
30399
  */
30219
30400
  var ReportedLoadContributionSchema = LoadContributionSchema.extend({ addonId: string() });
30401
+ /**
30402
+ * One per-camera failure counter, plus WHO reported it.
30403
+ *
30404
+ * Same rule as {@link ReportedLoadContributionSchema}: `addonId` is stamped by
30405
+ * the hub as it enumerates providers, never by the contributor.
30406
+ */
30407
+ var ReportedFailureContributionSchema = FailureContributionSchema.extend({ addonId: string() });
30220
30408
  var GetLoggingSettingsInputSchema = object({
30221
30409
  scopeNodeId: string().optional(),
30222
30410
  /**
@@ -30275,7 +30463,7 @@ method(_void(), FeatureManifestSchema), method(_void(), HealthStatusSchema), met
30275
30463
  }), method(_void(), SiteLocationStatusSchema, {
30276
30464
  kind: "mutation",
30277
30465
  auth: "admin"
30278
- }), method(_void(), RequestCensusStatusSchema, { auth: "admin" }), method(_void(), array(ReportedLoadContributionSchema).readonly(), { auth: "admin" }), method(GetLoggingSettingsInputSchema, LoggingSettingsStateSchema, { auth: "admin" }), method(SetLoggingSettingsInputSchema, LoggingSettingsStateSchema, {
30466
+ }), 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, {
30279
30467
  kind: "mutation",
30280
30468
  auth: "admin"
30281
30469
  });
@@ -34265,6 +34453,12 @@ Object.freeze({
34265
34453
  addonId: null,
34266
34454
  access: "create"
34267
34455
  },
34456
+ "failureContribution.list": {
34457
+ capName: "failure-contribution",
34458
+ capScope: "system",
34459
+ addonId: null,
34460
+ access: "view"
34461
+ },
34268
34462
  "fanControl.setDirection": {
34269
34463
  capName: "fan-control",
34270
34464
  capScope: "device",
@@ -37571,6 +37765,12 @@ Object.freeze({
37571
37765
  addonId: null,
37572
37766
  access: "create"
37573
37767
  },
37768
+ "system.getFailureContributions": {
37769
+ capName: "system",
37770
+ capScope: "system",
37771
+ addonId: null,
37772
+ access: "view"
37773
+ },
37574
37774
  "system.getLoadContributions": {
37575
37775
  capName: "system",
37576
37776
  capScope: "system",
package/dist/addon.mjs CHANGED
@@ -14451,6 +14451,114 @@ method(LogEntrySchema, _void(), { kind: "mutation" }), method(object({
14451
14451
  limit: number().optional(),
14452
14452
  tags: record(string(), string()).optional()
14453
14453
  }), array(LogEntrySchema).readonly());
14454
+ /**
14455
+ * `failure-contribution` — the capability an addon reports its OWN losses
14456
+ * through, per camera, with the denominator attached. It stores nothing.
14457
+ *
14458
+ * ## The twin of `load-contribution`, and why it is a twin and not a field
14459
+ *
14460
+ * `load-contribution` answers *what did this camera COST*. This answers *what
14461
+ * did this camera LOSE*. The reporting discipline is identical and deliberately
14462
+ * copied: the contributor reports what it already knows, hub-main adds only
14463
+ * `addonId`, nothing needs global knowledge, and there is no central list for
14464
+ * somebody to forget to edit.
14465
+ *
14466
+ * They are not merged, because their invariants are opposites:
14467
+ *
14468
+ * - a `load-contribution` measurement is **absent, never zero** — a zero would
14469
+ * claim a camera cost nothing, which is a measurement nobody made;
14470
+ * - a `failure-contribution` zero is the **most valuable value on the
14471
+ * surface** — `attempts: 400, succeeded: 400` is the proof a fix landed,
14472
+ * and it is exactly what an absent entry cannot say.
14473
+ *
14474
+ * Putting a loss counter on a cost entry would also break the reconciliation
14475
+ * that gives `load-contribution` its point: contributions are subtracted from
14476
+ * `metrics.node-processes-snapshot` to find processes nobody claims. A failure
14477
+ * has no process.
14478
+ *
14479
+ * ## Why not a log line, since the counters already exist
14480
+ *
14481
+ * Several of these paths already counted themselves — `CaptureScheduler`'s
14482
+ * per-device window, `KeyFrameCaptureLog`, `bumpCropMetric`. Every one of them
14483
+ * ends in a log line, and a log line is the thing the operator asked to stop
14484
+ * needing: *"possiamo armare questi errori intanto? Così al prossimo giro
14485
+ * ricontrolliamo tutti questi punti"*. Reading them meant grepping Loki and
14486
+ * hand-correlating timestamps, which is how a 22% thumbnail gap and a 3-hour
14487
+ * media blackout were both diagnosed. The counters stay; this is where they can
14488
+ * be READ.
14489
+ *
14490
+ * ## The rate is served with its denominator or not at all
14491
+ *
14492
+ * Every entry carries `attempts` and `succeeded`. A miss count alone is
14493
+ * unreadable: on 2026-08-28 the enrichment-crop miss count read as "35x worse
14494
+ * than yesterday" and was **flat across twelve hours** once divided by the
14495
+ * successes on the same path. A surface that publishes only the numerator
14496
+ * reproduces that mistake on every read.
14497
+ *
14498
+ * ## Shape
14499
+ *
14500
+ * Copied from `load-contribution.cap.ts` (`mode: 'collection'`,
14501
+ * `internal: true`, `mount: { kind: 'skip' }`): no tRPC route of its own and no
14502
+ * generated hooks, while `addons.listCapabilityProviders` still enumerates it
14503
+ * and the hub's `CapabilityRegistry` still holds an RPC proxy per provider — so
14504
+ * a forked runner's entries reach hub-main over transport that already exists.
14505
+ * No new UDS message, no second registry (D3). The operator reads the assembled
14506
+ * result through `system.getFailureContributions`.
14507
+ */
14508
+ var FailureReasonCountSchema = object({
14509
+ /**
14510
+ * Why the attempt did not land, in the contributor's own vocabulary —
14511
+ * `worker-lease-gone`, `queue-overflow`, `timeout`, `empty-read`. The same
14512
+ * strings that already appear in this repo's logs and, where one exists, the
14513
+ * same string the per-track `previewMissReason` records (D276): a second
14514
+ * vocabulary for the same loss would make the row and the counter
14515
+ * un-joinable.
14516
+ */
14517
+ reason: string(),
14518
+ count: number().int().nonnegative()
14519
+ });
14520
+ var FailureContributionSchema = object({
14521
+ /**
14522
+ * The failing path — `enrichment-crop`, `inference`, `plate-ocr`,
14523
+ * `person-over-vehicle`. Free text, for the reason `load-contribution` keeps
14524
+ * `unit` free: the families are owned by different addons and a shared enum
14525
+ * is a central list that rots invisibly.
14526
+ */
14527
+ family: string(),
14528
+ /**
14529
+ * The NUMERIC device id — the same value every log line carries as
14530
+ * `tags.deviceId`. Never nullable and never absent: a contributor that
14531
+ * cannot name the camera must not emit the entry, because a fleet total
14532
+ * cannot answer the only question anybody asks of this surface.
14533
+ */
14534
+ deviceId: number().int().positive(),
14535
+ /**
14536
+ * A second dimension inside the family: the model / step id for an inference
14537
+ * timeout, so "which camera AND which model" is one read. Absent when the
14538
+ * family has a single variant.
14539
+ */
14540
+ variant: string().optional(),
14541
+ /**
14542
+ * Epoch ms this counter started — the INCARNATION MARKER. A consumer
14543
+ * differencing two reads must drop the interval when it changes, because the
14544
+ * counter restarted from zero in a respawned runner. Same discipline as
14545
+ * `LoadContribution.startedAtMs`.
14546
+ */
14547
+ sinceMs: number(),
14548
+ /** Epoch ms it was read. `atMs - sinceMs` is the interval this covers. */
14549
+ atMs: number(),
14550
+ /**
14551
+ * THE DENOMINATOR — every attempt on this path for this camera in the
14552
+ * window. A failure count published without it is the mistake this schema
14553
+ * exists to make impossible.
14554
+ */
14555
+ attempts: number().int().nonnegative(),
14556
+ /** Attempts that landed. `attempts - succeeded` is the loss. */
14557
+ succeeded: number().int().nonnegative(),
14558
+ /** The loss, partitioned. Sums to `attempts - succeeded`. */
14559
+ reasons: array(FailureReasonCountSchema).readonly()
14560
+ });
14561
+ method(_void(), array(FailureContributionSchema).readonly());
14454
14562
  var LoadContributionSchema = object({
14455
14563
  role: _enum([
14456
14564
  "decode",
@@ -14758,6 +14866,50 @@ var NodeProcessSchema = object({
14758
14866
  /** Wall-clock uptime (seconds). Parsed from `ps etime`. */
14759
14867
  uptimeSec: number()
14760
14868
  });
14869
+ /**
14870
+ * One retained container-memory reading.
14871
+ *
14872
+ * `atMs` is the timestamp of the PROCESS snapshot taken in the same tick, not
14873
+ * a second clock: that is what makes "processes sum to X, container says Y"
14874
+ * subtractable per point rather than an eyeballed comparison of two series
14875
+ * sampled at different instants.
14876
+ *
14877
+ * A reduced window keeps the sample with the LARGEST `currentBytes` in each
14878
+ * bucket, WHOLE. Taking a per-field maximum would synthesise a row whose parts
14879
+ * never coexisted, and a mean would smear away the peak this exists to find.
14880
+ */
14881
+ var ContainerMemoryPointSchema = object({
14882
+ /** Which hierarchy answered, so a reading is never ambiguous. */
14883
+ source: _enum(["cgroup-v2", "cgroup-v1"]),
14884
+ /** `memory.current` (v2) / `memory.usage_in_bytes` (v1). Always known. */
14885
+ currentBytes: number(),
14886
+ /** The cgroup's ceiling. `null` = NO LIMIT — never a sentinel, never zero. */
14887
+ limitBytes: number().nullable(),
14888
+ /** Anonymous pages: the closest thing to "what the processes allocated". */
14889
+ anonBytes: number().nullable(),
14890
+ /** Page cache. Charged to the cgroup, owned by no process. */
14891
+ fileBytes: number().nullable(),
14892
+ /**
14893
+ * Shared memory — and the field that explained the largest single surprise.
14894
+ * The i915 driver backs GPU buffers with shmem, so an inference pool or a
14895
+ * hardware-decode session holding DRM objects is charged HERE and appears
14896
+ * nowhere in a `ps` scan.
14897
+ */
14898
+ shmemBytes: number().nullable(),
14899
+ /** Kernel slab charged to this cgroup. `null` on v1, which never publishes it. */
14900
+ slabBytes: number().nullable(),
14901
+ /**
14902
+ * Shrinkable i915 GEM object bytes, from debugfs.
14903
+ *
14904
+ * **Host-wide across every DRM client, NOT cgroup-scoped.** It is not a
14905
+ * component of `currentBytes` and must not be subtracted from it; it says
14906
+ * what put the shmem there, where `shmemBytes` only says how much.
14907
+ *
14908
+ * `null` wherever debugfs is not mounted — which is inside every camstack
14909
+ * container today — and on any node with no Intel GPU.
14910
+ */
14911
+ gpuShmemBytes: number().nullable()
14912
+ }).extend({ atMs: number() });
14761
14913
  var DumpHeapSnapshotInputSchema = object({
14762
14914
  /** The addon whose runner should dump a heap snapshot. */
14763
14915
  addonId: string() });
@@ -14821,6 +14973,21 @@ var NodeLoadSeriesSchema = object({
14821
14973
  /** One entry per function seen in the window, heaviest-first. */
14822
14974
  series: array(LoadFunctionSeriesSchema).readonly(),
14823
14975
  /**
14976
+ * The CONTAINER's memory over the same window, oldest-first.
14977
+ *
14978
+ * Sits next to `series` rather than in a method of its own because the whole
14979
+ * question is a subtraction: the per-process rows in `series` sum to one
14980
+ * number and this one is another, and an operator who has to issue two calls
14981
+ * to compare them will compare two different instants. Same reader, same
14982
+ * `sinceMs`, same `bucketMs`, same timestamps.
14983
+ *
14984
+ * **EMPTY means ABSENT, never zero.** A node with no cgroup — a developer
14985
+ * Mac, a bare-metal host, a container with the hierarchy hidden — reports no
14986
+ * points at all. A zero here would be indistinguishable from a healthy
14987
+ * container and is precisely the lie this field exists to avoid.
14988
+ */
14989
+ containerMemory: array(ContainerMemoryPointSchema).readonly(),
14990
+ /**
14824
14991
  * Width of one returned bucket, in ms. Equals the sampling cadence when no
14825
14992
  * reduction was needed — so a caller can always say what one point covers
14826
14993
  * without having to know whether it was reduced.
@@ -19041,6 +19208,20 @@ var TrackSchema = object({
19041
19208
  * `=== true` and render nothing otherwise — never infer "no rider".
19042
19209
  */
19043
19210
  hasRider: boolean().optional(),
19211
+ /**
19212
+ * WHY this track ended without a NATIVE best-shot tile
19213
+ * ([D276](../decisions/adr-0276-a-stand-in-tile-is-provisional-and-a-close-says-why.md)) —
19214
+ * a composed token line (`no-key-frame capture=keyframe:native-missx4`,
19215
+ * `derive-returned-null tile=standin`, …) written at close and CLEARED by
19216
+ * the late-keyFrame upgrade when a native tile lands after all. The
19217
+ * operator-facing answer to "perché manca l'immagine?" on a track whose
19218
+ * tile is a face/plate stand-in, a raster crop, or an icon.
19219
+ *
19220
+ * **Absent ≠ "missed silently"**: a row written before the column, a hub
19221
+ * that predates the field, and every track whose tile landed native all
19222
+ * omit it. Render nothing when absent.
19223
+ */
19224
+ previewMissReason: string().optional(),
19044
19225
  ...TrackFlagFields,
19045
19226
  ...TrackRetrainFields
19046
19227
  });
@@ -28502,10 +28683,10 @@ DeviceType.Camera, DeviceType.Sensor, DeviceType.Switch, method(object({ deviceI
28502
28683
  * recording config. NOTE on events (source of truth, R5/C3): this cap carries
28503
28684
  * NO event surface — `getPlaybackManifest` returns playlist URLs only. Timeline
28504
28685
  * events (motion/object/audio) come from `pipelineAnalytics` (durable SQLite
28505
- * rows); the recorder's internal EventMap markers are ephemeral in-RAM
28506
- * annotations that are not exposed here and must not be treated as an event
28507
- * feed. Event<->footage joins are by time, padded with the shared `EVENT_PAD_MS`
28508
- * (`interfaces/recording-config.ts`).
28686
+ * rows) and are the ONLY event surface the recorder has none. The in-RAM
28687
+ * playback markers it used to build were deleted on 2026-08-29 because nothing
28688
+ * ever read them. Event<->footage joins are by time, padded with the shared
28689
+ * `EVENT_PAD_MS` (`interfaces/recording-config.ts`).
28509
28690
  */
28510
28691
  var RecordingStatusSchema = object({
28511
28692
  deviceId: number(),
@@ -30216,6 +30397,13 @@ var LoggingSettingsPatchSchema = object({
30216
30397
  * anyone but its owner.
30217
30398
  */
30218
30399
  var ReportedLoadContributionSchema = LoadContributionSchema.extend({ addonId: string() });
30400
+ /**
30401
+ * One per-camera failure counter, plus WHO reported it.
30402
+ *
30403
+ * Same rule as {@link ReportedLoadContributionSchema}: `addonId` is stamped by
30404
+ * the hub as it enumerates providers, never by the contributor.
30405
+ */
30406
+ var ReportedFailureContributionSchema = FailureContributionSchema.extend({ addonId: string() });
30219
30407
  var GetLoggingSettingsInputSchema = object({
30220
30408
  scopeNodeId: string().optional(),
30221
30409
  /**
@@ -30274,7 +30462,7 @@ method(_void(), FeatureManifestSchema), method(_void(), HealthStatusSchema), met
30274
30462
  }), method(_void(), SiteLocationStatusSchema, {
30275
30463
  kind: "mutation",
30276
30464
  auth: "admin"
30277
- }), method(_void(), RequestCensusStatusSchema, { auth: "admin" }), method(_void(), array(ReportedLoadContributionSchema).readonly(), { auth: "admin" }), method(GetLoggingSettingsInputSchema, LoggingSettingsStateSchema, { auth: "admin" }), method(SetLoggingSettingsInputSchema, LoggingSettingsStateSchema, {
30465
+ }), 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, {
30278
30466
  kind: "mutation",
30279
30467
  auth: "admin"
30280
30468
  });
@@ -34264,6 +34452,12 @@ Object.freeze({
34264
34452
  addonId: null,
34265
34453
  access: "create"
34266
34454
  },
34455
+ "failureContribution.list": {
34456
+ capName: "failure-contribution",
34457
+ capScope: "system",
34458
+ addonId: null,
34459
+ access: "view"
34460
+ },
34267
34461
  "fanControl.setDirection": {
34268
34462
  capName: "fan-control",
34269
34463
  capScope: "device",
@@ -37570,6 +37764,12 @@ Object.freeze({
37570
37764
  addonId: null,
37571
37765
  access: "create"
37572
37766
  },
37767
+ "system.getFailureContributions": {
37768
+ capName: "system",
37769
+ capScope: "system",
37770
+ addonId: null,
37771
+ access: "view"
37772
+ },
37573
37773
  "system.getLoadContributions": {
37574
37774
  capName: "system",
37575
37775
  capScope: "system",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@camstack/addon-provider-rademacher",
3
- "version": "0.2.37",
3
+ "version": "0.2.40",
4
4
  "description": "Rademacher HomePilot device-provider addon for CamStack — wraps the @apocaliss92/noderademacher local-hub client (roller shutters over the cover cap)",
5
5
  "keywords": [
6
6
  "camstack",