@camstack/addon-provider-amcrest 0.2.40 → 0.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
@@ -13875,6 +13875,50 @@ var NodeProcessSchema = object({
13875
13875
  /** Wall-clock uptime (seconds). Parsed from `ps etime`. */
13876
13876
  uptimeSec: number()
13877
13877
  });
13878
+ /**
13879
+ * One retained container-memory reading.
13880
+ *
13881
+ * `atMs` is the timestamp of the PROCESS snapshot taken in the same tick, not
13882
+ * a second clock: that is what makes "processes sum to X, container says Y"
13883
+ * subtractable per point rather than an eyeballed comparison of two series
13884
+ * sampled at different instants.
13885
+ *
13886
+ * A reduced window keeps the sample with the LARGEST `currentBytes` in each
13887
+ * bucket, WHOLE. Taking a per-field maximum would synthesise a row whose parts
13888
+ * never coexisted, and a mean would smear away the peak this exists to find.
13889
+ */
13890
+ var ContainerMemoryPointSchema = object({
13891
+ /** Which hierarchy answered, so a reading is never ambiguous. */
13892
+ source: _enum(["cgroup-v2", "cgroup-v1"]),
13893
+ /** `memory.current` (v2) / `memory.usage_in_bytes` (v1). Always known. */
13894
+ currentBytes: number(),
13895
+ /** The cgroup's ceiling. `null` = NO LIMIT — never a sentinel, never zero. */
13896
+ limitBytes: number().nullable(),
13897
+ /** Anonymous pages: the closest thing to "what the processes allocated". */
13898
+ anonBytes: number().nullable(),
13899
+ /** Page cache. Charged to the cgroup, owned by no process. */
13900
+ fileBytes: number().nullable(),
13901
+ /**
13902
+ * Shared memory — and the field that explained the largest single surprise.
13903
+ * The i915 driver backs GPU buffers with shmem, so an inference pool or a
13904
+ * hardware-decode session holding DRM objects is charged HERE and appears
13905
+ * nowhere in a `ps` scan.
13906
+ */
13907
+ shmemBytes: number().nullable(),
13908
+ /** Kernel slab charged to this cgroup. `null` on v1, which never publishes it. */
13909
+ slabBytes: number().nullable(),
13910
+ /**
13911
+ * Shrinkable i915 GEM object bytes, from debugfs.
13912
+ *
13913
+ * **Host-wide across every DRM client, NOT cgroup-scoped.** It is not a
13914
+ * component of `currentBytes` and must not be subtracted from it; it says
13915
+ * what put the shmem there, where `shmemBytes` only says how much.
13916
+ *
13917
+ * `null` wherever debugfs is not mounted — which is inside every camstack
13918
+ * container today — and on any node with no Intel GPU.
13919
+ */
13920
+ gpuShmemBytes: number().nullable()
13921
+ }).extend({ atMs: number() });
13878
13922
  var DumpHeapSnapshotInputSchema = object({
13879
13923
  /** The addon whose runner should dump a heap snapshot. */
13880
13924
  addonId: string() });
@@ -13938,6 +13982,21 @@ var NodeLoadSeriesSchema = object({
13938
13982
  /** One entry per function seen in the window, heaviest-first. */
13939
13983
  series: array(LoadFunctionSeriesSchema).readonly(),
13940
13984
  /**
13985
+ * The CONTAINER's memory over the same window, oldest-first.
13986
+ *
13987
+ * Sits next to `series` rather than in a method of its own because the whole
13988
+ * question is a subtraction: the per-process rows in `series` sum to one
13989
+ * number and this one is another, and an operator who has to issue two calls
13990
+ * to compare them will compare two different instants. Same reader, same
13991
+ * `sinceMs`, same `bucketMs`, same timestamps.
13992
+ *
13993
+ * **EMPTY means ABSENT, never zero.** A node with no cgroup — a developer
13994
+ * Mac, a bare-metal host, a container with the hierarchy hidden — reports no
13995
+ * points at all. A zero here would be indistinguishable from a healthy
13996
+ * container and is precisely the lie this field exists to avoid.
13997
+ */
13998
+ containerMemory: array(ContainerMemoryPointSchema).readonly(),
13999
+ /**
13941
14000
  * Width of one returned bucket, in ms. Equals the sampling cadence when no
13942
14001
  * reduction was needed — so a caller can always say what one point covers
13943
14002
  * without having to know whether it was reduced.
@@ -27825,10 +27884,10 @@ DeviceType.Camera, DeviceType.Sensor, DeviceType.Switch, method(object({ deviceI
27825
27884
  * recording config. NOTE on events (source of truth, R5/C3): this cap carries
27826
27885
  * NO event surface — `getPlaybackManifest` returns playlist URLs only. Timeline
27827
27886
  * events (motion/object/audio) come from `pipelineAnalytics` (durable SQLite
27828
- * rows); the recorder's internal EventMap markers are ephemeral in-RAM
27829
- * annotations that are not exposed here and must not be treated as an event
27830
- * feed. Event<->footage joins are by time, padded with the shared `EVENT_PAD_MS`
27831
- * (`interfaces/recording-config.ts`).
27887
+ * rows) and are the ONLY event surface the recorder has none. The in-RAM
27888
+ * playback markers it used to build were deleted on 2026-08-29 because nothing
27889
+ * ever read them. Event<->footage joins are by time, padded with the shared
27890
+ * `EVENT_PAD_MS` (`interfaces/recording-config.ts`).
27832
27891
  */
27833
27892
  var RecordingStatusSchema = object({
27834
27893
  deviceId: number(),
package/dist/addon.mjs CHANGED
@@ -13876,6 +13876,50 @@ var NodeProcessSchema = object({
13876
13876
  /** Wall-clock uptime (seconds). Parsed from `ps etime`. */
13877
13877
  uptimeSec: number()
13878
13878
  });
13879
+ /**
13880
+ * One retained container-memory reading.
13881
+ *
13882
+ * `atMs` is the timestamp of the PROCESS snapshot taken in the same tick, not
13883
+ * a second clock: that is what makes "processes sum to X, container says Y"
13884
+ * subtractable per point rather than an eyeballed comparison of two series
13885
+ * sampled at different instants.
13886
+ *
13887
+ * A reduced window keeps the sample with the LARGEST `currentBytes` in each
13888
+ * bucket, WHOLE. Taking a per-field maximum would synthesise a row whose parts
13889
+ * never coexisted, and a mean would smear away the peak this exists to find.
13890
+ */
13891
+ var ContainerMemoryPointSchema = object({
13892
+ /** Which hierarchy answered, so a reading is never ambiguous. */
13893
+ source: _enum(["cgroup-v2", "cgroup-v1"]),
13894
+ /** `memory.current` (v2) / `memory.usage_in_bytes` (v1). Always known. */
13895
+ currentBytes: number(),
13896
+ /** The cgroup's ceiling. `null` = NO LIMIT — never a sentinel, never zero. */
13897
+ limitBytes: number().nullable(),
13898
+ /** Anonymous pages: the closest thing to "what the processes allocated". */
13899
+ anonBytes: number().nullable(),
13900
+ /** Page cache. Charged to the cgroup, owned by no process. */
13901
+ fileBytes: number().nullable(),
13902
+ /**
13903
+ * Shared memory — and the field that explained the largest single surprise.
13904
+ * The i915 driver backs GPU buffers with shmem, so an inference pool or a
13905
+ * hardware-decode session holding DRM objects is charged HERE and appears
13906
+ * nowhere in a `ps` scan.
13907
+ */
13908
+ shmemBytes: number().nullable(),
13909
+ /** Kernel slab charged to this cgroup. `null` on v1, which never publishes it. */
13910
+ slabBytes: number().nullable(),
13911
+ /**
13912
+ * Shrinkable i915 GEM object bytes, from debugfs.
13913
+ *
13914
+ * **Host-wide across every DRM client, NOT cgroup-scoped.** It is not a
13915
+ * component of `currentBytes` and must not be subtracted from it; it says
13916
+ * what put the shmem there, where `shmemBytes` only says how much.
13917
+ *
13918
+ * `null` wherever debugfs is not mounted — which is inside every camstack
13919
+ * container today — and on any node with no Intel GPU.
13920
+ */
13921
+ gpuShmemBytes: number().nullable()
13922
+ }).extend({ atMs: number() });
13879
13923
  var DumpHeapSnapshotInputSchema = object({
13880
13924
  /** The addon whose runner should dump a heap snapshot. */
13881
13925
  addonId: string() });
@@ -13939,6 +13983,21 @@ var NodeLoadSeriesSchema = object({
13939
13983
  /** One entry per function seen in the window, heaviest-first. */
13940
13984
  series: array(LoadFunctionSeriesSchema).readonly(),
13941
13985
  /**
13986
+ * The CONTAINER's memory over the same window, oldest-first.
13987
+ *
13988
+ * Sits next to `series` rather than in a method of its own because the whole
13989
+ * question is a subtraction: the per-process rows in `series` sum to one
13990
+ * number and this one is another, and an operator who has to issue two calls
13991
+ * to compare them will compare two different instants. Same reader, same
13992
+ * `sinceMs`, same `bucketMs`, same timestamps.
13993
+ *
13994
+ * **EMPTY means ABSENT, never zero.** A node with no cgroup — a developer
13995
+ * Mac, a bare-metal host, a container with the hierarchy hidden — reports no
13996
+ * points at all. A zero here would be indistinguishable from a healthy
13997
+ * container and is precisely the lie this field exists to avoid.
13998
+ */
13999
+ containerMemory: array(ContainerMemoryPointSchema).readonly(),
14000
+ /**
13942
14001
  * Width of one returned bucket, in ms. Equals the sampling cadence when no
13943
14002
  * reduction was needed — so a caller can always say what one point covers
13944
14003
  * without having to know whether it was reduced.
@@ -27826,10 +27885,10 @@ DeviceType.Camera, DeviceType.Sensor, DeviceType.Switch, method(object({ deviceI
27826
27885
  * recording config. NOTE on events (source of truth, R5/C3): this cap carries
27827
27886
  * NO event surface — `getPlaybackManifest` returns playlist URLs only. Timeline
27828
27887
  * events (motion/object/audio) come from `pipelineAnalytics` (durable SQLite
27829
- * rows); the recorder's internal EventMap markers are ephemeral in-RAM
27830
- * annotations that are not exposed here and must not be treated as an event
27831
- * feed. Event<->footage joins are by time, padded with the shared `EVENT_PAD_MS`
27832
- * (`interfaces/recording-config.ts`).
27888
+ * rows) and are the ONLY event surface the recorder has none. The in-RAM
27889
+ * playback markers it used to build were deleted on 2026-08-29 because nothing
27890
+ * ever read them. Event<->footage joins are by time, padded with the shared
27891
+ * `EVENT_PAD_MS` (`interfaces/recording-config.ts`).
27833
27892
  */
27834
27893
  var RecordingStatusSchema = object({
27835
27894
  deviceId: number(),
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@camstack/addon-provider-amcrest",
3
- "version": "0.2.40",
3
+ "version": "0.2.42",
4
4
  "description": "Amcrest/Dahua camera device provider addon for CamStack — Dahua CGI over HTTP(S) with digest auth (snapshot, RTSP catalog, PTZ, image/day-night config)",
5
5
  "keywords": [
6
6
  "camstack",