@camstack/addon-import-alexa 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
@@ -14125,6 +14125,50 @@ var NodeProcessSchema = object({
14125
14125
  /** Wall-clock uptime (seconds). Parsed from `ps etime`. */
14126
14126
  uptimeSec: number()
14127
14127
  });
14128
+ /**
14129
+ * One retained container-memory reading.
14130
+ *
14131
+ * `atMs` is the timestamp of the PROCESS snapshot taken in the same tick, not
14132
+ * a second clock: that is what makes "processes sum to X, container says Y"
14133
+ * subtractable per point rather than an eyeballed comparison of two series
14134
+ * sampled at different instants.
14135
+ *
14136
+ * A reduced window keeps the sample with the LARGEST `currentBytes` in each
14137
+ * bucket, WHOLE. Taking a per-field maximum would synthesise a row whose parts
14138
+ * never coexisted, and a mean would smear away the peak this exists to find.
14139
+ */
14140
+ var ContainerMemoryPointSchema = object({
14141
+ /** Which hierarchy answered, so a reading is never ambiguous. */
14142
+ source: _enum(["cgroup-v2", "cgroup-v1"]),
14143
+ /** `memory.current` (v2) / `memory.usage_in_bytes` (v1). Always known. */
14144
+ currentBytes: number(),
14145
+ /** The cgroup's ceiling. `null` = NO LIMIT — never a sentinel, never zero. */
14146
+ limitBytes: number().nullable(),
14147
+ /** Anonymous pages: the closest thing to "what the processes allocated". */
14148
+ anonBytes: number().nullable(),
14149
+ /** Page cache. Charged to the cgroup, owned by no process. */
14150
+ fileBytes: number().nullable(),
14151
+ /**
14152
+ * Shared memory — and the field that explained the largest single surprise.
14153
+ * The i915 driver backs GPU buffers with shmem, so an inference pool or a
14154
+ * hardware-decode session holding DRM objects is charged HERE and appears
14155
+ * nowhere in a `ps` scan.
14156
+ */
14157
+ shmemBytes: number().nullable(),
14158
+ /** Kernel slab charged to this cgroup. `null` on v1, which never publishes it. */
14159
+ slabBytes: number().nullable(),
14160
+ /**
14161
+ * Shrinkable i915 GEM object bytes, from debugfs.
14162
+ *
14163
+ * **Host-wide across every DRM client, NOT cgroup-scoped.** It is not a
14164
+ * component of `currentBytes` and must not be subtracted from it; it says
14165
+ * what put the shmem there, where `shmemBytes` only says how much.
14166
+ *
14167
+ * `null` wherever debugfs is not mounted — which is inside every camstack
14168
+ * container today — and on any node with no Intel GPU.
14169
+ */
14170
+ gpuShmemBytes: number().nullable()
14171
+ }).extend({ atMs: number() });
14128
14172
  var DumpHeapSnapshotInputSchema = object({
14129
14173
  /** The addon whose runner should dump a heap snapshot. */
14130
14174
  addonId: string() });
@@ -14188,6 +14232,21 @@ var NodeLoadSeriesSchema = object({
14188
14232
  /** One entry per function seen in the window, heaviest-first. */
14189
14233
  series: array(LoadFunctionSeriesSchema).readonly(),
14190
14234
  /**
14235
+ * The CONTAINER's memory over the same window, oldest-first.
14236
+ *
14237
+ * Sits next to `series` rather than in a method of its own because the whole
14238
+ * question is a subtraction: the per-process rows in `series` sum to one
14239
+ * number and this one is another, and an operator who has to issue two calls
14240
+ * to compare them will compare two different instants. Same reader, same
14241
+ * `sinceMs`, same `bucketMs`, same timestamps.
14242
+ *
14243
+ * **EMPTY means ABSENT, never zero.** A node with no cgroup — a developer
14244
+ * Mac, a bare-metal host, a container with the hierarchy hidden — reports no
14245
+ * points at all. A zero here would be indistinguishable from a healthy
14246
+ * container and is precisely the lie this field exists to avoid.
14247
+ */
14248
+ containerMemory: array(ContainerMemoryPointSchema).readonly(),
14249
+ /**
14191
14250
  * Width of one returned bucket, in ms. Equals the sampling cadence when no
14192
14251
  * reduction was needed — so a caller can always say what one point covers
14193
14252
  * without having to know whether it was reduced.
@@ -27900,10 +27959,10 @@ DeviceType.Camera, DeviceType.Sensor, DeviceType.Switch, method(object({ deviceI
27900
27959
  * recording config. NOTE on events (source of truth, R5/C3): this cap carries
27901
27960
  * NO event surface — `getPlaybackManifest` returns playlist URLs only. Timeline
27902
27961
  * events (motion/object/audio) come from `pipelineAnalytics` (durable SQLite
27903
- * rows); the recorder's internal EventMap markers are ephemeral in-RAM
27904
- * annotations that are not exposed here and must not be treated as an event
27905
- * feed. Event<->footage joins are by time, padded with the shared `EVENT_PAD_MS`
27906
- * (`interfaces/recording-config.ts`).
27962
+ * rows) and are the ONLY event surface — the recorder has none. The in-RAM
27963
+ * playback markers it used to build were deleted on 2026-08-29 because nothing
27964
+ * ever read them. Event<->footage joins are by time, padded with the shared
27965
+ * `EVENT_PAD_MS` (`interfaces/recording-config.ts`).
27907
27966
  */
27908
27967
  var RecordingStatusSchema = object({
27909
27968
  deviceId: number(),
package/dist/addon.mjs CHANGED
@@ -14125,6 +14125,50 @@ var NodeProcessSchema = object({
14125
14125
  /** Wall-clock uptime (seconds). Parsed from `ps etime`. */
14126
14126
  uptimeSec: number()
14127
14127
  });
14128
+ /**
14129
+ * One retained container-memory reading.
14130
+ *
14131
+ * `atMs` is the timestamp of the PROCESS snapshot taken in the same tick, not
14132
+ * a second clock: that is what makes "processes sum to X, container says Y"
14133
+ * subtractable per point rather than an eyeballed comparison of two series
14134
+ * sampled at different instants.
14135
+ *
14136
+ * A reduced window keeps the sample with the LARGEST `currentBytes` in each
14137
+ * bucket, WHOLE. Taking a per-field maximum would synthesise a row whose parts
14138
+ * never coexisted, and a mean would smear away the peak this exists to find.
14139
+ */
14140
+ var ContainerMemoryPointSchema = object({
14141
+ /** Which hierarchy answered, so a reading is never ambiguous. */
14142
+ source: _enum(["cgroup-v2", "cgroup-v1"]),
14143
+ /** `memory.current` (v2) / `memory.usage_in_bytes` (v1). Always known. */
14144
+ currentBytes: number(),
14145
+ /** The cgroup's ceiling. `null` = NO LIMIT — never a sentinel, never zero. */
14146
+ limitBytes: number().nullable(),
14147
+ /** Anonymous pages: the closest thing to "what the processes allocated". */
14148
+ anonBytes: number().nullable(),
14149
+ /** Page cache. Charged to the cgroup, owned by no process. */
14150
+ fileBytes: number().nullable(),
14151
+ /**
14152
+ * Shared memory — and the field that explained the largest single surprise.
14153
+ * The i915 driver backs GPU buffers with shmem, so an inference pool or a
14154
+ * hardware-decode session holding DRM objects is charged HERE and appears
14155
+ * nowhere in a `ps` scan.
14156
+ */
14157
+ shmemBytes: number().nullable(),
14158
+ /** Kernel slab charged to this cgroup. `null` on v1, which never publishes it. */
14159
+ slabBytes: number().nullable(),
14160
+ /**
14161
+ * Shrinkable i915 GEM object bytes, from debugfs.
14162
+ *
14163
+ * **Host-wide across every DRM client, NOT cgroup-scoped.** It is not a
14164
+ * component of `currentBytes` and must not be subtracted from it; it says
14165
+ * what put the shmem there, where `shmemBytes` only says how much.
14166
+ *
14167
+ * `null` wherever debugfs is not mounted — which is inside every camstack
14168
+ * container today — and on any node with no Intel GPU.
14169
+ */
14170
+ gpuShmemBytes: number().nullable()
14171
+ }).extend({ atMs: number() });
14128
14172
  var DumpHeapSnapshotInputSchema = object({
14129
14173
  /** The addon whose runner should dump a heap snapshot. */
14130
14174
  addonId: string() });
@@ -14188,6 +14232,21 @@ var NodeLoadSeriesSchema = object({
14188
14232
  /** One entry per function seen in the window, heaviest-first. */
14189
14233
  series: array(LoadFunctionSeriesSchema).readonly(),
14190
14234
  /**
14235
+ * The CONTAINER's memory over the same window, oldest-first.
14236
+ *
14237
+ * Sits next to `series` rather than in a method of its own because the whole
14238
+ * question is a subtraction: the per-process rows in `series` sum to one
14239
+ * number and this one is another, and an operator who has to issue two calls
14240
+ * to compare them will compare two different instants. Same reader, same
14241
+ * `sinceMs`, same `bucketMs`, same timestamps.
14242
+ *
14243
+ * **EMPTY means ABSENT, never zero.** A node with no cgroup — a developer
14244
+ * Mac, a bare-metal host, a container with the hierarchy hidden — reports no
14245
+ * points at all. A zero here would be indistinguishable from a healthy
14246
+ * container and is precisely the lie this field exists to avoid.
14247
+ */
14248
+ containerMemory: array(ContainerMemoryPointSchema).readonly(),
14249
+ /**
14191
14250
  * Width of one returned bucket, in ms. Equals the sampling cadence when no
14192
14251
  * reduction was needed — so a caller can always say what one point covers
14193
14252
  * without having to know whether it was reduced.
@@ -27900,10 +27959,10 @@ DeviceType.Camera, DeviceType.Sensor, DeviceType.Switch, method(object({ deviceI
27900
27959
  * recording config. NOTE on events (source of truth, R5/C3): this cap carries
27901
27960
  * NO event surface — `getPlaybackManifest` returns playlist URLs only. Timeline
27902
27961
  * events (motion/object/audio) come from `pipelineAnalytics` (durable SQLite
27903
- * rows); the recorder's internal EventMap markers are ephemeral in-RAM
27904
- * annotations that are not exposed here and must not be treated as an event
27905
- * feed. Event<->footage joins are by time, padded with the shared `EVENT_PAD_MS`
27906
- * (`interfaces/recording-config.ts`).
27962
+ * rows) and are the ONLY event surface — the recorder has none. The in-RAM
27963
+ * playback markers it used to build were deleted on 2026-08-29 because nothing
27964
+ * ever read them. Event<->footage joins are by time, padded with the shared
27965
+ * `EVENT_PAD_MS` (`interfaces/recording-config.ts`).
27907
27966
  */
27908
27967
  var RecordingStatusSchema = object({
27909
27968
  deviceId: number(),
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@camstack/addon-import-alexa",
3
- "version": "0.2.38",
3
+ "version": "0.2.40",
4
4
  "description": "Alexa device-import provider for CamStack — imports the smart-home devices in a user's Alexa account via the unofficial alexa-remote2 cookie/token client (the inverse of the Alexa exporter)",
5
5
  "keywords": [
6
6
  "camstack",