@camstack/addon-provider-rtsp 1.2.39 → 1.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
@@ -13938,6 +13938,50 @@ var NodeProcessSchema = object({
13938
13938
  /** Wall-clock uptime (seconds). Parsed from `ps etime`. */
13939
13939
  uptimeSec: number()
13940
13940
  });
13941
+ /**
13942
+ * One retained container-memory reading.
13943
+ *
13944
+ * `atMs` is the timestamp of the PROCESS snapshot taken in the same tick, not
13945
+ * a second clock: that is what makes "processes sum to X, container says Y"
13946
+ * subtractable per point rather than an eyeballed comparison of two series
13947
+ * sampled at different instants.
13948
+ *
13949
+ * A reduced window keeps the sample with the LARGEST `currentBytes` in each
13950
+ * bucket, WHOLE. Taking a per-field maximum would synthesise a row whose parts
13951
+ * never coexisted, and a mean would smear away the peak this exists to find.
13952
+ */
13953
+ var ContainerMemoryPointSchema = object({
13954
+ /** Which hierarchy answered, so a reading is never ambiguous. */
13955
+ source: _enum(["cgroup-v2", "cgroup-v1"]),
13956
+ /** `memory.current` (v2) / `memory.usage_in_bytes` (v1). Always known. */
13957
+ currentBytes: number(),
13958
+ /** The cgroup's ceiling. `null` = NO LIMIT — never a sentinel, never zero. */
13959
+ limitBytes: number().nullable(),
13960
+ /** Anonymous pages: the closest thing to "what the processes allocated". */
13961
+ anonBytes: number().nullable(),
13962
+ /** Page cache. Charged to the cgroup, owned by no process. */
13963
+ fileBytes: number().nullable(),
13964
+ /**
13965
+ * Shared memory — and the field that explained the largest single surprise.
13966
+ * The i915 driver backs GPU buffers with shmem, so an inference pool or a
13967
+ * hardware-decode session holding DRM objects is charged HERE and appears
13968
+ * nowhere in a `ps` scan.
13969
+ */
13970
+ shmemBytes: number().nullable(),
13971
+ /** Kernel slab charged to this cgroup. `null` on v1, which never publishes it. */
13972
+ slabBytes: number().nullable(),
13973
+ /**
13974
+ * Shrinkable i915 GEM object bytes, from debugfs.
13975
+ *
13976
+ * **Host-wide across every DRM client, NOT cgroup-scoped.** It is not a
13977
+ * component of `currentBytes` and must not be subtracted from it; it says
13978
+ * what put the shmem there, where `shmemBytes` only says how much.
13979
+ *
13980
+ * `null` wherever debugfs is not mounted — which is inside every camstack
13981
+ * container today — and on any node with no Intel GPU.
13982
+ */
13983
+ gpuShmemBytes: number().nullable()
13984
+ }).extend({ atMs: number() });
13941
13985
  var DumpHeapSnapshotInputSchema = object({
13942
13986
  /** The addon whose runner should dump a heap snapshot. */
13943
13987
  addonId: string() });
@@ -14001,6 +14045,21 @@ var NodeLoadSeriesSchema = object({
14001
14045
  /** One entry per function seen in the window, heaviest-first. */
14002
14046
  series: array(LoadFunctionSeriesSchema).readonly(),
14003
14047
  /**
14048
+ * The CONTAINER's memory over the same window, oldest-first.
14049
+ *
14050
+ * Sits next to `series` rather than in a method of its own because the whole
14051
+ * question is a subtraction: the per-process rows in `series` sum to one
14052
+ * number and this one is another, and an operator who has to issue two calls
14053
+ * to compare them will compare two different instants. Same reader, same
14054
+ * `sinceMs`, same `bucketMs`, same timestamps.
14055
+ *
14056
+ * **EMPTY means ABSENT, never zero.** A node with no cgroup — a developer
14057
+ * Mac, a bare-metal host, a container with the hierarchy hidden — reports no
14058
+ * points at all. A zero here would be indistinguishable from a healthy
14059
+ * container and is precisely the lie this field exists to avoid.
14060
+ */
14061
+ containerMemory: array(ContainerMemoryPointSchema).readonly(),
14062
+ /**
14004
14063
  * Width of one returned bucket, in ms. Equals the sampling cadence when no
14005
14064
  * reduction was needed — so a caller can always say what one point covers
14006
14065
  * without having to know whether it was reduced.
@@ -27808,10 +27867,10 @@ DeviceType.Camera, DeviceType.Sensor, DeviceType.Switch, method(object({ deviceI
27808
27867
  * recording config. NOTE on events (source of truth, R5/C3): this cap carries
27809
27868
  * NO event surface — `getPlaybackManifest` returns playlist URLs only. Timeline
27810
27869
  * events (motion/object/audio) come from `pipelineAnalytics` (durable SQLite
27811
- * rows); the recorder's internal EventMap markers are ephemeral in-RAM
27812
- * annotations that are not exposed here and must not be treated as an event
27813
- * feed. Event<->footage joins are by time, padded with the shared `EVENT_PAD_MS`
27814
- * (`interfaces/recording-config.ts`).
27870
+ * rows) and are the ONLY event surface the recorder has none. The in-RAM
27871
+ * playback markers it used to build were deleted on 2026-08-29 because nothing
27872
+ * ever read them. Event<->footage joins are by time, padded with the shared
27873
+ * `EVENT_PAD_MS` (`interfaces/recording-config.ts`).
27815
27874
  */
27816
27875
  var RecordingStatusSchema = object({
27817
27876
  deviceId: number(),
package/dist/addon.mjs CHANGED
@@ -13914,6 +13914,50 @@ var NodeProcessSchema = object({
13914
13914
  /** Wall-clock uptime (seconds). Parsed from `ps etime`. */
13915
13915
  uptimeSec: number()
13916
13916
  });
13917
+ /**
13918
+ * One retained container-memory reading.
13919
+ *
13920
+ * `atMs` is the timestamp of the PROCESS snapshot taken in the same tick, not
13921
+ * a second clock: that is what makes "processes sum to X, container says Y"
13922
+ * subtractable per point rather than an eyeballed comparison of two series
13923
+ * sampled at different instants.
13924
+ *
13925
+ * A reduced window keeps the sample with the LARGEST `currentBytes` in each
13926
+ * bucket, WHOLE. Taking a per-field maximum would synthesise a row whose parts
13927
+ * never coexisted, and a mean would smear away the peak this exists to find.
13928
+ */
13929
+ var ContainerMemoryPointSchema = object({
13930
+ /** Which hierarchy answered, so a reading is never ambiguous. */
13931
+ source: _enum(["cgroup-v2", "cgroup-v1"]),
13932
+ /** `memory.current` (v2) / `memory.usage_in_bytes` (v1). Always known. */
13933
+ currentBytes: number(),
13934
+ /** The cgroup's ceiling. `null` = NO LIMIT — never a sentinel, never zero. */
13935
+ limitBytes: number().nullable(),
13936
+ /** Anonymous pages: the closest thing to "what the processes allocated". */
13937
+ anonBytes: number().nullable(),
13938
+ /** Page cache. Charged to the cgroup, owned by no process. */
13939
+ fileBytes: number().nullable(),
13940
+ /**
13941
+ * Shared memory — and the field that explained the largest single surprise.
13942
+ * The i915 driver backs GPU buffers with shmem, so an inference pool or a
13943
+ * hardware-decode session holding DRM objects is charged HERE and appears
13944
+ * nowhere in a `ps` scan.
13945
+ */
13946
+ shmemBytes: number().nullable(),
13947
+ /** Kernel slab charged to this cgroup. `null` on v1, which never publishes it. */
13948
+ slabBytes: number().nullable(),
13949
+ /**
13950
+ * Shrinkable i915 GEM object bytes, from debugfs.
13951
+ *
13952
+ * **Host-wide across every DRM client, NOT cgroup-scoped.** It is not a
13953
+ * component of `currentBytes` and must not be subtracted from it; it says
13954
+ * what put the shmem there, where `shmemBytes` only says how much.
13955
+ *
13956
+ * `null` wherever debugfs is not mounted — which is inside every camstack
13957
+ * container today — and on any node with no Intel GPU.
13958
+ */
13959
+ gpuShmemBytes: number().nullable()
13960
+ }).extend({ atMs: number() });
13917
13961
  var DumpHeapSnapshotInputSchema = object({
13918
13962
  /** The addon whose runner should dump a heap snapshot. */
13919
13963
  addonId: string() });
@@ -13977,6 +14021,21 @@ var NodeLoadSeriesSchema = object({
13977
14021
  /** One entry per function seen in the window, heaviest-first. */
13978
14022
  series: array(LoadFunctionSeriesSchema).readonly(),
13979
14023
  /**
14024
+ * The CONTAINER's memory over the same window, oldest-first.
14025
+ *
14026
+ * Sits next to `series` rather than in a method of its own because the whole
14027
+ * question is a subtraction: the per-process rows in `series` sum to one
14028
+ * number and this one is another, and an operator who has to issue two calls
14029
+ * to compare them will compare two different instants. Same reader, same
14030
+ * `sinceMs`, same `bucketMs`, same timestamps.
14031
+ *
14032
+ * **EMPTY means ABSENT, never zero.** A node with no cgroup — a developer
14033
+ * Mac, a bare-metal host, a container with the hierarchy hidden — reports no
14034
+ * points at all. A zero here would be indistinguishable from a healthy
14035
+ * container and is precisely the lie this field exists to avoid.
14036
+ */
14037
+ containerMemory: array(ContainerMemoryPointSchema).readonly(),
14038
+ /**
13980
14039
  * Width of one returned bucket, in ms. Equals the sampling cadence when no
13981
14040
  * reduction was needed — so a caller can always say what one point covers
13982
14041
  * without having to know whether it was reduced.
@@ -27784,10 +27843,10 @@ DeviceType.Camera, DeviceType.Sensor, DeviceType.Switch, method(object({ deviceI
27784
27843
  * recording config. NOTE on events (source of truth, R5/C3): this cap carries
27785
27844
  * NO event surface — `getPlaybackManifest` returns playlist URLs only. Timeline
27786
27845
  * events (motion/object/audio) come from `pipelineAnalytics` (durable SQLite
27787
- * rows); the recorder's internal EventMap markers are ephemeral in-RAM
27788
- * annotations that are not exposed here and must not be treated as an event
27789
- * feed. Event<->footage joins are by time, padded with the shared `EVENT_PAD_MS`
27790
- * (`interfaces/recording-config.ts`).
27846
+ * rows) and are the ONLY event surface the recorder has none. The in-RAM
27847
+ * playback markers it used to build were deleted on 2026-08-29 because nothing
27848
+ * ever read them. Event<->footage joins are by time, padded with the shared
27849
+ * `EVENT_PAD_MS` (`interfaces/recording-config.ts`).
27791
27850
  */
27792
27851
  var RecordingStatusSchema = object({
27793
27852
  deviceId: number(),
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@camstack/addon-provider-rtsp",
3
- "version": "1.2.39",
3
+ "version": "1.2.41",
4
4
  "description": "Generic RTSP camera device provider addon for CamStack",
5
5
  "keywords": [
6
6
  "camstack",