@camstack/addon-provider-dreo 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
@@ -13520,6 +13520,114 @@ method(LogEntrySchema, _void(), { kind: "mutation" }), method(object({
13520
13520
  limit: number().optional(),
13521
13521
  tags: record(string(), string()).optional()
13522
13522
  }), array(LogEntrySchema).readonly());
13523
+ /**
13524
+ * `failure-contribution` — the capability an addon reports its OWN losses
13525
+ * through, per camera, with the denominator attached. It stores nothing.
13526
+ *
13527
+ * ## The twin of `load-contribution`, and why it is a twin and not a field
13528
+ *
13529
+ * `load-contribution` answers *what did this camera COST*. This answers *what
13530
+ * did this camera LOSE*. The reporting discipline is identical and deliberately
13531
+ * copied: the contributor reports what it already knows, hub-main adds only
13532
+ * `addonId`, nothing needs global knowledge, and there is no central list for
13533
+ * somebody to forget to edit.
13534
+ *
13535
+ * They are not merged, because their invariants are opposites:
13536
+ *
13537
+ * - a `load-contribution` measurement is **absent, never zero** — a zero would
13538
+ * claim a camera cost nothing, which is a measurement nobody made;
13539
+ * - a `failure-contribution` zero is the **most valuable value on the
13540
+ * surface** — `attempts: 400, succeeded: 400` is the proof a fix landed,
13541
+ * and it is exactly what an absent entry cannot say.
13542
+ *
13543
+ * Putting a loss counter on a cost entry would also break the reconciliation
13544
+ * that gives `load-contribution` its point: contributions are subtracted from
13545
+ * `metrics.node-processes-snapshot` to find processes nobody claims. A failure
13546
+ * has no process.
13547
+ *
13548
+ * ## Why not a log line, since the counters already exist
13549
+ *
13550
+ * Several of these paths already counted themselves — `CaptureScheduler`'s
13551
+ * per-device window, `KeyFrameCaptureLog`, `bumpCropMetric`. Every one of them
13552
+ * ends in a log line, and a log line is the thing the operator asked to stop
13553
+ * needing: *"possiamo armare questi errori intanto? Così al prossimo giro
13554
+ * ricontrolliamo tutti questi punti"*. Reading them meant grepping Loki and
13555
+ * hand-correlating timestamps, which is how a 22% thumbnail gap and a 3-hour
13556
+ * media blackout were both diagnosed. The counters stay; this is where they can
13557
+ * be READ.
13558
+ *
13559
+ * ## The rate is served with its denominator or not at all
13560
+ *
13561
+ * Every entry carries `attempts` and `succeeded`. A miss count alone is
13562
+ * unreadable: on 2026-08-28 the enrichment-crop miss count read as "35x worse
13563
+ * than yesterday" and was **flat across twelve hours** once divided by the
13564
+ * successes on the same path. A surface that publishes only the numerator
13565
+ * reproduces that mistake on every read.
13566
+ *
13567
+ * ## Shape
13568
+ *
13569
+ * Copied from `load-contribution.cap.ts` (`mode: 'collection'`,
13570
+ * `internal: true`, `mount: { kind: 'skip' }`): no tRPC route of its own and no
13571
+ * generated hooks, while `addons.listCapabilityProviders` still enumerates it
13572
+ * and the hub's `CapabilityRegistry` still holds an RPC proxy per provider — so
13573
+ * a forked runner's entries reach hub-main over transport that already exists.
13574
+ * No new UDS message, no second registry (D3). The operator reads the assembled
13575
+ * result through `system.getFailureContributions`.
13576
+ */
13577
+ var FailureReasonCountSchema = object({
13578
+ /**
13579
+ * Why the attempt did not land, in the contributor's own vocabulary —
13580
+ * `worker-lease-gone`, `queue-overflow`, `timeout`, `empty-read`. The same
13581
+ * strings that already appear in this repo's logs and, where one exists, the
13582
+ * same string the per-track `previewMissReason` records (D276): a second
13583
+ * vocabulary for the same loss would make the row and the counter
13584
+ * un-joinable.
13585
+ */
13586
+ reason: string(),
13587
+ count: number().int().nonnegative()
13588
+ });
13589
+ var FailureContributionSchema = object({
13590
+ /**
13591
+ * The failing path — `enrichment-crop`, `inference`, `plate-ocr`,
13592
+ * `person-over-vehicle`. Free text, for the reason `load-contribution` keeps
13593
+ * `unit` free: the families are owned by different addons and a shared enum
13594
+ * is a central list that rots invisibly.
13595
+ */
13596
+ family: string(),
13597
+ /**
13598
+ * The NUMERIC device id — the same value every log line carries as
13599
+ * `tags.deviceId`. Never nullable and never absent: a contributor that
13600
+ * cannot name the camera must not emit the entry, because a fleet total
13601
+ * cannot answer the only question anybody asks of this surface.
13602
+ */
13603
+ deviceId: number().int().positive(),
13604
+ /**
13605
+ * A second dimension inside the family: the model / step id for an inference
13606
+ * timeout, so "which camera AND which model" is one read. Absent when the
13607
+ * family has a single variant.
13608
+ */
13609
+ variant: string().optional(),
13610
+ /**
13611
+ * Epoch ms this counter started — the INCARNATION MARKER. A consumer
13612
+ * differencing two reads must drop the interval when it changes, because the
13613
+ * counter restarted from zero in a respawned runner. Same discipline as
13614
+ * `LoadContribution.startedAtMs`.
13615
+ */
13616
+ sinceMs: number(),
13617
+ /** Epoch ms it was read. `atMs - sinceMs` is the interval this covers. */
13618
+ atMs: number(),
13619
+ /**
13620
+ * THE DENOMINATOR — every attempt on this path for this camera in the
13621
+ * window. A failure count published without it is the mistake this schema
13622
+ * exists to make impossible.
13623
+ */
13624
+ attempts: number().int().nonnegative(),
13625
+ /** Attempts that landed. `attempts - succeeded` is the loss. */
13626
+ succeeded: number().int().nonnegative(),
13627
+ /** The loss, partitioned. Sums to `attempts - succeeded`. */
13628
+ reasons: array(FailureReasonCountSchema).readonly()
13629
+ });
13630
+ method(_void(), array(FailureContributionSchema).readonly());
13523
13631
  var LoadContributionSchema = object({
13524
13632
  role: _enum([
13525
13633
  "decode",
@@ -13827,6 +13935,50 @@ var NodeProcessSchema = object({
13827
13935
  /** Wall-clock uptime (seconds). Parsed from `ps etime`. */
13828
13936
  uptimeSec: number()
13829
13937
  });
13938
+ /**
13939
+ * One retained container-memory reading.
13940
+ *
13941
+ * `atMs` is the timestamp of the PROCESS snapshot taken in the same tick, not
13942
+ * a second clock: that is what makes "processes sum to X, container says Y"
13943
+ * subtractable per point rather than an eyeballed comparison of two series
13944
+ * sampled at different instants.
13945
+ *
13946
+ * A reduced window keeps the sample with the LARGEST `currentBytes` in each
13947
+ * bucket, WHOLE. Taking a per-field maximum would synthesise a row whose parts
13948
+ * never coexisted, and a mean would smear away the peak this exists to find.
13949
+ */
13950
+ var ContainerMemoryPointSchema = object({
13951
+ /** Which hierarchy answered, so a reading is never ambiguous. */
13952
+ source: _enum(["cgroup-v2", "cgroup-v1"]),
13953
+ /** `memory.current` (v2) / `memory.usage_in_bytes` (v1). Always known. */
13954
+ currentBytes: number(),
13955
+ /** The cgroup's ceiling. `null` = NO LIMIT — never a sentinel, never zero. */
13956
+ limitBytes: number().nullable(),
13957
+ /** Anonymous pages: the closest thing to "what the processes allocated". */
13958
+ anonBytes: number().nullable(),
13959
+ /** Page cache. Charged to the cgroup, owned by no process. */
13960
+ fileBytes: number().nullable(),
13961
+ /**
13962
+ * Shared memory — and the field that explained the largest single surprise.
13963
+ * The i915 driver backs GPU buffers with shmem, so an inference pool or a
13964
+ * hardware-decode session holding DRM objects is charged HERE and appears
13965
+ * nowhere in a `ps` scan.
13966
+ */
13967
+ shmemBytes: number().nullable(),
13968
+ /** Kernel slab charged to this cgroup. `null` on v1, which never publishes it. */
13969
+ slabBytes: number().nullable(),
13970
+ /**
13971
+ * Shrinkable i915 GEM object bytes, from debugfs.
13972
+ *
13973
+ * **Host-wide across every DRM client, NOT cgroup-scoped.** It is not a
13974
+ * component of `currentBytes` and must not be subtracted from it; it says
13975
+ * what put the shmem there, where `shmemBytes` only says how much.
13976
+ *
13977
+ * `null` wherever debugfs is not mounted — which is inside every camstack
13978
+ * container today — and on any node with no Intel GPU.
13979
+ */
13980
+ gpuShmemBytes: number().nullable()
13981
+ }).extend({ atMs: number() });
13830
13982
  var DumpHeapSnapshotInputSchema = object({
13831
13983
  /** The addon whose runner should dump a heap snapshot. */
13832
13984
  addonId: string() });
@@ -13890,6 +14042,21 @@ var NodeLoadSeriesSchema = object({
13890
14042
  /** One entry per function seen in the window, heaviest-first. */
13891
14043
  series: array(LoadFunctionSeriesSchema).readonly(),
13892
14044
  /**
14045
+ * The CONTAINER's memory over the same window, oldest-first.
14046
+ *
14047
+ * Sits next to `series` rather than in a method of its own because the whole
14048
+ * question is a subtraction: the per-process rows in `series` sum to one
14049
+ * number and this one is another, and an operator who has to issue two calls
14050
+ * to compare them will compare two different instants. Same reader, same
14051
+ * `sinceMs`, same `bucketMs`, same timestamps.
14052
+ *
14053
+ * **EMPTY means ABSENT, never zero.** A node with no cgroup — a developer
14054
+ * Mac, a bare-metal host, a container with the hierarchy hidden — reports no
14055
+ * points at all. A zero here would be indistinguishable from a healthy
14056
+ * container and is precisely the lie this field exists to avoid.
14057
+ */
14058
+ containerMemory: array(ContainerMemoryPointSchema).readonly(),
14059
+ /**
13893
14060
  * Width of one returned bucket, in ms. Equals the sampling cadence when no
13894
14061
  * reduction was needed — so a caller can always say what one point covers
13895
14062
  * without having to know whether it was reduced.
@@ -18110,6 +18277,20 @@ var TrackSchema = object({
18110
18277
  * `=== true` and render nothing otherwise — never infer "no rider".
18111
18278
  */
18112
18279
  hasRider: boolean().optional(),
18280
+ /**
18281
+ * WHY this track ended without a NATIVE best-shot tile
18282
+ * ([D276](../decisions/adr-0276-a-stand-in-tile-is-provisional-and-a-close-says-why.md)) —
18283
+ * a composed token line (`no-key-frame capture=keyframe:native-missx4`,
18284
+ * `derive-returned-null tile=standin`, …) written at close and CLEARED by
18285
+ * the late-keyFrame upgrade when a native tile lands after all. The
18286
+ * operator-facing answer to "perché manca l'immagine?" on a track whose
18287
+ * tile is a face/plate stand-in, a raster crop, or an icon.
18288
+ *
18289
+ * **Absent ≠ "missed silently"**: a row written before the column, a hub
18290
+ * that predates the field, and every track whose tile landed native all
18291
+ * omit it. Render nothing when absent.
18292
+ */
18293
+ previewMissReason: string().optional(),
18113
18294
  ...TrackFlagFields,
18114
18295
  ...TrackRetrainFields
18115
18296
  });
@@ -27579,10 +27760,10 @@ DeviceType.Camera, DeviceType.Sensor, DeviceType.Switch, method(object({ deviceI
27579
27760
  * recording config. NOTE on events (source of truth, R5/C3): this cap carries
27580
27761
  * NO event surface — `getPlaybackManifest` returns playlist URLs only. Timeline
27581
27762
  * events (motion/object/audio) come from `pipelineAnalytics` (durable SQLite
27582
- * rows); the recorder's internal EventMap markers are ephemeral in-RAM
27583
- * annotations that are not exposed here and must not be treated as an event
27584
- * feed. Event<->footage joins are by time, padded with the shared `EVENT_PAD_MS`
27585
- * (`interfaces/recording-config.ts`).
27763
+ * rows) and are the ONLY event surface — the recorder has none. The in-RAM
27764
+ * playback markers it used to build were deleted on 2026-08-29 because nothing
27765
+ * ever read them. Event<->footage joins are by time, padded with the shared
27766
+ * `EVENT_PAD_MS` (`interfaces/recording-config.ts`).
27586
27767
  */
27587
27768
  var RecordingStatusSchema = object({
27588
27769
  deviceId: number(),
@@ -29293,6 +29474,13 @@ var LoggingSettingsPatchSchema = object({
29293
29474
  * anyone but its owner.
29294
29475
  */
29295
29476
  var ReportedLoadContributionSchema = LoadContributionSchema.extend({ addonId: string() });
29477
+ /**
29478
+ * One per-camera failure counter, plus WHO reported it.
29479
+ *
29480
+ * Same rule as {@link ReportedLoadContributionSchema}: `addonId` is stamped by
29481
+ * the hub as it enumerates providers, never by the contributor.
29482
+ */
29483
+ var ReportedFailureContributionSchema = FailureContributionSchema.extend({ addonId: string() });
29296
29484
  var GetLoggingSettingsInputSchema = object({
29297
29485
  scopeNodeId: string().optional(),
29298
29486
  /**
@@ -29351,7 +29539,7 @@ method(_void(), FeatureManifestSchema), method(_void(), HealthStatusSchema), met
29351
29539
  }), method(_void(), SiteLocationStatusSchema, {
29352
29540
  kind: "mutation",
29353
29541
  auth: "admin"
29354
- }), method(_void(), RequestCensusStatusSchema, { auth: "admin" }), method(_void(), array(ReportedLoadContributionSchema).readonly(), { auth: "admin" }), method(GetLoggingSettingsInputSchema, LoggingSettingsStateSchema, { auth: "admin" }), method(SetLoggingSettingsInputSchema, LoggingSettingsStateSchema, {
29542
+ }), 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, {
29355
29543
  kind: "mutation",
29356
29544
  auth: "admin"
29357
29545
  });
@@ -33341,6 +33529,12 @@ Object.freeze({
33341
33529
  addonId: null,
33342
33530
  access: "create"
33343
33531
  },
33532
+ "failureContribution.list": {
33533
+ capName: "failure-contribution",
33534
+ capScope: "system",
33535
+ addonId: null,
33536
+ access: "view"
33537
+ },
33344
33538
  "fanControl.setDirection": {
33345
33539
  capName: "fan-control",
33346
33540
  capScope: "device",
@@ -36647,6 +36841,12 @@ Object.freeze({
36647
36841
  addonId: null,
36648
36842
  access: "create"
36649
36843
  },
36844
+ "system.getFailureContributions": {
36845
+ capName: "system",
36846
+ capScope: "system",
36847
+ addonId: null,
36848
+ access: "view"
36849
+ },
36650
36850
  "system.getLoadContributions": {
36651
36851
  capName: "system",
36652
36852
  capScope: "system",
package/dist/addon.mjs CHANGED
@@ -13521,6 +13521,114 @@ method(LogEntrySchema, _void(), { kind: "mutation" }), method(object({
13521
13521
  limit: number().optional(),
13522
13522
  tags: record(string(), string()).optional()
13523
13523
  }), array(LogEntrySchema).readonly());
13524
+ /**
13525
+ * `failure-contribution` — the capability an addon reports its OWN losses
13526
+ * through, per camera, with the denominator attached. It stores nothing.
13527
+ *
13528
+ * ## The twin of `load-contribution`, and why it is a twin and not a field
13529
+ *
13530
+ * `load-contribution` answers *what did this camera COST*. This answers *what
13531
+ * did this camera LOSE*. The reporting discipline is identical and deliberately
13532
+ * copied: the contributor reports what it already knows, hub-main adds only
13533
+ * `addonId`, nothing needs global knowledge, and there is no central list for
13534
+ * somebody to forget to edit.
13535
+ *
13536
+ * They are not merged, because their invariants are opposites:
13537
+ *
13538
+ * - a `load-contribution` measurement is **absent, never zero** — a zero would
13539
+ * claim a camera cost nothing, which is a measurement nobody made;
13540
+ * - a `failure-contribution` zero is the **most valuable value on the
13541
+ * surface** — `attempts: 400, succeeded: 400` is the proof a fix landed,
13542
+ * and it is exactly what an absent entry cannot say.
13543
+ *
13544
+ * Putting a loss counter on a cost entry would also break the reconciliation
13545
+ * that gives `load-contribution` its point: contributions are subtracted from
13546
+ * `metrics.node-processes-snapshot` to find processes nobody claims. A failure
13547
+ * has no process.
13548
+ *
13549
+ * ## Why not a log line, since the counters already exist
13550
+ *
13551
+ * Several of these paths already counted themselves — `CaptureScheduler`'s
13552
+ * per-device window, `KeyFrameCaptureLog`, `bumpCropMetric`. Every one of them
13553
+ * ends in a log line, and a log line is the thing the operator asked to stop
13554
+ * needing: *"possiamo armare questi errori intanto? Così al prossimo giro
13555
+ * ricontrolliamo tutti questi punti"*. Reading them meant grepping Loki and
13556
+ * hand-correlating timestamps, which is how a 22% thumbnail gap and a 3-hour
13557
+ * media blackout were both diagnosed. The counters stay; this is where they can
13558
+ * be READ.
13559
+ *
13560
+ * ## The rate is served with its denominator or not at all
13561
+ *
13562
+ * Every entry carries `attempts` and `succeeded`. A miss count alone is
13563
+ * unreadable: on 2026-08-28 the enrichment-crop miss count read as "35x worse
13564
+ * than yesterday" and was **flat across twelve hours** once divided by the
13565
+ * successes on the same path. A surface that publishes only the numerator
13566
+ * reproduces that mistake on every read.
13567
+ *
13568
+ * ## Shape
13569
+ *
13570
+ * Copied from `load-contribution.cap.ts` (`mode: 'collection'`,
13571
+ * `internal: true`, `mount: { kind: 'skip' }`): no tRPC route of its own and no
13572
+ * generated hooks, while `addons.listCapabilityProviders` still enumerates it
13573
+ * and the hub's `CapabilityRegistry` still holds an RPC proxy per provider — so
13574
+ * a forked runner's entries reach hub-main over transport that already exists.
13575
+ * No new UDS message, no second registry (D3). The operator reads the assembled
13576
+ * result through `system.getFailureContributions`.
13577
+ */
13578
+ var FailureReasonCountSchema = object({
13579
+ /**
13580
+ * Why the attempt did not land, in the contributor's own vocabulary —
13581
+ * `worker-lease-gone`, `queue-overflow`, `timeout`, `empty-read`. The same
13582
+ * strings that already appear in this repo's logs and, where one exists, the
13583
+ * same string the per-track `previewMissReason` records (D276): a second
13584
+ * vocabulary for the same loss would make the row and the counter
13585
+ * un-joinable.
13586
+ */
13587
+ reason: string(),
13588
+ count: number().int().nonnegative()
13589
+ });
13590
+ var FailureContributionSchema = object({
13591
+ /**
13592
+ * The failing path — `enrichment-crop`, `inference`, `plate-ocr`,
13593
+ * `person-over-vehicle`. Free text, for the reason `load-contribution` keeps
13594
+ * `unit` free: the families are owned by different addons and a shared enum
13595
+ * is a central list that rots invisibly.
13596
+ */
13597
+ family: string(),
13598
+ /**
13599
+ * The NUMERIC device id — the same value every log line carries as
13600
+ * `tags.deviceId`. Never nullable and never absent: a contributor that
13601
+ * cannot name the camera must not emit the entry, because a fleet total
13602
+ * cannot answer the only question anybody asks of this surface.
13603
+ */
13604
+ deviceId: number().int().positive(),
13605
+ /**
13606
+ * A second dimension inside the family: the model / step id for an inference
13607
+ * timeout, so "which camera AND which model" is one read. Absent when the
13608
+ * family has a single variant.
13609
+ */
13610
+ variant: string().optional(),
13611
+ /**
13612
+ * Epoch ms this counter started — the INCARNATION MARKER. A consumer
13613
+ * differencing two reads must drop the interval when it changes, because the
13614
+ * counter restarted from zero in a respawned runner. Same discipline as
13615
+ * `LoadContribution.startedAtMs`.
13616
+ */
13617
+ sinceMs: number(),
13618
+ /** Epoch ms it was read. `atMs - sinceMs` is the interval this covers. */
13619
+ atMs: number(),
13620
+ /**
13621
+ * THE DENOMINATOR — every attempt on this path for this camera in the
13622
+ * window. A failure count published without it is the mistake this schema
13623
+ * exists to make impossible.
13624
+ */
13625
+ attempts: number().int().nonnegative(),
13626
+ /** Attempts that landed. `attempts - succeeded` is the loss. */
13627
+ succeeded: number().int().nonnegative(),
13628
+ /** The loss, partitioned. Sums to `attempts - succeeded`. */
13629
+ reasons: array(FailureReasonCountSchema).readonly()
13630
+ });
13631
+ method(_void(), array(FailureContributionSchema).readonly());
13524
13632
  var LoadContributionSchema = object({
13525
13633
  role: _enum([
13526
13634
  "decode",
@@ -13828,6 +13936,50 @@ var NodeProcessSchema = object({
13828
13936
  /** Wall-clock uptime (seconds). Parsed from `ps etime`. */
13829
13937
  uptimeSec: number()
13830
13938
  });
13939
+ /**
13940
+ * One retained container-memory reading.
13941
+ *
13942
+ * `atMs` is the timestamp of the PROCESS snapshot taken in the same tick, not
13943
+ * a second clock: that is what makes "processes sum to X, container says Y"
13944
+ * subtractable per point rather than an eyeballed comparison of two series
13945
+ * sampled at different instants.
13946
+ *
13947
+ * A reduced window keeps the sample with the LARGEST `currentBytes` in each
13948
+ * bucket, WHOLE. Taking a per-field maximum would synthesise a row whose parts
13949
+ * never coexisted, and a mean would smear away the peak this exists to find.
13950
+ */
13951
+ var ContainerMemoryPointSchema = object({
13952
+ /** Which hierarchy answered, so a reading is never ambiguous. */
13953
+ source: _enum(["cgroup-v2", "cgroup-v1"]),
13954
+ /** `memory.current` (v2) / `memory.usage_in_bytes` (v1). Always known. */
13955
+ currentBytes: number(),
13956
+ /** The cgroup's ceiling. `null` = NO LIMIT — never a sentinel, never zero. */
13957
+ limitBytes: number().nullable(),
13958
+ /** Anonymous pages: the closest thing to "what the processes allocated". */
13959
+ anonBytes: number().nullable(),
13960
+ /** Page cache. Charged to the cgroup, owned by no process. */
13961
+ fileBytes: number().nullable(),
13962
+ /**
13963
+ * Shared memory — and the field that explained the largest single surprise.
13964
+ * The i915 driver backs GPU buffers with shmem, so an inference pool or a
13965
+ * hardware-decode session holding DRM objects is charged HERE and appears
13966
+ * nowhere in a `ps` scan.
13967
+ */
13968
+ shmemBytes: number().nullable(),
13969
+ /** Kernel slab charged to this cgroup. `null` on v1, which never publishes it. */
13970
+ slabBytes: number().nullable(),
13971
+ /**
13972
+ * Shrinkable i915 GEM object bytes, from debugfs.
13973
+ *
13974
+ * **Host-wide across every DRM client, NOT cgroup-scoped.** It is not a
13975
+ * component of `currentBytes` and must not be subtracted from it; it says
13976
+ * what put the shmem there, where `shmemBytes` only says how much.
13977
+ *
13978
+ * `null` wherever debugfs is not mounted — which is inside every camstack
13979
+ * container today — and on any node with no Intel GPU.
13980
+ */
13981
+ gpuShmemBytes: number().nullable()
13982
+ }).extend({ atMs: number() });
13831
13983
  var DumpHeapSnapshotInputSchema = object({
13832
13984
  /** The addon whose runner should dump a heap snapshot. */
13833
13985
  addonId: string() });
@@ -13891,6 +14043,21 @@ var NodeLoadSeriesSchema = object({
13891
14043
  /** One entry per function seen in the window, heaviest-first. */
13892
14044
  series: array(LoadFunctionSeriesSchema).readonly(),
13893
14045
  /**
14046
+ * The CONTAINER's memory over the same window, oldest-first.
14047
+ *
14048
+ * Sits next to `series` rather than in a method of its own because the whole
14049
+ * question is a subtraction: the per-process rows in `series` sum to one
14050
+ * number and this one is another, and an operator who has to issue two calls
14051
+ * to compare them will compare two different instants. Same reader, same
14052
+ * `sinceMs`, same `bucketMs`, same timestamps.
14053
+ *
14054
+ * **EMPTY means ABSENT, never zero.** A node with no cgroup — a developer
14055
+ * Mac, a bare-metal host, a container with the hierarchy hidden — reports no
14056
+ * points at all. A zero here would be indistinguishable from a healthy
14057
+ * container and is precisely the lie this field exists to avoid.
14058
+ */
14059
+ containerMemory: array(ContainerMemoryPointSchema).readonly(),
14060
+ /**
13894
14061
  * Width of one returned bucket, in ms. Equals the sampling cadence when no
13895
14062
  * reduction was needed — so a caller can always say what one point covers
13896
14063
  * without having to know whether it was reduced.
@@ -18111,6 +18278,20 @@ var TrackSchema = object({
18111
18278
  * `=== true` and render nothing otherwise — never infer "no rider".
18112
18279
  */
18113
18280
  hasRider: boolean().optional(),
18281
+ /**
18282
+ * WHY this track ended without a NATIVE best-shot tile
18283
+ * ([D276](../decisions/adr-0276-a-stand-in-tile-is-provisional-and-a-close-says-why.md)) —
18284
+ * a composed token line (`no-key-frame capture=keyframe:native-missx4`,
18285
+ * `derive-returned-null tile=standin`, …) written at close and CLEARED by
18286
+ * the late-keyFrame upgrade when a native tile lands after all. The
18287
+ * operator-facing answer to "perché manca l'immagine?" on a track whose
18288
+ * tile is a face/plate stand-in, a raster crop, or an icon.
18289
+ *
18290
+ * **Absent ≠ "missed silently"**: a row written before the column, a hub
18291
+ * that predates the field, and every track whose tile landed native all
18292
+ * omit it. Render nothing when absent.
18293
+ */
18294
+ previewMissReason: string().optional(),
18114
18295
  ...TrackFlagFields,
18115
18296
  ...TrackRetrainFields
18116
18297
  });
@@ -27580,10 +27761,10 @@ DeviceType.Camera, DeviceType.Sensor, DeviceType.Switch, method(object({ deviceI
27580
27761
  * recording config. NOTE on events (source of truth, R5/C3): this cap carries
27581
27762
  * NO event surface — `getPlaybackManifest` returns playlist URLs only. Timeline
27582
27763
  * events (motion/object/audio) come from `pipelineAnalytics` (durable SQLite
27583
- * rows); the recorder's internal EventMap markers are ephemeral in-RAM
27584
- * annotations that are not exposed here and must not be treated as an event
27585
- * feed. Event<->footage joins are by time, padded with the shared `EVENT_PAD_MS`
27586
- * (`interfaces/recording-config.ts`).
27764
+ * rows) and are the ONLY event surface — the recorder has none. The in-RAM
27765
+ * playback markers it used to build were deleted on 2026-08-29 because nothing
27766
+ * ever read them. Event<->footage joins are by time, padded with the shared
27767
+ * `EVENT_PAD_MS` (`interfaces/recording-config.ts`).
27587
27768
  */
27588
27769
  var RecordingStatusSchema = object({
27589
27770
  deviceId: number(),
@@ -29294,6 +29475,13 @@ var LoggingSettingsPatchSchema = object({
29294
29475
  * anyone but its owner.
29295
29476
  */
29296
29477
  var ReportedLoadContributionSchema = LoadContributionSchema.extend({ addonId: string() });
29478
+ /**
29479
+ * One per-camera failure counter, plus WHO reported it.
29480
+ *
29481
+ * Same rule as {@link ReportedLoadContributionSchema}: `addonId` is stamped by
29482
+ * the hub as it enumerates providers, never by the contributor.
29483
+ */
29484
+ var ReportedFailureContributionSchema = FailureContributionSchema.extend({ addonId: string() });
29297
29485
  var GetLoggingSettingsInputSchema = object({
29298
29486
  scopeNodeId: string().optional(),
29299
29487
  /**
@@ -29352,7 +29540,7 @@ method(_void(), FeatureManifestSchema), method(_void(), HealthStatusSchema), met
29352
29540
  }), method(_void(), SiteLocationStatusSchema, {
29353
29541
  kind: "mutation",
29354
29542
  auth: "admin"
29355
- }), method(_void(), RequestCensusStatusSchema, { auth: "admin" }), method(_void(), array(ReportedLoadContributionSchema).readonly(), { auth: "admin" }), method(GetLoggingSettingsInputSchema, LoggingSettingsStateSchema, { auth: "admin" }), method(SetLoggingSettingsInputSchema, LoggingSettingsStateSchema, {
29543
+ }), 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, {
29356
29544
  kind: "mutation",
29357
29545
  auth: "admin"
29358
29546
  });
@@ -33342,6 +33530,12 @@ Object.freeze({
33342
33530
  addonId: null,
33343
33531
  access: "create"
33344
33532
  },
33533
+ "failureContribution.list": {
33534
+ capName: "failure-contribution",
33535
+ capScope: "system",
33536
+ addonId: null,
33537
+ access: "view"
33538
+ },
33345
33539
  "fanControl.setDirection": {
33346
33540
  capName: "fan-control",
33347
33541
  capScope: "device",
@@ -36648,6 +36842,12 @@ Object.freeze({
36648
36842
  addonId: null,
36649
36843
  access: "create"
36650
36844
  },
36845
+ "system.getFailureContributions": {
36846
+ capName: "system",
36847
+ capScope: "system",
36848
+ addonId: null,
36849
+ access: "view"
36850
+ },
36651
36851
  "system.getLoadContributions": {
36652
36852
  capName: "system",
36653
36853
  capScope: "system",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@camstack/addon-provider-dreo",
3
- "version": "0.2.38",
3
+ "version": "0.2.41",
4
4
  "description": "Dreo smart-device (fan / air-circulator / purifier / heater / humidifier) device-provider addon for CamStack — wraps the @apocaliss92/nodedreo Dreo cloud client (REST + WebSocket)",
5
5
  "keywords": [
6
6
  "camstack",