@camstack/addon-pipeline 1.2.218 → 1.2.220

package/dist/stream-broker/index.js

@@ -2,26 +2,27 @@ Object.defineProperties(exports, {
 	__esModule: { value: true },
 	[Symbol.toStringTag]: { value: "Module" }
 });
-const require_dist = require("../dist-BbvtiBNc.js");
-const require_node = require("../node-CbCVHEvJ.js");
+const require_chunk = require("../chunk-emK7D4bc.js");
+const require_dist = require("../dist-ByPsWlTa.js");
+const require_node = require("../node-CNPnaux4.js");
 const require_restream_intent = require("../restream-intent-B1Difcnq.js");
 const require_remote_restream = require("../remote-restream-CO36Sr30.js");
 const require_retire_root_keys = require("../retire-root-keys-Csb8z2f3.js");
-const require_segment_demux_js = require("../segment-demux-js-D7bjzY8M.js");
+const require_segment_demux_js = require("../segment-demux-js-CZefXDLx.js");
 let node_os = require("node:os");
-node_os = require_dist.__toESM(node_os);
+node_os = require_chunk.__toESM(node_os);
 let node_crypto = require("node:crypto");
-node_crypto = require_dist.__toESM(node_crypto);
+node_crypto = require_chunk.__toESM(node_crypto);
 let node_fs = require("node:fs");
-node_fs = require_dist.__toESM(node_fs);
+node_fs = require_chunk.__toESM(node_fs);
 let node_path = require("node:path");
-node_path = require_dist.__toESM(node_path);
+node_path = require_chunk.__toESM(node_path);
 let node_child_process = require("node:child_process");
 let node_fs_promises = require("node:fs/promises");
 let node_url = require("node:url");
 let node_module = require("node:module");
 let node_net = require("node:net");
-node_net = require_dist.__toESM(node_net);
+node_net = require_chunk.__toESM(node_net);
 let node_dgram = require("node:dgram");
 let events = require("events");
 let net = require("net");
@@ -8380,14 +8381,14 @@ function depacketizeRfc3640(payload, opts = {
 }
 //#endregion
 //#region src/stream-broker/rtsp/audio-rtp-decoder.ts
-/** Target sample rate for decoded audio (matches ffmpeg path). */
-var TARGET_SAMPLE_RATE = 16e3;
-var CHUNK_SAMPLES = TARGET_SAMPLE_RATE * 500 / 1e3;
+/** G.711 is 8 kHz by definition (RFC 3551): the plane carries that rate. */
+var G711_SAMPLE_RATE = 8e3;
+var CHUNK_SAMPLES = G711_SAMPLE_RATE * 500 / 1e3;
 /**
-* Decodes G.711 audio RTP packets into PCM f32le chunks.
+* Decodes G.711 audio RTP packets into PCM f32le chunks at 8 kHz.
 *
-* Buffers decoded samples and emits DecodedAudioChunk when enough
-* samples accumulate (~0.5s), matching the ffmpeg audio output cadence.
+* Buffers decoded samples and emits a DecodedAudioChunk when ~0.5 s has
+* accumulated (4000 samples, 16 000 bytes).
 */
 var AudioRtpDecoder = class {
 	codec;
@@ -8401,18 +8402,14 @@ var AudioRtpDecoder = class {
 	}
 	/**
 	* Process a raw RTP packet (header + payload).
-	* Strips the 12-byte RTP header, decodes G.711 payload, upsamples 8→16kHz.
+	* Strips the 12-byte RTP header and decodes the G.711 payload: one byte,
+	* one 8 kHz sample. Nothing is interpolated here.
 	*/
 	processPacket(rtpData) {
 		if (rtpData.length <= 12) return;
 		const payload = rtpData.subarray(12);
 		const decode = this.codec === "PCMU" ? decodeUlaw : decodeAlaw;
-		for (let i = 0; i < payload.length; i++) {
-			const current = decode(payload[i]);
-			const next = i + 1 < payload.length ? decode(payload[i + 1]) : current;
-			this.pushSample(current);
-			this.pushSample((current + next) * .5);
-		}
+		for (let i = 0; i < payload.length; i++) this.pushSample(decode(payload[i]));
 	}
 	/** Flush any remaining buffered samples as a partial chunk. */
 	flush() {
@@ -8420,7 +8417,7 @@ var AudioRtpDecoder = class {
 		const data = Buffer.from(this.buffer.buffer, this.buffer.byteOffset, this.bufferOffset * 4);
 		this.onChunk({
 			data: Buffer.from(data),
-			sampleRate: TARGET_SAMPLE_RATE,
+			sampleRate: G711_SAMPLE_RATE,
 			channels: 1,
 			timestamp: Date.now()
 		});
@@ -8436,7 +8433,7 @@ var AudioRtpDecoder = class {
 			const data = Buffer.from(this.buffer.buffer, this.buffer.byteOffset, CHUNK_SAMPLES * 4);
 			this.onChunk({
 				data: Buffer.from(data),
-				sampleRate: TARGET_SAMPLE_RATE,
+				sampleRate: G711_SAMPLE_RATE,
 				channels: 1,
 				timestamp: Date.now()
 			});
@@ -13694,7 +13691,9 @@ var StreamBroker = class StreamBroker {
 					this.logger?.info("native: audio decoder initialized", { meta: {
 						codec: codecUpper,
 						sampleRate: audioTrack.clockRate,
-						channels: audioTrack.channels
+						channels: audioTrack.channels,
+						planeSampleRate: G711_SAMPLE_RATE,
+						planeFormat: "f32le"
 					} });
 				} else if (this.audioCodecApi) {
 					const capCfg = this.buildAudioCodecSessionConfig(audioTrack);
@@ -27485,7 +27484,7 @@ async function demuxSegmentToPcmu(bytes, ffmpegPath = "ffmpeg") {
 }
 //#endregion
 //#region src/stream-broker/recorded/segment-audio-js.ts
-var import_mp4box_all = /* @__PURE__ */ require_dist.__toESM(require_segment_demux_js.require_mp4box_all());
+var import_mp4box_all = /* @__PURE__ */ require_chunk.__toESM(require_segment_demux_js.require_mp4box_all());
 /** True for an mp4box audio codec string that is Opus (`Opus`/`opus`). */
 function isOpusCodec(codec) {
 	return /^opus$/i.test(codec);

package/dist/stream-broker/index.mjs

@@ -1,10 +1,10 @@
 import { r as __toESM } from "../chunk-DnnnRqeS.mjs";
-import { A as addonWidgetsSourceCapability, Bt as invocationFromEncodeProfile, C as RATE_CONTROL_RELAXED, F as cameraStreamsCapability, Ft as webrtcSessionCapability, Gt as DeviceFeature, H as deriveBatteryPresence, Ht as BOOT_RECOVERY_BACKOFF_MS, I as createHwAccelCache, It as errMsg, K as egressTranscodeSharingKey, Kt as DeviceType, L as createLogChannelsProvider, Lt as AUDIO_PRESETS, Mt as streamBrokerCapability, O as RingBuffer, P as batteryCapability, Qt as nodePin, Tt as resolveEgressDecodeHwAccel, Ut as BaseAddon, Vt as isSoftwareDecode, Wt as CAM_PROFILE_ORDER, Xt as makeProfileBrokerId, Yt as isEvent, Zt as makeSourceBrokerId, an as boolean, at as logChannelsCapability, cn as literal, en as parseProfileBrokerId, fn as record, h as EncodeProfileSchema, hn as EventCategory, i as BatteryStatusSchema, in as array, it as loadContributionCapability, ln as number, mn as union, on as discriminatedUnion, pn as string, q as egressTransportFromRequest, qt as createEvent, rn as _enum, st as maskUrlCredentials, un as object, w as RATE_CONTROL_TIGHT, z as declareLogChannel, zt as buildFfmpegArgs$1 } from "../dist-Dl6GntEh.mjs";
-import { i as NO_COST_CLAIM, n as Fmp4FragmentChild, r as Fmp4FragmentPlane, t as ChildCostRegistry } from "../node-CEyw52D2.mjs";
+import { A as addonWidgetsSourceCapability, Bt as invocationFromEncodeProfile, C as RATE_CONTROL_RELAXED, F as cameraStreamsCapability, Ft as webrtcSessionCapability, Gt as DeviceFeature, H as deriveBatteryPresence, Ht as BOOT_RECOVERY_BACKOFF_MS, I as createHwAccelCache, It as errMsg, K as egressTranscodeSharingKey, Kt as DeviceType, L as createLogChannelsProvider, Lt as AUDIO_PRESETS, Mt as streamBrokerCapability, O as RingBuffer, P as batteryCapability, Qt as nodePin, Tt as resolveEgressDecodeHwAccel, Ut as BaseAddon, Vt as isSoftwareDecode, Wt as CAM_PROFILE_ORDER, Xt as makeProfileBrokerId, Yt as isEvent, Zt as makeSourceBrokerId, an as boolean, at as logChannelsCapability, cn as literal, en as parseProfileBrokerId, fn as record, h as EncodeProfileSchema, hn as EventCategory, i as BatteryStatusSchema, in as array, it as loadContributionCapability, ln as number, mn as union, on as discriminatedUnion, pn as string, q as egressTransportFromRequest, qt as createEvent, rn as _enum, st as maskUrlCredentials, un as object, w as RATE_CONTROL_TIGHT, z as declareLogChannel, zt as buildFfmpegArgs$1 } from "../dist-ClihWGOZ.mjs";
+import { i as NO_COST_CLAIM, n as Fmp4FragmentChild, r as Fmp4FragmentPlane, t as ChildCostRegistry } from "../node-DiaTmz84.mjs";
 import { c as PREBUFFER_MAX_MS, d as resolvePrebuffer, i as parseRestreamPath, l as capPreRollRequestMs, n as NO_DECLARATION, u as prebufferRetentionMs } from "../restream-intent-DWe2kInY.mjs";
 import { n as profileForStreamId } from "../remote-restream-BeHi78PZ.mjs";
 import { n as RowMapStore, t as retireRootKeys } from "../retire-root-keys-DZvlso2l.mjs";
-import { i as require_mp4box_all, n as demuxSegmentPreferJs, r as runFfmpegOnce, t as demuxSegmentFullJs } from "../segment-demux-js-B278aBtB.mjs";
+import { i as require_mp4box_all, n as demuxSegmentPreferJs, r as runFfmpegOnce, t as demuxSegmentFullJs } from "../segment-demux-js-CFFXVae4.mjs";
 import { createRequire } from "node:module";
 import * as os from "node:os";
 import { networkInterfaces, tmpdir } from "node:os";
@@ -8377,14 +8377,14 @@ function depacketizeRfc3640(payload, opts = {
 }
 //#endregion
 //#region src/stream-broker/rtsp/audio-rtp-decoder.ts
-/** Target sample rate for decoded audio (matches ffmpeg path). */
-var TARGET_SAMPLE_RATE = 16e3;
-var CHUNK_SAMPLES = TARGET_SAMPLE_RATE * 500 / 1e3;
+/** G.711 is 8 kHz by definition (RFC 3551): the plane carries that rate. */
+var G711_SAMPLE_RATE = 8e3;
+var CHUNK_SAMPLES = G711_SAMPLE_RATE * 500 / 1e3;
 /**
-* Decodes G.711 audio RTP packets into PCM f32le chunks.
+* Decodes G.711 audio RTP packets into PCM f32le chunks at 8 kHz.
 *
-* Buffers decoded samples and emits DecodedAudioChunk when enough
-* samples accumulate (~0.5s), matching the ffmpeg audio output cadence.
+* Buffers decoded samples and emits a DecodedAudioChunk when ~0.5 s has
+* accumulated (4000 samples, 16 000 bytes).
 */
 var AudioRtpDecoder = class {
 	codec;
@@ -8398,18 +8398,14 @@ var AudioRtpDecoder = class {
 	}
 	/**
 	* Process a raw RTP packet (header + payload).
-	* Strips the 12-byte RTP header, decodes G.711 payload, upsamples 8→16kHz.
+	* Strips the 12-byte RTP header and decodes the G.711 payload: one byte,
+	* one 8 kHz sample. Nothing is interpolated here.
 	*/
 	processPacket(rtpData) {
 		if (rtpData.length <= 12) return;
 		const payload = rtpData.subarray(12);
 		const decode = this.codec === "PCMU" ? decodeUlaw : decodeAlaw;
-		for (let i = 0; i < payload.length; i++) {
-			const current = decode(payload[i]);
-			const next = i + 1 < payload.length ? decode(payload[i + 1]) : current;
-			this.pushSample(current);
-			this.pushSample((current + next) * .5);
-		}
+		for (let i = 0; i < payload.length; i++) this.pushSample(decode(payload[i]));
 	}
 	/** Flush any remaining buffered samples as a partial chunk. */
 	flush() {
@@ -8417,7 +8413,7 @@ var AudioRtpDecoder = class {
 		const data = Buffer.from(this.buffer.buffer, this.buffer.byteOffset, this.bufferOffset * 4);
 		this.onChunk({
 			data: Buffer.from(data),
-			sampleRate: TARGET_SAMPLE_RATE,
+			sampleRate: G711_SAMPLE_RATE,
 			channels: 1,
 			timestamp: Date.now()
 		});
@@ -8433,7 +8429,7 @@ var AudioRtpDecoder = class {
 			const data = Buffer.from(this.buffer.buffer, this.buffer.byteOffset, CHUNK_SAMPLES * 4);
 			this.onChunk({
 				data: Buffer.from(data),
-				sampleRate: TARGET_SAMPLE_RATE,
+				sampleRate: G711_SAMPLE_RATE,
 				channels: 1,
 				timestamp: Date.now()
 			});
@@ -13691,7 +13687,9 @@ var StreamBroker = class StreamBroker {
 					this.logger?.info("native: audio decoder initialized", { meta: {
 						codec: codecUpper,
 						sampleRate: audioTrack.clockRate,
-						channels: audioTrack.channels
+						channels: audioTrack.channels,
+						planeSampleRate: G711_SAMPLE_RATE,
+						planeFormat: "f32le"
 					} });
 				} else if (this.audioCodecApi) {
 					const capCfg = this.buildAudioCodecSessionConfig(audioTrack);

package/dist/stream-broker/remoteEntry.js

@@ -30,7 +30,7 @@ async function d(e) {
 	}
 }
 async function f() {
-	return l ||= d(() => import("./_virtual_mf-localSharedImportMap___mfe_internal__addon_stream_broker_widgets-BnmbfnAd.mjs")).catch((e) => {
+	return l ||= d(() => import("./_virtual_mf-localSharedImportMap___mfe_internal__addon_stream_broker_widgets-CtdpN7Sz.mjs")).catch((e) => {
 		throw l = void 0, e;
 	}), l;
 }

package/dist/worker-protocol-B2MfQLlu.js

@@ -0,0 +1,184 @@
+//#region src/session-decode/native-lease-knobs.ts
+/** Every knob, in the order the spawn line names them. */
+var NATIVE_LEASE_KNOB_NAMES = [
+	"holdFrames",
+	"budgetMb",
+	"activityMs",
+	"admission",
+	"tileBudgetMb",
+	"sceneBudgetMb"
+];
+/** The numeric knobs — every knob but `admission`. */
+var NATIVE_LEASE_NUMBER_KNOBS = [
+	"holdFrames",
+	"budgetMb",
+	"activityMs",
+	"tileBudgetMb",
+	"sceneBudgetMb"
+];
+var KNOB_SOURCES = [
+	"setting",
+	"env",
+	"default"
+];
+function isRecord$1(value) {
+	return typeof value === "object" && value !== null;
+}
+function isNonNegativeInteger(value) {
+	return typeof value === "number" && Number.isInteger(value) && value >= 0;
+}
+function isAdmission(value) {
+	return value === "all" || value === "inferred";
+}
+function isKnobSource(value) {
+	return typeof value === "string" && KNOB_SOURCES.some((s) => s === value);
+}
+/**
+* Shape guard for the wire. The parent already bounded every value through the
+* knob's own Zod schema; what is checked here is what a store constructor would
+* otherwise turn into a silent misconfiguration — a non-integer, a negative
+* budget, a hold of zero (a worker that holds nothing can crop nothing), an
+* admission word that is neither mode, a source that names no level.
+*/
+function isWorkerLeaseKnobs(value) {
+	if (!isRecord$1(value) || !isRecord$1(value.values) || !isRecord$1(value.sources)) return false;
+	const { values, sources } = value;
+	for (const knob of NATIVE_LEASE_NUMBER_KNOBS) if (!isNonNegativeInteger(values[knob])) return false;
+	if (!isNonNegativeInteger(values.holdFrames) || values.holdFrames < 1) return false;
+	if (!isAdmission(values.admission)) return false;
+	return NATIVE_LEASE_KNOB_NAMES.every((knob) => isKnobSource(sources[knob]));
+}
+/**
+* The one-line spawn diagnostic. Names the effective value AND its source for
+* every knob: without the source, a log saying `holdFrames=8` cannot distinguish
+* "the operator's setting arrived" from "someone left a shell variable set", and
+* a setting that silently fails to arrive is exactly the failure the source
+* field exists to make visible.
+*/
+function formatNativeLeaseKnobs(resolved) {
+	const part = (knob) => `${knob}=${resolved.values[knob]} source=${resolved.sources[knob]}`;
+	return `native lease knobs — ${NATIVE_LEASE_KNOB_NAMES.map(part).join("; ")}`;
+}
+//#endregion
+//#region src/session-decode/worker-protocol.ts
+/**
+* Typed IPC protocol between the per-session decode coordinator (Task 3 —
+* `child_process.fork`s the worker) and the decode-worker child
+* (`decode-worker-child.ts`, Task 2). Pure module: no node-av, no
+* `process.on`/`process.send` here — those live in `decode-worker-child.ts`,
+* which documents why raw IPC is sanctioned for that file.
+*
+* The protocol is a request/response pull: the parent asks for the next
+* frame (`pull`), gets back metadata + an opaque `frameId`, then asks for
+* pixel bytes for that id with an optional ROI (`toBuffer`). No shared
+* memory, no `/dev/shm` — frames travel as IPC messages only.
+*/
+/**
+* Classify a worker diagnostic line into a {@link WorkerLogLevel}. Failure /
+* fault lines surface at `warn` (visible at the default log level so a
+* native-crop failure is finally seen in `addons.getLogs`); routine
+* provenance / transition / lifecycle lines stay `debug`. Pure + exported so
+* the mapping is unit-testable without spawning a worker.
+*/
+function logLevelForLine(line) {
+	return /\b(fail(?:ed|ure)?|error|exception|unhandled rejection|corrupt|EIO|EINVAL)\b/i.test(line) ? "warn" : "debug";
+}
+function isRecord(value) {
+	return typeof value === "object" && value !== null;
+}
+function isFiniteNumber(value) {
+	return typeof value === "number" && Number.isFinite(value);
+}
+function isWorkerFrameFormat(value) {
+	return value === "rgb" || value === "gray";
+}
+function isWorkerBufferFormat(value) {
+	return isWorkerFrameFormat(value) || value === "jpeg";
+}
+function isWorkerLogLevel(value) {
+	return value === "debug" || value === "info" || value === "warn" || value === "error";
+}
+function isWorkerCropRegion(value) {
+	return isRecord(value) && isFiniteNumber(value.left) && isFiniteNumber(value.top) && isFiniteNumber(value.width) && isFiniteNumber(value.height);
+}
+function isWorkerResizeTarget(value) {
+	return isRecord(value) && isFiniteNumber(value.width) && isFiniteNumber(value.height);
+}
+function isFrameImageOptions(value) {
+	if (!isRecord(value)) return false;
+	if (value.crop !== void 0 && !isWorkerCropRegion(value.crop)) return false;
+	if (value.resize !== void 0 && !isWorkerResizeTarget(value.resize)) return false;
+	if (value.format !== void 0 && !isWorkerBufferFormat(value.format)) return false;
+	return true;
+}
+function isNormalizedBbox(value) {
+	return isRecord(value) && isFiniteNumber(value.x) && isFiniteNumber(value.y) && isFiniteNumber(value.w) && isFiniteNumber(value.h);
+}
+function isVideoFrameSource(value) {
+	return isRecord(value) && typeof value.restreamUrl === "string" && isFiniteNumber(value.deviceId) && typeof value.codec === "string";
+}
+function isVideoFrameGenOptions(value) {
+	if (!isRecord(value)) return false;
+	if (value.fps !== void 0 && !isFiniteNumber(value.fps)) return false;
+	if (value.format !== void 0 && !isWorkerFrameFormat(value.format)) return false;
+	if (value.preRollMs !== void 0 && !isFiniteNumber(value.preRollMs)) return false;
+	if (value.preRollMaxFrames !== void 0 && !isFiniteNumber(value.preRollMaxFrames)) return false;
+	return true;
+}
+/** Discriminated-union guard for {@link WorkerRequest} — no `as` casts. */
+function isWorkerRequest(value) {
+	if (!isRecord(value)) return false;
+	switch (value.kind) {
+		case "start": return isVideoFrameSource(value.source) && isVideoFrameGenOptions(value.opts) && isWorkerLeaseKnobs(value.lease);
+		case "pull": return true;
+		case "toBuffer": return isFiniteNumber(value.frameId) && (value.opts === void 0 || isFrameImageOptions(value.opts));
+		case "nativeCrop": return isFiniteNumber(value.requestId) && isFiniteNumber(value.frameId) && isNormalizedBbox(value.bbox) && (value.maxWidth === void 0 || isFiniteNumber(value.maxWidth));
+		case "cutTiles": return isFiniteNumber(value.frameId) && Array.isArray(value.bboxes) && value.bboxes.every(isNormalizedBbox);
+		case "releaseNativeLease":
+		case "markInferred": return isFiniteNumber(value.frameId);
+		case "stop": return true;
+		default: return false;
+	}
+}
+/** Discriminated-union guard for {@link WorkerReply} — no `as` casts. */
+function isWorkerReply(value) {
+	if (!isRecord(value)) return false;
+	switch (value.kind) {
+		case "frame": return isFiniteNumber(value.frameId) && isFiniteNumber(value.timestamp) && isFiniteNumber(value.width) && isFiniteNumber(value.height) && isWorkerFrameFormat(value.format) && (value.capturedAt === void 0 || isFiniteNumber(value.capturedAt)) && (value.preRoll === void 0 || typeof value.preRoll === "boolean");
+		case "buffer": return isFiniteNumber(value.frameId) && value.bytes instanceof Uint8Array;
+		case "nativeCropResult": return isFiniteNumber(value.requestId) && value.bytes instanceof Uint8Array && isFiniteNumber(value.width) && isFiniteNumber(value.height) && (value.source === void 0 || value.source === "lease" || value.source === "tile");
+		case "nativeCropMiss": return isFiniteNumber(value.requestId) && (value.reason === void 0 || typeof value.reason === "string");
+		case "ended": return true;
+		case "ready": return typeof value.warm === "boolean";
+		case "error": return typeof value.message === "string" && (value.frameId === void 0 || isFiniteNumber(value.frameId));
+		case "log": return isWorkerLogLevel(value.level) && typeof value.message === "string";
+		case "preRollReport": return isFiniteNumber(value.offered) && isFiniteNumber(value.inferred) && isFiniteNumber(value.dropped) && isRecord(value.droppedByReason) && isFiniteNumber(value.strideMs) && typeof value.subsampled === "boolean" && isFiniteNumber(value.spanMs);
+		case "dialTiming": return isFiniteNumber(value.hwContextMs) && isFiniteNumber(value.demuxerOpenMs) && isFiniteNumber(value.decoderCreateMs) && isFiniteNumber(value.firstDecodeMs) && typeof value.streamInfoProbed === "boolean";
+		default: return false;
+	}
+}
+//#endregion
+Object.defineProperty(exports, "formatNativeLeaseKnobs", {
+	enumerable: true,
+	get: function() {
+		return formatNativeLeaseKnobs;
+	}
+});
+Object.defineProperty(exports, "isWorkerReply", {
+	enumerable: true,
+	get: function() {
+		return isWorkerReply;
+	}
+});
+Object.defineProperty(exports, "isWorkerRequest", {
+	enumerable: true,
+	get: function() {
+		return isWorkerRequest;
+	}
+});
+Object.defineProperty(exports, "logLevelForLine", {
+	enumerable: true,
+	get: function() {
+		return logLevelForLine;
+	}
+});

package/dist/worker-protocol-C_W-P_g-.mjs

@@ -0,0 +1,161 @@
+//#region src/session-decode/native-lease-knobs.ts
+/** Every knob, in the order the spawn line names them. */
+var NATIVE_LEASE_KNOB_NAMES = [
+	"holdFrames",
+	"budgetMb",
+	"activityMs",
+	"admission",
+	"tileBudgetMb",
+	"sceneBudgetMb"
+];
+/** The numeric knobs — every knob but `admission`. */
+var NATIVE_LEASE_NUMBER_KNOBS = [
+	"holdFrames",
+	"budgetMb",
+	"activityMs",
+	"tileBudgetMb",
+	"sceneBudgetMb"
+];
+var KNOB_SOURCES = [
+	"setting",
+	"env",
+	"default"
+];
+function isRecord$1(value) {
+	return typeof value === "object" && value !== null;
+}
+function isNonNegativeInteger(value) {
+	return typeof value === "number" && Number.isInteger(value) && value >= 0;
+}
+function isAdmission(value) {
+	return value === "all" || value === "inferred";
+}
+function isKnobSource(value) {
+	return typeof value === "string" && KNOB_SOURCES.some((s) => s === value);
+}
+/**
+* Shape guard for the wire. The parent already bounded every value through the
+* knob's own Zod schema; what is checked here is what a store constructor would
+* otherwise turn into a silent misconfiguration — a non-integer, a negative
+* budget, a hold of zero (a worker that holds nothing can crop nothing), an
+* admission word that is neither mode, a source that names no level.
+*/
+function isWorkerLeaseKnobs(value) {
+	if (!isRecord$1(value) || !isRecord$1(value.values) || !isRecord$1(value.sources)) return false;
+	const { values, sources } = value;
+	for (const knob of NATIVE_LEASE_NUMBER_KNOBS) if (!isNonNegativeInteger(values[knob])) return false;
+	if (!isNonNegativeInteger(values.holdFrames) || values.holdFrames < 1) return false;
+	if (!isAdmission(values.admission)) return false;
+	return NATIVE_LEASE_KNOB_NAMES.every((knob) => isKnobSource(sources[knob]));
+}
+/**
+* The one-line spawn diagnostic. Names the effective value AND its source for
+* every knob: without the source, a log saying `holdFrames=8` cannot distinguish
+* "the operator's setting arrived" from "someone left a shell variable set", and
+* a setting that silently fails to arrive is exactly the failure the source
+* field exists to make visible.
+*/
+function formatNativeLeaseKnobs(resolved) {
+	const part = (knob) => `${knob}=${resolved.values[knob]} source=${resolved.sources[knob]}`;
+	return `native lease knobs — ${NATIVE_LEASE_KNOB_NAMES.map(part).join("; ")}`;
+}
+//#endregion
+//#region src/session-decode/worker-protocol.ts
+/**
+* Typed IPC protocol between the per-session decode coordinator (Task 3 —
+* `child_process.fork`s the worker) and the decode-worker child
+* (`decode-worker-child.ts`, Task 2). Pure module: no node-av, no
+* `process.on`/`process.send` here — those live in `decode-worker-child.ts`,
+* which documents why raw IPC is sanctioned for that file.
+*
+* The protocol is a request/response pull: the parent asks for the next
+* frame (`pull`), gets back metadata + an opaque `frameId`, then asks for
+* pixel bytes for that id with an optional ROI (`toBuffer`). No shared
+* memory, no `/dev/shm` — frames travel as IPC messages only.
+*/
+/**
+* Classify a worker diagnostic line into a {@link WorkerLogLevel}. Failure /
+* fault lines surface at `warn` (visible at the default log level so a
+* native-crop failure is finally seen in `addons.getLogs`); routine
+* provenance / transition / lifecycle lines stay `debug`. Pure + exported so
+* the mapping is unit-testable without spawning a worker.
+*/
+function logLevelForLine(line) {
+	return /\b(fail(?:ed|ure)?|error|exception|unhandled rejection|corrupt|EIO|EINVAL)\b/i.test(line) ? "warn" : "debug";
+}
+function isRecord(value) {
+	return typeof value === "object" && value !== null;
+}
+function isFiniteNumber(value) {
+	return typeof value === "number" && Number.isFinite(value);
+}
+function isWorkerFrameFormat(value) {
+	return value === "rgb" || value === "gray";
+}
+function isWorkerBufferFormat(value) {
+	return isWorkerFrameFormat(value) || value === "jpeg";
+}
+function isWorkerLogLevel(value) {
+	return value === "debug" || value === "info" || value === "warn" || value === "error";
+}
+function isWorkerCropRegion(value) {
+	return isRecord(value) && isFiniteNumber(value.left) && isFiniteNumber(value.top) && isFiniteNumber(value.width) && isFiniteNumber(value.height);
+}
+function isWorkerResizeTarget(value) {
+	return isRecord(value) && isFiniteNumber(value.width) && isFiniteNumber(value.height);
+}
+function isFrameImageOptions(value) {
+	if (!isRecord(value)) return false;
+	if (value.crop !== void 0 && !isWorkerCropRegion(value.crop)) return false;
+	if (value.resize !== void 0 && !isWorkerResizeTarget(value.resize)) return false;
+	if (value.format !== void 0 && !isWorkerBufferFormat(value.format)) return false;
+	return true;
+}
+function isNormalizedBbox(value) {
+	return isRecord(value) && isFiniteNumber(value.x) && isFiniteNumber(value.y) && isFiniteNumber(value.w) && isFiniteNumber(value.h);
+}
+function isVideoFrameSource(value) {
+	return isRecord(value) && typeof value.restreamUrl === "string" && isFiniteNumber(value.deviceId) && typeof value.codec === "string";
+}
+function isVideoFrameGenOptions(value) {
+	if (!isRecord(value)) return false;
+	if (value.fps !== void 0 && !isFiniteNumber(value.fps)) return false;
+	if (value.format !== void 0 && !isWorkerFrameFormat(value.format)) return false;
+	if (value.preRollMs !== void 0 && !isFiniteNumber(value.preRollMs)) return false;
+	if (value.preRollMaxFrames !== void 0 && !isFiniteNumber(value.preRollMaxFrames)) return false;
+	return true;
+}
+/** Discriminated-union guard for {@link WorkerRequest} — no `as` casts. */
+function isWorkerRequest(value) {
+	if (!isRecord(value)) return false;
+	switch (value.kind) {
+		case "start": return isVideoFrameSource(value.source) && isVideoFrameGenOptions(value.opts) && isWorkerLeaseKnobs(value.lease);
+		case "pull": return true;
+		case "toBuffer": return isFiniteNumber(value.frameId) && (value.opts === void 0 || isFrameImageOptions(value.opts));
+		case "nativeCrop": return isFiniteNumber(value.requestId) && isFiniteNumber(value.frameId) && isNormalizedBbox(value.bbox) && (value.maxWidth === void 0 || isFiniteNumber(value.maxWidth));
+		case "cutTiles": return isFiniteNumber(value.frameId) && Array.isArray(value.bboxes) && value.bboxes.every(isNormalizedBbox);
+		case "releaseNativeLease":
+		case "markInferred": return isFiniteNumber(value.frameId);
+		case "stop": return true;
+		default: return false;
+	}
+}
+/** Discriminated-union guard for {@link WorkerReply} — no `as` casts. */
+function isWorkerReply(value) {
+	if (!isRecord(value)) return false;
+	switch (value.kind) {
+		case "frame": return isFiniteNumber(value.frameId) && isFiniteNumber(value.timestamp) && isFiniteNumber(value.width) && isFiniteNumber(value.height) && isWorkerFrameFormat(value.format) && (value.capturedAt === void 0 || isFiniteNumber(value.capturedAt)) && (value.preRoll === void 0 || typeof value.preRoll === "boolean");
+		case "buffer": return isFiniteNumber(value.frameId) && value.bytes instanceof Uint8Array;
+		case "nativeCropResult": return isFiniteNumber(value.requestId) && value.bytes instanceof Uint8Array && isFiniteNumber(value.width) && isFiniteNumber(value.height) && (value.source === void 0 || value.source === "lease" || value.source === "tile");
+		case "nativeCropMiss": return isFiniteNumber(value.requestId) && (value.reason === void 0 || typeof value.reason === "string");
+		case "ended": return true;
+		case "ready": return typeof value.warm === "boolean";
+		case "error": return typeof value.message === "string" && (value.frameId === void 0 || isFiniteNumber(value.frameId));
+		case "log": return isWorkerLogLevel(value.level) && typeof value.message === "string";
+		case "preRollReport": return isFiniteNumber(value.offered) && isFiniteNumber(value.inferred) && isFiniteNumber(value.dropped) && isRecord(value.droppedByReason) && isFiniteNumber(value.strideMs) && typeof value.subsampled === "boolean" && isFiniteNumber(value.spanMs);
+		case "dialTiming": return isFiniteNumber(value.hwContextMs) && isFiniteNumber(value.demuxerOpenMs) && isFiniteNumber(value.decoderCreateMs) && isFiniteNumber(value.firstDecodeMs) && typeof value.streamInfoProbed === "boolean";
+		default: return false;
+	}
+}
+//#endregion
+export { formatNativeLeaseKnobs as i, isWorkerRequest as n, logLevelForLine as r, isWorkerReply as t };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/addon-pipeline",
-  "version": "1.2.218",
+  "version": "1.2.220",
   "description": "Pipeline bundle — runner, detection, motion, audio + stream broker. Multi-entry npm package shipping pipeline addons under a single bundle.",
   "keywords": [
     "camstack",