@camstack/types 1.2.305 → 1.2.306

package/dist/index.js

@@ -5346,6 +5346,567 @@ function resolveClipSearchMinScore(meta, request) {
 	return Math.min(1, Math.round(meta.searchMinScore * factor * 1e3) / 1e3);
 }
 //#endregion
+//#region src/catalogs/coco-classmap.ts
+var COCO_80_LABELS = [
+	{
+		id: "person",
+		name: "Person"
+	},
+	{
+		id: "bicycle",
+		name: "Bicycle"
+	},
+	{
+		id: "car",
+		name: "Car"
+	},
+	{
+		id: "motorcycle",
+		name: "Motorcycle"
+	},
+	{
+		id: "airplane",
+		name: "Airplane"
+	},
+	{
+		id: "bus",
+		name: "Bus"
+	},
+	{
+		id: "train",
+		name: "Train"
+	},
+	{
+		id: "truck",
+		name: "Truck"
+	},
+	{
+		id: "boat",
+		name: "Boat"
+	},
+	{
+		id: "traffic light",
+		name: "Traffic Light"
+	},
+	{
+		id: "fire hydrant",
+		name: "Fire Hydrant"
+	},
+	{
+		id: "stop sign",
+		name: "Stop Sign"
+	},
+	{
+		id: "parking meter",
+		name: "Parking Meter"
+	},
+	{
+		id: "bench",
+		name: "Bench"
+	},
+	{
+		id: "bird",
+		name: "Bird"
+	},
+	{
+		id: "cat",
+		name: "Cat"
+	},
+	{
+		id: "dog",
+		name: "Dog"
+	},
+	{
+		id: "horse",
+		name: "Horse"
+	},
+	{
+		id: "sheep",
+		name: "Sheep"
+	},
+	{
+		id: "cow",
+		name: "Cow"
+	},
+	{
+		id: "elephant",
+		name: "Elephant"
+	},
+	{
+		id: "bear",
+		name: "Bear"
+	},
+	{
+		id: "zebra",
+		name: "Zebra"
+	},
+	{
+		id: "giraffe",
+		name: "Giraffe"
+	},
+	{
+		id: "backpack",
+		name: "Backpack"
+	},
+	{
+		id: "umbrella",
+		name: "Umbrella"
+	},
+	{
+		id: "handbag",
+		name: "Handbag"
+	},
+	{
+		id: "tie",
+		name: "Tie"
+	},
+	{
+		id: "suitcase",
+		name: "Suitcase"
+	},
+	{
+		id: "frisbee",
+		name: "Frisbee"
+	},
+	{
+		id: "skis",
+		name: "Skis"
+	},
+	{
+		id: "snowboard",
+		name: "Snowboard"
+	},
+	{
+		id: "sports ball",
+		name: "Sports Ball"
+	},
+	{
+		id: "kite",
+		name: "Kite"
+	},
+	{
+		id: "baseball bat",
+		name: "Baseball Bat"
+	},
+	{
+		id: "baseball glove",
+		name: "Baseball Glove"
+	},
+	{
+		id: "skateboard",
+		name: "Skateboard"
+	},
+	{
+		id: "surfboard",
+		name: "Surfboard"
+	},
+	{
+		id: "tennis racket",
+		name: "Tennis Racket"
+	},
+	{
+		id: "bottle",
+		name: "Bottle"
+	},
+	{
+		id: "wine glass",
+		name: "Wine Glass"
+	},
+	{
+		id: "cup",
+		name: "Cup"
+	},
+	{
+		id: "fork",
+		name: "Fork"
+	},
+	{
+		id: "knife",
+		name: "Knife"
+	},
+	{
+		id: "spoon",
+		name: "Spoon"
+	},
+	{
+		id: "bowl",
+		name: "Bowl"
+	},
+	{
+		id: "banana",
+		name: "Banana"
+	},
+	{
+		id: "apple",
+		name: "Apple"
+	},
+	{
+		id: "sandwich",
+		name: "Sandwich"
+	},
+	{
+		id: "orange",
+		name: "Orange"
+	},
+	{
+		id: "broccoli",
+		name: "Broccoli"
+	},
+	{
+		id: "carrot",
+		name: "Carrot"
+	},
+	{
+		id: "hot dog",
+		name: "Hot Dog"
+	},
+	{
+		id: "pizza",
+		name: "Pizza"
+	},
+	{
+		id: "donut",
+		name: "Donut"
+	},
+	{
+		id: "cake",
+		name: "Cake"
+	},
+	{
+		id: "chair",
+		name: "Chair"
+	},
+	{
+		id: "couch",
+		name: "Couch"
+	},
+	{
+		id: "potted plant",
+		name: "Potted Plant"
+	},
+	{
+		id: "bed",
+		name: "Bed"
+	},
+	{
+		id: "dining table",
+		name: "Dining Table"
+	},
+	{
+		id: "toilet",
+		name: "Toilet"
+	},
+	{
+		id: "tv",
+		name: "TV"
+	},
+	{
+		id: "laptop",
+		name: "Laptop"
+	},
+	{
+		id: "mouse",
+		name: "Mouse"
+	},
+	{
+		id: "remote",
+		name: "Remote"
+	},
+	{
+		id: "keyboard",
+		name: "Keyboard"
+	},
+	{
+		id: "cell phone",
+		name: "Cell Phone"
+	},
+	{
+		id: "microwave",
+		name: "Microwave"
+	},
+	{
+		id: "oven",
+		name: "Oven"
+	},
+	{
+		id: "toaster",
+		name: "Toaster"
+	},
+	{
+		id: "sink",
+		name: "Sink"
+	},
+	{
+		id: "refrigerator",
+		name: "Refrigerator"
+	},
+	{
+		id: "book",
+		name: "Book"
+	},
+	{
+		id: "clock",
+		name: "Clock"
+	},
+	{
+		id: "vase",
+		name: "Vase"
+	},
+	{
+		id: "scissors",
+		name: "Scissors"
+	},
+	{
+		id: "teddy bear",
+		name: "Teddy Bear"
+	},
+	{
+		id: "hair drier",
+		name: "Hair Drier"
+	},
+	{
+		id: "toothbrush",
+		name: "Toothbrush"
+	}
+];
+var MACRO_LABELS = [
+	{
+		id: "person",
+		name: "Person"
+	},
+	{
+		id: "vehicle",
+		name: "Vehicle"
+	},
+	{
+		id: "animal",
+		name: "Animal"
+	},
+	{
+		id: "package",
+		name: "Package"
+	}
+];
+/**
+* The class names a per-class COUNT can ever be keyed on — the macro ids, and
+* only those.
+*
+* `preserveOriginal: false` below is the whole reason this set exists: the
+* executor maps each raw COCO label onto its macro and DROPS everything else,
+* so a tracked detection's `className` is always one of {@link MACRO_LABELS}.
+* Any surface that indexes counts by class name — the ZoneAnalytics occupancy
+* snapshot's `byClass`, and therefore every occupancy rule — can match nothing
+* else. Derived from the catalog, never hand-listed, so a new macro joins it by
+* being declared once.
+*
+* Cost of not having it, 2026-08-12: the notification rule editor offered the
+* full taxonomy for an occupancy class (occupancy is the one condition that
+* does not go through the engine's macro-expanding `expandClassSelector`), two
+* live rules were authored on `car`, and both counters read 0 forever.
+*/
+var DETECTION_MACRO_CLASSES = new Set(MACRO_LABELS.map((l) => l.id));
+/** True when `className` is a macro the detector can actually emit (and hence a
+*  class a count can be keyed on) — see {@link DETECTION_MACRO_CLASSES}. */
+function isDetectionMacroClass(className) {
+	return DETECTION_MACRO_CLASSES.has(className.trim().toLowerCase());
+}
+var COCO_TO_MACRO = {
+	mapping: {
+		person: "person",
+		bicycle: "vehicle",
+		car: "vehicle",
+		motorcycle: "vehicle",
+		airplane: "vehicle",
+		bus: "vehicle",
+		train: "vehicle",
+		truck: "vehicle",
+		boat: "vehicle",
+		bird: "animal",
+		cat: "animal",
+		dog: "animal",
+		horse: "animal",
+		sheep: "animal",
+		cow: "animal",
+		elephant: "animal",
+		bear: "animal",
+		zebra: "animal",
+		giraffe: "animal",
+		suitcase: "package",
+		backpack: "package",
+		handbag: "package"
+	},
+	preserveOriginal: false
+};
+//#endregion
+//#region src/catalogs/classifier-fill.ts
+/** Steps a root detector may declare it fills. */
+var FILLABLE_STEP_IDS = [
+	"animal-classifier",
+	"vehicle-classifier",
+	"package-detection"
+];
+/** Narrow a step id to a fillable one — type guard, not a cast. */
+function isFillableStepId(value) {
+	return FILLABLE_STEP_IDS.some((id) => id === value);
+}
+/**
+* The EFFECT vocabulary of each fillable step: exactly the strings the step
+* itself emits, in its own spelling. A linked label is one of these and nothing
+* else, so a tier-1 value means the same thing whichever writer produced it.
+*
+* - `animal-classifier`: the PRIMARY model's `-labels.json` (Open Images V7,
+*   8 classes) — also the species allow-list the step offers.
+* - `vehicle-classifier`: `vehicle-type-v1-labels.json`, capitalised as the
+*   model emits them (the classifier writes `winner.class` verbatim).
+* - `package-detection`: its one output class.
+*
+* `scripts/check-label-link-vocabulary.ts` fails the build if a model entry's
+* `labelToEffect` names anything outside this table.
+*/
+var FILLABLE_STEP_VOCABULARIES = {
+	"animal-classifier": [
+		"bird",
+		"cat",
+		"cow",
+		"deer",
+		"dog",
+		"horse",
+		"sheep",
+		"squirrel"
+	],
+	"vehicle-classifier": [
+		"Ambulance",
+		"Bicycle",
+		"Bus",
+		"Car",
+		"Motorcycle",
+		"Taxi",
+		"Truck",
+		"Van"
+	],
+	"package-detection": ["package"]
+};
+/** The macro a detection must carry for the step to apply to it. */
+var FILLABLE_STEP_MACRO = {
+	"animal-classifier": "animal",
+	"vehicle-classifier": "vehicle",
+	"package-detection": "package"
+};
+/**
+* Raw detector labels that name a vocabulary entry under another spelling.
+* Case-insensitive equality covers the rest (`car` → `Car`).
+*/
+var EFFECT_ALIASES = {
+	"animal-classifier": {},
+	"vehicle-classifier": {
+		school_bus: "Bus",
+		garbage_truck: "Truck"
+	},
+	"package-detection": {}
+};
+/** The policy values of a step's `labelLink` setting. */
+var LABEL_LINK_POLICIES = ["run", "skip-when-filled"];
+/** Absent setting ⇒ this. It changes nothing unless the root model declares a fill. */
+var DEFAULT_LABEL_LINK_POLICY = "skip-when-filled";
+/** The step-settings key the policy is stored under (DeviceStepConfig.settings). */
+var LABEL_LINK_SETTING_KEY = "labelLink";
+/** `ScoredLabel.stepId` prefix of a label the detector wrote for a step. */
+var LINKED_LABEL_STEP_PREFIX = "detector-link:";
+/** `detector-link:<stepId>` — the attribution of a linked label. */
+function linkedLabelStepId(stepId) {
+	return `${LINKED_LABEL_STEP_PREFIX}${stepId}`;
+}
+/** The step a linked label stands in for, or `undefined` for any other attribution. */
+function linkedStepOf(attributionStepId) {
+	if (attributionStepId === void 0) return void 0;
+	if (!attributionStepId.startsWith("detector-link:")) return void 0;
+	const stepId = attributionStepId.slice(14);
+	return isFillableStepId(stepId) ? stepId : void 0;
+}
+/**
+* A labelmap is COCO when it carries at least half of the COCO-80 classes. A
+* COCO detector NEVER fills a step (operator decision, D715): its `dog` / `car`
+* is the generic class the classifier exists to refine, and its six animal
+* classes would otherwise read as "fills animal-classifier 6/8". Frigate+
+* shares about a dozen COCO names; a COCO-80 or COCO-91 labelmap carries ~80.
+*/
+function isCocoLabelmap(labels) {
+	const present = new Set(labels);
+	return COCO_80_LABELS.filter((l) => present.has(l.id)).length * 2 >= COCO_80_LABELS.length;
+}
+function effectFor(stepId, label) {
+	const alias = EFFECT_ALIASES[stepId][label];
+	if (alias !== void 0) return alias;
+	const folded = label.toLowerCase();
+	return FILLABLE_STEP_VOCABULARIES[stepId].find((v) => v.toLowerCase() === folded);
+}
+/**
+* Which steps a root detector fills, from its labelmap and classMap. A label
+* counts for a step only when the model's classMap sends it to that step's
+* macro AND it names a vocabulary entry. A step none of the labels reach is
+* not declared; a COCO labelmap declares nothing.
+*/
+function deriveClassifierFills(labels, classMap) {
+	if (classMap === void 0 || isCocoLabelmap(labels)) return [];
+	const fills = [];
+	for (const stepId of FILLABLE_STEP_IDS) {
+		const labelToEffect = {};
+		for (const label of labels) {
+			if (classMap.mapping[label] !== FILLABLE_STEP_MACRO[stepId]) continue;
+			const effect = effectFor(stepId, label);
+			if (effect !== void 0) labelToEffect[label] = effect;
+		}
+		const covered = new Set(Object.values(labelToEffect));
+		if (covered.size === 0) continue;
+		const uncovered = FILLABLE_STEP_VOCABULARIES[stepId].filter((v) => !covered.has(v));
+		fills.push({
+			stepId,
+			labelToEffect,
+			uncovered
+		});
+	}
+	return fills;
+}
+/** The fill a model declares for one step, if any. */
+function fillFor(entry, stepId) {
+	return entry?.fillsClassifierEffects?.find((f) => f.stepId === stepId);
+}
+/** Read the `labelLink` policy off a step's settings bag; anything else ⇒ the default. */
+function readLabelLinkPolicy(settings) {
+	const raw = settings?.[LABEL_LINK_SETTING_KEY];
+	return LABEL_LINK_POLICIES.find((p) => p === raw) ?? "skip-when-filled";
+}
+/**
+* Decide the writer of one filled effect for one camera.
+*
+* - The step is not running (disabled, or not in the camera's tree): the
+*   detector is the only writer — authoritative, nothing to skip.
+* - The step runs, the policy is `skip-when-filled` and every coverage gap is
+*   switched off in `enabledClasses`: the detector is authoritative and the
+*   step is skipped.
+* - Otherwise the step runs and is the writer; the linked label is a score-0
+*   fallback.
+*/
+function resolveLabelLink(fill, step) {
+	const policy = readLabelLinkPolicy(step?.settings);
+	const rawEnabled = step?.settings?.["enabledClasses"];
+	const allowList = Array.isArray(rawEnabled) && rawEnabled.length > 0 ? rawEnabled.filter((v) => typeof v === "string") : null;
+	const openGaps = fill.uncovered.filter((g) => allowList === null || allowList.includes(g));
+	if (step === void 0 || !step.enabled) return {
+		authoritative: true,
+		skip: false,
+		policy,
+		openGaps
+	};
+	const skip = policy === "skip-when-filled" && openGaps.length === 0;
+	return {
+		authoritative: skip,
+		skip,
+		policy,
+		openGaps
+	};
+}
+//#endregion
 //#region src/types/models.ts
 var MODEL_FORMATS = [
 	"onnx",
@@ -5501,6 +6062,12 @@ var ModelLicenseRecordSchema = zod.z.object({
 * `camstack/docs` → `/docs/detection/models`.
 */
 var ModelLicenseSchema = zod.z.preprocess((value) => typeof value === "string" ? { weights: value } : value, ModelLicenseRecordSchema);
+/** One `fillsClassifierEffects` entry — see `ModelCatalogEntry.fillsClassifierEffects`. */
+var FillsClassifierEffectSchema = zod.z.object({
+	stepId: zod.z.enum(FILLABLE_STEP_IDS),
+	labelToEffect: zod.z.record(zod.z.string(), zod.z.string()),
+	uncovered: zod.z.array(zod.z.string()).readonly()
+});
 var ModelCatalogEntrySchema = zod.z.object({
 	id: zod.z.string(),
 	name: zod.z.string(),
@@ -5627,6 +6194,16 @@ var ModelCatalogEntrySchema = zod.z.object({
 	*/
 	classMap: DetectionCatalogClassMapSchema.optional(),
 	/**
+	* The pipeline steps this ROOT detector already does the work of (D715):
+	* its labels name the effect the step exists to produce (`deer` for
+	* `animal-classifier`, `package` for `package-detection`). Derived from the
+	* labelmap by `deriveClassifierFills`, never hand-written; a COCO model
+	* declares none. Whether a declaration is honoured is the step's own
+	* `labelLink` policy (`resolveLabelLink`). `labelToEffect` values are in
+	* `FILLABLE_STEP_VOCABULARIES` (guard `check-label-link-vocabulary`).
+	*/
+	fillsClassifierEffects: zod.z.array(FillsClassifierEffectSchema).readonly().optional(),
+	/**
 	* The model's CLIP feature-space contract (text encoder, dimension, vector
 	* index, token window, search floor) — see `clip-model.ts`. Present ONLY on a
 	* CLIP image encoder; its absence is what "not a CLIP model" means to the
@@ -18014,398 +18591,6 @@ var notificationOutputCapability = {
 	}
 };
 //#endregion
-//#region src/catalogs/coco-classmap.ts
-var COCO_80_LABELS = [
-	{
-		id: "person",
-		name: "Person"
-	},
-	{
-		id: "bicycle",
-		name: "Bicycle"
-	},
-	{
-		id: "car",
-		name: "Car"
-	},
-	{
-		id: "motorcycle",
-		name: "Motorcycle"
-	},
-	{
-		id: "airplane",
-		name: "Airplane"
-	},
-	{
-		id: "bus",
-		name: "Bus"
-	},
-	{
-		id: "train",
-		name: "Train"
-	},
-	{
-		id: "truck",
-		name: "Truck"
-	},
-	{
-		id: "boat",
-		name: "Boat"
-	},
-	{
-		id: "traffic light",
-		name: "Traffic Light"
-	},
-	{
-		id: "fire hydrant",
-		name: "Fire Hydrant"
-	},
-	{
-		id: "stop sign",
-		name: "Stop Sign"
-	},
-	{
-		id: "parking meter",
-		name: "Parking Meter"
-	},
-	{
-		id: "bench",
-		name: "Bench"
-	},
-	{
-		id: "bird",
-		name: "Bird"
-	},
-	{
-		id: "cat",
-		name: "Cat"
-	},
-	{
-		id: "dog",
-		name: "Dog"
-	},
-	{
-		id: "horse",
-		name: "Horse"
-	},
-	{
-		id: "sheep",
-		name: "Sheep"
-	},
-	{
-		id: "cow",
-		name: "Cow"
-	},
-	{
-		id: "elephant",
-		name: "Elephant"
-	},
-	{
-		id: "bear",
-		name: "Bear"
-	},
-	{
-		id: "zebra",
-		name: "Zebra"
-	},
-	{
-		id: "giraffe",
-		name: "Giraffe"
-	},
-	{
-		id: "backpack",
-		name: "Backpack"
-	},
-	{
-		id: "umbrella",
-		name: "Umbrella"
-	},
-	{
-		id: "handbag",
-		name: "Handbag"
-	},
-	{
-		id: "tie",
-		name: "Tie"
-	},
-	{
-		id: "suitcase",
-		name: "Suitcase"
-	},
-	{
-		id: "frisbee",
-		name: "Frisbee"
-	},
-	{
-		id: "skis",
-		name: "Skis"
-	},
-	{
-		id: "snowboard",
-		name: "Snowboard"
-	},
-	{
-		id: "sports ball",
-		name: "Sports Ball"
-	},
-	{
-		id: "kite",
-		name: "Kite"
-	},
-	{
-		id: "baseball bat",
-		name: "Baseball Bat"
-	},
-	{
-		id: "baseball glove",
-		name: "Baseball Glove"
-	},
-	{
-		id: "skateboard",
-		name: "Skateboard"
-	},
-	{
-		id: "surfboard",
-		name: "Surfboard"
-	},
-	{
-		id: "tennis racket",
-		name: "Tennis Racket"
-	},
-	{
-		id: "bottle",
-		name: "Bottle"
-	},
-	{
-		id: "wine glass",
-		name: "Wine Glass"
-	},
-	{
-		id: "cup",
-		name: "Cup"
-	},
-	{
-		id: "fork",
-		name: "Fork"
-	},
-	{
-		id: "knife",
-		name: "Knife"
-	},
-	{
-		id: "spoon",
-		name: "Spoon"
-	},
-	{
-		id: "bowl",
-		name: "Bowl"
-	},
-	{
-		id: "banana",
-		name: "Banana"
-	},
-	{
-		id: "apple",
-		name: "Apple"
-	},
-	{
-		id: "sandwich",
-		name: "Sandwich"
-	},
-	{
-		id: "orange",
-		name: "Orange"
-	},
-	{
-		id: "broccoli",
-		name: "Broccoli"
-	},
-	{
-		id: "carrot",
-		name: "Carrot"
-	},
-	{
-		id: "hot dog",
-		name: "Hot Dog"
-	},
-	{
-		id: "pizza",
-		name: "Pizza"
-	},
-	{
-		id: "donut",
-		name: "Donut"
-	},
-	{
-		id: "cake",
-		name: "Cake"
-	},
-	{
-		id: "chair",
-		name: "Chair"
-	},
-	{
-		id: "couch",
-		name: "Couch"
-	},
-	{
-		id: "potted plant",
-		name: "Potted Plant"
-	},
-	{
-		id: "bed",
-		name: "Bed"
-	},
-	{
-		id: "dining table",
-		name: "Dining Table"
-	},
-	{
-		id: "toilet",
-		name: "Toilet"
-	},
-	{
-		id: "tv",
-		name: "TV"
-	},
-	{
-		id: "laptop",
-		name: "Laptop"
-	},
-	{
-		id: "mouse",
-		name: "Mouse"
-	},
-	{
-		id: "remote",
-		name: "Remote"
-	},
-	{
-		id: "keyboard",
-		name: "Keyboard"
-	},
-	{
-		id: "cell phone",
-		name: "Cell Phone"
-	},
-	{
-		id: "microwave",
-		name: "Microwave"
-	},
-	{
-		id: "oven",
-		name: "Oven"
-	},
-	{
-		id: "toaster",
-		name: "Toaster"
-	},
-	{
-		id: "sink",
-		name: "Sink"
-	},
-	{
-		id: "refrigerator",
-		name: "Refrigerator"
-	},
-	{
-		id: "book",
-		name: "Book"
-	},
-	{
-		id: "clock",
-		name: "Clock"
-	},
-	{
-		id: "vase",
-		name: "Vase"
-	},
-	{
-		id: "scissors",
-		name: "Scissors"
-	},
-	{
-		id: "teddy bear",
-		name: "Teddy Bear"
-	},
-	{
-		id: "hair drier",
-		name: "Hair Drier"
-	},
-	{
-		id: "toothbrush",
-		name: "Toothbrush"
-	}
-];
-var MACRO_LABELS = [
-	{
-		id: "person",
-		name: "Person"
-	},
-	{
-		id: "vehicle",
-		name: "Vehicle"
-	},
-	{
-		id: "animal",
-		name: "Animal"
-	},
-	{
-		id: "package",
-		name: "Package"
-	}
-];
-/**
-* The class names a per-class COUNT can ever be keyed on — the macro ids, and
-* only those.
-*
-* `preserveOriginal: false` below is the whole reason this set exists: the
-* executor maps each raw COCO label onto its macro and DROPS everything else,
-* so a tracked detection's `className` is always one of {@link MACRO_LABELS}.
-* Any surface that indexes counts by class name — the ZoneAnalytics occupancy
-* snapshot's `byClass`, and therefore every occupancy rule — can match nothing
-* else. Derived from the catalog, never hand-listed, so a new macro joins it by
-* being declared once.
-*
-* Cost of not having it, 2026-08-12: the notification rule editor offered the
-* full taxonomy for an occupancy class (occupancy is the one condition that
-* does not go through the engine's macro-expanding `expandClassSelector`), two
-* live rules were authored on `car`, and both counters read 0 forever.
-*/
-var DETECTION_MACRO_CLASSES = new Set(MACRO_LABELS.map((l) => l.id));
-/** True when `className` is a macro the detector can actually emit (and hence a
-*  class a count can be keyed on) — see {@link DETECTION_MACRO_CLASSES}. */
-function isDetectionMacroClass(className) {
-	return DETECTION_MACRO_CLASSES.has(className.trim().toLowerCase());
-}
-var COCO_TO_MACRO = {
-	mapping: {
-		person: "person",
-		bicycle: "vehicle",
-		car: "vehicle",
-		motorcycle: "vehicle",
-		airplane: "vehicle",
-		bus: "vehicle",
-		train: "vehicle",
-		truck: "vehicle",
-		boat: "vehicle",
-		bird: "animal",
-		cat: "animal",
-		dog: "animal",
-		horse: "animal",
-		sheep: "animal",
-		cow: "animal",
-		elephant: "animal",
-		bear: "animal",
-		zebra: "animal",
-		giraffe: "animal",
-		suitcase: "package",
-		backpack: "package",
-		handbag: "package"
-	},
-	preserveOriginal: false
-};
-//#endregion
 //#region src/catalogs/audio-classmap.ts
 var AUDIO_MACRO_LABELS = [
 	{
@@ -19768,7 +19953,7 @@ var NcLegacyRuleActionSequenceSchema = zod.z.object({
 	minDelaySec: zod.z.number().int().min(0).max(86400).optional(),
 	actions: zod.z.array(NcRuleActionSchema).min(1)
 });
-/** @deprecated */
+/** @deprecated Alias kept for call sites mid-migration; prefer {@link NcSharedSequence}. */
 var NcRuleActionSequenceSchema = NcLegacyRuleActionSequenceSchema;
 /**
 * "This rule applies only while `deviceId` is in one of `states`."
@@ -25783,7 +25968,8 @@ var PipelineModelOptionSchema = zod.z.object({
 	group: ModelVariantGroupSchema.optional(),
 	legacy: zod.z.boolean().optional(),
 	provider: ModelProviderIdSchema.optional(),
-	defaultConfidence: zod.z.number().optional()
+	defaultConfidence: zod.z.number().optional(),
+	fillsClassifierEffects: zod.z.array(FillsClassifierEffectSchema).readonly().optional()
 });
 var ConfigFieldBridge = zod.z.custom();
 var PipelineAddonSchemaSchema = zod.z.object({
@@ -47271,7 +47457,8 @@ function expressionOutcome(source, read, now, stateful) {
 		value: null,
 		reason: `the expression failed: ${result.error}`,
 		fatal: false,
-		confirmed: true
+		confirmed: true,
+		expressionFailed: true
 	};
 	return {
 		state: staleReasons.length > 0 ? "stale" : "fresh",
@@ -47621,6 +47808,116 @@ function convertPresetFeature(input) {
 	};
 }
 //#endregion
+//#region src/catalogs/frigate-plus-classmap.ts
+function isClassMapMacroTarget(value) {
+	return CLASS_MAP_MACRO_TARGETS.some((target) => target === value);
+}
+/**
+* Raw Frigate+ label → detection macro. Every label of the documented
+* Frigate+ base set (docs.frigate.video/plus, verified 2026-08-21) is either
+* here or in {@link FRIGATE_PLUS_UNMAPPED_LABELS}, with the reason it is not.
+*
+* Why this exists: a Frigate+ import used to carry NO classMap, so it inherited
+* the step's `COCO_TO_MACRO` (`preserveOriginal: false`) and the executor
+* dropped every label COCO does not name — deer, raccoon, fox, squirrel, goat,
+* rabbit, skunk, kangaroo, possum, rodent, school_bus, garbage_truck and even
+* `package` vanished as `class-filter` discards. The executor keeps the raw
+* label as `originalClass` whenever the map resolves it, so the fine identity
+* survives under the macro.
+*/
+var FRIGATE_PLUS_TO_MACRO = {
+	person: "person",
+	baby: "person",
+	car: "vehicle",
+	motorcycle: "vehicle",
+	bicycle: "vehicle",
+	boat: "vehicle",
+	school_bus: "vehicle",
+	garbage_truck: "vehicle",
+	dog: "animal",
+	cat: "animal",
+	deer: "animal",
+	horse: "animal",
+	bird: "animal",
+	raccoon: "animal",
+	fox: "animal",
+	bear: "animal",
+	cow: "animal",
+	squirrel: "animal",
+	goat: "animal",
+	rabbit: "animal",
+	skunk: "animal",
+	kangaroo: "animal",
+	possum: "animal",
+	rodent: "animal",
+	package: "package"
+};
+/**
+* Frigate+ labels deliberately left OUT of {@link FRIGATE_PLUS_TO_MACRO}.
+*
+* - `attribute`: Frigate+ emits these INSIDE a parent box (a face inside a
+*   person, a plate or a carrier logo on a vehicle). Mapping one to its
+*   parent's macro would spawn a second, overlapping track for the same
+*   subject; CamStack derives faces and plates with its own detail steps.
+* - `no-macro`: an object with no detection macro to live under.
+*/
+var FRIGATE_PLUS_UNMAPPED_LABELS = {
+	face: "attribute",
+	license_plate: "attribute",
+	amazon: "attribute",
+	usps: "attribute",
+	ups: "attribute",
+	fedex: "attribute",
+	dhl: "attribute",
+	an_post: "attribute",
+	purolator: "attribute",
+	postnl: "attribute",
+	nzpost: "attribute",
+	postnord: "attribute",
+	gls: "attribute",
+	dpd: "attribute",
+	canada_post: "attribute",
+	royal_mail: "attribute",
+	waste_bin: "no-macro",
+	bbq_grill: "no-macro",
+	robot_lawnmower: "no-macro",
+	umbrella: "no-macro",
+	baby_stroller: "no-macro"
+};
+/**
+* The per-model classMap for a Frigate / Frigate+ detector, derived from ITS
+* labelmap: each label resolves through {@link FRIGATE_PLUS_TO_MACRO} first,
+* then `COCO_TO_MACRO` (Frigate's default model ships the COCO-91 labelmap, so
+* a preset import may carry either vocabulary). A label neither knows is left
+* out, and `preserveOriginal: false` drops it in the executor — the same
+* contract as the COCO map, now with the Frigate+ vocabulary in it.
+*/
+function buildFrigateClassMap(labels) {
+	const mapping = {};
+	for (const label of labels) {
+		const target = FRIGATE_PLUS_TO_MACRO[label] ?? COCO_TO_MACRO.mapping[label];
+		if (target !== void 0 && isClassMapMacroTarget(target)) mapping[label] = target;
+	}
+	return {
+		mapping,
+		preserveOriginal: false
+	};
+}
+/**
+* Everything a Frigate / Frigate+ entry derives from its labelmap: the classMap
+* and the steps it fills (D715). Every Frigate builder spreads this, so the two
+* cannot be derived from different label lists. A COCO labelmap gets its map
+* and no fill.
+*/
+function frigateLabelFields(labels) {
+	const classMap = buildFrigateClassMap(labels);
+	const fills = deriveClassifierFills(labels, classMap);
+	return fills.length > 0 ? {
+		classMap,
+		fillsClassifierEffects: fills
+	} : { classMap };
+}
+//#endregion
 //#region src/catalogs/device-state-vocabulary.ts
 /**
 * Most specific first. Extending this list is how a new device kind becomes
@@ -70894,9 +71191,9 @@ function slideInsideFrame(rect, frameWidth, frameHeight) {
 * ## What each knob costs
 *
 * A HELD frame is a full NATIVE-resolution copy in system RAM. With the
-* default pinned-RGB24 lease path (`CAMSTACK_SESSION_PINNED_RGB_CROP`, on):
-* 4K ≈ 24.9 MB/frame, 1080p ≈ 6.2 MB/frame. On the YUV420P path (flag off, and
-* for software-decoded sessions): 4K ≈ 12.4 MB, 1080p ≈ 3.1 MB. Worst-case
+* pinned-RGB24 lease path (hardware sessions):
+* 4K ≈ 24.9 MB/frame, 1080p ≈ 6.2 MB/frame. On the YUV420P path (software-decoded
+* sessions): 4K ≈ 12.4 MB, 1080p ≈ 3.1 MB. Worst-case
 * resident RAM for ONE busy camera is now `frameBytes × holdFrames`, clamped by
 * the budget ceiling — bounded by a COUNT because a held frame is waiting for
 * one specific event (its own detection result), not for a clock.
@@ -73118,6 +73415,7 @@ exports.DEFAULT_EVENTS_BAND_BUFFER_SEC = DEFAULT_EVENTS_BAND_BUFFER_SEC;
 exports.DEFAULT_EVENT_COLOR = DEFAULT_EVENT_COLOR;
 exports.DEFAULT_FEATURES = DEFAULT_FEATURES;
 exports.DEFAULT_FIRST_SIGHTING_FRESHNESS_MS = require_composition.DEFAULT_FIRST_SIGHTING_FRESHNESS_MS;
+exports.DEFAULT_LABEL_LINK_POLICY = DEFAULT_LABEL_LINK_POLICY;
 exports.DEFAULT_MIN_LANDMARK_FACE_SIZE_PX = DEFAULT_MIN_LANDMARK_FACE_SIZE_PX;
 exports.DEFAULT_NATIVE_LEASE_SETTINGS = DEFAULT_NATIVE_LEASE_SETTINGS;
 exports.DEFAULT_OVERLAY_LAYERS = DEFAULT_OVERLAY_LAYERS;
@@ -73294,7 +73592,12 @@ exports.ExtensionSourceSchema = ExtensionSourceSchema;
 exports.FEEDER_EXAMPLE_ADDON_ID = FEEDER_EXAMPLE_ADDON_ID;
 exports.FEEDER_EXAMPLE_HA_DEVICE_ID = FEEDER_EXAMPLE_HA_DEVICE_ID;
 exports.FFMPEG_PATH_ENV = require_composition.FFMPEG_PATH_ENV;
+exports.FILLABLE_STEP_IDS = FILLABLE_STEP_IDS;
+exports.FILLABLE_STEP_MACRO = FILLABLE_STEP_MACRO;
+exports.FILLABLE_STEP_VOCABULARIES = FILLABLE_STEP_VOCABULARIES;
 exports.FIRST_LEVEL_MACRO_CLASSES = FIRST_LEVEL_MACRO_CLASSES;
+exports.FRIGATE_PLUS_TO_MACRO = FRIGATE_PLUS_TO_MACRO;
+exports.FRIGATE_PLUS_UNMAPPED_LABELS = FRIGATE_PLUS_UNMAPPED_LABELS;
 exports.FULL_IMAGE_BBOX = FULL_IMAGE_BBOX;
 exports.FailureContributionSchema = FailureContributionSchema;
 exports.FailureCounters = FailureCounters;
@@ -73305,6 +73608,7 @@ exports.FeatureManifestSchema = FeatureManifestSchema;
 exports.FeatureProbeStatusSchema = FeatureProbeStatusSchema;
 exports.FieldClaimModeSchema = FieldClaimModeSchema;
 exports.FieldClaimSchema = FieldClaimSchema;
+exports.FillsClassifierEffectSchema = FillsClassifierEffectSchema;
 exports.FloodStatusSchema = FloodStatusSchema;
 exports.Fmp4BoxSplitter = require_composition.Fmp4BoxSplitter;
 exports.FrameHandleFormatSchema = require_sleep.FrameHandleFormatSchema;
@@ -73353,8 +73657,11 @@ exports.IntercomAbilitySchema = IntercomAbilitySchema;
 exports.IntercomStatusSchema = IntercomStatusSchema;
 exports.KNOWN_CAP_NAMES = KNOWN_CAP_NAMES;
 exports.KeyEventSchema = KeyEventSchema;
+exports.LABEL_LINK_POLICIES = LABEL_LINK_POLICIES;
+exports.LABEL_LINK_SETTING_KEY = LABEL_LINK_SETTING_KEY;
 exports.LEGACY_READ_ONLY_CONFIG_KEY = LEGACY_READ_ONLY_CONFIG_KEY;
 exports.LINKED_DEVICES_SLOT = LINKED_DEVICES_SLOT;
+exports.LINKED_LABEL_STEP_PREFIX = LINKED_LABEL_STEP_PREFIX;
 exports.LOAD_CONTRIBUTION_ATTRIBUTIONS = LOAD_CONTRIBUTION_ATTRIBUTIONS;
 exports.LOAD_CONTRIBUTION_ROLES = LOAD_CONTRIBUTION_ROLES;
 exports.LOCATION_DESCRIPTION_MAX = LOCATION_DESCRIPTION_MAX;
@@ -74302,6 +74609,7 @@ exports.buildDeviceAdminUrl = buildDeviceAdminUrl;
 exports.buildDoorbellCompositionFeature = buildDoorbellCompositionFeature;
 exports.buildEventKindDescriptor = buildEventKindDescriptor;
 exports.buildFfmpegArgs = require_composition.buildFfmpegArgs;
+exports.buildFrigateClassMap = buildFrigateClassMap;
 exports.buildInputArgs = require_composition.buildInputArgs;
 exports.buildModelVariantGroups = buildModelVariantGroups;
 exports.buildNcTaxonomy = buildNcTaxonomy;
@@ -74408,6 +74716,7 @@ exports.defineExtensionSlotProvider = defineExtensionSlotProvider;
 exports.deleteAlarmProfile = deleteAlarmProfile;
 exports.deriveBatteryPresence = deriveBatteryPresence;
 exports.deriveCameraSwitches = deriveCameraSwitches;
+exports.deriveClassifierFills = deriveClassifierFills;
 exports.deriveDetailCropRect = deriveDetailCropRect;
 exports.derivePostTriggeredAction = derivePostTriggeredAction;
 exports.deriveRecordingMode = deriveRecordingMode;
@@ -74499,6 +74808,7 @@ exports.feederExampleSources = feederExampleSources;
 exports.ffmpegRate = ffmpegRate;
 exports.fieldReads = require_composition.fieldReads;
 exports.filesystemBrowseCapability = filesystemBrowseCapability;
+exports.fillFor = fillFor;
 exports.findCandidateCycles = findCandidateCycles;
 exports.findCompositionCycles = findCompositionCycles;
 exports.findTimezone = findTimezone;
@@ -74508,6 +74818,7 @@ exports.formatForRuntime = formatForRuntime;
 exports.formatMediaOwnerKey = formatMediaOwnerKey;
 exports.formatMinutes = formatMinutes;
 exports.formatParkedFor = formatParkedFor;
+exports.frigateLabelFields = frigateLabelFields;
 exports.gasCapability = gasCapability;
 exports.gbToBytes = gbToBytes;
 exports.generateAutomationBlock = generateAutomationBlock;
@@ -74547,6 +74858,7 @@ exports.isAudioRule = isAudioRule;
 exports.isBaseConditionKey = isBaseConditionKey;
 exports.isBatteryPresenceFault = isBatteryPresenceFault;
 exports.isClusterScopedStep = isClusterScopedStep;
+exports.isCocoLabelmap = isCocoLabelmap;
 exports.isCollectionArrayMethod = isCollectionArrayMethod;
 exports.isDefaultAlarmProfileId = isDefaultAlarmProfileId;
 exports.isDeployableToAgent = isDeployableToAgent;
@@ -74560,6 +74872,7 @@ exports.isEmbeddingModelFailed = isEmbeddingModelFailed;
 exports.isEvent = require_sleep.isEvent;
 exports.isEventKindLabelKey = isEventKindLabelKey;
 exports.isEventOwnerType = isEventOwnerType;
+exports.isFillableStepId = isFillableStepId;
 exports.isFirstLevelMacroClass = isFirstLevelMacroClass;
 exports.isHeldBackTemplateVar = isHeldBackTemplateVar;
 exports.isIsolatedBuiltin = isIsolatedBuiltin;
@@ -74599,6 +74912,8 @@ exports.lifecycleJobSchema = lifecycleJobSchema;
 exports.lifecycleJobScopeSchema = lifecycleJobScopeSchema;
 exports.lifecycleJobStateSchema = lifecycleJobStateSchema;
 exports.lifecycleTaskSchema = lifecycleTaskSchema;
+exports.linkedLabelStepId = linkedLabelStepId;
+exports.linkedStepOf = linkedStepOf;
 exports.llmCapability = llmCapability;
 exports.llmRuntimeCapability = llmRuntimeCapability;
 exports.loadContributionCapability = loadContributionCapability;
@@ -74724,6 +75039,7 @@ exports.readClusterStepSettings = readClusterStepSettings;
 exports.readDetailCropConvention = readDetailCropConvention;
 exports.readDeviceStateFrom = readDeviceStateFrom;
 exports.readHubMotionDetected = readHubMotionDetected;
+exports.readLabelLinkPolicy = readLabelLinkPolicy;
 exports.readMotionTriggeredBy = readMotionTriggeredBy;
 exports.readNativeLeaseOverride = readNativeLeaseOverride;
 exports.readNodePin = require_sleep.readNodePin;
@@ -74761,6 +75077,7 @@ exports.resolveEgressDecodeHwAccel = resolveEgressDecodeHwAccel;
 exports.resolveExportProfiles = resolveExportProfiles;
 exports.resolveFormat = resolveFormat;
 exports.resolveHydratedFieldValue = require_sleep.resolveHydratedFieldValue;
+exports.resolveLabelLink = resolveLabelLink;
 exports.resolveLocationIcon = resolveLocationIcon;
 exports.resolveLocationMode = resolveLocationMode;
 exports.resolveMethodAuth = resolveMethodAuth;