@camstack/addon-provider-gree 0.2.38 → 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
@@ -13885,6 +13885,50 @@ var NodeProcessSchema = object({
13885
13885
  /** Wall-clock uptime (seconds). Parsed from `ps etime`. */
13886
13886
  uptimeSec: number()
13887
13887
  });
13888
+ /**
13889
+ * One retained container-memory reading.
13890
+ *
13891
+ * `atMs` is the timestamp of the PROCESS snapshot taken in the same tick, not
13892
+ * a second clock: that is what makes "processes sum to X, container says Y"
13893
+ * subtractable per point rather than an eyeballed comparison of two series
13894
+ * sampled at different instants.
13895
+ *
13896
+ * A reduced window keeps the sample with the LARGEST `currentBytes` in each
13897
+ * bucket, WHOLE. Taking a per-field maximum would synthesise a row whose parts
13898
+ * never coexisted, and a mean would smear away the peak this exists to find.
13899
+ */
13900
+ var ContainerMemoryPointSchema = object({
13901
+ /** Which hierarchy answered, so a reading is never ambiguous. */
13902
+ source: _enum(["cgroup-v2", "cgroup-v1"]),
13903
+ /** `memory.current` (v2) / `memory.usage_in_bytes` (v1). Always known. */
13904
+ currentBytes: number(),
13905
+ /** The cgroup's ceiling. `null` = NO LIMIT — never a sentinel, never zero. */
13906
+ limitBytes: number().nullable(),
13907
+ /** Anonymous pages: the closest thing to "what the processes allocated". */
13908
+ anonBytes: number().nullable(),
13909
+ /** Page cache. Charged to the cgroup, owned by no process. */
13910
+ fileBytes: number().nullable(),
13911
+ /**
13912
+ * Shared memory — and the field that explained the largest single surprise.
13913
+ * The i915 driver backs GPU buffers with shmem, so an inference pool or a
13914
+ * hardware-decode session holding DRM objects is charged HERE and appears
13915
+ * nowhere in a `ps` scan.
13916
+ */
13917
+ shmemBytes: number().nullable(),
13918
+ /** Kernel slab charged to this cgroup. `null` on v1, which never publishes it. */
13919
+ slabBytes: number().nullable(),
13920
+ /**
13921
+ * Shrinkable i915 GEM object bytes, from debugfs.
13922
+ *
13923
+ * **Host-wide across every DRM client, NOT cgroup-scoped.** It is not a
13924
+ * component of `currentBytes` and must not be subtracted from it; it says
13925
+ * what put the shmem there, where `shmemBytes` only says how much.
13926
+ *
13927
+ * `null` wherever debugfs is not mounted — which is inside every camstack
13928
+ * container today — and on any node with no Intel GPU.
13929
+ */
13930
+ gpuShmemBytes: number().nullable()
13931
+ }).extend({ atMs: number() });
13888
13932
  var DumpHeapSnapshotInputSchema = object({
13889
13933
  /** The addon whose runner should dump a heap snapshot. */
13890
13934
  addonId: string() });
@@ -13948,6 +13992,21 @@ var NodeLoadSeriesSchema = object({
13948
13992
  /** One entry per function seen in the window, heaviest-first. */
13949
13993
  series: array(LoadFunctionSeriesSchema).readonly(),
13950
13994
  /**
13995
+ * The CONTAINER's memory over the same window, oldest-first.
13996
+ *
13997
+ * Sits next to `series` rather than in a method of its own because the whole
13998
+ * question is a subtraction: the per-process rows in `series` sum to one
13999
+ * number and this one is another, and an operator who has to issue two calls
14000
+ * to compare them will compare two different instants. Same reader, same
14001
+ * `sinceMs`, same `bucketMs`, same timestamps.
14002
+ *
14003
+ * **EMPTY means ABSENT, never zero.** A node with no cgroup — a developer
14004
+ * Mac, a bare-metal host, a container with the hierarchy hidden — reports no
14005
+ * points at all. A zero here would be indistinguishable from a healthy
14006
+ * container and is precisely the lie this field exists to avoid.
14007
+ */
14008
+ containerMemory: array(ContainerMemoryPointSchema).readonly(),
14009
+ /**
13951
14010
  * Width of one returned bucket, in ms. Equals the sampling cadence when no
13952
14011
  * reduction was needed — so a caller can always say what one point covers
13953
14012
  * without having to know whether it was reduced.
@@ -27643,10 +27702,10 @@ DeviceType.Camera, DeviceType.Sensor, DeviceType.Switch, method(object({ deviceI
27643
27702
  * recording config. NOTE on events (source of truth, R5/C3): this cap carries
27644
27703
  * NO event surface — `getPlaybackManifest` returns playlist URLs only. Timeline
27645
27704
  * events (motion/object/audio) come from `pipelineAnalytics` (durable SQLite
27646
- * rows); the recorder's internal EventMap markers are ephemeral in-RAM
27647
- * annotations that are not exposed here and must not be treated as an event
27648
- * feed. Event<->footage joins are by time, padded with the shared `EVENT_PAD_MS`
27649
- * (`interfaces/recording-config.ts`).
27705
+ * rows) and are the ONLY event surface — the recorder has none. The in-RAM
27706
+ * playback markers it used to build were deleted on 2026-08-29 because nothing
27707
+ * ever read them. Event<->footage joins are by time, padded with the shared
27708
+ * `EVENT_PAD_MS` (`interfaces/recording-config.ts`).
27650
27709
  */
27651
27710
  var RecordingStatusSchema = object({
27652
27711
  deviceId: number(),
package/dist/addon.mjs CHANGED
@@ -13884,6 +13884,50 @@ var NodeProcessSchema = object({
13884
13884
  /** Wall-clock uptime (seconds). Parsed from `ps etime`. */
13885
13885
  uptimeSec: number()
13886
13886
  });
13887
+ /**
13888
+ * One retained container-memory reading.
13889
+ *
13890
+ * `atMs` is the timestamp of the PROCESS snapshot taken in the same tick, not
13891
+ * a second clock: that is what makes "processes sum to X, container says Y"
13892
+ * subtractable per point rather than an eyeballed comparison of two series
13893
+ * sampled at different instants.
13894
+ *
13895
+ * A reduced window keeps the sample with the LARGEST `currentBytes` in each
13896
+ * bucket, WHOLE. Taking a per-field maximum would synthesise a row whose parts
13897
+ * never coexisted, and a mean would smear away the peak this exists to find.
13898
+ */
13899
+ var ContainerMemoryPointSchema = object({
13900
+ /** Which hierarchy answered, so a reading is never ambiguous. */
13901
+ source: _enum(["cgroup-v2", "cgroup-v1"]),
13902
+ /** `memory.current` (v2) / `memory.usage_in_bytes` (v1). Always known. */
13903
+ currentBytes: number(),
13904
+ /** The cgroup's ceiling. `null` = NO LIMIT — never a sentinel, never zero. */
13905
+ limitBytes: number().nullable(),
13906
+ /** Anonymous pages: the closest thing to "what the processes allocated". */
13907
+ anonBytes: number().nullable(),
13908
+ /** Page cache. Charged to the cgroup, owned by no process. */
13909
+ fileBytes: number().nullable(),
13910
+ /**
13911
+ * Shared memory — and the field that explained the largest single surprise.
13912
+ * The i915 driver backs GPU buffers with shmem, so an inference pool or a
13913
+ * hardware-decode session holding DRM objects is charged HERE and appears
13914
+ * nowhere in a `ps` scan.
13915
+ */
13916
+ shmemBytes: number().nullable(),
13917
+ /** Kernel slab charged to this cgroup. `null` on v1, which never publishes it. */
13918
+ slabBytes: number().nullable(),
13919
+ /**
13920
+ * Shrinkable i915 GEM object bytes, from debugfs.
13921
+ *
13922
+ * **Host-wide across every DRM client, NOT cgroup-scoped.** It is not a
13923
+ * component of `currentBytes` and must not be subtracted from it; it says
13924
+ * what put the shmem there, where `shmemBytes` only says how much.
13925
+ *
13926
+ * `null` wherever debugfs is not mounted — which is inside every camstack
13927
+ * container today — and on any node with no Intel GPU.
13928
+ */
13929
+ gpuShmemBytes: number().nullable()
13930
+ }).extend({ atMs: number() });
13887
13931
  var DumpHeapSnapshotInputSchema = object({
13888
13932
  /** The addon whose runner should dump a heap snapshot. */
13889
13933
  addonId: string() });
@@ -13947,6 +13991,21 @@ var NodeLoadSeriesSchema = object({
13947
13991
  /** One entry per function seen in the window, heaviest-first. */
13948
13992
  series: array(LoadFunctionSeriesSchema).readonly(),
13949
13993
  /**
13994
+ * The CONTAINER's memory over the same window, oldest-first.
13995
+ *
13996
+ * Sits next to `series` rather than in a method of its own because the whole
13997
+ * question is a subtraction: the per-process rows in `series` sum to one
13998
+ * number and this one is another, and an operator who has to issue two calls
13999
+ * to compare them will compare two different instants. Same reader, same
14000
+ * `sinceMs`, same `bucketMs`, same timestamps.
14001
+ *
14002
+ * **EMPTY means ABSENT, never zero.** A node with no cgroup — a developer
14003
+ * Mac, a bare-metal host, a container with the hierarchy hidden — reports no
14004
+ * points at all. A zero here would be indistinguishable from a healthy
14005
+ * container and is precisely the lie this field exists to avoid.
14006
+ */
14007
+ containerMemory: array(ContainerMemoryPointSchema).readonly(),
14008
+ /**
13950
14009
  * Width of one returned bucket, in ms. Equals the sampling cadence when no
13951
14010
  * reduction was needed — so a caller can always say what one point covers
13952
14011
  * without having to know whether it was reduced.
@@ -27642,10 +27701,10 @@ DeviceType.Camera, DeviceType.Sensor, DeviceType.Switch, method(object({ deviceI
27642
27701
  * recording config. NOTE on events (source of truth, R5/C3): this cap carries
27643
27702
  * NO event surface — `getPlaybackManifest` returns playlist URLs only. Timeline
27644
27703
  * events (motion/object/audio) come from `pipelineAnalytics` (durable SQLite
27645
- * rows); the recorder's internal EventMap markers are ephemeral in-RAM
27646
- * annotations that are not exposed here and must not be treated as an event
27647
- * feed. Event<->footage joins are by time, padded with the shared `EVENT_PAD_MS`
27648
- * (`interfaces/recording-config.ts`).
27704
+ * rows) and are the ONLY event surface — the recorder has none. The in-RAM
27705
+ * playback markers it used to build were deleted on 2026-08-29 because nothing
27706
+ * ever read them. Event<->footage joins are by time, padded with the shared
27707
+ * `EVENT_PAD_MS` (`interfaces/recording-config.ts`).
27649
27708
  */
27650
27709
  var RecordingStatusSchema = object({
27651
27710
  deviceId: number(),
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@camstack/addon-provider-gree",
3
- "version": "0.2.38",
3
+ "version": "0.2.40",
4
4
  "description": "Gree air-conditioner device-provider addon for CamStack — wraps the @apocaliss92/nodegree local-UDP client (LAN discovery + AES control), exposing climate-control and fan-control",
5
5
  "keywords": [
6
6
  "camstack",