@camstack/addon-provider-dreo 0.2.39 → 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
@@ -13935,6 +13935,50 @@ var NodeProcessSchema = object({
13935
13935
  /** Wall-clock uptime (seconds). Parsed from `ps etime`. */
13936
13936
  uptimeSec: number()
13937
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() });
13938
13982
  var DumpHeapSnapshotInputSchema = object({
13939
13983
  /** The addon whose runner should dump a heap snapshot. */
13940
13984
  addonId: string() });
@@ -13998,6 +14042,21 @@ var NodeLoadSeriesSchema = object({
13998
14042
  /** One entry per function seen in the window, heaviest-first. */
13999
14043
  series: array(LoadFunctionSeriesSchema).readonly(),
14000
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
+ /**
14001
14060
  * Width of one returned bucket, in ms. Equals the sampling cadence when no
14002
14061
  * reduction was needed — so a caller can always say what one point covers
14003
14062
  * without having to know whether it was reduced.
@@ -27701,10 +27760,10 @@ DeviceType.Camera, DeviceType.Sensor, DeviceType.Switch, method(object({ deviceI
27701
27760
  * recording config. NOTE on events (source of truth, R5/C3): this cap carries
27702
27761
  * NO event surface — `getPlaybackManifest` returns playlist URLs only. Timeline
27703
27762
  * events (motion/object/audio) come from `pipelineAnalytics` (durable SQLite
27704
- * rows); the recorder's internal EventMap markers are ephemeral in-RAM
27705
- * annotations that are not exposed here and must not be treated as an event
27706
- * feed. Event<->footage joins are by time, padded with the shared `EVENT_PAD_MS`
27707
- * (`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`).
27708
27767
  */
27709
27768
  var RecordingStatusSchema = object({
27710
27769
  deviceId: number(),
package/dist/addon.mjs CHANGED
@@ -13936,6 +13936,50 @@ var NodeProcessSchema = object({
13936
13936
  /** Wall-clock uptime (seconds). Parsed from `ps etime`. */
13937
13937
  uptimeSec: number()
13938
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() });
13939
13983
  var DumpHeapSnapshotInputSchema = object({
13940
13984
  /** The addon whose runner should dump a heap snapshot. */
13941
13985
  addonId: string() });
@@ -13999,6 +14043,21 @@ var NodeLoadSeriesSchema = object({
13999
14043
  /** One entry per function seen in the window, heaviest-first. */
14000
14044
  series: array(LoadFunctionSeriesSchema).readonly(),
14001
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
+ /**
14002
14061
  * Width of one returned bucket, in ms. Equals the sampling cadence when no
14003
14062
  * reduction was needed — so a caller can always say what one point covers
14004
14063
  * without having to know whether it was reduced.
@@ -27702,10 +27761,10 @@ DeviceType.Camera, DeviceType.Sensor, DeviceType.Switch, method(object({ deviceI
27702
27761
  * recording config. NOTE on events (source of truth, R5/C3): this cap carries
27703
27762
  * NO event surface — `getPlaybackManifest` returns playlist URLs only. Timeline
27704
27763
  * events (motion/object/audio) come from `pipelineAnalytics` (durable SQLite
27705
- * rows); the recorder's internal EventMap markers are ephemeral in-RAM
27706
- * annotations that are not exposed here and must not be treated as an event
27707
- * feed. Event<->footage joins are by time, padded with the shared `EVENT_PAD_MS`
27708
- * (`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`).
27709
27768
  */
27710
27769
  var RecordingStatusSchema = object({
27711
27770
  deviceId: number(),
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@camstack/addon-provider-dreo",
3
- "version": "0.2.39",
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",