@camstack/addon-provider-rademacher 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
@@ -14867,6 +14867,50 @@ var NodeProcessSchema = object({
14867
14867
  /** Wall-clock uptime (seconds). Parsed from `ps etime`. */
14868
14868
  uptimeSec: number()
14869
14869
  });
14870
+ /**
14871
+ * One retained container-memory reading.
14872
+ *
14873
+ * `atMs` is the timestamp of the PROCESS snapshot taken in the same tick, not
14874
+ * a second clock: that is what makes "processes sum to X, container says Y"
14875
+ * subtractable per point rather than an eyeballed comparison of two series
14876
+ * sampled at different instants.
14877
+ *
14878
+ * A reduced window keeps the sample with the LARGEST `currentBytes` in each
14879
+ * bucket, WHOLE. Taking a per-field maximum would synthesise a row whose parts
14880
+ * never coexisted, and a mean would smear away the peak this exists to find.
14881
+ */
14882
+ var ContainerMemoryPointSchema = object({
14883
+ /** Which hierarchy answered, so a reading is never ambiguous. */
14884
+ source: _enum(["cgroup-v2", "cgroup-v1"]),
14885
+ /** `memory.current` (v2) / `memory.usage_in_bytes` (v1). Always known. */
14886
+ currentBytes: number(),
14887
+ /** The cgroup's ceiling. `null` = NO LIMIT — never a sentinel, never zero. */
14888
+ limitBytes: number().nullable(),
14889
+ /** Anonymous pages: the closest thing to "what the processes allocated". */
14890
+ anonBytes: number().nullable(),
14891
+ /** Page cache. Charged to the cgroup, owned by no process. */
14892
+ fileBytes: number().nullable(),
14893
+ /**
14894
+ * Shared memory — and the field that explained the largest single surprise.
14895
+ * The i915 driver backs GPU buffers with shmem, so an inference pool or a
14896
+ * hardware-decode session holding DRM objects is charged HERE and appears
14897
+ * nowhere in a `ps` scan.
14898
+ */
14899
+ shmemBytes: number().nullable(),
14900
+ /** Kernel slab charged to this cgroup. `null` on v1, which never publishes it. */
14901
+ slabBytes: number().nullable(),
14902
+ /**
14903
+ * Shrinkable i915 GEM object bytes, from debugfs.
14904
+ *
14905
+ * **Host-wide across every DRM client, NOT cgroup-scoped.** It is not a
14906
+ * component of `currentBytes` and must not be subtracted from it; it says
14907
+ * what put the shmem there, where `shmemBytes` only says how much.
14908
+ *
14909
+ * `null` wherever debugfs is not mounted — which is inside every camstack
14910
+ * container today — and on any node with no Intel GPU.
14911
+ */
14912
+ gpuShmemBytes: number().nullable()
14913
+ }).extend({ atMs: number() });
14870
14914
  var DumpHeapSnapshotInputSchema = object({
14871
14915
  /** The addon whose runner should dump a heap snapshot. */
14872
14916
  addonId: string() });
@@ -14930,6 +14974,21 @@ var NodeLoadSeriesSchema = object({
14930
14974
  /** One entry per function seen in the window, heaviest-first. */
14931
14975
  series: array(LoadFunctionSeriesSchema).readonly(),
14932
14976
  /**
14977
+ * The CONTAINER's memory over the same window, oldest-first.
14978
+ *
14979
+ * Sits next to `series` rather than in a method of its own because the whole
14980
+ * question is a subtraction: the per-process rows in `series` sum to one
14981
+ * number and this one is another, and an operator who has to issue two calls
14982
+ * to compare them will compare two different instants. Same reader, same
14983
+ * `sinceMs`, same `bucketMs`, same timestamps.
14984
+ *
14985
+ * **EMPTY means ABSENT, never zero.** A node with no cgroup — a developer
14986
+ * Mac, a bare-metal host, a container with the hierarchy hidden — reports no
14987
+ * points at all. A zero here would be indistinguishable from a healthy
14988
+ * container and is precisely the lie this field exists to avoid.
14989
+ */
14990
+ containerMemory: array(ContainerMemoryPointSchema).readonly(),
14991
+ /**
14933
14992
  * Width of one returned bucket, in ms. Equals the sampling cadence when no
14934
14993
  * reduction was needed — so a caller can always say what one point covers
14935
14994
  * without having to know whether it was reduced.
@@ -28625,10 +28684,10 @@ DeviceType.Camera, DeviceType.Sensor, DeviceType.Switch, method(object({ deviceI
28625
28684
  * recording config. NOTE on events (source of truth, R5/C3): this cap carries
28626
28685
  * NO event surface — `getPlaybackManifest` returns playlist URLs only. Timeline
28627
28686
  * events (motion/object/audio) come from `pipelineAnalytics` (durable SQLite
28628
- * rows); the recorder's internal EventMap markers are ephemeral in-RAM
28629
- * annotations that are not exposed here and must not be treated as an event
28630
- * feed. Event<->footage joins are by time, padded with the shared `EVENT_PAD_MS`
28631
- * (`interfaces/recording-config.ts`).
28687
+ * rows) and are the ONLY event surface the recorder has none. The in-RAM
28688
+ * playback markers it used to build were deleted on 2026-08-29 because nothing
28689
+ * ever read them. Event<->footage joins are by time, padded with the shared
28690
+ * `EVENT_PAD_MS` (`interfaces/recording-config.ts`).
28632
28691
  */
28633
28692
  var RecordingStatusSchema = object({
28634
28693
  deviceId: number(),
package/dist/addon.mjs CHANGED
@@ -14866,6 +14866,50 @@ var NodeProcessSchema = object({
14866
14866
  /** Wall-clock uptime (seconds). Parsed from `ps etime`. */
14867
14867
  uptimeSec: number()
14868
14868
  });
14869
+ /**
14870
+ * One retained container-memory reading.
14871
+ *
14872
+ * `atMs` is the timestamp of the PROCESS snapshot taken in the same tick, not
14873
+ * a second clock: that is what makes "processes sum to X, container says Y"
14874
+ * subtractable per point rather than an eyeballed comparison of two series
14875
+ * sampled at different instants.
14876
+ *
14877
+ * A reduced window keeps the sample with the LARGEST `currentBytes` in each
14878
+ * bucket, WHOLE. Taking a per-field maximum would synthesise a row whose parts
14879
+ * never coexisted, and a mean would smear away the peak this exists to find.
14880
+ */
14881
+ var ContainerMemoryPointSchema = object({
14882
+ /** Which hierarchy answered, so a reading is never ambiguous. */
14883
+ source: _enum(["cgroup-v2", "cgroup-v1"]),
14884
+ /** `memory.current` (v2) / `memory.usage_in_bytes` (v1). Always known. */
14885
+ currentBytes: number(),
14886
+ /** The cgroup's ceiling. `null` = NO LIMIT — never a sentinel, never zero. */
14887
+ limitBytes: number().nullable(),
14888
+ /** Anonymous pages: the closest thing to "what the processes allocated". */
14889
+ anonBytes: number().nullable(),
14890
+ /** Page cache. Charged to the cgroup, owned by no process. */
14891
+ fileBytes: number().nullable(),
14892
+ /**
14893
+ * Shared memory — and the field that explained the largest single surprise.
14894
+ * The i915 driver backs GPU buffers with shmem, so an inference pool or a
14895
+ * hardware-decode session holding DRM objects is charged HERE and appears
14896
+ * nowhere in a `ps` scan.
14897
+ */
14898
+ shmemBytes: number().nullable(),
14899
+ /** Kernel slab charged to this cgroup. `null` on v1, which never publishes it. */
14900
+ slabBytes: number().nullable(),
14901
+ /**
14902
+ * Shrinkable i915 GEM object bytes, from debugfs.
14903
+ *
14904
+ * **Host-wide across every DRM client, NOT cgroup-scoped.** It is not a
14905
+ * component of `currentBytes` and must not be subtracted from it; it says
14906
+ * what put the shmem there, where `shmemBytes` only says how much.
14907
+ *
14908
+ * `null` wherever debugfs is not mounted — which is inside every camstack
14909
+ * container today — and on any node with no Intel GPU.
14910
+ */
14911
+ gpuShmemBytes: number().nullable()
14912
+ }).extend({ atMs: number() });
14869
14913
  var DumpHeapSnapshotInputSchema = object({
14870
14914
  /** The addon whose runner should dump a heap snapshot. */
14871
14915
  addonId: string() });
@@ -14929,6 +14973,21 @@ var NodeLoadSeriesSchema = object({
14929
14973
  /** One entry per function seen in the window, heaviest-first. */
14930
14974
  series: array(LoadFunctionSeriesSchema).readonly(),
14931
14975
  /**
14976
+ * The CONTAINER's memory over the same window, oldest-first.
14977
+ *
14978
+ * Sits next to `series` rather than in a method of its own because the whole
14979
+ * question is a subtraction: the per-process rows in `series` sum to one
14980
+ * number and this one is another, and an operator who has to issue two calls
14981
+ * to compare them will compare two different instants. Same reader, same
14982
+ * `sinceMs`, same `bucketMs`, same timestamps.
14983
+ *
14984
+ * **EMPTY means ABSENT, never zero.** A node with no cgroup — a developer
14985
+ * Mac, a bare-metal host, a container with the hierarchy hidden — reports no
14986
+ * points at all. A zero here would be indistinguishable from a healthy
14987
+ * container and is precisely the lie this field exists to avoid.
14988
+ */
14989
+ containerMemory: array(ContainerMemoryPointSchema).readonly(),
14990
+ /**
14932
14991
  * Width of one returned bucket, in ms. Equals the sampling cadence when no
14933
14992
  * reduction was needed — so a caller can always say what one point covers
14934
14993
  * without having to know whether it was reduced.
@@ -28624,10 +28683,10 @@ DeviceType.Camera, DeviceType.Sensor, DeviceType.Switch, method(object({ deviceI
28624
28683
  * recording config. NOTE on events (source of truth, R5/C3): this cap carries
28625
28684
  * NO event surface — `getPlaybackManifest` returns playlist URLs only. Timeline
28626
28685
  * events (motion/object/audio) come from `pipelineAnalytics` (durable SQLite
28627
- * rows); the recorder's internal EventMap markers are ephemeral in-RAM
28628
- * annotations that are not exposed here and must not be treated as an event
28629
- * feed. Event<->footage joins are by time, padded with the shared `EVENT_PAD_MS`
28630
- * (`interfaces/recording-config.ts`).
28686
+ * rows) and are the ONLY event surface the recorder has none. The in-RAM
28687
+ * playback markers it used to build were deleted on 2026-08-29 because nothing
28688
+ * ever read them. Event<->footage joins are by time, padded with the shared
28689
+ * `EVENT_PAD_MS` (`interfaces/recording-config.ts`).
28631
28690
  */
28632
28691
  var RecordingStatusSchema = object({
28633
28692
  deviceId: number(),
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@camstack/addon-provider-rademacher",
3
- "version": "0.2.38",
3
+ "version": "0.2.40",
4
4
  "description": "Rademacher HomePilot device-provider addon for CamStack — wraps the @apocaliss92/noderademacher local-hub client (roller shutters over the cover cap)",
5
5
  "keywords": [
6
6
  "camstack",