@camstack/addon-matter-broker 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
@@ -13547,6 +13547,114 @@ method(LogEntrySchema, _void(), { kind: "mutation" }), method(object({
13547
13547
  limit: number().optional(),
13548
13548
  tags: record(string$2(), string$2()).optional()
13549
13549
  }), array(LogEntrySchema).readonly());
13550
+ /**
13551
+ * `failure-contribution` — the capability an addon reports its OWN losses
13552
+ * through, per camera, with the denominator attached. It stores nothing.
13553
+ *
13554
+ * ## The twin of `load-contribution`, and why it is a twin and not a field
13555
+ *
13556
+ * `load-contribution` answers *what did this camera COST*. This answers *what
13557
+ * did this camera LOSE*. The reporting discipline is identical and deliberately
13558
+ * copied: the contributor reports what it already knows, hub-main adds only
13559
+ * `addonId`, nothing needs global knowledge, and there is no central list for
13560
+ * somebody to forget to edit.
13561
+ *
13562
+ * They are not merged, because their invariants are opposites:
13563
+ *
13564
+ * - a `load-contribution` measurement is **absent, never zero** — a zero would
13565
+ * claim a camera cost nothing, which is a measurement nobody made;
13566
+ * - a `failure-contribution` zero is the **most valuable value on the
13567
+ * surface** — `attempts: 400, succeeded: 400` is the proof a fix landed,
13568
+ * and it is exactly what an absent entry cannot say.
13569
+ *
13570
+ * Putting a loss counter on a cost entry would also break the reconciliation
13571
+ * that gives `load-contribution` its point: contributions are subtracted from
13572
+ * `metrics.node-processes-snapshot` to find processes nobody claims. A failure
13573
+ * has no process.
13574
+ *
13575
+ * ## Why not a log line, since the counters already exist
13576
+ *
13577
+ * Several of these paths already counted themselves — `CaptureScheduler`'s
13578
+ * per-device window, `KeyFrameCaptureLog`, `bumpCropMetric`. Every one of them
13579
+ * ends in a log line, and a log line is the thing the operator asked to stop
13580
+ * needing: *"possiamo armare questi errori intanto? Così al prossimo giro
13581
+ * ricontrolliamo tutti questi punti"*. Reading them meant grepping Loki and
13582
+ * hand-correlating timestamps, which is how a 22% thumbnail gap and a 3-hour
13583
+ * media blackout were both diagnosed. The counters stay; this is where they can
13584
+ * be READ.
13585
+ *
13586
+ * ## The rate is served with its denominator or not at all
13587
+ *
13588
+ * Every entry carries `attempts` and `succeeded`. A miss count alone is
13589
+ * unreadable: on 2026-08-28 the enrichment-crop miss count read as "35x worse
13590
+ * than yesterday" and was **flat across twelve hours** once divided by the
13591
+ * successes on the same path. A surface that publishes only the numerator
13592
+ * reproduces that mistake on every read.
13593
+ *
13594
+ * ## Shape
13595
+ *
13596
+ * Copied from `load-contribution.cap.ts` (`mode: 'collection'`,
13597
+ * `internal: true`, `mount: { kind: 'skip' }`): no tRPC route of its own and no
13598
+ * generated hooks, while `addons.listCapabilityProviders` still enumerates it
13599
+ * and the hub's `CapabilityRegistry` still holds an RPC proxy per provider — so
13600
+ * a forked runner's entries reach hub-main over transport that already exists.
13601
+ * No new UDS message, no second registry (D3). The operator reads the assembled
13602
+ * result through `system.getFailureContributions`.
13603
+ */
13604
+ var FailureReasonCountSchema = object({
13605
+ /**
13606
+ * Why the attempt did not land, in the contributor's own vocabulary —
13607
+ * `worker-lease-gone`, `queue-overflow`, `timeout`, `empty-read`. The same
13608
+ * strings that already appear in this repo's logs and, where one exists, the
13609
+ * same string the per-track `previewMissReason` records (D276): a second
13610
+ * vocabulary for the same loss would make the row and the counter
13611
+ * un-joinable.
13612
+ */
13613
+ reason: string$2(),
13614
+ count: number().int().nonnegative()
13615
+ });
13616
+ var FailureContributionSchema = object({
13617
+ /**
13618
+ * The failing path — `enrichment-crop`, `inference`, `plate-ocr`,
13619
+ * `person-over-vehicle`. Free text, for the reason `load-contribution` keeps
13620
+ * `unit` free: the families are owned by different addons and a shared enum
13621
+ * is a central list that rots invisibly.
13622
+ */
13623
+ family: string$2(),
13624
+ /**
13625
+ * The NUMERIC device id — the same value every log line carries as
13626
+ * `tags.deviceId`. Never nullable and never absent: a contributor that
13627
+ * cannot name the camera must not emit the entry, because a fleet total
13628
+ * cannot answer the only question anybody asks of this surface.
13629
+ */
13630
+ deviceId: number().int().positive(),
13631
+ /**
13632
+ * A second dimension inside the family: the model / step id for an inference
13633
+ * timeout, so "which camera AND which model" is one read. Absent when the
13634
+ * family has a single variant.
13635
+ */
13636
+ variant: string$2().optional(),
13637
+ /**
13638
+ * Epoch ms this counter started — the INCARNATION MARKER. A consumer
13639
+ * differencing two reads must drop the interval when it changes, because the
13640
+ * counter restarted from zero in a respawned runner. Same discipline as
13641
+ * `LoadContribution.startedAtMs`.
13642
+ */
13643
+ sinceMs: number(),
13644
+ /** Epoch ms it was read. `atMs - sinceMs` is the interval this covers. */
13645
+ atMs: number(),
13646
+ /**
13647
+ * THE DENOMINATOR — every attempt on this path for this camera in the
13648
+ * window. A failure count published without it is the mistake this schema
13649
+ * exists to make impossible.
13650
+ */
13651
+ attempts: number().int().nonnegative(),
13652
+ /** Attempts that landed. `attempts - succeeded` is the loss. */
13653
+ succeeded: number().int().nonnegative(),
13654
+ /** The loss, partitioned. Sums to `attempts - succeeded`. */
13655
+ reasons: array(FailureReasonCountSchema).readonly()
13656
+ });
13657
+ method(_void(), array(FailureContributionSchema).readonly());
13550
13658
  var LoadContributionSchema = object({
13551
13659
  role: _enum([
13552
13660
  "decode",
@@ -13854,6 +13962,50 @@ var NodeProcessSchema = object({
13854
13962
  /** Wall-clock uptime (seconds). Parsed from `ps etime`. */
13855
13963
  uptimeSec: number()
13856
13964
  });
13965
+ /**
13966
+ * One retained container-memory reading.
13967
+ *
13968
+ * `atMs` is the timestamp of the PROCESS snapshot taken in the same tick, not
13969
+ * a second clock: that is what makes "processes sum to X, container says Y"
13970
+ * subtractable per point rather than an eyeballed comparison of two series
13971
+ * sampled at different instants.
13972
+ *
13973
+ * A reduced window keeps the sample with the LARGEST `currentBytes` in each
13974
+ * bucket, WHOLE. Taking a per-field maximum would synthesise a row whose parts
13975
+ * never coexisted, and a mean would smear away the peak this exists to find.
13976
+ */
13977
+ var ContainerMemoryPointSchema = object({
13978
+ /** Which hierarchy answered, so a reading is never ambiguous. */
13979
+ source: _enum(["cgroup-v2", "cgroup-v1"]),
13980
+ /** `memory.current` (v2) / `memory.usage_in_bytes` (v1). Always known. */
13981
+ currentBytes: number(),
13982
+ /** The cgroup's ceiling. `null` = NO LIMIT — never a sentinel, never zero. */
13983
+ limitBytes: number().nullable(),
13984
+ /** Anonymous pages: the closest thing to "what the processes allocated". */
13985
+ anonBytes: number().nullable(),
13986
+ /** Page cache. Charged to the cgroup, owned by no process. */
13987
+ fileBytes: number().nullable(),
13988
+ /**
13989
+ * Shared memory — and the field that explained the largest single surprise.
13990
+ * The i915 driver backs GPU buffers with shmem, so an inference pool or a
13991
+ * hardware-decode session holding DRM objects is charged HERE and appears
13992
+ * nowhere in a `ps` scan.
13993
+ */
13994
+ shmemBytes: number().nullable(),
13995
+ /** Kernel slab charged to this cgroup. `null` on v1, which never publishes it. */
13996
+ slabBytes: number().nullable(),
13997
+ /**
13998
+ * Shrinkable i915 GEM object bytes, from debugfs.
13999
+ *
14000
+ * **Host-wide across every DRM client, NOT cgroup-scoped.** It is not a
14001
+ * component of `currentBytes` and must not be subtracted from it; it says
14002
+ * what put the shmem there, where `shmemBytes` only says how much.
14003
+ *
14004
+ * `null` wherever debugfs is not mounted — which is inside every camstack
14005
+ * container today — and on any node with no Intel GPU.
14006
+ */
14007
+ gpuShmemBytes: number().nullable()
14008
+ }).extend({ atMs: number() });
13857
14009
  var DumpHeapSnapshotInputSchema = object({
13858
14010
  /** The addon whose runner should dump a heap snapshot. */
13859
14011
  addonId: string$2() });
@@ -13917,6 +14069,21 @@ var NodeLoadSeriesSchema = object({
13917
14069
  /** One entry per function seen in the window, heaviest-first. */
13918
14070
  series: array(LoadFunctionSeriesSchema).readonly(),
13919
14071
  /**
14072
+ * The CONTAINER's memory over the same window, oldest-first.
14073
+ *
14074
+ * Sits next to `series` rather than in a method of its own because the whole
14075
+ * question is a subtraction: the per-process rows in `series` sum to one
14076
+ * number and this one is another, and an operator who has to issue two calls
14077
+ * to compare them will compare two different instants. Same reader, same
14078
+ * `sinceMs`, same `bucketMs`, same timestamps.
14079
+ *
14080
+ * **EMPTY means ABSENT, never zero.** A node with no cgroup — a developer
14081
+ * Mac, a bare-metal host, a container with the hierarchy hidden — reports no
14082
+ * points at all. A zero here would be indistinguishable from a healthy
14083
+ * container and is precisely the lie this field exists to avoid.
14084
+ */
14085
+ containerMemory: array(ContainerMemoryPointSchema).readonly(),
14086
+ /**
13920
14087
  * Width of one returned bucket, in ms. Equals the sampling cadence when no
13921
14088
  * reduction was needed — so a caller can always say what one point covers
13922
14089
  * without having to know whether it was reduced.
@@ -18137,6 +18304,20 @@ var TrackSchema = object({
18137
18304
  * `=== true` and render nothing otherwise — never infer "no rider".
18138
18305
  */
18139
18306
  hasRider: boolean().optional(),
18307
+ /**
18308
+ * WHY this track ended without a NATIVE best-shot tile
18309
+ * ([D276](../decisions/adr-0276-a-stand-in-tile-is-provisional-and-a-close-says-why.md)) —
18310
+ * a composed token line (`no-key-frame capture=keyframe:native-missx4`,
18311
+ * `derive-returned-null tile=standin`, …) written at close and CLEARED by
18312
+ * the late-keyFrame upgrade when a native tile lands after all. The
18313
+ * operator-facing answer to "perché manca l'immagine?" on a track whose
18314
+ * tile is a face/plate stand-in, a raster crop, or an icon.
18315
+ *
18316
+ * **Absent ≠ "missed silently"**: a row written before the column, a hub
18317
+ * that predates the field, and every track whose tile landed native all
18318
+ * omit it. Render nothing when absent.
18319
+ */
18320
+ previewMissReason: string$2().optional(),
18140
18321
  ...TrackFlagFields,
18141
18322
  ...TrackRetrainFields
18142
18323
  });
@@ -27615,10 +27796,10 @@ DeviceType.Camera, DeviceType.Sensor, DeviceType.Switch, method(object({ deviceI
27615
27796
  * recording config. NOTE on events (source of truth, R5/C3): this cap carries
27616
27797
  * NO event surface — `getPlaybackManifest` returns playlist URLs only. Timeline
27617
27798
  * events (motion/object/audio) come from `pipelineAnalytics` (durable SQLite
27618
- * rows); the recorder's internal EventMap markers are ephemeral in-RAM
27619
- * annotations that are not exposed here and must not be treated as an event
27620
- * feed. Event<->footage joins are by time, padded with the shared `EVENT_PAD_MS`
27621
- * (`interfaces/recording-config.ts`).
27799
+ * rows) and are the ONLY event surface the recorder has none. The in-RAM
27800
+ * playback markers it used to build were deleted on 2026-08-29 because nothing
27801
+ * ever read them. Event<->footage joins are by time, padded with the shared
27802
+ * `EVENT_PAD_MS` (`interfaces/recording-config.ts`).
27622
27803
  */
27623
27804
  var RecordingStatusSchema = object({
27624
27805
  deviceId: number(),
@@ -29329,6 +29510,13 @@ var LoggingSettingsPatchSchema = object({
29329
29510
  * anyone but its owner.
29330
29511
  */
29331
29512
  var ReportedLoadContributionSchema = LoadContributionSchema.extend({ addonId: string$2() });
29513
+ /**
29514
+ * One per-camera failure counter, plus WHO reported it.
29515
+ *
29516
+ * Same rule as {@link ReportedLoadContributionSchema}: `addonId` is stamped by
29517
+ * the hub as it enumerates providers, never by the contributor.
29518
+ */
29519
+ var ReportedFailureContributionSchema = FailureContributionSchema.extend({ addonId: string$2() });
29332
29520
  var GetLoggingSettingsInputSchema = object({
29333
29521
  scopeNodeId: string$2().optional(),
29334
29522
  /**
@@ -29387,7 +29575,7 @@ method(_void(), FeatureManifestSchema), method(_void(), HealthStatusSchema), met
29387
29575
  }), method(_void(), SiteLocationStatusSchema, {
29388
29576
  kind: "mutation",
29389
29577
  auth: "admin"
29390
- }), method(_void(), RequestCensusStatusSchema, { auth: "admin" }), method(_void(), array(ReportedLoadContributionSchema).readonly(), { auth: "admin" }), method(GetLoggingSettingsInputSchema, LoggingSettingsStateSchema, { auth: "admin" }), method(SetLoggingSettingsInputSchema, LoggingSettingsStateSchema, {
29578
+ }), 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, {
29391
29579
  kind: "mutation",
29392
29580
  auth: "admin"
29393
29581
  });
@@ -33377,6 +33565,12 @@ Object.freeze({
33377
33565
  addonId: null,
33378
33566
  access: "create"
33379
33567
  },
33568
+ "failureContribution.list": {
33569
+ capName: "failure-contribution",
33570
+ capScope: "system",
33571
+ addonId: null,
33572
+ access: "view"
33573
+ },
33380
33574
  "fanControl.setDirection": {
33381
33575
  capName: "fan-control",
33382
33576
  capScope: "device",
@@ -36683,6 +36877,12 @@ Object.freeze({
36683
36877
  addonId: null,
36684
36878
  access: "create"
36685
36879
  },
36880
+ "system.getFailureContributions": {
36881
+ capName: "system",
36882
+ capScope: "system",
36883
+ addonId: null,
36884
+ access: "view"
36885
+ },
36686
36886
  "system.getLoadContributions": {
36687
36887
  capName: "system",
36688
36888
  capScope: "system",
package/dist/addon.mjs CHANGED
@@ -13545,6 +13545,114 @@ method(LogEntrySchema, _void(), { kind: "mutation" }), method(object({
13545
13545
  limit: number().optional(),
13546
13546
  tags: record(string$2(), string$2()).optional()
13547
13547
  }), array(LogEntrySchema).readonly());
13548
+ /**
13549
+ * `failure-contribution` — the capability an addon reports its OWN losses
13550
+ * through, per camera, with the denominator attached. It stores nothing.
13551
+ *
13552
+ * ## The twin of `load-contribution`, and why it is a twin and not a field
13553
+ *
13554
+ * `load-contribution` answers *what did this camera COST*. This answers *what
13555
+ * did this camera LOSE*. The reporting discipline is identical and deliberately
13556
+ * copied: the contributor reports what it already knows, hub-main adds only
13557
+ * `addonId`, nothing needs global knowledge, and there is no central list for
13558
+ * somebody to forget to edit.
13559
+ *
13560
+ * They are not merged, because their invariants are opposites:
13561
+ *
13562
+ * - a `load-contribution` measurement is **absent, never zero** — a zero would
13563
+ * claim a camera cost nothing, which is a measurement nobody made;
13564
+ * - a `failure-contribution` zero is the **most valuable value on the
13565
+ * surface** — `attempts: 400, succeeded: 400` is the proof a fix landed,
13566
+ * and it is exactly what an absent entry cannot say.
13567
+ *
13568
+ * Putting a loss counter on a cost entry would also break the reconciliation
13569
+ * that gives `load-contribution` its point: contributions are subtracted from
13570
+ * `metrics.node-processes-snapshot` to find processes nobody claims. A failure
13571
+ * has no process.
13572
+ *
13573
+ * ## Why not a log line, since the counters already exist
13574
+ *
13575
+ * Several of these paths already counted themselves — `CaptureScheduler`'s
13576
+ * per-device window, `KeyFrameCaptureLog`, `bumpCropMetric`. Every one of them
13577
+ * ends in a log line, and a log line is the thing the operator asked to stop
13578
+ * needing: *"possiamo armare questi errori intanto? Così al prossimo giro
13579
+ * ricontrolliamo tutti questi punti"*. Reading them meant grepping Loki and
13580
+ * hand-correlating timestamps, which is how a 22% thumbnail gap and a 3-hour
13581
+ * media blackout were both diagnosed. The counters stay; this is where they can
13582
+ * be READ.
13583
+ *
13584
+ * ## The rate is served with its denominator or not at all
13585
+ *
13586
+ * Every entry carries `attempts` and `succeeded`. A miss count alone is
13587
+ * unreadable: on 2026-08-28 the enrichment-crop miss count read as "35x worse
13588
+ * than yesterday" and was **flat across twelve hours** once divided by the
13589
+ * successes on the same path. A surface that publishes only the numerator
13590
+ * reproduces that mistake on every read.
13591
+ *
13592
+ * ## Shape
13593
+ *
13594
+ * Copied from `load-contribution.cap.ts` (`mode: 'collection'`,
13595
+ * `internal: true`, `mount: { kind: 'skip' }`): no tRPC route of its own and no
13596
+ * generated hooks, while `addons.listCapabilityProviders` still enumerates it
13597
+ * and the hub's `CapabilityRegistry` still holds an RPC proxy per provider — so
13598
+ * a forked runner's entries reach hub-main over transport that already exists.
13599
+ * No new UDS message, no second registry (D3). The operator reads the assembled
13600
+ * result through `system.getFailureContributions`.
13601
+ */
13602
+ var FailureReasonCountSchema = object({
13603
+ /**
13604
+ * Why the attempt did not land, in the contributor's own vocabulary —
13605
+ * `worker-lease-gone`, `queue-overflow`, `timeout`, `empty-read`. The same
13606
+ * strings that already appear in this repo's logs and, where one exists, the
13607
+ * same string the per-track `previewMissReason` records (D276): a second
13608
+ * vocabulary for the same loss would make the row and the counter
13609
+ * un-joinable.
13610
+ */
13611
+ reason: string$2(),
13612
+ count: number().int().nonnegative()
13613
+ });
13614
+ var FailureContributionSchema = object({
13615
+ /**
13616
+ * The failing path — `enrichment-crop`, `inference`, `plate-ocr`,
13617
+ * `person-over-vehicle`. Free text, for the reason `load-contribution` keeps
13618
+ * `unit` free: the families are owned by different addons and a shared enum
13619
+ * is a central list that rots invisibly.
13620
+ */
13621
+ family: string$2(),
13622
+ /**
13623
+ * The NUMERIC device id — the same value every log line carries as
13624
+ * `tags.deviceId`. Never nullable and never absent: a contributor that
13625
+ * cannot name the camera must not emit the entry, because a fleet total
13626
+ * cannot answer the only question anybody asks of this surface.
13627
+ */
13628
+ deviceId: number().int().positive(),
13629
+ /**
13630
+ * A second dimension inside the family: the model / step id for an inference
13631
+ * timeout, so "which camera AND which model" is one read. Absent when the
13632
+ * family has a single variant.
13633
+ */
13634
+ variant: string$2().optional(),
13635
+ /**
13636
+ * Epoch ms this counter started — the INCARNATION MARKER. A consumer
13637
+ * differencing two reads must drop the interval when it changes, because the
13638
+ * counter restarted from zero in a respawned runner. Same discipline as
13639
+ * `LoadContribution.startedAtMs`.
13640
+ */
13641
+ sinceMs: number(),
13642
+ /** Epoch ms it was read. `atMs - sinceMs` is the interval this covers. */
13643
+ atMs: number(),
13644
+ /**
13645
+ * THE DENOMINATOR — every attempt on this path for this camera in the
13646
+ * window. A failure count published without it is the mistake this schema
13647
+ * exists to make impossible.
13648
+ */
13649
+ attempts: number().int().nonnegative(),
13650
+ /** Attempts that landed. `attempts - succeeded` is the loss. */
13651
+ succeeded: number().int().nonnegative(),
13652
+ /** The loss, partitioned. Sums to `attempts - succeeded`. */
13653
+ reasons: array(FailureReasonCountSchema).readonly()
13654
+ });
13655
+ method(_void(), array(FailureContributionSchema).readonly());
13548
13656
  var LoadContributionSchema = object({
13549
13657
  role: _enum([
13550
13658
  "decode",
@@ -13852,6 +13960,50 @@ var NodeProcessSchema = object({
13852
13960
  /** Wall-clock uptime (seconds). Parsed from `ps etime`. */
13853
13961
  uptimeSec: number()
13854
13962
  });
13963
+ /**
13964
+ * One retained container-memory reading.
13965
+ *
13966
+ * `atMs` is the timestamp of the PROCESS snapshot taken in the same tick, not
13967
+ * a second clock: that is what makes "processes sum to X, container says Y"
13968
+ * subtractable per point rather than an eyeballed comparison of two series
13969
+ * sampled at different instants.
13970
+ *
13971
+ * A reduced window keeps the sample with the LARGEST `currentBytes` in each
13972
+ * bucket, WHOLE. Taking a per-field maximum would synthesise a row whose parts
13973
+ * never coexisted, and a mean would smear away the peak this exists to find.
13974
+ */
13975
+ var ContainerMemoryPointSchema = object({
13976
+ /** Which hierarchy answered, so a reading is never ambiguous. */
13977
+ source: _enum(["cgroup-v2", "cgroup-v1"]),
13978
+ /** `memory.current` (v2) / `memory.usage_in_bytes` (v1). Always known. */
13979
+ currentBytes: number(),
13980
+ /** The cgroup's ceiling. `null` = NO LIMIT — never a sentinel, never zero. */
13981
+ limitBytes: number().nullable(),
13982
+ /** Anonymous pages: the closest thing to "what the processes allocated". */
13983
+ anonBytes: number().nullable(),
13984
+ /** Page cache. Charged to the cgroup, owned by no process. */
13985
+ fileBytes: number().nullable(),
13986
+ /**
13987
+ * Shared memory — and the field that explained the largest single surprise.
13988
+ * The i915 driver backs GPU buffers with shmem, so an inference pool or a
13989
+ * hardware-decode session holding DRM objects is charged HERE and appears
13990
+ * nowhere in a `ps` scan.
13991
+ */
13992
+ shmemBytes: number().nullable(),
13993
+ /** Kernel slab charged to this cgroup. `null` on v1, which never publishes it. */
13994
+ slabBytes: number().nullable(),
13995
+ /**
13996
+ * Shrinkable i915 GEM object bytes, from debugfs.
13997
+ *
13998
+ * **Host-wide across every DRM client, NOT cgroup-scoped.** It is not a
13999
+ * component of `currentBytes` and must not be subtracted from it; it says
14000
+ * what put the shmem there, where `shmemBytes` only says how much.
14001
+ *
14002
+ * `null` wherever debugfs is not mounted — which is inside every camstack
14003
+ * container today — and on any node with no Intel GPU.
14004
+ */
14005
+ gpuShmemBytes: number().nullable()
14006
+ }).extend({ atMs: number() });
13855
14007
  var DumpHeapSnapshotInputSchema = object({
13856
14008
  /** The addon whose runner should dump a heap snapshot. */
13857
14009
  addonId: string$2() });
@@ -13915,6 +14067,21 @@ var NodeLoadSeriesSchema = object({
13915
14067
  /** One entry per function seen in the window, heaviest-first. */
13916
14068
  series: array(LoadFunctionSeriesSchema).readonly(),
13917
14069
  /**
14070
+ * The CONTAINER's memory over the same window, oldest-first.
14071
+ *
14072
+ * Sits next to `series` rather than in a method of its own because the whole
14073
+ * question is a subtraction: the per-process rows in `series` sum to one
14074
+ * number and this one is another, and an operator who has to issue two calls
14075
+ * to compare them will compare two different instants. Same reader, same
14076
+ * `sinceMs`, same `bucketMs`, same timestamps.
14077
+ *
14078
+ * **EMPTY means ABSENT, never zero.** A node with no cgroup — a developer
14079
+ * Mac, a bare-metal host, a container with the hierarchy hidden — reports no
14080
+ * points at all. A zero here would be indistinguishable from a healthy
14081
+ * container and is precisely the lie this field exists to avoid.
14082
+ */
14083
+ containerMemory: array(ContainerMemoryPointSchema).readonly(),
14084
+ /**
13918
14085
  * Width of one returned bucket, in ms. Equals the sampling cadence when no
13919
14086
  * reduction was needed — so a caller can always say what one point covers
13920
14087
  * without having to know whether it was reduced.
@@ -18135,6 +18302,20 @@ var TrackSchema = object({
18135
18302
  * `=== true` and render nothing otherwise — never infer "no rider".
18136
18303
  */
18137
18304
  hasRider: boolean().optional(),
18305
+ /**
18306
+ * WHY this track ended without a NATIVE best-shot tile
18307
+ * ([D276](../decisions/adr-0276-a-stand-in-tile-is-provisional-and-a-close-says-why.md)) —
18308
+ * a composed token line (`no-key-frame capture=keyframe:native-missx4`,
18309
+ * `derive-returned-null tile=standin`, …) written at close and CLEARED by
18310
+ * the late-keyFrame upgrade when a native tile lands after all. The
18311
+ * operator-facing answer to "perché manca l'immagine?" on a track whose
18312
+ * tile is a face/plate stand-in, a raster crop, or an icon.
18313
+ *
18314
+ * **Absent ≠ "missed silently"**: a row written before the column, a hub
18315
+ * that predates the field, and every track whose tile landed native all
18316
+ * omit it. Render nothing when absent.
18317
+ */
18318
+ previewMissReason: string$2().optional(),
18138
18319
  ...TrackFlagFields,
18139
18320
  ...TrackRetrainFields
18140
18321
  });
@@ -27613,10 +27794,10 @@ DeviceType.Camera, DeviceType.Sensor, DeviceType.Switch, method(object({ deviceI
27613
27794
  * recording config. NOTE on events (source of truth, R5/C3): this cap carries
27614
27795
  * NO event surface — `getPlaybackManifest` returns playlist URLs only. Timeline
27615
27796
  * events (motion/object/audio) come from `pipelineAnalytics` (durable SQLite
27616
- * rows); the recorder's internal EventMap markers are ephemeral in-RAM
27617
- * annotations that are not exposed here and must not be treated as an event
27618
- * feed. Event<->footage joins are by time, padded with the shared `EVENT_PAD_MS`
27619
- * (`interfaces/recording-config.ts`).
27797
+ * rows) and are the ONLY event surface the recorder has none. The in-RAM
27798
+ * playback markers it used to build were deleted on 2026-08-29 because nothing
27799
+ * ever read them. Event<->footage joins are by time, padded with the shared
27800
+ * `EVENT_PAD_MS` (`interfaces/recording-config.ts`).
27620
27801
  */
27621
27802
  var RecordingStatusSchema = object({
27622
27803
  deviceId: number(),
@@ -29327,6 +29508,13 @@ var LoggingSettingsPatchSchema = object({
29327
29508
  * anyone but its owner.
29328
29509
  */
29329
29510
  var ReportedLoadContributionSchema = LoadContributionSchema.extend({ addonId: string$2() });
29511
+ /**
29512
+ * One per-camera failure counter, plus WHO reported it.
29513
+ *
29514
+ * Same rule as {@link ReportedLoadContributionSchema}: `addonId` is stamped by
29515
+ * the hub as it enumerates providers, never by the contributor.
29516
+ */
29517
+ var ReportedFailureContributionSchema = FailureContributionSchema.extend({ addonId: string$2() });
29330
29518
  var GetLoggingSettingsInputSchema = object({
29331
29519
  scopeNodeId: string$2().optional(),
29332
29520
  /**
@@ -29385,7 +29573,7 @@ method(_void(), FeatureManifestSchema), method(_void(), HealthStatusSchema), met
29385
29573
  }), method(_void(), SiteLocationStatusSchema, {
29386
29574
  kind: "mutation",
29387
29575
  auth: "admin"
29388
- }), method(_void(), RequestCensusStatusSchema, { auth: "admin" }), method(_void(), array(ReportedLoadContributionSchema).readonly(), { auth: "admin" }), method(GetLoggingSettingsInputSchema, LoggingSettingsStateSchema, { auth: "admin" }), method(SetLoggingSettingsInputSchema, LoggingSettingsStateSchema, {
29576
+ }), 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, {
29389
29577
  kind: "mutation",
29390
29578
  auth: "admin"
29391
29579
  });
@@ -33375,6 +33563,12 @@ Object.freeze({
33375
33563
  addonId: null,
33376
33564
  access: "create"
33377
33565
  },
33566
+ "failureContribution.list": {
33567
+ capName: "failure-contribution",
33568
+ capScope: "system",
33569
+ addonId: null,
33570
+ access: "view"
33571
+ },
33378
33572
  "fanControl.setDirection": {
33379
33573
  capName: "fan-control",
33380
33574
  capScope: "device",
@@ -36681,6 +36875,12 @@ Object.freeze({
36681
36875
  addonId: null,
36682
36876
  access: "create"
36683
36877
  },
36878
+ "system.getFailureContributions": {
36879
+ capName: "system",
36880
+ capScope: "system",
36881
+ addonId: null,
36882
+ access: "view"
36883
+ },
36684
36884
  "system.getLoadContributions": {
36685
36885
  capName: "system",
36686
36886
  capScope: "system",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@camstack/addon-matter-broker",
3
- "version": "0.2.37",
3
+ "version": "0.2.40",
4
4
  "description": "Matter broker addon for CamStack — owns a Matter fabric (commissioning + the long-lived controller) via the matter.js controller and brokers commissioned Matter nodes into CamStack",
5
5
  "keywords": [
6
6
  "camstack",