@camstack/addon-osd-manager 0.1.267 → 0.1.269

package/dist/index.js

@@ -8737,7 +8737,7 @@ var DeviceRole = /* @__PURE__ */ function(DeviceRole) {
 	return DeviceRole;
 }({});
 //#endregion
-//#region ../types/dist/composition-xz-ud5EQ.mjs
+//#region ../types/dist/composition-BJ8iAZb3.mjs
 /**
 * The ffmpeg build every CamStack node downloads, per platform and arch.
 *
@@ -8797,7 +8797,7 @@ portable("linux64"), portable("linuxarm64"), portable("macarm64"), portable("mac
 * ONE table for everyone who asks "is this device HIGH?": the
 * recorder's `RecordingTriggers.sensorDeviceIds` trigger, the post-analysis
 * sensor markers, the orchestrator's camera-sensors bridge and
-* the sources of a composite doorbell (`doorbellFeatureSources`, D671).
+* the sources of a pulse (`compilePulseOverride`, D936).
 * A second copy would diverge at the first cap added, and the symptom — "the
 * sensor rings the doorbell but does not record" — is exactly D62.
 *
@@ -15848,6 +15848,13 @@ var ComposerUnreadableBlockSchema = object({
 	/** The parse error, in the operator's words. */
 	error: string()
 });
+/** A confirmed release the hub did not accept. `deviceId` is the claim's device. */
+var UnreleasedClaimSchema = object({
+	deviceId: number().int(),
+	capName: string(),
+	owner: string(),
+	error: string()
+});
 method(object({
 	/** The shared Blocks integration; null until `core-blocks` has reconciled it. */
 	integrationId: string().nullable(),
@@ -15857,7 +15864,13 @@ method(object({
 	/** Operator restarts: rebuild these runtimes and re-resolve their sources. Stores nothing (D62). */
 	restartBlockIds: array(string()),
 	/** Composition rows that exist but do not parse: held, never withdrawn, reported failed. */
-	unreadableBlocks: array(ComposerUnreadableBlockSchema)
+	unreadableBlocks: array(ComposerUnreadableBlockSchema),
+	/**
+	* Operator-confirmed deletions. Their claims are released on this apply,
+	* before any replacement block claims. A block that merely vanished from the
+	* snapshot is not listed here and still waits for two applies (D49).
+	*/
+	retiredBlockIds: array(string()).optional()
 }), object({
 	blocks: array(object({
 		blockId: string(),
@@ -15869,7 +15882,13 @@ method(object({
 	* integration unknown, its own rows unread or read empty once). An empty
 	* apply the caller owes is paid off only by one the composer acted on (D49).
 	*/
-	acted: boolean()
+	acted: boolean(),
+	/**
+	* Confirmed releases this apply tried and the hub did not accept. Empty when
+	* every one landed (or there was nothing to hand back). Absent on a result
+	* that never got that far.
+	*/
+	unreleasedClaims: array(UnreleasedClaimSchema).optional()
 }), {
 	kind: "mutation",
 	auth: "admin"
@@ -41777,6 +41796,381 @@ var _macroLookup = /* @__PURE__ */ new Map();
 for (const [k, v] of Object.entries(YAMNET_TO_MACRO.mapping)) _macroLookup.set(k.toLowerCase(), v);
 for (const [k, v] of Object.entries(APPLE_SA_TO_MACRO.mapping)) _macroLookup.set(k.toLowerCase(), v);
 /**
+* Palette entry ids (D939). Audio is the one gradient; `audio-*` leaves are
+* not entries. `heatmapScrub` is a mark, not an event kind.
+*/
+var PALETTE_ENTRY_IDS = [
+	"motion",
+	"audio",
+	"recording",
+	"live",
+	"heatmapScrub",
+	"person",
+	"vehicle",
+	"animal",
+	"package",
+	"sensor",
+	"control",
+	"face",
+	"plate",
+	"car",
+	"truck",
+	"bus",
+	"motorcycle",
+	"bicycle",
+	"airplane",
+	"boat",
+	"train",
+	"bird",
+	"dog",
+	"cat",
+	"horse",
+	"sheep",
+	"cow",
+	"elephant",
+	"bear",
+	"zebra",
+	"giraffe",
+	"package-delivered",
+	"package-picked-up",
+	"suitcase",
+	"backpack",
+	"handbag",
+	"contact",
+	"motion-sensor",
+	"smoke",
+	"flood",
+	"gas",
+	"carbon-monoxide",
+	"vibration",
+	"tamper",
+	"presence",
+	"enum-sensor",
+	"device-event",
+	"lock",
+	"cover",
+	"switch",
+	"siren",
+	"button",
+	"doorbell"
+];
+var AUDIO_ENTRY_ID = "audio";
+/** Six rungs, quiet → loud. The opaque end is the entry's hex. */
+var AUDIO_GRADIENT_ALPHAS = [
+	.3,
+	.42,
+	.55,
+	.7,
+	.85,
+	1
+];
+var PALETTE_PRESET_IDS = [
+	"camstack",
+	"high-contrast",
+	"okabe-ito"
+];
+/** Frozen palette tables (D939). The spec refuses a table that breaks the rule. */
+var CAMSTACK_HEX = {
+	motion: "#d946ef",
+	audio: "#059eb8",
+	recording: "#ef4444",
+	live: "#8d7a00",
+	heatmapScrub: "#4b32ff",
+	person: "#11a64c",
+	vehicle: "#3b82f6",
+	animal: "#ea6a09",
+	package: "#924667",
+	sensor: "#624bbc",
+	control: "#944d24",
+	face: "#ed4f8d",
+	plate: "#4b7027",
+	car: "#9684cf",
+	truck: "#0f9b89",
+	bus: "#a734a9",
+	motorcycle: "#c1133a",
+	bicycle: "#0e6a9b",
+	airplane: "#7c9928",
+	boat: "#b17933",
+	train: "#ad6ca3",
+	bird: "#0f7c55",
+	dog: "#c82700",
+	cat: "#7268f2",
+	horse: "#cb795e",
+	sheep: "#b8636b",
+	cow: "#cb2969",
+	elephant: "#1158d2",
+	bear: "#8d5e00",
+	zebra: "#0097d6",
+	giraffe: "#8f61bb",
+	"package-delivered": "#cd3f9b",
+	"package-picked-up": "#388a08",
+	suitcase: "#666800",
+	backpack: "#ec5022",
+	handbag: "#a76ef8",
+	contact: "#ab5a49",
+	"motion-sensor": "#b95d1a",
+	smoke: "#dd3858",
+	flood: "#b31e7d",
+	gas: "#5b70b5",
+	"carbon-monoxide": "#7b4e8e",
+	vibration: "#e65bba",
+	tamper: "#98464b",
+	presence: "#3a9468",
+	"enum-sensor": "#7885f8",
+	"device-event": "#8c43c8",
+	lock: "#649653",
+	cover: "#c67597",
+	switch: "#7a812a",
+	siren: "#ac5d7f",
+	button: "#b276cd",
+	doorbell: "#0087ab"
+};
+var CAMSTACK_FALLBACK = [
+	"#b34dc7",
+	"#1d7d34",
+	"#db6b6c",
+	"#a43d29",
+	"#0e6ee6",
+	"#29a10b",
+	"#a98731",
+	"#0181c6"
+];
+var HIGH_CONTRAST_HEX = {
+	motion: "#964360",
+	audio: "#23a132",
+	recording: "#2494ca",
+	live: "#bd7e2b",
+	heatmapScrub: "#ad6eea",
+	person: "#62611e",
+	vehicle: "#f4534c",
+	animal: "#1556cd",
+	package: "#9c4415",
+	sensor: "#066c48",
+	control: "#f2479f",
+	face: "#139d8a",
+	plate: "#909024",
+	car: "#8e35ab",
+	truck: "#bd0b2b",
+	bus: "#7a88ca",
+	motorcycle: "#e26725",
+	bicycle: "#a6679b",
+	airplane: "#7c5720",
+	boat: "#467a1b",
+	train: "#6f65a4",
+	bird: "#cb717f",
+	dog: "#c62490",
+	cat: "#b36850",
+	horse: "#1872ac",
+	sheep: "#927939",
+	cow: "#428a5c",
+	elephant: "#d41160",
+	bear: "#799453",
+	zebra: "#a85455",
+	giraffe: "#746be8",
+	"package-delivered": "#824a80",
+	"package-picked-up": "#614ac1",
+	suitcase: "#2f77f3",
+	backpack: "#fa476d",
+	handbag: "#c14cbe",
+	contact: "#c83921",
+	"motion-sensor": "#a07ebd",
+	smoke: "#a25b13",
+	flood: "#526bab",
+	gas: "#924938",
+	"carbon-monoxide": "#bb7e53",
+	vibration: "#b66182",
+	tamper: "#3c6931",
+	presence: "#6c851d",
+	"enum-sensor": "#ad2d48",
+	"device-event": "#5e9b04",
+	lock: "#00a062",
+	cover: "#ad8624",
+	switch: "#d05259",
+	siren: "#cd67b3",
+	button: "#c9746a",
+	doorbell: "#338eeb"
+};
+var HIGH_CONTRAST_FALLBACK = [
+	"#817f3b",
+	"#a0733e",
+	"#8658b2",
+	"#956301",
+	"#bc652d",
+	"#647331",
+	"#a14c9e",
+	"#d14e71"
+];
+var OKABE_ITO_HEX = {
+	motion: "#b88128",
+	audio: "#1096c8",
+	recording: "#009e73",
+	live: "#9c8c22",
+	heatmapScrub: "#0072b2",
+	person: "#d55e00",
+	vehicle: "#c0739f",
+	animal: "#226d18",
+	package: "#91446c",
+	sensor: "#217b56",
+	control: "#648647",
+	face: "#c22998",
+	plate: "#fa4575",
+	car: "#956301",
+	truck: "#2f77f3",
+	bus: "#7a4e86",
+	motorcycle: "#f54597",
+	bicycle: "#bb3e75",
+	airplane: "#e054c0",
+	boat: "#457942",
+	train: "#867afa",
+	bird: "#88914c",
+	dog: "#1556cd",
+	cat: "#71702c",
+	horse: "#9b4fa4",
+	sheep: "#c0559d",
+	cow: "#d14f65",
+	elephant: "#98470f",
+	bear: "#595896",
+	zebra: "#96790e",
+	giraffe: "#cb717b",
+	"package-delivered": "#139d8a",
+	"package-picked-up": "#906ead",
+	suitcase: "#d02939",
+	backpack: "#d41160",
+	handbag: "#f64f54",
+	contact: "#7258d2",
+	"motion-sensor": "#b66182",
+	smoke: "#627abb",
+	flood: "#b86ae4",
+	gas: "#a95261",
+	"carbon-monoxide": "#c65d3c",
+	vibration: "#7a40b7",
+	tamper: "#914b34",
+	presence: "#9481c3",
+	"enum-sensor": "#ac6d47",
+	"device-event": "#7b6fce",
+	lock: "#c67662",
+	cover: "#a6564d",
+	switch: "#ad2c4e",
+	siren: "#348e08",
+	button: "#d27303",
+	doorbell: "#55770f"
+};
+var OKABE_ITO_FALLBACK = [
+	"#9a3784",
+	"#a7392c",
+	"#409d50",
+	"#6987e7",
+	"#ee5b3d",
+	"#c0430d",
+	"#af79b3",
+	"#4b6628"
+];
+/**
+* The display palette (D939). One table of colours, three presets, one
+* validator. Taxonomy colours and every consumer read this — there is no
+* second hex table.
+*/
+var paletteHexSchema = string().regex(/^#[0-9a-f]{6}$/);
+var paletteSwatchSchema = discriminatedUnion("form", [object({
+	form: literal("solid"),
+	hex: paletteHexSchema
+}), object({
+	form: literal("gradient"),
+	hex: paletteHexSchema,
+	alphas: array(number().gt(0).lte(1)).length(AUDIO_GRADIENT_ALPHAS.length)
+})]);
+var paletteReadySchema = object({
+	status: literal("ready"),
+	presetId: _enum(PALETTE_PRESET_IDS),
+	customized: boolean(),
+	source: _enum(["stored", "unconfigured"]),
+	swatches: record(string(), paletteSwatchSchema),
+	fallbacks: array(paletteHexSchema).length(8)
+});
+var paletteResultSchema = discriminatedUnion("status", [paletteReadySchema, object({
+	status: literal("unknown"),
+	reason: string()
+})]);
+var setPaletteInputSchema = union([object({ presetId: string() }), object({
+	presetId: string(),
+	overrides: record(string(), paletteSwatchSchema)
+})]);
+object({
+	presetId: string(),
+	overrides: record(string(), paletteSwatchSchema)
+});
+function solid(hex) {
+	return {
+		form: "solid",
+		hex
+	};
+}
+function audioGradient(hex) {
+	return {
+		form: "gradient",
+		hex,
+		alphas: [...AUDIO_GRADIENT_ALPHAS]
+	};
+}
+function swatchesFrom(hexes) {
+	const out = {};
+	for (const id of PALETTE_ENTRY_IDS) {
+		const hex = hexes[id];
+		if (hex === void 0) throw new Error(`palette table missing ${id}`);
+		out[id] = id === "audio" ? audioGradient(hex) : solid(hex);
+	}
+	return out;
+}
+function preset(id, name, hexes, fallbacks) {
+	return {
+		id,
+		name,
+		swatches: swatchesFrom(hexes),
+		fallbacks
+	};
+}
+var DISPLAY_PRESETS = [
+	preset("camstack", "CamStack", CAMSTACK_HEX, CAMSTACK_FALLBACK),
+	preset("high-contrast", "High contrast", HIGH_CONTRAST_HEX, HIGH_CONTRAST_FALLBACK),
+	preset("okabe-ito", "Colour-blind safe", OKABE_ITO_HEX, OKABE_ITO_FALLBACK)
+];
+function presetById(id) {
+	return DISPLAY_PRESETS.find((item) => item.id === id);
+}
+function bundledCamstack() {
+	const presetRow = presetById("camstack");
+	if (presetRow === void 0) throw new Error("CamStack preset missing");
+	return readyOf(presetRow, "unconfigured", false);
+}
+function readyOf(row, source, customized) {
+	return {
+		status: "ready",
+		presetId: row.id,
+		customized,
+		source,
+		swatches: row.swatches,
+		fallbacks: [...row.fallbacks]
+	};
+}
+function hashFallback(kind, fallbacks) {
+	let hash = 0;
+	for (let i = 0; i < kind.length; i++) hash = hash * 31 + (kind.codePointAt(i) ?? 0) >>> 0;
+	const hex = fallbacks[hash % fallbacks.length];
+	if (hex === void 0) throw new Error("display palette has no fallback colour");
+	return hex;
+}
+/** Colour a kind paints with. Audio leaves share the audio gradient's hex. */
+function paintHex(swatches, fallbacks, kind) {
+	const key = kind.trim().toLowerCase();
+	if (key.startsWith("audio-")) {
+		const audio = swatches[AUDIO_ENTRY_ID];
+		return audio !== void 0 ? audio.hex : hashFallback(key, fallbacks);
+	}
+	const direct = swatches[key];
+	if (direct !== void 0) return direct.hex;
+	return hashFallback(key, fallbacks);
+}
+/**
 * Unified event-kind taxonomy — THE single source of truth for
 * `kind → { parentKind, category, level, color, iconId, labelKey, label,
 * icon }`.
@@ -41790,109 +42184,88 @@ for (const [k, v] of Object.entries(APPLE_SA_TO_MACRO.mapping)) _macroLookup.set
 *   - `addon-post-analysis/shared/frame/box-drawer.ts` (DEFAULT_COLOR)
 *   - the COCO / audio class maps (macro ↔ sub relationships)
 *
-* The DATA (serializable — color/iconId/labelKey/parentKind) lives here in
-* `@camstack/types`. The UI-side mapping `iconId → lucide component` and
-* `labelKey → t()` lives in `@camstack/ui-library`. UIs never hardcode a
-* color or an icon: they read this dictionary (server descriptors carry the
-* fields inline; the client resolves color/icon/label from `iconId`/`kind`).
+* The DATA (serializable — parentKind / iconId / labelKey) lives here in
+* `@camstack/types`. Colour is NOT a second table: each entry's `color` is
+* the bundled CamStack display palette (D939). The effective cluster palette
+* is the `display-palette` capability. The UI-side mapping `iconId → lucide
+* component` and `labelKey → t()` lives in `@camstack/ui-library`.
 *
 * Two levels only (v1 YAGNI): macro → sub. `person` is a leaf macro.
 */
-var TAXONOMY_COLORS = {
-	motion: "#f59e0b",
-	audio: "#06b6d4",
-	person: "#22c55e",
-	vehicle: "#3b82f6",
-	animal: "#f97316",
-	package: "#a855f7",
-	sensor: "#8b5cf6",
-	control: "#10b981",
-	genericDetection: "#64748b"
-};
-var DETECTION_SUB_COLORS = {
-	car: "#f59e0b",
-	truck: "#d97706",
-	bus: "#b45309",
-	motorcycle: "#eab308",
-	bicycle: "#ca8a04",
-	airplane: "#60a5fa",
-	boat: "#2563eb",
-	train: "#1d4ed8",
-	bird: "#14b8a6",
-	dog: "#84cc16",
-	cat: "#f97316",
-	horse: "#a16207",
-	sheep: "#a3a3a3",
-	cow: "#78716c",
-	elephant: "#6b7280",
-	bear: "#7c2d12",
-	zebra: "#404040",
-	giraffe: "#d4a373"
-};
+var BUNDLED_PALETTE = bundledCamstack();
+function kindColor(kind) {
+	return paintHex(BUNDLED_PALETTE.swatches, BUNDLED_PALETTE.fallbacks, kind);
+}
+function firstFallback(fallbacks) {
+	const hex = fallbacks[0];
+	if (hex === void 0) throw new Error("display palette has no fallback colour");
+	return hex;
+}
+firstFallback(BUNDLED_PALETTE.fallbacks);
 function titleCase(id) {
 	return id.split(/[-_ ]/).filter((p) => p.length > 0).map((p) => p.charAt(0).toUpperCase() + p.slice(1)).join(" ");
 }
 var entries = /* @__PURE__ */ new Map();
-function macro(kind, category, color, iconId, label) {
+function macro(kind, category, iconId, label) {
 	entries.set(kind, {
 		kind,
 		parentKind: null,
 		level: "macro",
 		category,
-		color,
+		color: kindColor(kind),
 		iconId,
 		labelKey: `eventKind.${kind}`,
 		label
 	});
 }
-function sub(kind, parentKind, category, color, iconId, label) {
+function sub(kind, parentKind, category, iconId, label) {
 	entries.set(kind, {
 		kind,
 		parentKind,
 		level: "sub",
 		category,
-		color,
+		color: kindColor(kind),
 		iconId,
 		labelKey: `eventKind.${kind}`,
 		label
 	});
 }
-macro("motion", "motion", TAXONOMY_COLORS.motion, "motion", "Motion");
-macro("audio", "audio", TAXONOMY_COLORS.audio, "audio", "Audio");
-macro("person", "detection", TAXONOMY_COLORS.person, "person", "Person");
-macro("vehicle", "detection", TAXONOMY_COLORS.vehicle, "vehicle", "Vehicle");
-macro("animal", "detection", TAXONOMY_COLORS.animal, "animal", "Animal");
-macro("package", "package", TAXONOMY_COLORS.package, "package", "Package");
-macro("sensor", "sensor", TAXONOMY_COLORS.sensor, "sensor", "Sensor");
-macro("control", "control", TAXONOMY_COLORS.control, "control", "Control");
+macro("motion", "motion", "motion", "Motion");
+macro("audio", "audio", "audio", "Audio");
+macro("person", "detection", "person", "Person");
+macro("vehicle", "detection", "vehicle", "Vehicle");
+macro("animal", "detection", "animal", "Animal");
+macro("package", "package", "package", "Package");
+macro("sensor", "sensor", "sensor", "Sensor");
+macro("control", "control", "control", "Control");
 for (const [cocoClass, macroClass] of Object.entries(COCO_TO_MACRO.mapping)) {
 	if (macroClass !== "vehicle" && macroClass !== "animal") continue;
 	if (entries.has(cocoClass)) continue;
-	sub(cocoClass, macroClass, "detection", DETECTION_SUB_COLORS[cocoClass] ?? TAXONOMY_COLORS.genericDetection, cocoClass, titleCase(cocoClass));
+	sub(cocoClass, macroClass, "detection", cocoClass, titleCase(cocoClass));
 }
-sub("package-delivered", "package", "package", TAXONOMY_COLORS.package, "package", "Package delivered");
-sub("package-picked-up", "package", "package", TAXONOMY_COLORS.package, "package", "Package picked up");
-sub("contact", "sensor", "sensor", "#f59e0b", "door", "Contact");
-sub("motion-sensor", "sensor", "sensor", TAXONOMY_COLORS.sensor, "pir", "Motion sensor");
-sub("smoke", "sensor", "sensor", "#ef4444", "smoke", "Smoke");
-sub("flood", "sensor", "sensor", "#3b82f6", "water", "Water leak");
-sub("gas", "sensor", "sensor", "#ef4444", "gas", "Gas");
-sub("carbon-monoxide", "sensor", "sensor", "#dc2626", "smoke", "Carbon monoxide");
-sub("vibration", "sensor", "sensor", "#eab308", "vibration", "Vibration");
-sub("tamper", "sensor", "sensor", "#f97316", "tamper", "Tamper");
-sub("presence", "sensor", "sensor", "#22c55e", "presence", "Presence");
-sub("enum-sensor", "sensor", "sensor", TAXONOMY_COLORS.sensor, "generic", "Sensor state");
-sub("device-event", "sensor", "sensor", "#10b981", "button", "Device event");
-sub("lock", "control", "control", "#0ea5e9", "lock", "Lock");
-sub("cover", "control", "control", "#0ea5e9", "door", "Cover");
-sub("switch", "control", "control", TAXONOMY_COLORS.control, "switch", "Switch");
-sub("siren", "control", "control", "#dc2626", "siren", "Siren");
-sub("button", "control", "control", "#10b981", "button", "Button");
-sub("doorbell", "control", "control", "#a855f7", "doorbell", "Doorbell");
+sub("package-delivered", "package", "package", "package", "Package delivered");
+sub("package-picked-up", "package", "package", "package", "Package picked up");
+sub("contact", "sensor", "sensor", "door", "Contact");
+sub("motion-sensor", "sensor", "sensor", "pir", "Motion sensor");
+sub("smoke", "sensor", "sensor", "smoke", "Smoke");
+sub("flood", "sensor", "sensor", "water", "Water leak");
+sub("gas", "sensor", "sensor", "gas", "Gas");
+sub("carbon-monoxide", "sensor", "sensor", "smoke", "Carbon monoxide");
+sub("vibration", "sensor", "sensor", "vibration", "Vibration");
+sub("tamper", "sensor", "sensor", "tamper", "Tamper");
+sub("presence", "sensor", "sensor", "presence", "Presence");
+sub("enum-sensor", "sensor", "sensor", "generic", "Sensor state");
+sub("device-event", "sensor", "sensor", "button", "Device event");
+sub("lock", "control", "control", "lock", "Lock");
+sub("cover", "control", "control", "door", "Cover");
+sub("switch", "control", "control", "switch", "Switch");
+sub("siren", "control", "control", "siren", "Siren");
+sub("button", "control", "control", "button", "Button");
+sub("doorbell", "control", "control", "doorbell", "Doorbell");
 for (const l of AUDIO_MACRO_LABELS) {
 	const kind = `audio-${l.id}`;
 	if (entries.has(kind)) continue;
-	sub(kind, "audio", "audio", TAXONOMY_COLORS.audio, kind, l.name);
+	sub(kind, "audio", "audio", kind, l.name);
 }
 /** The complete taxonomy dictionary, keyed by kind. */
 var EVENT_TAXONOMY = Object.freeze(Object.fromEntries(entries));
@@ -54291,7 +54664,8 @@ var BatteryStatusSchema = object({
 	*/
 	binary: boolean().optional()
 });
-DeviceType.Camera, DeviceType.Sensor, DeviceType.Button, DeviceType.Switch, DeviceType.PetFeeder, DeviceType.Container, DeviceType.Thermostat, method(object({
+DeviceType.Camera, DeviceType.Sensor, DeviceType.Button, DeviceType.Switch, DeviceType.PetFeeder, DeviceType.Container, DeviceType.Thermostat;
+method(object({
 	deviceId: number(),
 	/** Bound on the wait. Sensible range 3000–10000ms. */
 	timeoutMs: number().int().min(500).max(3e4).default(8e3)
@@ -55000,6 +55374,7 @@ var ConsumablesStatusSchema = object({
 	})),
 	lastChangedAt: number()
 });
+Object.values(DeviceType), [...ConsumableRemainingUnitSchema.options], [...ConsumableStatusSchema.options], [...ConsumableKindSchema.options], [...ConsumableFormSchema.options];
 Object.values(DeviceType), method(object({
 	deviceId: number().int().nonnegative(),
 	key: string().min(1)
@@ -55192,6 +55567,30 @@ DeviceType.Camera, method(object({ deviceId: number() }), DayNightOptionsSchema)
 	auth: "admin"
 });
 /**
+* display-palette — the cluster's one colour table (D939).
+*
+* Hub singleton. `getPalette` reports `unknown` when the settings store
+* cannot be read; it does not pretend the bundled preset was stored.
+* `setPalette` refuses a palette that fails the ΔE / contrast rule and names
+* the pairs.
+*/
+var presetSummarySchema = object({
+	id: string(),
+	name: string(),
+	swatches: record(string(), paletteSwatchSchema),
+	fallbacks: array(string())
+});
+method(_void(), paletteResultSchema, {
+	auth: "protected",
+	role: "viewer"
+}), method(_void(), array(presetSummarySchema).readonly(), {
+	auth: "protected",
+	role: "viewer"
+}), method(setPaletteInputSchema, paletteReadySchema, {
+	kind: "mutation",
+	auth: "admin"
+});
+/**
 * Generic device-level status snapshot. Auto-registered by `BaseDevice`
 * for every device, regardless of provider — the kernel needs a uniform
 * cap-keyed slice for the basic device flags every consumer expects to
@@ -55471,6 +55870,7 @@ DeviceType.Dishwasher, method(object({
 	kind: "mutation",
 	auth: "protected"
 }), method(object({ deviceId: DeviceIdSchema }), DishwasherOptionsSchema, { auth: "protected" });
+DeviceType.Camera;
 object({
 	/** Ms epoch of the last press. null = never observed since this provider started. */
 	lastPressedAt: number().nullable(),
@@ -57263,6 +57663,7 @@ authKey: string().optional() }), object({
 	/** Human-readable error when `ok: false`. */
 	error: string().optional()
 }), { kind: "mutation" });
+DeviceType.Camera;
 object({
 	detected: boolean(),
 	/** Ms epoch of the last detected-true observation. Null if never detected. */
@@ -59396,7 +59797,8 @@ object({
 	since: number().nullable(),
 	source: RunningStateSourceSchema,
 	phase: string().nullable(),
-	lastFetchedAt: number()
+	/** null until a reading has been published (D393). */
+	lastFetchedAt: number().nullable()
 });
 object({
 	deviceId: number(),
@@ -59404,6 +59806,7 @@ object({
 	phase: string().nullable()
 });
 Object.values(DeviceType);
+DeviceType.Dishwasher, DeviceType.Vacuum, DeviceType.LawnMower, DeviceType.MediaPlayer, DeviceType.WaterHeater, DeviceType.Humidifier, DeviceType.Fan, DeviceType.Climate, DeviceType.Thermostat, DeviceType.PetFeeder;
 DeviceType.Camera, DeviceType.Sensor, DeviceType.Switch, method(object({ deviceId: number().int().nonnegative() }), object({ success: literal(true) }), {
 	kind: "mutation",
 	auth: "admin"
@@ -66464,6 +66867,27 @@ Object.freeze({
 		access: "create",
 		role: "viewer"
 	},
+	"displayPalette.getPalette": {
+		capName: "display-palette",
+		capScope: "system",
+		addonId: null,
+		access: "view",
+		role: "viewer"
+	},
+	"displayPalette.listPresets": {
+		capName: "display-palette",
+		capScope: "system",
+		addonId: null,
+		access: "view",
+		role: "viewer"
+	},
+	"displayPalette.setPalette": {
+		capName: "display-palette",
+		capScope: "system",
+		addonId: null,
+		access: "create",
+		role: "admin"
+	},
 	"doorbell.getStatus": {
 		capName: "doorbell",
 		capScope: "device",
@@ -76920,6 +77344,7 @@ var SYSTEM_CAP_VOCABULARY = {
 	"device-provider": system(INTERNAL),
 	"device-removal-hook": system(INTERNAL),
 	"device-state": system("the runtime-state mirror every trigger already reads through"),
+	"display-palette": system("the cluster display palette — one colour table for every client, not a device action"),
 	"embedding-encoder": system(ML),
 	"face-gallery": system("the face gallery — curated on its own page"),
 	"failure-contribution": system(INTERNAL),
@@ -79804,6 +80229,96 @@ Object.freeze({
 	"smtp-provider": "email"
 });
 DeviceType.Camera;
+DeviceType.Camera, DeviceType.Sensor, DeviceType.Button, DeviceType.Switch, DeviceType.PetFeeder, DeviceType.Container, DeviceType.Thermostat, DeviceType.Camera, DeviceType.Hub, DeviceType.Light, DeviceType.Siren, DeviceType.Switch, DeviceType.Sensor, DeviceType.Thermostat, DeviceType.Climate, DeviceType.Button, DeviceType.EventEmitter, DeviceType.Update, DeviceType.Generic, DeviceType.Notifier, DeviceType.Script, DeviceType.Automation, DeviceType.Lock, DeviceType.Cover, DeviceType.Valve, DeviceType.Humidifier, DeviceType.WaterHeater, DeviceType.Fan, DeviceType.MediaPlayer, DeviceType.AlarmPanel, DeviceType.Control, DeviceType.Presence, DeviceType.Weather, DeviceType.Vacuum, DeviceType.LawnMower, DeviceType.Container, DeviceType.Image, DeviceType.PetFeeder, DeviceType.Dishwasher, DeviceType.Camera, DeviceType.Camera, DeviceType.Dishwasher, DeviceType.Vacuum, DeviceType.LawnMower, DeviceType.MediaPlayer, DeviceType.WaterHeater, DeviceType.Humidifier, DeviceType.Fan, DeviceType.Climate, DeviceType.Thermostat, DeviceType.PetFeeder;
+/**
+* A saved Customize assignment (D936). The schema is the type: callers use
+* `z.infer`, they do not restate the shape.
+*/
+var OverrideSourceSchema = object({
+	addonId: string().min(1),
+	stableId: string().min(1),
+	cap: string().min(1),
+	fieldPath: string().min(1)
+});
+var CustomizeTransformDraftSchema = discriminatedUnion("kind", [
+	object({ kind: literal("identity") }),
+	object({ kind: literal("invert") }),
+	object({
+		kind: literal("threshold"),
+		comparison: _enum(["gte", "lte"]),
+		threshold: number(),
+		startDwellMs: number().nonnegative(),
+		stopDwellMs: number().nonnegative()
+	}),
+	object({
+		kind: literal("linear"),
+		scale: number(),
+		offset: number(),
+		clampMin: number().optional(),
+		clampMax: number().optional()
+	}),
+	object({
+		kind: literal("enum-map"),
+		mapping: record(string(), string().nullable())
+	}),
+	object({ kind: literal("number") })
+]);
+var ScalarOverrideDraftSchema = object({
+	kind: literal("scalar"),
+	cap: string().min(1),
+	targetId: string().min(1),
+	source: OverrideSourceSchema,
+	transform: CustomizeTransformDraftSchema
+});
+var KeyedArrayOverrideDraftSchema = object({
+	kind: literal("keyedArray"),
+	cap: string().min(1),
+	targetId: string().min(1),
+	key: string().min(1),
+	label: string().min(1),
+	fieldPath: string().min(1),
+	source: OverrideSourceSchema,
+	transform: CustomizeTransformDraftSchema
+});
+var PulseOverrideDraftSchema = object({
+	kind: literal("pulse"),
+	cap: string().min(1),
+	targetId: string().min(1),
+	enabled: boolean(),
+	debounceMs: number().nonnegative(),
+	sources: array(OverrideSourceSchema).min(1)
+});
+var SpanSourceDraftSchema = OverrideSourceSchema.extend({ mode: _enum([
+	"in-addition",
+	"confirm",
+	"replace"
+]).optional() });
+discriminatedUnion("kind", [
+	ScalarOverrideDraftSchema,
+	KeyedArrayOverrideDraftSchema,
+	PulseOverrideDraftSchema,
+	object({
+		kind: literal("span"),
+		cap: string().min(1),
+		targetId: string().min(1),
+		timeoutMs: number().nonnegative(),
+		cooldownMs: number().nonnegative().optional(),
+		sources: array(SpanSourceDraftSchema)
+	})
+]);
+object({
+	targetId: string().min(1),
+	configured: boolean(),
+	source: _enum(["native", "assigned"]),
+	state: _enum([
+		"active",
+		"stale",
+		"released",
+		"unavailable"
+	]),
+	reason: string().nullable()
+});
+String.raw`rose\(active(\d+), changed(\d+), (\d+(?:\.\d+)?)\)`;
 var G711_SCALE_CORRECTION_DB = {
 	PCMU: 20 * Math.log10(4),
 	PCMA: 20 * Math.log10(8)
@@ -84654,7 +85169,7 @@ var OsdManagerAddon = class extends BaseAddon {
 	* collection cap. Mirrors the manifest `pages[]` entry — admin-ui's
 	* `<AddonPageLoader>` loads `addon_osd_manager_page/page` from
 	* `/api/addon-pages/osd-manager/remoteEntry.js`. Modeled directly on
-	* `addon-benchmark` / `addon-model-studio` (docs/roadmap.md 4d).
+	* `addon-benchmark` / `addon-model-studio` (former roadmap item 4d).
 	*/
 	pages = [{
 		id: "osd-manager",