@camstack/addon-pipeline 1.1.0 → 1.1.1

package/dist/detection-pipeline/index.mjs

@@ -1,6 +1,6 @@
 import { t as __require } from "../chunk-BdkLduGY.mjs";
-import { A as nodePin, B as BaseAddon, C as detectionPipelineCapability, J as hydrateSchema, L as supportedRuntimes$1, P as runtimeDevices$1, T as hfModelUrl, W as EventCategory, Z as parseJsonUnknown, a as COCO_TO_MACRO, et as sleep, i as COCO_80_LABELS, j as pipelineExecutorCapability, p as YAMNET_TO_MACRO, q as createEvent, r as AUDIO_MACRO_LABELS, t as APPLE_SA_TO_MACRO, w as evaluateZoneRules, x as defaultDeviceFor$1, z as errMsg } from "../dist-BA6DR_jV.mjs";
-import { a as isModelDownloaded, i as ensureModel, n as deleteModelFromDisk } from "../model-download-service-RxAOiYvX-CMAvhgO7.mjs";
+import { A as nodePin, B as BaseAddon, C as detectionPipelineCapability, J as hydrateSchema, L as supportedRuntimes$1, P as runtimeDevices$1, T as hfModelUrl, W as EventCategory, Z as parseJsonUnknown, a as COCO_TO_MACRO, et as sleep, i as COCO_80_LABELS, j as pipelineExecutorCapability, p as YAMNET_TO_MACRO, q as createEvent, r as AUDIO_MACRO_LABELS, t as APPLE_SA_TO_MACRO, w as evaluateZoneRules, x as defaultDeviceFor$1, z as errMsg } from "../dist-BWc-HYQz.mjs";
+import { a as isModelDownloaded, i as ensureModel, n as deleteModelFromDisk } from "../model-download-service-C-IHWnXx-3Mmeob3l.mjs";
 import * as fs from "node:fs";
 import * as path$1 from "node:path";
 import * as os from "node:os";
@@ -1036,6 +1036,26 @@ var ovFormat = (url, sizeMB) => {
 		...files ? { files } : {}
 	};
 };
+/**
+* Build a precision-variant catalog entry (OpenVINO-only) derived from a base
+* detection model. fp16 halves the weights (Intel iGPU/NPU sweet spot); int8 is
+* NNCF post-training-quantized (~4× smaller, fastest on CPU/iGPU at a small
+* accuracy cost). The IRs live next to the base `.xml` on HF as
+* `camstack-<id>-<precision>.xml`. Lets an operator scale the model to the node
+* (e.g. yolo26x-int8 on a 265K, yolo26n-int8 on an N100).
+*/
+var ovPrecisionVariant = (baseId, ovDir, baseName, precision, sizeMB) => ({
+	id: `${baseId}-${precision}`,
+	name: `${baseName} (${precision.toUpperCase()})`,
+	description: `${baseName} — OpenVINO ${precision.toUpperCase()} variant for Intel iGPU/NPU; scale by hardware`,
+	inputSize: {
+		width: 640,
+		height: 640
+	},
+	labels: [],
+	preprocessMode: "letterbox",
+	formats: { openvino: ovFormat(hf(`${ovDir}/camstack-${baseId}-${precision}.xml`), sizeMB) }
+});
 var MLPACKAGE_FILES = [
 	"Manifest.json",
 	"Data/com.apple.CoreML/model.mlmodel",
@@ -1341,7 +1361,21 @@ var OBJECT_DETECTION_MODELS = [
 			},
 			openvino: ovFormat(hf("objectDetection/scrypted-yolov9-relu/openvino/scrypted_yolov9m_relu.xml"), 38)
 		}
-	}
+	},
+	ovPrecisionVariant("yolov9t", "objectDetection/yolov9/openvino", "YOLOv9 Tiny", "fp16", 5),
+	ovPrecisionVariant("yolov9t", "objectDetection/yolov9/openvino", "YOLOv9 Tiny", "int8", 3),
+	ovPrecisionVariant("yolov9s", "objectDetection/yolov9/openvino", "YOLOv9 Small", "fp16", 15),
+	ovPrecisionVariant("yolov9s", "objectDetection/yolov9/openvino", "YOLOv9 Small", "int8", 8),
+	ovPrecisionVariant("yolo26n", "objectDetection/yolo26/openvino", "YOLO26 Nano", "fp16", 5),
+	ovPrecisionVariant("yolo26n", "objectDetection/yolo26/openvino", "YOLO26 Nano", "int8", 3),
+	ovPrecisionVariant("yolo26s", "objectDetection/yolo26/openvino", "YOLO26 Small", "fp16", 19),
+	ovPrecisionVariant("yolo26s", "objectDetection/yolo26/openvino", "YOLO26 Small", "int8", 10),
+	ovPrecisionVariant("yolo26m", "objectDetection/yolo26/openvino", "YOLO26 Medium", "fp16", 41),
+	ovPrecisionVariant("yolo26m", "objectDetection/yolo26/openvino", "YOLO26 Medium", "int8", 21),
+	ovPrecisionVariant("yolo26l", "objectDetection/yolo26/openvino", "YOLO26 Large", "fp16", 50),
+	ovPrecisionVariant("yolo26l", "objectDetection/yolo26/openvino", "YOLO26 Large", "int8", 25),
+	ovPrecisionVariant("yolo26x", "objectDetection/yolo26/openvino", "YOLO26 XLarge", "fp16", 112),
+	ovPrecisionVariant("yolo26x", "objectDetection/yolo26/openvino", "YOLO26 XLarge", "int8", 56)
 ];
 var FACE_DETECTION_MODELS = [{
 	id: "scrfd-2.5g",
@@ -1788,7 +1822,7 @@ var ObjectDetectionStep = class {
 			"animal"
 		],
 		models: [...OBJECT_DETECTION_MODELS],
-		defaultModelId: "yolov9s",
+		defaultModelId: "yolo26n",
 		defaultConfidence: .5,
 		labels: COCO_80_LABELS.map((l) => l.id),
 		classMap: COCO_TO_MACRO
@@ -2037,9 +2071,9 @@ var STEP_VEHICLE_CLASSIFIER = new ClassifierWithMinConfidence({
 	enabledByDefault: false,
 	defaultConfidence: .3
 });
-var STEP_SEGMENTATION_REFINER = new PipelineStepBase({
-	id: "segmentation-refiner",
-	name: "Saliency Segmentation",
+var STEP_SEGMENTATION = new PipelineStepBase({
+	id: "segmentation",
+	name: "Segmentation",
 	slot: "refiner",
 	postprocessor: "saliency",
 	extractMode: "crop-roi",
@@ -2051,7 +2085,7 @@ var STEP_SEGMENTATION_REFINER = new PipelineStepBase({
 	defaultConfidence: 0,
 	group: "Segmentation"
 });
-var STEP_INSTANCE_SEGMENTATION = new PipelineStepBase({
+new PipelineStepBase({
 	id: "instance-segmentation",
 	name: "Instance Segmentation",
 	slot: "refiner",
@@ -2078,8 +2112,7 @@ var ALL_PIPELINE_STEPS = [
 	new AnimalClassifierStep(),
 	STEP_BIRD_CLASSIFIER,
 	STEP_VEHICLE_CLASSIFIER,
-	STEP_SEGMENTATION_REFINER,
-	STEP_INSTANCE_SEGMENTATION,
+	STEP_SEGMENTATION,
 	STEP_AUDIO_CLASSIFIER_INSTANCE
 ];
 /** Compat: flat array of StepDefinition for existing consumers */
@@ -3250,6 +3283,18 @@ function applyChildOutput(parent, childStep, output, stepLatencyMs, ctx) {
 			parent.mask = output.mask;
 			parent.maskWidth = output.maskWidth;
 			parent.maskHeight = output.maskHeight;
+			if (output.maskBbox !== void 0 && output.maskWidth > 0 && output.maskHeight > 0) {
+				const [px1, py1, px2, py2] = parent.bbox;
+				const parentW = px2 - px1;
+				const parentH = py2 - py1;
+				const [mbx, mby, mbw, mbh] = output.maskBbox;
+				parent.refinedBbox = [
+					px1 + mbx / output.maskWidth * parentW,
+					py1 + mby / output.maskHeight * parentH,
+					px1 + (mbx + mbw) / output.maskWidth * parentW,
+					py1 + (mby + mbh) / output.maskHeight * parentH
+				];
+			}
 			break;
 	}
 }
@@ -3300,6 +3345,12 @@ function buildFrameResult(input) {
 			macroClass: m.macroClass,
 			score: m.score,
 			bbox,
+			...m.refinedBbox !== void 0 ? { refinedBbox: bboxTupleToRect(m.refinedBbox) } : {},
+			...m.mask !== void 0 && m.maskWidth !== void 0 && m.maskHeight !== void 0 ? {
+				mask: m.mask,
+				maskWidth: m.maskWidth,
+				maskHeight: m.maskHeight
+			} : {},
 			labels,
 			...m.parentId !== void 0 ? { parentId: m.parentId } : {},
 			...embedding !== void 0 ? {
@@ -3790,6 +3841,40 @@ function walkFieldsForDefaults(fields, out) {
 	}
 }
 //#endregion
+//#region src/detection-pipeline/registry/custom-models.ts
+/**
+* Group a flat list of custom-model descriptors (as returned by the
+* `custom-model-registry` collection cap) into a `stepId → entries` map for
+* the picker / resolution union. Pure; order within a step preserved.
+*/
+function groupCustomModelsByStep(descriptors) {
+	const byStep = /* @__PURE__ */ new Map();
+	for (const d of descriptors) {
+		const arr = byStep.get(d.stepId) ?? [];
+		arr.push(d.entry);
+		byStep.set(d.stepId, arr);
+	}
+	return byStep;
+}
+/**
+* Union a step's static catalog models with operator-registered custom
+* models. On an `id` collision the static catalog entry wins — a custom
+* model can never shadow a built-in one.
+*
+* Pure + side-effect-free so it can be unit-tested in isolation and called
+* from the (free) `buildSchemaSlots` builder without any addon context.
+*/
+function mergeCustomModels(staticModels, customModels) {
+	const seen = new Set(staticModels.map((m) => m.id));
+	const merged = [...staticModels];
+	for (const m of customModels) {
+		if (seen.has(m.id)) continue;
+		seen.add(m.id);
+		merged.push(m);
+	}
+	return merged;
+}
+//#endregion
 //#region src/detection-pipeline/provider.ts
 /**
 * DetectionPipelineProvider — implements IPipelineExecutorProvider.
@@ -4025,6 +4110,13 @@ var DetectionPipelineProvider = class DetectionPipelineProvider {
 	/** Addon context — ctx.api resolves lazily (direct caller created after boot) */
 	addonCtx = null;
 	/**
+	* Short-lived cache of custom models pulled from the `custom-model-registry`
+	* collection cap, grouped by step id. TTL-bounded so the picker / resolution
+	* paths don't issue a cap round-trip on every call. Empty map = no provider
+	* (or a query failure) → behaviour identical to the static-catalog-only path.
+	*/
+	customModelsCache = null;
+	/**
 	* Per-device {@link DeviceProxy} cache used for zone gating at the
 	* runtime path. Reads `state.zones.value` + `state.zoneRules.value`
 	* synchronously per frame so detections inside an `exclude` zone
@@ -4353,8 +4445,20 @@ var DetectionPipelineProvider = class DetectionPipelineProvider {
 	* runtime through installing → verifying → ready.
 	*/
 	async onEngineSelectionChanged() {
+		const prev = this.currentEngine;
 		const stored = await this.loadEngine();
 		if (stored) this.currentEngine = stored;
+		if ((prev.runtime !== this.currentEngine.runtime || prev.backend !== this.currentEngine.backend || prev.format !== this.currentEngine.format || (prev.device ?? "") !== (this.currentEngine.device ?? "")) && this.engineFactory) {
+			this.log.info("engine selection changed — rebuilding pool in place", { meta: {
+				from: `${prev.backend}/${prev.device ?? "default"}`,
+				to: `${this.currentEngine.backend}/${this.currentEngine.device ?? "default"}`
+			} });
+			try {
+				await this.engineFactory.dispose();
+			} catch {}
+			this.engineFactory = null;
+			this.executor = null;
+		}
 		this.startProvisioningForCurrentEngine();
 	}
 	/**
@@ -4392,7 +4496,7 @@ var DetectionPipelineProvider = class DetectionPipelineProvider {
 		if (!steps || steps.length === 0) return;
 		for (const step of flattenSteps(steps)) {
 			if (!step.enabled) continue;
-			const modelEntry = getStepDefinition(step.addonId).models.find((m) => m.id === step.modelId);
+			const modelEntry = await this.resolveModelEntry(step.addonId, step.modelId);
 			if (!modelEntry) continue;
 			if (isModelDownloaded(this.modelsDir, modelEntry, format)) continue;
 			await this.downloadWithRetry(modelEntry, format, 3);
@@ -4470,10 +4574,44 @@ var DetectionPipelineProvider = class DetectionPipelineProvider {
 			return { hardware: null };
 		}
 	}
+	/**
+	* Pull custom models from the `custom-model-registry` collection cap,
+	* grouped by step id. 5s TTL cache. Fully graceful: when no provider is
+	* registered (or the query fails) it returns an empty map and logs at most
+	* a warning — callers then behave exactly like the static-catalog path.
+	*/
+	async getCustomModels() {
+		const now = Date.now();
+		if (this.customModelsCache && now - this.customModelsCache.at < 5e3) return this.customModelsCache.byStep;
+		let byStep = /* @__PURE__ */ new Map();
+		try {
+			const api = this.addonCtx?.api;
+			if (api) {
+				if ((await api.addons.listCapabilityProviders.query({ capName: "custom-model-registry" })).some((p) => p.isActive)) byStep = groupCustomModelsByStep(await api.customModelRegistry.listModels.query());
+			}
+		} catch (err) {
+			this.log.warn("custom-model-registry query failed — using static catalog only", { meta: { error: errMsg(err) } });
+		}
+		this.customModelsCache = {
+			at: now,
+			byStep
+		};
+		return byStep;
+	}
+	/**
+	* Resolve a model id within a step to a catalog entry — static catalog
+	* first, then the custom registry. Returns undefined if neither has it.
+	*/
+	async resolveModelEntry(addonId, modelId) {
+		const fromCatalog = getStepDefinition(addonId).models.find((m) => m.id === modelId);
+		if (fromCatalog) return fromCatalog;
+		return (await this.getCustomModels()).get(addonId)?.find((m) => m.id === modelId);
+	}
 	async getSchema(engine) {
 		if (!engine || !engine.runtime) engine = await this.getSelectedEngine();
 		const format = engine.format;
-		const slots = buildSchemaSlots(format, this.modelsDir);
+		const customByStep = await this.getCustomModels();
+		const slots = buildSchemaSlots(format, this.modelsDir, customByStep);
 		const { hardware } = await this.fetchProbeGatingData();
 		const env = runtimeEnvFromProcess(toProbedHardware(hardware));
 		return {
@@ -4660,7 +4798,7 @@ var DetectionPipelineProvider = class DetectionPipelineProvider {
 	}
 	async downloadModel(input) {
 		const { modelId, format, addonId } = input;
-		const modelEntry = getStepDefinition(addonId).models.find((m) => m.id === modelId);
+		const modelEntry = await this.resolveModelEntry(addonId, modelId);
 		if (!modelEntry) throw new Error(`Model "${modelId}" not found in step "${addonId}" catalog`);
 		const formatEntry = modelEntry.formats[format];
 		if (!formatEntry) throw new Error(`Model "${modelId}" has no ${format} format. Available: ${Object.keys(modelEntry.formats).join(", ")}`);
@@ -4723,7 +4861,7 @@ var DetectionPipelineProvider = class DetectionPipelineProvider {
 	}
 	async deleteModel(input) {
 		const { modelId, format, addonId } = input;
-		const modelEntry = getStepDefinition(addonId).models.find((m) => m.id === modelId);
+		const modelEntry = await this.resolveModelEntry(addonId, modelId);
 		if (!modelEntry) throw new Error(`Model "${modelId}" not found in step "${addonId}" catalog`);
 		if (!deleteModelFromDisk(this.modelsDir, modelEntry, format)) throw new Error(`Model "${modelId}" (${format}) is not downloaded — nothing to delete`);
 		this.log.info("Model deleted from disk", { meta: {
@@ -5179,7 +5317,7 @@ var DetectionPipelineProvider = class DetectionPipelineProvider {
 		const work = (async () => {
 			const format = this.currentEngine?.format ?? "onnx";
 			for (const step of needed) {
-				const modelEntry = getStepDefinition(step.addonId).models.find((m) => m.id === step.modelId);
+				const modelEntry = await this.resolveModelEntry(step.addonId, step.modelId);
 				if (modelEntry && !isModelDownloaded(this.modelsDir, modelEntry, format)) {
 					this.log.info("Downloading model for step", { meta: {
 						modelId: step.modelId,
@@ -5674,7 +5812,7 @@ var DetectionPipelineProvider = class DetectionPipelineProvider {
 		const format = this.currentEngine.format;
 		const downloads = [];
 		for (const step of flattenSteps(steps)) {
-			const modelEntry = getStepDefinition(step.addonId).models.find((m) => m.id === step.modelId);
+			const modelEntry = await this.resolveModelEntry(step.addonId, step.modelId);
 			if (!modelEntry) {
 				this.log.warn("Model not found in step catalog — skipping download", { meta: {
 					modelId: step.modelId,
@@ -6077,11 +6215,11 @@ var DetectionPipelineProvider = class DetectionPipelineProvider {
 		}
 	}
 };
-function buildSchemaSlots(format, modelsDir) {
+function buildSchemaSlots(format, modelsDir, customByStep) {
 	const slotMap = /* @__PURE__ */ new Map();
 	for (const pipelineStep of ALL_PIPELINE_STEPS) {
 		const step = pipelineStep.definition;
-		const availableModels = step.models.filter((m) => m.formats[format]);
+		const availableModels = mergeCustomModels(step.models, customByStep?.get(step.id) ?? []).filter((m) => m.formats[format]);
 		if (availableModels.length === 0) continue;
 		const slot = step.slot;
 		if (!slotMap.has(slot)) slotMap.set(slot, []);
@@ -6186,8 +6324,7 @@ function buildDefaultStepTree(format) {
 		makeStep("animal-classifier", [], { enabled: false }),
 		makeStep("bird-classifier", [], { enabled: false }),
 		makeStep("vehicle-classifier", [], { enabled: false }),
-		makeStep("segmentation-refiner", [], { enabled: false }),
-		makeStep("instance-segmentation", [], { enabled: false })
+		makeStep("segmentation", [], { enabled: false })
 	].filter((s) => s !== null));
 	const audioEngine = getDefaultModelForFormat("audio-classifier", format) === "apple-soundanalysis" ? {
 		runtime: "python",
@@ -6477,8 +6614,7 @@ var DetectionPipelineAddon = class extends BaseAddon {
 					label: "Execution provider",
 					options: [...STATIC_BACKEND_OPTIONS],
 					default: DEFAULT_CONFIG.engineBackend,
-					immediate: true,
-					requiresRestart: true
+					immediate: true
 				}),
 				this.field({
 					type: "select",
@@ -6486,8 +6622,7 @@ var DetectionPipelineAddon = class extends BaseAddon {
 					label: "Hardware device",
 					options: [...STATIC_DEFAULT_DEVICE_OPTIONS],
 					default: DEFAULT_CONFIG.engineDevice,
-					immediate: true,
-					requiresRestart: true
+					immediate: true
 				})
 			]
 		}, {
@@ -6526,8 +6661,7 @@ var DetectionPipelineAddon = class extends BaseAddon {
 							"onnx",
 							"cpu"
 						]
-					},
-					requiresRestart: true
+					}
 				}),
 				this.field({
 					type: "slider",
@@ -6544,8 +6678,7 @@ var DetectionPipelineAddon = class extends BaseAddon {
 					showWhen: {
 						field: "batchMode",
 						notEquals: "none"
-					},
-					requiresRestart: true
+					}
 				}),
 				this.field({
 					type: "slider",
@@ -6562,8 +6695,7 @@ var DetectionPipelineAddon = class extends BaseAddon {
 					showWhen: {
 						field: "batchMode",
 						notEquals: "none"
-					},
-					requiresRestart: true
+					}
 				}),
 				this.field({
 					type: "slider",
@@ -6576,8 +6708,7 @@ var DetectionPipelineAddon = class extends BaseAddon {
 					default: void 0,
 					showValue: true,
 					nullable: true,
-					nullLabel: "Auto",
-					requiresRestart: true
+					nullLabel: "Auto"
 				}),
 				this.field({
 					type: "slider",
@@ -6590,8 +6721,7 @@ var DetectionPipelineAddon = class extends BaseAddon {
 					default: void 0,
 					showValue: true,
 					nullable: true,
-					nullLabel: "Auto",
-					requiresRestart: true
+					nullLabel: "Auto"
 				})
 			]
 		}] });
@@ -6964,16 +7094,17 @@ var DetectionPipelineAddon = class extends BaseAddon {
 		return false;
 	}
 	/**
-	* BaseAddon calls `onConfigChanged` after every settings write.
-	* Group-runner addons can't honour the schema's `requiresRestart:
-	* true` flag (the restart cap returns "process not found" for
-	* processes spawned in a kernel group worker). To make tuning
-	* changes actually take effect, watch the pool-bound subset and
-	* respawn the provider in place when it flips.
-	*
-	* Engine cascade (`engineRuntime/Backend/Device`) and audio
-	* settings don't require this — those still rely on the addon
-	* lifecycle (engineFactory rebuild on next runPipeline).
+	* BaseAddon calls `onConfigChanged` after every settings write. This is the
+	* SOLE apply path for engine + tuning changes — none of those fields declare
+	* `requiresRestart` anymore (an addon restart re-probes hardware + reloads
+	* every model on every set, which is exactly what we want to avoid). Instead:
+	*  - Pool-bound tuning (`concurrency`/`batchMode`/`windowMs`/…) → in-place
+	*    pool respawn when the snapshot flips (`poolConfigChanged` below).
+	*  - Engine cascade (`engineBackend`/`engineDevice`) → the provider's
+	*    `onEngineSelectionChanged` disposes the device-bound factory so the next
+	*    runPipeline rebuilds the pool on the new selection, in place.
+	* Both apply optimistically — the inference gate stays closed for the short
+	* re-spin, frames are dropped (never crashed), no addon bounce.
 	*/
 	async onConfigChanged() {
 		await this.refreshNodeEngineFromStore();

package/dist/{dist-BA6DR_jV.mjs → dist-BWc-HYQz.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([
@@ -6756,6 +6762,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",
@@ -6764,6 +6777,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`.
@@ -13667,6 +13794,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",
@@ -18916,6 +19091,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",
@@ -20140,6 +20321,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",