@camstack/addon-pipeline 1.2.328 → 1.2.330

package/dist/{dist-wJO7mXeO.js → dist-CMeICL07.js}

@@ -12600,398 +12600,35 @@ var ClipSearchStrictnessSchema = _enum([
 	"balanced",
 	"strict"
 ]);
-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"
-	}
-];
-new Set([
-	{
-		id: "person",
-		name: "Person"
-	},
-	{
-		id: "vehicle",
-		name: "Vehicle"
-	},
-	{
-		id: "animal",
-		name: "Animal"
-	},
-	{
-		id: "package",
-		name: "Package"
-	}
-].map((l) => l.id));
-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
-};
-/** Steps a root detector may declare it fills. */
-var FILLABLE_STEP_IDS = [
+/** Steps whose effect a root label can BE. */
+var LABEL_SUPPLY_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);
+/** Steps whose box a root detection can BE. */
+var CROP_SUPPLY_STEP_IDS = ["plate-detection", "face-detection"];
+/** Every step a root model can supply. */
+var ROOT_SUPPLIABLE_STEP_IDS = [...LABEL_SUPPLY_STEP_IDS, ...CROP_SUPPLY_STEP_IDS];
+/** Narrow a step id to a label-kind one. */
+function isLabelSupplyStepId(value) {
+	return LABEL_SUPPLY_STEP_IDS.some((id) => id === value);
 }
 /**
-* The EFFECT vocabulary of each fillable step: exactly the strings the step
+* The EFFECT vocabulary of each label-kind 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).
+* - `vehicle-classifier`: the classifier's labels, capitalised as it emits them
+*   (it writes `winner.class` verbatim).
 * - `package-detection`: its one output class.
 *
-* `scripts/check-label-link-vocabulary.ts` fails the build if a model entry's
+* `scripts/check-label-link-vocabulary.ts` fails the build if a declared
 * `labelToEffect` names anything outside this table.
 */
-var FILLABLE_STEP_VOCABULARIES = {
+var LABEL_SUPPLY_VOCABULARIES = {
 	"animal-classifier": [
 		"bird",
 		"cat",
@@ -13014,18 +12651,64 @@ var FILLABLE_STEP_VOCABULARIES = {
 	],
 	"package-detection": ["package"]
 };
-/** The macro a detection must carry for the step to apply to it. */
-var FILLABLE_STEP_MACRO = {
+/** The macro a detection must carry for a label-kind step to apply to it. */
+var LABEL_SUPPLY_MACRO = {
 	"animal-classifier": "animal",
 	"vehicle-classifier": "vehicle",
 	"package-detection": "package"
 };
-/** 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";
+/**
+* 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": {}
+};
+var CROP_SUPPLY_SOURCES = {
+	"plate-detection": {
+		rootLabels: ["license_plate"],
+		parentMacro: "vehicle",
+		childClass: "plate",
+		servedChildSteps: ["plate-ocr"],
+		use: "as-output"
+	},
+	"face-detection": {
+		rootLabels: ["face"],
+		parentMacro: "person",
+		childClass: "face",
+		servedChildSteps: ["face-embedding"],
+		use: "refine",
+		minRootInputPx: 640
+	}
+};
+/**
+* Whether an operator intends a step to take the root's output when the
+* root declares it — the default of the `useRootModel` flag. The label kinds
+* default ON: the detector's answer is the cheaper one and the classifier
+* keeps its model for the day the root changes. The crop kinds default OFF: a
+* root plate box has an uncalibrated OCR margin, and root-face refinement has
+* not run on live traffic yet.
+*/
+var USE_ROOT_MODEL_DEFAULTS = {
+	"animal-classifier": true,
+	"vehicle-classifier": true,
+	"package-detection": true,
+	"plate-detection": false,
+	"face-detection": false
+};
+/** The step-settings key the flag is stored under (DeviceStepConfig.settings, camera overrides). */
+var USE_ROOT_MODEL_SETTING_KEY = "useRootModel";
+/**
+* The retired D715 policy key. A `skip-when-filled` / `run` value still
+* stored under it reads as the flag (`true` / `false`) when no flag is stored
+* — the normal read path, not a migration.
+*/
+var RETIRED_LABEL_LINK_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. */
@@ -13037,43 +12720,150 @@ 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;
-}
-/** 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 isLabelSupplyStepId(stepId) ? stepId : void 0;
+}
+function effectFor(stepId, label) {
+	const alias = EFFECT_ALIASES[stepId][label];
+	if (alias !== void 0) return alias;
+	const folded = label.toLowerCase();
+	return LABEL_SUPPLY_VOCABULARIES[stepId].find((v) => v.toLowerCase() === folded);
+}
+/**
+* Which steps a root detector can supply, from its labelmap and classMap.
+*
+* - label kind: a label counts for a step only when the classMap sends it to
+*   that step's macro AND it names a vocabulary entry. Every root is judged
+*   the same way — a COCO model supplies the animal classifier with the six
+*   species COCO names, exactly as a Frigate+ model supplies seven.
+* - crop kind: the labelmap carries one of the step's root labels. Those
+*   labels are deliberately left out of the classMap, so they never make a
+*   track of their own.
+*
+* No classMap ⇒ no label supply (nothing says which macro a label lives under).
+*/
+function deriveRootSupplies(labels, classMap) {
+	const supplies = [];
+	if (classMap !== void 0) for (const stepId of LABEL_SUPPLY_STEP_IDS) {
+		const labelToEffect = {};
+		for (const label of labels) {
+			if (classMap.mapping[label] !== LABEL_SUPPLY_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 = LABEL_SUPPLY_VOCABULARIES[stepId].filter((v) => !covered.has(v));
+		supplies.push({
+			kind: "label",
+			stepId,
+			labelToEffect,
+			uncovered
+		});
+	}
+	const present = new Set(labels);
+	for (const stepId of CROP_SUPPLY_STEP_IDS) {
+		const source = CROP_SUPPLY_SOURCES[stepId];
+		const rootLabels = source.rootLabels.filter((l) => present.has(l));
+		if (rootLabels.length === 0) continue;
+		supplies.push({
+			kind: "crop",
+			stepId,
+			rootLabels,
+			parentMacro: source.parentMacro,
+			childClass: source.childClass
+		});
+	}
+	return supplies;
+}
+/**
+* The supplies a root model declares. A row registered with a declaration
+* carries it (`suppliesSteps`, computed at import from the model's own
+* labelmap); a row without one — a built-in entry, or a custom row registered
+* before the field existed — is derived here, on read, from the same inputs.
+*/
+function rootSuppliesOf(entry, stepDefaults) {
+	const declared = entry?.suppliesSteps ?? deriveRootSupplies(entry !== void 0 && entry.labels.length > 0 ? entry.labels.map((l) => l.id) : stepDefaults.labels, entry?.classMap ?? stepDefaults.classMap);
+	const inputPx = entry !== void 0 ? Math.min(entry.inputSize.width, entry.inputSize.height) : void 0;
+	if (inputPx === void 0) return declared;
+	return declared.map((s) => s.kind === "crop" ? {
+		...s,
+		rootInputPx: inputPx
+	} : s);
+}
+/** The supply a root declares for one step, if any. */
+function supplyFor(supplies, stepId) {
+	return supplies?.find((s) => s.stepId === stepId);
+}
+/**
+* Read the `useRootModel` flag off a step's settings bag. Absent ⇒ the
+* retired `labelLink` value if one is stored, else the step's default.
+*/
+function readUseRootModel(stepId, settings) {
+	const raw = settings?.[USE_ROOT_MODEL_SETTING_KEY];
+	if (typeof raw === "boolean") return raw;
+	const retired = settings?.[RETIRED_LABEL_LINK_KEY];
+	if (retired === "skip-when-filled") return true;
+	if (retired === "run") return false;
+	return USE_ROOT_MODEL_DEFAULTS[stepId];
+}
+/** Why a DECLARED supply is still not usable, or `undefined` when it is. */
+function supplyBlocker(supply) {
+	if (supply.kind !== "crop") return void 0;
+	const min = CROP_SUPPLY_SOURCES[supply.stepId].minRootInputPx;
+	if (min === void 0) return void 0;
+	return supply.rootInputPx !== void 0 && supply.rootInputPx >= min ? void 0 : "root-input-too-small";
+}
+/**
+* THE decision. Effective = the operator intends it AND the current root
+* declares it. It never looks at, changes or clears the step's `modelId`: a
+* root that cannot supply the step leaves the step running its own model, and
+* switching back to a root that can re-activates the supply by itself.
+*/
+function resolveRootSupply(stepId, settings, rootSupplies) {
+	const supply = supplyFor(rootSupplies, stepId);
+	const intent = readUseRootModel(stepId, settings);
+	const blocker = supply === void 0 ? "root-does-not-declare" : supplyBlocker(supply);
 	return {
-		authoritative: skip,
-		skip,
-		policy,
-		openGaps
+		stepId,
+		supply,
+		intent,
+		effective: intent && blocker === void 0,
+		inactive: intent && blocker !== void 0,
+		...intent && blocker !== void 0 ? { inactiveReason: blocker } : {}
 	};
 }
+/**
+* The fine label a supplied root class becomes for a step whose supply is
+* effective, or `undefined` when the step's `enabledClasses` switched it off —
+* the detection then stays at its macro (`animal`). Empty / absent allow-list
+* = every class.
+*/
+function allowedSuppliedEffect(effect, settings) {
+	const raw = settings?.["enabledClasses"];
+	if (!Array.isArray(raw) || raw.length === 0) return true;
+	return raw.some((v) => v === effect);
+}
+/**
+* The parent a root child box belongs to: among `parents`, the SMALLEST whose
+* box holds at least {@link ROOT_CHILD_CONTAINMENT_MIN} of the child's area
+* (a plate inside the car, not inside the bus behind it). `-1` when none does
+* — the box then belongs to nobody and makes nothing.
+*/
+function containingParentIndex(child, parents) {
+	const childArea = child.w * child.h;
+	if (!(childArea > 0)) return -1;
+	let best = -1;
+	let bestArea = Number.POSITIVE_INFINITY;
+	parents.forEach((p, i) => {
+		if (Math.max(0, Math.min(child.x + child.w, p.x + p.w) - Math.max(child.x, p.x)) * Math.max(0, Math.min(child.y + child.h, p.y + p.h) - Math.max(child.y, p.y)) / childArea < .9) return;
+		const area = p.w * p.h;
+		if (area < bestArea) {
+			best = i;
+			bestArea = area;
+		}
+	});
+	return best;
+}
 var MODEL_FORMATS = [
 	"onnx",
 	"coreml",
@@ -13219,12 +13009,35 @@ var ModelLicenseSchema = preprocess((value) => typeof value === "string" ? { wei
 	/** True when the weights or their data forbid commercial use. */
 	nonCommercial: boolean().optional()
 }));
-/** One `fillsClassifierEffects` entry — see `ModelCatalogEntry.fillsClassifierEffects`. */
-var FillsClassifierEffectSchema = object({
-	stepId: _enum(FILLABLE_STEP_IDS),
+/**
+* One step a ROOT detector can supply from its own output (D730) — see
+* `ModelCatalogEntry.suppliesSteps`.
+*
+* - `label`: the root's raw class IS the step's answer. `labelToEffect` maps
+*   the root's label to the step's vocabulary; `uncovered` is the vocabulary
+*   the root cannot produce (shown as unavailable, never a blocker).
+* - `crop`: the root draws the box the step would have found (`license_plate`
+*   for plate-detection, `face` for face-detection). The box becomes a detail
+*   child of the `parentMacro` detection that contains it — never a track.
+*/
+var RootStepSupplySchema = discriminatedUnion("kind", [object({
+	kind: literal("label"),
+	stepId: _enum(LABEL_SUPPLY_STEP_IDS),
 	labelToEffect: record(string(), string()),
 	uncovered: array(string()).readonly()
-});
+}), object({
+	kind: literal("crop"),
+	stepId: _enum(CROP_SUPPLY_STEP_IDS),
+	rootLabels: array(string()).readonly(),
+	parentMacro: _enum(["vehicle", "person"]),
+	childClass: _enum(["plate", "face"]),
+	/**
+	* The root's smaller input side, stamped on read by `rootSuppliesOf` from
+	* the model entry — what a step's `minRootInputPx` gate judges. Never
+	* stored by an import.
+	*/
+	rootInputPx: number().int().positive().optional()
+})]);
 var ModelCatalogEntrySchema = object({
 	id: string(),
 	name: string(),
@@ -13351,15 +13164,15 @@ var ModelCatalogEntrySchema = 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`).
+	* The pipeline steps this ROOT detector can supply from its own output
+	* (D730): its labels name a step's effect (`deer` for `animal-classifier`)
+	* or draw a step's box (`license_plate` for `plate-detection`). Computed at
+	* import from THIS model's labelmap by `deriveRootSupplies`, never written
+	* by hand and never assumed per family; a row without it is derived on read
+	* (`rootSuppliesOf`). Whether a camera uses it is the step's own
+	* `useRootModel` flag (`resolveRootSupply`).
 	*/
-	fillsClassifierEffects: array(FillsClassifierEffectSchema).readonly().optional(),
+	suppliesSteps: array(RootStepSupplySchema).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
@@ -20855,6 +20668,373 @@ method(object({}), array(TargetKindSchema)), method(object({}), array(TargetSche
 	kind: "mutation",
 	auth: "admin"
 });
+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"
+	}
+];
+new Set([
+	{
+		id: "person",
+		name: "Person"
+	},
+	{
+		id: "vehicle",
+		name: "Vehicle"
+	},
+	{
+		id: "animal",
+		name: "Animal"
+	},
+	{
+		id: "package",
+		name: "Package"
+	}
+].map((l) => l.id));
+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
+};
 var AUDIO_MACRO_LABELS = [
 	{
 		id: "speech",
@@ -21616,6 +21796,8 @@ var NcSystemEventKindSchema = _enum([
 	"stream-offline",
 	"node-online",
 	"node-offline",
+	"node-restarting",
+	"node-updating",
 	"node-inference-unavailable",
 	"detection-blind",
 	"addon-crash-loop",
@@ -26180,6 +26362,34 @@ DeviceType.Camera, method(object({ deviceId: number() }), array(TrackSchema).rea
 	timestamp: number()
 });
 /**
+* A root model's boxes standing in for one crop-kind step's own inference
+* (D730) — see `runPipeline.suppliedRoot`.
+*/
+var SuppliedRootOutputSchema = object({
+	stepId: string(),
+	/** The root model that drew the boxes — stamped on the result. */
+	modelId: string(),
+	detections: array(object({
+		/** `[x1, y1, x2, y2]` in the pixels of the call's image. */
+		bbox: tuple([
+			number(),
+			number(),
+			number(),
+			number()
+		]),
+		score: number(),
+		/**
+		* Five facial landmarks in the same pixels — a face the step's own
+		* detector already re-found inside a root face box (D730), so its
+		* embedder child aligns it exactly as it aligns any detected face.
+		*/
+		landmarks: array(object({
+			x: number(),
+			y: number()
+		})).optional()
+	})).min(1)
+});
+/**
 * Reference to the frame's retained NATIVE surface + the parent crop's placement
 * within the frame, so the executor can re-cut a leaf child ROI at native
 * resolution on the detail plane. See the `runPipeline` `nativeCropRef` field.
@@ -26310,7 +26520,7 @@ var PipelineModelOptionSchema = object({
 	legacy: boolean().optional(),
 	provider: ModelProviderIdSchema.optional(),
 	defaultConfidence: number().optional(),
-	fillsClassifierEffects: array(FillsClassifierEffectSchema).readonly().optional()
+	suppliesSteps: array(RootStepSupplySchema).readonly().optional()
 });
 var ConfigFieldBridge = custom();
 var PipelineAddonSchemaSchema = object({
@@ -26714,7 +26924,16 @@ var pipelineExecutorCapability = {
 			* `device-not-servable`), and nothing reaches the camera's live
 			* trace stream. Absent ⇒ unchanged behaviour.
 			*/
-			replay: literal(true).optional()
+			replay: literal(true).optional(),
+			/**
+			* Root-supplied detections for the tree's ROOT step (D730). Set by
+			* `runDetailSubtree` when the camera's root model supplies a crop-kind
+			* step (a Frigate+ `license_plate` for `plate-detection`): the step is
+			* NOT inferred, these boxes are its output, and its children (the plate
+			* reader) run on them through their own crop policy. Boxes are in the
+			* PIXELS of the image this call carries. Absent ⇒ the root step runs.
+			*/
+			suppliedRoot: SuppliedRootOutputSchema.optional()
 		}), PipelineRunResultBridge, { kind: "mutation" }),
 		/**
 		* Batched run — N raw frames packed into one cap call. The provider
@@ -27987,7 +28206,22 @@ var pipelineRunnerCapability = {
 			*/
 			cropJpeg: string().optional(),
 			parent: DetailParentSchema,
-			steps: array(string()).optional()
+			steps: array(string()).optional(),
+			/**
+			* The camera's root model already drew this step's boxes (D730): a
+			* `license_plate` inside the parent vehicle. The named step is NOT
+			* inferred — these FRAME-space boxes are its output — and its
+			* requested children (the plate reader) run on them. Absent ⇒ every
+			* requested step infers as before.
+			*/
+			supplied: object({
+				stepId: string(),
+				modelId: string(),
+				boxes: array(object({
+					bbox: NativeCropBboxSchema,
+					score: number()
+				})).min(1)
+			}).optional()
 		}), object({ details: array(DetailResultSchema) }).nullable(), { kind: "mutation" }),
 		/**
 		* Run ONE enrichment step against caller-supplied pixels, with NO camera
@@ -34621,6 +34855,27 @@ var ViewerEndpointsSchema = object({
 	/** What the ranking currently resolves to (may be empty if nothing is up). */
 	resolved: array(string()).readonly()
 });
+/**
+* One audience's hub address (see `hub-address.ts`): the operator's stored
+* override, the address in use, and where it came from.
+*/
+var HubAddressSnapshotSchema = object({
+	/** The operator's override, or null for automatic. */
+	override: string().nullable(),
+	/** The address in use, or null when nothing qualifies (never loopback). */
+	resolved: string().nullable(),
+	source: _enum([
+		"override",
+		"auto",
+		"none"
+	])
+});
+var HubAddressesSchema = object({
+	/** "Hub address for agents" — agents' bundle/model pulls, LAN devices. */
+	cluster: HubAddressSnapshotSchema,
+	/** "Public address for sign-in links" — e-mail links, OIDC, WebAuthn, OAuth2. */
+	browser: HubAddressSnapshotSchema
+});
 var AllowedAddressesSchema = object({ 
 /**
 * Allowlist of interface addresses operators have explicitly opted
@@ -34667,7 +34922,13 @@ method(_void(), ListResultSchema), method(_void(), PreferredSchema), method(obje
 	*  an address notification links can be flagged with, not a hub
 	*  route. Default `false`: racers and rankers never see it. */
 	includeAppLink: boolean().optional()
-}), GetConnectionEndpointsResultSchema), method(_void(), NotificationEndpointSchema), method(object({ baseUrl: string().nullable() }), NotificationEndpointSchema, { kind: "mutation" }), method(_void(), ViewerEndpointsSchema), method(object({ baseUrls: array(string()).readonly() }), ViewerEndpointsSchema, { kind: "mutation" }), method(_void(), AllowedAddressesSchema), method(AllowedAddressesSchema, object({ success: literal(true) }), { kind: "mutation" }), method(_void(), AllowedAddressesSchema, { kind: "mutation" }), method(_void(), TlsStatusSchema), method(object({ reason: string().optional() }), TlsStatusSchema, {
+}), GetConnectionEndpointsResultSchema), method(_void(), NotificationEndpointSchema), method(object({ baseUrl: string().nullable() }), NotificationEndpointSchema, { kind: "mutation" }), method(_void(), ViewerEndpointsSchema), method(object({ baseUrls: array(string()).readonly() }), ViewerEndpointsSchema, { kind: "mutation" }), method(_void(), HubAddressesSchema), method(object({
+	audience: _enum(["cluster", "browser"]),
+	baseUrl: string().nullable()
+}), HubAddressesSchema, {
+	kind: "mutation",
+	auth: "admin"
+}), method(_void(), AllowedAddressesSchema), method(AllowedAddressesSchema, object({ success: literal(true) }), { kind: "mutation" }), method(_void(), AllowedAddressesSchema, { kind: "mutation" }), method(_void(), TlsStatusSchema), method(object({ reason: string().optional() }), TlsStatusSchema, {
 	kind: "mutation",
 	auth: "admin"
 }), method(object({
@@ -35057,7 +35318,8 @@ object({
 	*   writes this slice (not even a boot seed), and neither does the runner's
 	*   phase machine: its phase is "a session is attached" for every on-motion
 	*   session, not motion, and it now has its own `DetectionPhaseTransition`.
-	*   A provider's `isDetected` answers from the hub's slice.
+	*   A provider's `isDetected` and `getStatus` answer from the hub's slice
+	*   (`hubMotionNativeProvider`).
 	* - **Sensors** (Home Assistant binary sensors, Homematic, Matter, Alexa
 	*   imports) — the provider pushes both edges itself, from the upstream
 	*   system's own state change. That is the sensor's own fact.
@@ -43673,6 +43935,12 @@ Object.freeze({
 		addonId: null,
 		access: "view"
 	},
+	"localNetwork.getHubAddresses": {
+		capName: "local-network",
+		capScope: "system",
+		addonId: null,
+		access: "view"
+	},
 	"localNetwork.getNotificationEndpoint": {
 		capName: "local-network",
 		capScope: "system",
@@ -43727,6 +43995,12 @@ Object.freeze({
 		addonId: null,
 		access: "create"
 	},
+	"localNetwork.setHubAddress": {
+		capName: "local-network",
+		capScope: "system",
+		addonId: null,
+		access: "create"
+	},
 	"localNetwork.setNotificationEndpoint": {
 		capName: "local-network",
 		capScope: "system",
@@ -52176,6 +52450,8 @@ new Map(Object.entries({
 	"detection-blind": "device-events",
 	"node-online": "system",
 	"node-offline": "system",
+	"node-restarting": "system",
+	"node-updating": "system",
 	"node-inference-unavailable": "system",
 	"addon-crash-loop": "system",
 	"addon-update-available": "system",
@@ -52253,6 +52529,7 @@ var NC_SYSTEM_EVENT_KIND_GROUP_SPECS = [
 		kinds: [
 			"node-offline",
 			"node-online",
+			"node-restarting",
 			"node-inference-unavailable"
 		]
 	},
@@ -52274,6 +52551,7 @@ var NC_SYSTEM_EVENT_KIND_GROUP_SPECS = [
 		label: "Server & container updates",
 		kinds: [
 			"server-update-available",
+			"node-updating",
 			"server-updated",
 			"wrapper-update-available"
 		]
@@ -52421,6 +52699,7 @@ var STATE_SUMMARY_SECTION_VARS = [
 		kinds: [
 			"node-offline",
 			"node-online",
+			"node-restarting",
 			"node-inference-unavailable"
 		]
 	},
@@ -52442,6 +52721,7 @@ var STATE_SUMMARY_SECTION_VARS = [
 		example: "server 1.2.377 → 1.2.378",
 		kinds: [
 			"server-update-available",
+			"node-updating",
 			"server-updated",
 			"wrapper-update-available"
 		]
@@ -52474,7 +52754,7 @@ var STATE_SUMMARY_VARS = [
 	{
 		name: "summarySection",
 		label: "Summary: this section",
-		description: "The section a per-section summary row is about (D698); on a summary sent as one message, every section it reports, comma-separated.",
+		description: "The section a per-section summary row is about; on a summary sent as one message, every section it reports, comma-separated.",
 		example: "Batterie scariche",
 		group: "system",
 		families: ["rule"],
@@ -52916,6 +53196,24 @@ function stepModelRunsOnFormat(models, modelId, format) {
 	}
 	return models.some((m) => m.legacy !== true && hasBuild(m, format));
 }
+/** Side of the square, as a multiple of the face box's longer side. */
+var ROOT_FACE_REFINE_SCALE = 1.6;
+/**
+* The square (frame-space pixels) a root face box is refined in: centred on
+* the box, side `ROOT_FACE_REFINE_SCALE ×` its longer side, slid inside the
+* frame, and shrunk only when the frame's shorter side is smaller. Pure.
+*/
+function deriveRootFaceRefineRect(face, frameWidth, frameHeight) {
+	const side = Math.min(Math.max(face.w, face.h) * ROOT_FACE_REFINE_SCALE, Math.min(frameWidth, frameHeight));
+	const cx = face.x + face.w / 2;
+	const cy = face.y + face.h / 2;
+	return {
+		x: Math.min(Math.max(0, cx - side / 2), frameWidth - side),
+		y: Math.min(Math.max(0, cy - side / 2), frameHeight - side),
+		w: side,
+		h: side
+	};
+}
 var DETAIL_CROP_PADDING_KEY = "detailCropPaddingRatio";
 var DETAIL_CROP_SQUARE_KEY = "detailCropSquare";
 /**
@@ -54218,6 +54516,12 @@ Object.defineProperty(exports, "COCO_TO_MACRO", {
 		return COCO_TO_MACRO;
 	}
 });
+Object.defineProperty(exports, "CROP_SUPPLY_SOURCES", {
+	enumerable: true,
+	get: function() {
+		return CROP_SUPPLY_SOURCES;
+	}
+});
 Object.defineProperty(exports, "CamProfileSchema", {
 	enumerable: true,
 	get: function() {
@@ -54254,12 +54558,6 @@ Object.defineProperty(exports, "DEFAULT_FIRST_SIGHTING_FRESHNESS_MS", {
 		return DEFAULT_FIRST_SIGHTING_FRESHNESS_MS;
 	}
 });
-Object.defineProperty(exports, "DEFAULT_LABEL_LINK_POLICY", {
-	enumerable: true,
-	get: function() {
-		return DEFAULT_LABEL_LINK_POLICY;
-	}
-});
 Object.defineProperty(exports, "DEFAULT_NATIVE_LEASE_SETTINGS", {
 	enumerable: true,
 	get: function() {
@@ -54314,18 +54612,6 @@ Object.defineProperty(exports, "ExportRecordSchema", {
 		return ExportRecordSchema;
 	}
 });
-Object.defineProperty(exports, "FILLABLE_STEP_MACRO", {
-	enumerable: true,
-	get: function() {
-		return FILLABLE_STEP_MACRO;
-	}
-});
-Object.defineProperty(exports, "FILLABLE_STEP_VOCABULARIES", {
-	enumerable: true,
-	get: function() {
-		return FILLABLE_STEP_VOCABULARIES;
-	}
-});
 Object.defineProperty(exports, "FailureCounters", {
 	enumerable: true,
 	get: function() {
@@ -54350,16 +54636,16 @@ Object.defineProperty(exports, "HF_BASE_URL", {
 		return HF_BASE_URL;
 	}
 });
-Object.defineProperty(exports, "LABEL_LINK_POLICIES", {
+Object.defineProperty(exports, "LABEL_SUPPLY_MACRO", {
 	enumerable: true,
 	get: function() {
-		return LABEL_LINK_POLICIES;
+		return LABEL_SUPPLY_MACRO;
 	}
 });
-Object.defineProperty(exports, "LABEL_LINK_SETTING_KEY", {
+Object.defineProperty(exports, "LABEL_SUPPLY_VOCABULARIES", {
 	enumerable: true,
 	get: function() {
-		return LABEL_LINK_SETTING_KEY;
+		return LABEL_SUPPLY_VOCABULARIES;
 	}
 });
 Object.defineProperty(exports, "NativeLeaseAdmissionSchema", {
@@ -54416,6 +54702,12 @@ Object.defineProperty(exports, "RECORDING_SOURCE_CAMSTACK_ADDON", {
 		return RECORDING_SOURCE_CAMSTACK_ADDON;
 	}
 });
+Object.defineProperty(exports, "ROOT_SUPPLIABLE_STEP_IDS", {
+	enumerable: true,
+	get: function() {
+		return ROOT_SUPPLIABLE_STEP_IDS;
+	}
+});
 Object.defineProperty(exports, "RecordingConfigSchema", {
 	enumerable: true,
 	get: function() {
@@ -54464,6 +54756,12 @@ Object.defineProperty(exports, "addonWidgetsSourceCapability", {
 		return addonWidgetsSourceCapability;
 	}
 });
+Object.defineProperty(exports, "allowedSuppliedEffect", {
+	enumerable: true,
+	get: function() {
+		return allowedSuppliedEffect;
+	}
+});
 Object.defineProperty(exports, "array", {
 	enumerable: true,
 	get: function() {
@@ -54536,6 +54834,12 @@ Object.defineProperty(exports, "clipExportFailureOf", {
 		return clipExportFailureOf;
 	}
 });
+Object.defineProperty(exports, "containingParentIndex", {
+	enumerable: true,
+	get: function() {
+		return containingParentIndex;
+	}
+});
 Object.defineProperty(exports, "createEvent", {
 	enumerable: true,
 	get: function() {
@@ -54596,6 +54900,12 @@ Object.defineProperty(exports, "deriveRecordingMode", {
 		return deriveRecordingMode;
 	}
 });
+Object.defineProperty(exports, "deriveRootFaceRefineRect", {
+	enumerable: true,
+	get: function() {
+		return deriveRootFaceRefineRect;
+	}
+});
 Object.defineProperty(exports, "detectionPipelineCapability", {
 	enumerable: true,
 	get: function() {
@@ -54968,12 +55278,6 @@ Object.defineProperty(exports, "resolveEgressDecodeHwAccel", {
 		return resolveEgressDecodeHwAccel;
 	}
 });
-Object.defineProperty(exports, "resolveLabelLink", {
-	enumerable: true,
-	get: function() {
-		return resolveLabelLink;
-	}
-});
 Object.defineProperty(exports, "resolveLocationMode", {
 	enumerable: true,
 	get: function() {
@@ -54992,6 +55296,18 @@ Object.defineProperty(exports, "resolveRecordingProfiles", {
 		return resolveRecordingProfiles;
 	}
 });
+Object.defineProperty(exports, "resolveRootSupply", {
+	enumerable: true,
+	get: function() {
+		return resolveRootSupply;
+	}
+});
+Object.defineProperty(exports, "rootSuppliesOf", {
+	enumerable: true,
+	get: function() {
+		return rootSuppliesOf;
+	}
+});
 Object.defineProperty(exports, "runtimeDevices", {
 	enumerable: true,
 	get: function() {