@camstack/addon-provider-homeassistant 1.1.25 → 1.1.26

package/dist/addon.js

@@ -1,5 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 let node_crypto = require("node:crypto");
+let node_zlib = require("node:zlib");
 //#region ../../node_modules/zod/v4/core/core.js
 var _a$1;
 function $constructor(name, initializer, params) {
@@ -4637,7 +4638,7 @@ function _instanceof(cls, params = {}) {
 	return inst;
 }
 //#endregion
-//#region ../types/dist/sleep-DkhOVOjW.mjs
+//#region ../types/dist/sleep-_sv7WKkq.mjs
 var EventCategory = /* @__PURE__ */ function(EventCategory) {
 	EventCategory["SystemBoot"] = "system.boot";
 	EventCategory["SystemAddonsReady"] = "system.addons-ready";
@@ -5068,6 +5069,14 @@ var EventCategory = /* @__PURE__ */ function(EventCategory) {
 	EventCategory["PipelineAnalyticsDetectionEvent"] = "pipeline-analytics.detection-event";
 	EventCategory["PipelineAnalyticsFrameTracked"] = "pipeline-analytics.frame-tracked";
 	/**
+	* Fired by `addon-post-analysis` when a parked (stationary) object appears
+	* (a track was promoted to a stationary-registry entry) or departs (the
+	* object moved / was removed). Telemetry (D8): lossy, drives a UI refresh of
+	* the dedicated "Stationary" section — never the live event feed. Payload:
+	* `{ deviceId, entryId, className, phase:'appeared'|'departed', timestamp }`.
+	*/
+	EventCategory["PipelineAnalyticsStationaryChanged"] = "pipeline-analytics.stationary-changed";
+	/**
 	* Fired by `addon-post-analysis` whenever a gallery face row changes:
 	* `kind:'buffered'` a new detected face was persisted, `'assigned'` /
 	* `'unassigned'` its identity link changed, `'deleted'` the row was
@@ -7015,6 +7024,15 @@ var ModelCatalogEntrySchema = object({
 		width: number(),
 		height: number()
 	}),
+	/**
+	* Channel count of the model input tensor. Omit ⇒ 3 (RGB), the default for
+	* every detector / classifier / embedder. Set to 1 for a grayscale CTC text
+	* recognizer (EasyOCR VGG plate-OCR: input `[N,1,H,W]`) so the preprocess
+	* feeds a single-channel, EasyOCR-normalized tensor instead of the default
+	* 3-channel RGB one. Threaded through `PoolModelConfig.inputChannels` to the
+	* Python inference pool.
+	*/
+	inputChannels: number().int().positive().optional(),
 	labels: array(LabelDefinitionSchema).readonly(),
 	inputLayout: _enum(["nchw", "nhwc"]).optional(),
 	inputNormalization: _enum([
@@ -7024,6 +7042,16 @@ var ModelCatalogEntrySchema = object({
 	]).optional(),
 	preprocessMode: _enum(["letterbox", "resize"]).optional(),
 	/**
+	* Per-MODEL postprocessor override. Absent ⇒ the step's own
+	* `StepDefinition.postprocessor` applies (the normal case — every model in a
+	* step shares its decode). Set it when a step hosts models with DIFFERENT raw
+	* output layouts under one slot: e.g. object-detection is `'yolo'` by default,
+	* but a Coral SSD MobileNet build emits the `TFLite_Detection_PostProcess`
+	* 4-tensor layout and needs `'ssd'`. Threaded into `PoolModelConfig.postprocessor`
+	* by the engine factory (`modelEntry.postprocessor ?? def.postprocessor`).
+	*/
+	postprocessor: custom().optional(),
+	/**
 	* When true, the executor produces a landmark-aligned crop (similarity warp
 	* onto the canonical template) before this step runs, instead of a plain
 	* axis-aligned bbox crop. Required for face-recognition embedders (ArcFace):
@@ -7113,6 +7141,123 @@ var ConvertResultSchema = object({
 	})).readonly()
 });
 /**
+* Build an `IAddonRouteProvider` from a list of routes. Implements
+* both the operator-facing `getRoutes` (returning route descriptors
+* minus the handlers, which can't cross JSON) and the framework-
+* private `invoke` method that the hub calls when this provider lives
+* in a forked worker.
+*
+* Co-located addons use the returned `getRoutes` directly because
+* their handlers don't need to cross any wire. The `invoke` method
+* is present anyway so the bridge code on the hub is uniform — it
+* doesn't need to switch on "local vs remote provider" at the call
+* site.
+*
+* Example:
+*   const routes: IAddonHttpRoute[] = [
+*     { method: 'GET', path: '/start', access: 'public', handler: this.handleStart },
+*   ]
+*   return [
+*     {
+*       capability: addonRoutesCapability,
+*       provider: buildAddonRouteProvider('auth-oidc', routes),
+*     },
+*   ]
+*/
+function buildAddonRouteProvider(id, routes) {
+	return {
+		id,
+		getRoutes: () => routes,
+		invoke: async (input) => {
+			const match = matchRoute(routes, input.method, input.path);
+			if (!match) return {
+				status: 404,
+				headers: {},
+				redirectUrl: null,
+				body: { error: `No route matches ${input.method} ${input.path}` }
+			};
+			const envelope = {
+				status: 200,
+				headers: {},
+				redirectUrl: null
+			};
+			const reply = buildCapturingReply(envelope);
+			const request = {
+				params: {
+					...input.params,
+					...match.params
+				},
+				query: input.query,
+				body: input.body,
+				headers: input.headers,
+				...input.user ? { user: input.user } : {},
+				...input.scopedToken !== void 0 ? { scopedToken: input.scopedToken } : {}
+			};
+			await match.route.handler(request, reply);
+			return envelope;
+		}
+	};
+}
+/**
+* Pattern matcher: same semantics as `AddonRouteRegistry.matchRoute`
+* but operating on a flat list and bypassing the `/addon/<id>/` prefix
+* — the bridge sends the post-prefix path directly so we don't need
+* to round-trip it through normalization.
+*/
+function matchRoute(routes, method, path) {
+	const normalizedMethod = method.toUpperCase();
+	for (const route of routes) {
+		if (route.method !== normalizedMethod) continue;
+		const params = matchPath(route.path, path);
+		if (params !== null) return {
+			route,
+			params
+		};
+	}
+	return null;
+}
+function matchPath(pattern, p) {
+	const patternParts = pattern.split("/").filter(Boolean);
+	const pathParts = p.split("/").filter(Boolean);
+	if (patternParts.length !== pathParts.length) return null;
+	const params = {};
+	for (let i = 0; i < patternParts.length; i++) {
+		const a = patternParts[i];
+		const b = pathParts[i];
+		if (a.startsWith(":")) params[a.slice(1)] = b;
+		else if (a !== b) return null;
+	}
+	return params;
+}
+function buildCapturingReply(envelope) {
+	const wrapper = {
+		status(code) {
+			envelope.status = code;
+			return wrapper;
+		},
+		code(code) {
+			envelope.status = code;
+			return wrapper;
+		},
+		send(data) {
+			envelope.body = data;
+		},
+		redirect(url) {
+			envelope.redirectUrl = url;
+			if (envelope.status === 200) envelope.status = 302;
+		},
+		header(name, value) {
+			envelope.headers[name.toLowerCase()] = value;
+			return wrapper;
+		},
+		type(mime) {
+			envelope.contentType = mime;
+			return wrapper;
+		}
+	};
+	return wrapper;
+}
+/**
 * Numeric day-of-week: 0 = Sunday … 6 = Saturday (matches `Date.getDay`).
 * Named `RecordingWeekday` to avoid collision with the string-union
 * `Weekday` exported from `interfaces/timezones.ts`.
@@ -12063,7 +12208,8 @@ var EngineProvisioningSchema = object({
 	runtimeId: _enum([
 		"onnx",
 		"openvino",
-		"coreml"
+		"coreml",
+		"edgetpu"
 	]).nullable(),
 	device: string().nullable(),
 	state: _enum([
@@ -14596,6 +14742,36 @@ var ZoneScopeBreakdownSchema = PerScopeBreakdownSchema.extend({
 	*  with the per-track detail panel and live overlay. */
 	trackIds: array(string()).readonly()
 });
+/**
+* A parked ("stationary") object surfaced alongside occupancy — an object that
+* settled and stopped moving. It is NO LONGER a tracked object (the tracker was
+* told to forget it so it stops re-spawning tracks/events), but it IS still
+* physically present, so it keeps counting toward `frame` occupancy and is
+* listed here so the UI can show it in a dedicated "Stationary" section instead
+* of flooding the live event feed.
+*/
+var StationaryObjectSchema = object({
+	id: string(),
+	className: string(),
+	bbox: object({
+		x: number(),
+		y: number(),
+		w: number(),
+		h: number()
+	}),
+	frameWidth: number().int().nonnegative(),
+	frameHeight: number().int().nonnegative(),
+	/** When the source track was first seen. */
+	firstSeenAt: number().int(),
+	/** When the object was recognised as parked (promotion time). */
+	becameStationaryAt: number().int(),
+	/** Last frame a detection confirmed the object is still there. */
+	lastConfirmedAt: number().int(),
+	/** Enrichment label carried from the source track (identity / plate). */
+	label: string().optional(),
+	/** Native-resolution key-frame media key for the parked object's best image. */
+	keyFrameMediaKey: string().optional()
+});
 var CameraOccupancySnapshotSchema = object({
 	/** Frame timestamp of the inference result that produced this snapshot. */
 	ts: number().int(),
@@ -14604,10 +14780,15 @@ var CameraOccupancySnapshotSchema = object({
 	frameHeight: number().int().nonnegative(),
 	/** Per-zone breakdown — one entry per defined zone (user + onboard). */
 	zones: array(ZoneScopeBreakdownSchema).readonly(),
-	/** Frame-wide aggregate (everywhere, regardless of zone membership). */
+	/** Frame-wide aggregate (everywhere, regardless of zone membership).
+	*  INCLUDES currently-confirmed stationary objects (they are still present). */
 	frame: PerScopeBreakdownSchema,
 	/** Detections that landed outside every zone. Empty when no zones defined. */
-	unzoned: PerScopeBreakdownSchema
+	unzoned: PerScopeBreakdownSchema,
+	/** Parked objects on this camera (additive — absent on legacy snapshots).
+	*  Surfaced separately so the UI shows them in a dedicated section rather
+	*  than as repeated tracks/events. */
+	stationaryObjects: array(StationaryObjectSchema).readonly().optional()
 });
 /**
 * Time-series resolution. The history methods return one bucket per
@@ -15895,7 +16076,26 @@ var InvokeReplyEnvelopeSchema = object({
 	/** Set when the handler called `reply.type(mime)`. */
 	contentType: string().optional()
 });
-method(_void(), array(AddonHttpRouteSchema)), method(InvokeRequestSchema, InvokeReplyEnvelopeSchema, { kind: "mutation" });
+var addonRoutesCapability = {
+	name: "addon-routes",
+	scope: "system",
+	mode: "collection",
+	internal: true,
+	methods: {
+		getRoutes: method(_void(), array(AddonHttpRouteSchema)),
+		/**
+		* Cross-process dispatch entry point. Forked addons implement this
+		* (via `buildAddonRouteProvider`) so the hub's Fastify catch-all
+		* can route through Moleculer when the handler lives in a worker.
+		*
+		* Local addons can implement it for free with the same helper;
+		* the hub bypasses the wire on co-located addons.
+		*/
+		invoke: method(InvokeRequestSchema, InvokeReplyEnvelopeSchema, { kind: "mutation" })
+	},
+	/** BIG PLAN 2: declarative mount hint — read by `@camstack/system` `buildCapRouters`. */
+	mount: { kind: "skip" }
+};
 var ConfigTabDeclarationSchema = object({
 	id: string(),
 	label: string(),
@@ -18916,6 +19116,22 @@ var TrackSnapshotSchema = object({
 	/** MediaStore key; resolve via `getTrackMedia({ trackId })`. */
 	mediaKey: string()
 });
+/**
+* One audio-classification label heard on the track's camera while the
+* track was alive, aggregated per label. An "episode" is one persisted
+* audio event (the confident-classification path: score ≥ the device's
+* `classificationMinScore`, class-change-or-heartbeat coalesced) — NOT
+* one 32 ms inference chunk, so counts stay human-scaled.
+*/
+var TrackAudioLabelSchema = object({
+	label: string(),
+	/** Highest classification score observed across the label's episodes. */
+	peakScore: number(),
+	/** Number of coalesced audio-event episodes carrying this label. */
+	count: number(),
+	firstAt: number(),
+	lastAt: number()
+});
 var TrackSchema = object({
 	trackId: string(),
 	deviceId: number(),
@@ -18947,7 +19163,11 @@ var TrackSchema = object({
 	bestEventId: string().optional(),
 	/** Tag of the importance sub-signal that dominated the score
 	*  (identity|dwell|proximity|class|confidence|travel|zone). */
-	importanceReason: string().optional()
+	importanceReason: string().optional(),
+	/** Audio-classification labels heard on the camera during the track's
+	*  life (score ≥ device `classificationMinScore`), aggregated per label.
+	*  Absent on legacy rows / tracks with no confident audio. */
+	audioLabels: array(TrackAudioLabelSchema).readonly().optional()
 });
 var BaseEventFields = {
 	id: string(),
@@ -22257,6 +22477,10 @@ var GpuInfoSchema = object({
 	memoryMB: number().optional()
 });
 var NpuInfoSchema = object({ type: _enum(["apple-ane", "intel-npu"]) });
+var CoralInfoSchema = object({
+	type: literal("coral-edgetpu"),
+	bus: string().optional()
+});
 var HardwareInfoSchema = object({
 	platform: HardwarePlatformSchema,
 	arch: HardwareArchSchema,
@@ -22265,7 +22489,8 @@ var HardwareInfoSchema = object({
 	totalRAM_MB: number(),
 	availableRAM_MB: number(),
 	gpu: GpuInfoSchema.nullable(),
-	npu: NpuInfoSchema.nullable()
+	npu: NpuInfoSchema.nullable(),
+	coral: CoralInfoSchema.nullable().optional()
 });
 var PlatformScoreSchema = object({
 	runtime: _enum(["node", "python"]),
@@ -33859,6 +34084,90 @@ function deriveIntegrationDomain(platforms) {
 	return best ?? present[0] ?? null;
 }
 //#endregion
+//#region src/ha-notification-icon.ts
+/**
+* Bundled brand icon for the `homeassistant` notification-output kind, served
+* by THIS addon over its own `addon-routes` HTTP surface. Mirrors the pattern
+* `addon-notifiers` uses for the other notifier kinds (each provider serves the
+* icon for the kinds it contributes), so `notificationOutput.listTargetKinds`
+* can stamp a self-hosted `iconUrl` onto the `homeassistant` descriptor and the
+* admin UI renders `<img src=iconUrl>` instead of a text label.
+*
+*   GET /addon/provider-homeassistant/icons/homeassistant  →  image/svg+xml
+*
+* The bytes ship INSIDE the addon (no external CDN / hotlink) so the icon is
+* self-contained and CSP-safe. The SVG is a standalone document (declares the
+* default `xmlns`, a `viewBox`, and an intrinsic `fill`) with NO editor-tool
+* namespaces, so a browser `<img src>` renders it in its strict SVG mode.
+*
+* We register ONE CONCRETE static route (`/icons/homeassistant`), never a
+* `/:kind` param route: the forked-addon route bridge re-matches the pattern
+* against itself and would clobber a `:kind` path param with the literal token
+* `':kind'`. A static path carries no param, so it routes correctly across the
+* process boundary.
+*
+* The route negotiates `Accept-Encoding` and stamps `content-encoding` itself
+* (serving a pre-computed br/gzip/deflate variant, or identity). This makes the
+* hub's global `@fastify/compress` skip the response — on the forked-addon route
+* bridge that compressor emits an EMPTY brotli stream for any compressible body
+* over its 1 KiB threshold, which shows as a broken `<img>`. Owning the coding
+* keeps this icon robust even if its bytes ever grow past the threshold, and
+* matches how `addon-notifiers` serves its notifier-kind icons.
+*/
+/** The single notifier kind this addon contributes an icon for. */
+var HA_ICON_KIND = "homeassistant";
+/** The addon id — also the `/addon/<id>/…` route prefix. Mirrors the manifest id. */
+var HA_ROUTE_ID = "provider-homeassistant";
+/** One day; the icon is immutable per addon version. */
+var CACHE_CONTROL = "public, max-age=86400, immutable";
+/**
+* Home Assistant's official brand mark (simple-icons `homeassistant`, CC0) —
+* the blue "house + circuit" glyph — tinted with the official HA brand hex
+* (#18BCF2) so it reads on the dark admin UI. A standalone SVG document, no
+* editor-tool namespaces.
+*/
+var HOME_ASSISTANT_SVG = "<svg xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"0 0 24 24\" width=\"24\" height=\"24\" fill=\"#18BCF2\"><path d=\"M22.939 10.627 13.061.749a1.505 1.505 0 0 0-2.121 0l-9.879 9.878C.478 11.21 0 12.363 0 13.187v9c0 .826.675 1.5 1.5 1.5h9.227l-4.063-4.062a2.034 2.034 0 0 1-.664.113c-1.13 0-2.05-.92-2.05-2.05s.92-2.05 2.05-2.05 2.05.92 2.05 2.05c0 .233-.041.456-.113.665l3.163 3.163V9.928a2.05 2.05 0 0 1-1.15-1.84c0-1.13.92-2.05 2.05-2.05s2.05.92 2.05 2.05a2.05 2.05 0 0 1-1.15 1.84v8.127l3.146-3.146A2.051 2.051 0 0 1 18 12.239c1.13 0 2.05.92 2.05 2.05s-.92 2.05-2.05 2.05c-.25 0-.488-.047-.709-.13L12.9 20.602v3.088h9.6c.825 0 1.5-.675 1.5-1.5v-9c0-.825-.477-1.977-1.061-2.561z\"/></svg>";
+/**
+* The stable icon URL for the `homeassistant` kind. Stamped onto the descriptor
+* by `listTargetKinds`. Root-relative so it resolves against whatever origin
+* the admin UI is served from.
+*/
+var HA_NOTIFICATION_ICON_URL = `/addon/${HA_ROUTE_ID}/icons/${HA_ICON_KIND}`;
+/** The icon's identity bytes plus every content coding we may serve, computed
+*  once at module load (the icon is immutable). */
+var HA_ICON_IDENTITY = Buffer.from(HOME_ASSISTANT_SVG, "utf8");
+var HA_ICON_ENCODED = {
+	br: (0, node_zlib.brotliCompressSync)(HA_ICON_IDENTITY),
+	gzip: (0, node_zlib.gzipSync)(HA_ICON_IDENTITY),
+	deflate: (0, node_zlib.deflateSync)(HA_ICON_IDENTITY)
+};
+/** Pick the best coding the client accepts (br › gzip › deflate), or `null` for
+*  identity when the header names none of them. */
+function negotiateEncoding(acceptEncoding) {
+	const tokens = acceptEncoding.toLowerCase().split(",").map((part) => part.trim().split(";")[0]?.trim());
+	for (const coding of [
+		"br",
+		"gzip",
+		"deflate"
+	]) if (tokens.includes(coding)) return coding;
+	return null;
+}
+/** Build the `addon-routes` provider that serves the bundled Home Assistant icon. */
+function createHaIconRouteProvider() {
+	return buildAddonRouteProvider(HA_ROUTE_ID, [{
+		method: "GET",
+		path: `/icons/${HA_ICON_KIND}`,
+		access: "public",
+		description: "Official brand icon (SVG) for the 'homeassistant' notifier kind.",
+		handler: async (request, reply) => {
+			const coding = negotiateEncoding(String(request.headers["accept-encoding"] ?? ""));
+			reply.code(200).type("image/svg+xml").header("cache-control", CACHE_CONTROL).header("vary", "accept-encoding");
+			if (coding !== null) reply.header("content-encoding", coding);
+			reply.send(coding !== null ? HA_ICON_ENCODED[coding] : HA_ICON_IDENTITY);
+		}
+	}]);
+}
+//#endregion
 //#region src/ha-notification-output.ts
 /**
 * `homeassistant` notification-output kind — hosted BY the HA provider addon.
@@ -34048,6 +34357,13 @@ function parseNotifyServices(result, brokerId) {
 		}
 	}));
 }
+/** KV JSON-blob shape — a single `data` column routes the row through the
+*  settings backend's canonical key/value path (id TEXT PK, data TEXT). */
+var KV_BLOB_COLUMNS = [{
+	name: "data",
+	type: "TEXT",
+	notNull: true
+}];
 function rowToTarget(row) {
 	const parsed = TargetSchema.safeParse({
 		id: row.id,
@@ -34072,6 +34388,12 @@ var HaTargetStore = class {
 		this.store = store;
 		this.collection = collection;
 	}
+	/** Declare the backing collection before any read/write. The SQLite settings
+	*  backend rejects undeclared collections (fail-fast), so this MUST run before
+	*  `list`/`getById`/`upsert`/`delete` — mirrors addon-ai's ProfileStore.init. */
+	async init() {
+		await this.store.declareCollection(this.collection, KV_BLOB_COLUMNS);
+	}
 	async list() {
 		const rows = await this.store.query(this.collection);
 		const out = [];
@@ -34138,6 +34460,12 @@ function createApiHaSettingsStorePort(api) {
 				collection,
 				key: id
 			});
+		},
+		declareCollection: async (collection, columns) => {
+			await api.settingsStore.declareCollection.mutate({
+				collection,
+				columns: columns.map((c) => ({ ...c }))
+			});
 		}
 	};
 }
@@ -34168,6 +34496,9 @@ function createMemoryHaSettingsStorePort() {
 		},
 		remove: async (collection, id) => {
 			bucket(collection).delete(id);
+		},
+		declareCollection: async (collection) => {
+			bucket(collection);
 		}
 	};
 }
@@ -34237,7 +34568,12 @@ function createHaNotificationOutputProvider(deps) {
 		}
 	}
 	return {
-		listTargetKinds: async () => [descriptor],
+		listTargetKinds: async () => {
+			return [deps.iconUrl !== void 0 ? {
+				...descriptor,
+				iconUrl: deps.iconUrl
+			} : descriptor];
+		},
 		listTargets: async () => {
 			return (await store.list()).map((target) => ({
 				...target,
@@ -34803,17 +35139,23 @@ var HaProviderAddon = class HaProviderAddon extends BaseDeviceProvider {
 			},
 			{
 				capability: notificationOutputCapability,
-				provider: this.buildNotificationOutputProvider()
+				provider: await this.buildNotificationOutputProvider()
+			},
+			{
+				capability: addonRoutesCapability,
+				provider: createHaIconRouteProvider()
 			}
 		];
 	}
-	buildNotificationOutputProvider() {
+	async buildNotificationOutputProvider() {
 		const api = this.ctx.api;
 		const port = api ? createApiHaSettingsStorePort(api) : createMemoryHaSettingsStorePort();
 		if (!api) this.ctx.logger.warn("ha notification-output: no ctx.api — targets persist in-memory only");
 		const store = new HaTargetStore(port);
+		await store.init();
 		return createHaNotificationOutputProvider({
 			addonId: this.ctx.id,
+			iconUrl: HA_NOTIFICATION_ICON_URL,
 			store,
 			publish: async (brokerId, service, serviceData) => {
 				await this.requireRegistry().publish(brokerId, {

package/dist/addon.mjs

@@ -1,4 +1,5 @@
 import { randomUUID } from "node:crypto";
+import { brotliCompressSync, deflateSync, gzipSync } from "node:zlib";
 //#region ../../node_modules/zod/v4/core/core.js
 var _a$1;
 function $constructor(name, initializer, params) {
@@ -4636,7 +4637,7 @@ function _instanceof(cls, params = {}) {
 	return inst;
 }
 //#endregion
-//#region ../types/dist/sleep-DkhOVOjW.mjs
+//#region ../types/dist/sleep-_sv7WKkq.mjs
 var EventCategory = /* @__PURE__ */ function(EventCategory) {
 	EventCategory["SystemBoot"] = "system.boot";
 	EventCategory["SystemAddonsReady"] = "system.addons-ready";
@@ -5067,6 +5068,14 @@ var EventCategory = /* @__PURE__ */ function(EventCategory) {
 	EventCategory["PipelineAnalyticsDetectionEvent"] = "pipeline-analytics.detection-event";
 	EventCategory["PipelineAnalyticsFrameTracked"] = "pipeline-analytics.frame-tracked";
 	/**
+	* Fired by `addon-post-analysis` when a parked (stationary) object appears
+	* (a track was promoted to a stationary-registry entry) or departs (the
+	* object moved / was removed). Telemetry (D8): lossy, drives a UI refresh of
+	* the dedicated "Stationary" section — never the live event feed. Payload:
+	* `{ deviceId, entryId, className, phase:'appeared'|'departed', timestamp }`.
+	*/
+	EventCategory["PipelineAnalyticsStationaryChanged"] = "pipeline-analytics.stationary-changed";
+	/**
 	* Fired by `addon-post-analysis` whenever a gallery face row changes:
 	* `kind:'buffered'` a new detected face was persisted, `'assigned'` /
 	* `'unassigned'` its identity link changed, `'deleted'` the row was
@@ -7014,6 +7023,15 @@ var ModelCatalogEntrySchema = object({
 		width: number(),
 		height: number()
 	}),
+	/**
+	* Channel count of the model input tensor. Omit ⇒ 3 (RGB), the default for
+	* every detector / classifier / embedder. Set to 1 for a grayscale CTC text
+	* recognizer (EasyOCR VGG plate-OCR: input `[N,1,H,W]`) so the preprocess
+	* feeds a single-channel, EasyOCR-normalized tensor instead of the default
+	* 3-channel RGB one. Threaded through `PoolModelConfig.inputChannels` to the
+	* Python inference pool.
+	*/
+	inputChannels: number().int().positive().optional(),
 	labels: array(LabelDefinitionSchema).readonly(),
 	inputLayout: _enum(["nchw", "nhwc"]).optional(),
 	inputNormalization: _enum([
@@ -7023,6 +7041,16 @@ var ModelCatalogEntrySchema = object({
 	]).optional(),
 	preprocessMode: _enum(["letterbox", "resize"]).optional(),
 	/**
+	* Per-MODEL postprocessor override. Absent ⇒ the step's own
+	* `StepDefinition.postprocessor` applies (the normal case — every model in a
+	* step shares its decode). Set it when a step hosts models with DIFFERENT raw
+	* output layouts under one slot: e.g. object-detection is `'yolo'` by default,
+	* but a Coral SSD MobileNet build emits the `TFLite_Detection_PostProcess`
+	* 4-tensor layout and needs `'ssd'`. Threaded into `PoolModelConfig.postprocessor`
+	* by the engine factory (`modelEntry.postprocessor ?? def.postprocessor`).
+	*/
+	postprocessor: custom().optional(),
+	/**
 	* When true, the executor produces a landmark-aligned crop (similarity warp
 	* onto the canonical template) before this step runs, instead of a plain
 	* axis-aligned bbox crop. Required for face-recognition embedders (ArcFace):
@@ -7112,6 +7140,123 @@ var ConvertResultSchema = object({
 	})).readonly()
 });
 /**
+* Build an `IAddonRouteProvider` from a list of routes. Implements
+* both the operator-facing `getRoutes` (returning route descriptors
+* minus the handlers, which can't cross JSON) and the framework-
+* private `invoke` method that the hub calls when this provider lives
+* in a forked worker.
+*
+* Co-located addons use the returned `getRoutes` directly because
+* their handlers don't need to cross any wire. The `invoke` method
+* is present anyway so the bridge code on the hub is uniform — it
+* doesn't need to switch on "local vs remote provider" at the call
+* site.
+*
+* Example:
+*   const routes: IAddonHttpRoute[] = [
+*     { method: 'GET', path: '/start', access: 'public', handler: this.handleStart },
+*   ]
+*   return [
+*     {
+*       capability: addonRoutesCapability,
+*       provider: buildAddonRouteProvider('auth-oidc', routes),
+*     },
+*   ]
+*/
+function buildAddonRouteProvider(id, routes) {
+	return {
+		id,
+		getRoutes: () => routes,
+		invoke: async (input) => {
+			const match = matchRoute(routes, input.method, input.path);
+			if (!match) return {
+				status: 404,
+				headers: {},
+				redirectUrl: null,
+				body: { error: `No route matches ${input.method} ${input.path}` }
+			};
+			const envelope = {
+				status: 200,
+				headers: {},
+				redirectUrl: null
+			};
+			const reply = buildCapturingReply(envelope);
+			const request = {
+				params: {
+					...input.params,
+					...match.params
+				},
+				query: input.query,
+				body: input.body,
+				headers: input.headers,
+				...input.user ? { user: input.user } : {},
+				...input.scopedToken !== void 0 ? { scopedToken: input.scopedToken } : {}
+			};
+			await match.route.handler(request, reply);
+			return envelope;
+		}
+	};
+}
+/**
+* Pattern matcher: same semantics as `AddonRouteRegistry.matchRoute`
+* but operating on a flat list and bypassing the `/addon/<id>/` prefix
+* — the bridge sends the post-prefix path directly so we don't need
+* to round-trip it through normalization.
+*/
+function matchRoute(routes, method, path) {
+	const normalizedMethod = method.toUpperCase();
+	for (const route of routes) {
+		if (route.method !== normalizedMethod) continue;
+		const params = matchPath(route.path, path);
+		if (params !== null) return {
+			route,
+			params
+		};
+	}
+	return null;
+}
+function matchPath(pattern, p) {
+	const patternParts = pattern.split("/").filter(Boolean);
+	const pathParts = p.split("/").filter(Boolean);
+	if (patternParts.length !== pathParts.length) return null;
+	const params = {};
+	for (let i = 0; i < patternParts.length; i++) {
+		const a = patternParts[i];
+		const b = pathParts[i];
+		if (a.startsWith(":")) params[a.slice(1)] = b;
+		else if (a !== b) return null;
+	}
+	return params;
+}
+function buildCapturingReply(envelope) {
+	const wrapper = {
+		status(code) {
+			envelope.status = code;
+			return wrapper;
+		},
+		code(code) {
+			envelope.status = code;
+			return wrapper;
+		},
+		send(data) {
+			envelope.body = data;
+		},
+		redirect(url) {
+			envelope.redirectUrl = url;
+			if (envelope.status === 200) envelope.status = 302;
+		},
+		header(name, value) {
+			envelope.headers[name.toLowerCase()] = value;
+			return wrapper;
+		},
+		type(mime) {
+			envelope.contentType = mime;
+			return wrapper;
+		}
+	};
+	return wrapper;
+}
+/**
 * Numeric day-of-week: 0 = Sunday … 6 = Saturday (matches `Date.getDay`).
 * Named `RecordingWeekday` to avoid collision with the string-union
 * `Weekday` exported from `interfaces/timezones.ts`.
@@ -12062,7 +12207,8 @@ var EngineProvisioningSchema = object({
 	runtimeId: _enum([
 		"onnx",
 		"openvino",
-		"coreml"
+		"coreml",
+		"edgetpu"
 	]).nullable(),
 	device: string().nullable(),
 	state: _enum([
@@ -14595,6 +14741,36 @@ var ZoneScopeBreakdownSchema = PerScopeBreakdownSchema.extend({
 	*  with the per-track detail panel and live overlay. */
 	trackIds: array(string()).readonly()
 });
+/**
+* A parked ("stationary") object surfaced alongside occupancy — an object that
+* settled and stopped moving. It is NO LONGER a tracked object (the tracker was
+* told to forget it so it stops re-spawning tracks/events), but it IS still
+* physically present, so it keeps counting toward `frame` occupancy and is
+* listed here so the UI can show it in a dedicated "Stationary" section instead
+* of flooding the live event feed.
+*/
+var StationaryObjectSchema = object({
+	id: string(),
+	className: string(),
+	bbox: object({
+		x: number(),
+		y: number(),
+		w: number(),
+		h: number()
+	}),
+	frameWidth: number().int().nonnegative(),
+	frameHeight: number().int().nonnegative(),
+	/** When the source track was first seen. */
+	firstSeenAt: number().int(),
+	/** When the object was recognised as parked (promotion time). */
+	becameStationaryAt: number().int(),
+	/** Last frame a detection confirmed the object is still there. */
+	lastConfirmedAt: number().int(),
+	/** Enrichment label carried from the source track (identity / plate). */
+	label: string().optional(),
+	/** Native-resolution key-frame media key for the parked object's best image. */
+	keyFrameMediaKey: string().optional()
+});
 var CameraOccupancySnapshotSchema = object({
 	/** Frame timestamp of the inference result that produced this snapshot. */
 	ts: number().int(),
@@ -14603,10 +14779,15 @@ var CameraOccupancySnapshotSchema = object({
 	frameHeight: number().int().nonnegative(),
 	/** Per-zone breakdown — one entry per defined zone (user + onboard). */
 	zones: array(ZoneScopeBreakdownSchema).readonly(),
-	/** Frame-wide aggregate (everywhere, regardless of zone membership). */
+	/** Frame-wide aggregate (everywhere, regardless of zone membership).
+	*  INCLUDES currently-confirmed stationary objects (they are still present). */
 	frame: PerScopeBreakdownSchema,
 	/** Detections that landed outside every zone. Empty when no zones defined. */
-	unzoned: PerScopeBreakdownSchema
+	unzoned: PerScopeBreakdownSchema,
+	/** Parked objects on this camera (additive — absent on legacy snapshots).
+	*  Surfaced separately so the UI shows them in a dedicated section rather
+	*  than as repeated tracks/events. */
+	stationaryObjects: array(StationaryObjectSchema).readonly().optional()
 });
 /**
 * Time-series resolution. The history methods return one bucket per
@@ -15894,7 +16075,26 @@ var InvokeReplyEnvelopeSchema = object({
 	/** Set when the handler called `reply.type(mime)`. */
 	contentType: string().optional()
 });
-method(_void(), array(AddonHttpRouteSchema)), method(InvokeRequestSchema, InvokeReplyEnvelopeSchema, { kind: "mutation" });
+var addonRoutesCapability = {
+	name: "addon-routes",
+	scope: "system",
+	mode: "collection",
+	internal: true,
+	methods: {
+		getRoutes: method(_void(), array(AddonHttpRouteSchema)),
+		/**
+		* Cross-process dispatch entry point. Forked addons implement this
+		* (via `buildAddonRouteProvider`) so the hub's Fastify catch-all
+		* can route through Moleculer when the handler lives in a worker.
+		*
+		* Local addons can implement it for free with the same helper;
+		* the hub bypasses the wire on co-located addons.
+		*/
+		invoke: method(InvokeRequestSchema, InvokeReplyEnvelopeSchema, { kind: "mutation" })
+	},
+	/** BIG PLAN 2: declarative mount hint — read by `@camstack/system` `buildCapRouters`. */
+	mount: { kind: "skip" }
+};
 var ConfigTabDeclarationSchema = object({
 	id: string(),
 	label: string(),
@@ -18915,6 +19115,22 @@ var TrackSnapshotSchema = object({
 	/** MediaStore key; resolve via `getTrackMedia({ trackId })`. */
 	mediaKey: string()
 });
+/**
+* One audio-classification label heard on the track's camera while the
+* track was alive, aggregated per label. An "episode" is one persisted
+* audio event (the confident-classification path: score ≥ the device's
+* `classificationMinScore`, class-change-or-heartbeat coalesced) — NOT
+* one 32 ms inference chunk, so counts stay human-scaled.
+*/
+var TrackAudioLabelSchema = object({
+	label: string(),
+	/** Highest classification score observed across the label's episodes. */
+	peakScore: number(),
+	/** Number of coalesced audio-event episodes carrying this label. */
+	count: number(),
+	firstAt: number(),
+	lastAt: number()
+});
 var TrackSchema = object({
 	trackId: string(),
 	deviceId: number(),
@@ -18946,7 +19162,11 @@ var TrackSchema = object({
 	bestEventId: string().optional(),
 	/** Tag of the importance sub-signal that dominated the score
 	*  (identity|dwell|proximity|class|confidence|travel|zone). */
-	importanceReason: string().optional()
+	importanceReason: string().optional(),
+	/** Audio-classification labels heard on the camera during the track's
+	*  life (score ≥ device `classificationMinScore`), aggregated per label.
+	*  Absent on legacy rows / tracks with no confident audio. */
+	audioLabels: array(TrackAudioLabelSchema).readonly().optional()
 });
 var BaseEventFields = {
 	id: string(),
@@ -22256,6 +22476,10 @@ var GpuInfoSchema = object({
 	memoryMB: number().optional()
 });
 var NpuInfoSchema = object({ type: _enum(["apple-ane", "intel-npu"]) });
+var CoralInfoSchema = object({
+	type: literal("coral-edgetpu"),
+	bus: string().optional()
+});
 var HardwareInfoSchema = object({
 	platform: HardwarePlatformSchema,
 	arch: HardwareArchSchema,
@@ -22264,7 +22488,8 @@ var HardwareInfoSchema = object({
 	totalRAM_MB: number(),
 	availableRAM_MB: number(),
 	gpu: GpuInfoSchema.nullable(),
-	npu: NpuInfoSchema.nullable()
+	npu: NpuInfoSchema.nullable(),
+	coral: CoralInfoSchema.nullable().optional()
 });
 var PlatformScoreSchema = object({
 	runtime: _enum(["node", "python"]),
@@ -33858,6 +34083,90 @@ function deriveIntegrationDomain(platforms) {
 	return best ?? present[0] ?? null;
 }
 //#endregion
+//#region src/ha-notification-icon.ts
+/**
+* Bundled brand icon for the `homeassistant` notification-output kind, served
+* by THIS addon over its own `addon-routes` HTTP surface. Mirrors the pattern
+* `addon-notifiers` uses for the other notifier kinds (each provider serves the
+* icon for the kinds it contributes), so `notificationOutput.listTargetKinds`
+* can stamp a self-hosted `iconUrl` onto the `homeassistant` descriptor and the
+* admin UI renders `<img src=iconUrl>` instead of a text label.
+*
+*   GET /addon/provider-homeassistant/icons/homeassistant  →  image/svg+xml
+*
+* The bytes ship INSIDE the addon (no external CDN / hotlink) so the icon is
+* self-contained and CSP-safe. The SVG is a standalone document (declares the
+* default `xmlns`, a `viewBox`, and an intrinsic `fill`) with NO editor-tool
+* namespaces, so a browser `<img src>` renders it in its strict SVG mode.
+*
+* We register ONE CONCRETE static route (`/icons/homeassistant`), never a
+* `/:kind` param route: the forked-addon route bridge re-matches the pattern
+* against itself and would clobber a `:kind` path param with the literal token
+* `':kind'`. A static path carries no param, so it routes correctly across the
+* process boundary.
+*
+* The route negotiates `Accept-Encoding` and stamps `content-encoding` itself
+* (serving a pre-computed br/gzip/deflate variant, or identity). This makes the
+* hub's global `@fastify/compress` skip the response — on the forked-addon route
+* bridge that compressor emits an EMPTY brotli stream for any compressible body
+* over its 1 KiB threshold, which shows as a broken `<img>`. Owning the coding
+* keeps this icon robust even if its bytes ever grow past the threshold, and
+* matches how `addon-notifiers` serves its notifier-kind icons.
+*/
+/** The single notifier kind this addon contributes an icon for. */
+var HA_ICON_KIND = "homeassistant";
+/** The addon id — also the `/addon/<id>/…` route prefix. Mirrors the manifest id. */
+var HA_ROUTE_ID = "provider-homeassistant";
+/** One day; the icon is immutable per addon version. */
+var CACHE_CONTROL = "public, max-age=86400, immutable";
+/**
+* Home Assistant's official brand mark (simple-icons `homeassistant`, CC0) —
+* the blue "house + circuit" glyph — tinted with the official HA brand hex
+* (#18BCF2) so it reads on the dark admin UI. A standalone SVG document, no
+* editor-tool namespaces.
+*/
+var HOME_ASSISTANT_SVG = "<svg xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"0 0 24 24\" width=\"24\" height=\"24\" fill=\"#18BCF2\"><path d=\"M22.939 10.627 13.061.749a1.505 1.505 0 0 0-2.121 0l-9.879 9.878C.478 11.21 0 12.363 0 13.187v9c0 .826.675 1.5 1.5 1.5h9.227l-4.063-4.062a2.034 2.034 0 0 1-.664.113c-1.13 0-2.05-.92-2.05-2.05s.92-2.05 2.05-2.05 2.05.92 2.05 2.05c0 .233-.041.456-.113.665l3.163 3.163V9.928a2.05 2.05 0 0 1-1.15-1.84c0-1.13.92-2.05 2.05-2.05s2.05.92 2.05 2.05a2.05 2.05 0 0 1-1.15 1.84v8.127l3.146-3.146A2.051 2.051 0 0 1 18 12.239c1.13 0 2.05.92 2.05 2.05s-.92 2.05-2.05 2.05c-.25 0-.488-.047-.709-.13L12.9 20.602v3.088h9.6c.825 0 1.5-.675 1.5-1.5v-9c0-.825-.477-1.977-1.061-2.561z\"/></svg>";
+/**
+* The stable icon URL for the `homeassistant` kind. Stamped onto the descriptor
+* by `listTargetKinds`. Root-relative so it resolves against whatever origin
+* the admin UI is served from.
+*/
+var HA_NOTIFICATION_ICON_URL = `/addon/${HA_ROUTE_ID}/icons/${HA_ICON_KIND}`;
+/** The icon's identity bytes plus every content coding we may serve, computed
+*  once at module load (the icon is immutable). */
+var HA_ICON_IDENTITY = Buffer.from(HOME_ASSISTANT_SVG, "utf8");
+var HA_ICON_ENCODED = {
+	br: brotliCompressSync(HA_ICON_IDENTITY),
+	gzip: gzipSync(HA_ICON_IDENTITY),
+	deflate: deflateSync(HA_ICON_IDENTITY)
+};
+/** Pick the best coding the client accepts (br › gzip › deflate), or `null` for
+*  identity when the header names none of them. */
+function negotiateEncoding(acceptEncoding) {
+	const tokens = acceptEncoding.toLowerCase().split(",").map((part) => part.trim().split(";")[0]?.trim());
+	for (const coding of [
+		"br",
+		"gzip",
+		"deflate"
+	]) if (tokens.includes(coding)) return coding;
+	return null;
+}
+/** Build the `addon-routes` provider that serves the bundled Home Assistant icon. */
+function createHaIconRouteProvider() {
+	return buildAddonRouteProvider(HA_ROUTE_ID, [{
+		method: "GET",
+		path: `/icons/${HA_ICON_KIND}`,
+		access: "public",
+		description: "Official brand icon (SVG) for the 'homeassistant' notifier kind.",
+		handler: async (request, reply) => {
+			const coding = negotiateEncoding(String(request.headers["accept-encoding"] ?? ""));
+			reply.code(200).type("image/svg+xml").header("cache-control", CACHE_CONTROL).header("vary", "accept-encoding");
+			if (coding !== null) reply.header("content-encoding", coding);
+			reply.send(coding !== null ? HA_ICON_ENCODED[coding] : HA_ICON_IDENTITY);
+		}
+	}]);
+}
+//#endregion
 //#region src/ha-notification-output.ts
 /**
 * `homeassistant` notification-output kind — hosted BY the HA provider addon.
@@ -34047,6 +34356,13 @@ function parseNotifyServices(result, brokerId) {
 		}
 	}));
 }
+/** KV JSON-blob shape — a single `data` column routes the row through the
+*  settings backend's canonical key/value path (id TEXT PK, data TEXT). */
+var KV_BLOB_COLUMNS = [{
+	name: "data",
+	type: "TEXT",
+	notNull: true
+}];
 function rowToTarget(row) {
 	const parsed = TargetSchema.safeParse({
 		id: row.id,
@@ -34071,6 +34387,12 @@ var HaTargetStore = class {
 		this.store = store;
 		this.collection = collection;
 	}
+	/** Declare the backing collection before any read/write. The SQLite settings
+	*  backend rejects undeclared collections (fail-fast), so this MUST run before
+	*  `list`/`getById`/`upsert`/`delete` — mirrors addon-ai's ProfileStore.init. */
+	async init() {
+		await this.store.declareCollection(this.collection, KV_BLOB_COLUMNS);
+	}
 	async list() {
 		const rows = await this.store.query(this.collection);
 		const out = [];
@@ -34137,6 +34459,12 @@ function createApiHaSettingsStorePort(api) {
 				collection,
 				key: id
 			});
+		},
+		declareCollection: async (collection, columns) => {
+			await api.settingsStore.declareCollection.mutate({
+				collection,
+				columns: columns.map((c) => ({ ...c }))
+			});
 		}
 	};
 }
@@ -34167,6 +34495,9 @@ function createMemoryHaSettingsStorePort() {
 		},
 		remove: async (collection, id) => {
 			bucket(collection).delete(id);
+		},
+		declareCollection: async (collection) => {
+			bucket(collection);
 		}
 	};
 }
@@ -34236,7 +34567,12 @@ function createHaNotificationOutputProvider(deps) {
 		}
 	}
 	return {
-		listTargetKinds: async () => [descriptor],
+		listTargetKinds: async () => {
+			return [deps.iconUrl !== void 0 ? {
+				...descriptor,
+				iconUrl: deps.iconUrl
+			} : descriptor];
+		},
 		listTargets: async () => {
 			return (await store.list()).map((target) => ({
 				...target,
@@ -34802,17 +35138,23 @@ var HaProviderAddon = class HaProviderAddon extends BaseDeviceProvider {
 			},
 			{
 				capability: notificationOutputCapability,
-				provider: this.buildNotificationOutputProvider()
+				provider: await this.buildNotificationOutputProvider()
+			},
+			{
+				capability: addonRoutesCapability,
+				provider: createHaIconRouteProvider()
 			}
 		];
 	}
-	buildNotificationOutputProvider() {
+	async buildNotificationOutputProvider() {
 		const api = this.ctx.api;
 		const port = api ? createApiHaSettingsStorePort(api) : createMemoryHaSettingsStorePort();
 		if (!api) this.ctx.logger.warn("ha notification-output: no ctx.api — targets persist in-memory only");
 		const store = new HaTargetStore(port);
+		await store.init();
 		return createHaNotificationOutputProvider({
 			addonId: this.ctx.id,
+			iconUrl: HA_NOTIFICATION_ICON_URL,
 			store,
 			publish: async (brokerId, service, serviceData) => {
 				await this.requireRegistry().publish(brokerId, {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/addon-provider-homeassistant",
-  "version": "1.1.25",
+  "version": "1.1.26",
   "description": "Home Assistant device provider addon for CamStack",
   "keywords": [
     "camstack",
@@ -78,6 +78,9 @@
           },
           {
             "name": "notification-output"
+          },
+          {
+            "name": "addon-routes"
           }
         ]
       }