@camstack/addon-provider-homematic 1.2.39 → 1.2.42

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
@@ -13542,6 +13542,114 @@ method(LogEntrySchema, _void(), { kind: "mutation" }), method(object({
13542
13542
  limit: number().optional(),
13543
13543
  tags: record(string(), string()).optional()
13544
13544
  }), array(LogEntrySchema).readonly());
13545
+ /**
13546
+ * `failure-contribution` — the capability an addon reports its OWN losses
13547
+ * through, per camera, with the denominator attached. It stores nothing.
13548
+ *
13549
+ * ## The twin of `load-contribution`, and why it is a twin and not a field
13550
+ *
13551
+ * `load-contribution` answers *what did this camera COST*. This answers *what
13552
+ * did this camera LOSE*. The reporting discipline is identical and deliberately
13553
+ * copied: the contributor reports what it already knows, hub-main adds only
13554
+ * `addonId`, nothing needs global knowledge, and there is no central list for
13555
+ * somebody to forget to edit.
13556
+ *
13557
+ * They are not merged, because their invariants are opposites:
13558
+ *
13559
+ * - a `load-contribution` measurement is **absent, never zero** — a zero would
13560
+ * claim a camera cost nothing, which is a measurement nobody made;
13561
+ * - a `failure-contribution` zero is the **most valuable value on the
13562
+ * surface** — `attempts: 400, succeeded: 400` is the proof a fix landed,
13563
+ * and it is exactly what an absent entry cannot say.
13564
+ *
13565
+ * Putting a loss counter on a cost entry would also break the reconciliation
13566
+ * that gives `load-contribution` its point: contributions are subtracted from
13567
+ * `metrics.node-processes-snapshot` to find processes nobody claims. A failure
13568
+ * has no process.
13569
+ *
13570
+ * ## Why not a log line, since the counters already exist
13571
+ *
13572
+ * Several of these paths already counted themselves — `CaptureScheduler`'s
13573
+ * per-device window, `KeyFrameCaptureLog`, `bumpCropMetric`. Every one of them
13574
+ * ends in a log line, and a log line is the thing the operator asked to stop
13575
+ * needing: *"possiamo armare questi errori intanto? Così al prossimo giro
13576
+ * ricontrolliamo tutti questi punti"*. Reading them meant grepping Loki and
13577
+ * hand-correlating timestamps, which is how a 22% thumbnail gap and a 3-hour
13578
+ * media blackout were both diagnosed. The counters stay; this is where they can
13579
+ * be READ.
13580
+ *
13581
+ * ## The rate is served with its denominator or not at all
13582
+ *
13583
+ * Every entry carries `attempts` and `succeeded`. A miss count alone is
13584
+ * unreadable: on 2026-08-28 the enrichment-crop miss count read as "35x worse
13585
+ * than yesterday" and was **flat across twelve hours** once divided by the
13586
+ * successes on the same path. A surface that publishes only the numerator
13587
+ * reproduces that mistake on every read.
13588
+ *
13589
+ * ## Shape
13590
+ *
13591
+ * Copied from `load-contribution.cap.ts` (`mode: 'collection'`,
13592
+ * `internal: true`, `mount: { kind: 'skip' }`): no tRPC route of its own and no
13593
+ * generated hooks, while `addons.listCapabilityProviders` still enumerates it
13594
+ * and the hub's `CapabilityRegistry` still holds an RPC proxy per provider — so
13595
+ * a forked runner's entries reach hub-main over transport that already exists.
13596
+ * No new UDS message, no second registry (D3). The operator reads the assembled
13597
+ * result through `system.getFailureContributions`.
13598
+ */
13599
+ var FailureReasonCountSchema = object({
13600
+ /**
13601
+ * Why the attempt did not land, in the contributor's own vocabulary —
13602
+ * `worker-lease-gone`, `queue-overflow`, `timeout`, `empty-read`. The same
13603
+ * strings that already appear in this repo's logs and, where one exists, the
13604
+ * same string the per-track `previewMissReason` records (D276): a second
13605
+ * vocabulary for the same loss would make the row and the counter
13606
+ * un-joinable.
13607
+ */
13608
+ reason: string(),
13609
+ count: number().int().nonnegative()
13610
+ });
13611
+ var FailureContributionSchema = object({
13612
+ /**
13613
+ * The failing path — `enrichment-crop`, `inference`, `plate-ocr`,
13614
+ * `person-over-vehicle`. Free text, for the reason `load-contribution` keeps
13615
+ * `unit` free: the families are owned by different addons and a shared enum
13616
+ * is a central list that rots invisibly.
13617
+ */
13618
+ family: string(),
13619
+ /**
13620
+ * The NUMERIC device id — the same value every log line carries as
13621
+ * `tags.deviceId`. Never nullable and never absent: a contributor that
13622
+ * cannot name the camera must not emit the entry, because a fleet total
13623
+ * cannot answer the only question anybody asks of this surface.
13624
+ */
13625
+ deviceId: number().int().positive(),
13626
+ /**
13627
+ * A second dimension inside the family: the model / step id for an inference
13628
+ * timeout, so "which camera AND which model" is one read. Absent when the
13629
+ * family has a single variant.
13630
+ */
13631
+ variant: string().optional(),
13632
+ /**
13633
+ * Epoch ms this counter started — the INCARNATION MARKER. A consumer
13634
+ * differencing two reads must drop the interval when it changes, because the
13635
+ * counter restarted from zero in a respawned runner. Same discipline as
13636
+ * `LoadContribution.startedAtMs`.
13637
+ */
13638
+ sinceMs: number(),
13639
+ /** Epoch ms it was read. `atMs - sinceMs` is the interval this covers. */
13640
+ atMs: number(),
13641
+ /**
13642
+ * THE DENOMINATOR — every attempt on this path for this camera in the
13643
+ * window. A failure count published without it is the mistake this schema
13644
+ * exists to make impossible.
13645
+ */
13646
+ attempts: number().int().nonnegative(),
13647
+ /** Attempts that landed. `attempts - succeeded` is the loss. */
13648
+ succeeded: number().int().nonnegative(),
13649
+ /** The loss, partitioned. Sums to `attempts - succeeded`. */
13650
+ reasons: array(FailureReasonCountSchema).readonly()
13651
+ });
13652
+ method(_void(), array(FailureContributionSchema).readonly());
13545
13653
  var LoadContributionSchema = object({
13546
13654
  role: _enum([
13547
13655
  "decode",
@@ -13849,6 +13957,50 @@ var NodeProcessSchema = object({
13849
13957
  /** Wall-clock uptime (seconds). Parsed from `ps etime`. */
13850
13958
  uptimeSec: number()
13851
13959
  });
13960
+ /**
13961
+ * One retained container-memory reading.
13962
+ *
13963
+ * `atMs` is the timestamp of the PROCESS snapshot taken in the same tick, not
13964
+ * a second clock: that is what makes "processes sum to X, container says Y"
13965
+ * subtractable per point rather than an eyeballed comparison of two series
13966
+ * sampled at different instants.
13967
+ *
13968
+ * A reduced window keeps the sample with the LARGEST `currentBytes` in each
13969
+ * bucket, WHOLE. Taking a per-field maximum would synthesise a row whose parts
13970
+ * never coexisted, and a mean would smear away the peak this exists to find.
13971
+ */
13972
+ var ContainerMemoryPointSchema = object({
13973
+ /** Which hierarchy answered, so a reading is never ambiguous. */
13974
+ source: _enum(["cgroup-v2", "cgroup-v1"]),
13975
+ /** `memory.current` (v2) / `memory.usage_in_bytes` (v1). Always known. */
13976
+ currentBytes: number(),
13977
+ /** The cgroup's ceiling. `null` = NO LIMIT — never a sentinel, never zero. */
13978
+ limitBytes: number().nullable(),
13979
+ /** Anonymous pages: the closest thing to "what the processes allocated". */
13980
+ anonBytes: number().nullable(),
13981
+ /** Page cache. Charged to the cgroup, owned by no process. */
13982
+ fileBytes: number().nullable(),
13983
+ /**
13984
+ * Shared memory — and the field that explained the largest single surprise.
13985
+ * The i915 driver backs GPU buffers with shmem, so an inference pool or a
13986
+ * hardware-decode session holding DRM objects is charged HERE and appears
13987
+ * nowhere in a `ps` scan.
13988
+ */
13989
+ shmemBytes: number().nullable(),
13990
+ /** Kernel slab charged to this cgroup. `null` on v1, which never publishes it. */
13991
+ slabBytes: number().nullable(),
13992
+ /**
13993
+ * Shrinkable i915 GEM object bytes, from debugfs.
13994
+ *
13995
+ * **Host-wide across every DRM client, NOT cgroup-scoped.** It is not a
13996
+ * component of `currentBytes` and must not be subtracted from it; it says
13997
+ * what put the shmem there, where `shmemBytes` only says how much.
13998
+ *
13999
+ * `null` wherever debugfs is not mounted — which is inside every camstack
14000
+ * container today — and on any node with no Intel GPU.
14001
+ */
14002
+ gpuShmemBytes: number().nullable()
14003
+ }).extend({ atMs: number() });
13852
14004
  var DumpHeapSnapshotInputSchema = object({
13853
14005
  /** The addon whose runner should dump a heap snapshot. */
13854
14006
  addonId: string() });
@@ -13912,6 +14064,21 @@ var NodeLoadSeriesSchema = object({
13912
14064
  /** One entry per function seen in the window, heaviest-first. */
13913
14065
  series: array(LoadFunctionSeriesSchema).readonly(),
13914
14066
  /**
14067
+ * The CONTAINER's memory over the same window, oldest-first.
14068
+ *
14069
+ * Sits next to `series` rather than in a method of its own because the whole
14070
+ * question is a subtraction: the per-process rows in `series` sum to one
14071
+ * number and this one is another, and an operator who has to issue two calls
14072
+ * to compare them will compare two different instants. Same reader, same
14073
+ * `sinceMs`, same `bucketMs`, same timestamps.
14074
+ *
14075
+ * **EMPTY means ABSENT, never zero.** A node with no cgroup — a developer
14076
+ * Mac, a bare-metal host, a container with the hierarchy hidden — reports no
14077
+ * points at all. A zero here would be indistinguishable from a healthy
14078
+ * container and is precisely the lie this field exists to avoid.
14079
+ */
14080
+ containerMemory: array(ContainerMemoryPointSchema).readonly(),
14081
+ /**
13915
14082
  * Width of one returned bucket, in ms. Equals the sampling cadence when no
13916
14083
  * reduction was needed — so a caller can always say what one point covers
13917
14084
  * without having to know whether it was reduced.
@@ -18132,6 +18299,20 @@ var TrackSchema = object({
18132
18299
  * `=== true` and render nothing otherwise — never infer "no rider".
18133
18300
  */
18134
18301
  hasRider: boolean().optional(),
18302
+ /**
18303
+ * WHY this track ended without a NATIVE best-shot tile
18304
+ * ([D276](../decisions/adr-0276-a-stand-in-tile-is-provisional-and-a-close-says-why.md)) —
18305
+ * a composed token line (`no-key-frame capture=keyframe:native-missx4`,
18306
+ * `derive-returned-null tile=standin`, …) written at close and CLEARED by
18307
+ * the late-keyFrame upgrade when a native tile lands after all. The
18308
+ * operator-facing answer to "perché manca l'immagine?" on a track whose
18309
+ * tile is a face/plate stand-in, a raster crop, or an icon.
18310
+ *
18311
+ * **Absent ≠ "missed silently"**: a row written before the column, a hub
18312
+ * that predates the field, and every track whose tile landed native all
18313
+ * omit it. Render nothing when absent.
18314
+ */
18315
+ previewMissReason: string().optional(),
18135
18316
  ...TrackFlagFields,
18136
18317
  ...TrackRetrainFields
18137
18318
  });
@@ -27593,10 +27774,10 @@ DeviceType.Camera, DeviceType.Sensor, DeviceType.Switch, method(object({ deviceI
27593
27774
  * recording config. NOTE on events (source of truth, R5/C3): this cap carries
27594
27775
  * NO event surface — `getPlaybackManifest` returns playlist URLs only. Timeline
27595
27776
  * events (motion/object/audio) come from `pipelineAnalytics` (durable SQLite
27596
- * rows); the recorder's internal EventMap markers are ephemeral in-RAM
27597
- * annotations that are not exposed here and must not be treated as an event
27598
- * feed. Event<->footage joins are by time, padded with the shared `EVENT_PAD_MS`
27599
- * (`interfaces/recording-config.ts`).
27777
+ * rows) and are the ONLY event surface — the recorder has none. The in-RAM
27778
+ * playback markers it used to build were deleted on 2026-08-29 because nothing
27779
+ * ever read them. Event<->footage joins are by time, padded with the shared
27780
+ * `EVENT_PAD_MS` (`interfaces/recording-config.ts`).
27600
27781
  */
27601
27782
  var RecordingStatusSchema = object({
27602
27783
  deviceId: number(),
@@ -29307,6 +29488,13 @@ var LoggingSettingsPatchSchema = object({
29307
29488
  * anyone but its owner.
29308
29489
  */
29309
29490
  var ReportedLoadContributionSchema = LoadContributionSchema.extend({ addonId: string() });
29491
+ /**
29492
+ * One per-camera failure counter, plus WHO reported it.
29493
+ *
29494
+ * Same rule as {@link ReportedLoadContributionSchema}: `addonId` is stamped by
29495
+ * the hub as it enumerates providers, never by the contributor.
29496
+ */
29497
+ var ReportedFailureContributionSchema = FailureContributionSchema.extend({ addonId: string() });
29310
29498
  var GetLoggingSettingsInputSchema = object({
29311
29499
  scopeNodeId: string().optional(),
29312
29500
  /**
@@ -29365,7 +29553,7 @@ method(_void(), FeatureManifestSchema), method(_void(), HealthStatusSchema), met
29365
29553
  }), method(_void(), SiteLocationStatusSchema, {
29366
29554
  kind: "mutation",
29367
29555
  auth: "admin"
29368
- }), method(_void(), RequestCensusStatusSchema, { auth: "admin" }), method(_void(), array(ReportedLoadContributionSchema).readonly(), { auth: "admin" }), method(GetLoggingSettingsInputSchema, LoggingSettingsStateSchema, { auth: "admin" }), method(SetLoggingSettingsInputSchema, LoggingSettingsStateSchema, {
29556
+ }), 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, {
29369
29557
  kind: "mutation",
29370
29558
  auth: "admin"
29371
29559
  });
@@ -33355,6 +33543,12 @@ Object.freeze({
33355
33543
  addonId: null,
33356
33544
  access: "create"
33357
33545
  },
33546
+ "failureContribution.list": {
33547
+ capName: "failure-contribution",
33548
+ capScope: "system",
33549
+ addonId: null,
33550
+ access: "view"
33551
+ },
33358
33552
  "fanControl.setDirection": {
33359
33553
  capName: "fan-control",
33360
33554
  capScope: "device",
@@ -36661,6 +36855,12 @@ Object.freeze({
36661
36855
  addonId: null,
36662
36856
  access: "create"
36663
36857
  },
36858
+ "system.getFailureContributions": {
36859
+ capName: "system",
36860
+ capScope: "system",
36861
+ addonId: null,
36862
+ access: "view"
36863
+ },
36664
36864
  "system.getLoadContributions": {
36665
36865
  capName: "system",
36666
36866
  capScope: "system",
package/dist/addon.mjs CHANGED
@@ -13543,6 +13543,114 @@ method(LogEntrySchema, _void(), { kind: "mutation" }), method(object({
13543
13543
  limit: number().optional(),
13544
13544
  tags: record(string(), string()).optional()
13545
13545
  }), array(LogEntrySchema).readonly());
13546
+ /**
13547
+ * `failure-contribution` — the capability an addon reports its OWN losses
13548
+ * through, per camera, with the denominator attached. It stores nothing.
13549
+ *
13550
+ * ## The twin of `load-contribution`, and why it is a twin and not a field
13551
+ *
13552
+ * `load-contribution` answers *what did this camera COST*. This answers *what
13553
+ * did this camera LOSE*. The reporting discipline is identical and deliberately
13554
+ * copied: the contributor reports what it already knows, hub-main adds only
13555
+ * `addonId`, nothing needs global knowledge, and there is no central list for
13556
+ * somebody to forget to edit.
13557
+ *
13558
+ * They are not merged, because their invariants are opposites:
13559
+ *
13560
+ * - a `load-contribution` measurement is **absent, never zero** — a zero would
13561
+ * claim a camera cost nothing, which is a measurement nobody made;
13562
+ * - a `failure-contribution` zero is the **most valuable value on the
13563
+ * surface** — `attempts: 400, succeeded: 400` is the proof a fix landed,
13564
+ * and it is exactly what an absent entry cannot say.
13565
+ *
13566
+ * Putting a loss counter on a cost entry would also break the reconciliation
13567
+ * that gives `load-contribution` its point: contributions are subtracted from
13568
+ * `metrics.node-processes-snapshot` to find processes nobody claims. A failure
13569
+ * has no process.
13570
+ *
13571
+ * ## Why not a log line, since the counters already exist
13572
+ *
13573
+ * Several of these paths already counted themselves — `CaptureScheduler`'s
13574
+ * per-device window, `KeyFrameCaptureLog`, `bumpCropMetric`. Every one of them
13575
+ * ends in a log line, and a log line is the thing the operator asked to stop
13576
+ * needing: *"possiamo armare questi errori intanto? Così al prossimo giro
13577
+ * ricontrolliamo tutti questi punti"*. Reading them meant grepping Loki and
13578
+ * hand-correlating timestamps, which is how a 22% thumbnail gap and a 3-hour
13579
+ * media blackout were both diagnosed. The counters stay; this is where they can
13580
+ * be READ.
13581
+ *
13582
+ * ## The rate is served with its denominator or not at all
13583
+ *
13584
+ * Every entry carries `attempts` and `succeeded`. A miss count alone is
13585
+ * unreadable: on 2026-08-28 the enrichment-crop miss count read as "35x worse
13586
+ * than yesterday" and was **flat across twelve hours** once divided by the
13587
+ * successes on the same path. A surface that publishes only the numerator
13588
+ * reproduces that mistake on every read.
13589
+ *
13590
+ * ## Shape
13591
+ *
13592
+ * Copied from `load-contribution.cap.ts` (`mode: 'collection'`,
13593
+ * `internal: true`, `mount: { kind: 'skip' }`): no tRPC route of its own and no
13594
+ * generated hooks, while `addons.listCapabilityProviders` still enumerates it
13595
+ * and the hub's `CapabilityRegistry` still holds an RPC proxy per provider — so
13596
+ * a forked runner's entries reach hub-main over transport that already exists.
13597
+ * No new UDS message, no second registry (D3). The operator reads the assembled
13598
+ * result through `system.getFailureContributions`.
13599
+ */
13600
+ var FailureReasonCountSchema = object({
13601
+ /**
13602
+ * Why the attempt did not land, in the contributor's own vocabulary —
13603
+ * `worker-lease-gone`, `queue-overflow`, `timeout`, `empty-read`. The same
13604
+ * strings that already appear in this repo's logs and, where one exists, the
13605
+ * same string the per-track `previewMissReason` records (D276): a second
13606
+ * vocabulary for the same loss would make the row and the counter
13607
+ * un-joinable.
13608
+ */
13609
+ reason: string(),
13610
+ count: number().int().nonnegative()
13611
+ });
13612
+ var FailureContributionSchema = object({
13613
+ /**
13614
+ * The failing path — `enrichment-crop`, `inference`, `plate-ocr`,
13615
+ * `person-over-vehicle`. Free text, for the reason `load-contribution` keeps
13616
+ * `unit` free: the families are owned by different addons and a shared enum
13617
+ * is a central list that rots invisibly.
13618
+ */
13619
+ family: string(),
13620
+ /**
13621
+ * The NUMERIC device id — the same value every log line carries as
13622
+ * `tags.deviceId`. Never nullable and never absent: a contributor that
13623
+ * cannot name the camera must not emit the entry, because a fleet total
13624
+ * cannot answer the only question anybody asks of this surface.
13625
+ */
13626
+ deviceId: number().int().positive(),
13627
+ /**
13628
+ * A second dimension inside the family: the model / step id for an inference
13629
+ * timeout, so "which camera AND which model" is one read. Absent when the
13630
+ * family has a single variant.
13631
+ */
13632
+ variant: string().optional(),
13633
+ /**
13634
+ * Epoch ms this counter started — the INCARNATION MARKER. A consumer
13635
+ * differencing two reads must drop the interval when it changes, because the
13636
+ * counter restarted from zero in a respawned runner. Same discipline as
13637
+ * `LoadContribution.startedAtMs`.
13638
+ */
13639
+ sinceMs: number(),
13640
+ /** Epoch ms it was read. `atMs - sinceMs` is the interval this covers. */
13641
+ atMs: number(),
13642
+ /**
13643
+ * THE DENOMINATOR — every attempt on this path for this camera in the
13644
+ * window. A failure count published without it is the mistake this schema
13645
+ * exists to make impossible.
13646
+ */
13647
+ attempts: number().int().nonnegative(),
13648
+ /** Attempts that landed. `attempts - succeeded` is the loss. */
13649
+ succeeded: number().int().nonnegative(),
13650
+ /** The loss, partitioned. Sums to `attempts - succeeded`. */
13651
+ reasons: array(FailureReasonCountSchema).readonly()
13652
+ });
13653
+ method(_void(), array(FailureContributionSchema).readonly());
13546
13654
  var LoadContributionSchema = object({
13547
13655
  role: _enum([
13548
13656
  "decode",
@@ -13850,6 +13958,50 @@ var NodeProcessSchema = object({
13850
13958
  /** Wall-clock uptime (seconds). Parsed from `ps etime`. */
13851
13959
  uptimeSec: number()
13852
13960
  });
13961
+ /**
13962
+ * One retained container-memory reading.
13963
+ *
13964
+ * `atMs` is the timestamp of the PROCESS snapshot taken in the same tick, not
13965
+ * a second clock: that is what makes "processes sum to X, container says Y"
13966
+ * subtractable per point rather than an eyeballed comparison of two series
13967
+ * sampled at different instants.
13968
+ *
13969
+ * A reduced window keeps the sample with the LARGEST `currentBytes` in each
13970
+ * bucket, WHOLE. Taking a per-field maximum would synthesise a row whose parts
13971
+ * never coexisted, and a mean would smear away the peak this exists to find.
13972
+ */
13973
+ var ContainerMemoryPointSchema = object({
13974
+ /** Which hierarchy answered, so a reading is never ambiguous. */
13975
+ source: _enum(["cgroup-v2", "cgroup-v1"]),
13976
+ /** `memory.current` (v2) / `memory.usage_in_bytes` (v1). Always known. */
13977
+ currentBytes: number(),
13978
+ /** The cgroup's ceiling. `null` = NO LIMIT — never a sentinel, never zero. */
13979
+ limitBytes: number().nullable(),
13980
+ /** Anonymous pages: the closest thing to "what the processes allocated". */
13981
+ anonBytes: number().nullable(),
13982
+ /** Page cache. Charged to the cgroup, owned by no process. */
13983
+ fileBytes: number().nullable(),
13984
+ /**
13985
+ * Shared memory — and the field that explained the largest single surprise.
13986
+ * The i915 driver backs GPU buffers with shmem, so an inference pool or a
13987
+ * hardware-decode session holding DRM objects is charged HERE and appears
13988
+ * nowhere in a `ps` scan.
13989
+ */
13990
+ shmemBytes: number().nullable(),
13991
+ /** Kernel slab charged to this cgroup. `null` on v1, which never publishes it. */
13992
+ slabBytes: number().nullable(),
13993
+ /**
13994
+ * Shrinkable i915 GEM object bytes, from debugfs.
13995
+ *
13996
+ * **Host-wide across every DRM client, NOT cgroup-scoped.** It is not a
13997
+ * component of `currentBytes` and must not be subtracted from it; it says
13998
+ * what put the shmem there, where `shmemBytes` only says how much.
13999
+ *
14000
+ * `null` wherever debugfs is not mounted — which is inside every camstack
14001
+ * container today — and on any node with no Intel GPU.
14002
+ */
14003
+ gpuShmemBytes: number().nullable()
14004
+ }).extend({ atMs: number() });
13853
14005
  var DumpHeapSnapshotInputSchema = object({
13854
14006
  /** The addon whose runner should dump a heap snapshot. */
13855
14007
  addonId: string() });
@@ -13913,6 +14065,21 @@ var NodeLoadSeriesSchema = object({
13913
14065
  /** One entry per function seen in the window, heaviest-first. */
13914
14066
  series: array(LoadFunctionSeriesSchema).readonly(),
13915
14067
  /**
14068
+ * The CONTAINER's memory over the same window, oldest-first.
14069
+ *
14070
+ * Sits next to `series` rather than in a method of its own because the whole
14071
+ * question is a subtraction: the per-process rows in `series` sum to one
14072
+ * number and this one is another, and an operator who has to issue two calls
14073
+ * to compare them will compare two different instants. Same reader, same
14074
+ * `sinceMs`, same `bucketMs`, same timestamps.
14075
+ *
14076
+ * **EMPTY means ABSENT, never zero.** A node with no cgroup — a developer
14077
+ * Mac, a bare-metal host, a container with the hierarchy hidden — reports no
14078
+ * points at all. A zero here would be indistinguishable from a healthy
14079
+ * container and is precisely the lie this field exists to avoid.
14080
+ */
14081
+ containerMemory: array(ContainerMemoryPointSchema).readonly(),
14082
+ /**
13916
14083
  * Width of one returned bucket, in ms. Equals the sampling cadence when no
13917
14084
  * reduction was needed — so a caller can always say what one point covers
13918
14085
  * without having to know whether it was reduced.
@@ -18133,6 +18300,20 @@ var TrackSchema = object({
18133
18300
  * `=== true` and render nothing otherwise — never infer "no rider".
18134
18301
  */
18135
18302
  hasRider: boolean().optional(),
18303
+ /**
18304
+ * WHY this track ended without a NATIVE best-shot tile
18305
+ * ([D276](../decisions/adr-0276-a-stand-in-tile-is-provisional-and-a-close-says-why.md)) —
18306
+ * a composed token line (`no-key-frame capture=keyframe:native-missx4`,
18307
+ * `derive-returned-null tile=standin`, …) written at close and CLEARED by
18308
+ * the late-keyFrame upgrade when a native tile lands after all. The
18309
+ * operator-facing answer to "perché manca l'immagine?" on a track whose
18310
+ * tile is a face/plate stand-in, a raster crop, or an icon.
18311
+ *
18312
+ * **Absent ≠ "missed silently"**: a row written before the column, a hub
18313
+ * that predates the field, and every track whose tile landed native all
18314
+ * omit it. Render nothing when absent.
18315
+ */
18316
+ previewMissReason: string().optional(),
18136
18317
  ...TrackFlagFields,
18137
18318
  ...TrackRetrainFields
18138
18319
  });
@@ -27594,10 +27775,10 @@ DeviceType.Camera, DeviceType.Sensor, DeviceType.Switch, method(object({ deviceI
27594
27775
  * recording config. NOTE on events (source of truth, R5/C3): this cap carries
27595
27776
  * NO event surface — `getPlaybackManifest` returns playlist URLs only. Timeline
27596
27777
  * events (motion/object/audio) come from `pipelineAnalytics` (durable SQLite
27597
- * rows); the recorder's internal EventMap markers are ephemeral in-RAM
27598
- * annotations that are not exposed here and must not be treated as an event
27599
- * feed. Event<->footage joins are by time, padded with the shared `EVENT_PAD_MS`
27600
- * (`interfaces/recording-config.ts`).
27778
+ * rows) and are the ONLY event surface — the recorder has none. The in-RAM
27779
+ * playback markers it used to build were deleted on 2026-08-29 because nothing
27780
+ * ever read them. Event<->footage joins are by time, padded with the shared
27781
+ * `EVENT_PAD_MS` (`interfaces/recording-config.ts`).
27601
27782
  */
27602
27783
  var RecordingStatusSchema = object({
27603
27784
  deviceId: number(),
@@ -29308,6 +29489,13 @@ var LoggingSettingsPatchSchema = object({
29308
29489
  * anyone but its owner.
29309
29490
  */
29310
29491
  var ReportedLoadContributionSchema = LoadContributionSchema.extend({ addonId: string() });
29492
+ /**
29493
+ * One per-camera failure counter, plus WHO reported it.
29494
+ *
29495
+ * Same rule as {@link ReportedLoadContributionSchema}: `addonId` is stamped by
29496
+ * the hub as it enumerates providers, never by the contributor.
29497
+ */
29498
+ var ReportedFailureContributionSchema = FailureContributionSchema.extend({ addonId: string() });
29311
29499
  var GetLoggingSettingsInputSchema = object({
29312
29500
  scopeNodeId: string().optional(),
29313
29501
  /**
@@ -29366,7 +29554,7 @@ method(_void(), FeatureManifestSchema), method(_void(), HealthStatusSchema), met
29366
29554
  }), method(_void(), SiteLocationStatusSchema, {
29367
29555
  kind: "mutation",
29368
29556
  auth: "admin"
29369
- }), method(_void(), RequestCensusStatusSchema, { auth: "admin" }), method(_void(), array(ReportedLoadContributionSchema).readonly(), { auth: "admin" }), method(GetLoggingSettingsInputSchema, LoggingSettingsStateSchema, { auth: "admin" }), method(SetLoggingSettingsInputSchema, LoggingSettingsStateSchema, {
29557
+ }), 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, {
29370
29558
  kind: "mutation",
29371
29559
  auth: "admin"
29372
29560
  });
@@ -33356,6 +33544,12 @@ Object.freeze({
33356
33544
  addonId: null,
33357
33545
  access: "create"
33358
33546
  },
33547
+ "failureContribution.list": {
33548
+ capName: "failure-contribution",
33549
+ capScope: "system",
33550
+ addonId: null,
33551
+ access: "view"
33552
+ },
33359
33553
  "fanControl.setDirection": {
33360
33554
  capName: "fan-control",
33361
33555
  capScope: "device",
@@ -36662,6 +36856,12 @@ Object.freeze({
36662
36856
  addonId: null,
36663
36857
  access: "create"
36664
36858
  },
36859
+ "system.getFailureContributions": {
36860
+ capName: "system",
36861
+ capScope: "system",
36862
+ addonId: null,
36863
+ access: "view"
36864
+ },
36665
36865
  "system.getLoadContributions": {
36666
36866
  capName: "system",
36667
36867
  capScope: "system",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@camstack/addon-provider-homematic",
3
- "version": "1.2.39",
3
+ "version": "1.2.42",
4
4
  "description": "Homematic / HomematicIP (CCU3 / RaspberryMatic) device-provider addon for CamStack — wraps the nodehomematic library",
5
5
  "keywords": [
6
6
  "camstack",