@camstack/addon-post-analysis 1.2.1 → 1.2.2

package/dist/{dist-D4KAS857.mjs → dist-Bu9eXObI.mjs}

@@ -11146,7 +11146,8 @@ var PipelineStepInputSchema = lazy(() => object({
 	modelId: string().optional(),
 	enabled: boolean().default(true),
 	children: array(PipelineStepInputSchema).optional(),
-	settings: record(string(), unknown()).optional()
+	settings: record(string(), unknown()).optional(),
+	jumpDeviceKey: string().optional()
 }));
 var ModelSubstitutionSchema = object({
 	addonId: string(),
@@ -11452,8 +11453,24 @@ var NativeCropBboxSchema = object({
 });
 /** Result of a best-effort native-resolution crop (`getNativeCrop`). */
 var NativeCropResultSchema = object({
-	/** Packed rgb (24-bit) pixels of the crop. */
-	bytes: _instanceof(Uint8Array),
+	/**
+	* Packed rgb (24-bit) pixels of the crop. Present on the DEFAULT (raw) path —
+	* same-node (in-process / UDS) callers get zero-copy RGB and encode locally.
+	* OMITTED when the caller requested `encodeJpeg` (the cross-node compressed
+	* path below), where shipping raw RGB is both an invariant violation and, for
+	* a native full frame (~26 MB at 4K), larger than Moleculer's 10 MB
+	* `maxPacketSize` → the packet is dropped and the call 60s-times-out. That is
+	* the cross-node native-media miss: `bytes` is replaced by `jpeg`.
+	*/
+	bytes: _instanceof(Uint8Array).optional(),
+	/**
+	* Base64 JPEG of the crop — the COMPRESSED cross-node payload. The OWNING node
+	* (which holds the native surface) encodes it in-process, so a native 4K frame
+	* ships as ~0.5–2 MB (well under `maxPacketSize`) and NO raw pixels ever cross
+	* a process boundary (CLAUDE.md invariant #21). Present ONLY when the request
+	* set `encodeJpeg: true`; `bytes` is then absent.
+	*/
+	jpeg: string().optional(),
 	width: number().int().positive(),
 	height: number().int().positive(),
 	/**
@@ -11599,6 +11616,20 @@ var RunnerFrameSourceSchema = discriminatedUnion("kind", [object({ kind: literal
 	hubHostnameOverride: string().optional()
 })]).describe("Per-camera frame-source mode for the runner (P2c)");
 /**
+* One ENABLED inference device on the runner's node, as the step-tree
+* device-jump resolver sees it (phase 1). The orchestrator populates this
+* roster on the attach payload whenever the camera is elected onto a specific
+* `deviceKey` and the node has ≥2 enabled devices — it is the candidate set the
+* runner auto-jumps an enrichment step to when the elected device's format
+* cannot run that step's model. `weight`/`maxSessions` mirror the balancer's
+* per-device knobs so the auto choice is weighted-least-loaded.
+*/
+var RunnerInferenceDeviceSchema = object({
+	deviceKey: string(),
+	weight: number().positive().default(1),
+	maxSessions: number().int().positive().nullable().default(null)
+});
+/**
 * Camera assignment payload sent by `addon-pipeline-orchestrator` to a
 * specific runner instance via `attachCamera`. Carries everything the
 * runner needs to subscribe to the local broker and execute inference.
@@ -11716,7 +11747,16 @@ var RunnerCameraConfigSchema = object({
 	* omitted ⇒ the runner's default device. The engine itself stays node-local —
 	* this only selects WHICH device pool of that node runs the session.
 	*/
-	deviceKey: string().optional()
+	deviceKey: string().optional(),
+	/**
+	* Step-tree device-jump roster (phase 1): the node's ENABLED inference
+	* devices, populated by the orchestrator ONLY when `deviceKey` is set and the
+	* node has ≥2 enabled devices. The runner uses it to AUTO-jump an enrichment
+	* step whose model has no build for the elected device's format onto another
+	* enabled device of the SAME node (weighted-least-loaded). Absent/single-entry
+	* ⇒ no jump possible; the step runs on `deviceKey`.
+	*/
+	inferenceDevices: array(RunnerInferenceDeviceSchema).readonly().optional()
 });
 motionFpsField.min, motionFpsField.max, motionFpsField.step, motionFpsField.default, detectionFpsField.min, detectionFpsField.max, detectionFpsField.step, detectionFpsField.default, motionCooldownMsField.min, motionCooldownMsField.max, motionCooldownMsField.step, motionCooldownMsField.default, occupancyRecheckSecField.min, occupancyRecheckSecField.max, occupancyRecheckSecField.step, occupancyRecheckSecField.default, occupancyRecheckFramesField.min, occupancyRecheckFramesField.max, occupancyRecheckFramesField.step, occupancyRecheckFramesField.default;
 /**
@@ -11772,7 +11812,18 @@ var RunnerLocalMetricsSchema = object({
 method(RunnerCameraConfigSchema, object({ success: literal(true) }), { kind: "mutation" }), method(object({ deviceId: number() }), object({ success: literal(true) }), { kind: "mutation" }), method(ReportMotionInputSchema, object({ success: literal(true) }), { kind: "mutation" }), method(_void(), RunnerLocalLoadSchema), method(_void(), RunnerLocalMetricsSchema), method(object({ deviceId: number() }), CameraMetricsSchema.nullable()), method(_void(), array(CameraMetricsWithDeviceIdSchema).readonly()), method(_void(), array(number()).readonly()), method(object({
 	handle: FrameHandleSchema,
 	bbox: NativeCropBboxSchema,
-	maxWidth: number().int().positive().optional()
+	maxWidth: number().int().positive().optional(),
+	/**
+	* When `true`, the runner encodes the resolved crop to JPEG ON THE
+	* OWNING NODE and returns it in `jpeg` (base64) INSTEAD of raw `bytes`.
+	* Callers set this for CROSS-NODE fetches (`handle.nodeId` is a remote
+	* agent) so the compressed payload fits Moleculer's `maxPacketSize` and
+	* no raw pixels cross the process boundary. Same-node callers omit it
+	* and keep the zero-copy raw `bytes` path. Additive + optional: a
+	* pre-encode runner (version skew) ignores it and returns `bytes`, so
+	* the caller falls back to encoding locally.
+	*/
+	encodeJpeg: boolean().optional()
 }), NativeCropResultSchema.nullable()), method(object({
 	deviceId: number(),
 	frameHandle: FrameHandleSchema.optional(),
@@ -17147,7 +17198,16 @@ var PipelineTemplateSchema = object({
 });
 var DeviceStepConfigSchema = object({
 	modelId: string().optional(),
-	settings: record(string(), unknown()).optional()
+	settings: record(string(), unknown()).optional(),
+	/**
+	* Step-tree device jump (same-node, phase 1) — OPTIONAL manual override.
+	* When set, this step runs on the named enabled device of the SAME node
+	* (`<backend>:<device>`) instead of the camera's elected device, bypassing
+	* the runtime AUTO-jump. The orchestrator rejects a `jumpDeviceKey` pointing
+	* at a disabled/absent device on that node at save time. Absent ⇒ the runner
+	* auto-jumps only when the effective device's format cannot run the step.
+	*/
+	jumpDeviceKey: string().optional()
 });
 var AgentPipelineSettingsSchema = object({
 	maxCameras: number().int().nonnegative().nullable().default(null),

package/dist/{dist-DMg7kQfI.js → dist-DSP-cVM0.js}

@@ -11168,7 +11168,8 @@ var PipelineStepInputSchema = lazy(() => object({
 	modelId: string().optional(),
 	enabled: boolean().default(true),
 	children: array(PipelineStepInputSchema).optional(),
-	settings: record(string(), unknown()).optional()
+	settings: record(string(), unknown()).optional(),
+	jumpDeviceKey: string().optional()
 }));
 var ModelSubstitutionSchema = object({
 	addonId: string(),
@@ -11474,8 +11475,24 @@ var NativeCropBboxSchema = object({
 });
 /** Result of a best-effort native-resolution crop (`getNativeCrop`). */
 var NativeCropResultSchema = object({
-	/** Packed rgb (24-bit) pixels of the crop. */
-	bytes: _instanceof(Uint8Array),
+	/**
+	* Packed rgb (24-bit) pixels of the crop. Present on the DEFAULT (raw) path —
+	* same-node (in-process / UDS) callers get zero-copy RGB and encode locally.
+	* OMITTED when the caller requested `encodeJpeg` (the cross-node compressed
+	* path below), where shipping raw RGB is both an invariant violation and, for
+	* a native full frame (~26 MB at 4K), larger than Moleculer's 10 MB
+	* `maxPacketSize` → the packet is dropped and the call 60s-times-out. That is
+	* the cross-node native-media miss: `bytes` is replaced by `jpeg`.
+	*/
+	bytes: _instanceof(Uint8Array).optional(),
+	/**
+	* Base64 JPEG of the crop — the COMPRESSED cross-node payload. The OWNING node
+	* (which holds the native surface) encodes it in-process, so a native 4K frame
+	* ships as ~0.5–2 MB (well under `maxPacketSize`) and NO raw pixels ever cross
+	* a process boundary (CLAUDE.md invariant #21). Present ONLY when the request
+	* set `encodeJpeg: true`; `bytes` is then absent.
+	*/
+	jpeg: string().optional(),
 	width: number().int().positive(),
 	height: number().int().positive(),
 	/**
@@ -11621,6 +11638,20 @@ var RunnerFrameSourceSchema = discriminatedUnion("kind", [object({ kind: literal
 	hubHostnameOverride: string().optional()
 })]).describe("Per-camera frame-source mode for the runner (P2c)");
 /**
+* One ENABLED inference device on the runner's node, as the step-tree
+* device-jump resolver sees it (phase 1). The orchestrator populates this
+* roster on the attach payload whenever the camera is elected onto a specific
+* `deviceKey` and the node has ≥2 enabled devices — it is the candidate set the
+* runner auto-jumps an enrichment step to when the elected device's format
+* cannot run that step's model. `weight`/`maxSessions` mirror the balancer's
+* per-device knobs so the auto choice is weighted-least-loaded.
+*/
+var RunnerInferenceDeviceSchema = object({
+	deviceKey: string(),
+	weight: number().positive().default(1),
+	maxSessions: number().int().positive().nullable().default(null)
+});
+/**
 * Camera assignment payload sent by `addon-pipeline-orchestrator` to a
 * specific runner instance via `attachCamera`. Carries everything the
 * runner needs to subscribe to the local broker and execute inference.
@@ -11738,7 +11769,16 @@ var RunnerCameraConfigSchema = object({
 	* omitted ⇒ the runner's default device. The engine itself stays node-local —
 	* this only selects WHICH device pool of that node runs the session.
 	*/
-	deviceKey: string().optional()
+	deviceKey: string().optional(),
+	/**
+	* Step-tree device-jump roster (phase 1): the node's ENABLED inference
+	* devices, populated by the orchestrator ONLY when `deviceKey` is set and the
+	* node has ≥2 enabled devices. The runner uses it to AUTO-jump an enrichment
+	* step whose model has no build for the elected device's format onto another
+	* enabled device of the SAME node (weighted-least-loaded). Absent/single-entry
+	* ⇒ no jump possible; the step runs on `deviceKey`.
+	*/
+	inferenceDevices: array(RunnerInferenceDeviceSchema).readonly().optional()
 });
 motionFpsField.min, motionFpsField.max, motionFpsField.step, motionFpsField.default, detectionFpsField.min, detectionFpsField.max, detectionFpsField.step, detectionFpsField.default, motionCooldownMsField.min, motionCooldownMsField.max, motionCooldownMsField.step, motionCooldownMsField.default, occupancyRecheckSecField.min, occupancyRecheckSecField.max, occupancyRecheckSecField.step, occupancyRecheckSecField.default, occupancyRecheckFramesField.min, occupancyRecheckFramesField.max, occupancyRecheckFramesField.step, occupancyRecheckFramesField.default;
 /**
@@ -11794,7 +11834,18 @@ var RunnerLocalMetricsSchema = object({
 method(RunnerCameraConfigSchema, object({ success: literal(true) }), { kind: "mutation" }), method(object({ deviceId: number() }), object({ success: literal(true) }), { kind: "mutation" }), method(ReportMotionInputSchema, object({ success: literal(true) }), { kind: "mutation" }), method(_void(), RunnerLocalLoadSchema), method(_void(), RunnerLocalMetricsSchema), method(object({ deviceId: number() }), CameraMetricsSchema.nullable()), method(_void(), array(CameraMetricsWithDeviceIdSchema).readonly()), method(_void(), array(number()).readonly()), method(object({
 	handle: FrameHandleSchema,
 	bbox: NativeCropBboxSchema,
-	maxWidth: number().int().positive().optional()
+	maxWidth: number().int().positive().optional(),
+	/**
+	* When `true`, the runner encodes the resolved crop to JPEG ON THE
+	* OWNING NODE and returns it in `jpeg` (base64) INSTEAD of raw `bytes`.
+	* Callers set this for CROSS-NODE fetches (`handle.nodeId` is a remote
+	* agent) so the compressed payload fits Moleculer's `maxPacketSize` and
+	* no raw pixels cross the process boundary. Same-node callers omit it
+	* and keep the zero-copy raw `bytes` path. Additive + optional: a
+	* pre-encode runner (version skew) ignores it and returns `bytes`, so
+	* the caller falls back to encoding locally.
+	*/
+	encodeJpeg: boolean().optional()
 }), NativeCropResultSchema.nullable()), method(object({
 	deviceId: number(),
 	frameHandle: FrameHandleSchema.optional(),
@@ -17169,7 +17220,16 @@ var PipelineTemplateSchema = object({
 });
 var DeviceStepConfigSchema = object({
 	modelId: string().optional(),
-	settings: record(string(), unknown()).optional()
+	settings: record(string(), unknown()).optional(),
+	/**
+	* Step-tree device jump (same-node, phase 1) — OPTIONAL manual override.
+	* When set, this step runs on the named enabled device of the SAME node
+	* (`<backend>:<device>`) instead of the camera's elected device, bypassing
+	* the runtime AUTO-jump. The orchestrator rejects a `jumpDeviceKey` pointing
+	* at a disabled/absent device on that node at save time. Absent ⇒ the runner
+	* auto-jumps only when the effective device's format cannot run the step.
+	*/
+	jumpDeviceKey: string().optional()
 });
 var AgentPipelineSettingsSchema = object({
 	maxCameras: number().int().nonnegative().nullable().default(null),

package/dist/embedding-encoder/index.js

@@ -2,7 +2,7 @@ Object.defineProperties(exports, {
 	__esModule: { value: true },
 	[Symbol.toStringTag]: { value: "Module" }
 });
-const require_dist = require("../dist-DMg7kQfI.js");
+const require_dist = require("../dist-DSP-cVM0.js");
 let node_fs = require("node:fs");
 let node_fs$1 = require_dist.__toESM(node_fs, 1);
 node_fs = require_dist.__toESM(node_fs);

package/dist/embedding-encoder/index.mjs

@@ -1,4 +1,4 @@
-import { b as BaseAddon, f as hfModelUrl, u as embeddingEncoderCapability } from "../dist-D4KAS857.mjs";
+import { b as BaseAddon, f as hfModelUrl, u as embeddingEncoderCapability } from "../dist-Bu9eXObI.mjs";
 import { createRequire } from "node:module";
 import * as fs from "node:fs";
 import * as path$1 from "node:path";

package/dist/{node--uX7wh6R.js → node-DtSEvIXU.js}

@@ -1,4 +1,4 @@
-const require_dist = require("./dist-DMg7kQfI.js");
+const require_dist = require("./dist-DSP-cVM0.js");
 let node_fs = require("node:fs");
 node_fs = require_dist.__toESM(node_fs, 1);
 let node_path = require("node:path");

package/dist/pipeline-analytics/{_virtual_mf-localSharedImportMap___mfe_internal__addon_pipeline_analytics_widgets-ddQyIsuX.mjs → _virtual_mf-localSharedImportMap___mfe_internal__addon_pipeline_analytics_widgets-2w2j7Rm4.mjs}

@@ -3,7 +3,7 @@ import "./dist-CYZr2fwk.mjs";
 var e = {
 	"@camstack/sdk": {
 		name: "@camstack/sdk",
-		version: "1.2.1",
+		version: "1.2.2",
 		scope: ["default"],
 		loaded: !1,
 		from: "addon_pipeline_analytics_widgets",
@@ -18,7 +18,7 @@ var e = {
 	},
 	"@camstack/types": {
 		name: "@camstack/types",
-		version: "1.2.1",
+		version: "1.2.2",
 		scope: ["default"],
 		loaded: !1,
 		from: "addon_pipeline_analytics_widgets",
@@ -33,7 +33,7 @@ var e = {
 	},
 	"@camstack/ui-library": {
 		name: "@camstack/ui-library",
-		version: "1.2.1",
+		version: "1.2.2",
 		scope: ["default"],
 		loaded: !1,
 		from: "addon_pipeline_analytics_widgets",

package/dist/pipeline-analytics/{hostInit-DGlQ_y2f.mjs → hostInit-CTQ8-sg-.mjs}

@@ -36,7 +36,7 @@ async function r() {
 				}
 			},
 			"@camstack/types": {
-				version: "1.2.1",
+				version: "1.2.2",
 				scope: "default",
 				shareConfig: {
 					singleton: !0,
@@ -45,7 +45,7 @@ async function r() {
 				}
 			},
 			"@camstack/sdk": {
-				version: "1.2.1",
+				version: "1.2.2",
 				scope: "default",
 				shareConfig: {
 					singleton: !0,
@@ -81,7 +81,7 @@ async function r() {
 				}
 			},
 			"@camstack/ui-library": {
-				version: "1.2.1",
+				version: "1.2.2",
 				scope: "default",
 				shareConfig: {
 					singleton: !0,

package/dist/pipeline-analytics/index.js

@@ -2,7 +2,7 @@ Object.defineProperties(exports, {
 	__esModule: { value: true },
 	[Symbol.toStringTag]: { value: "Module" }
 });
-const require_dist = require("../dist-DMg7kQfI.js");
+const require_dist = require("../dist-DSP-cVM0.js");
 let node_crypto = require("node:crypto");
 let sharp = require("sharp");
 sharp = require_dist.__toESM(sharp);
@@ -11608,6 +11608,21 @@ async function encodeRgbCropToJpeg(bytes, width, height) {
 		channels: 3
 	} }).jpeg({ quality: 90 }).toBuffer();
 }
+/**
+* Decode a base64 JPEG (the COMPRESSED cross-node crop the owning runner
+* returns) back into raw RGB (24-bit) pixels, so every downstream consumer
+* keeps its existing RGB contract regardless of whether the crop was fetched
+* same-node (raw) or cross-node (JPEG). The decode happens IN-PROCESS on the
+* post-processing node — no raw pixels ever cross a process boundary.
+*/
+async function decodeJpegToRgb(base64Jpeg) {
+	const { data, info } = await (0, sharp.default)(Buffer.from(base64Jpeg, "base64")).raw().toBuffer({ resolveWithObject: true });
+	return {
+		bytes: data,
+		width: info.width,
+		height: info.height
+	};
+}
 //#endregion
 //#region src/pipeline-analytics/pipeline/event-child-crops.ts
 /**
@@ -12401,7 +12416,7 @@ var PipelineAnalyticsAddon = class extends require_dist.BaseAddon {
 		let storage = this.ctx.kernel.storage;
 		const mediaRoot = process.env.CAMSTACK_MEDIA_ROOT?.trim();
 		if (mediaRoot) {
-			const { FilesystemStorageProvider } = await Promise.resolve().then(() => require("../node--uX7wh6R.js"));
+			const { FilesystemStorageProvider } = await Promise.resolve().then(() => require("../node-DtSEvIXU.js"));
 			storage = new FilesystemStorageProvider(mediaRoot);
 			logger.info("pipeline-analytics: event media rooted at CAMSTACK_MEDIA_ROOT", { meta: { mediaRoot } });
 		}
@@ -12548,6 +12563,23 @@ var PipelineAnalyticsAddon = class extends require_dist.BaseAddon {
 			} });
 		}
 		const pipelineRunnerApi = api.pipelineRunner;
+		const isRemoteHandle = (handle) => handle.nodeId !== ownNodeId;
+		const cropReplyToRgb = async (reply) => {
+			if (reply.jpeg !== void 0) {
+				const rgb = await decodeJpegToRgb(reply.jpeg);
+				return {
+					bytes: Buffer.from(rgb.bytes),
+					width: rgb.width,
+					height: rgb.height
+				};
+			}
+			if (reply.bytes !== void 0) return {
+				bytes: Buffer.from(reply.bytes),
+				width: reply.width,
+				height: reply.height
+			};
+			return null;
+		};
 		const getRemoteFrame = async (handle) => {
 			if (!pipelineRunnerApi?.getNativeCrop) return null;
 			const full = await pipelineRunnerApi.getNativeCrop.query({
@@ -12558,13 +12590,16 @@ var PipelineAnalyticsAddon = class extends require_dist.BaseAddon {
 					w: 1,
 					h: 1
 				},
-				maxWidth: handle.width
+				maxWidth: handle.width,
+				encodeJpeg: isRemoteHandle(handle)
 			}, require_dist.nodePin(handle.nodeId));
 			if (!full || full.width <= 0 || full.height <= 0) return null;
+			const rgb = await cropReplyToRgb(full);
+			if (!rgb) return null;
 			return {
-				data: Buffer.from(full.bytes),
-				width: full.width,
-				height: full.height,
+				data: rgb.bytes,
+				width: rgb.width,
+				height: rgb.height,
 				format: "rgb",
 				timestamp: 0
 			};
@@ -12579,15 +12614,18 @@ var PipelineAnalyticsAddon = class extends require_dist.BaseAddon {
 					w: 1,
 					h: 1
 				},
-				maxWidth
+				maxWidth,
+				encodeJpeg: isRemoteHandle(handle)
 			}, require_dist.nodePin(handle.nodeId));
 			if (!full || full.width <= 0 || full.height <= 0) return null;
+			const rgb = await cropReplyToRgb(full);
+			if (!rgb) return null;
 			const tier = full.tier === "ram-fullframe" ? "ram-fullframe" : "native";
 			return {
 				frame: {
-					data: Buffer.from(full.bytes),
-					width: full.width,
-					height: full.height,
+					data: rgb.bytes,
+					width: rgb.width,
+					height: rgb.height,
 					format: "rgb",
 					timestamp: 0
 				},
@@ -12618,14 +12656,11 @@ var PipelineAnalyticsAddon = class extends require_dist.BaseAddon {
 				const native = await pipelineRunnerApi.getNativeCrop.query({
 					handle: frameHandle,
 					bbox: paddedNorm,
-					...maxWidth !== void 0 ? { maxWidth } : {}
+					...maxWidth !== void 0 ? { maxWidth } : {},
+					encodeJpeg: isRemoteHandle(frameHandle)
 				}, require_dist.nodePin(frameHandle.nodeId));
 				if (!native || native.width <= 0 || native.height <= 0) return null;
-				return {
-					bytes: Buffer.from(native.bytes),
-					width: native.width,
-					height: native.height
-				};
+				return await cropReplyToRgb(native);
 			} catch (err) {
 				cropMetricLogger.debug("native crop request failed — falling back", { meta: { error: require_dist.errMsg(err) } });
 				return null;

package/dist/pipeline-analytics/index.mjs

@@ -1,4 +1,4 @@
-import { C as hydrateSchema, D as object, E as number, O as string, S as createEvent, T as boolean, _ as videoclipsCapability, a as OpsLogEntrySchema, b as BaseAddon, c as buildEventKindDescriptor, d as faceGalleryCapability, g as subKindsOf, h as plateGalleryCapability, i as MACRO_LABELS, k as EventCategory, l as cosineSimilarity, m as pipelineAnalyticsCapability, n as EVENT_KIND_BY_CAP, o as addonWidgetsSourceCapability, p as nodePin, r as EVENT_PAD_MS, s as audioMetricsCapability, t as DEFAULT_EVENT_COLOR, v as zoneAnalyticsCapability, w as array, x as DeviceType, y as errMsg } from "../dist-D4KAS857.mjs";
+import { C as hydrateSchema, D as object, E as number, O as string, S as createEvent, T as boolean, _ as videoclipsCapability, a as OpsLogEntrySchema, b as BaseAddon, c as buildEventKindDescriptor, d as faceGalleryCapability, g as subKindsOf, h as plateGalleryCapability, i as MACRO_LABELS, k as EventCategory, l as cosineSimilarity, m as pipelineAnalyticsCapability, n as EVENT_KIND_BY_CAP, o as addonWidgetsSourceCapability, p as nodePin, r as EVENT_PAD_MS, s as audioMetricsCapability, t as DEFAULT_EVENT_COLOR, v as zoneAnalyticsCapability, w as array, x as DeviceType, y as errMsg } from "../dist-Bu9eXObI.mjs";
 import { randomUUID } from "node:crypto";
 import sharp from "sharp";
 //#region src/pipeline-analytics/videoclips-provider.ts
@@ -11603,6 +11603,21 @@ async function encodeRgbCropToJpeg(bytes, width, height) {
 		channels: 3
 	} }).jpeg({ quality: 90 }).toBuffer();
 }
+/**
+* Decode a base64 JPEG (the COMPRESSED cross-node crop the owning runner
+* returns) back into raw RGB (24-bit) pixels, so every downstream consumer
+* keeps its existing RGB contract regardless of whether the crop was fetched
+* same-node (raw) or cross-node (JPEG). The decode happens IN-PROCESS on the
+* post-processing node — no raw pixels ever cross a process boundary.
+*/
+async function decodeJpegToRgb(base64Jpeg) {
+	const { data, info } = await sharp(Buffer.from(base64Jpeg, "base64")).raw().toBuffer({ resolveWithObject: true });
+	return {
+		bytes: data,
+		width: info.width,
+		height: info.height
+	};
+}
 //#endregion
 //#region src/pipeline-analytics/pipeline/event-child-crops.ts
 /**
@@ -12543,6 +12558,23 @@ var PipelineAnalyticsAddon = class extends BaseAddon {
 			} });
 		}
 		const pipelineRunnerApi = api.pipelineRunner;
+		const isRemoteHandle = (handle) => handle.nodeId !== ownNodeId;
+		const cropReplyToRgb = async (reply) => {
+			if (reply.jpeg !== void 0) {
+				const rgb = await decodeJpegToRgb(reply.jpeg);
+				return {
+					bytes: Buffer.from(rgb.bytes),
+					width: rgb.width,
+					height: rgb.height
+				};
+			}
+			if (reply.bytes !== void 0) return {
+				bytes: Buffer.from(reply.bytes),
+				width: reply.width,
+				height: reply.height
+			};
+			return null;
+		};
 		const getRemoteFrame = async (handle) => {
 			if (!pipelineRunnerApi?.getNativeCrop) return null;
 			const full = await pipelineRunnerApi.getNativeCrop.query({
@@ -12553,13 +12585,16 @@ var PipelineAnalyticsAddon = class extends BaseAddon {
 					w: 1,
 					h: 1
 				},
-				maxWidth: handle.width
+				maxWidth: handle.width,
+				encodeJpeg: isRemoteHandle(handle)
 			}, nodePin(handle.nodeId));
 			if (!full || full.width <= 0 || full.height <= 0) return null;
+			const rgb = await cropReplyToRgb(full);
+			if (!rgb) return null;
 			return {
-				data: Buffer.from(full.bytes),
-				width: full.width,
-				height: full.height,
+				data: rgb.bytes,
+				width: rgb.width,
+				height: rgb.height,
 				format: "rgb",
 				timestamp: 0
 			};
@@ -12574,15 +12609,18 @@ var PipelineAnalyticsAddon = class extends BaseAddon {
 					w: 1,
 					h: 1
 				},
-				maxWidth
+				maxWidth,
+				encodeJpeg: isRemoteHandle(handle)
 			}, nodePin(handle.nodeId));
 			if (!full || full.width <= 0 || full.height <= 0) return null;
+			const rgb = await cropReplyToRgb(full);
+			if (!rgb) return null;
 			const tier = full.tier === "ram-fullframe" ? "ram-fullframe" : "native";
 			return {
 				frame: {
-					data: Buffer.from(full.bytes),
-					width: full.width,
-					height: full.height,
+					data: rgb.bytes,
+					width: rgb.width,
+					height: rgb.height,
 					format: "rgb",
 					timestamp: 0
 				},
@@ -12613,14 +12651,11 @@ var PipelineAnalyticsAddon = class extends BaseAddon {
 				const native = await pipelineRunnerApi.getNativeCrop.query({
 					handle: frameHandle,
 					bbox: paddedNorm,
-					...maxWidth !== void 0 ? { maxWidth } : {}
+					...maxWidth !== void 0 ? { maxWidth } : {},
+					encodeJpeg: isRemoteHandle(frameHandle)
 				}, nodePin(frameHandle.nodeId));
 				if (!native || native.width <= 0 || native.height <= 0) return null;
-				return {
-					bytes: Buffer.from(native.bytes),
-					width: native.width,
-					height: native.height
-				};
+				return await cropReplyToRgb(native);
 			} catch (err) {
 				cropMetricLogger.debug("native crop request failed — falling back", { meta: { error: errMsg(err) } });
 				return null;

package/dist/pipeline-analytics/remoteEntry.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/addon-post-analysis",
-  "version": "1.2.1",
+  "version": "1.2.2",
   "description": "CamStack Post-Analysis bundle — enrichment, embedding-encoder, pipeline-analytics. Multi-entry npm package shipping addons that consume pipeline output.",
   "keywords": [
     "camstack",