@camstack/addon-provider-velux 0.2.38 → 0.2.41

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
@@ -13467,6 +13467,114 @@ method(LogEntrySchema, _void(), { kind: "mutation" }), method(object({
13467
13467
  limit: number().optional(),
13468
13468
  tags: record(string(), string()).optional()
13469
13469
  }), array(LogEntrySchema).readonly());
13470
+ /**
13471
+ * `failure-contribution` — the capability an addon reports its OWN losses
13472
+ * through, per camera, with the denominator attached. It stores nothing.
13473
+ *
13474
+ * ## The twin of `load-contribution`, and why it is a twin and not a field
13475
+ *
13476
+ * `load-contribution` answers *what did this camera COST*. This answers *what
13477
+ * did this camera LOSE*. The reporting discipline is identical and deliberately
13478
+ * copied: the contributor reports what it already knows, hub-main adds only
13479
+ * `addonId`, nothing needs global knowledge, and there is no central list for
13480
+ * somebody to forget to edit.
13481
+ *
13482
+ * They are not merged, because their invariants are opposites:
13483
+ *
13484
+ * - a `load-contribution` measurement is **absent, never zero** — a zero would
13485
+ * claim a camera cost nothing, which is a measurement nobody made;
13486
+ * - a `failure-contribution` zero is the **most valuable value on the
13487
+ * surface** — `attempts: 400, succeeded: 400` is the proof a fix landed,
13488
+ * and it is exactly what an absent entry cannot say.
13489
+ *
13490
+ * Putting a loss counter on a cost entry would also break the reconciliation
13491
+ * that gives `load-contribution` its point: contributions are subtracted from
13492
+ * `metrics.node-processes-snapshot` to find processes nobody claims. A failure
13493
+ * has no process.
13494
+ *
13495
+ * ## Why not a log line, since the counters already exist
13496
+ *
13497
+ * Several of these paths already counted themselves — `CaptureScheduler`'s
13498
+ * per-device window, `KeyFrameCaptureLog`, `bumpCropMetric`. Every one of them
13499
+ * ends in a log line, and a log line is the thing the operator asked to stop
13500
+ * needing: *"possiamo armare questi errori intanto? Così al prossimo giro
13501
+ * ricontrolliamo tutti questi punti"*. Reading them meant grepping Loki and
13502
+ * hand-correlating timestamps, which is how a 22% thumbnail gap and a 3-hour
13503
+ * media blackout were both diagnosed. The counters stay; this is where they can
13504
+ * be READ.
13505
+ *
13506
+ * ## The rate is served with its denominator or not at all
13507
+ *
13508
+ * Every entry carries `attempts` and `succeeded`. A miss count alone is
13509
+ * unreadable: on 2026-08-28 the enrichment-crop miss count read as "35x worse
13510
+ * than yesterday" and was **flat across twelve hours** once divided by the
13511
+ * successes on the same path. A surface that publishes only the numerator
13512
+ * reproduces that mistake on every read.
13513
+ *
13514
+ * ## Shape
13515
+ *
13516
+ * Copied from `load-contribution.cap.ts` (`mode: 'collection'`,
13517
+ * `internal: true`, `mount: { kind: 'skip' }`): no tRPC route of its own and no
13518
+ * generated hooks, while `addons.listCapabilityProviders` still enumerates it
13519
+ * and the hub's `CapabilityRegistry` still holds an RPC proxy per provider — so
13520
+ * a forked runner's entries reach hub-main over transport that already exists.
13521
+ * No new UDS message, no second registry (D3). The operator reads the assembled
13522
+ * result through `system.getFailureContributions`.
13523
+ */
13524
+ var FailureReasonCountSchema = object({
13525
+ /**
13526
+ * Why the attempt did not land, in the contributor's own vocabulary —
13527
+ * `worker-lease-gone`, `queue-overflow`, `timeout`, `empty-read`. The same
13528
+ * strings that already appear in this repo's logs and, where one exists, the
13529
+ * same string the per-track `previewMissReason` records (D276): a second
13530
+ * vocabulary for the same loss would make the row and the counter
13531
+ * un-joinable.
13532
+ */
13533
+ reason: string(),
13534
+ count: number().int().nonnegative()
13535
+ });
13536
+ var FailureContributionSchema = object({
13537
+ /**
13538
+ * The failing path — `enrichment-crop`, `inference`, `plate-ocr`,
13539
+ * `person-over-vehicle`. Free text, for the reason `load-contribution` keeps
13540
+ * `unit` free: the families are owned by different addons and a shared enum
13541
+ * is a central list that rots invisibly.
13542
+ */
13543
+ family: string(),
13544
+ /**
13545
+ * The NUMERIC device id — the same value every log line carries as
13546
+ * `tags.deviceId`. Never nullable and never absent: a contributor that
13547
+ * cannot name the camera must not emit the entry, because a fleet total
13548
+ * cannot answer the only question anybody asks of this surface.
13549
+ */
13550
+ deviceId: number().int().positive(),
13551
+ /**
13552
+ * A second dimension inside the family: the model / step id for an inference
13553
+ * timeout, so "which camera AND which model" is one read. Absent when the
13554
+ * family has a single variant.
13555
+ */
13556
+ variant: string().optional(),
13557
+ /**
13558
+ * Epoch ms this counter started — the INCARNATION MARKER. A consumer
13559
+ * differencing two reads must drop the interval when it changes, because the
13560
+ * counter restarted from zero in a respawned runner. Same discipline as
13561
+ * `LoadContribution.startedAtMs`.
13562
+ */
13563
+ sinceMs: number(),
13564
+ /** Epoch ms it was read. `atMs - sinceMs` is the interval this covers. */
13565
+ atMs: number(),
13566
+ /**
13567
+ * THE DENOMINATOR — every attempt on this path for this camera in the
13568
+ * window. A failure count published without it is the mistake this schema
13569
+ * exists to make impossible.
13570
+ */
13571
+ attempts: number().int().nonnegative(),
13572
+ /** Attempts that landed. `attempts - succeeded` is the loss. */
13573
+ succeeded: number().int().nonnegative(),
13574
+ /** The loss, partitioned. Sums to `attempts - succeeded`. */
13575
+ reasons: array(FailureReasonCountSchema).readonly()
13576
+ });
13577
+ method(_void(), array(FailureContributionSchema).readonly());
13470
13578
  var LoadContributionSchema = object({
13471
13579
  role: _enum([
13472
13580
  "decode",
@@ -13774,6 +13882,50 @@ var NodeProcessSchema = object({
13774
13882
  /** Wall-clock uptime (seconds). Parsed from `ps etime`. */
13775
13883
  uptimeSec: number()
13776
13884
  });
13885
+ /**
13886
+ * One retained container-memory reading.
13887
+ *
13888
+ * `atMs` is the timestamp of the PROCESS snapshot taken in the same tick, not
13889
+ * a second clock: that is what makes "processes sum to X, container says Y"
13890
+ * subtractable per point rather than an eyeballed comparison of two series
13891
+ * sampled at different instants.
13892
+ *
13893
+ * A reduced window keeps the sample with the LARGEST `currentBytes` in each
13894
+ * bucket, WHOLE. Taking a per-field maximum would synthesise a row whose parts
13895
+ * never coexisted, and a mean would smear away the peak this exists to find.
13896
+ */
13897
+ var ContainerMemoryPointSchema = object({
13898
+ /** Which hierarchy answered, so a reading is never ambiguous. */
13899
+ source: _enum(["cgroup-v2", "cgroup-v1"]),
13900
+ /** `memory.current` (v2) / `memory.usage_in_bytes` (v1). Always known. */
13901
+ currentBytes: number(),
13902
+ /** The cgroup's ceiling. `null` = NO LIMIT — never a sentinel, never zero. */
13903
+ limitBytes: number().nullable(),
13904
+ /** Anonymous pages: the closest thing to "what the processes allocated". */
13905
+ anonBytes: number().nullable(),
13906
+ /** Page cache. Charged to the cgroup, owned by no process. */
13907
+ fileBytes: number().nullable(),
13908
+ /**
13909
+ * Shared memory — and the field that explained the largest single surprise.
13910
+ * The i915 driver backs GPU buffers with shmem, so an inference pool or a
13911
+ * hardware-decode session holding DRM objects is charged HERE and appears
13912
+ * nowhere in a `ps` scan.
13913
+ */
13914
+ shmemBytes: number().nullable(),
13915
+ /** Kernel slab charged to this cgroup. `null` on v1, which never publishes it. */
13916
+ slabBytes: number().nullable(),
13917
+ /**
13918
+ * Shrinkable i915 GEM object bytes, from debugfs.
13919
+ *
13920
+ * **Host-wide across every DRM client, NOT cgroup-scoped.** It is not a
13921
+ * component of `currentBytes` and must not be subtracted from it; it says
13922
+ * what put the shmem there, where `shmemBytes` only says how much.
13923
+ *
13924
+ * `null` wherever debugfs is not mounted — which is inside every camstack
13925
+ * container today — and on any node with no Intel GPU.
13926
+ */
13927
+ gpuShmemBytes: number().nullable()
13928
+ }).extend({ atMs: number() });
13777
13929
  var DumpHeapSnapshotInputSchema = object({
13778
13930
  /** The addon whose runner should dump a heap snapshot. */
13779
13931
  addonId: string() });
@@ -13837,6 +13989,21 @@ var NodeLoadSeriesSchema = object({
13837
13989
  /** One entry per function seen in the window, heaviest-first. */
13838
13990
  series: array(LoadFunctionSeriesSchema).readonly(),
13839
13991
  /**
13992
+ * The CONTAINER's memory over the same window, oldest-first.
13993
+ *
13994
+ * Sits next to `series` rather than in a method of its own because the whole
13995
+ * question is a subtraction: the per-process rows in `series` sum to one
13996
+ * number and this one is another, and an operator who has to issue two calls
13997
+ * to compare them will compare two different instants. Same reader, same
13998
+ * `sinceMs`, same `bucketMs`, same timestamps.
13999
+ *
14000
+ * **EMPTY means ABSENT, never zero.** A node with no cgroup — a developer
14001
+ * Mac, a bare-metal host, a container with the hierarchy hidden — reports no
14002
+ * points at all. A zero here would be indistinguishable from a healthy
14003
+ * container and is precisely the lie this field exists to avoid.
14004
+ */
14005
+ containerMemory: array(ContainerMemoryPointSchema).readonly(),
14006
+ /**
13840
14007
  * Width of one returned bucket, in ms. Equals the sampling cadence when no
13841
14008
  * reduction was needed — so a caller can always say what one point covers
13842
14009
  * without having to know whether it was reduced.
@@ -18057,6 +18224,20 @@ var TrackSchema = object({
18057
18224
  * `=== true` and render nothing otherwise — never infer "no rider".
18058
18225
  */
18059
18226
  hasRider: boolean().optional(),
18227
+ /**
18228
+ * WHY this track ended without a NATIVE best-shot tile
18229
+ * ([D276](../decisions/adr-0276-a-stand-in-tile-is-provisional-and-a-close-says-why.md)) —
18230
+ * a composed token line (`no-key-frame capture=keyframe:native-missx4`,
18231
+ * `derive-returned-null tile=standin`, …) written at close and CLEARED by
18232
+ * the late-keyFrame upgrade when a native tile lands after all. The
18233
+ * operator-facing answer to "perché manca l'immagine?" on a track whose
18234
+ * tile is a face/plate stand-in, a raster crop, or an icon.
18235
+ *
18236
+ * **Absent ≠ "missed silently"**: a row written before the column, a hub
18237
+ * that predates the field, and every track whose tile landed native all
18238
+ * omit it. Render nothing when absent.
18239
+ */
18240
+ previewMissReason: string().optional(),
18060
18241
  ...TrackFlagFields,
18061
18242
  ...TrackRetrainFields
18062
18243
  });
@@ -27518,10 +27699,10 @@ DeviceType.Camera, DeviceType.Sensor, DeviceType.Switch, method(object({ deviceI
27518
27699
  * recording config. NOTE on events (source of truth, R5/C3): this cap carries
27519
27700
  * NO event surface — `getPlaybackManifest` returns playlist URLs only. Timeline
27520
27701
  * events (motion/object/audio) come from `pipelineAnalytics` (durable SQLite
27521
- * rows); the recorder's internal EventMap markers are ephemeral in-RAM
27522
- * annotations that are not exposed here and must not be treated as an event
27523
- * feed. Event<->footage joins are by time, padded with the shared `EVENT_PAD_MS`
27524
- * (`interfaces/recording-config.ts`).
27702
+ * rows) and are the ONLY event surface — the recorder has none. The in-RAM
27703
+ * playback markers it used to build were deleted on 2026-08-29 because nothing
27704
+ * ever read them. Event<->footage joins are by time, padded with the shared
27705
+ * `EVENT_PAD_MS` (`interfaces/recording-config.ts`).
27525
27706
  */
27526
27707
  var RecordingStatusSchema = object({
27527
27708
  deviceId: number(),
@@ -29232,6 +29413,13 @@ var LoggingSettingsPatchSchema = object({
29232
29413
  * anyone but its owner.
29233
29414
  */
29234
29415
  var ReportedLoadContributionSchema = LoadContributionSchema.extend({ addonId: string() });
29416
+ /**
29417
+ * One per-camera failure counter, plus WHO reported it.
29418
+ *
29419
+ * Same rule as {@link ReportedLoadContributionSchema}: `addonId` is stamped by
29420
+ * the hub as it enumerates providers, never by the contributor.
29421
+ */
29422
+ var ReportedFailureContributionSchema = FailureContributionSchema.extend({ addonId: string() });
29235
29423
  var GetLoggingSettingsInputSchema = object({
29236
29424
  scopeNodeId: string().optional(),
29237
29425
  /**
@@ -29290,7 +29478,7 @@ method(_void(), FeatureManifestSchema), method(_void(), HealthStatusSchema), met
29290
29478
  }), method(_void(), SiteLocationStatusSchema, {
29291
29479
  kind: "mutation",
29292
29480
  auth: "admin"
29293
- }), method(_void(), RequestCensusStatusSchema, { auth: "admin" }), method(_void(), array(ReportedLoadContributionSchema).readonly(), { auth: "admin" }), method(GetLoggingSettingsInputSchema, LoggingSettingsStateSchema, { auth: "admin" }), method(SetLoggingSettingsInputSchema, LoggingSettingsStateSchema, {
29481
+ }), 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, {
29294
29482
  kind: "mutation",
29295
29483
  auth: "admin"
29296
29484
  });
@@ -33280,6 +33468,12 @@ Object.freeze({
33280
33468
  addonId: null,
33281
33469
  access: "create"
33282
33470
  },
33471
+ "failureContribution.list": {
33472
+ capName: "failure-contribution",
33473
+ capScope: "system",
33474
+ addonId: null,
33475
+ access: "view"
33476
+ },
33283
33477
  "fanControl.setDirection": {
33284
33478
  capName: "fan-control",
33285
33479
  capScope: "device",
@@ -36586,6 +36780,12 @@ Object.freeze({
36586
36780
  addonId: null,
36587
36781
  access: "create"
36588
36782
  },
36783
+ "system.getFailureContributions": {
36784
+ capName: "system",
36785
+ capScope: "system",
36786
+ addonId: null,
36787
+ access: "view"
36788
+ },
36589
36789
  "system.getLoadContributions": {
36590
36790
  capName: "system",
36591
36791
  capScope: "system",
package/dist/addon.mjs CHANGED
@@ -13466,6 +13466,114 @@ method(LogEntrySchema, _void(), { kind: "mutation" }), method(object({
13466
13466
  limit: number().optional(),
13467
13467
  tags: record(string(), string()).optional()
13468
13468
  }), array(LogEntrySchema).readonly());
13469
+ /**
13470
+ * `failure-contribution` — the capability an addon reports its OWN losses
13471
+ * through, per camera, with the denominator attached. It stores nothing.
13472
+ *
13473
+ * ## The twin of `load-contribution`, and why it is a twin and not a field
13474
+ *
13475
+ * `load-contribution` answers *what did this camera COST*. This answers *what
13476
+ * did this camera LOSE*. The reporting discipline is identical and deliberately
13477
+ * copied: the contributor reports what it already knows, hub-main adds only
13478
+ * `addonId`, nothing needs global knowledge, and there is no central list for
13479
+ * somebody to forget to edit.
13480
+ *
13481
+ * They are not merged, because their invariants are opposites:
13482
+ *
13483
+ * - a `load-contribution` measurement is **absent, never zero** — a zero would
13484
+ * claim a camera cost nothing, which is a measurement nobody made;
13485
+ * - a `failure-contribution` zero is the **most valuable value on the
13486
+ * surface** — `attempts: 400, succeeded: 400` is the proof a fix landed,
13487
+ * and it is exactly what an absent entry cannot say.
13488
+ *
13489
+ * Putting a loss counter on a cost entry would also break the reconciliation
13490
+ * that gives `load-contribution` its point: contributions are subtracted from
13491
+ * `metrics.node-processes-snapshot` to find processes nobody claims. A failure
13492
+ * has no process.
13493
+ *
13494
+ * ## Why not a log line, since the counters already exist
13495
+ *
13496
+ * Several of these paths already counted themselves — `CaptureScheduler`'s
13497
+ * per-device window, `KeyFrameCaptureLog`, `bumpCropMetric`. Every one of them
13498
+ * ends in a log line, and a log line is the thing the operator asked to stop
13499
+ * needing: *"possiamo armare questi errori intanto? Così al prossimo giro
13500
+ * ricontrolliamo tutti questi punti"*. Reading them meant grepping Loki and
13501
+ * hand-correlating timestamps, which is how a 22% thumbnail gap and a 3-hour
13502
+ * media blackout were both diagnosed. The counters stay; this is where they can
13503
+ * be READ.
13504
+ *
13505
+ * ## The rate is served with its denominator or not at all
13506
+ *
13507
+ * Every entry carries `attempts` and `succeeded`. A miss count alone is
13508
+ * unreadable: on 2026-08-28 the enrichment-crop miss count read as "35x worse
13509
+ * than yesterday" and was **flat across twelve hours** once divided by the
13510
+ * successes on the same path. A surface that publishes only the numerator
13511
+ * reproduces that mistake on every read.
13512
+ *
13513
+ * ## Shape
13514
+ *
13515
+ * Copied from `load-contribution.cap.ts` (`mode: 'collection'`,
13516
+ * `internal: true`, `mount: { kind: 'skip' }`): no tRPC route of its own and no
13517
+ * generated hooks, while `addons.listCapabilityProviders` still enumerates it
13518
+ * and the hub's `CapabilityRegistry` still holds an RPC proxy per provider — so
13519
+ * a forked runner's entries reach hub-main over transport that already exists.
13520
+ * No new UDS message, no second registry (D3). The operator reads the assembled
13521
+ * result through `system.getFailureContributions`.
13522
+ */
13523
+ var FailureReasonCountSchema = object({
13524
+ /**
13525
+ * Why the attempt did not land, in the contributor's own vocabulary —
13526
+ * `worker-lease-gone`, `queue-overflow`, `timeout`, `empty-read`. The same
13527
+ * strings that already appear in this repo's logs and, where one exists, the
13528
+ * same string the per-track `previewMissReason` records (D276): a second
13529
+ * vocabulary for the same loss would make the row and the counter
13530
+ * un-joinable.
13531
+ */
13532
+ reason: string(),
13533
+ count: number().int().nonnegative()
13534
+ });
13535
+ var FailureContributionSchema = object({
13536
+ /**
13537
+ * The failing path — `enrichment-crop`, `inference`, `plate-ocr`,
13538
+ * `person-over-vehicle`. Free text, for the reason `load-contribution` keeps
13539
+ * `unit` free: the families are owned by different addons and a shared enum
13540
+ * is a central list that rots invisibly.
13541
+ */
13542
+ family: string(),
13543
+ /**
13544
+ * The NUMERIC device id — the same value every log line carries as
13545
+ * `tags.deviceId`. Never nullable and never absent: a contributor that
13546
+ * cannot name the camera must not emit the entry, because a fleet total
13547
+ * cannot answer the only question anybody asks of this surface.
13548
+ */
13549
+ deviceId: number().int().positive(),
13550
+ /**
13551
+ * A second dimension inside the family: the model / step id for an inference
13552
+ * timeout, so "which camera AND which model" is one read. Absent when the
13553
+ * family has a single variant.
13554
+ */
13555
+ variant: string().optional(),
13556
+ /**
13557
+ * Epoch ms this counter started — the INCARNATION MARKER. A consumer
13558
+ * differencing two reads must drop the interval when it changes, because the
13559
+ * counter restarted from zero in a respawned runner. Same discipline as
13560
+ * `LoadContribution.startedAtMs`.
13561
+ */
13562
+ sinceMs: number(),
13563
+ /** Epoch ms it was read. `atMs - sinceMs` is the interval this covers. */
13564
+ atMs: number(),
13565
+ /**
13566
+ * THE DENOMINATOR — every attempt on this path for this camera in the
13567
+ * window. A failure count published without it is the mistake this schema
13568
+ * exists to make impossible.
13569
+ */
13570
+ attempts: number().int().nonnegative(),
13571
+ /** Attempts that landed. `attempts - succeeded` is the loss. */
13572
+ succeeded: number().int().nonnegative(),
13573
+ /** The loss, partitioned. Sums to `attempts - succeeded`. */
13574
+ reasons: array(FailureReasonCountSchema).readonly()
13575
+ });
13576
+ method(_void(), array(FailureContributionSchema).readonly());
13469
13577
  var LoadContributionSchema = object({
13470
13578
  role: _enum([
13471
13579
  "decode",
@@ -13773,6 +13881,50 @@ var NodeProcessSchema = object({
13773
13881
  /** Wall-clock uptime (seconds). Parsed from `ps etime`. */
13774
13882
  uptimeSec: number()
13775
13883
  });
13884
+ /**
13885
+ * One retained container-memory reading.
13886
+ *
13887
+ * `atMs` is the timestamp of the PROCESS snapshot taken in the same tick, not
13888
+ * a second clock: that is what makes "processes sum to X, container says Y"
13889
+ * subtractable per point rather than an eyeballed comparison of two series
13890
+ * sampled at different instants.
13891
+ *
13892
+ * A reduced window keeps the sample with the LARGEST `currentBytes` in each
13893
+ * bucket, WHOLE. Taking a per-field maximum would synthesise a row whose parts
13894
+ * never coexisted, and a mean would smear away the peak this exists to find.
13895
+ */
13896
+ var ContainerMemoryPointSchema = object({
13897
+ /** Which hierarchy answered, so a reading is never ambiguous. */
13898
+ source: _enum(["cgroup-v2", "cgroup-v1"]),
13899
+ /** `memory.current` (v2) / `memory.usage_in_bytes` (v1). Always known. */
13900
+ currentBytes: number(),
13901
+ /** The cgroup's ceiling. `null` = NO LIMIT — never a sentinel, never zero. */
13902
+ limitBytes: number().nullable(),
13903
+ /** Anonymous pages: the closest thing to "what the processes allocated". */
13904
+ anonBytes: number().nullable(),
13905
+ /** Page cache. Charged to the cgroup, owned by no process. */
13906
+ fileBytes: number().nullable(),
13907
+ /**
13908
+ * Shared memory — and the field that explained the largest single surprise.
13909
+ * The i915 driver backs GPU buffers with shmem, so an inference pool or a
13910
+ * hardware-decode session holding DRM objects is charged HERE and appears
13911
+ * nowhere in a `ps` scan.
13912
+ */
13913
+ shmemBytes: number().nullable(),
13914
+ /** Kernel slab charged to this cgroup. `null` on v1, which never publishes it. */
13915
+ slabBytes: number().nullable(),
13916
+ /**
13917
+ * Shrinkable i915 GEM object bytes, from debugfs.
13918
+ *
13919
+ * **Host-wide across every DRM client, NOT cgroup-scoped.** It is not a
13920
+ * component of `currentBytes` and must not be subtracted from it; it says
13921
+ * what put the shmem there, where `shmemBytes` only says how much.
13922
+ *
13923
+ * `null` wherever debugfs is not mounted — which is inside every camstack
13924
+ * container today — and on any node with no Intel GPU.
13925
+ */
13926
+ gpuShmemBytes: number().nullable()
13927
+ }).extend({ atMs: number() });
13776
13928
  var DumpHeapSnapshotInputSchema = object({
13777
13929
  /** The addon whose runner should dump a heap snapshot. */
13778
13930
  addonId: string() });
@@ -13836,6 +13988,21 @@ var NodeLoadSeriesSchema = object({
13836
13988
  /** One entry per function seen in the window, heaviest-first. */
13837
13989
  series: array(LoadFunctionSeriesSchema).readonly(),
13838
13990
  /**
13991
+ * The CONTAINER's memory over the same window, oldest-first.
13992
+ *
13993
+ * Sits next to `series` rather than in a method of its own because the whole
13994
+ * question is a subtraction: the per-process rows in `series` sum to one
13995
+ * number and this one is another, and an operator who has to issue two calls
13996
+ * to compare them will compare two different instants. Same reader, same
13997
+ * `sinceMs`, same `bucketMs`, same timestamps.
13998
+ *
13999
+ * **EMPTY means ABSENT, never zero.** A node with no cgroup — a developer
14000
+ * Mac, a bare-metal host, a container with the hierarchy hidden — reports no
14001
+ * points at all. A zero here would be indistinguishable from a healthy
14002
+ * container and is precisely the lie this field exists to avoid.
14003
+ */
14004
+ containerMemory: array(ContainerMemoryPointSchema).readonly(),
14005
+ /**
13839
14006
  * Width of one returned bucket, in ms. Equals the sampling cadence when no
13840
14007
  * reduction was needed — so a caller can always say what one point covers
13841
14008
  * without having to know whether it was reduced.
@@ -18056,6 +18223,20 @@ var TrackSchema = object({
18056
18223
  * `=== true` and render nothing otherwise — never infer "no rider".
18057
18224
  */
18058
18225
  hasRider: boolean().optional(),
18226
+ /**
18227
+ * WHY this track ended without a NATIVE best-shot tile
18228
+ * ([D276](../decisions/adr-0276-a-stand-in-tile-is-provisional-and-a-close-says-why.md)) —
18229
+ * a composed token line (`no-key-frame capture=keyframe:native-missx4`,
18230
+ * `derive-returned-null tile=standin`, …) written at close and CLEARED by
18231
+ * the late-keyFrame upgrade when a native tile lands after all. The
18232
+ * operator-facing answer to "perché manca l'immagine?" on a track whose
18233
+ * tile is a face/plate stand-in, a raster crop, or an icon.
18234
+ *
18235
+ * **Absent ≠ "missed silently"**: a row written before the column, a hub
18236
+ * that predates the field, and every track whose tile landed native all
18237
+ * omit it. Render nothing when absent.
18238
+ */
18239
+ previewMissReason: string().optional(),
18059
18240
  ...TrackFlagFields,
18060
18241
  ...TrackRetrainFields
18061
18242
  });
@@ -27517,10 +27698,10 @@ DeviceType.Camera, DeviceType.Sensor, DeviceType.Switch, method(object({ deviceI
27517
27698
  * recording config. NOTE on events (source of truth, R5/C3): this cap carries
27518
27699
  * NO event surface — `getPlaybackManifest` returns playlist URLs only. Timeline
27519
27700
  * events (motion/object/audio) come from `pipelineAnalytics` (durable SQLite
27520
- * rows); the recorder's internal EventMap markers are ephemeral in-RAM
27521
- * annotations that are not exposed here and must not be treated as an event
27522
- * feed. Event<->footage joins are by time, padded with the shared `EVENT_PAD_MS`
27523
- * (`interfaces/recording-config.ts`).
27701
+ * rows) and are the ONLY event surface — the recorder has none. The in-RAM
27702
+ * playback markers it used to build were deleted on 2026-08-29 because nothing
27703
+ * ever read them. Event<->footage joins are by time, padded with the shared
27704
+ * `EVENT_PAD_MS` (`interfaces/recording-config.ts`).
27524
27705
  */
27525
27706
  var RecordingStatusSchema = object({
27526
27707
  deviceId: number(),
@@ -29231,6 +29412,13 @@ var LoggingSettingsPatchSchema = object({
29231
29412
  * anyone but its owner.
29232
29413
  */
29233
29414
  var ReportedLoadContributionSchema = LoadContributionSchema.extend({ addonId: string() });
29415
+ /**
29416
+ * One per-camera failure counter, plus WHO reported it.
29417
+ *
29418
+ * Same rule as {@link ReportedLoadContributionSchema}: `addonId` is stamped by
29419
+ * the hub as it enumerates providers, never by the contributor.
29420
+ */
29421
+ var ReportedFailureContributionSchema = FailureContributionSchema.extend({ addonId: string() });
29234
29422
  var GetLoggingSettingsInputSchema = object({
29235
29423
  scopeNodeId: string().optional(),
29236
29424
  /**
@@ -29289,7 +29477,7 @@ method(_void(), FeatureManifestSchema), method(_void(), HealthStatusSchema), met
29289
29477
  }), method(_void(), SiteLocationStatusSchema, {
29290
29478
  kind: "mutation",
29291
29479
  auth: "admin"
29292
- }), method(_void(), RequestCensusStatusSchema, { auth: "admin" }), method(_void(), array(ReportedLoadContributionSchema).readonly(), { auth: "admin" }), method(GetLoggingSettingsInputSchema, LoggingSettingsStateSchema, { auth: "admin" }), method(SetLoggingSettingsInputSchema, LoggingSettingsStateSchema, {
29480
+ }), 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, {
29293
29481
  kind: "mutation",
29294
29482
  auth: "admin"
29295
29483
  });
@@ -33279,6 +33467,12 @@ Object.freeze({
33279
33467
  addonId: null,
33280
33468
  access: "create"
33281
33469
  },
33470
+ "failureContribution.list": {
33471
+ capName: "failure-contribution",
33472
+ capScope: "system",
33473
+ addonId: null,
33474
+ access: "view"
33475
+ },
33282
33476
  "fanControl.setDirection": {
33283
33477
  capName: "fan-control",
33284
33478
  capScope: "device",
@@ -36585,6 +36779,12 @@ Object.freeze({
36585
36779
  addonId: null,
36586
36780
  access: "create"
36587
36781
  },
36782
+ "system.getFailureContributions": {
36783
+ capName: "system",
36784
+ capScope: "system",
36785
+ addonId: null,
36786
+ access: "view"
36787
+ },
36588
36788
  "system.getLoadContributions": {
36589
36789
  capName: "system",
36590
36790
  capScope: "system",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@camstack/addon-provider-velux",
3
- "version": "0.2.38",
3
+ "version": "0.2.41",
4
4
  "description": "Velux KLF-200 device-provider addon for CamStack — local-gateway window + shutter covers (positional, no tilt)",
5
5
  "keywords": [
6
6
  "camstack",