@camstack/system 1.1.28 → 1.1.30

package/dist/builtins/device-manager/day-night-config-schema.d.ts

@@ -0,0 +1,16 @@
+import { ConfigUISchema, DayNightOptions, DayNightSettingsPatch, DayNightStatus } from '@camstack/types';
+/**
+ * Build the `day-night` `ConfigUISchema` from the camera-probed options +
+ * current status. Returns `null` when the camera exposes no configurable
+ * property — the cap then reports "no schema" and the renderer shows the
+ * unsupported-camera message.
+ */
+export declare function buildDayNightConfigSchema(options: DayNightOptions, status: DayNightStatus | null): ConfigUISchema | null;
+/**
+ * Re-parse a flat `ConfigFormBuilder` patch into a `DayNightSettingsPatch`.
+ * Returns an empty object when no `dayNight_*` field changed — the caller
+ * (`parseDerivedFormSettingsPatch`) forwards the result verbatim to the
+ * cap's `setSettings` mutation, which itself ignores fields it doesn't
+ * support.
+ */
+export declare function parseDayNightFormPatch(patch: Record<string, unknown>): DayNightSettingsPatch;

package/dist/builtins/device-manager/device-aggregation.d.ts

@@ -1,4 +1,4 @@
-import { deviceManagerCapability, InferProvider, AddonContext, CapabilityDefinition, DeviceBindingEntry, DeviceConfigSpec, DeviceSettingsContribution, ICapabilityRegistry, IDevice } from '@camstack/types';
+import { deviceManagerCapability, InferProvider, AddonContext, CapabilityDefinition, DeviceBindingEntry, DeviceConfigSpec, DeviceSettingsContribution, ICapabilityRegistry, IDevice, StreamProfile, StreamProfilePatch } from '@camstack/types';
 import { ContributionShape, DriverConfigSchemaResult } from './device-meta-types.js';
 import { BindingsDeps, RemoteNativeCaps } from './device-bindings-store.js';
 /**
@@ -122,6 +122,33 @@ export declare function resolveDriverConfigSchema(deps: AggregationDeps, deviceI
     addonId: string;
     device: IDevice;
 } | null): Promise<DriverConfigSchemaResult>;
+/**
+ * Provider surface for a `derived-form` device-config cap's save path.
+ * Exactly one of `setProfile` / `setSettings` is present on the actual
+ * bound provider — which one is present tells us how to route the
+ * patch. `stream-params` exposes `setProfile` (profile axis); `day-night`
+ * / `image-settings` expose `setSettings` (no profile axis). Never branch
+ * on the cap name here — the method surface is the source of truth.
+ */
+export interface DerivedFormSaveSurface {
+    setProfile?: (input: {
+        deviceId: number;
+        profile: StreamProfile;
+        patch: StreamProfilePatch;
+    }) => Promise<void>;
+    setSettings?: (input: {
+        deviceId: number;
+        settings: Record<string, unknown>;
+    }) => Promise<void>;
+}
+/**
+ * Route a `derived-form` device-config cap's flat form patch to whichever
+ * mutation the bound provider actually exposes — inspecting the
+ * provider's method surface, not the cap name. `setSettings` fires once
+ * with the parsed flat patch; `setProfile` fans the patch out per-profile
+ * via the registered builderId reducer.
+ */
+export declare function dispatchDerivedFormSave(builderId: string, deviceId: number, patch: Record<string, unknown>, dcProvider: DerivedFormSaveSurface, capName: string): Promise<void>;
 export declare function updateDeviceField(deps: AggregationDeps, input: {
     deviceId: number;
     writerCapName: string;

package/dist/builtins/device-manager/device-config-contribution.d.ts

@@ -17,16 +17,28 @@ export interface DerivedContributionShape {
         fields: readonly unknown[];
     }>;
 }
-/** A per-profile mutation callback the cap's provider supplies. */
+/** A per-profile mutation callback the cap's provider supplies (profile-based caps only). */
 export type ProfileSetter = (profile: StreamProfile, patch: StreamProfilePatch) => Promise<void>;
-/** The single registered builderId today. New device-config caps add their own. */
+/** Registered builderIds today. New device-config caps add their own reducer below. */
 export declare const STREAM_PARAMS_BUILDER_ID: "stream-params";
+export declare const DAY_NIGHT_BUILDER_ID: "day-night";
+export declare const IMAGE_SETTINGS_BUILDER_ID: "image-settings";
 /**
  * Build the device-detail form section for a `derived-form` device-config
  * cap. Returns null when the camera exposes no configurable property.
  */
 export declare function deriveFormContribution(builderId: string, options: unknown, status: unknown): DerivedContributionShape | null;
 /**
- * Route a flat form patch back through the cap's per-profile setter.
+ * Route a flat form patch back through a profile-based cap's per-profile
+ * `setProfile` mutation (`stream-params`). Throws if `builderId` isn't
+ * registered as a profile-based reducer — callers dispatch here only
+ * after confirming the bound provider exposes `setProfile`.
  */
-export declare function applyDerivedFormPatch(builderId: string, patch: Record<string, unknown>, setProfile: ProfileSetter): Promise<void>;
+export declare function applyDerivedFormProfilePatch(builderId: string, patch: Record<string, unknown>, setProfile: ProfileSetter): Promise<void>;
+/**
+ * Parse a flat form patch into the settings payload for a `setSettings`-
+ * based cap (`day-night`, `image-settings`). The caller forwards the
+ * result verbatim to `dcProvider.setSettings({ deviceId, settings })`.
+ * Throws if `builderId` isn't registered as a settings-based reducer.
+ */
+export declare function parseDerivedFormSettingsPatch(builderId: string, patch: Record<string, unknown>): Record<string, unknown>;

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

@@ -7,13 +7,361 @@ let _camstack_types_node = require("@camstack/types/node");
 let _camstack_types = require("@camstack/types");
 let node_crypto = require("node:crypto");
 let zod = require("zod");
+//#region src/builtins/device-manager/day-night-config-schema.ts
+var MODE_LABELS = {
+	auto: "Auto",
+	day: "Day",
+	night: "Night",
+	schedule: "Schedule"
+};
+/**
+* Build the `day-night` `ConfigUISchema` from the camera-probed options +
+* current status. Returns `null` when the camera exposes no configurable
+* property — the cap then reports "no schema" and the renderer shows the
+* unsupported-camera message.
+*/
+function buildDayNightConfigSchema(options, status) {
+	const fields = [];
+	if (options.modes.length > 0) fields.push({
+		type: "select",
+		key: "dayNight_mode",
+		label: "Mode",
+		options: options.modes.map((m) => ({
+			value: m,
+			label: MODE_LABELS[m]
+		})),
+		default: status?.mode ?? options.modes[0]
+	});
+	if (options.supportsSensitivity && options.sensitivity) fields.push({
+		type: "slider",
+		key: "dayNight_sensitivity",
+		label: "IR-cut sensitivity",
+		min: options.sensitivity.min,
+		max: options.sensitivity.max,
+		step: options.sensitivity.step,
+		showValue: true,
+		default: status?.sensitivity ?? options.sensitivity.min
+	});
+	if (options.supportsSwitchDelay && options.switchDelaySec) fields.push({
+		type: "number",
+		key: "dayNight_switchDelaySec",
+		label: "Switch delay",
+		unit: "s",
+		min: options.switchDelaySec.min,
+		max: options.switchDelaySec.max,
+		step: options.switchDelaySec.step,
+		default: status?.switchDelaySec ?? options.switchDelaySec.min
+	});
+	if (fields.length === 0) return null;
+	return { sections: [{
+		id: "day-night",
+		tab: "image",
+		title: "Day / Night",
+		description: "IR-cut switching mode and the photocell knobs that gate it.",
+		columns: 2,
+		fields
+	}] };
+}
+var DAY_NIGHT_MODES = new Set([
+	"auto",
+	"day",
+	"night",
+	"schedule"
+]);
+function isDayNightMode(value) {
+	return typeof value === "string" && DAY_NIGHT_MODES.has(value);
+}
+/**
+* Re-parse a flat `ConfigFormBuilder` patch into a `DayNightSettingsPatch`.
+* Returns an empty object when no `dayNight_*` field changed — the caller
+* (`parseDerivedFormSettingsPatch`) forwards the result verbatim to the
+* cap's `setSettings` mutation, which itself ignores fields it doesn't
+* support.
+*/
+function parseDayNightFormPatch(patch) {
+	const out = {};
+	if ("dayNight_mode" in patch && isDayNightMode(patch.dayNight_mode)) out.mode = patch.dayNight_mode;
+	if ("dayNight_sensitivity" in patch) {
+		const value = Number(patch.dayNight_sensitivity);
+		if (Number.isFinite(value)) out.sensitivity = value;
+	}
+	if ("dayNight_switchDelaySec" in patch) {
+		const value = Number(patch.dayNight_switchDelaySec);
+		if (Number.isFinite(value)) out.switchDelaySec = value;
+	}
+	return out;
+}
+//#endregion
+//#region src/builtins/device-manager/image-settings-config-schema.ts
+var ROTATE_LABELS = {
+	"0": "0°",
+	"90": "90°",
+	"180": "180°",
+	"270": "270°"
+};
+var WHITE_BALANCE_LABELS = {
+	auto: "Auto",
+	manual: "Manual"
+};
+var EXPOSURE_LABELS = {
+	auto: "Auto",
+	manual: "Manual"
+};
+var BACKLIGHT_LABELS = {
+	off: "Off",
+	blc: "Backlight compensation",
+	wdr: "Wide dynamic range",
+	hlc: "Highlight compensation"
+};
+var ROTATE_VALUES = new Set([
+	"0",
+	"90",
+	"180",
+	"270"
+]);
+var WHITE_BALANCE_VALUES = new Set(["auto", "manual"]);
+var EXPOSURE_VALUES = new Set(["auto", "manual"]);
+var BACKLIGHT_VALUES = new Set([
+	"off",
+	"blc",
+	"wdr",
+	"hlc"
+]);
+function isImageRotate(value) {
+	return typeof value === "string" && ROTATE_VALUES.has(value);
+}
+function isWhiteBalanceMode(value) {
+	return typeof value === "string" && WHITE_BALANCE_VALUES.has(value);
+}
+function isExposureMode(value) {
+	return typeof value === "string" && EXPOSURE_VALUES.has(value);
+}
+function isBacklightMode(value) {
+	return typeof value === "string" && BACKLIGHT_VALUES.has(value);
+}
+/**
+* Build the `image-settings` `ConfigUISchema` from the camera-probed
+* options + current status. Returns `null` when the camera exposes no
+* configurable property.
+*/
+function buildImageSettingsConfigSchema(options, status) {
+	const fields = [];
+	if (options.supportsBrightness && options.brightness) fields.push({
+		type: "slider",
+		key: "imageSettings_brightness",
+		label: "Brightness",
+		min: options.brightness.min,
+		max: options.brightness.max,
+		step: options.brightness.step,
+		showValue: true,
+		default: status?.brightness ?? options.brightness.min
+	});
+	if (options.supportsContrast && options.contrast) fields.push({
+		type: "slider",
+		key: "imageSettings_contrast",
+		label: "Contrast",
+		min: options.contrast.min,
+		max: options.contrast.max,
+		step: options.contrast.step,
+		showValue: true,
+		default: status?.contrast ?? options.contrast.min
+	});
+	if (options.supportsSaturation && options.saturation) fields.push({
+		type: "slider",
+		key: "imageSettings_saturation",
+		label: "Saturation",
+		min: options.saturation.min,
+		max: options.saturation.max,
+		step: options.saturation.step,
+		showValue: true,
+		default: status?.saturation ?? options.saturation.min
+	});
+	if (options.supportsSharpness && options.sharpness) fields.push({
+		type: "slider",
+		key: "imageSettings_sharpness",
+		label: "Sharpness",
+		min: options.sharpness.min,
+		max: options.sharpness.max,
+		step: options.sharpness.step,
+		showValue: true,
+		default: status?.sharpness ?? options.sharpness.min
+	});
+	if (options.supportsMirror) fields.push({
+		type: "boolean",
+		key: "imageSettings_mirror",
+		label: "Mirror",
+		style: "switch",
+		default: status?.mirror ?? false
+	});
+	if (options.supportsFlip) fields.push({
+		type: "boolean",
+		key: "imageSettings_flip",
+		label: "Flip",
+		style: "switch",
+		default: status?.flip ?? false
+	});
+	if (options.rotateOptions.length > 0) fields.push({
+		type: "select",
+		key: "imageSettings_rotate",
+		label: "Rotation",
+		options: options.rotateOptions.map((r) => ({
+			value: r,
+			label: ROTATE_LABELS[r]
+		})),
+		default: status?.rotate ?? options.rotateOptions[0]
+	});
+	if (options.whiteBalanceModes.length > 0) fields.push({
+		type: "select",
+		key: "imageSettings_whiteBalance",
+		label: "White balance",
+		options: options.whiteBalanceModes.map((m) => ({
+			value: m,
+			label: WHITE_BALANCE_LABELS[m]
+		})),
+		default: status?.whiteBalance ?? options.whiteBalanceModes[0]
+	});
+	if (options.supportsWarmth && options.warmth) fields.push({
+		type: "slider",
+		key: "imageSettings_warmth",
+		label: "Warmth",
+		min: options.warmth.min,
+		max: options.warmth.max,
+		step: options.warmth.step,
+		showValue: true,
+		default: status?.warmth ?? options.warmth.min,
+		showWhen: {
+			field: "imageSettings_whiteBalance",
+			equals: "manual"
+		}
+	});
+	if (options.exposureModes.length > 0) fields.push({
+		type: "select",
+		key: "imageSettings_exposureMode",
+		label: "Exposure mode",
+		options: options.exposureModes.map((m) => ({
+			value: m,
+			label: EXPOSURE_LABELS[m]
+		})),
+		default: status?.exposureMode ?? options.exposureModes[0]
+	});
+	if (options.backlightModes.length > 0) fields.push({
+		type: "select",
+		key: "imageSettings_backlightMode",
+		label: "Backlight compensation",
+		options: options.backlightModes.map((m) => ({
+			value: m,
+			label: BACKLIGHT_LABELS[m]
+		})),
+		default: status?.backlightMode ?? options.backlightModes[0]
+	});
+	if (fields.length === 0) return null;
+	return { sections: [{
+		id: "image-settings",
+		tab: "image",
+		title: "Image adjustment",
+		description: "Picture sliders, orientation and exposure. Option lists are read live from the camera — fields the firmware doesn't expose are hidden.",
+		columns: 2,
+		fields
+	}] };
+}
+/**
+* Re-parse a flat `ConfigFormBuilder` patch into an `ImageSettingsPatch`.
+* Returns an empty object when no `imageSettings_*` field changed.
+*/
+function parseImageSettingsFormPatch(patch) {
+	const out = {};
+	if ("imageSettings_brightness" in patch) {
+		const value = Number(patch.imageSettings_brightness);
+		if (Number.isFinite(value)) out.brightness = value;
+	}
+	if ("imageSettings_contrast" in patch) {
+		const value = Number(patch.imageSettings_contrast);
+		if (Number.isFinite(value)) out.contrast = value;
+	}
+	if ("imageSettings_saturation" in patch) {
+		const value = Number(patch.imageSettings_saturation);
+		if (Number.isFinite(value)) out.saturation = value;
+	}
+	if ("imageSettings_sharpness" in patch) {
+		const value = Number(patch.imageSettings_sharpness);
+		if (Number.isFinite(value)) out.sharpness = value;
+	}
+	if ("imageSettings_mirror" in patch && typeof patch.imageSettings_mirror === "boolean") out.mirror = patch.imageSettings_mirror;
+	if ("imageSettings_flip" in patch && typeof patch.imageSettings_flip === "boolean") out.flip = patch.imageSettings_flip;
+	if ("imageSettings_rotate" in patch && isImageRotate(patch.imageSettings_rotate)) out.rotate = patch.imageSettings_rotate;
+	if ("imageSettings_whiteBalance" in patch && isWhiteBalanceMode(patch.imageSettings_whiteBalance)) out.whiteBalance = patch.imageSettings_whiteBalance;
+	if ("imageSettings_warmth" in patch) {
+		const value = Number(patch.imageSettings_warmth);
+		if (Number.isFinite(value)) out.warmth = value;
+	}
+	if ("imageSettings_exposureMode" in patch && isExposureMode(patch.imageSettings_exposureMode)) out.exposureMode = patch.imageSettings_exposureMode;
+	if ("imageSettings_backlightMode" in patch && isBacklightMode(patch.imageSettings_backlightMode)) out.backlightMode = patch.imageSettings_backlightMode;
+	return out;
+}
+//#endregion
+//#region src/builtins/device-manager/device-config-contribution.ts
+/**
+* D14 device-config archetype — framework-side contribution derivation.
+*
+* A `deviceConfig` cap with `ui.kind: 'derived-form'` names a `builderId`.
+* This module owns the registry of `builderId → reducer` pure functions
+* that build the UI section from the cap's `getOptions` + `getStatus`
+* output and route a flat form patch back through the cap's `set*`
+* mutation. No per-vendor UI code: reolink and hikvision produce the same
+* section from the same inputs.
+*
+* Two reducer shapes exist, one per save-path surface a `derived-form` cap
+* can expose:
+*   - `kind: 'profile'` — the cap mutates one of several named profiles
+*     via `setProfile({ deviceId, profile, patch })` (`stream-params`).
+*   - `kind: 'settings'` — the cap has no profile axis and mutates via a
+*     single `setSettings({ deviceId, settings })` (`day-night`,
+*     `image-settings`).
+*
+* `device-aggregation.ts` picks which apply function to call by
+* inspecting the bound provider's actual method surface (`setProfile` vs
+* `setSettings`), never by branching on the cap name.
+*/
+/** Registered builderIds today. New device-config caps add their own reducer below. */
+var STREAM_PARAMS_BUILDER_ID = "stream-params";
+var DAY_NIGHT_BUILDER_ID = "day-night";
+var IMAGE_SETTINGS_BUILDER_ID = "image-settings";
+var STREAM_PARAMS_REDUCER = {
+	kind: "profile",
+	buildSchema: (options, status) => (0, _camstack_types.buildStreamParamsConfigSchema)(options, status ?? null),
+	applyPatch: async (patch, setProfile) => {
+		for (const meta of _camstack_types.STREAM_PROFILE_META) {
+			const profilePatch = (0, _camstack_types.parseStreamParamsFormPatch)(patch, meta.prefix);
+			if (profilePatch) await setProfile(meta.profile, profilePatch);
+		}
+	}
+};
+var DAY_NIGHT_REDUCER = {
+	kind: "settings",
+	buildSchema: (options, status) => buildDayNightConfigSchema(options, status ?? null),
+	parsePatch: (patch) => parseDayNightFormPatch(patch)
+};
+var IMAGE_SETTINGS_REDUCER = {
+	kind: "settings",
+	buildSchema: (options, status) => buildImageSettingsConfigSchema(options, status ?? null),
+	parsePatch: (patch) => parseImageSettingsFormPatch(patch)
+};
+var BUILDER_REDUCERS = {
+	[STREAM_PARAMS_BUILDER_ID]: STREAM_PARAMS_REDUCER,
+	[DAY_NIGHT_BUILDER_ID]: DAY_NIGHT_REDUCER,
+	[IMAGE_SETTINGS_BUILDER_ID]: IMAGE_SETTINGS_REDUCER
+};
+function resolveReducer(builderId) {
+	const reducer = BUILDER_REDUCERS[builderId];
+	if (!reducer) throw new Error(`device-config: unknown derived-form builderId "${builderId}"`);
+	return reducer;
+}
 /**
 * Build the device-detail form section for a `derived-form` device-config
 * cap. Returns null when the camera exposes no configurable property.
 */
 function deriveFormContribution(builderId, options, status) {
-	if (builderId !== "stream-params") throw new Error(`device-config: unknown derived-form builderId "${builderId}"`);
-	const schema = (0, _camstack_types.buildStreamParamsConfigSchema)(options, status ?? null);
+	const schema = resolveReducer(builderId).buildSchema(options, status);
 	if (!schema) return null;
 	return { sections: schema.sections.map((s) => ({
 		id: s.id,
@@ -26,14 +374,26 @@ function deriveFormContribution(builderId, options, status) {
 	})) };
 }
 /**
-* Route a flat form patch back through the cap's per-profile setter.
+* Route a flat form patch back through a profile-based cap's per-profile
+* `setProfile` mutation (`stream-params`). Throws if `builderId` isn't
+* registered as a profile-based reducer — callers dispatch here only
+* after confirming the bound provider exposes `setProfile`.
 */
-async function applyDerivedFormPatch(builderId, patch, setProfile) {
-	if (builderId !== "stream-params") throw new Error(`device-config: unknown derived-form builderId "${builderId}"`);
-	for (const meta of _camstack_types.STREAM_PROFILE_META) {
-		const profilePatch = (0, _camstack_types.parseStreamParamsFormPatch)(patch, meta.prefix);
-		if (profilePatch) await setProfile(meta.profile, profilePatch);
-	}
+async function applyDerivedFormProfilePatch(builderId, patch, setProfile) {
+	const reducer = resolveReducer(builderId);
+	if (reducer.kind !== "profile") throw new Error(`device-config: builderId "${builderId}" is not a profile-based derived-form`);
+	await reducer.applyPatch(patch, setProfile);
+}
+/**
+* Parse a flat form patch into the settings payload for a `setSettings`-
+* based cap (`day-night`, `image-settings`). The caller forwards the
+* result verbatim to `dcProvider.setSettings({ deviceId, settings })`.
+* Throws if `builderId` isn't registered as a settings-based reducer.
+*/
+function parseDerivedFormSettingsPatch(builderId, patch) {
+	const reducer = resolveReducer(builderId);
+	if (reducer.kind !== "settings") throw new Error(`device-config: builderId "${builderId}" is not a settings-based derived-form`);
+	return reducer.parsePatch(patch);
 }
 //#endregion
 //#region src/builtins/device-manager/device-aggregation-merge.ts
@@ -985,6 +1345,33 @@ async function resolveDriverConfigSchema(deps, deviceId, hubLocal) {
 	});
 	return { status: "unavailable" };
 }
+/**
+* Route a `derived-form` device-config cap's flat form patch to whichever
+* mutation the bound provider actually exposes — inspecting the
+* provider's method surface, not the cap name. `setSettings` fires once
+* with the parsed flat patch; `setProfile` fans the patch out per-profile
+* via the registered builderId reducer.
+*/
+async function dispatchDerivedFormSave(builderId, deviceId, patch, dcProvider, capName) {
+	if (typeof dcProvider.setSettings === "function") {
+		const settings = parseDerivedFormSettingsPatch(builderId, patch);
+		await dcProvider.setSettings({
+			deviceId,
+			settings
+		});
+		return;
+	}
+	if (typeof dcProvider.setProfile === "function") {
+		const setProfile = dcProvider.setProfile;
+		await applyDerivedFormProfilePatch(builderId, patch, (profile, profilePatch) => setProfile({
+			deviceId,
+			profile,
+			patch: profilePatch
+		}));
+		return;
+	}
+	throw new Error(`[device-manager] device-config cap "${capName}" provider exposes neither setSettings nor setProfile`);
+}
 async function updateDeviceField(deps, input) {
 	if (input.writerCapName === "device-manager") {
 		const hubRegistry = deps.ctx.kernel?.deviceRegistry;
@@ -1008,11 +1395,7 @@ async function updateDeviceField(deps, input) {
 		if (def.deviceConfig.ui.kind === "widget") return { success: true };
 		const dcProvider = registry.getProviderForDevice(input.writerCapName, input.deviceId);
 		if (!dcProvider) throw new Error(`[device-manager] no provider for device-config cap "${input.writerCapName}" on device ${input.deviceId}`);
-		await applyDerivedFormPatch(def.deviceConfig.ui.builderId, { [input.key]: input.value }, (profile, patch) => dcProvider.setProfile({
-			deviceId: input.deviceId,
-			profile,
-			patch
-		}));
+		await dispatchDerivedFormSave(def.deviceConfig.ui.builderId, input.deviceId, { [input.key]: input.value }, dcProvider, input.writerCapName);
 		return { success: true };
 	}
 	if (!def?.exposesDeviceSettings) throw new Error(`[device-manager] cap "${input.writerCapName}" does not expose device settings`);
@@ -1131,11 +1514,7 @@ async function applyGroupPatch(deps, deviceId, group) {
 		if (def.deviceConfig.ui.kind === "widget") return;
 		const dcProvider = registry.getProviderForDevice(group.writerCapName, deviceId);
 		if (!dcProvider) throw new Error(`[device-manager] no provider for device-config cap "${group.writerCapName}" on device ${deviceId}`);
-		await applyDerivedFormPatch(def.deviceConfig.ui.builderId, group.patch, (profile, patch) => dcProvider.setProfile({
-			deviceId,
-			profile,
-			patch
-		}));
+		await dispatchDerivedFormSave(def.deviceConfig.ui.builderId, deviceId, group.patch, dcProvider, group.writerCapName);
 		return;
 	}
 	if (!def?.exposesDeviceSettings) throw new Error(`[device-manager] cap "${group.writerCapName}" does not expose device settings`);

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

@@ -2,13 +2,361 @@ import { canonicalDeviceFingerprint } from "@camstack/types/node";
 import { ALL_CAPABILITY_DEFINITIONS, BaseAddon, CAP_NAMES_WITH_STATUS, DeviceFeature, DeviceRole, DeviceStatusSchema, DeviceType, EventCategory, STREAM_PROFILE_META, WELL_KNOWN_TAB_MAP, applyTransform, buildStreamParamsConfigSchema, deviceManagerCapability, deviceStateCapability, deviceStatusCapability, enumerateItemArrayFields, enumerateSchemaFields, errMsg, evaluateLinkExpression, getByPath, isDeviceConfigCap, normalizeUnit, parseStreamParamsFormPatch, setByPath, sleep, toExpressionValue, validateExpressionSource } from "@camstack/types";
 import { randomUUID } from "node:crypto";
 import { z } from "zod";
+//#region src/builtins/device-manager/day-night-config-schema.ts
+var MODE_LABELS = {
+	auto: "Auto",
+	day: "Day",
+	night: "Night",
+	schedule: "Schedule"
+};
+/**
+* Build the `day-night` `ConfigUISchema` from the camera-probed options +
+* current status. Returns `null` when the camera exposes no configurable
+* property — the cap then reports "no schema" and the renderer shows the
+* unsupported-camera message.
+*/
+function buildDayNightConfigSchema(options, status) {
+	const fields = [];
+	if (options.modes.length > 0) fields.push({
+		type: "select",
+		key: "dayNight_mode",
+		label: "Mode",
+		options: options.modes.map((m) => ({
+			value: m,
+			label: MODE_LABELS[m]
+		})),
+		default: status?.mode ?? options.modes[0]
+	});
+	if (options.supportsSensitivity && options.sensitivity) fields.push({
+		type: "slider",
+		key: "dayNight_sensitivity",
+		label: "IR-cut sensitivity",
+		min: options.sensitivity.min,
+		max: options.sensitivity.max,
+		step: options.sensitivity.step,
+		showValue: true,
+		default: status?.sensitivity ?? options.sensitivity.min
+	});
+	if (options.supportsSwitchDelay && options.switchDelaySec) fields.push({
+		type: "number",
+		key: "dayNight_switchDelaySec",
+		label: "Switch delay",
+		unit: "s",
+		min: options.switchDelaySec.min,
+		max: options.switchDelaySec.max,
+		step: options.switchDelaySec.step,
+		default: status?.switchDelaySec ?? options.switchDelaySec.min
+	});
+	if (fields.length === 0) return null;
+	return { sections: [{
+		id: "day-night",
+		tab: "image",
+		title: "Day / Night",
+		description: "IR-cut switching mode and the photocell knobs that gate it.",
+		columns: 2,
+		fields
+	}] };
+}
+var DAY_NIGHT_MODES = new Set([
+	"auto",
+	"day",
+	"night",
+	"schedule"
+]);
+function isDayNightMode(value) {
+	return typeof value === "string" && DAY_NIGHT_MODES.has(value);
+}
+/**
+* Re-parse a flat `ConfigFormBuilder` patch into a `DayNightSettingsPatch`.
+* Returns an empty object when no `dayNight_*` field changed — the caller
+* (`parseDerivedFormSettingsPatch`) forwards the result verbatim to the
+* cap's `setSettings` mutation, which itself ignores fields it doesn't
+* support.
+*/
+function parseDayNightFormPatch(patch) {
+	const out = {};
+	if ("dayNight_mode" in patch && isDayNightMode(patch.dayNight_mode)) out.mode = patch.dayNight_mode;
+	if ("dayNight_sensitivity" in patch) {
+		const value = Number(patch.dayNight_sensitivity);
+		if (Number.isFinite(value)) out.sensitivity = value;
+	}
+	if ("dayNight_switchDelaySec" in patch) {
+		const value = Number(patch.dayNight_switchDelaySec);
+		if (Number.isFinite(value)) out.switchDelaySec = value;
+	}
+	return out;
+}
+//#endregion
+//#region src/builtins/device-manager/image-settings-config-schema.ts
+var ROTATE_LABELS = {
+	"0": "0°",
+	"90": "90°",
+	"180": "180°",
+	"270": "270°"
+};
+var WHITE_BALANCE_LABELS = {
+	auto: "Auto",
+	manual: "Manual"
+};
+var EXPOSURE_LABELS = {
+	auto: "Auto",
+	manual: "Manual"
+};
+var BACKLIGHT_LABELS = {
+	off: "Off",
+	blc: "Backlight compensation",
+	wdr: "Wide dynamic range",
+	hlc: "Highlight compensation"
+};
+var ROTATE_VALUES = new Set([
+	"0",
+	"90",
+	"180",
+	"270"
+]);
+var WHITE_BALANCE_VALUES = new Set(["auto", "manual"]);
+var EXPOSURE_VALUES = new Set(["auto", "manual"]);
+var BACKLIGHT_VALUES = new Set([
+	"off",
+	"blc",
+	"wdr",
+	"hlc"
+]);
+function isImageRotate(value) {
+	return typeof value === "string" && ROTATE_VALUES.has(value);
+}
+function isWhiteBalanceMode(value) {
+	return typeof value === "string" && WHITE_BALANCE_VALUES.has(value);
+}
+function isExposureMode(value) {
+	return typeof value === "string" && EXPOSURE_VALUES.has(value);
+}
+function isBacklightMode(value) {
+	return typeof value === "string" && BACKLIGHT_VALUES.has(value);
+}
+/**
+* Build the `image-settings` `ConfigUISchema` from the camera-probed
+* options + current status. Returns `null` when the camera exposes no
+* configurable property.
+*/
+function buildImageSettingsConfigSchema(options, status) {
+	const fields = [];
+	if (options.supportsBrightness && options.brightness) fields.push({
+		type: "slider",
+		key: "imageSettings_brightness",
+		label: "Brightness",
+		min: options.brightness.min,
+		max: options.brightness.max,
+		step: options.brightness.step,
+		showValue: true,
+		default: status?.brightness ?? options.brightness.min
+	});
+	if (options.supportsContrast && options.contrast) fields.push({
+		type: "slider",
+		key: "imageSettings_contrast",
+		label: "Contrast",
+		min: options.contrast.min,
+		max: options.contrast.max,
+		step: options.contrast.step,
+		showValue: true,
+		default: status?.contrast ?? options.contrast.min
+	});
+	if (options.supportsSaturation && options.saturation) fields.push({
+		type: "slider",
+		key: "imageSettings_saturation",
+		label: "Saturation",
+		min: options.saturation.min,
+		max: options.saturation.max,
+		step: options.saturation.step,
+		showValue: true,
+		default: status?.saturation ?? options.saturation.min
+	});
+	if (options.supportsSharpness && options.sharpness) fields.push({
+		type: "slider",
+		key: "imageSettings_sharpness",
+		label: "Sharpness",
+		min: options.sharpness.min,
+		max: options.sharpness.max,
+		step: options.sharpness.step,
+		showValue: true,
+		default: status?.sharpness ?? options.sharpness.min
+	});
+	if (options.supportsMirror) fields.push({
+		type: "boolean",
+		key: "imageSettings_mirror",
+		label: "Mirror",
+		style: "switch",
+		default: status?.mirror ?? false
+	});
+	if (options.supportsFlip) fields.push({
+		type: "boolean",
+		key: "imageSettings_flip",
+		label: "Flip",
+		style: "switch",
+		default: status?.flip ?? false
+	});
+	if (options.rotateOptions.length > 0) fields.push({
+		type: "select",
+		key: "imageSettings_rotate",
+		label: "Rotation",
+		options: options.rotateOptions.map((r) => ({
+			value: r,
+			label: ROTATE_LABELS[r]
+		})),
+		default: status?.rotate ?? options.rotateOptions[0]
+	});
+	if (options.whiteBalanceModes.length > 0) fields.push({
+		type: "select",
+		key: "imageSettings_whiteBalance",
+		label: "White balance",
+		options: options.whiteBalanceModes.map((m) => ({
+			value: m,
+			label: WHITE_BALANCE_LABELS[m]
+		})),
+		default: status?.whiteBalance ?? options.whiteBalanceModes[0]
+	});
+	if (options.supportsWarmth && options.warmth) fields.push({
+		type: "slider",
+		key: "imageSettings_warmth",
+		label: "Warmth",
+		min: options.warmth.min,
+		max: options.warmth.max,
+		step: options.warmth.step,
+		showValue: true,
+		default: status?.warmth ?? options.warmth.min,
+		showWhen: {
+			field: "imageSettings_whiteBalance",
+			equals: "manual"
+		}
+	});
+	if (options.exposureModes.length > 0) fields.push({
+		type: "select",
+		key: "imageSettings_exposureMode",
+		label: "Exposure mode",
+		options: options.exposureModes.map((m) => ({
+			value: m,
+			label: EXPOSURE_LABELS[m]
+		})),
+		default: status?.exposureMode ?? options.exposureModes[0]
+	});
+	if (options.backlightModes.length > 0) fields.push({
+		type: "select",
+		key: "imageSettings_backlightMode",
+		label: "Backlight compensation",
+		options: options.backlightModes.map((m) => ({
+			value: m,
+			label: BACKLIGHT_LABELS[m]
+		})),
+		default: status?.backlightMode ?? options.backlightModes[0]
+	});
+	if (fields.length === 0) return null;
+	return { sections: [{
+		id: "image-settings",
+		tab: "image",
+		title: "Image adjustment",
+		description: "Picture sliders, orientation and exposure. Option lists are read live from the camera — fields the firmware doesn't expose are hidden.",
+		columns: 2,
+		fields
+	}] };
+}
+/**
+* Re-parse a flat `ConfigFormBuilder` patch into an `ImageSettingsPatch`.
+* Returns an empty object when no `imageSettings_*` field changed.
+*/
+function parseImageSettingsFormPatch(patch) {
+	const out = {};
+	if ("imageSettings_brightness" in patch) {
+		const value = Number(patch.imageSettings_brightness);
+		if (Number.isFinite(value)) out.brightness = value;
+	}
+	if ("imageSettings_contrast" in patch) {
+		const value = Number(patch.imageSettings_contrast);
+		if (Number.isFinite(value)) out.contrast = value;
+	}
+	if ("imageSettings_saturation" in patch) {
+		const value = Number(patch.imageSettings_saturation);
+		if (Number.isFinite(value)) out.saturation = value;
+	}
+	if ("imageSettings_sharpness" in patch) {
+		const value = Number(patch.imageSettings_sharpness);
+		if (Number.isFinite(value)) out.sharpness = value;
+	}
+	if ("imageSettings_mirror" in patch && typeof patch.imageSettings_mirror === "boolean") out.mirror = patch.imageSettings_mirror;
+	if ("imageSettings_flip" in patch && typeof patch.imageSettings_flip === "boolean") out.flip = patch.imageSettings_flip;
+	if ("imageSettings_rotate" in patch && isImageRotate(patch.imageSettings_rotate)) out.rotate = patch.imageSettings_rotate;
+	if ("imageSettings_whiteBalance" in patch && isWhiteBalanceMode(patch.imageSettings_whiteBalance)) out.whiteBalance = patch.imageSettings_whiteBalance;
+	if ("imageSettings_warmth" in patch) {
+		const value = Number(patch.imageSettings_warmth);
+		if (Number.isFinite(value)) out.warmth = value;
+	}
+	if ("imageSettings_exposureMode" in patch && isExposureMode(patch.imageSettings_exposureMode)) out.exposureMode = patch.imageSettings_exposureMode;
+	if ("imageSettings_backlightMode" in patch && isBacklightMode(patch.imageSettings_backlightMode)) out.backlightMode = patch.imageSettings_backlightMode;
+	return out;
+}
+//#endregion
+//#region src/builtins/device-manager/device-config-contribution.ts
+/**
+* D14 device-config archetype — framework-side contribution derivation.
+*
+* A `deviceConfig` cap with `ui.kind: 'derived-form'` names a `builderId`.
+* This module owns the registry of `builderId → reducer` pure functions
+* that build the UI section from the cap's `getOptions` + `getStatus`
+* output and route a flat form patch back through the cap's `set*`
+* mutation. No per-vendor UI code: reolink and hikvision produce the same
+* section from the same inputs.
+*
+* Two reducer shapes exist, one per save-path surface a `derived-form` cap
+* can expose:
+*   - `kind: 'profile'` — the cap mutates one of several named profiles
+*     via `setProfile({ deviceId, profile, patch })` (`stream-params`).
+*   - `kind: 'settings'` — the cap has no profile axis and mutates via a
+*     single `setSettings({ deviceId, settings })` (`day-night`,
+*     `image-settings`).
+*
+* `device-aggregation.ts` picks which apply function to call by
+* inspecting the bound provider's actual method surface (`setProfile` vs
+* `setSettings`), never by branching on the cap name.
+*/
+/** Registered builderIds today. New device-config caps add their own reducer below. */
+var STREAM_PARAMS_BUILDER_ID = "stream-params";
+var DAY_NIGHT_BUILDER_ID = "day-night";
+var IMAGE_SETTINGS_BUILDER_ID = "image-settings";
+var STREAM_PARAMS_REDUCER = {
+	kind: "profile",
+	buildSchema: (options, status) => buildStreamParamsConfigSchema(options, status ?? null),
+	applyPatch: async (patch, setProfile) => {
+		for (const meta of STREAM_PROFILE_META) {
+			const profilePatch = parseStreamParamsFormPatch(patch, meta.prefix);
+			if (profilePatch) await setProfile(meta.profile, profilePatch);
+		}
+	}
+};
+var DAY_NIGHT_REDUCER = {
+	kind: "settings",
+	buildSchema: (options, status) => buildDayNightConfigSchema(options, status ?? null),
+	parsePatch: (patch) => parseDayNightFormPatch(patch)
+};
+var IMAGE_SETTINGS_REDUCER = {
+	kind: "settings",
+	buildSchema: (options, status) => buildImageSettingsConfigSchema(options, status ?? null),
+	parsePatch: (patch) => parseImageSettingsFormPatch(patch)
+};
+var BUILDER_REDUCERS = {
+	[STREAM_PARAMS_BUILDER_ID]: STREAM_PARAMS_REDUCER,
+	[DAY_NIGHT_BUILDER_ID]: DAY_NIGHT_REDUCER,
+	[IMAGE_SETTINGS_BUILDER_ID]: IMAGE_SETTINGS_REDUCER
+};
+function resolveReducer(builderId) {
+	const reducer = BUILDER_REDUCERS[builderId];
+	if (!reducer) throw new Error(`device-config: unknown derived-form builderId "${builderId}"`);
+	return reducer;
+}
 /**
 * Build the device-detail form section for a `derived-form` device-config
 * cap. Returns null when the camera exposes no configurable property.
 */
 function deriveFormContribution(builderId, options, status) {
-	if (builderId !== "stream-params") throw new Error(`device-config: unknown derived-form builderId "${builderId}"`);
-	const schema = buildStreamParamsConfigSchema(options, status ?? null);
+	const schema = resolveReducer(builderId).buildSchema(options, status);
 	if (!schema) return null;
 	return { sections: schema.sections.map((s) => ({
 		id: s.id,
@@ -21,14 +369,26 @@ function deriveFormContribution(builderId, options, status) {
 	})) };
 }
 /**
-* Route a flat form patch back through the cap's per-profile setter.
+* Route a flat form patch back through a profile-based cap's per-profile
+* `setProfile` mutation (`stream-params`). Throws if `builderId` isn't
+* registered as a profile-based reducer — callers dispatch here only
+* after confirming the bound provider exposes `setProfile`.
 */
-async function applyDerivedFormPatch(builderId, patch, setProfile) {
-	if (builderId !== "stream-params") throw new Error(`device-config: unknown derived-form builderId "${builderId}"`);
-	for (const meta of STREAM_PROFILE_META) {
-		const profilePatch = parseStreamParamsFormPatch(patch, meta.prefix);
-		if (profilePatch) await setProfile(meta.profile, profilePatch);
-	}
+async function applyDerivedFormProfilePatch(builderId, patch, setProfile) {
+	const reducer = resolveReducer(builderId);
+	if (reducer.kind !== "profile") throw new Error(`device-config: builderId "${builderId}" is not a profile-based derived-form`);
+	await reducer.applyPatch(patch, setProfile);
+}
+/**
+* Parse a flat form patch into the settings payload for a `setSettings`-
+* based cap (`day-night`, `image-settings`). The caller forwards the
+* result verbatim to `dcProvider.setSettings({ deviceId, settings })`.
+* Throws if `builderId` isn't registered as a settings-based reducer.
+*/
+function parseDerivedFormSettingsPatch(builderId, patch) {
+	const reducer = resolveReducer(builderId);
+	if (reducer.kind !== "settings") throw new Error(`device-config: builderId "${builderId}" is not a settings-based derived-form`);
+	return reducer.parsePatch(patch);
 }
 //#endregion
 //#region src/builtins/device-manager/device-aggregation-merge.ts
@@ -980,6 +1340,33 @@ async function resolveDriverConfigSchema(deps, deviceId, hubLocal) {
 	});
 	return { status: "unavailable" };
 }
+/**
+* Route a `derived-form` device-config cap's flat form patch to whichever
+* mutation the bound provider actually exposes — inspecting the
+* provider's method surface, not the cap name. `setSettings` fires once
+* with the parsed flat patch; `setProfile` fans the patch out per-profile
+* via the registered builderId reducer.
+*/
+async function dispatchDerivedFormSave(builderId, deviceId, patch, dcProvider, capName) {
+	if (typeof dcProvider.setSettings === "function") {
+		const settings = parseDerivedFormSettingsPatch(builderId, patch);
+		await dcProvider.setSettings({
+			deviceId,
+			settings
+		});
+		return;
+	}
+	if (typeof dcProvider.setProfile === "function") {
+		const setProfile = dcProvider.setProfile;
+		await applyDerivedFormProfilePatch(builderId, patch, (profile, profilePatch) => setProfile({
+			deviceId,
+			profile,
+			patch: profilePatch
+		}));
+		return;
+	}
+	throw new Error(`[device-manager] device-config cap "${capName}" provider exposes neither setSettings nor setProfile`);
+}
 async function updateDeviceField(deps, input) {
 	if (input.writerCapName === "device-manager") {
 		const hubRegistry = deps.ctx.kernel?.deviceRegistry;
@@ -1003,11 +1390,7 @@ async function updateDeviceField(deps, input) {
 		if (def.deviceConfig.ui.kind === "widget") return { success: true };
 		const dcProvider = registry.getProviderForDevice(input.writerCapName, input.deviceId);
 		if (!dcProvider) throw new Error(`[device-manager] no provider for device-config cap "${input.writerCapName}" on device ${input.deviceId}`);
-		await applyDerivedFormPatch(def.deviceConfig.ui.builderId, { [input.key]: input.value }, (profile, patch) => dcProvider.setProfile({
-			deviceId: input.deviceId,
-			profile,
-			patch
-		}));
+		await dispatchDerivedFormSave(def.deviceConfig.ui.builderId, input.deviceId, { [input.key]: input.value }, dcProvider, input.writerCapName);
 		return { success: true };
 	}
 	if (!def?.exposesDeviceSettings) throw new Error(`[device-manager] cap "${input.writerCapName}" does not expose device settings`);
@@ -1126,11 +1509,7 @@ async function applyGroupPatch(deps, deviceId, group) {
 		if (def.deviceConfig.ui.kind === "widget") return;
 		const dcProvider = registry.getProviderForDevice(group.writerCapName, deviceId);
 		if (!dcProvider) throw new Error(`[device-manager] no provider for device-config cap "${group.writerCapName}" on device ${deviceId}`);
-		await applyDerivedFormPatch(def.deviceConfig.ui.builderId, group.patch, (profile, patch) => dcProvider.setProfile({
-			deviceId,
-			profile,
-			patch
-		}));
+		await dispatchDerivedFormSave(def.deviceConfig.ui.builderId, deviceId, group.patch, dcProvider, group.writerCapName);
 		return;
 	}
 	if (!def?.exposesDeviceSettings) throw new Error(`[device-manager] cap "${group.writerCapName}" does not expose device settings`);

package/dist/builtins/device-manager/image-settings-config-schema.d.ts

@@ -0,0 +1,12 @@
+import { ConfigUISchema, ImageSettingsOptions, ImageSettingsPatch, ImageSettingsStatus } from '@camstack/types';
+/**
+ * Build the `image-settings` `ConfigUISchema` from the camera-probed
+ * options + current status. Returns `null` when the camera exposes no
+ * configurable property.
+ */
+export declare function buildImageSettingsConfigSchema(options: ImageSettingsOptions, status: ImageSettingsStatus | null): ConfigUISchema | null;
+/**
+ * Re-parse a flat `ConfigFormBuilder` patch into an `ImageSettingsPatch`.
+ * Returns an empty object when no `imageSettings_*` field changed.
+ */
+export declare function parseImageSettingsFormPatch(patch: Record<string, unknown>): ImageSettingsPatch;

package/dist/builtins/native-metrics/native-metrics.addon.d.ts

@@ -10,6 +10,7 @@ export default class NativeMetricsAddon extends BaseAddon<NativeMetricsConfig> {
     private provider;
     private startedAtMs;
     private snapshotTimer;
+    private processSnapshotTimer;
     /**
      * Snapshot-equality cache for the resources + processes emit.
      * Stores the coarsened JSON and timestamp; a tick where the
@@ -22,11 +23,23 @@ export default class NativeMetricsAddon extends BaseAddon<NativeMetricsConfig> {
     protected onInitialize(): Promise<ProviderRegistration[]>;
     protected onShutdown(): Promise<void>;
     /**
-     * Emit one `metrics.node-resources-snapshot` + one
-     * `metrics.node-processes-snapshot` for this node. UI consumers
-     * subscribe and read state directly from the payload.
+     * Resolve this node's short id (strips any `nodeId/addonId` suffix).
+     * Returns null when the provider or event bus isn't available yet.
      */
-    private emitMetricsSnapshots;
+    private resolveSnapshotNodeId;
+    /**
+     * Emit one `metrics.node-resources-snapshot` for this node. Cheap —
+     * reads the cached sample (the provider's background sampler already
+     * runs at samplingIntervalMs). Fires on METRICS_SNAPSHOT_INTERVAL_MS.
+     */
+    private emitResourcesSnapshot;
+    /**
+     * Emit one `metrics.node-processes-snapshot` for this node. Heavy —
+     * runs a full OS `ps -eo` scan (`runPs`) plus a `$process.list` broker
+     * call. Fires on the coarser PROCESS_SNAPSHOT_INTERVAL_MS so an idle
+     * node isn't paying a process-table walk every 5s. Skip on failure.
+     */
+    private emitProcessesSnapshot;
     protected onConfigChanged(): Promise<void>;
     private listWorkerInstances;
     private listAddonInstances;

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

@@ -504,6 +504,19 @@ var SUPERVISOR_BOUNDARY_RE = /(tsx\s+watch\s.*launcher\.ts|packages\/agent\/dist
 */
 var METRICS_SNAPSHOT_INTERVAL_MS = 5e3;
 /**
+* Cadence for the per-node PROCESS-TREE snapshot bus events. Kept
+* deliberately coarser than the resources cadence because each tick
+* runs a full OS `ps -eo` scan (`runPs`) plus a `$process.list` broker
+* call — heavy work that was previously paid every 5s regardless of
+* whether any UI consumer was subscribed to
+* `MetricsNodeProcessesSnapshot`. The event bus exposes no per-category
+* subscriber count, so instead of demand-gating we split the cadence:
+* 20s cuts the `ps` frequency 4x while the ProcessesTab still gets a
+* fresh-on-open payload from the on-demand `listNodeProcesses` cap call.
+* The dedup + 60s heartbeat below still apply on top of this.
+*/
+var PROCESS_SNAPSHOT_INTERVAL_MS = 2e4;
+/**
 * Force a metrics-snapshot emit at least every 60s even when the
 * coarsened payload looks unchanged. Without this an idle node
 * (steady CPU within ±5%, no process churn) goes silent on the
@@ -569,6 +582,7 @@ var NativeMetricsAddon = class extends _camstack_types.BaseAddon {
 	provider = null;
 	startedAtMs = Date.now();
 	snapshotTimer = null;
+	processSnapshotTimer = null;
 	/**
 	* Snapshot-equality cache for the resources + processes emit.
 	* Stores the coarsened JSON and timestamp; a tick where the
@@ -601,7 +615,8 @@ var NativeMetricsAddon = class extends _camstack_types.BaseAddon {
 			killProcess: (params) => this.killProcess(params),
 			dumpHeapSnapshot: (params) => this.dumpHeapSnapshot(params)
 		};
-		this.snapshotTimer = setInterval(() => this.emitMetricsSnapshots(), METRICS_SNAPSHOT_INTERVAL_MS);
+		this.snapshotTimer = setInterval(() => this.emitResourcesSnapshot(), METRICS_SNAPSHOT_INTERVAL_MS);
+		this.processSnapshotTimer = setInterval(() => this.emitProcessesSnapshot(), PROCESS_SNAPSHOT_INTERVAL_MS);
 		return [{
 			capability: _camstack_types.metricsProviderCapability,
 			provider: composed
@@ -612,20 +627,32 @@ var NativeMetricsAddon = class extends _camstack_types.BaseAddon {
 			clearInterval(this.snapshotTimer);
 			this.snapshotTimer = null;
 		}
+		if (this.processSnapshotTimer) {
+			clearInterval(this.processSnapshotTimer);
+			this.processSnapshotTimer = null;
+		}
 		this.provider?.stopSampling();
 		this.provider = null;
 	}
 	/**
-	* Emit one `metrics.node-resources-snapshot` + one
-	* `metrics.node-processes-snapshot` for this node. UI consumers
-	* subscribe and read state directly from the payload.
+	* Resolve this node's short id (strips any `nodeId/addonId` suffix).
+	* Returns null when the provider or event bus isn't available yet.
+	*/
+	resolveSnapshotNodeId() {
+		if (!this.provider || !this.ctx.eventBus) return null;
+		const rawNodeId = this.ctx.kernel.localNodeId ?? this.ctx.id;
+		return rawNodeId.includes("/") ? rawNodeId.split("/")[0] : rawNodeId;
+	}
+	/**
+	* Emit one `metrics.node-resources-snapshot` for this node. Cheap —
+	* reads the cached sample (the provider's background sampler already
+	* runs at samplingIntervalMs). Fires on METRICS_SNAPSHOT_INTERVAL_MS.
 	*/
-	async emitMetricsSnapshots() {
+	async emitResourcesSnapshot() {
 		const provider = this.provider;
 		const eventBus = this.ctx.eventBus;
-		if (!provider || !eventBus) return;
-		const rawNodeId = this.ctx.kernel.localNodeId ?? this.ctx.id;
-		const nodeId = rawNodeId.includes("/") ? rawNodeId.split("/")[0] : rawNodeId;
+		const nodeId = this.resolveSnapshotNodeId();
+		if (!provider || !eventBus || !nodeId) return;
 		const timestamp = Date.now();
 		try {
 			const snapshot = await provider.getCached() ?? await provider.collectSnapshot();
@@ -648,6 +675,18 @@ var NativeMetricsAddon = class extends _camstack_types.BaseAddon {
 				}));
 			}
 		} catch {}
+	}
+	/**
+	* Emit one `metrics.node-processes-snapshot` for this node. Heavy —
+	* runs a full OS `ps -eo` scan (`runPs`) plus a `$process.list` broker
+	* call. Fires on the coarser PROCESS_SNAPSHOT_INTERVAL_MS so an idle
+	* node isn't paying a process-table walk every 5s. Skip on failure.
+	*/
+	async emitProcessesSnapshot() {
+		const eventBus = this.ctx.eventBus;
+		const nodeId = this.resolveSnapshotNodeId();
+		if (!this.provider || !eventBus || !nodeId) return;
+		const timestamp = Date.now();
 		try {
 			const processes = await this.listNodeProcesses();
 			const coarse = coarsenProcessList(processes);

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

@@ -497,6 +497,19 @@ var SUPERVISOR_BOUNDARY_RE = /(tsx\s+watch\s.*launcher\.ts|packages\/agent\/dist
 */
 var METRICS_SNAPSHOT_INTERVAL_MS = 5e3;
 /**
+* Cadence for the per-node PROCESS-TREE snapshot bus events. Kept
+* deliberately coarser than the resources cadence because each tick
+* runs a full OS `ps -eo` scan (`runPs`) plus a `$process.list` broker
+* call — heavy work that was previously paid every 5s regardless of
+* whether any UI consumer was subscribed to
+* `MetricsNodeProcessesSnapshot`. The event bus exposes no per-category
+* subscriber count, so instead of demand-gating we split the cadence:
+* 20s cuts the `ps` frequency 4x while the ProcessesTab still gets a
+* fresh-on-open payload from the on-demand `listNodeProcesses` cap call.
+* The dedup + 60s heartbeat below still apply on top of this.
+*/
+var PROCESS_SNAPSHOT_INTERVAL_MS = 2e4;
+/**
 * Force a metrics-snapshot emit at least every 60s even when the
 * coarsened payload looks unchanged. Without this an idle node
 * (steady CPU within ±5%, no process churn) goes silent on the
@@ -562,6 +575,7 @@ var NativeMetricsAddon = class extends BaseAddon {
 	provider = null;
 	startedAtMs = Date.now();
 	snapshotTimer = null;
+	processSnapshotTimer = null;
 	/**
 	* Snapshot-equality cache for the resources + processes emit.
 	* Stores the coarsened JSON and timestamp; a tick where the
@@ -594,7 +608,8 @@ var NativeMetricsAddon = class extends BaseAddon {
 			killProcess: (params) => this.killProcess(params),
 			dumpHeapSnapshot: (params) => this.dumpHeapSnapshot(params)
 		};
-		this.snapshotTimer = setInterval(() => this.emitMetricsSnapshots(), METRICS_SNAPSHOT_INTERVAL_MS);
+		this.snapshotTimer = setInterval(() => this.emitResourcesSnapshot(), METRICS_SNAPSHOT_INTERVAL_MS);
+		this.processSnapshotTimer = setInterval(() => this.emitProcessesSnapshot(), PROCESS_SNAPSHOT_INTERVAL_MS);
 		return [{
 			capability: metricsProviderCapability,
 			provider: composed
@@ -605,20 +620,32 @@ var NativeMetricsAddon = class extends BaseAddon {
 			clearInterval(this.snapshotTimer);
 			this.snapshotTimer = null;
 		}
+		if (this.processSnapshotTimer) {
+			clearInterval(this.processSnapshotTimer);
+			this.processSnapshotTimer = null;
+		}
 		this.provider?.stopSampling();
 		this.provider = null;
 	}
 	/**
-	* Emit one `metrics.node-resources-snapshot` + one
-	* `metrics.node-processes-snapshot` for this node. UI consumers
-	* subscribe and read state directly from the payload.
+	* Resolve this node's short id (strips any `nodeId/addonId` suffix).
+	* Returns null when the provider or event bus isn't available yet.
+	*/
+	resolveSnapshotNodeId() {
+		if (!this.provider || !this.ctx.eventBus) return null;
+		const rawNodeId = this.ctx.kernel.localNodeId ?? this.ctx.id;
+		return rawNodeId.includes("/") ? rawNodeId.split("/")[0] : rawNodeId;
+	}
+	/**
+	* Emit one `metrics.node-resources-snapshot` for this node. Cheap —
+	* reads the cached sample (the provider's background sampler already
+	* runs at samplingIntervalMs). Fires on METRICS_SNAPSHOT_INTERVAL_MS.
 	*/
-	async emitMetricsSnapshots() {
+	async emitResourcesSnapshot() {
 		const provider = this.provider;
 		const eventBus = this.ctx.eventBus;
-		if (!provider || !eventBus) return;
-		const rawNodeId = this.ctx.kernel.localNodeId ?? this.ctx.id;
-		const nodeId = rawNodeId.includes("/") ? rawNodeId.split("/")[0] : rawNodeId;
+		const nodeId = this.resolveSnapshotNodeId();
+		if (!provider || !eventBus || !nodeId) return;
 		const timestamp = Date.now();
 		try {
 			const snapshot = await provider.getCached() ?? await provider.collectSnapshot();
@@ -641,6 +668,18 @@ var NativeMetricsAddon = class extends BaseAddon {
 				}));
 			}
 		} catch {}
+	}
+	/**
+	* Emit one `metrics.node-processes-snapshot` for this node. Heavy —
+	* runs a full OS `ps -eo` scan (`runPs`) plus a `$process.list` broker
+	* call. Fires on the coarser PROCESS_SNAPSHOT_INTERVAL_MS so an idle
+	* node isn't paying a process-table walk every 5s. Skip on failure.
+	*/
+	async emitProcessesSnapshot() {
+		const eventBus = this.ctx.eventBus;
+		const nodeId = this.resolveSnapshotNodeId();
+		if (!this.provider || !eventBus || !nodeId) return;
+		const timestamp = Date.now();
 		try {
 			const processes = await this.listNodeProcesses();
 			const coarse = coarsenProcessList(processes);

package/package.json

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