@camstack/addon-post-analysis 1.1.0 → 1.1.1

package/dist/{dist-xZ1nMZGV.mjs → dist-BUE-vLMt.mjs}

@@ -4627,7 +4627,7 @@ function _instanceof(cls, params = {}) {
 	return inst;
 }
 //#endregion
-//#region ../types/dist/sleep-B1dKJAMJ.mjs
+//#region ../types/dist/sleep-BV7rLc6Y.mjs
 var EventCategory = /* @__PURE__ */ function(EventCategory) {
 	EventCategory["SystemBoot"] = "system.boot";
 	EventCategory["SystemAddonsReady"] = "system.addons-ready";
@@ -5106,6 +5106,12 @@ var EventCategory = /* @__PURE__ */ function(EventCategory) {
 	* Payload: `{ deviceId, childDeviceIds, hiddenChildIds }`.
 	*/
 	EventCategory["AccessoriesChanged"] = "accessories.onAccessoriesChanged";
+	/**
+	* Progress update from a running model conversion job.
+	* Payload: `{ kind: 'model-convert', phase, sessionId?, pct?, detail? }`.
+	* Emitted by `addon-model-studio` on the converting node.
+	*/
+	EventCategory["ModelConvertProgress"] = "model-convert.progress";
 	return EventCategory;
 }({});
 Object.fromEntries([
@@ -6644,6 +6650,13 @@ object({
 		unreachable: number()
 	})
 });
+var LabelDefinitionSchema = object({
+	id: string(),
+	name: string(),
+	category: string().optional(),
+	description: string().optional(),
+	icon: string().optional()
+});
 var MODEL_FORMATS = [
 	"onnx",
 	"coreml",
@@ -6652,6 +6665,120 @@ var MODEL_FORMATS = [
 	"pt"
 ];
 /**
+* Multi-file format payload.
+*
+* - Directory formats (`isDirectory: true`, e.g. `.mlpackage`): files
+*   relative to the directory root — the downloader fetches each from
+*   `{url}/{file}` into `{modelDir}/{file}`. If omitted, it probes the
+*   HuggingFace API (slower).
+* - Single-file formats (no `isDirectory`, e.g. OpenVINO IR): sibling
+*   files fetched from the SAME remote directory as `url` and stored flat
+*   alongside the main file — e.g. `['camstack-yolov9t.bin']` for the IR
+*   weights next to `camstack-yolov9t.xml`.
+*/
+var ModelFormatEntrySchema = object({
+	url: string(),
+	sizeMB: number(),
+	/** Whether this format is a directory bundle (e.g., .mlpackage) rather than a single file */
+	isDirectory: boolean().optional(),
+	/** Multi-file payload (directory members or sibling files). */
+	files: array(string()).readonly().optional(),
+	/** Runtime(s) that can use this format. If omitted, inferred from ModelFormat key */
+	runtimes: array(_enum(["node", "python"])).readonly().optional()
+});
+/**
+* Extra file that must be downloaded alongside the model (e.g., labels JSON, dict.txt).
+* The downloader fetches from `url` and saves to `{modelsDir}/{filename}`.
+*/
+var ModelExtraFileSchema = object({
+	url: string(),
+	filename: string(),
+	sizeMB: number()
+});
+/**
+* Per-format payload map. Modelled as an explicit object (one optional key
+* per `ModelFormat`) rather than `z.record(enum, …)` — zod v4's enum-keyed
+* record requires every key, but a catalog entry only ships a subset of
+* formats.
+*/
+var ModelFormatsSchema = object({
+	onnx: ModelFormatEntrySchema.optional(),
+	coreml: ModelFormatEntrySchema.optional(),
+	openvino: ModelFormatEntrySchema.optional(),
+	tflite: ModelFormatEntrySchema.optional(),
+	pt: ModelFormatEntrySchema.optional()
+});
+var ModelCatalogEntrySchema = object({
+	id: string(),
+	name: string(),
+	description: string(),
+	formats: ModelFormatsSchema,
+	inputSize: object({
+		width: number(),
+		height: number()
+	}),
+	labels: array(LabelDefinitionSchema).readonly(),
+	inputLayout: _enum(["nchw", "nhwc"]).optional(),
+	inputNormalization: _enum([
+		"zero-one",
+		"imagenet",
+		"none"
+	]).optional(),
+	preprocessMode: _enum(["letterbox", "resize"]).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):
+	* their embeddings are only discriminative on an aligned input. The face
+	* detector that produced the parent detail must emit 5 landmarks.
+	*/
+	faceAlignment: boolean().optional(),
+	/**
+	* Auxiliary files required at runtime (labels JSON, charset dict, etc.).
+	* Downloaded into the same modelsDir alongside the model file.
+	*/
+	extraFiles: array(ModelExtraFileSchema).readonly().optional()
+});
+var ConvertTargetSchema = discriminatedUnion("format", [object({
+	format: literal("openvino"),
+	precisions: array(_enum(["fp16", "int8"])).min(1).readonly()
+}), object({ format: literal("coreml") })]);
+var ModelConvertMetadataSchema = object({
+	id: string().regex(/^[a-zA-Z0-9._-]+$/),
+	name: string(),
+	labels: array(LabelDefinitionSchema).readonly(),
+	inputSize: object({
+		width: number(),
+		height: number()
+	}),
+	inputLayout: _enum(["nchw", "nhwc"]).optional(),
+	inputNormalization: _enum([
+		"zero-one",
+		"imagenet",
+		"none"
+	]).optional(),
+	preprocessMode: _enum(["letterbox", "resize"]).optional(),
+	outputFormat: _enum([
+		"yolo",
+		"ssd",
+		"embedding",
+		"classification",
+		"ocr",
+		"segmentation"
+	]),
+	faceAlignment: boolean().optional()
+});
+var ConvertResultSchema = object({
+	entry: ModelCatalogEntrySchema,
+	artifacts: array(object({
+		format: _enum(MODEL_FORMATS),
+		precision: _enum(["fp16", "int8"]).optional(),
+		sizeMB: number(),
+		validated: boolean(),
+		files: array(string()).readonly()
+	})).readonly()
+});
+/**
 * 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`.
@@ -12588,6 +12715,54 @@ var EnrichedWidgetMetadataSchema = WidgetMetadataSchema.extend({
 	bundleUrl: string()
 });
 method(_void(), array(EnrichedWidgetMetadataSchema).readonly());
+/**
+* `custom-model-registry` — collection cap exposing operator-registered
+* custom detection models. Each provider (today: `addon-model-studio`)
+* contributes a list of `CustomModelDescriptor`s; the hub auto-concatenates
+* them across providers (`concatCollection`).
+*
+* The detection-pipeline is *aware* of this cap: when at least one provider
+* exists it unions these descriptors into the per-step model picker and the
+* runtime model-resolution path, alongside the static catalog. When no
+* provider exists the consumer no-ops entirely (identical to the catalog-only
+* behaviour).
+*
+* A descriptor carries a full `ModelCatalogEntry` directly — the same shape
+* the static catalog uses — so the existing download/resolution code consumes
+* it unchanged. `stepId` is the detection step the model targets
+* (e.g. `'object-detection'`).
+*/
+var CustomModelDescriptorSchema = object({
+	stepId: string(),
+	entry: ModelCatalogEntrySchema
+});
+method(_void(), array(CustomModelDescriptorSchema).readonly());
+method(object({
+	nodeId: string(),
+	modelId: string(),
+	format: _enum(MODEL_FORMATS),
+	entry: ModelCatalogEntrySchema
+}), object({
+	ok: boolean(),
+	/** sha256 of the staged tarball (empty for a hub-local no-op). */
+	sha256: string(),
+	bytes: number(),
+	/** The target node's modelsDir the artifact landed in. */
+	path: string()
+}), {
+	kind: "mutation",
+	auth: "admin"
+});
+method(object({
+	sourceUrl: string(),
+	metadata: ModelConvertMetadataSchema,
+	targets: array(ConvertTargetSchema).min(1).readonly(),
+	calibrationRef: string().optional(),
+	sessionId: string().optional()
+}), ConvertResultSchema, {
+	kind: "mutation",
+	auth: "admin"
+});
 var AddonHttpRouteSchema = object({
 	method: _enum([
 		"GET",
@@ -17601,6 +17776,12 @@ Object.freeze({
 		addonId: null,
 		access: "create"
 	},
+	"customModelRegistry.listModels": {
+		capName: "custom-model-registry",
+		capScope: "system",
+		addonId: null,
+		access: "view"
+	},
 	"decoder.createSession": {
 		capName: "decoder",
 		capScope: "system",
@@ -18825,6 +19006,18 @@ Object.freeze({
 		addonId: null,
 		access: "view"
 	},
+	"modelConvert.convert": {
+		capName: "model-convert",
+		capScope: "system",
+		addonId: null,
+		access: "create"
+	},
+	"modelDistributor.distributeModel": {
+		capName: "model-distributor",
+		capScope: "system",
+		addonId: null,
+		access: "create"
+	},
 	"motion.isDetected": {
 		capName: "motion",
 		capScope: "device",

package/dist/{dist-BO4vHZS6.js → dist-BY1NQ5oi.js}

@@ -4649,7 +4649,7 @@ function _instanceof(cls, params = {}) {
 	return inst;
 }
 //#endregion
-//#region ../types/dist/sleep-B1dKJAMJ.mjs
+//#region ../types/dist/sleep-BV7rLc6Y.mjs
 var EventCategory = /* @__PURE__ */ function(EventCategory) {
 	EventCategory["SystemBoot"] = "system.boot";
 	EventCategory["SystemAddonsReady"] = "system.addons-ready";
@@ -5128,6 +5128,12 @@ var EventCategory = /* @__PURE__ */ function(EventCategory) {
 	* Payload: `{ deviceId, childDeviceIds, hiddenChildIds }`.
 	*/
 	EventCategory["AccessoriesChanged"] = "accessories.onAccessoriesChanged";
+	/**
+	* Progress update from a running model conversion job.
+	* Payload: `{ kind: 'model-convert', phase, sessionId?, pct?, detail? }`.
+	* Emitted by `addon-model-studio` on the converting node.
+	*/
+	EventCategory["ModelConvertProgress"] = "model-convert.progress";
 	return EventCategory;
 }({});
 Object.fromEntries([
@@ -6666,6 +6672,13 @@ object({
 		unreachable: number()
 	})
 });
+var LabelDefinitionSchema = object({
+	id: string(),
+	name: string(),
+	category: string().optional(),
+	description: string().optional(),
+	icon: string().optional()
+});
 var MODEL_FORMATS = [
 	"onnx",
 	"coreml",
@@ -6674,6 +6687,120 @@ var MODEL_FORMATS = [
 	"pt"
 ];
 /**
+* Multi-file format payload.
+*
+* - Directory formats (`isDirectory: true`, e.g. `.mlpackage`): files
+*   relative to the directory root — the downloader fetches each from
+*   `{url}/{file}` into `{modelDir}/{file}`. If omitted, it probes the
+*   HuggingFace API (slower).
+* - Single-file formats (no `isDirectory`, e.g. OpenVINO IR): sibling
+*   files fetched from the SAME remote directory as `url` and stored flat
+*   alongside the main file — e.g. `['camstack-yolov9t.bin']` for the IR
+*   weights next to `camstack-yolov9t.xml`.
+*/
+var ModelFormatEntrySchema = object({
+	url: string(),
+	sizeMB: number(),
+	/** Whether this format is a directory bundle (e.g., .mlpackage) rather than a single file */
+	isDirectory: boolean().optional(),
+	/** Multi-file payload (directory members or sibling files). */
+	files: array(string()).readonly().optional(),
+	/** Runtime(s) that can use this format. If omitted, inferred from ModelFormat key */
+	runtimes: array(_enum(["node", "python"])).readonly().optional()
+});
+/**
+* Extra file that must be downloaded alongside the model (e.g., labels JSON, dict.txt).
+* The downloader fetches from `url` and saves to `{modelsDir}/{filename}`.
+*/
+var ModelExtraFileSchema = object({
+	url: string(),
+	filename: string(),
+	sizeMB: number()
+});
+/**
+* Per-format payload map. Modelled as an explicit object (one optional key
+* per `ModelFormat`) rather than `z.record(enum, …)` — zod v4's enum-keyed
+* record requires every key, but a catalog entry only ships a subset of
+* formats.
+*/
+var ModelFormatsSchema = object({
+	onnx: ModelFormatEntrySchema.optional(),
+	coreml: ModelFormatEntrySchema.optional(),
+	openvino: ModelFormatEntrySchema.optional(),
+	tflite: ModelFormatEntrySchema.optional(),
+	pt: ModelFormatEntrySchema.optional()
+});
+var ModelCatalogEntrySchema = object({
+	id: string(),
+	name: string(),
+	description: string(),
+	formats: ModelFormatsSchema,
+	inputSize: object({
+		width: number(),
+		height: number()
+	}),
+	labels: array(LabelDefinitionSchema).readonly(),
+	inputLayout: _enum(["nchw", "nhwc"]).optional(),
+	inputNormalization: _enum([
+		"zero-one",
+		"imagenet",
+		"none"
+	]).optional(),
+	preprocessMode: _enum(["letterbox", "resize"]).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):
+	* their embeddings are only discriminative on an aligned input. The face
+	* detector that produced the parent detail must emit 5 landmarks.
+	*/
+	faceAlignment: boolean().optional(),
+	/**
+	* Auxiliary files required at runtime (labels JSON, charset dict, etc.).
+	* Downloaded into the same modelsDir alongside the model file.
+	*/
+	extraFiles: array(ModelExtraFileSchema).readonly().optional()
+});
+var ConvertTargetSchema = discriminatedUnion("format", [object({
+	format: literal("openvino"),
+	precisions: array(_enum(["fp16", "int8"])).min(1).readonly()
+}), object({ format: literal("coreml") })]);
+var ModelConvertMetadataSchema = object({
+	id: string().regex(/^[a-zA-Z0-9._-]+$/),
+	name: string(),
+	labels: array(LabelDefinitionSchema).readonly(),
+	inputSize: object({
+		width: number(),
+		height: number()
+	}),
+	inputLayout: _enum(["nchw", "nhwc"]).optional(),
+	inputNormalization: _enum([
+		"zero-one",
+		"imagenet",
+		"none"
+	]).optional(),
+	preprocessMode: _enum(["letterbox", "resize"]).optional(),
+	outputFormat: _enum([
+		"yolo",
+		"ssd",
+		"embedding",
+		"classification",
+		"ocr",
+		"segmentation"
+	]),
+	faceAlignment: boolean().optional()
+});
+var ConvertResultSchema = object({
+	entry: ModelCatalogEntrySchema,
+	artifacts: array(object({
+		format: _enum(MODEL_FORMATS),
+		precision: _enum(["fp16", "int8"]).optional(),
+		sizeMB: number(),
+		validated: boolean(),
+		files: array(string()).readonly()
+	})).readonly()
+});
+/**
 * 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`.
@@ -12610,6 +12737,54 @@ var EnrichedWidgetMetadataSchema = WidgetMetadataSchema.extend({
 	bundleUrl: string()
 });
 method(_void(), array(EnrichedWidgetMetadataSchema).readonly());
+/**
+* `custom-model-registry` — collection cap exposing operator-registered
+* custom detection models. Each provider (today: `addon-model-studio`)
+* contributes a list of `CustomModelDescriptor`s; the hub auto-concatenates
+* them across providers (`concatCollection`).
+*
+* The detection-pipeline is *aware* of this cap: when at least one provider
+* exists it unions these descriptors into the per-step model picker and the
+* runtime model-resolution path, alongside the static catalog. When no
+* provider exists the consumer no-ops entirely (identical to the catalog-only
+* behaviour).
+*
+* A descriptor carries a full `ModelCatalogEntry` directly — the same shape
+* the static catalog uses — so the existing download/resolution code consumes
+* it unchanged. `stepId` is the detection step the model targets
+* (e.g. `'object-detection'`).
+*/
+var CustomModelDescriptorSchema = object({
+	stepId: string(),
+	entry: ModelCatalogEntrySchema
+});
+method(_void(), array(CustomModelDescriptorSchema).readonly());
+method(object({
+	nodeId: string(),
+	modelId: string(),
+	format: _enum(MODEL_FORMATS),
+	entry: ModelCatalogEntrySchema
+}), object({
+	ok: boolean(),
+	/** sha256 of the staged tarball (empty for a hub-local no-op). */
+	sha256: string(),
+	bytes: number(),
+	/** The target node's modelsDir the artifact landed in. */
+	path: string()
+}), {
+	kind: "mutation",
+	auth: "admin"
+});
+method(object({
+	sourceUrl: string(),
+	metadata: ModelConvertMetadataSchema,
+	targets: array(ConvertTargetSchema).min(1).readonly(),
+	calibrationRef: string().optional(),
+	sessionId: string().optional()
+}), ConvertResultSchema, {
+	kind: "mutation",
+	auth: "admin"
+});
 var AddonHttpRouteSchema = object({
 	method: _enum([
 		"GET",
@@ -17623,6 +17798,12 @@ Object.freeze({
 		addonId: null,
 		access: "create"
 	},
+	"customModelRegistry.listModels": {
+		capName: "custom-model-registry",
+		capScope: "system",
+		addonId: null,
+		access: "view"
+	},
 	"decoder.createSession": {
 		capName: "decoder",
 		capScope: "system",
@@ -18847,6 +19028,18 @@ Object.freeze({
 		addonId: null,
 		access: "view"
 	},
+	"modelConvert.convert": {
+		capName: "model-convert",
+		capScope: "system",
+		addonId: null,
+		access: "create"
+	},
+	"modelDistributor.distributeModel": {
+		capName: "model-distributor",
+		capScope: "system",
+		addonId: null,
+		access: "create"
+	},
 	"motion.isDetected": {
 		capName: "motion",
 		capScope: "device",

package/dist/embedding-encoder/index.js

@@ -2,7 +2,7 @@ Object.defineProperties(exports, {
 	__esModule: { value: true },
 	[Symbol.toStringTag]: { value: "Module" }
 });
-const require_dist = require("../dist-BO4vHZS6.js");
+const require_dist = require("../dist-BY1NQ5oi.js");
 let node_path = require("node:path");
 let node_path$1 = require_dist.__toESM(node_path, 1);
 node_path = require_dist.__toESM(node_path);
@@ -11,7 +11,25 @@ let node_fs$1 = require_dist.__toESM(node_fs, 1);
 node_fs = require_dist.__toESM(node_fs);
 require("node:crypto");
 let node_child_process = require("node:child_process");
-//#region ../system/dist/model-download-service-RxAOiYvX.mjs
+//#region ../system/dist/model-download-service-C-IHWnXx.mjs
+function isNonEmptyFile(filePath) {
+	return node_fs$1.existsSync(filePath) && node_fs$1.statSync(filePath).size > 0;
+}
+/**
+* Sibling files of a single-file (non-directory) format — extra files the
+* format needs, fetched from the same remote directory as `url` and stored
+* flat alongside the main file in `modelsDir`. Catalog-declared via
+* `formatEntry.files`, e.g. OpenVINO IR lists its `.bin` weights next to the
+* `.xml`. The downloader stays format-agnostic; the convention lives in the
+* catalog data (like `MLPACKAGE_FILES` for the directory case).
+*/
+function siblingFilesFor(formatEntry) {
+	return formatEntry.isDirectory ? [] : formatEntry.files ?? [];
+}
+/** Resolve a sibling's remote URL relative to the main file's directory. */
+function siblingUrl(mainUrl, sibling) {
+	return mainUrl.replace(/[^/]+$/, sibling);
+}
 /** Build fetch headers, including HF auth token for huggingface.co URLs */
 function buildHeaders(url) {
 	const headers = { "User-Agent": "CamStack/1.0" };
@@ -107,15 +125,21 @@ var ModelDownloadService = class {
 		if (!formatEntry) throw new Error(`ModelDownloadService: model "${modelId}" has no ${selectedFormat} format`);
 		await this.ensureExtraFiles(modelId);
 		const modelPath = this.modelFilePath(entry, selectedFormat);
-		if (node_fs$1.existsSync(modelPath)) if (formatEntry.isDirectory) if (!node_fs$1.existsSync(node_path$1.join(modelPath, "Manifest.json"))) node_fs$1.rmSync(modelPath, {
-			recursive: true,
-			force: true
-		});
-		else return modelPath;
-		else return modelPath;
+		const siblings = siblingFilesFor(formatEntry);
+		if (node_fs$1.existsSync(modelPath)) {
+			if (formatEntry.isDirectory) if (!node_fs$1.existsSync(node_path$1.join(modelPath, "Manifest.json"))) node_fs$1.rmSync(modelPath, {
+				recursive: true,
+				force: true
+			});
+			else return modelPath;
+			else if (siblings.every((f) => isNonEmptyFile(node_path$1.join(this.modelsDir, f)))) return modelPath;
+		}
 		node_fs$1.mkdirSync(this.modelsDir, { recursive: true });
 		if (formatEntry.isDirectory) await this.downloadDirectory(formatEntry.url, modelPath, formatEntry.files, modelId);
-		else await downloadFile(formatEntry.url, modelPath, this.onProgress ? (downloaded, total) => this.onProgress(modelId, downloaded, total) : void 0);
+		else {
+			await downloadFile(formatEntry.url, modelPath, this.onProgress ? (downloaded, total) => this.onProgress(modelId, downloaded, total) : void 0);
+			for (const sibling of siblings) await downloadFile(siblingUrl(formatEntry.url, sibling), node_path$1.join(this.modelsDir, sibling));
+		}
 		return modelPath;
 	}
 	/**
@@ -149,7 +173,8 @@ var ModelDownloadService = class {
 		const modelPath = this.modelFilePath(entry, selectedFormat);
 		if (!node_fs$1.existsSync(modelPath)) return false;
 		if (formatEntry.isDirectory) return node_fs$1.existsSync(node_path$1.join(modelPath, "Manifest.json"));
-		return node_fs$1.statSync(modelPath).size > 0;
+		if (node_fs$1.statSync(modelPath).size <= 0) return false;
+		return siblingFilesFor(formatEntry).every((f) => isNonEmptyFile(node_path$1.join(this.modelsDir, f)));
 	}
 	/** Get the catalog entry for a model by ID. */
 	getEntry(modelId) {

package/dist/embedding-encoder/index.mjs

@@ -1,4 +1,4 @@
-import { d as BaseAddon, i as embeddingEncoderCapability } from "../dist-xZ1nMZGV.mjs";
+import { d as BaseAddon, i as embeddingEncoderCapability } from "../dist-BUE-vLMt.mjs";
 import { createRequire } from "node:module";
 import * as path$1 from "node:path";
 import * as fs from "node:fs";
@@ -6,7 +6,25 @@ import { spawn } from "node:child_process";
 //#region \0rolldown/runtime.js
 var __require = /* @__PURE__ */ createRequire(import.meta.url);
 //#endregion
-//#region ../system/dist/model-download-service-RxAOiYvX.mjs
+//#region ../system/dist/model-download-service-C-IHWnXx.mjs
+function isNonEmptyFile(filePath) {
+	return fs.existsSync(filePath) && fs.statSync(filePath).size > 0;
+}
+/**
+* Sibling files of a single-file (non-directory) format — extra files the
+* format needs, fetched from the same remote directory as `url` and stored
+* flat alongside the main file in `modelsDir`. Catalog-declared via
+* `formatEntry.files`, e.g. OpenVINO IR lists its `.bin` weights next to the
+* `.xml`. The downloader stays format-agnostic; the convention lives in the
+* catalog data (like `MLPACKAGE_FILES` for the directory case).
+*/
+function siblingFilesFor(formatEntry) {
+	return formatEntry.isDirectory ? [] : formatEntry.files ?? [];
+}
+/** Resolve a sibling's remote URL relative to the main file's directory. */
+function siblingUrl(mainUrl, sibling) {
+	return mainUrl.replace(/[^/]+$/, sibling);
+}
 /** Build fetch headers, including HF auth token for huggingface.co URLs */
 function buildHeaders(url) {
 	const headers = { "User-Agent": "CamStack/1.0" };
@@ -102,15 +120,21 @@ var ModelDownloadService = class {
 		if (!formatEntry) throw new Error(`ModelDownloadService: model "${modelId}" has no ${selectedFormat} format`);
 		await this.ensureExtraFiles(modelId);
 		const modelPath = this.modelFilePath(entry, selectedFormat);
-		if (fs.existsSync(modelPath)) if (formatEntry.isDirectory) if (!fs.existsSync(path$1.join(modelPath, "Manifest.json"))) fs.rmSync(modelPath, {
-			recursive: true,
-			force: true
-		});
-		else return modelPath;
-		else return modelPath;
+		const siblings = siblingFilesFor(formatEntry);
+		if (fs.existsSync(modelPath)) {
+			if (formatEntry.isDirectory) if (!fs.existsSync(path$1.join(modelPath, "Manifest.json"))) fs.rmSync(modelPath, {
+				recursive: true,
+				force: true
+			});
+			else return modelPath;
+			else if (siblings.every((f) => isNonEmptyFile(path$1.join(this.modelsDir, f)))) return modelPath;
+		}
 		fs.mkdirSync(this.modelsDir, { recursive: true });
 		if (formatEntry.isDirectory) await this.downloadDirectory(formatEntry.url, modelPath, formatEntry.files, modelId);
-		else await downloadFile(formatEntry.url, modelPath, this.onProgress ? (downloaded, total) => this.onProgress(modelId, downloaded, total) : void 0);
+		else {
+			await downloadFile(formatEntry.url, modelPath, this.onProgress ? (downloaded, total) => this.onProgress(modelId, downloaded, total) : void 0);
+			for (const sibling of siblings) await downloadFile(siblingUrl(formatEntry.url, sibling), path$1.join(this.modelsDir, sibling));
+		}
 		return modelPath;
 	}
 	/**
@@ -144,7 +168,8 @@ var ModelDownloadService = class {
 		const modelPath = this.modelFilePath(entry, selectedFormat);
 		if (!fs.existsSync(modelPath)) return false;
 		if (formatEntry.isDirectory) return fs.existsSync(path$1.join(modelPath, "Manifest.json"));
-		return fs.statSync(modelPath).size > 0;
+		if (fs.statSync(modelPath).size <= 0) return false;
+		return siblingFilesFor(formatEntry).every((f) => isNonEmptyFile(path$1.join(this.modelsDir, f)));
 	}
 	/** Get the catalog entry for a model by ID. */
 	getEntry(modelId) {

package/dist/enrichment-engine/index.js

@@ -2,8 +2,8 @@ Object.defineProperties(exports, {
 	__esModule: { value: true },
 	[Symbol.toStringTag]: { value: "Module" }
 });
-const require_dist = require("../dist-BO4vHZS6.js");
-const require_resolve_frame = require("../resolve-frame-A6QovqGd.js");
+const require_dist = require("../dist-BY1NQ5oi.js");
+const require_resolve_frame = require("../resolve-frame-B2Do-e7z.js");
 let _camstack_shm_ring = require("@camstack/shm-ring");
 //#region src/enrichment-engine/types.ts
 var DEFAULT_ENRICHMENT_CONFIG = {
@@ -38,6 +38,9 @@ var DEFAULT_ENRICHMENT_CONFIG = {
 };
 //#endregion
 //#region src/enrichment-engine/workers/embedding-dispatcher.ts
+function selectCropBbox(detection) {
+	return detection.refinedBbox ?? detection.bbox;
+}
 var EmbeddingDispatcher = class {
 	config;
 	encoders;
@@ -155,7 +158,7 @@ var EmbeddingDispatcher = class {
 				frameData,
 				frameWidth,
 				frameHeight,
-				bbox: detection.bbox,
+				bbox: selectCropBbox(detection),
 				receivedAt: now
 			};
 			switch (this.config.cropStrategy) {

package/dist/enrichment-engine/index.mjs

@@ -1,4 +1,4 @@
-import { C as tuple, S as string, _ as _enum, b as number, d as BaseAddon, h as createEvent, m as asJsonObject, p as EventCategory, v as array, x as object, y as boolean } from "../dist-xZ1nMZGV.mjs";
+import { C as tuple, S as string, _ as _enum, b as number, d as BaseAddon, h as createEvent, m as asJsonObject, p as EventCategory, v as array, x as object, y as boolean } from "../dist-BUE-vLMt.mjs";
 import { n as extractCrop, t as resolveFrame } from "../resolve-frame-CT1T1tWy.mjs";
 import { FrameRingReaderCache } from "@camstack/shm-ring";
 //#region src/enrichment-engine/types.ts
@@ -34,6 +34,9 @@ var DEFAULT_ENRICHMENT_CONFIG = {
 };
 //#endregion
 //#region src/enrichment-engine/workers/embedding-dispatcher.ts
+function selectCropBbox(detection) {
+	return detection.refinedBbox ?? detection.bbox;
+}
 var EmbeddingDispatcher = class {
 	config;
 	encoders;
@@ -151,7 +154,7 @@ var EmbeddingDispatcher = class {
 				frameData,
 				frameWidth,
 				frameHeight,
-				bbox: detection.bbox,
+				bbox: selectCropBbox(detection),
 				receivedAt: now
 			};
 			switch (this.config.cropStrategy) {

package/dist/pipeline-analytics/{_virtual_mf-localSharedImportMap___mfe_internal__addon_pipeline_analytics_widgets-DnW0j4y0.mjs → _virtual_mf-localSharedImportMap___mfe_internal__addon_pipeline_analytics_widgets-BidjVASi.mjs}

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

package/dist/pipeline-analytics/{hostInit-DW4vPMgj.mjs → hostInit-CzvzETbd.mjs}

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

package/dist/pipeline-analytics/index.js

@@ -2,8 +2,8 @@ Object.defineProperties(exports, {
 	__esModule: { value: true },
 	[Symbol.toStringTag]: { value: "Module" }
 });
-const require_dist = require("../dist-BO4vHZS6.js");
-const require_resolve_frame = require("../resolve-frame-A6QovqGd.js");
+const require_dist = require("../dist-BY1NQ5oi.js");
+const require_resolve_frame = require("../resolve-frame-B2Do-e7z.js");
 let _camstack_shm_ring = require("@camstack/shm-ring");
 let sharp = require("sharp");
 sharp = require_dist.__toESM(sharp);
@@ -1284,6 +1284,7 @@ var FrameProcessor = class {
 		const firstLevelBboxById = /* @__PURE__ */ new Map();
 		const faceBboxByBbox = /* @__PURE__ */ new Map();
 		const plateByBbox = /* @__PURE__ */ new Map();
+		const maskByBbox = /* @__PURE__ */ new Map();
 		const flatDetections = frame.detections.filter((d) => d.kind === "first-level").map((det) => {
 			const bbox = {
 				x: det.bbox.x,
@@ -1302,6 +1303,11 @@ var FrameProcessor = class {
 				embedding: det.embedding,
 				...det.embeddingModelId !== void 0 ? { embeddingModelId: det.embeddingModelId } : {}
 			});
+			if (det.mask !== void 0 && det.maskWidth !== void 0 && det.maskHeight !== void 0) maskByBbox.set(bbox, {
+				mask: Uint8Array.from(Buffer.from(det.mask, "base64")),
+				width: det.maskWidth,
+				height: det.maskHeight
+			});
 			firstLevelBboxById.set(det.id, bbox);
 			return {
 				...bbox,
@@ -1344,8 +1350,9 @@ var FrameProcessor = class {
 		const rawEvents = this.eventEmitter.emit(trackedDetections, objectStates, [], [], String(this.deviceId));
 		const zonesByTrack = /* @__PURE__ */ new Map();
 		for (const td of trackedDetections) {
-			const memberships = this.zoneEngine.annotateDetection(td.bbox, this.zones, frameWidth, frameHeight);
-			zonesByTrack.set(td.trackId, memberships.map((m) => m.zoneId));
+			const m = maskByBbox.get(td.bbox);
+			const memberships = this.zoneEngine.annotateDetection(td.bbox, this.zones, frameWidth, frameHeight, m?.mask, m?.width, m?.height);
+			zonesByTrack.set(td.trackId, memberships.map((m2) => m2.zoneId));
 		}
 		const tracked = trackedDetections.map((td) => {
 			const state = mapObjectStateToTrackState(objectStates.find((o) => o.trackId === td.trackId)?.state);

package/dist/pipeline-analytics/index.mjs

@@ -1,4 +1,4 @@
-import { a as faceGalleryCapability, b as number, c as videoclipsCapability, d as BaseAddon, f as DeviceType, g as hydrateSchema, l as zoneAnalyticsCapability, n as audioMetricsCapability, o as pipelineAnalyticsCapability, p as EventCategory, r as cosineSimilarity, s as plateGalleryCapability, t as addonWidgetsSourceCapability, u as errMsg, x as object, y as boolean } from "../dist-xZ1nMZGV.mjs";
+import { a as faceGalleryCapability, b as number, c as videoclipsCapability, d as BaseAddon, f as DeviceType, g as hydrateSchema, l as zoneAnalyticsCapability, n as audioMetricsCapability, o as pipelineAnalyticsCapability, p as EventCategory, r as cosineSimilarity, s as plateGalleryCapability, t as addonWidgetsSourceCapability, u as errMsg, x as object, y as boolean } from "../dist-BUE-vLMt.mjs";
 import { n as extractCrop, t as resolveFrame } from "../resolve-frame-CT1T1tWy.mjs";
 import { FrameRingReaderCache } from "@camstack/shm-ring";
 import sharp from "sharp";
@@ -1279,6 +1279,7 @@ var FrameProcessor = class {
 		const firstLevelBboxById = /* @__PURE__ */ new Map();
 		const faceBboxByBbox = /* @__PURE__ */ new Map();
 		const plateByBbox = /* @__PURE__ */ new Map();
+		const maskByBbox = /* @__PURE__ */ new Map();
 		const flatDetections = frame.detections.filter((d) => d.kind === "first-level").map((det) => {
 			const bbox = {
 				x: det.bbox.x,
@@ -1297,6 +1298,11 @@ var FrameProcessor = class {
 				embedding: det.embedding,
 				...det.embeddingModelId !== void 0 ? { embeddingModelId: det.embeddingModelId } : {}
 			});
+			if (det.mask !== void 0 && det.maskWidth !== void 0 && det.maskHeight !== void 0) maskByBbox.set(bbox, {
+				mask: Uint8Array.from(Buffer.from(det.mask, "base64")),
+				width: det.maskWidth,
+				height: det.maskHeight
+			});
 			firstLevelBboxById.set(det.id, bbox);
 			return {
 				...bbox,
@@ -1339,8 +1345,9 @@ var FrameProcessor = class {
 		const rawEvents = this.eventEmitter.emit(trackedDetections, objectStates, [], [], String(this.deviceId));
 		const zonesByTrack = /* @__PURE__ */ new Map();
 		for (const td of trackedDetections) {
-			const memberships = this.zoneEngine.annotateDetection(td.bbox, this.zones, frameWidth, frameHeight);
-			zonesByTrack.set(td.trackId, memberships.map((m) => m.zoneId));
+			const m = maskByBbox.get(td.bbox);
+			const memberships = this.zoneEngine.annotateDetection(td.bbox, this.zones, frameWidth, frameHeight, m?.mask, m?.width, m?.height);
+			zonesByTrack.set(td.trackId, memberships.map((m2) => m2.zoneId));
 		}
 		const tracked = trackedDetections.map((td) => {
 			const state = mapObjectStateToTrackState(objectStates.find((o) => o.trackId === td.trackId)?.state);

package/dist/pipeline-analytics/remoteEntry.js

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

package/dist/{resolve-frame-A6QovqGd.js → resolve-frame-B2Do-e7z.js}

@@ -1,4 +1,4 @@
-const require_dist = require("./dist-BO4vHZS6.js");
+const require_dist = require("./dist-BY1NQ5oi.js");
 let sharp = require("sharp");
 sharp = require_dist.__toESM(sharp);
 //#region src/shared/frame/crop-extractor.ts

package/package.json

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