@camstack/addon-decoder-nodeav 1.2.38 → 1.2.41

package/dist/index.js

@@ -13748,6 +13748,50 @@ var NodeProcessSchema = object({
 	/** Wall-clock uptime (seconds). Parsed from `ps etime`. */
 	uptimeSec: number()
 });
+/**
+* One retained container-memory reading.
+*
+* `atMs` is the timestamp of the PROCESS snapshot taken in the same tick, not
+* a second clock: that is what makes "processes sum to X, container says Y"
+* subtractable per point rather than an eyeballed comparison of two series
+* sampled at different instants.
+*
+* A reduced window keeps the sample with the LARGEST `currentBytes` in each
+* bucket, WHOLE. Taking a per-field maximum would synthesise a row whose parts
+* never coexisted, and a mean would smear away the peak this exists to find.
+*/
+var ContainerMemoryPointSchema = object({
+	/** Which hierarchy answered, so a reading is never ambiguous. */
+	source: _enum(["cgroup-v2", "cgroup-v1"]),
+	/** `memory.current` (v2) / `memory.usage_in_bytes` (v1). Always known. */
+	currentBytes: number(),
+	/** The cgroup's ceiling. `null` = NO LIMIT — never a sentinel, never zero. */
+	limitBytes: number().nullable(),
+	/** Anonymous pages: the closest thing to "what the processes allocated". */
+	anonBytes: number().nullable(),
+	/** Page cache. Charged to the cgroup, owned by no process. */
+	fileBytes: number().nullable(),
+	/**
+	* Shared memory — and the field that explained the largest single surprise.
+	* The i915 driver backs GPU buffers with shmem, so an inference pool or a
+	* hardware-decode session holding DRM objects is charged HERE and appears
+	* nowhere in a `ps` scan.
+	*/
+	shmemBytes: number().nullable(),
+	/** Kernel slab charged to this cgroup. `null` on v1, which never publishes it. */
+	slabBytes: number().nullable(),
+	/**
+	* Shrinkable i915 GEM object bytes, from debugfs.
+	*
+	* **Host-wide across every DRM client, NOT cgroup-scoped.** It is not a
+	* component of `currentBytes` and must not be subtracted from it; it says
+	* what put the shmem there, where `shmemBytes` only says how much.
+	*
+	* `null` wherever debugfs is not mounted — which is inside every camstack
+	* container today — and on any node with no Intel GPU.
+	*/
+	gpuShmemBytes: number().nullable()
+}).extend({ atMs: number() });
 var DumpHeapSnapshotInputSchema = object({ 
 /** The addon whose runner should dump a heap snapshot. */
 addonId: string() });
@@ -13811,6 +13855,21 @@ var NodeLoadSeriesSchema = object({
 	/** One entry per function seen in the window, heaviest-first. */
 	series: array(LoadFunctionSeriesSchema).readonly(),
 	/**
+	* The CONTAINER's memory over the same window, oldest-first.
+	*
+	* Sits next to `series` rather than in a method of its own because the whole
+	* question is a subtraction: the per-process rows in `series` sum to one
+	* number and this one is another, and an operator who has to issue two calls
+	* to compare them will compare two different instants. Same reader, same
+	* `sinceMs`, same `bucketMs`, same timestamps.
+	*
+	* **EMPTY means ABSENT, never zero.** A node with no cgroup — a developer
+	* Mac, a bare-metal host, a container with the hierarchy hidden — reports no
+	* points at all. A zero here would be indistinguishable from a healthy
+	* container and is precisely the lie this field exists to avoid.
+	*/
+	containerMemory: array(ContainerMemoryPointSchema).readonly(),
+	/**
 	* Width of one returned bucket, in ms. Equals the sampling cadence when no
 	* reduction was needed — so a caller can always say what one point covers
 	* without having to know whether it was reduced.
@@ -25740,10 +25799,10 @@ DeviceType.Camera, DeviceType.Sensor, DeviceType.Switch, method(object({ deviceI
 * recording config. NOTE on events (source of truth, R5/C3): this cap carries
 * NO event surface — `getPlaybackManifest` returns playlist URLs only. Timeline
 * events (motion/object/audio) come from `pipelineAnalytics` (durable SQLite
-* rows); the recorder's internal EventMap markers are ephemeral in-RAM
-* annotations that are not exposed here and must not be treated as an event
-* feed. Event<->footage joins are by time, padded with the shared `EVENT_PAD_MS`
-* (`interfaces/recording-config.ts`).
+* rows) and are the ONLY event surface — the recorder has none. The in-RAM
+* playback markers it used to build were deleted on 2026-08-29 because nothing
+* ever read them. Event<->footage joins are by time, padded with the shared
+* `EVENT_PAD_MS` (`interfaces/recording-config.ts`).
 */
 var RecordingStatusSchema = object({
 	deviceId: number(),
@@ -37390,7 +37449,19 @@ function resolveAudioCodecAlias(codec) {
 /**
 * Supported codec matrix. `aac_latm` / `mpeg4-generic` are decode-only (they
 * exist only as camera-side inbound streams; the intercom back-channel encodes
-* plain `aac`). Kept byte-for-byte in step with the ffmpeg addon's catalogue.
+* plain `aac`). Kept byte-for-byte in step with the ffmpeg addon's catalogue —
+* `scripts/check-audio-codec-catalog-parity.ts` refuses a commit that drifts
+* one without the other.
+*
+* `pcm_s16le` / `pcm_f32le` are LINEAR PCM, and they are here for exactly one
+* reason: a `{pcm_s16le, 22050 → 8000, s16le}` DECODE session is a pure
+* libswresample rate conversion, which is what an intercom provider needs when
+* a HomeKit / Alexa / TTS caller pushes raw PCM at a rate the camera does not
+* speak. Without them the provider had nothing to call and dropped the frame
+* (D281). They are ENCODE-capable too so the pairing stays symmetric: an
+* encode session whose codec is linear PCM is the same swr pass with the
+* codec stage as a no-op, and a half-populated matrix is how the two backends
+* come to disagree about what `canHandle` means.
 */
 var CODEC_CATALOG = [
 	{
@@ -37405,6 +37476,18 @@ var CODEC_CATALOG = [
 		canEncode: true,
 		label: "PCM A-law (G.711)"
 	},
+	{
+		codec: "pcm_s16le",
+		canDecode: true,
+		canEncode: true,
+		label: "PCM signed 16-bit LE"
+	},
+	{
+		codec: "pcm_f32le",
+		canDecode: true,
+		canEncode: true,
+		label: "PCM float 32-bit LE"
+	},
 	{
 		codec: "g722",
 		canDecode: true,
@@ -37460,6 +37543,8 @@ function resolveCodecKey(codec) {
 		case "opus": return "opus";
 		case "pcm_alaw": return "pcm_alaw";
 		case "pcm_mulaw": return "pcm_mulaw";
+		case "pcm_s16le": return "pcm_s16le";
+		case "pcm_f32le": return "pcm_f32le";
 		case "g722": return "g722";
 		default: return null;
 	}
@@ -37469,7 +37554,9 @@ function resolveCodecKey(codec) {
 /**
 * Resolve a codec name to its branded libav `AVCodecID` using the real
 * constants. Returns `null` for names outside this addon's matrix. G.722 maps
-* to `AV_CODEC_ID_ADPCM_G722` (there is no plain `AV_CODEC_ID_G722`).
+* to `AV_CODEC_ID_ADPCM_G722` (there is no plain `AV_CODEC_ID_G722`); linear
+* PCM has no naming oddity — `AV_CODEC_ID_PCM_S16LE` / `AV_CODEC_ID_PCM_F32LE`
+* exist on node-av's constants object under exactly those names.
 */
 function resolveAvCodecId(codec, consts) {
 	switch (resolveCodecKey(codec)) {
@@ -37478,6 +37565,8 @@ function resolveAvCodecId(codec, consts) {
 		case "opus": return consts.AV_CODEC_ID_OPUS;
 		case "pcm_alaw": return consts.AV_CODEC_ID_PCM_ALAW;
 		case "pcm_mulaw": return consts.AV_CODEC_ID_PCM_MULAW;
+		case "pcm_s16le": return consts.AV_CODEC_ID_PCM_S16LE;
+		case "pcm_f32le": return consts.AV_CODEC_ID_PCM_F32LE;
 		case "g722": return consts.AV_CODEC_ID_ADPCM_G722;
 		case null: return null;
 	}

package/dist/index.mjs

@@ -13744,6 +13744,50 @@ var NodeProcessSchema = object({
 	/** Wall-clock uptime (seconds). Parsed from `ps etime`. */
 	uptimeSec: number()
 });
+/**
+* One retained container-memory reading.
+*
+* `atMs` is the timestamp of the PROCESS snapshot taken in the same tick, not
+* a second clock: that is what makes "processes sum to X, container says Y"
+* subtractable per point rather than an eyeballed comparison of two series
+* sampled at different instants.
+*
+* A reduced window keeps the sample with the LARGEST `currentBytes` in each
+* bucket, WHOLE. Taking a per-field maximum would synthesise a row whose parts
+* never coexisted, and a mean would smear away the peak this exists to find.
+*/
+var ContainerMemoryPointSchema = object({
+	/** Which hierarchy answered, so a reading is never ambiguous. */
+	source: _enum(["cgroup-v2", "cgroup-v1"]),
+	/** `memory.current` (v2) / `memory.usage_in_bytes` (v1). Always known. */
+	currentBytes: number(),
+	/** The cgroup's ceiling. `null` = NO LIMIT — never a sentinel, never zero. */
+	limitBytes: number().nullable(),
+	/** Anonymous pages: the closest thing to "what the processes allocated". */
+	anonBytes: number().nullable(),
+	/** Page cache. Charged to the cgroup, owned by no process. */
+	fileBytes: number().nullable(),
+	/**
+	* Shared memory — and the field that explained the largest single surprise.
+	* The i915 driver backs GPU buffers with shmem, so an inference pool or a
+	* hardware-decode session holding DRM objects is charged HERE and appears
+	* nowhere in a `ps` scan.
+	*/
+	shmemBytes: number().nullable(),
+	/** Kernel slab charged to this cgroup. `null` on v1, which never publishes it. */
+	slabBytes: number().nullable(),
+	/**
+	* Shrinkable i915 GEM object bytes, from debugfs.
+	*
+	* **Host-wide across every DRM client, NOT cgroup-scoped.** It is not a
+	* component of `currentBytes` and must not be subtracted from it; it says
+	* what put the shmem there, where `shmemBytes` only says how much.
+	*
+	* `null` wherever debugfs is not mounted — which is inside every camstack
+	* container today — and on any node with no Intel GPU.
+	*/
+	gpuShmemBytes: number().nullable()
+}).extend({ atMs: number() });
 var DumpHeapSnapshotInputSchema = object({ 
 /** The addon whose runner should dump a heap snapshot. */
 addonId: string() });
@@ -13807,6 +13851,21 @@ var NodeLoadSeriesSchema = object({
 	/** One entry per function seen in the window, heaviest-first. */
 	series: array(LoadFunctionSeriesSchema).readonly(),
 	/**
+	* The CONTAINER's memory over the same window, oldest-first.
+	*
+	* Sits next to `series` rather than in a method of its own because the whole
+	* question is a subtraction: the per-process rows in `series` sum to one
+	* number and this one is another, and an operator who has to issue two calls
+	* to compare them will compare two different instants. Same reader, same
+	* `sinceMs`, same `bucketMs`, same timestamps.
+	*
+	* **EMPTY means ABSENT, never zero.** A node with no cgroup — a developer
+	* Mac, a bare-metal host, a container with the hierarchy hidden — reports no
+	* points at all. A zero here would be indistinguishable from a healthy
+	* container and is precisely the lie this field exists to avoid.
+	*/
+	containerMemory: array(ContainerMemoryPointSchema).readonly(),
+	/**
 	* Width of one returned bucket, in ms. Equals the sampling cadence when no
 	* reduction was needed — so a caller can always say what one point covers
 	* without having to know whether it was reduced.
@@ -25736,10 +25795,10 @@ DeviceType.Camera, DeviceType.Sensor, DeviceType.Switch, method(object({ deviceI
 * recording config. NOTE on events (source of truth, R5/C3): this cap carries
 * NO event surface — `getPlaybackManifest` returns playlist URLs only. Timeline
 * events (motion/object/audio) come from `pipelineAnalytics` (durable SQLite
-* rows); the recorder's internal EventMap markers are ephemeral in-RAM
-* annotations that are not exposed here and must not be treated as an event
-* feed. Event<->footage joins are by time, padded with the shared `EVENT_PAD_MS`
-* (`interfaces/recording-config.ts`).
+* rows) and are the ONLY event surface — the recorder has none. The in-RAM
+* playback markers it used to build were deleted on 2026-08-29 because nothing
+* ever read them. Event<->footage joins are by time, padded with the shared
+* `EVENT_PAD_MS` (`interfaces/recording-config.ts`).
 */
 var RecordingStatusSchema = object({
 	deviceId: number(),
@@ -37386,7 +37445,19 @@ function resolveAudioCodecAlias(codec) {
 /**
 * Supported codec matrix. `aac_latm` / `mpeg4-generic` are decode-only (they
 * exist only as camera-side inbound streams; the intercom back-channel encodes
-* plain `aac`). Kept byte-for-byte in step with the ffmpeg addon's catalogue.
+* plain `aac`). Kept byte-for-byte in step with the ffmpeg addon's catalogue —
+* `scripts/check-audio-codec-catalog-parity.ts` refuses a commit that drifts
+* one without the other.
+*
+* `pcm_s16le` / `pcm_f32le` are LINEAR PCM, and they are here for exactly one
+* reason: a `{pcm_s16le, 22050 → 8000, s16le}` DECODE session is a pure
+* libswresample rate conversion, which is what an intercom provider needs when
+* a HomeKit / Alexa / TTS caller pushes raw PCM at a rate the camera does not
+* speak. Without them the provider had nothing to call and dropped the frame
+* (D281). They are ENCODE-capable too so the pairing stays symmetric: an
+* encode session whose codec is linear PCM is the same swr pass with the
+* codec stage as a no-op, and a half-populated matrix is how the two backends
+* come to disagree about what `canHandle` means.
 */
 var CODEC_CATALOG = [
 	{
@@ -37401,6 +37472,18 @@ var CODEC_CATALOG = [
 		canEncode: true,
 		label: "PCM A-law (G.711)"
 	},
+	{
+		codec: "pcm_s16le",
+		canDecode: true,
+		canEncode: true,
+		label: "PCM signed 16-bit LE"
+	},
+	{
+		codec: "pcm_f32le",
+		canDecode: true,
+		canEncode: true,
+		label: "PCM float 32-bit LE"
+	},
 	{
 		codec: "g722",
 		canDecode: true,
@@ -37456,6 +37539,8 @@ function resolveCodecKey(codec) {
 		case "opus": return "opus";
 		case "pcm_alaw": return "pcm_alaw";
 		case "pcm_mulaw": return "pcm_mulaw";
+		case "pcm_s16le": return "pcm_s16le";
+		case "pcm_f32le": return "pcm_f32le";
 		case "g722": return "g722";
 		default: return null;
 	}
@@ -37465,7 +37550,9 @@ function resolveCodecKey(codec) {
 /**
 * Resolve a codec name to its branded libav `AVCodecID` using the real
 * constants. Returns `null` for names outside this addon's matrix. G.722 maps
-* to `AV_CODEC_ID_ADPCM_G722` (there is no plain `AV_CODEC_ID_G722`).
+* to `AV_CODEC_ID_ADPCM_G722` (there is no plain `AV_CODEC_ID_G722`); linear
+* PCM has no naming oddity — `AV_CODEC_ID_PCM_S16LE` / `AV_CODEC_ID_PCM_F32LE`
+* exist on node-av's constants object under exactly those names.
 */
 function resolveAvCodecId(codec, consts) {
 	switch (resolveCodecKey(codec)) {
@@ -37474,6 +37561,8 @@ function resolveAvCodecId(codec, consts) {
 		case "opus": return consts.AV_CODEC_ID_OPUS;
 		case "pcm_alaw": return consts.AV_CODEC_ID_PCM_ALAW;
 		case "pcm_mulaw": return consts.AV_CODEC_ID_PCM_MULAW;
+		case "pcm_s16le": return consts.AV_CODEC_ID_PCM_S16LE;
+		case "pcm_f32le": return consts.AV_CODEC_ID_PCM_F32LE;
 		case "g722": return consts.AV_CODEC_ID_ADPCM_G722;
 		case null: return null;
 	}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/addon-decoder-nodeav",
-  "version": "1.2.38",
+  "version": "1.2.41",
   "description": "Standalone in-process node-av decoder addon for CamStack",
   "keywords": [
     "camstack",