@camstack/system 1.2.0 → 1.2.2

package/dist/addon-runner.js

@@ -1,6 +1,6 @@
 const require_chunk = require("./chunk-Cek0wNdY.js");
-const require_dist = require("./dist-B9OD5Tdn.js");
-const require_manifest_python_deps = require("./manifest-python-deps-DXqcuOha.js");
+const require_dist = require("./dist-CkdNC8US.js");
+const require_manifest_python_deps = require("./manifest-python-deps-DRq5MreI.js");
 const require_custom_action_registry = require("./custom-action-registry-vLYEFTtv.js");
 let node_fs = require("node:fs");
 node_fs = require_chunk.__toESM(node_fs);

package/dist/addon-runner.mjs

@@ -1,5 +1,5 @@
-import { M as isCollectionArrayMethod, t as ALL_CAPABILITY_DEFINITIONS } from "./dist-D7-BTTgZ.mjs";
-import { I as createUdsLoggerWithControl, L as LocalChildClient, St as resolveAddonClass, at as setWorkerNativeCapsChangeListener, i as createUdsAddonContext, nt as getWorkerNativeCapProvider, rt as getWorkerNativeCapSnapshot, st as validateProviderRegistrations, t as installManifestPythonDeps, yt as installManifestNativeDeps } from "./manifest-python-deps-D7EIakIT.mjs";
+import { M as isCollectionArrayMethod, t as ALL_CAPABILITY_DEFINITIONS } from "./dist-DTTTjPCL.mjs";
+import { I as createUdsLoggerWithControl, L as LocalChildClient, St as resolveAddonClass, at as setWorkerNativeCapsChangeListener, i as createUdsAddonContext, nt as getWorkerNativeCapProvider, rt as getWorkerNativeCapSnapshot, st as validateProviderRegistrations, t as installManifestPythonDeps, yt as installManifestNativeDeps } from "./manifest-python-deps-s_-uULmp.mjs";
 import { t as CustomActionRegistry } from "./custom-action-registry-BEXwC-oo.mjs";
 import { register } from "node:module";
 import * as fs from "node:fs";

package/dist/builtins/addon-pages-aggregator/addon-pages-aggregator.addon.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 const require_chunk = require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-B9OD5Tdn.js");
+const require_dist = require("../../dist-CkdNC8US.js");
 const require_settle_sources = require("../../settle-sources-Bhsy57y-.js");
 let node_fs = require("node:fs");
 node_fs = require_chunk.__toESM(node_fs);

package/dist/builtins/addon-pages-aggregator/addon-pages-aggregator.addon.mjs

@@ -1,4 +1,4 @@
-import { At as EventCategory, at as BaseAddon, f as addonPagesCapability, it as errMsg } from "../../dist-D7-BTTgZ.mjs";
+import { At as EventCategory, at as BaseAddon, f as addonPagesCapability, it as errMsg } from "../../dist-DTTTjPCL.mjs";
 import { t as settleSourcesWithTimeout } from "../../settle-sources-CDtNC8ub.mjs";
 import * as fs from "node:fs";
 import * as path$1 from "node:path";

package/dist/builtins/addon-widgets-aggregator/addon-widgets-aggregator.addon.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 const require_chunk = require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-B9OD5Tdn.js");
+const require_dist = require("../../dist-CkdNC8US.js");
 const require_settle_sources = require("../../settle-sources-Bhsy57y-.js");
 let node_fs = require("node:fs");
 node_fs = require_chunk.__toESM(node_fs);

package/dist/builtins/addon-widgets-aggregator/addon-widgets-aggregator.addon.mjs

@@ -1,4 +1,4 @@
-import { At as EventCategory, at as BaseAddon, it as errMsg, m as addonWidgetsCapability } from "../../dist-D7-BTTgZ.mjs";
+import { At as EventCategory, at as BaseAddon, it as errMsg, m as addonWidgetsCapability } from "../../dist-DTTTjPCL.mjs";
 import { t as settleSourcesWithTimeout } from "../../settle-sources-CDtNC8ub.mjs";
 import * as fs from "node:fs";
 import * as path$1 from "node:path";

package/dist/builtins/alerts/alerts.addon.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-B9OD5Tdn.js");
+const require_dist = require("../../dist-CkdNC8US.js");
 //#region src/builtins/alerts/alerts.addon.ts
 var CATEGORY_MAPPINGS = {
 	"addon.crashed": {

package/dist/builtins/alerts/alerts.addon.mjs

@@ -1,4 +1,4 @@
-import { At as EventCategory, at as BaseAddon, h as alertsCapability, it as errMsg, n as AlertSchema, vt as createEvent } from "../../dist-D7-BTTgZ.mjs";
+import { At as EventCategory, at as BaseAddon, h as alertsCapability, it as errMsg, n as AlertSchema, vt as createEvent } from "../../dist-DTTTjPCL.mjs";
 //#region src/builtins/alerts/alerts.addon.ts
 var CATEGORY_MAPPINGS = {
 	"addon.crashed": {

package/dist/builtins/backup-orchestrator/backup-orchestrator.addon.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 const require_chunk = require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-B9OD5Tdn.js");
+const require_dist = require("../../dist-CkdNC8US.js");
 let node_fs = require("node:fs");
 let node_fs$1 = require_chunk.__toESM(node_fs, 1);
 node_fs = require_chunk.__toESM(node_fs);

package/dist/builtins/backup-orchestrator/backup-orchestrator.addon.mjs

@@ -1,4 +1,4 @@
-import { At as EventCategory, at as BaseAddon, v as backupCapability } from "../../dist-D7-BTTgZ.mjs";
+import { At as EventCategory, at as BaseAddon, v as backupCapability } from "../../dist-DTTTjPCL.mjs";
 import * as fs from "node:fs";
 import Kt from "node:fs";
 import * as path$1 from "node:path";

package/dist/builtins/console-logging/index.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-B9OD5Tdn.js");
+const require_dist = require("../../dist-CkdNC8US.js");
 const require_formatter = require("../../formatter-DqAKDlvN.js");
 //#region src/builtins/console-logging/console-destination.ts
 var LEVEL_RANK = {

package/dist/builtins/console-logging/index.mjs

@@ -1,4 +1,4 @@
-import { R as logDestinationCapability, at as BaseAddon } from "../../dist-D7-BTTgZ.mjs";
+import { R as logDestinationCapability, at as BaseAddon } from "../../dist-DTTTjPCL.mjs";
 import { t as formatLogLine } from "../../formatter-B7qW8bPJ.mjs";
 //#region src/builtins/console-logging/console-destination.ts
 var LEVEL_RANK = {

package/dist/builtins/device-manager/device-linked-devices.d.ts

@@ -3,6 +3,9 @@ import { ProviderContext } from './device-provider-context.js';
 /** Reserved device-config keys (cf. `_profileMap`). */
 export declare const LINKED_MODE_CONFIG_KEY = "_linkedDevicesMode";
 export declare const LINKED_IDS_CONFIG_KEY = "_linkedDeviceIds";
+/** Reserved key: subset of linked devices that materialize synthetic tracked
+ *  events on the camera. Absent ⇒ ALL linked devices produce tracked events. */
+export declare const LINKED_TRACKED_IDS_CONFIG_KEY = "_linkedDeviceTrackedIds";
 export interface LinkedDevicesConfig {
     readonly mode: DeviceLinkMode;
     readonly manualIds: readonly number[];
@@ -27,6 +30,16 @@ export declare function resolveLinkedDeviceIds(params: {
     readonly config: LinkedDevicesConfig;
     readonly candidates: readonly LinkCandidate[];
 }): readonly number[];
+/**
+ * Which linked devices materialize synthetic tracked events on the camera.
+ * Absent / non-array config key ⇒ ALL linked devices (back-compat with the
+ * pre-existing "every linked device produces events" behaviour). Otherwise the
+ * configured subset intersected with the currently-resolved linked set (a
+ * picked id no longer linked is dropped). Ids may arrive as numbers or numeric
+ * strings (the multiselect stores string option values); non-numeric entries
+ * are ignored.
+ */
+export declare function resolveTrackedEventDeviceIds(config: Record<string, unknown>, linkedIds: readonly number[]): readonly number[];
 /** Cap implementation of `getLinkedDevices`. */
 export declare function getLinkedDevices(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider['getLinkedDevices']>[0]): ReturnType<IDeviceManagerProvider['getLinkedDevices']>;
 /**

package/dist/builtins/device-manager/device-manager.addon.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-B9OD5Tdn.js");
+const require_dist = require("../../dist-CkdNC8US.js");
 let _camstack_types_node = require("@camstack/types/node");
 let zod = require("zod");
 let node_crypto = require("node:crypto");
@@ -1209,6 +1209,9 @@ async function testField(pctx, input) {
 /** Reserved device-config keys (cf. `_profileMap`). */
 var LINKED_MODE_CONFIG_KEY = "_linkedDevicesMode";
 var LINKED_IDS_CONFIG_KEY = "_linkedDeviceIds";
+/** Reserved key: subset of linked devices that materialize synthetic tracked
+*  events on the camera. Absent ⇒ ALL linked devices produce tracked events. */
+var LINKED_TRACKED_IDS_CONFIG_KEY = "_linkedDeviceTrackedIds";
 /** Parse the two reserved keys out of a device-config blob. Tolerant:
 *  ids may arrive as numbers or numeric strings (the multiselect field
 *  stores string option values); anything else is dropped. */
@@ -1244,6 +1247,25 @@ function resolveLinkedDeviceIds(params) {
 	ids.delete(selfId);
 	return [...ids];
 }
+/**
+* Which linked devices materialize synthetic tracked events on the camera.
+* Absent / non-array config key ⇒ ALL linked devices (back-compat with the
+* pre-existing "every linked device produces events" behaviour). Otherwise the
+* configured subset intersected with the currently-resolved linked set (a
+* picked id no longer linked is dropped). Ids may arrive as numbers or numeric
+* strings (the multiselect stores string option values); non-numeric entries
+* are ignored.
+*/
+function resolveTrackedEventDeviceIds(config, linkedIds) {
+	const raw = config[LINKED_TRACKED_IDS_CONFIG_KEY];
+	if (!Array.isArray(raw)) return linkedIds;
+	const picked = /* @__PURE__ */ new Set();
+	for (const v of raw) {
+		const n = typeof v === "number" ? v : typeof v === "string" ? Number(v) : NaN;
+		if (Number.isInteger(n)) picked.add(n);
+	}
+	return linkedIds.filter((id) => picked.has(id));
+}
 /** Cap implementation of `getLinkedDevices`. */
 async function getLinkedDevices(pctx, input) {
 	const { deviceId } = input;
@@ -1256,6 +1278,7 @@ async function getLinkedDevices(pctx, input) {
 		config,
 		candidates: all
 	});
+	const trackedIds = new Set(resolveTrackedEventDeviceIds(blob, ids));
 	const devices = [];
 	for (const id of ids) {
 		const d = byId.get(id);
@@ -1264,7 +1287,8 @@ async function getLinkedDevices(pctx, input) {
 			deviceId: d.id,
 			name: d.name,
 			location: d.location,
-			features: d.features
+			features: d.features,
+			producesTrackedEvents: trackedIds.has(d.id)
 		});
 	}
 	return {
@@ -1287,36 +1311,63 @@ async function buildLinkedDevicesContribution(pctx, deviceId) {
 		value: String(d.id),
 		label: d.location !== null ? `${d.name} (${d.location})` : d.name
 	}));
+	const linkedIds = resolveLinkedDeviceIds({
+		selfId: deviceId,
+		selfLocation: all.find((d) => d.id === deviceId)?.location ?? null,
+		config,
+		candidates: all
+	});
+	const byId = new Map(all.map((d) => [d.id, d]));
+	const trackedOptions = linkedIds.flatMap((id) => {
+		const d = byId.get(id);
+		if (!d) return [];
+		return [{
+			value: String(d.id),
+			label: d.location !== null ? `${d.name} (${d.location})` : d.name
+		}];
+	});
+	const trackedValue = resolveTrackedEventDeviceIds(blob, linkedIds).map(String);
 	return { sections: [{
 		id: "linked-devices",
 		title: "Linked devices",
 		description: "Companion devices associated with this camera. Device-tree children are always linked; auto mode also links every device sharing the camera location, manual mode links the picked list instead.",
 		order: 70,
-		fields: [{
-			type: "select",
-			key: LINKED_MODE_CONFIG_KEY,
-			label: "Link mode",
-			description: "Auto: children + same-location devices. Manual: children + the list below.",
-			options: [{
-				value: "auto",
-				label: "Auto (location-based)"
-			}, {
-				value: "manual",
-				label: "Manual"
-			}],
-			value: config.mode
-		}, {
-			type: "multiselect",
-			key: LINKED_IDS_CONFIG_KEY,
-			label: "Manually linked devices",
-			description: "Used in manual mode (children stay linked regardless).",
-			showWhen: {
-				field: LINKED_MODE_CONFIG_KEY,
-				equals: "manual"
+		fields: [
+			{
+				type: "select",
+				key: LINKED_MODE_CONFIG_KEY,
+				label: "Link mode",
+				description: "Auto: children + same-location devices. Manual: children + the list below.",
+				options: [{
+					value: "auto",
+					label: "Auto (location-based)"
+				}, {
+					value: "manual",
+					label: "Manual"
+				}],
+				value: config.mode
 			},
-			options,
-			value: config.manualIds.map(String)
-		}]
+			{
+				type: "multiselect",
+				key: LINKED_IDS_CONFIG_KEY,
+				label: "Manually linked devices",
+				description: "Used in manual mode (children stay linked regardless).",
+				showWhen: {
+					field: LINKED_MODE_CONFIG_KEY,
+					equals: "manual"
+				},
+				options,
+				value: config.manualIds.map(String)
+			},
+			{
+				type: "multiselect",
+				key: LINKED_TRACKED_IDS_CONFIG_KEY,
+				label: "Devices that produce tracked events",
+				description: "Linked devices whose state changes materialize a synthetic tracked event on this camera. Default: all linked devices.",
+				options: trackedOptions,
+				value: trackedValue
+			}
+		]
 	}] };
 }
 /**
@@ -1329,6 +1380,15 @@ async function applyLinkedDevicesPatch(pctx, deviceId, patch) {
 	const next = { ...await pctx.settings.readDeviceStore(deviceId) };
 	if ("_linkedDevicesMode" in patch) next[LINKED_MODE_CONFIG_KEY] = patch["_linkedDevicesMode"] === "manual" ? "manual" : "auto";
 	if ("_linkedDeviceIds" in patch) next[LINKED_IDS_CONFIG_KEY] = [...parseLinkedDevicesConfig({ [LINKED_IDS_CONFIG_KEY]: patch[LINKED_IDS_CONFIG_KEY] }).manualIds];
+	if ("_linkedDeviceTrackedIds" in patch) {
+		const raw = patch[LINKED_TRACKED_IDS_CONFIG_KEY];
+		const ids = [];
+		if (Array.isArray(raw)) for (const v of raw) {
+			const n = typeof v === "number" ? v : typeof v === "string" ? Number(v) : NaN;
+			if (Number.isInteger(n) && !ids.includes(n)) ids.push(n);
+		}
+		next[LINKED_TRACKED_IDS_CONFIG_KEY] = ids;
+	}
 	await pctx.settings.writeDeviceStore(deviceId, next);
 	return { success: true };
 }

package/dist/builtins/device-manager/device-manager.addon.mjs

@@ -1,4 +1,4 @@
-import { A as getByPath, At as EventCategory, Ct as isDeviceConfigCap, D as evaluateLinkExpression, E as enumerateSchemaFields, H as normalizeUnit, S as deviceStatusCapability, T as enumerateItemArrayFields, W as parseStreamParamsFormPatch, Y as setByPath, a as DeviceStatusSchema, at as BaseAddon, b as deviceManagerCapability, c as STREAM_PROFILE_META, dt as DeviceType, g as applyTransform, i as CAP_NAMES_WITH_STATUS, it as errMsg, kt as sleep, lt as DeviceFeature, mt as WELL_KNOWN_TAB_MAP, rt as validateExpressionSource, t as ALL_CAPABILITY_DEFINITIONS, tt as toExpressionValue, ut as DeviceRole, x as deviceStateCapability, y as buildStreamParamsConfigSchema } from "../../dist-D7-BTTgZ.mjs";
+import { A as getByPath, At as EventCategory, Ct as isDeviceConfigCap, D as evaluateLinkExpression, E as enumerateSchemaFields, H as normalizeUnit, S as deviceStatusCapability, T as enumerateItemArrayFields, W as parseStreamParamsFormPatch, Y as setByPath, a as DeviceStatusSchema, at as BaseAddon, b as deviceManagerCapability, c as STREAM_PROFILE_META, dt as DeviceType, g as applyTransform, i as CAP_NAMES_WITH_STATUS, it as errMsg, kt as sleep, lt as DeviceFeature, mt as WELL_KNOWN_TAB_MAP, rt as validateExpressionSource, t as ALL_CAPABILITY_DEFINITIONS, tt as toExpressionValue, ut as DeviceRole, x as deviceStateCapability, y as buildStreamParamsConfigSchema } from "../../dist-DTTTjPCL.mjs";
 import { canonicalDeviceFingerprint } from "@camstack/types/node";
 import { z } from "zod";
 import { randomUUID } from "node:crypto";
@@ -1204,6 +1204,9 @@ async function testField(pctx, input) {
 /** Reserved device-config keys (cf. `_profileMap`). */
 var LINKED_MODE_CONFIG_KEY = "_linkedDevicesMode";
 var LINKED_IDS_CONFIG_KEY = "_linkedDeviceIds";
+/** Reserved key: subset of linked devices that materialize synthetic tracked
+*  events on the camera. Absent ⇒ ALL linked devices produce tracked events. */
+var LINKED_TRACKED_IDS_CONFIG_KEY = "_linkedDeviceTrackedIds";
 /** Parse the two reserved keys out of a device-config blob. Tolerant:
 *  ids may arrive as numbers or numeric strings (the multiselect field
 *  stores string option values); anything else is dropped. */
@@ -1239,6 +1242,25 @@ function resolveLinkedDeviceIds(params) {
 	ids.delete(selfId);
 	return [...ids];
 }
+/**
+* Which linked devices materialize synthetic tracked events on the camera.
+* Absent / non-array config key ⇒ ALL linked devices (back-compat with the
+* pre-existing "every linked device produces events" behaviour). Otherwise the
+* configured subset intersected with the currently-resolved linked set (a
+* picked id no longer linked is dropped). Ids may arrive as numbers or numeric
+* strings (the multiselect stores string option values); non-numeric entries
+* are ignored.
+*/
+function resolveTrackedEventDeviceIds(config, linkedIds) {
+	const raw = config[LINKED_TRACKED_IDS_CONFIG_KEY];
+	if (!Array.isArray(raw)) return linkedIds;
+	const picked = /* @__PURE__ */ new Set();
+	for (const v of raw) {
+		const n = typeof v === "number" ? v : typeof v === "string" ? Number(v) : NaN;
+		if (Number.isInteger(n)) picked.add(n);
+	}
+	return linkedIds.filter((id) => picked.has(id));
+}
 /** Cap implementation of `getLinkedDevices`. */
 async function getLinkedDevices(pctx, input) {
 	const { deviceId } = input;
@@ -1251,6 +1273,7 @@ async function getLinkedDevices(pctx, input) {
 		config,
 		candidates: all
 	});
+	const trackedIds = new Set(resolveTrackedEventDeviceIds(blob, ids));
 	const devices = [];
 	for (const id of ids) {
 		const d = byId.get(id);
@@ -1259,7 +1282,8 @@ async function getLinkedDevices(pctx, input) {
 			deviceId: d.id,
 			name: d.name,
 			location: d.location,
-			features: d.features
+			features: d.features,
+			producesTrackedEvents: trackedIds.has(d.id)
 		});
 	}
 	return {
@@ -1282,36 +1306,63 @@ async function buildLinkedDevicesContribution(pctx, deviceId) {
 		value: String(d.id),
 		label: d.location !== null ? `${d.name} (${d.location})` : d.name
 	}));
+	const linkedIds = resolveLinkedDeviceIds({
+		selfId: deviceId,
+		selfLocation: all.find((d) => d.id === deviceId)?.location ?? null,
+		config,
+		candidates: all
+	});
+	const byId = new Map(all.map((d) => [d.id, d]));
+	const trackedOptions = linkedIds.flatMap((id) => {
+		const d = byId.get(id);
+		if (!d) return [];
+		return [{
+			value: String(d.id),
+			label: d.location !== null ? `${d.name} (${d.location})` : d.name
+		}];
+	});
+	const trackedValue = resolveTrackedEventDeviceIds(blob, linkedIds).map(String);
 	return { sections: [{
 		id: "linked-devices",
 		title: "Linked devices",
 		description: "Companion devices associated with this camera. Device-tree children are always linked; auto mode also links every device sharing the camera location, manual mode links the picked list instead.",
 		order: 70,
-		fields: [{
-			type: "select",
-			key: LINKED_MODE_CONFIG_KEY,
-			label: "Link mode",
-			description: "Auto: children + same-location devices. Manual: children + the list below.",
-			options: [{
-				value: "auto",
-				label: "Auto (location-based)"
-			}, {
-				value: "manual",
-				label: "Manual"
-			}],
-			value: config.mode
-		}, {
-			type: "multiselect",
-			key: LINKED_IDS_CONFIG_KEY,
-			label: "Manually linked devices",
-			description: "Used in manual mode (children stay linked regardless).",
-			showWhen: {
-				field: LINKED_MODE_CONFIG_KEY,
-				equals: "manual"
+		fields: [
+			{
+				type: "select",
+				key: LINKED_MODE_CONFIG_KEY,
+				label: "Link mode",
+				description: "Auto: children + same-location devices. Manual: children + the list below.",
+				options: [{
+					value: "auto",
+					label: "Auto (location-based)"
+				}, {
+					value: "manual",
+					label: "Manual"
+				}],
+				value: config.mode
 			},
-			options,
-			value: config.manualIds.map(String)
-		}]
+			{
+				type: "multiselect",
+				key: LINKED_IDS_CONFIG_KEY,
+				label: "Manually linked devices",
+				description: "Used in manual mode (children stay linked regardless).",
+				showWhen: {
+					field: LINKED_MODE_CONFIG_KEY,
+					equals: "manual"
+				},
+				options,
+				value: config.manualIds.map(String)
+			},
+			{
+				type: "multiselect",
+				key: LINKED_TRACKED_IDS_CONFIG_KEY,
+				label: "Devices that produce tracked events",
+				description: "Linked devices whose state changes materialize a synthetic tracked event on this camera. Default: all linked devices.",
+				options: trackedOptions,
+				value: trackedValue
+			}
+		]
 	}] };
 }
 /**
@@ -1324,6 +1375,15 @@ async function applyLinkedDevicesPatch(pctx, deviceId, patch) {
 	const next = { ...await pctx.settings.readDeviceStore(deviceId) };
 	if ("_linkedDevicesMode" in patch) next[LINKED_MODE_CONFIG_KEY] = patch["_linkedDevicesMode"] === "manual" ? "manual" : "auto";
 	if ("_linkedDeviceIds" in patch) next[LINKED_IDS_CONFIG_KEY] = [...parseLinkedDevicesConfig({ [LINKED_IDS_CONFIG_KEY]: patch[LINKED_IDS_CONFIG_KEY] }).manualIds];
+	if ("_linkedDeviceTrackedIds" in patch) {
+		const raw = patch[LINKED_TRACKED_IDS_CONFIG_KEY];
+		const ids = [];
+		if (Array.isArray(raw)) for (const v of raw) {
+			const n = typeof v === "number" ? v : typeof v === "string" ? Number(v) : NaN;
+			if (Number.isInteger(n) && !ids.includes(n)) ids.push(n);
+		}
+		next[LINKED_TRACKED_IDS_CONFIG_KEY] = ids;
+	}
 	await pctx.settings.writeDeviceStore(deviceId, next);
 	return { success: true };
 }

package/dist/builtins/doorbell/virtual-doorbell.addon.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-B9OD5Tdn.js");
+const require_dist = require("../../dist-CkdNC8US.js");
 //#region src/builtins/doorbell/trigger-engine.ts
 /**
 * Pure trigger logic for the virtual-doorbell builtin — edge detection over

package/dist/builtins/doorbell/virtual-doorbell.addon.mjs

@@ -1,4 +1,4 @@
-import { At as EventCategory, C as doorbellCapability, at as BaseAddon, dt as DeviceType, it as errMsg, vt as createEvent } from "../../dist-D7-BTTgZ.mjs";
+import { At as EventCategory, C as doorbellCapability, at as BaseAddon, dt as DeviceType, it as errMsg, vt as createEvent } from "../../dist-DTTTjPCL.mjs";
 //#region src/builtins/doorbell/trigger-engine.ts
 /**
 * Pure trigger logic for the virtual-doorbell builtin — edge detection over

package/dist/builtins/hub-forwarder/index.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-B9OD5Tdn.js");
+const require_dist = require("../../dist-CkdNC8US.js");
 const require_formatter = require("../../formatter-DqAKDlvN.js");
 //#region src/builtins/hub-forwarder/hub-forwarder-destination.ts
 var DEFAULT_OUTBOUND_BUFFER_SIZE = 500;

package/dist/builtins/hub-forwarder/index.mjs

@@ -1,4 +1,4 @@
-import { R as logDestinationCapability, at as BaseAddon } from "../../dist-D7-BTTgZ.mjs";
+import { R as logDestinationCapability, at as BaseAddon } from "../../dist-DTTTjPCL.mjs";
 import { t as formatLogLine } from "../../formatter-B7qW8bPJ.mjs";
 //#region src/builtins/hub-forwarder/hub-forwarder-destination.ts
 var DEFAULT_OUTBOUND_BUFFER_SIZE = 500;

package/dist/builtins/local-auth/local-auth.addon.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 const require_chunk = require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-B9OD5Tdn.js");
+const require_dist = require("../../dist-CkdNC8US.js");
 let node_crypto = require("node:crypto");
 node_crypto = require_chunk.__toESM(node_crypto);
 let crypto$1 = require("crypto");

package/dist/builtins/local-auth/local-auth.addon.mjs

@@ -1,4 +1,4 @@
-import { _ as authProviderCapability, at as BaseAddon, d as UserRecordSchema, l as ScopedTokenSchema, nt as userManagementCapability, r as ApiKeyRecordSchema } from "../../dist-D7-BTTgZ.mjs";
+import { _ as authProviderCapability, at as BaseAddon, d as UserRecordSchema, l as ScopedTokenSchema, nt as userManagementCapability, r as ApiKeyRecordSchema } from "../../dist-DTTTjPCL.mjs";
 import { createRequire } from "node:module";
 import * as crypto$1 from "node:crypto";
 import { randomUUID } from "node:crypto";

package/dist/builtins/local-network/local-network.addon.js

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_chunk = require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-B9OD5Tdn.js");
+const require_dist = require("../../dist-CkdNC8US.js");
 let node_os = require("node:os");
 node_os = require_chunk.__toESM(node_os);
 //#region src/builtins/local-network/local-network.addon.ts

package/dist/builtins/local-network/local-network.addon.mjs

@@ -1,4 +1,4 @@
-import { At as EventCategory, L as localNetworkCapability, at as BaseAddon } from "../../dist-D7-BTTgZ.mjs";
+import { At as EventCategory, L as localNetworkCapability, at as BaseAddon } from "../../dist-DTTTjPCL.mjs";
 import * as os from "node:os";
 //#region src/builtins/local-network/local-network.addon.ts
 /**

package/dist/builtins/native-metrics/native-metrics.addon.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 const require_chunk = require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-B9OD5Tdn.js");
+const require_dist = require("../../dist-CkdNC8US.js");
 let node_fs = require("node:fs");
 node_fs = require_chunk.__toESM(node_fs);
 let node_child_process = require("node:child_process");

package/dist/builtins/native-metrics/native-metrics.addon.mjs

@@ -1,4 +1,4 @@
-import { At as EventCategory, B as metricsProviderCapability, at as BaseAddon, vt as createEvent } from "../../dist-D7-BTTgZ.mjs";
+import { At as EventCategory, B as metricsProviderCapability, at as BaseAddon, vt as createEvent } from "../../dist-DTTTjPCL.mjs";
 import * as fs from "node:fs";
 import { execFile, execFileSync } from "node:child_process";
 import { promisify } from "node:util";

package/dist/builtins/platform-probe/index.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 const require_chunk = require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-B9OD5Tdn.js");
+const require_dist = require("../../dist-CkdNC8US.js");
 let node_fs = require("node:fs");
 node_fs = require_chunk.__toESM(node_fs);
 let node_child_process = require("node:child_process");

package/dist/builtins/platform-probe/index.mjs

@@ -1,4 +1,4 @@
-import { At as EventCategory, G as platformProbeCapability, J as scoreRuntimes, at as BaseAddon, bt as emitReadiness, it as errMsg, w as enumerateInferenceDevices } from "../../dist-D7-BTTgZ.mjs";
+import { At as EventCategory, G as platformProbeCapability, J as scoreRuntimes, at as BaseAddon, bt as emitReadiness, it as errMsg, w as enumerateInferenceDevices } from "../../dist-DTTTjPCL.mjs";
 import * as fs from "node:fs";
 import { execFile } from "node:child_process";
 import { promisify } from "node:util";

package/dist/builtins/remote-access-orchestrator/remote-access-orchestrator.addon.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-B9OD5Tdn.js");
+const require_dist = require("../../dist-CkdNC8US.js");
 //#region src/builtins/remote-access-orchestrator/enabled-providers-reconcile.ts
 /**
 * Reconcile the durable `enabledProviders` set against authoritative

package/dist/builtins/remote-access-orchestrator/remote-access-orchestrator.addon.mjs

@@ -1,4 +1,4 @@
-import { At as EventCategory, at as BaseAddon } from "../../dist-D7-BTTgZ.mjs";
+import { At as EventCategory, at as BaseAddon } from "../../dist-DTTTjPCL.mjs";
 //#region src/builtins/remote-access-orchestrator/enabled-providers-reconcile.ts
 /**
 * Reconcile the durable `enabledProviders` set against authoritative

package/dist/builtins/snapshot/index.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-B9OD5Tdn.js");
+const require_dist = require("../../dist-CkdNC8US.js");
 let node_child_process = require("node:child_process");
 //#region src/builtins/snapshot/snapshot-coalescing.ts
 /**

package/dist/builtins/snapshot/index.mjs

@@ -1,4 +1,4 @@
-import { V as nodePin, Z as snapshotCapability, at as BaseAddon, dt as DeviceType, et as streamQualityLabel, it as errMsg, lt as DeviceFeature } from "../../dist-D7-BTTgZ.mjs";
+import { V as nodePin, Z as snapshotCapability, at as BaseAddon, dt as DeviceType, et as streamQualityLabel, it as errMsg, lt as DeviceFeature } from "../../dist-DTTTjPCL.mjs";
 import { execFile } from "node:child_process";
 //#region src/builtins/snapshot/snapshot-coalescing.ts
 /**

package/dist/builtins/sqlite-storage/filesystem-storage.addon.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 const require_chunk = require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-B9OD5Tdn.js");
+const require_dist = require("../../dist-CkdNC8US.js");
 let node_fs = require("node:fs");
 node_fs = require_chunk.__toESM(node_fs);
 let node_path = require("node:path");

package/dist/builtins/sqlite-storage/filesystem-storage.addon.mjs

@@ -1,4 +1,4 @@
-import { $ as storageProviderCapability, at as BaseAddon, k as filesystemBrowseCapability } from "../../dist-D7-BTTgZ.mjs";
+import { $ as storageProviderCapability, at as BaseAddon, k as filesystemBrowseCapability } from "../../dist-DTTTjPCL.mjs";
 import * as fs from "node:fs";
 import * as path$1 from "node:path";
 import { basename, dirname, join, resolve, sep } from "node:path";

package/dist/builtins/sqlite-storage/sqlite-settings.addon.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 const require_chunk = require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-B9OD5Tdn.js");
+const require_dist = require("../../dist-CkdNC8US.js");
 let node_crypto = require("node:crypto");
 let better_sqlite3 = require("better-sqlite3");
 better_sqlite3 = require_chunk.__toESM(better_sqlite3);

package/dist/builtins/sqlite-storage/sqlite-settings.addon.mjs

@@ -1,4 +1,4 @@
-import { Tt as parseJsonUnknown, X as settingsStoreCapability, at as BaseAddon, ht as asJsonObject, it as errMsg, s as RUNTIME_DEFAULTS } from "../../dist-D7-BTTgZ.mjs";
+import { Tt as parseJsonUnknown, X as settingsStoreCapability, at as BaseAddon, ht as asJsonObject, it as errMsg, s as RUNTIME_DEFAULTS } from "../../dist-DTTTjPCL.mjs";
 import { randomUUID } from "node:crypto";
 import Database from "better-sqlite3";
 //#region src/builtins/sqlite-storage/sqlite-settings-backend.ts

package/dist/builtins/storage-orchestrator/storage-orchestrator.addon.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 const require_chunk = require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-B9OD5Tdn.js");
+const require_dist = require("../../dist-CkdNC8US.js");
 let node_path = require("node:path");
 node_path = require_chunk.__toESM(node_path);
 let node_fs_promises = require("node:fs/promises");

package/dist/builtins/storage-orchestrator/storage-orchestrator.addon.mjs

@@ -1,4 +1,4 @@
-import { Q as storageCapability, at as BaseAddon, u as StorageLocationTypeSchema, wt as parseJsonObject } from "../../dist-D7-BTTgZ.mjs";
+import { Q as storageCapability, at as BaseAddon, u as StorageLocationTypeSchema, wt as parseJsonObject } from "../../dist-DTTTjPCL.mjs";
 import * as path$1 from "node:path";
 import * as fs from "node:fs/promises";
 import { buildStorageLocationRegistry } from "@camstack/system";

package/dist/builtins/system-config/system-config.addon.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-B9OD5Tdn.js");
+const require_dist = require("../../dist-CkdNC8US.js");
 //#region src/builtins/system-config/system-config.addon.ts
 /**
 * Built-in `system-config` addon — Phase 4 of the settings redesign.

package/dist/builtins/system-config/system-config.addon.mjs

@@ -1,4 +1,4 @@
-import { St as hydrateSchema, at as BaseAddon, it as errMsg } from "../../dist-D7-BTTgZ.mjs";
+import { St as hydrateSchema, at as BaseAddon, it as errMsg } from "../../dist-DTTTjPCL.mjs";
 //#region src/builtins/system-config/system-config.addon.ts
 /**
 * Built-in `system-config` addon — Phase 4 of the settings redesign.

package/dist/builtins/winston-logging/index.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 const require_chunk = require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-B9OD5Tdn.js");
+const require_dist = require("../../dist-CkdNC8US.js");
 const require_formatter = require("../../formatter-DqAKDlvN.js");
 let node_path = require("node:path");
 node_path = require_chunk.__toESM(node_path);

package/dist/builtins/winston-logging/index.mjs

@@ -1,4 +1,4 @@
-import { R as logDestinationCapability, at as BaseAddon } from "../../dist-D7-BTTgZ.mjs";
+import { R as logDestinationCapability, at as BaseAddon } from "../../dist-DTTTjPCL.mjs";
 import { t as formatLogLine } from "../../formatter-B7qW8bPJ.mjs";
 import * as path$1 from "node:path";
 import path from "node:path";

package/dist/{dist-B9OD5Tdn.js → dist-CkdNC8US.js}

@@ -8495,7 +8495,8 @@ var PipelineStepInputSchema = zod.z.lazy(() => zod.z.object({
 	modelId: zod.z.string().optional(),
 	enabled: zod.z.boolean().default(true),
 	children: zod.z.array(PipelineStepInputSchema).optional(),
-	settings: zod.z.record(zod.z.string(), zod.z.unknown()).optional()
+	settings: zod.z.record(zod.z.string(), zod.z.unknown()).optional(),
+	jumpDeviceKey: zod.z.string().optional()
 }));
 var ModelSubstitutionSchema = zod.z.object({
 	addonId: zod.z.string(),
@@ -8986,10 +8987,40 @@ var NativeCropBboxSchema = zod.z.object({
 });
 /** Result of a best-effort native-resolution crop (`getNativeCrop`). */
 var NativeCropResultSchema = zod.z.object({
-	/** Packed rgb (24-bit) pixels of the crop. */
-	bytes: zod.z.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: zod.z.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: zod.z.string().optional(),
 	width: zod.z.number().int().positive(),
-	height: zod.z.number().int().positive()
+	height: zod.z.number().int().positive(),
+	/**
+	* Which source served this crop, so a quality-sensitive consumer (the native
+	* `keyFrame`) can reject a degraded fallback:
+	* - `native` — cut from the decode worker's retained NATIVE surface (the
+	*   quality path).
+	* - `ram-fullframe` — the native surface MISSED but the request was full-frame,
+	*   so the ≤640 RAM `RetainedFrameStore` served it (honest lower-res; legit for
+	*   the blank-frame guard / 640-snapshot resolve, NOT for the clean keyFrame).
+	*
+	* OPTIONAL: a pre-tier runner (version skew) omits it — an ABSENT `tier` MUST be
+	* treated as `native` (accepted) by every consumer so mixed-version clusters
+	* keep the pre-tier behaviour. An ROI miss returns `null` (no tier at all).
+	*/
+	tier: zod.z.enum(["native", "ram-fullframe"]).optional()
 });
 /** Parent detection context passed to `runDetailSubtree` — the crop's
 *  originating detection, in FRAME-space coordinates. Reuses
@@ -9119,6 +9150,20 @@ var RunnerFrameSourceSchema = zod.z.discriminatedUnion("kind", [zod.z.object({ k
 	hubHostnameOverride: zod.z.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 = zod.z.object({
+	deviceKey: zod.z.string(),
+	weight: zod.z.number().positive().default(1),
+	maxSessions: zod.z.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.
@@ -9236,7 +9281,16 @@ var RunnerCameraConfigSchema = zod.z.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: zod.z.string().optional()
+	deviceKey: zod.z.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: zod.z.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;
 /**
@@ -9343,15 +9397,31 @@ var pipelineRunnerCapability = {
 		* `FrameHandle` that rode an inference-result event and a normalized `bbox`,
 		* the runner asks the decode worker still holding that frame's NATIVE
 		* surface to GPU/CPU-crop ONLY the ROI at native res and download just the
-		* crop. Returns `null` on a miss (handle not registered, or the worker's
-		* tiny native-retention ring already evicted the frame) — the caller falls
-		* back to a detection-frame crop. Routed to the frame's owning node by
-		* `handle.nodeId`; NEVER ships a full native frame.
+		* crop. Routed to the frame's owning node by `handle.nodeId`; NEVER ships a
+		* full native frame.
+		*
+		* Miss behaviour differs by request shape (see `NativeCropResultSchema.tier`):
+		* - an ROI (subject-crop) miss returns `null` — the caller reports the miss
+		*   and retries; it is NEVER handed a ≤640 crop masquerading as native.
+		* - a FULL-FRAME miss falls back to the ≤640 RAM `RetainedFrameStore`, tagged
+		*   `tier: 'ram-fullframe'` (honest lower-res for the blank-frame guard /
+		*   640-snapshot resolve). A native hit is tagged `tier: 'native'`.
 		*/
 		getNativeCrop: method(zod.z.object({
 			handle: FrameHandleSchema,
 			bbox: NativeCropBboxSchema,
-			maxWidth: zod.z.number().int().positive().optional()
+			maxWidth: zod.z.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: zod.z.boolean().optional()
 		}), NativeCropResultSchema.nullable()),
 		/**
 		* Two-plane design: run the DETAIL subtree (crop children —
@@ -14081,7 +14151,8 @@ var LinkedDeviceSchema = zod.z.object({
 	deviceId: zod.z.number(),
 	name: zod.z.string(),
 	location: zod.z.string().nullable(),
-	features: zod.z.array(zod.z.string())
+	features: zod.z.array(zod.z.string()),
+	producesTrackedEvents: zod.z.boolean().optional()
 });
 var SavedDeviceRowSchema = zod.z.object({
 	/** Numeric id reserved at allocateDeviceId time. */
@@ -16307,6 +16378,7 @@ var TrackSchema = zod.z.object({
 	deviceId: zod.z.number(),
 	className: zod.z.string(),
 	label: zod.z.string().optional(),
+	producingDeviceName: zod.z.string().optional(),
 	/** Track provenance. Absent ⇒ `pipeline` (legacy rows). */
 	source: TrackSourceSchema.optional(),
 	firstSeen: zod.z.number(),
@@ -16444,7 +16516,8 @@ var MediaFileKindEnum = zod.z.enum([
 	"fullFrameBoxed",
 	"faceCrop",
 	"plateCrop",
-	"keyFrame"
+	"keyFrame",
+	"keyFrameSmall"
 ]);
 var MediaFileSchema = zod.z.object({
 	key: zod.z.string(),
@@ -16926,7 +16999,16 @@ var PipelineTemplateSchema = zod.z.object({
 });
 var DeviceStepConfigSchema = zod.z.object({
 	modelId: zod.z.string().optional(),
-	settings: zod.z.record(zod.z.string(), zod.z.unknown()).optional()
+	settings: zod.z.record(zod.z.string(), zod.z.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: zod.z.string().optional()
 });
 var AgentPipelineSettingsSchema = zod.z.object({
 	maxCameras: zod.z.number().int().nonnegative().nullable().default(null),

package/dist/{dist-D7-BTTgZ.mjs → dist-DTTTjPCL.mjs}

@@ -8495,7 +8495,8 @@ var PipelineStepInputSchema = z.lazy(() => z.object({
 	modelId: z.string().optional(),
 	enabled: z.boolean().default(true),
 	children: z.array(PipelineStepInputSchema).optional(),
-	settings: z.record(z.string(), z.unknown()).optional()
+	settings: z.record(z.string(), z.unknown()).optional(),
+	jumpDeviceKey: z.string().optional()
 }));
 var ModelSubstitutionSchema = z.object({
 	addonId: z.string(),
@@ -8986,10 +8987,40 @@ var NativeCropBboxSchema = z.object({
 });
 /** Result of a best-effort native-resolution crop (`getNativeCrop`). */
 var NativeCropResultSchema = z.object({
-	/** Packed rgb (24-bit) pixels of the crop. */
-	bytes: z.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: z.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: z.string().optional(),
 	width: z.number().int().positive(),
-	height: z.number().int().positive()
+	height: z.number().int().positive(),
+	/**
+	* Which source served this crop, so a quality-sensitive consumer (the native
+	* `keyFrame`) can reject a degraded fallback:
+	* - `native` — cut from the decode worker's retained NATIVE surface (the
+	*   quality path).
+	* - `ram-fullframe` — the native surface MISSED but the request was full-frame,
+	*   so the ≤640 RAM `RetainedFrameStore` served it (honest lower-res; legit for
+	*   the blank-frame guard / 640-snapshot resolve, NOT for the clean keyFrame).
+	*
+	* OPTIONAL: a pre-tier runner (version skew) omits it — an ABSENT `tier` MUST be
+	* treated as `native` (accepted) by every consumer so mixed-version clusters
+	* keep the pre-tier behaviour. An ROI miss returns `null` (no tier at all).
+	*/
+	tier: z.enum(["native", "ram-fullframe"]).optional()
 });
 /** Parent detection context passed to `runDetailSubtree` — the crop's
 *  originating detection, in FRAME-space coordinates. Reuses
@@ -9119,6 +9150,20 @@ var RunnerFrameSourceSchema = z.discriminatedUnion("kind", [z.object({ kind: z.l
 	hubHostnameOverride: z.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 = z.object({
+	deviceKey: z.string(),
+	weight: z.number().positive().default(1),
+	maxSessions: z.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.
@@ -9236,7 +9281,16 @@ var RunnerCameraConfigSchema = z.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: z.string().optional()
+	deviceKey: z.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: z.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;
 /**
@@ -9343,15 +9397,31 @@ var pipelineRunnerCapability = {
 		* `FrameHandle` that rode an inference-result event and a normalized `bbox`,
 		* the runner asks the decode worker still holding that frame's NATIVE
 		* surface to GPU/CPU-crop ONLY the ROI at native res and download just the
-		* crop. Returns `null` on a miss (handle not registered, or the worker's
-		* tiny native-retention ring already evicted the frame) — the caller falls
-		* back to a detection-frame crop. Routed to the frame's owning node by
-		* `handle.nodeId`; NEVER ships a full native frame.
+		* crop. Routed to the frame's owning node by `handle.nodeId`; NEVER ships a
+		* full native frame.
+		*
+		* Miss behaviour differs by request shape (see `NativeCropResultSchema.tier`):
+		* - an ROI (subject-crop) miss returns `null` — the caller reports the miss
+		*   and retries; it is NEVER handed a ≤640 crop masquerading as native.
+		* - a FULL-FRAME miss falls back to the ≤640 RAM `RetainedFrameStore`, tagged
+		*   `tier: 'ram-fullframe'` (honest lower-res for the blank-frame guard /
+		*   640-snapshot resolve). A native hit is tagged `tier: 'native'`.
 		*/
 		getNativeCrop: method(z.object({
 			handle: FrameHandleSchema,
 			bbox: NativeCropBboxSchema,
-			maxWidth: z.number().int().positive().optional()
+			maxWidth: z.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: z.boolean().optional()
 		}), NativeCropResultSchema.nullable()),
 		/**
 		* Two-plane design: run the DETAIL subtree (crop children —
@@ -14081,7 +14151,8 @@ var LinkedDeviceSchema = z.object({
 	deviceId: z.number(),
 	name: z.string(),
 	location: z.string().nullable(),
-	features: z.array(z.string())
+	features: z.array(z.string()),
+	producesTrackedEvents: z.boolean().optional()
 });
 var SavedDeviceRowSchema = z.object({
 	/** Numeric id reserved at allocateDeviceId time. */
@@ -16307,6 +16378,7 @@ var TrackSchema = z.object({
 	deviceId: z.number(),
 	className: z.string(),
 	label: z.string().optional(),
+	producingDeviceName: z.string().optional(),
 	/** Track provenance. Absent ⇒ `pipeline` (legacy rows). */
 	source: TrackSourceSchema.optional(),
 	firstSeen: z.number(),
@@ -16444,7 +16516,8 @@ var MediaFileKindEnum = z.enum([
 	"fullFrameBoxed",
 	"faceCrop",
 	"plateCrop",
-	"keyFrame"
+	"keyFrame",
+	"keyFrameSmall"
 ]);
 var MediaFileSchema = z.object({
 	key: z.string(),
@@ -16926,7 +16999,16 @@ var PipelineTemplateSchema = z.object({
 });
 var DeviceStepConfigSchema = z.object({
 	modelId: z.string().optional(),
-	settings: z.record(z.string(), z.unknown()).optional()
+	settings: z.record(z.string(), z.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: z.string().optional()
 });
 var AgentPipelineSettingsSchema = z.object({
 	maxCameras: z.number().int().nonnegative().nullable().default(null),

package/dist/index.js

@@ -1,8 +1,8 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_chunk = require("./chunk-Cek0wNdY.js");
-const require_dist = require("./dist-B9OD5Tdn.js");
+const require_dist = require("./dist-CkdNC8US.js");
 const require_model_download_service = require("./model-download-service-hf0ookyy.js");
-const require_manifest_python_deps = require("./manifest-python-deps-DXqcuOha.js");
+const require_manifest_python_deps = require("./manifest-python-deps-DRq5MreI.js");
 const require_resource_monitor = require("./resource-monitor-DNNomR-i.js");
 const require_builtins_sqlite_storage_filesystem_storage_addon = require("./builtins/sqlite-storage/filesystem-storage.addon.js");
 const require_builtins_sqlite_storage_sqlite_settings_addon = require("./builtins/sqlite-storage/sqlite-settings.addon.js");

package/dist/index.mjs

@@ -1,6 +1,6 @@
-import { At as EventCategory$1, Dt as resolveCapMount, Et as readinessKey, F as kebabToCamel, I as lifecycleJobSchema, K as procedureAuthKey, M as isCollectionArrayMethod, N as isObjectInput, O as extractNestedAddonId, Ot as scopeKey, P as isVoidInput, Tt as parseJsonUnknown$1, U as objectInputDeclaresAddonId, _t as asString$1, ct as DEVICE_STATUS_METHOD, ft as ReadinessRegistry, gt as asNumber, ht as asJsonObject$1, it as errMsg$1, j as isArrayOutputSchema, o as METHOD_ACCESS_MAP, ot as DATAPLANE_SECRET_HEADER$1, p as addonSettingsCapability, pt as ReadinessTimeoutError, s as RUNTIME_DEFAULTS, st as DEVICE_SETTINGS_CONTRIBUTION_METHODS, t as ALL_CAPABILITY_DEFINITIONS, vt as createEvent, wt as parseJsonObject, xt as expandCapMethods, yt as emitDownForOwnedCaps, z as looseSchema } from "./dist-D7-BTTgZ.mjs";
+import { At as EventCategory$1, Dt as resolveCapMount, Et as readinessKey, F as kebabToCamel, I as lifecycleJobSchema, K as procedureAuthKey, M as isCollectionArrayMethod, N as isObjectInput, O as extractNestedAddonId, Ot as scopeKey, P as isVoidInput, Tt as parseJsonUnknown$1, U as objectInputDeclaresAddonId, _t as asString$1, ct as DEVICE_STATUS_METHOD, ft as ReadinessRegistry, gt as asNumber, ht as asJsonObject$1, it as errMsg$1, j as isArrayOutputSchema, o as METHOD_ACCESS_MAP, ot as DATAPLANE_SECRET_HEADER$1, p as addonSettingsCapability, pt as ReadinessTimeoutError, s as RUNTIME_DEFAULTS, st as DEVICE_SETTINGS_CONTRIBUTION_METHODS, t as ALL_CAPABILITY_DEFINITIONS, vt as createEvent, wt as parseJsonObject, xt as expandCapMethods, yt as emitDownForOwnedCaps, z as looseSchema } from "./dist-DTTTjPCL.mjs";
 import { a as downloadModel, c as getModelFilePath, d as contentTypeFor, f as createAuthenticatedFileServer, h as resolveFilePath, i as downloadFile, l as isModelDownloaded, m as parseTokenizedUrl, n as collectModelFiles, o as ensureModel, p as parseRangeHeader, r as deleteModelFromDisk, s as fetchJson, t as ModelDownloadService, u as createFileDataPlaneHandler } from "./model-download-service-Cp9f4dk6.mjs";
-import { $ as buildNativeCapProxy, A as createHubCapForwardService, B as AGENT_CAP_FWD_ACTION, C as brokerTransportLink, Ct as createAddonDataPlaneFacility, D as localProviderLink, E as ipcParentLink, F as createUdsLogger, G as callWithServiceDiscovery, H as CapRouteResolver, I as createUdsLoggerWithControl, J as UdsLocalTransportServer, K as createLocalTransport, L as LocalChildClient, M as createUdsEventBridge, N as createUdsEventBus, O as HUB_CAP_FWD_ACTION, P as udsChildLogToWorkerEntry, Q as encodeFrame, R as LocalChildRegistry, S as brokerCallForCap, St as resolveAddonClass, T as ipcChildLink, U as CapRouteError, V as AGENT_CAP_FWD_SERVICE, W as classifyCapRoute, X as localEndpointPath, Y as SocketChannel, Z as FrameDecoder, _ as createKernelHwAccel, _t as CapabilityHandle, a as getWorkerDeviceRegistry, b as __resetCapUsageRegistryForTests, bt as resolveNpmInvocation, c as setHubConnected, ct as NATIVE_PROVIDER_SERVICE_INFIX, d as getBrokerEventBus, dt as capBareAction, et as buildUdsNativeCapProxy, f as getMoleculerEventStats, ft as capServiceName, g as AddonDepsManager, gt as DeviceRegistry, h as subscribePassthrough, ht as serializeTypedArrays, i as createUdsAddonContext, it as mountNativeCapService, j as createParentUnownedCallHandler, k as HUB_CAP_FWD_SERVICE, l as EVENT_TOPIC_PREFIX, lt as capActionName, m as setNodeEventInterest, mt as deserializeTypedArrays, n as adaptBrokerToCluster, o as getOrInitReadinessRegistry, ot as createAddonService, p as registerEventBusService, pt as parseCapAction, q as UdsLocalTransportClient, r as createAddonContext, s as getOrInitReadinessRegistryForClient, st as validateProviderRegistrations, t as installManifestPythonDeps, tt as createBrokerDeviceManagerApi, u as clusterEventTopic, ut as capActionSuffix, v as resolveHwAccel, vt as CapabilityUnavailableError, w as buildLinkChain, x as getCapUsageRegistry, xt as runNpm, y as CapUsageRegistry, yt as installManifestNativeDeps, z as UDS_NO_ROUTE_PREFIX } from "./manifest-python-deps-D7EIakIT.mjs";
+import { $ as buildNativeCapProxy, A as createHubCapForwardService, B as AGENT_CAP_FWD_ACTION, C as brokerTransportLink, Ct as createAddonDataPlaneFacility, D as localProviderLink, E as ipcParentLink, F as createUdsLogger, G as callWithServiceDiscovery, H as CapRouteResolver, I as createUdsLoggerWithControl, J as UdsLocalTransportServer, K as createLocalTransport, L as LocalChildClient, M as createUdsEventBridge, N as createUdsEventBus, O as HUB_CAP_FWD_ACTION, P as udsChildLogToWorkerEntry, Q as encodeFrame, R as LocalChildRegistry, S as brokerCallForCap, St as resolveAddonClass, T as ipcChildLink, U as CapRouteError, V as AGENT_CAP_FWD_SERVICE, W as classifyCapRoute, X as localEndpointPath, Y as SocketChannel, Z as FrameDecoder, _ as createKernelHwAccel, _t as CapabilityHandle, a as getWorkerDeviceRegistry, b as __resetCapUsageRegistryForTests, bt as resolveNpmInvocation, c as setHubConnected, ct as NATIVE_PROVIDER_SERVICE_INFIX, d as getBrokerEventBus, dt as capBareAction, et as buildUdsNativeCapProxy, f as getMoleculerEventStats, ft as capServiceName, g as AddonDepsManager, gt as DeviceRegistry, h as subscribePassthrough, ht as serializeTypedArrays, i as createUdsAddonContext, it as mountNativeCapService, j as createParentUnownedCallHandler, k as HUB_CAP_FWD_SERVICE, l as EVENT_TOPIC_PREFIX, lt as capActionName, m as setNodeEventInterest, mt as deserializeTypedArrays, n as adaptBrokerToCluster, o as getOrInitReadinessRegistry, ot as createAddonService, p as registerEventBusService, pt as parseCapAction, q as UdsLocalTransportClient, r as createAddonContext, s as getOrInitReadinessRegistryForClient, st as validateProviderRegistrations, t as installManifestPythonDeps, tt as createBrokerDeviceManagerApi, u as clusterEventTopic, ut as capActionSuffix, v as resolveHwAccel, vt as CapabilityUnavailableError, w as buildLinkChain, x as getCapUsageRegistry, xt as runNpm, y as CapUsageRegistry, yt as installManifestNativeDeps, z as UDS_NO_ROUTE_PREFIX } from "./manifest-python-deps-s_-uULmp.mjs";
 import { n as getSinglePidStats, t as getPidStats } from "./resource-monitor-Le3l0qS2.mjs";
 import { FilesystemStorageAddon, t as FilesystemStorageProvider } from "./builtins/sqlite-storage/filesystem-storage.addon.mjs";
 import { SqliteSettingsAddon, t as SqliteSettingsBackend } from "./builtins/sqlite-storage/sqlite-settings.addon.mjs";

package/dist/{manifest-python-deps-DXqcuOha.js → manifest-python-deps-DRq5MreI.js}

@@ -1,5 +1,5 @@
 const require_chunk = require("./chunk-Cek0wNdY.js");
-const require_dist = require("./dist-B9OD5Tdn.js");
+const require_dist = require("./dist-CkdNC8US.js");
 let _camstack_types_node = require("@camstack/types/node");
 let node_http = require("node:http");
 let node_fs = require("node:fs");

package/dist/{manifest-python-deps-D7EIakIT.mjs → manifest-python-deps-s_-uULmp.mjs}

@@ -1,4 +1,4 @@
-import { q as readNodePin } from "./dist-D7-BTTgZ.mjs";
+import { q as readNodePin } from "./dist-DTTTjPCL.mjs";
 import { ensureBinary, ensureFfmpeg, ensurePython, installPythonPackages, installPythonRequirements } from "@camstack/types/node";
 import { createServer } from "node:http";
 import * as fs from "node:fs";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/system",
-  "version": "1.2.0",
+  "version": "1.2.2",
   "description": "Core addon for CamStack — builtins, pipeline, process management, auth, logging, events",
   "keywords": [
     "camstack",