@camstack/addon-provider-homematic 1.2.40 → 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
@@ -13957,6 +13957,50 @@ var NodeProcessSchema = object({
13957
13957
  /** Wall-clock uptime (seconds). Parsed from `ps etime`. */
13958
13958
  uptimeSec: number()
13959
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() });
13960
14004
  var DumpHeapSnapshotInputSchema = object({
13961
14005
  /** The addon whose runner should dump a heap snapshot. */
13962
14006
  addonId: string() });
@@ -14020,6 +14064,21 @@ var NodeLoadSeriesSchema = object({
14020
14064
  /** One entry per function seen in the window, heaviest-first. */
14021
14065
  series: array(LoadFunctionSeriesSchema).readonly(),
14022
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
+ /**
14023
14082
  * Width of one returned bucket, in ms. Equals the sampling cadence when no
14024
14083
  * reduction was needed — so a caller can always say what one point covers
14025
14084
  * without having to know whether it was reduced.
@@ -27715,10 +27774,10 @@ DeviceType.Camera, DeviceType.Sensor, DeviceType.Switch, method(object({ deviceI
27715
27774
  * recording config. NOTE on events (source of truth, R5/C3): this cap carries
27716
27775
  * NO event surface — `getPlaybackManifest` returns playlist URLs only. Timeline
27717
27776
  * events (motion/object/audio) come from `pipelineAnalytics` (durable SQLite
27718
- * rows); the recorder's internal EventMap markers are ephemeral in-RAM
27719
- * annotations that are not exposed here and must not be treated as an event
27720
- * feed. Event<->footage joins are by time, padded with the shared `EVENT_PAD_MS`
27721
- * (`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`).
27722
27781
  */
27723
27782
  var RecordingStatusSchema = object({
27724
27783
  deviceId: number(),
package/dist/addon.mjs CHANGED
@@ -13958,6 +13958,50 @@ var NodeProcessSchema = object({
13958
13958
  /** Wall-clock uptime (seconds). Parsed from `ps etime`. */
13959
13959
  uptimeSec: number()
13960
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() });
13961
14005
  var DumpHeapSnapshotInputSchema = object({
13962
14006
  /** The addon whose runner should dump a heap snapshot. */
13963
14007
  addonId: string() });
@@ -14021,6 +14065,21 @@ var NodeLoadSeriesSchema = object({
14021
14065
  /** One entry per function seen in the window, heaviest-first. */
14022
14066
  series: array(LoadFunctionSeriesSchema).readonly(),
14023
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
+ /**
14024
14083
  * Width of one returned bucket, in ms. Equals the sampling cadence when no
14025
14084
  * reduction was needed — so a caller can always say what one point covers
14026
14085
  * without having to know whether it was reduced.
@@ -27716,10 +27775,10 @@ DeviceType.Camera, DeviceType.Sensor, DeviceType.Switch, method(object({ deviceI
27716
27775
  * recording config. NOTE on events (source of truth, R5/C3): this cap carries
27717
27776
  * NO event surface — `getPlaybackManifest` returns playlist URLs only. Timeline
27718
27777
  * events (motion/object/audio) come from `pipelineAnalytics` (durable SQLite
27719
- * rows); the recorder's internal EventMap markers are ephemeral in-RAM
27720
- * annotations that are not exposed here and must not be treated as an event
27721
- * feed. Event<->footage joins are by time, padded with the shared `EVENT_PAD_MS`
27722
- * (`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`).
27723
27782
  */
27724
27783
  var RecordingStatusSchema = object({
27725
27784
  deviceId: number(),
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@camstack/addon-provider-homematic",
3
- "version": "1.2.40",
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",