@camstack/types 1.2.40 → 1.2.41

package/dist/capabilities/pipeline-analytics.cap.d.ts

@@ -1664,8 +1664,6 @@ export declare const pipelineAnalyticsCapability: {
             deviceId: z.ZodOptional<z.ZodNumber>;
             since: z.ZodOptional<z.ZodNumber>;
             until: z.ZodOptional<z.ZodNumber>;
-            cropMargin: z.ZodOptional<z.ZodNumber>;
-            square: z.ZodOptional<z.ZodBoolean>;
             maxTracks: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strip>, z.ZodObject<{
             started: z.ZodBoolean;
@@ -1677,6 +1675,7 @@ export declare const pipelineAnalyticsCapability: {
             rebuilt: z.ZodNumber;
             missingKeyFrame: z.ZodNumber;
             missingBbox: z.ZodNumber;
+            notRunnable: z.ZodNumber;
             failed: z.ZodNumber;
             complete: z.ZodNullable<z.ZodBoolean>;
             startedAtMs: z.ZodNullable<z.ZodNumber>;

package/dist/capabilities/pipeline-runner.cap.d.ts

@@ -533,12 +533,29 @@ export declare const pipelineRunnerCapability: {
          * for a single tracked detection. The per-frame plane (`runPipeline`
          * with `plane: 'frame'`) skips crop children entirely; a track-level
          * caller invokes this per-track, on its own cadence, instead of on
-         * every frame. Takes either a `frameHandle` (shm lease/session —
-         * preferred, zero-copy) or a `cropJpeg` fallback when the lease/
-         * session backing the frame is already gone. `steps` narrows which
-         * configured children to run (default: all configured children for
-         * `parent.className`). Returns `null` when neither frame source is
-         * resolvable (handle evicted and no cropJpeg fallback supplied).
+         * every frame. `steps` narrows which configured children to run
+         * (default: all configured children for `parent.className`).
+         *
+         * ## Three pixel sources, and WHO decides the rectangle
+         *
+         * Tried in this order; the difference between them is not the pixels but
+         * which side derives the crop, and confusing the two is how the CLIP index
+         * ended up holding two incomparable feature spaces:
+         *
+         * 1. `frameHandle` — shm lease/session, preferred and zero-copy. **The
+         *    runner cuts**, applying the cluster crop convention.
+         * 2. `frameJpeg` — a FULL FRAME supplied by the caller (the embedding
+         *    rebuild's stored key frame). **The runner cuts**, applying the same
+         *    convention to the same function, so a rebuilt vector lands in the same
+         *    feature space as a live one.
+         * 3. `cropJpeg` — an ALREADY-CUT tile. **The caller decided the
+         *    rectangle**; the runner applies NO padding and no squaring and feeds
+         *    it to the model verbatim. Only for the lease-miss retry, where the
+         *    caller holds pixels the runner can no longer reach.
+         *
+         * Returns `null` when no source resolves (handle evicted and no fallback
+         * supplied), when the camera is not attached, or when no enabled step
+         * matches — every one of those is logged on the runner with the deviceId.
          */
         readonly runDetailSubtree: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
             deviceId: z.ZodNumber;
@@ -560,6 +577,7 @@ export declare const pipelineRunnerCapability: {
                 nodeId: z.ZodString;
                 slotCount: z.ZodNumber;
             }, z.core.$strip>>;
+            frameJpeg: z.ZodOptional<z.ZodString>;
             cropJpeg: z.ZodOptional<z.ZodString>;
             parent: z.ZodObject<{
                 bbox: z.ZodObject<{

package/dist/generated/addon-api.d.ts

@@ -8274,14 +8274,14 @@ export type AppRouter = TrpcCoreRouter<{
     }, import("@trpc/server").TRPCDecorateCreateRouterOptions<{
         listCapabilities: import("@trpc/server").TRPCQueryProcedure<{
             input: void;
-            output: import("packages/types/dist").CapabilityInfo[];
+            output: import("@camstack/types").CapabilityInfo[];
             meta: object;
         }>;
         getCapability: import("@trpc/server").TRPCQueryProcedure<{
             input: {
                 name: string;
             };
-            output: import("packages/types/dist").CapabilityInfo | null;
+            output: import("@camstack/types").CapabilityInfo | null;
             meta: object;
         }>;
         setActiveSingleton: import("@trpc/server").TRPCMutationProcedure<{
@@ -8353,14 +8353,14 @@ export type AppRouter = TrpcCoreRouter<{
     }>> & import("@trpc/server").TRPCDecorateCreateRouterOptions<{
         listCapabilities: import("@trpc/server").TRPCQueryProcedure<{
             input: void;
-            output: import("packages/types/dist").CapabilityInfo[];
+            output: import("@camstack/types").CapabilityInfo[];
             meta: object;
         }>;
         getCapability: import("@trpc/server").TRPCQueryProcedure<{
             input: {
                 name: string;
             };
-            output: import("packages/types/dist").CapabilityInfo | null;
+            output: import("@camstack/types").CapabilityInfo | null;
             meta: object;
         }>;
         setActiveSingleton: import("@trpc/server").TRPCMutationProcedure<{

package/dist/index.d.ts

@@ -198,6 +198,7 @@ export { BACKEND_TO_FORMAT, DEVICE_BACKEND_TO_FORMAT, deviceBackendToFormat, for
 export { sleep, sleepCancellable } from './utils/sleep.js';
 export { decodeVectorBase64, encodeVectorBase64, vectorDimFromBase64, } from './utils/vector-codec.js';
 export { evaluateZoneRules, type ZoneRuleEvalResult } from './utils/zone-rule-eval.js';
+export { DEFAULT_DETAIL_CROP_CONVENTION, DETAIL_CROP_PADDING_FIELD, DETAIL_CROP_PADDING_KEY, DETAIL_CROP_SECTION_ID, DETAIL_CROP_SQUARE_KEY, type DetailCropConvention, DetailCropConventionSchema, type DetailCropRect, deriveDetailCropRect, type HydratedSettingsSection, type HydratedSettingsView, pickDetailCropConvention, readDetailCropConvention, } from './pipeline/detail-crop.js';
 export { bindAddonActions } from './helpers/bind-addon-actions.js';
 export type { DeviceOption, InferenceDeviceDescriptor, RuntimeId, } from './inference/runtime-capabilities.js';
 export { defaultDeviceFor, enumerateInferenceDevices, modelFormatForRuntime, runtimeDevices, scoreRuntimes, supportedRuntimes, } from './inference/runtime-capabilities.js';

package/dist/index.js

@@ -11721,14 +11721,6 @@ var RebuildObjectEmbeddingsInput = zod.z.object({
 	deviceId: zod.z.number().optional(),
 	since: zod.z.number().optional(),
 	until: zod.z.number().optional(),
-	/**
-	* Fraction added on EACH side of the detection box before cropping.
-	* ~0.2 (a 1.4x window) gives CLIP the surroundings it is trained on; 0 is
-	* the pixel-tight crop the first implementation used.
-	*/
-	cropMargin: zod.z.number().min(0).max(4).optional(),
-	/** Square the window before extracting, so a tall subject is not squashed. */
-	square: zod.z.boolean().optional(),
 	/** Stop after this many tracks; the result reports whether more remain. */
 	maxTracks: zod.z.number().int().positive().optional()
 });
@@ -11763,6 +11755,14 @@ var RebuildStatusSchema = zod.z.object({
 	missingKeyFrame: zod.z.number(),
 	/** Tracks with no usable detection box. */
 	missingBbox: zod.z.number(),
+	/**
+	* Tracks the pipeline REFUSED rather than broke on: the camera is not
+	* attached, or `clip-embedding` is not enabled in its step tree. Separate
+	* from `failed` because the remedy is a configuration change, not an engine
+	* investigation — and because a pass over decommissioned cameras would
+	* otherwise read as a total engine outage.
+	*/
+	notRunnable: zod.z.number(),
 	failed: zod.z.number(),
 	/** Set once a pass ends: true only when EVERYTHING was covered. */
 	complete: zod.z.boolean().nullable(),
@@ -13382,16 +13382,44 @@ var pipelineRunnerCapability = {
 		* for a single tracked detection. The per-frame plane (`runPipeline`
 		* with `plane: 'frame'`) skips crop children entirely; a track-level
 		* caller invokes this per-track, on its own cadence, instead of on
-		* every frame. Takes either a `frameHandle` (shm lease/session —
-		* preferred, zero-copy) or a `cropJpeg` fallback when the lease/
-		* session backing the frame is already gone. `steps` narrows which
-		* configured children to run (default: all configured children for
-		* `parent.className`). Returns `null` when neither frame source is
-		* resolvable (handle evicted and no cropJpeg fallback supplied).
+		* every frame. `steps` narrows which configured children to run
+		* (default: all configured children for `parent.className`).
+		*
+		* ## Three pixel sources, and WHO decides the rectangle
+		*
+		* Tried in this order; the difference between them is not the pixels but
+		* which side derives the crop, and confusing the two is how the CLIP index
+		* ended up holding two incomparable feature spaces:
+		*
+		* 1. `frameHandle` — shm lease/session, preferred and zero-copy. **The
+		*    runner cuts**, applying the cluster crop convention.
+		* 2. `frameJpeg` — a FULL FRAME supplied by the caller (the embedding
+		*    rebuild's stored key frame). **The runner cuts**, applying the same
+		*    convention to the same function, so a rebuilt vector lands in the same
+		*    feature space as a live one.
+		* 3. `cropJpeg` — an ALREADY-CUT tile. **The caller decided the
+		*    rectangle**; the runner applies NO padding and no squaring and feeds
+		*    it to the model verbatim. Only for the lease-miss retry, where the
+		*    caller holds pixels the runner can no longer reach.
+		*
+		* Returns `null` when no source resolves (handle evicted and no fallback
+		* supplied), when the camera is not attached, or when no enabled step
+		* matches — every one of those is logged on the runner with the deviceId.
 		*/
 		runDetailSubtree: require_sleep.method(zod.z.object({
 			deviceId: zod.z.number(),
 			frameHandle: require_sleep.FrameHandleSchema.optional(),
+			/**
+			* FULL FRAME (base64 JPEG). The runner derives the crop rectangle from
+			* `parent.bbox` with the cluster crop convention and cuts it itself —
+			* do NOT pre-crop for this field, that is what `cropJpeg` is.
+			*/
+			frameJpeg: zod.z.string().optional(),
+			/**
+			* PRE-CUT tile (base64 JPEG), used verbatim — NO padding is applied.
+			* The fallback when the lease/session backing the frame is gone and the
+			* caller already holds a crop.
+			*/
 			cropJpeg: zod.z.string().optional(),
 			parent: DetailParentSchema,
 			steps: zod.z.array(zod.z.string()).optional()
@@ -34881,6 +34909,202 @@ function pointInPolygon(point, polygon) {
 	return inside;
 }
 //#endregion
+//#region src/pipeline/detail-crop.ts
+/**
+* THE detail-crop convention — the single derivation of the rectangle a
+* detail/enrichment step (clip-embedding, face-detection, plate-detection…)
+* is fed.
+*
+* ## Why this is one module and not two constants
+*
+* `object-clip` is ONE vector index, and cosine similarity is only meaningful
+* between vectors produced from the same crop convention. Two encode paths
+* write into it — the live detail plane and the embedding rebuild — and they
+* used to derive their crops independently: `DETAIL_CROP_PADDING_RATIO = 0.15`
+* with no squaring on one side, `DEFAULT_CROP_MARGIN = 0.2` with squaring on
+* by default on the other. Every rebuild therefore poured a second, silently
+* incomparable feature space into the index it exists to keep consistent.
+*
+* So the rectangle is derived HERE, once, from ONE convention value. Both
+* paths now reach this function through `pipelineRunner.runDetailSubtree` —
+* the runner is the only process that cuts (see `detail-subtree.ts`), and the
+* convention is a cluster-global `pipeline-orchestrator` setting. There is
+* deliberately no per-node or per-device scope: a per-accelerator crop margin
+* would reintroduce the same split, merely relocated.
+*
+* ## The default IS the live convention
+*
+* {@link DEFAULT_DETAIL_CROP_CONVENTION} reproduces what the live path has
+* been storing (0.15, no squaring). Anything else would invalidate every
+* vector already in the index on the day it shipped. Changing the convention
+* is legitimate — that is what the operator knob is for — but it must be
+* followed by a rebuild, which is now guaranteed to produce crops from this
+* same function.
+*/
+/**
+* Store identity of the convention in `pipeline-orchestrator`'s GLOBAL
+* (cluster-wide) settings.
+*
+* These live here rather than in the orchestrator because the reader is a
+* different addon — the pipeline runner, over the hub-routed `addon-settings`
+* cap. Addons never import each other, so a key owned by the writer would have
+* to be hand-copied by the reader, and a hand-copied key is how a setting
+* silently stops arriving while both sides still look correct.
+*/
+var DETAIL_CROP_SECTION_ID = "detail-crop";
+var DETAIL_CROP_PADDING_KEY = "detailCropPaddingRatio";
+var DETAIL_CROP_SQUARE_KEY = "detailCropSquare";
+/**
+* Operator-tunable crop convention. Single-valued and cluster-wide — see the
+* module docblock for why it cannot be scoped per node or per device.
+*/
+var DetailCropConventionSchema = zod.z.object({
+	/**
+	* Fraction of the box's own size added on EACH side before cutting.
+	*
+	* CLIP is trained on natural images WITH surroundings; a pixel-tight crop
+	* removes exactly the context it is strongest on (a dog cut to its outline
+	* is a dark blob). The right value is an empirical question, which is why it
+	* is a setting: 0 / 0.15 / 0.2 / 0.5 are the interesting points.
+	*/
+	paddingRatio: zod.z.number().min(0).max(4),
+	/**
+	* Square the window (in PIXELS) before cutting.
+	*
+	* CLIP's input is square, so a tall bbox resized straight to NxN is squashed
+	* — a standing person becomes a shape the model never saw. Squaring costs
+	* extra background, which is context the model wants anyway. Off by default
+	* because the live path has never squared and the stored index reflects that.
+	*/
+	square: zod.z.boolean()
+});
+/**
+* The convention in force when nobody has configured one — byte-for-byte the
+* behaviour of the pre-unification LIVE path (`DETAIL_CROP_PADDING_RATIO`).
+*/
+var DEFAULT_DETAIL_CROP_CONVENTION = {
+	paddingRatio: .15,
+	square: false
+};
+/**
+* Narrow a FLAT settings record to the convention.
+*
+* Per-FIELD fallback, deliberately: a junk padding must not also discard a
+* valid squaring choice. An absent or invalid value resolves to
+* {@link DEFAULT_DETAIL_CROP_CONVENTION} — the historical live behaviour —
+* rather than to a clamped number nobody chose, so a bad read can never
+* quietly change what the stored vectors mean.
+*/
+function readDetailCropConvention(config) {
+	const paddingRatio = DetailCropConventionSchema.shape.paddingRatio.safeParse(config[DETAIL_CROP_PADDING_KEY]);
+	const square = DetailCropConventionSchema.shape.square.safeParse(config[DETAIL_CROP_SQUARE_KEY]);
+	return {
+		paddingRatio: paddingRatio.success ? paddingRatio.data : DEFAULT_DETAIL_CROP_CONVENTION.paddingRatio,
+		square: square.success ? square.data : DEFAULT_DETAIL_CROP_CONVENTION.square
+	};
+}
+function isHydratedField(entry) {
+	return typeof entry === "object" && entry !== null && "key" in entry;
+}
+/**
+* Extract the convention from an `addon-settings.getGlobalSettings` payload.
+*
+* Walks EVERY section rather than looking inside {@link DETAIL_CROP_SECTION_ID}
+* alone: the keys are unique across the addon's schema, and a section rename
+* must not silently revert the whole cluster to the default. A `null` payload
+* (addon mid-boot) is the default convention.
+*/
+function pickDetailCropConvention(view) {
+	if (view === null) return DEFAULT_DETAIL_CROP_CONVENTION;
+	const flat = {};
+	for (const section of view.sections) for (const entry of section.fields) {
+		if (!isHydratedField(entry) || typeof entry.key !== "string") continue;
+		if (entry.key === "detailCropPaddingRatio" || entry.key === "detailCropSquare") flat[entry.key] = entry.value;
+	}
+	return readDetailCropConvention(flat);
+}
+/** Slider bounds for the operator-facing padding knob (orchestrator settings UI). */
+var DETAIL_CROP_PADDING_FIELD = {
+	min: 0,
+	max: 1,
+	step: .05,
+	default: DEFAULT_DETAIL_CROP_CONVENTION.paddingRatio
+};
+/**
+* Derive the crop rectangle for one parent detection.
+*
+* Order: pad by `paddingRatio` of the box's own size → optionally square in
+* pixel space around the padded centre → keep it inside the frame. Pure:
+* always returns a new rect and never mutates `bbox`.
+*
+* Edge handling differs by mode, on purpose:
+*
+* - **unsquared** — TRUNCATED at the frame border, byte-for-byte what the live
+*   path has always done (`padAndClampFrameBbox`). A subject against the edge
+*   gets a slightly smaller window. Changing this would silently reinterpret
+*   every edge-touching vector already in the index.
+* - **squared** — SLID inward instead, because a truncated square is not
+*   square and squaring exists precisely to preserve the aspect the model
+*   sees. It only shrinks when the square is larger than the frame itself.
+*/
+function deriveDetailCropRect(bbox, frameWidth, frameHeight, convention) {
+	const padX = convention.paddingRatio * bbox.w;
+	const padY = convention.paddingRatio * bbox.h;
+	const padded = {
+		x: bbox.x - padX,
+		y: bbox.y - padY,
+		w: bbox.w + 2 * padX,
+		h: bbox.h + 2 * padY
+	};
+	return convention.square ? slideInsideFrame(squareInPixels(padded, frameWidth, frameHeight), frameWidth, frameHeight) : truncateToFrame(padded, frameWidth, frameHeight);
+}
+/**
+* Grow the shorter side to the longer one around the window's centre, bounded
+* by the frame's shorter side — a square larger than the frame cannot exist,
+* and collapsing to the frame's short side is the most that does.
+*/
+function squareInPixels(rect, frameWidth, frameHeight) {
+	const side = Math.min(Math.max(rect.w, rect.h), Math.min(frameWidth, frameHeight));
+	const cx = rect.x + rect.w / 2;
+	const cy = rect.y + rect.h / 2;
+	return {
+		x: cx - side / 2,
+		y: cy - side / 2,
+		w: side,
+		h: side
+	};
+}
+/**
+* Cut the window at the frame border — the pre-unification live behaviour,
+* preserved exactly so unsquared crops keep matching the stored index.
+*/
+function truncateToFrame(rect, frameWidth, frameHeight) {
+	const x1 = Math.max(0, rect.x);
+	const y1 = Math.max(0, rect.y);
+	const x2 = Math.min(frameWidth, rect.x + rect.w);
+	const y2 = Math.min(frameHeight, rect.y + rect.h);
+	return {
+		x: x1,
+		y: y1,
+		w: Math.max(0, x2 - x1),
+		h: Math.max(0, y2 - y1)
+	};
+}
+/**
+* Move the window inside the frame keeping its extent — used only for squared
+* windows, where truncating would destroy the squareness that is the point.
+*/
+function slideInsideFrame(rect, frameWidth, frameHeight) {
+	const w = Math.max(0, Math.min(rect.w, frameWidth));
+	const h = Math.max(0, Math.min(rect.h, frameHeight));
+	return {
+		x: Math.min(Math.max(0, rect.x), Math.max(0, frameWidth - w)),
+		y: Math.min(Math.max(0, rect.y), Math.max(0, frameHeight - h)),
+		w,
+		h
+	};
+}
+//#endregion
 //#region src/helpers/bind-addon-actions.ts
 /**
 * Bind an addon's custom-action catalog to its tRPC surface, returning a
@@ -35300,10 +35524,15 @@ exports.DATAPLANE_SECRET_HEADER = require_sleep.DATAPLANE_SECRET_HEADER;
 exports.DEFAULT_ADDON_PLACEMENT = DEFAULT_ADDON_PLACEMENT;
 exports.DEFAULT_AUDIO_ANALYZER_CONFIG = DEFAULT_AUDIO_ANALYZER_CONFIG;
 exports.DEFAULT_DECODER_HWACCEL_CONFIG = DEFAULT_DECODER_HWACCEL_CONFIG;
+exports.DEFAULT_DETAIL_CROP_CONVENTION = DEFAULT_DETAIL_CROP_CONVENTION;
 exports.DEFAULT_EVENT_COLOR = DEFAULT_EVENT_COLOR;
 exports.DEFAULT_FEATURES = DEFAULT_FEATURES;
 exports.DEFAULT_RETENTION = DEFAULT_RETENTION;
 exports.DEFAULT_SCRUB_THUMBNAIL_PRESET = DEFAULT_SCRUB_THUMBNAIL_PRESET;
+exports.DETAIL_CROP_PADDING_FIELD = DETAIL_CROP_PADDING_FIELD;
+exports.DETAIL_CROP_PADDING_KEY = DETAIL_CROP_PADDING_KEY;
+exports.DETAIL_CROP_SECTION_ID = DETAIL_CROP_SECTION_ID;
+exports.DETAIL_CROP_SQUARE_KEY = DETAIL_CROP_SQUARE_KEY;
 exports.DEVICE_BACKEND_TO_FORMAT = DEVICE_BACKEND_TO_FORMAT;
 exports.DEVICE_CAP_NAMES = DEVICE_CAP_NAMES;
 exports.DEVICE_PROFILES = DEVICE_PROFILES;
@@ -35323,6 +35552,7 @@ exports.DecodedFrameSchema = require_sleep.DecodedFrameSchema;
 exports.DecoderSessionConfigSchema = DecoderSessionConfigSchema;
 exports.DecoderStatsSchema = DecoderStatsSchema;
 exports.DeleteIntegrationResultSchema = DeleteIntegrationResultSchema;
+exports.DetailCropConventionSchema = DetailCropConventionSchema;
 exports.DetectionSourceSchema = DetectionSourceSchema;
 exports.DeviceCodeSeveritySchema = DeviceCodeSeveritySchema;
 exports.DeviceConfig = DeviceConfig;
@@ -35915,6 +36145,7 @@ exports.decodeVectorBase64 = decodeVectorBase64;
 exports.decoderCapability = decoderCapability;
 exports.defaultDeviceFor = defaultDeviceFor;
 exports.defineCustomActions = defineCustomActions;
+exports.deriveDetailCropRect = deriveDetailCropRect;
 exports.deriveRecordingMode = deriveRecordingMode;
 exports.describeModelVariant = describeModelVariant;
 exports.detectionPipelineCapability = detectionPipelineCapability;
@@ -36042,6 +36273,7 @@ exports.parseProfileBrokerId = require_sleep.parseProfileBrokerId;
 exports.parseStreamParamsFormPatch = parseStreamParamsFormPatch;
 exports.petFeederCapability = petFeederCapability;
 exports.pickAccessoryControl = pickAccessoryControl;
+exports.pickDetailCropConvention = pickDetailCropConvention;
 exports.pickPreferredRtspEntry = pickPreferredRtspEntry;
 exports.pickerForCondition = pickerForCondition;
 exports.pipelineAnalyticsCapability = pipelineAnalyticsCapability;
@@ -36059,6 +36291,7 @@ exports.procedureAuthKey = procedureAuthKey;
 exports.ptzAutotrackCapability = ptzAutotrackCapability;
 exports.ptzCapability = ptzCapability;
 exports.pythonScriptForBackend = pythonScriptForBackend;
+exports.readDetailCropConvention = readDetailCropConvention;
 exports.readDeviceStateFrom = readDeviceStateFrom;
 exports.readNodePin = require_sleep.readNodePin;
 exports.readinessKey = require_sleep.readinessKey;

package/dist/index.mjs

@@ -11720,14 +11720,6 @@ var RebuildObjectEmbeddingsInput = z.object({
 	deviceId: z.number().optional(),
 	since: z.number().optional(),
 	until: z.number().optional(),
-	/**
-	* Fraction added on EACH side of the detection box before cropping.
-	* ~0.2 (a 1.4x window) gives CLIP the surroundings it is trained on; 0 is
-	* the pixel-tight crop the first implementation used.
-	*/
-	cropMargin: z.number().min(0).max(4).optional(),
-	/** Square the window before extracting, so a tall subject is not squashed. */
-	square: z.boolean().optional(),
 	/** Stop after this many tracks; the result reports whether more remain. */
 	maxTracks: z.number().int().positive().optional()
 });
@@ -11762,6 +11754,14 @@ var RebuildStatusSchema = z.object({
 	missingKeyFrame: z.number(),
 	/** Tracks with no usable detection box. */
 	missingBbox: z.number(),
+	/**
+	* Tracks the pipeline REFUSED rather than broke on: the camera is not
+	* attached, or `clip-embedding` is not enabled in its step tree. Separate
+	* from `failed` because the remedy is a configuration change, not an engine
+	* investigation — and because a pass over decommissioned cameras would
+	* otherwise read as a total engine outage.
+	*/
+	notRunnable: z.number(),
 	failed: z.number(),
 	/** Set once a pass ends: true only when EVERYTHING was covered. */
 	complete: z.boolean().nullable(),
@@ -13381,16 +13381,44 @@ var pipelineRunnerCapability = {
 		* for a single tracked detection. The per-frame plane (`runPipeline`
 		* with `plane: 'frame'`) skips crop children entirely; a track-level
 		* caller invokes this per-track, on its own cadence, instead of on
-		* every frame. Takes either a `frameHandle` (shm lease/session —
-		* preferred, zero-copy) or a `cropJpeg` fallback when the lease/
-		* session backing the frame is already gone. `steps` narrows which
-		* configured children to run (default: all configured children for
-		* `parent.className`). Returns `null` when neither frame source is
-		* resolvable (handle evicted and no cropJpeg fallback supplied).
+		* every frame. `steps` narrows which configured children to run
+		* (default: all configured children for `parent.className`).
+		*
+		* ## Three pixel sources, and WHO decides the rectangle
+		*
+		* Tried in this order; the difference between them is not the pixels but
+		* which side derives the crop, and confusing the two is how the CLIP index
+		* ended up holding two incomparable feature spaces:
+		*
+		* 1. `frameHandle` — shm lease/session, preferred and zero-copy. **The
+		*    runner cuts**, applying the cluster crop convention.
+		* 2. `frameJpeg` — a FULL FRAME supplied by the caller (the embedding
+		*    rebuild's stored key frame). **The runner cuts**, applying the same
+		*    convention to the same function, so a rebuilt vector lands in the same
+		*    feature space as a live one.
+		* 3. `cropJpeg` — an ALREADY-CUT tile. **The caller decided the
+		*    rectangle**; the runner applies NO padding and no squaring and feeds
+		*    it to the model verbatim. Only for the lease-miss retry, where the
+		*    caller holds pixels the runner can no longer reach.
+		*
+		* Returns `null` when no source resolves (handle evicted and no fallback
+		* supplied), when the camera is not attached, or when no enabled step
+		* matches — every one of those is logged on the runner with the deviceId.
 		*/
 		runDetailSubtree: method(z.object({
 			deviceId: z.number(),
 			frameHandle: FrameHandleSchema.optional(),
+			/**
+			* FULL FRAME (base64 JPEG). The runner derives the crop rectangle from
+			* `parent.bbox` with the cluster crop convention and cuts it itself —
+			* do NOT pre-crop for this field, that is what `cropJpeg` is.
+			*/
+			frameJpeg: z.string().optional(),
+			/**
+			* PRE-CUT tile (base64 JPEG), used verbatim — NO padding is applied.
+			* The fallback when the lease/session backing the frame is gone and the
+			* caller already holds a crop.
+			*/
 			cropJpeg: z.string().optional(),
 			parent: DetailParentSchema,
 			steps: z.array(z.string()).optional()
@@ -34880,6 +34908,202 @@ function pointInPolygon(point, polygon) {
 	return inside;
 }
 //#endregion
+//#region src/pipeline/detail-crop.ts
+/**
+* THE detail-crop convention — the single derivation of the rectangle a
+* detail/enrichment step (clip-embedding, face-detection, plate-detection…)
+* is fed.
+*
+* ## Why this is one module and not two constants
+*
+* `object-clip` is ONE vector index, and cosine similarity is only meaningful
+* between vectors produced from the same crop convention. Two encode paths
+* write into it — the live detail plane and the embedding rebuild — and they
+* used to derive their crops independently: `DETAIL_CROP_PADDING_RATIO = 0.15`
+* with no squaring on one side, `DEFAULT_CROP_MARGIN = 0.2` with squaring on
+* by default on the other. Every rebuild therefore poured a second, silently
+* incomparable feature space into the index it exists to keep consistent.
+*
+* So the rectangle is derived HERE, once, from ONE convention value. Both
+* paths now reach this function through `pipelineRunner.runDetailSubtree` —
+* the runner is the only process that cuts (see `detail-subtree.ts`), and the
+* convention is a cluster-global `pipeline-orchestrator` setting. There is
+* deliberately no per-node or per-device scope: a per-accelerator crop margin
+* would reintroduce the same split, merely relocated.
+*
+* ## The default IS the live convention
+*
+* {@link DEFAULT_DETAIL_CROP_CONVENTION} reproduces what the live path has
+* been storing (0.15, no squaring). Anything else would invalidate every
+* vector already in the index on the day it shipped. Changing the convention
+* is legitimate — that is what the operator knob is for — but it must be
+* followed by a rebuild, which is now guaranteed to produce crops from this
+* same function.
+*/
+/**
+* Store identity of the convention in `pipeline-orchestrator`'s GLOBAL
+* (cluster-wide) settings.
+*
+* These live here rather than in the orchestrator because the reader is a
+* different addon — the pipeline runner, over the hub-routed `addon-settings`
+* cap. Addons never import each other, so a key owned by the writer would have
+* to be hand-copied by the reader, and a hand-copied key is how a setting
+* silently stops arriving while both sides still look correct.
+*/
+var DETAIL_CROP_SECTION_ID = "detail-crop";
+var DETAIL_CROP_PADDING_KEY = "detailCropPaddingRatio";
+var DETAIL_CROP_SQUARE_KEY = "detailCropSquare";
+/**
+* Operator-tunable crop convention. Single-valued and cluster-wide — see the
+* module docblock for why it cannot be scoped per node or per device.
+*/
+var DetailCropConventionSchema = z.object({
+	/**
+	* Fraction of the box's own size added on EACH side before cutting.
+	*
+	* CLIP is trained on natural images WITH surroundings; a pixel-tight crop
+	* removes exactly the context it is strongest on (a dog cut to its outline
+	* is a dark blob). The right value is an empirical question, which is why it
+	* is a setting: 0 / 0.15 / 0.2 / 0.5 are the interesting points.
+	*/
+	paddingRatio: z.number().min(0).max(4),
+	/**
+	* Square the window (in PIXELS) before cutting.
+	*
+	* CLIP's input is square, so a tall bbox resized straight to NxN is squashed
+	* — a standing person becomes a shape the model never saw. Squaring costs
+	* extra background, which is context the model wants anyway. Off by default
+	* because the live path has never squared and the stored index reflects that.
+	*/
+	square: z.boolean()
+});
+/**
+* The convention in force when nobody has configured one — byte-for-byte the
+* behaviour of the pre-unification LIVE path (`DETAIL_CROP_PADDING_RATIO`).
+*/
+var DEFAULT_DETAIL_CROP_CONVENTION = {
+	paddingRatio: .15,
+	square: false
+};
+/**
+* Narrow a FLAT settings record to the convention.
+*
+* Per-FIELD fallback, deliberately: a junk padding must not also discard a
+* valid squaring choice. An absent or invalid value resolves to
+* {@link DEFAULT_DETAIL_CROP_CONVENTION} — the historical live behaviour —
+* rather than to a clamped number nobody chose, so a bad read can never
+* quietly change what the stored vectors mean.
+*/
+function readDetailCropConvention(config) {
+	const paddingRatio = DetailCropConventionSchema.shape.paddingRatio.safeParse(config[DETAIL_CROP_PADDING_KEY]);
+	const square = DetailCropConventionSchema.shape.square.safeParse(config[DETAIL_CROP_SQUARE_KEY]);
+	return {
+		paddingRatio: paddingRatio.success ? paddingRatio.data : DEFAULT_DETAIL_CROP_CONVENTION.paddingRatio,
+		square: square.success ? square.data : DEFAULT_DETAIL_CROP_CONVENTION.square
+	};
+}
+function isHydratedField(entry) {
+	return typeof entry === "object" && entry !== null && "key" in entry;
+}
+/**
+* Extract the convention from an `addon-settings.getGlobalSettings` payload.
+*
+* Walks EVERY section rather than looking inside {@link DETAIL_CROP_SECTION_ID}
+* alone: the keys are unique across the addon's schema, and a section rename
+* must not silently revert the whole cluster to the default. A `null` payload
+* (addon mid-boot) is the default convention.
+*/
+function pickDetailCropConvention(view) {
+	if (view === null) return DEFAULT_DETAIL_CROP_CONVENTION;
+	const flat = {};
+	for (const section of view.sections) for (const entry of section.fields) {
+		if (!isHydratedField(entry) || typeof entry.key !== "string") continue;
+		if (entry.key === "detailCropPaddingRatio" || entry.key === "detailCropSquare") flat[entry.key] = entry.value;
+	}
+	return readDetailCropConvention(flat);
+}
+/** Slider bounds for the operator-facing padding knob (orchestrator settings UI). */
+var DETAIL_CROP_PADDING_FIELD = {
+	min: 0,
+	max: 1,
+	step: .05,
+	default: DEFAULT_DETAIL_CROP_CONVENTION.paddingRatio
+};
+/**
+* Derive the crop rectangle for one parent detection.
+*
+* Order: pad by `paddingRatio` of the box's own size → optionally square in
+* pixel space around the padded centre → keep it inside the frame. Pure:
+* always returns a new rect and never mutates `bbox`.
+*
+* Edge handling differs by mode, on purpose:
+*
+* - **unsquared** — TRUNCATED at the frame border, byte-for-byte what the live
+*   path has always done (`padAndClampFrameBbox`). A subject against the edge
+*   gets a slightly smaller window. Changing this would silently reinterpret
+*   every edge-touching vector already in the index.
+* - **squared** — SLID inward instead, because a truncated square is not
+*   square and squaring exists precisely to preserve the aspect the model
+*   sees. It only shrinks when the square is larger than the frame itself.
+*/
+function deriveDetailCropRect(bbox, frameWidth, frameHeight, convention) {
+	const padX = convention.paddingRatio * bbox.w;
+	const padY = convention.paddingRatio * bbox.h;
+	const padded = {
+		x: bbox.x - padX,
+		y: bbox.y - padY,
+		w: bbox.w + 2 * padX,
+		h: bbox.h + 2 * padY
+	};
+	return convention.square ? slideInsideFrame(squareInPixels(padded, frameWidth, frameHeight), frameWidth, frameHeight) : truncateToFrame(padded, frameWidth, frameHeight);
+}
+/**
+* Grow the shorter side to the longer one around the window's centre, bounded
+* by the frame's shorter side — a square larger than the frame cannot exist,
+* and collapsing to the frame's short side is the most that does.
+*/
+function squareInPixels(rect, frameWidth, frameHeight) {
+	const side = Math.min(Math.max(rect.w, rect.h), Math.min(frameWidth, frameHeight));
+	const cx = rect.x + rect.w / 2;
+	const cy = rect.y + rect.h / 2;
+	return {
+		x: cx - side / 2,
+		y: cy - side / 2,
+		w: side,
+		h: side
+	};
+}
+/**
+* Cut the window at the frame border — the pre-unification live behaviour,
+* preserved exactly so unsquared crops keep matching the stored index.
+*/
+function truncateToFrame(rect, frameWidth, frameHeight) {
+	const x1 = Math.max(0, rect.x);
+	const y1 = Math.max(0, rect.y);
+	const x2 = Math.min(frameWidth, rect.x + rect.w);
+	const y2 = Math.min(frameHeight, rect.y + rect.h);
+	return {
+		x: x1,
+		y: y1,
+		w: Math.max(0, x2 - x1),
+		h: Math.max(0, y2 - y1)
+	};
+}
+/**
+* Move the window inside the frame keeping its extent — used only for squared
+* windows, where truncating would destroy the squareness that is the point.
+*/
+function slideInsideFrame(rect, frameWidth, frameHeight) {
+	const w = Math.max(0, Math.min(rect.w, frameWidth));
+	const h = Math.max(0, Math.min(rect.h, frameHeight));
+	return {
+		x: Math.min(Math.max(0, rect.x), Math.max(0, frameWidth - w)),
+		y: Math.min(Math.max(0, rect.y), Math.max(0, frameHeight - h)),
+		w,
+		h
+	};
+}
+//#endregion
 //#region src/helpers/bind-addon-actions.ts
 /**
 * Bind an addon's custom-action catalog to its tRPC surface, returning a
@@ -35131,4 +35355,4 @@ function enumerateInferenceDevices(hw) {
 	return out;
 }
 //#endregion
-export { ACCESSORY_LABEL, ALL_CAPABILITY_DEFINITIONS, APPLE_SA_TO_MACRO, AUDIO_BACKEND_CHOICES, AUDIO_MACRO_LABELS, AccessoriesStatusSchema, AccessoryKind, AddBrokerInputSchema, AddonAutoUpdateSchema, AddonListItemSchema, AddonPageDeclarationSchema, AddonPageInfoSchema, AdoptInputSchema as AdoptionAdoptInputSchema, AdoptResultSchema as AdoptionAdoptResultSchema, AdoptionFilterSchema, GetCandidateInputSchema as AdoptionGetCandidateInputSchema, ListCandidatesInputSchema as AdoptionListCandidatesInputSchema, ListCandidatesOutputSchema as AdoptionListCandidatesOutputSchema, ReleaseInputSchema as AdoptionReleaseInputSchema, AdoptionStatusSchema, AgentLoadSummarySchema, AirQualitySensorStatusSchema, AlarmArmModeSchema, AlarmPanelStatusSchema, AlarmStateSchema, AlertSchema, AlertSeveritySchema, AlertSourceSchema, AlertStatusSchema, AmbientLightSensorStatusSchema, ApiKeyRecordSchema, ApiKeySummarySchema, ArchiveEntrySchema, ArchiveManifestSchema, AttachmentMediaTypeSchema, AttachmentSchema, AudioAnalysisResultSchema, AudioAnalysisSettingsSchema, AudioChunkInputSchema, AudioClassSummarySchema, AudioClassificationLabelSchema, AudioClassificationResultSchema, AudioCodecInfoSchema, AudioDecodeSessionConfigSchema, AudioEncodeSchema, AudioEncodeSessionConfigSchema, AudioEncodedChunkSchema, AudioEventSchema, AudioLevelSchema, AudioMetricsHistoryPointSchema, AudioMetricsHistorySchema, AudioMetricsSnapshotSchema, AudioPcmChunkSchema, AuthResultSchema, AutoUpdateSettingsSchema, AutomationControlStatusSchema, AvailableIntegrationTypeSchema, BACKEND_TO_FORMAT, BATTERY_DEVICE_PROFILE, BacklightModeSchema, BackupDestinationInfoSchema, BackupEntrySchema, BaseAddon, BaseDevice, BaseDeviceProvider, BatteryStatusSchema, BinaryStatusSchema, BoundingBoxSchema, BrightnessStatusSchema, AddInputSchema as BrokerAddInputSchema, BrokerAudioClientSchema, BrokerClientsSchema, BrokerConnectionDetailsSchema, BrokerConsumerAttributionSchema, BrokerConsumerKindSchema, BrokerDecodedClientSchema, BrokerEncodedClientSchema, GetStateInputSchema as BrokerGetStateInputSchema, BrokerInfoSchema, BrokerProviderInfoSchema, PublishInputSchema as BrokerPublishInputSchema, RegistryStatusSchema as BrokerRegistryStatusSchema, BrokerRtspClientSchema, BrokerStatsSchema, BrokerStatusEnum, BrokerStatusSchema, SubscribeInputSchema as BrokerSubscribeInputSchema, SubscribeResultSchema as BrokerSubscribeResultSchema, TestConnectionResultSchema as BrokerTestConnectionResultSchema, UnsubscribeInputSchema as BrokerUnsubscribeInputSchema, CAM_PROFILE_ORDER, CAPABILITY_NAMES, CAPABILITY_ROUTER_KEYS, CAP_NAMES_WITH_STATUS, CAP_NODE_PIN_CONTEXT_KEY, CAP_PROVIDER_KIND_MAP, COCO_80_LABELS, COCO_TO_MACRO, CamProfileSchema, CamStreamDescriptorSchema, CamStreamKindSchema, CamStreamResolutionSchema, CameraAssignmentStatusSchema, CameraAudioStatusSchema, CameraBrokerProfileSchema, CameraBrokerStatusSchema, CameraCredentialsSchema, CameraCredentialsStatusSchema, CameraDecoderShmSchema, CameraDecoderStatusSchema, CameraDetectionPhaseSchema, CameraDetectionProvisioningSchema, CameraDetectionProvisioningStateSchema, CameraDetectionStatusSchema, CameraMetricsSchema, CameraMetricsWithDeviceIdSchema, CameraMotionStatusSchema, CameraRecordingModeSchema, CameraRecordingStatusSchema, CameraSourceStatusSchema, CameraSourceStreamSchema, CameraStatusSchema, CameraStreamSchema, CandidateQueryFilterSchema, CapScopeSchema, CapabilityBindingsSchema, CarbonMonoxideStatusSchema, ChargingStatus, ClientNetworkStatsSchema, ClimateControlStatusSchema, ClipPlaybackSchema, ClipSchema, ClusterAddonNodeDeploymentSchema, ClusterAddonStatusEntrySchema, CollectionColumnSchema, CollectionIndexSchema, ColorStatusSchema, ConfigEntrySchema, ConfigSectionWithValuesSchema, ConfigTabDeclarationSchema, ConnectivityStatusSchema, ConsumableItemSchema, ConsumablesStatusSchema, ContactStatusSchema, ControlKindSchema, ControlStatusSchema, ConvertArtifactSchema, ConvertResultSchema, ConvertTargetSchema, CoreBlockCompileResultSchema, CoreBlockInputSchema, CoreBlockPlacementSchema, CoreBlockSchema, CoreBlockStatusSchema, CoverStateSchema, CoverStatusSchema, CreateApiKeyInputSchema, CreateApiKeyResultSchema, CreateIntegrationInputSchema, CreateScopedTokenInputSchema, CreateScopedTokenResultSchema, CreateUserInputSchema, CustomActionInputSchema, CustomModelDescriptorSchema, DATAPLANE_SECRET_HEADER, DEFAULT_ADDON_PLACEMENT, DEFAULT_AUDIO_ANALYZER_CONFIG, DEFAULT_DECODER_HWACCEL_CONFIG, DEFAULT_EVENT_COLOR, DEFAULT_FEATURES, DEFAULT_RETENTION, DEFAULT_SCRUB_THUMBNAIL_PRESET, DEVICE_BACKEND_TO_FORMAT, DEVICE_CAP_NAMES, DEVICE_PROFILES, DEVICE_SCOPED_CAPS, DEVICE_SETTINGS_CONTRIBUTION_METHODS, DEVICE_STATE_READERS, DEVICE_STATUS_METHOD, DEVICE_TYPE_CONTROL_KIND, DEVICE_TYPE_INFO, EngineInfoSchema as DataStoreEngineInfoSchema, DayNightModeSchema, DayNightOptionsSchema, DayNightSettingsPatchSchema, DayNightStatusSchema, DecodedAudioChunkSchema, DecodedFrameSchema, DecoderSessionConfigSchema, DecoderStatsSchema, DeleteIntegrationResultSchema, DetectionSourceSchema, DeviceCodeSeveritySchema, DeviceConfig, DeviceDiscoveryStatusSchema, ExposeInputSchema as DeviceExportExposeInputSchema, DeviceExportStatusSchema, UnexposeInputSchema as DeviceExportUnexposeInputSchema, DeviceFeature, DeviceInfoSchema, DeviceLinkModeSchema, DeviceNetworkStatsSchema, DeviceRole, DeviceRuntimeState, DeviceStatusSchema, DeviceType, DiscoveredChildDeviceSchema, DiscoveredChildStatusSchema, DiscoveredDeviceSchema, DiscoveredTargetSchema, DisposerChain, DoorbellPressEventSchema, DoorbellStatusSchema, EVENTFUL_CAP_NAMES, EVENT_KIND_BY_CAP, EVENT_PAD_MS, EVENT_TAXONOMY, EXPRESSION_BUILTINS, EXPRESSION_BUILTIN_NAMES, EXPRESSION_COMPILE_CACHE_CAPACITY, EXPRESSION_IDENTIFIER_RE, EXPRESSION_INJECTED_NOW, ElementConfigStore, EmbeddingInfoSchema, EmbeddingResultSchema, EncodeProfileSchema, EncodedPacketSchema, EnrichedWidgetMetadataSchema, EnumSensorDateTimeFormatSchema, EnumSensorStatusSchema, EventCategory, EventEmitterStatusSchema, EventFireSchema, EventItemSchema, EventKindCategorySchema, EventKindDescriptorSchema, EventKindIconSchema, EventKindSchema, EventKindsForDeviceSchema, EventSourceType, ExportDownloadSchema, ExportOptionsSchema, ExportRecordSchema, ExportSetupFieldSchema, ExportSetupSchema, ExportSpeedSchema, ExportStateSchema, ExportTimelapseSchema, ExposedDeviceSchema, ExposureModeSchema, ExpressionEvalError, ExpressionParseError, FanControlStatusSchema, FanDirectionSchema, FeatureManifestSchema, FeatureProbeStatusSchema, FloodStatusSchema, FrameHandleFormatSchema, FrameHandleSchema, FrameInputSchema, GasStatusSchema, GetStreamWithCodecInputSchema, GlobalMetricsSchema, HF_BASE_URL, HF_REPO, HWACCEL_OPTIONS, HealthStatusSchema, HistoryPointSchema, HistoryResolutionEnum, HumidifierStatusSchema, HumiditySensorStatusSchema, HvacModeSchema, ImageContractSchema, ImageContractStateSchema, ImageRotateSchema, ImageSettingsOptionsSchema, ImageSettingsPatchSchema, ImageSettingsStatusSchema, ImageStatusSchema, IngestOwnerSchema, InstalledPackageSchema, IntegrationLiteSchema, IntegrationWithStateSchema, IntercomAbilitySchema, IntercomStatusSchema, KNOWN_CAP_NAMES, KeyEventSchema, LOG_LEVEL_RANK, LabelDefinitionSchema, LawnMowerActivitySchema, LawnMowerControlStatusSchema, LinkedDeviceSchema, LlmDefaultSchema, LlmDefaultSelectorSchema, LlmErrorCodeSchema, LlmGenerateBaseInputSchema, LlmGenerateErrSchema, LlmGenerateOkSchema, LlmGenerateResultSchema, LlmImageSchema, LlmNodeModelSchema, LlmProfileKindDescriptorSchema, LlmProfileKindSchema, LlmProfileSchema, LlmRuntimeCompleteInputSchema, LlmRuntimeDiskUsageSchema, LlmRuntimeNodeSchema, LlmRuntimeStatusSchema, LlmUsageRollupSchema, LlmUsageSchema, LocateSegmentResultSchema, LocationStatSchema, LockControlStatusSchema, LockStateSchema, LogEntrySchema, LogLevelSchema, LogStreamEntrySchema, LoginMethodContributionSchema, LoginStageEnum, MACRO_LABELS, MAX_EXPRESSION_AST_NODES, MAX_EXPRESSION_BINDINGS, MAX_EXPRESSION_CALL_ARGS, MAX_EXPRESSION_EVAL_STEPS, MAX_EXPRESSION_SOURCE_LENGTH, METHOD_ACCESS_MAP, MODEL_FORMATS, MOTION_TRIGGER_FEATURE, ManagedModelCatalogEntrySchema, ManagedModelRefSchema, ManagedRuntimeConfigSchema, MaskGridDimsSchema, MaskGridShapeSchema, MaskLineShapeSchema, MaskPointSchema, MaskPolygonShapeSchema, MaskPolygonVerticesSchema, MaskRectShapeSchema, MaskShapeKindSchema, MaskShapeSchema, MediaFileInfoSchema, MediaFileSchema, MediaPlayerRepeatSchema, MediaPlayerStateSchema, MediaPlayerStatusSchema, MeshPeerSchema, MeshStatusSchema, MethodAccessSchema, ModelCatalogEntrySchema, ModelConvertInputSchema, ModelConvertMetadataSchema, ModelDistributeInputSchema, ModelDistributeResultSchema, ModelExtraFileSchema, ModelFormatEntrySchema, ModelFormatsSchema, ModelSubstitutionSchema, ModelVariantGroupSchema, MotionAnalysisResultSchema, MotionEventSchema, MotionOnMotionChangedDataSchema, MotionRegionSchema, MotionSourceEnum, MotionSourcesSchema, MotionStatusSchema, MotionTriggerRuntimeStateSchema, MotionTriggerStatusSchema, MotionZoneOptionsSchema, MotionZonePatchSchema, MotionZoneRegionSchema, MotionZoneStatusSchema, StatusSchema as MqttBrokerStatusSchema, MutationFilterSchema, NC_BASE_CONDITION_KEYS, NC_CONDITION_CATALOG, NC_HISTORY_LIMIT_DEFAULT, NC_HISTORY_LIMIT_MAX, NC_MAX_PER_TRACK_IMMEDIATE, NC_SNOOZE_MAX_MINUTES, NC_TAXONOMY, NativeCropBboxSchema, NativeCropRefSchema, NativeCropResultSchema, NativeDetectionSchema, NativeObjectClassEnum, NativeObjectDetectionRuntimeStateSchema, NativeObjectDetectionStatusSchema, NcAlarmConfigSchema, NcAlarmModeCoverageSchema, NcAlarmSettingsPatchSchema, NcAlarmSettingsSchema, NcConditionDescriptorSchema, NcConditionsSchema, NcCrossingSchema, NcDeliverySchema, NcDeviceStateConditionSchema, NcHistoryEntrySchema, NcHistoryFilterSchema, NcHistoryRecordKindSchema, NcHistoryStatusSchema, NcHistorySubjectSchema, NcMediaFrameSchema, NcMediaPolicySchema, NcOccupancyConditionSchema, NcPlateMatcherSchema, NcRuleActionSchema, NcRuleActionSequenceSchema, NcRuleActionsSchema, NcRuleInputSchema, NcRuleNotificationButtonSchema, NcRulePatchSchema, NcRuleSchema, NcRuleTargetSchema, NcScheduleSchema, NcScheduleWindowSchema, NcSnoozeInputSchema, NcSnoozeSchema, NcSnoozeScopeSchema, NcSnoozeSuppressedSchema, NcTaxonomyEntrySchema, NcTaxonomySchema, NcTestResultSchema, NcThrottleGranularitySchema, NcThrottleSchema, NcZoneConditionSchema, NetworkAccessStatusSchema, NetworkAddressSchema, NetworkEndpointSchema, NotificationActionIconSchema, NotificationActionSchema, NotificationFormatSchema, NotificationSchema, NotifierStatusSchema, NumericSensorStatusSchema, OPS_LOG_DEFAULT_LIMIT, OPS_LOG_RING_DEFAULT_MAX, OauthIntegrationDescriptorSchema, ObjectEventSchema, OpsLogDomainSchema, OpsLogEntrySchema, OpsLogOpSchema, OpsLogQueryInputSchema, OpsLogReasonSchema, OrchestratorMetricsSchema, OsdOverlayKindEnum, OsdOverlayPatchSchema, OsdOverlaySchema, OsdPositionEnum, OsdStatusSchema, PET_FEEDER_MANUAL_FEED_MAX, PET_FEEDER_MANUAL_FEED_MIN, PIPELINE_FLOW_CAPABILITY_NAMES, PIPELINE_OWNER_CAPABILITY_NAMES, PROVIDER_KIND_CAP_NAMES, PYTHON_SCRIPT, PackageUpdateSchema, PackageVersionInfoSchema, PasskeyLoginMethodSchema, PasskeySummarySchema, PcmSampleFormatSchema, PerScopeBreakdownSchema, PetFeederStatusSchema, PickStreamPreferencesSchema, PickStreamRequirementsSchema, PickedCamStreamSchema, PipelineAssignmentSchema, PipelineDefaultStepSchema, PipelineEngineChoiceSchema, PipelineRunResultBridge, PipelineStepInputSchema, PipelineValidationIssueSchema, PipelineValidationResultSchema, PlaceholderReasonSchema, PolygonPointSchema, PowerMeterStatusSchema, PresenceStatusSchema, PressureSensorStatusSchema, PrivacyMaskOptionsSchema, PrivacyMaskPatchSchema, PrivacyMaskRegionSchema, PrivacyMaskShapeSchema, PrivacyMaskStatusSchema, ProfileRtspEntrySchema, ProfileSlotSchema, ProfileSlotStatusSchema, ProviderStatusSchema, PtzAutotrackRuntimeStateSchema, PtzAutotrackSettingsSchema, PtzAutotrackStatusSchema, PtzAutotrackTargetOptionSchema, PtzMoveCommandSchema, PtzOptionsSchema, PtzPositionSchema, PtzPresetSchema, PtzStatusSchema, QueryFilterSchema, REACHABILITY_FAILURES_TO_OFFLINE, REACHABILITY_POLL_INTERVAL_MS, REACHABILITY_PROBE_TIMEOUT_MS, RECOGNITION_TYPES, RESERVED_BINDING_NAMES, RUNTIME_DEFAULTS, RUNTIME_TO_FORMAT, RawStateResultSchema, ReadSegmentBytesResultSchema, ReadinessRegistry, ReadinessTimeoutError, RecentTracksPageSchema, RecentTracksQueryInput, RecordingAvailabilitySchema, RecordingBandModeSchema, RecordingBandSchema, RecordingBandTriggersSchema, RecordingConfigSchema, RecordingDaysSchema, RecordingDeviceUsageSchema, RecordingLocationUsageSchema, RecordingManifestSchema, RecordingRangeSchema, RecordingRetentionSchema, RecordingStatusSchema, RecordingStorageModeSchema, RecordingStorageUsageSchema, RecordingTriggersSchema, RecordingWeekdaySchema, RedirectLoginMethodSchema, RelocateFootageInputSchema, RelocateJobSchema, RelocateJobStateSchema, RelocateMediaInputSchema, RenderedAsSchema, ReportMotionInputSchema, RingBuffer, RtpSourceSchema, RtspRestreamEntrySchema, RunnerCameraConfigSchema, RunnerCameraDeviceUIFields, RunnerFrameSourceSchema, RunnerInferenceDeviceSchema, RunnerLocalLoadSchema, RunnerLocalMetricsSchema, SCOPE_PRESETS, SCRUB_THUMBNAIL_PRESETS, SCRUB_THUMBNAIL_PRESET_LABELS, SCRUB_THUMBNAIL_PRESET_ORDER, SENSOR_FEATURES, SENSOR_MAP, SOURCE_INFO_METADATA_KEY, STREAM_PROFILE_META, STREAM_QUALITY_LABELS, SUB_DETECTION_TYPES, SYSTEM_CAP_NAMES, SceneCheckSchema, SceneConditionSchema, SceneMonitorSchema, SceneMonitorStateSchema, SceneMonitorStatusSchema, SceneReferenceSchema, ScopedTokenSchema, ScopedTokenSummarySchema, ScoredObjectEventSchema, ScriptRunnerStatusSchema, ScrubThumbnailPresetSchema, SearchResultSchema, SendEmailInputSchema, SendEmailResultSchema, SendResultSchema, SensorEventSchema, ServerBootModeSchema, ServerPackageStatusSchema, ServerRollbackInfoSchema, ServerUpdateActionResultSchema, ServerUpdateCheckResultSchema, ServerUpdateStateSchema, SettingsPatchSchema, SettingsRecordSchema, SettingsSchemaWithValuesSchema, SettingsUpdateResultSchema, ShmRingStatsSchema, SmokeStatusSchema, SmtpStatusSchema, SnapshotImageSchema, SourceInfoSchema, SpatialDetectionSchema, SsoBridgeClaimsSchema, StartEmbeddedInputSchema, StationaryObjectSchema, AbortUploadInputSchema as StorageAbortUploadInputSchema, BeginDownloadInputSchema as StorageBeginDownloadInputSchema, BeginDownloadResultSchema as StorageBeginDownloadResultSchema, BeginUploadInputSchema as StorageBeginUploadInputSchema, BeginUploadResultSchema as StorageBeginUploadResultSchema, EndDownloadInputSchema as StorageEndDownloadInputSchema, FinalizeUploadInputSchema as StorageFinalizeUploadInputSchema, StorageLocationDeclarationSchema, StorageLocationRefSchema, StorageLocationSchema, StorageLocationTypeSchema, ProviderInfoSchema as StorageProviderInfoSchema, ReadChunkInputSchema as StorageReadChunkInputSchema, TestLocationResultSchema as StorageTestLocationResultSchema, WriteChunkInputSchema as StorageWriteChunkInputSchema, StreamCodecSchema, StreamFormatSchema, StreamNetworkStatsSchema, StreamParamsOptionsSchema, StreamParamsStatusSchema, StreamProfileConfigSchema, StreamProfileOptionsSchema, StreamProfilePatchSchema, StreamProfileSchema, StreamSourceEntrySchema, StreamSourceSchema, SubscribeAudioChunksInputSchema, SubscribeAudioChunksResultSchema, SubscribeFramesInputSchema, SubscribeFramesResultSchema, SwitchStatusSchema, SystemMetricsSchema, SystemMirror, TAXONOMY_COLORS, TIMEZONES, TamperStatusSchema, TankStatusSchema, TargetKindCapsSchema, TargetKindLevelSchema, TargetKindSchema, TargetSchema, TemperatureSensorStatusSchema, TerminalProfileInfoSchema, TerminalSessionInfoSchema, TestConnectionResultSchema$1 as TestConnectionResultSchema, TestResultSchema, TimelapseRuleInputSchema, TimelapseRulePatchSchema, TimelapseRuleSchema, TimelapseTemplateSchema, ToastSchema, TokenScopeSchema, TopologyNodeSchema, TopologyProcessSchema, TopologyServiceSchema, TrackCascadeCountsSchema, TrackEnvelopeSchema, TrackProjectionSchema, TrackSchema, TrackStateSchema, TrackZoneFilterSchema, TrackedDetectionSchema, TurnServerSchema, UNIT_TABLE, BrokerInfoSchema$1 as UnifiedBrokerInfoSchema, UnitConversionError, UpdateIntegrationInputSchema, UpdateStatusSchema, UpdateUserInputSchema, UserRecordSchema, UserSummarySchema, VacuumControlStatusSchema, VacuumStateSchema, ValveStateSchema, ValveStatusSchema, VectorDeclareIndexInputSchema, VectorDeleteByFilterInputSchema, VectorDeleteInputSchema, VectorDeleteResultSchema, VectorFilterSchema, VectorGetInputSchema, VectorGetResultSchema, VectorItemSchema, VectorMatchSchema, VectorMetadataSchema, VectorMetricSchema, VectorQueryInputSchema, VectorQueryResultSchema, VectorStatsInputSchema, VectorStatsResultSchema, VectorUpsertInputSchema, VectorUpsertResultSchema, VibrationStatusSchema, VideoEncodeSchema, WELL_KNOWN_TABS, WELL_KNOWN_TAB_MAP, WaterHeaterStatusSchema, WeatherStatusSchema, WebrtcStreamChoiceSchema, WebrtcStreamTargetSchema, WhiteBalanceModeSchema, WidgetHostEnum, WidgetLoginMethodSchema, WidgetMetadataSchema, WidgetRemoteSchema, WidgetSizeEnum, YAMNET_TO_MACRO, ZoneCrossingDirectionSchema, ZoneCrossingSchema, ZoneKindEnum, ZoneRuleModeEnum, ZoneRuleSchema, ZoneRuleStageEnum, ZoneRulesArraySchema, ZoneSchema, ZoneScopeBreakdownSchema, accessoriesCapability, accessoryStableId, addonPagesCapability, addonPagesSourceCapability, addonRoutesCapability, addonSettingsCapability, addonWidgetsCapability, addonWidgetsSourceCapability, addonsCapability, adminUiCapability, airQualitySensorCapability, alarmPanelCapability, alertsCapability, ambientLightSensorCapability, applyTransform, asBoolean, asJsonArray, asJsonObject, asNumber, asString, audioAnalysisCapability, audioAnalyzerCapability, audioCodecCapability, audioMetricsCapability, authProviderCapability, autoAssignProfiles, automationControlCapability, backupCapability, batteryCapability, bestLocationMatch, binaryCapability, bindAddonActions, brightnessCapability, brokerCapability, buildAddonRouteProvider, buildEventKindDescriptor, buildModelVariantGroups, buildNcTaxonomy, buildStreamParamsConfigSchema, buttonCapability, cameraCredentialsCapability, cameraPipelineConfigCapability, cameraStreamsCapability, canConvertUnit, carbonMonoxideCapability, cellsToRects, classifyStream, classifyStreams, climateControlCapability, collectHydratedFieldEntries, collectHydratedFieldValues, colorCapability, colorForKind, compileExpression, compileExpressionSafe, connectivityCapability, consumablesCapability, contactCapability, controlCapability, convertUnit, coreBlocksCapability, cosineSimilarity, coverCapability, createDeviceProxy, createDurableState, createEvent, createExpressionScope, createLazyTrpcSource, createMirrorSource, createRuntimeStateBridge, createSliceHandle, createSystemProxy, customAction, customModelRegistryCapability, dataStoreProviderCapability, dayNightCapability, decodeVectorBase64, decoderCapability, defaultDeviceFor, defineCustomActions, deriveRecordingMode, describeModelVariant, detectionPipelineCapability, deviceAdoptionCapability, deviceBackendToFormat, deviceCustomAction, deviceDiscoveryCapability, deviceExportCapability, deviceManagerCapability, deviceMatchesProfile, deviceOpsCapability, deviceProviderCapability, deviceStateCapability, deviceStatusCapability, doorbellCapability, embeddingEncoderCapability, emitDownForOwnedCaps, emitReadiness, encodeProfileFromStreamShape, encodeVectorBase64, enumSensorCapability, enumerateInferenceDevices, enumerateItemArrayFields, enumerateSchemaFields, errMsg, evaluateAst, evaluateLinkExpression, evaluateZoneRules, event, eventEmitterCapability, eventsCapability, expandCapMethods, extractNestedAddonId, extractSourceInfoFromMetadata, faceGalleryCapability, fanControlCapability, featureProbeCapability, filesystemBrowseCapability, findTimezone, floodCapability, formatForBackend, formatForRuntime, gasCapability, getAudioMacroClassIds, getByPath, getCapsByProviderKind, getTaxonomyEntry, hasMotionTrigger, hfModelUrl, htmlToText, humidifierCapability, humiditySensorCapability, hydrateSchema, imageCapability, imageSettingsCapability, integrationsCapability, intercomCapability, isAgentOnlyPlacement, isArrayOutputSchema, isBaseConditionKey, isCollectionArrayMethod, isDeployableToAgent, isDeviceConfigCap, isDeviceScopedCap, isEvent, isNode, isObjectInput, isVoidInput, jobKindSchema, kebabToCamel, knownValues, lawnMowerControlCapability, lifecycleJobSchema, lifecycleJobScopeSchema, lifecycleJobStateSchema, lifecycleTaskSchema, llmCapability, llmRuntimeCapability, localNetworkCapability, locationSimilarity, lockControlCapability, logDestinationCapability, logLevelAtMost, loginMethodCapability, looseSchema, makeProfileBrokerId, makeSourceBrokerId, mapAudioLabelToMacro, markdownToHtmlLite, markdownToText, maskUrlCredentials, mediaPlayerCapability, mergeSourceInfo, meshNetworkCapability, method, metricsProviderCapability, modelConvertCapability, modelDistributorCapability, modelFormatForRuntime, motionCapability, motionDetectionCapability, motionTriggerCapability, motionZonesCapability, mqttBrokerCapability, nativeObjectDetectionCapability, networkAccessCapability, networkQualityCapability, nodePin, nodesCapability, normalizeAddonInitResult, normalizeUnit, notificationOutputCapability, notificationRulesCapability, notifierCapability, numericSensorCapability, oauthIntegrationCapability, objectInputDeclaresAddonId, osdCapability, parseCameraStreamConfig, parseExpression, parseJsonArray, parseJsonObject, parseJsonUnknown, parseProfileBrokerId, parseStreamParamsFormPatch, petFeederCapability, pickAccessoryControl, pickPreferredRtspEntry, pickerForCondition, pipelineAnalyticsCapability, pipelineExecutorCapability, pipelineOrchestratorCapability, pipelineRunnerCapability, plateGalleryCapability, platformProbeCapability, powerMeterCapability, prepareNotification, presenceCapability, pressureSensorCapability, privacyMaskCapability, procedureAuthKey, ptzAutotrackCapability, ptzCapability, pythonScriptForBackend, readDeviceStateFrom, readNodePin, readinessKey, rebootCapability, recordingCapability, recordingExportCapability, rectsToCells, requiresPython, resolveAddonExecution, resolveAddonGroup, resolveAddonPlacement, resolveAddonRuntime, resolveCapMount, resolveDetectionRuntime, resolveDeviceControlKind, resolveDeviceProfile, resolveFormat, resolveHydratedFieldValue, resolveModelFormat, resolveMutate, resolveRunnerId, resolveScrubThumbnailGeometry, resolveVariantModelId, runInferenceStep, runtimeDevices, sceneMonitorCapability, scopeKey, scoreRuntimes, scriptRunnerCapability, selectAssignedProfileSlots, serverManagementCapability, setByPath, settingsStoreCapability, sleep, sleepCancellable, smokeCapability, smtpProviderCapability, snapshotCapability, ssoBridgeCapability, startReachabilityPoll, stateVocabularyFor, storageCapability, storageEvictableCapability, storageProviderCapability, streamBrokerCapability, streamCatalogCapability, streamParamsCapability, streamPixels, streamQualityLabel, subKindsOf, supportedRuntimes, switchCapability, synthesizeSourceInfo, systemCapability, tamperCapability, taskLogEntrySchema, taskPhaseSchema, taskTargetSchema, temperatureSensorCapability, terminalSessionCapability, textToHtml, toDeviceSummary, toExpressionValue, toStreamSourceEntry, toastCapability, tokenize, transcodeBody, tryConvertUnit, turnProviderCapability, unitDimension, unitsForDimension, updateCapability, userManagementCapability, userPasskeysCapability, vacuumControlCapability, validateExpressionSource, valveCapability, vectorDimFromBase64, vectorStoreCapability, vibrationCapability, videoclipsCapability, viewerUiCapability, waterHeaterCapability, weatherCapability, webrtcClientHintsSchema, webrtcSessionCapability, wiringAddonHealthSchema, wiringHealthSnapshotSchema, wiringNodeHealthSchema, wiringProbeKindSchema, wiringProbeResultSchema, zodEntriesToConfigUI, zoneAnalyticsCapability, zoneRulesCapability, zonesCapability };
+export { ACCESSORY_LABEL, ALL_CAPABILITY_DEFINITIONS, APPLE_SA_TO_MACRO, AUDIO_BACKEND_CHOICES, AUDIO_MACRO_LABELS, AccessoriesStatusSchema, AccessoryKind, AddBrokerInputSchema, AddonAutoUpdateSchema, AddonListItemSchema, AddonPageDeclarationSchema, AddonPageInfoSchema, AdoptInputSchema as AdoptionAdoptInputSchema, AdoptResultSchema as AdoptionAdoptResultSchema, AdoptionFilterSchema, GetCandidateInputSchema as AdoptionGetCandidateInputSchema, ListCandidatesInputSchema as AdoptionListCandidatesInputSchema, ListCandidatesOutputSchema as AdoptionListCandidatesOutputSchema, ReleaseInputSchema as AdoptionReleaseInputSchema, AdoptionStatusSchema, AgentLoadSummarySchema, AirQualitySensorStatusSchema, AlarmArmModeSchema, AlarmPanelStatusSchema, AlarmStateSchema, AlertSchema, AlertSeveritySchema, AlertSourceSchema, AlertStatusSchema, AmbientLightSensorStatusSchema, ApiKeyRecordSchema, ApiKeySummarySchema, ArchiveEntrySchema, ArchiveManifestSchema, AttachmentMediaTypeSchema, AttachmentSchema, AudioAnalysisResultSchema, AudioAnalysisSettingsSchema, AudioChunkInputSchema, AudioClassSummarySchema, AudioClassificationLabelSchema, AudioClassificationResultSchema, AudioCodecInfoSchema, AudioDecodeSessionConfigSchema, AudioEncodeSchema, AudioEncodeSessionConfigSchema, AudioEncodedChunkSchema, AudioEventSchema, AudioLevelSchema, AudioMetricsHistoryPointSchema, AudioMetricsHistorySchema, AudioMetricsSnapshotSchema, AudioPcmChunkSchema, AuthResultSchema, AutoUpdateSettingsSchema, AutomationControlStatusSchema, AvailableIntegrationTypeSchema, BACKEND_TO_FORMAT, BATTERY_DEVICE_PROFILE, BacklightModeSchema, BackupDestinationInfoSchema, BackupEntrySchema, BaseAddon, BaseDevice, BaseDeviceProvider, BatteryStatusSchema, BinaryStatusSchema, BoundingBoxSchema, BrightnessStatusSchema, AddInputSchema as BrokerAddInputSchema, BrokerAudioClientSchema, BrokerClientsSchema, BrokerConnectionDetailsSchema, BrokerConsumerAttributionSchema, BrokerConsumerKindSchema, BrokerDecodedClientSchema, BrokerEncodedClientSchema, GetStateInputSchema as BrokerGetStateInputSchema, BrokerInfoSchema, BrokerProviderInfoSchema, PublishInputSchema as BrokerPublishInputSchema, RegistryStatusSchema as BrokerRegistryStatusSchema, BrokerRtspClientSchema, BrokerStatsSchema, BrokerStatusEnum, BrokerStatusSchema, SubscribeInputSchema as BrokerSubscribeInputSchema, SubscribeResultSchema as BrokerSubscribeResultSchema, TestConnectionResultSchema as BrokerTestConnectionResultSchema, UnsubscribeInputSchema as BrokerUnsubscribeInputSchema, CAM_PROFILE_ORDER, CAPABILITY_NAMES, CAPABILITY_ROUTER_KEYS, CAP_NAMES_WITH_STATUS, CAP_NODE_PIN_CONTEXT_KEY, CAP_PROVIDER_KIND_MAP, COCO_80_LABELS, COCO_TO_MACRO, CamProfileSchema, CamStreamDescriptorSchema, CamStreamKindSchema, CamStreamResolutionSchema, CameraAssignmentStatusSchema, CameraAudioStatusSchema, CameraBrokerProfileSchema, CameraBrokerStatusSchema, CameraCredentialsSchema, CameraCredentialsStatusSchema, CameraDecoderShmSchema, CameraDecoderStatusSchema, CameraDetectionPhaseSchema, CameraDetectionProvisioningSchema, CameraDetectionProvisioningStateSchema, CameraDetectionStatusSchema, CameraMetricsSchema, CameraMetricsWithDeviceIdSchema, CameraMotionStatusSchema, CameraRecordingModeSchema, CameraRecordingStatusSchema, CameraSourceStatusSchema, CameraSourceStreamSchema, CameraStatusSchema, CameraStreamSchema, CandidateQueryFilterSchema, CapScopeSchema, CapabilityBindingsSchema, CarbonMonoxideStatusSchema, ChargingStatus, ClientNetworkStatsSchema, ClimateControlStatusSchema, ClipPlaybackSchema, ClipSchema, ClusterAddonNodeDeploymentSchema, ClusterAddonStatusEntrySchema, CollectionColumnSchema, CollectionIndexSchema, ColorStatusSchema, ConfigEntrySchema, ConfigSectionWithValuesSchema, ConfigTabDeclarationSchema, ConnectivityStatusSchema, ConsumableItemSchema, ConsumablesStatusSchema, ContactStatusSchema, ControlKindSchema, ControlStatusSchema, ConvertArtifactSchema, ConvertResultSchema, ConvertTargetSchema, CoreBlockCompileResultSchema, CoreBlockInputSchema, CoreBlockPlacementSchema, CoreBlockSchema, CoreBlockStatusSchema, CoverStateSchema, CoverStatusSchema, CreateApiKeyInputSchema, CreateApiKeyResultSchema, CreateIntegrationInputSchema, CreateScopedTokenInputSchema, CreateScopedTokenResultSchema, CreateUserInputSchema, CustomActionInputSchema, CustomModelDescriptorSchema, DATAPLANE_SECRET_HEADER, DEFAULT_ADDON_PLACEMENT, DEFAULT_AUDIO_ANALYZER_CONFIG, DEFAULT_DECODER_HWACCEL_CONFIG, DEFAULT_DETAIL_CROP_CONVENTION, DEFAULT_EVENT_COLOR, DEFAULT_FEATURES, DEFAULT_RETENTION, DEFAULT_SCRUB_THUMBNAIL_PRESET, DETAIL_CROP_PADDING_FIELD, DETAIL_CROP_PADDING_KEY, DETAIL_CROP_SECTION_ID, DETAIL_CROP_SQUARE_KEY, DEVICE_BACKEND_TO_FORMAT, DEVICE_CAP_NAMES, DEVICE_PROFILES, DEVICE_SCOPED_CAPS, DEVICE_SETTINGS_CONTRIBUTION_METHODS, DEVICE_STATE_READERS, DEVICE_STATUS_METHOD, DEVICE_TYPE_CONTROL_KIND, DEVICE_TYPE_INFO, EngineInfoSchema as DataStoreEngineInfoSchema, DayNightModeSchema, DayNightOptionsSchema, DayNightSettingsPatchSchema, DayNightStatusSchema, DecodedAudioChunkSchema, DecodedFrameSchema, DecoderSessionConfigSchema, DecoderStatsSchema, DeleteIntegrationResultSchema, DetailCropConventionSchema, DetectionSourceSchema, DeviceCodeSeveritySchema, DeviceConfig, DeviceDiscoveryStatusSchema, ExposeInputSchema as DeviceExportExposeInputSchema, DeviceExportStatusSchema, UnexposeInputSchema as DeviceExportUnexposeInputSchema, DeviceFeature, DeviceInfoSchema, DeviceLinkModeSchema, DeviceNetworkStatsSchema, DeviceRole, DeviceRuntimeState, DeviceStatusSchema, DeviceType, DiscoveredChildDeviceSchema, DiscoveredChildStatusSchema, DiscoveredDeviceSchema, DiscoveredTargetSchema, DisposerChain, DoorbellPressEventSchema, DoorbellStatusSchema, EVENTFUL_CAP_NAMES, EVENT_KIND_BY_CAP, EVENT_PAD_MS, EVENT_TAXONOMY, EXPRESSION_BUILTINS, EXPRESSION_BUILTIN_NAMES, EXPRESSION_COMPILE_CACHE_CAPACITY, EXPRESSION_IDENTIFIER_RE, EXPRESSION_INJECTED_NOW, ElementConfigStore, EmbeddingInfoSchema, EmbeddingResultSchema, EncodeProfileSchema, EncodedPacketSchema, EnrichedWidgetMetadataSchema, EnumSensorDateTimeFormatSchema, EnumSensorStatusSchema, EventCategory, EventEmitterStatusSchema, EventFireSchema, EventItemSchema, EventKindCategorySchema, EventKindDescriptorSchema, EventKindIconSchema, EventKindSchema, EventKindsForDeviceSchema, EventSourceType, ExportDownloadSchema, ExportOptionsSchema, ExportRecordSchema, ExportSetupFieldSchema, ExportSetupSchema, ExportSpeedSchema, ExportStateSchema, ExportTimelapseSchema, ExposedDeviceSchema, ExposureModeSchema, ExpressionEvalError, ExpressionParseError, FanControlStatusSchema, FanDirectionSchema, FeatureManifestSchema, FeatureProbeStatusSchema, FloodStatusSchema, FrameHandleFormatSchema, FrameHandleSchema, FrameInputSchema, GasStatusSchema, GetStreamWithCodecInputSchema, GlobalMetricsSchema, HF_BASE_URL, HF_REPO, HWACCEL_OPTIONS, HealthStatusSchema, HistoryPointSchema, HistoryResolutionEnum, HumidifierStatusSchema, HumiditySensorStatusSchema, HvacModeSchema, ImageContractSchema, ImageContractStateSchema, ImageRotateSchema, ImageSettingsOptionsSchema, ImageSettingsPatchSchema, ImageSettingsStatusSchema, ImageStatusSchema, IngestOwnerSchema, InstalledPackageSchema, IntegrationLiteSchema, IntegrationWithStateSchema, IntercomAbilitySchema, IntercomStatusSchema, KNOWN_CAP_NAMES, KeyEventSchema, LOG_LEVEL_RANK, LabelDefinitionSchema, LawnMowerActivitySchema, LawnMowerControlStatusSchema, LinkedDeviceSchema, LlmDefaultSchema, LlmDefaultSelectorSchema, LlmErrorCodeSchema, LlmGenerateBaseInputSchema, LlmGenerateErrSchema, LlmGenerateOkSchema, LlmGenerateResultSchema, LlmImageSchema, LlmNodeModelSchema, LlmProfileKindDescriptorSchema, LlmProfileKindSchema, LlmProfileSchema, LlmRuntimeCompleteInputSchema, LlmRuntimeDiskUsageSchema, LlmRuntimeNodeSchema, LlmRuntimeStatusSchema, LlmUsageRollupSchema, LlmUsageSchema, LocateSegmentResultSchema, LocationStatSchema, LockControlStatusSchema, LockStateSchema, LogEntrySchema, LogLevelSchema, LogStreamEntrySchema, LoginMethodContributionSchema, LoginStageEnum, MACRO_LABELS, MAX_EXPRESSION_AST_NODES, MAX_EXPRESSION_BINDINGS, MAX_EXPRESSION_CALL_ARGS, MAX_EXPRESSION_EVAL_STEPS, MAX_EXPRESSION_SOURCE_LENGTH, METHOD_ACCESS_MAP, MODEL_FORMATS, MOTION_TRIGGER_FEATURE, ManagedModelCatalogEntrySchema, ManagedModelRefSchema, ManagedRuntimeConfigSchema, MaskGridDimsSchema, MaskGridShapeSchema, MaskLineShapeSchema, MaskPointSchema, MaskPolygonShapeSchema, MaskPolygonVerticesSchema, MaskRectShapeSchema, MaskShapeKindSchema, MaskShapeSchema, MediaFileInfoSchema, MediaFileSchema, MediaPlayerRepeatSchema, MediaPlayerStateSchema, MediaPlayerStatusSchema, MeshPeerSchema, MeshStatusSchema, MethodAccessSchema, ModelCatalogEntrySchema, ModelConvertInputSchema, ModelConvertMetadataSchema, ModelDistributeInputSchema, ModelDistributeResultSchema, ModelExtraFileSchema, ModelFormatEntrySchema, ModelFormatsSchema, ModelSubstitutionSchema, ModelVariantGroupSchema, MotionAnalysisResultSchema, MotionEventSchema, MotionOnMotionChangedDataSchema, MotionRegionSchema, MotionSourceEnum, MotionSourcesSchema, MotionStatusSchema, MotionTriggerRuntimeStateSchema, MotionTriggerStatusSchema, MotionZoneOptionsSchema, MotionZonePatchSchema, MotionZoneRegionSchema, MotionZoneStatusSchema, StatusSchema as MqttBrokerStatusSchema, MutationFilterSchema, NC_BASE_CONDITION_KEYS, NC_CONDITION_CATALOG, NC_HISTORY_LIMIT_DEFAULT, NC_HISTORY_LIMIT_MAX, NC_MAX_PER_TRACK_IMMEDIATE, NC_SNOOZE_MAX_MINUTES, NC_TAXONOMY, NativeCropBboxSchema, NativeCropRefSchema, NativeCropResultSchema, NativeDetectionSchema, NativeObjectClassEnum, NativeObjectDetectionRuntimeStateSchema, NativeObjectDetectionStatusSchema, NcAlarmConfigSchema, NcAlarmModeCoverageSchema, NcAlarmSettingsPatchSchema, NcAlarmSettingsSchema, NcConditionDescriptorSchema, NcConditionsSchema, NcCrossingSchema, NcDeliverySchema, NcDeviceStateConditionSchema, NcHistoryEntrySchema, NcHistoryFilterSchema, NcHistoryRecordKindSchema, NcHistoryStatusSchema, NcHistorySubjectSchema, NcMediaFrameSchema, NcMediaPolicySchema, NcOccupancyConditionSchema, NcPlateMatcherSchema, NcRuleActionSchema, NcRuleActionSequenceSchema, NcRuleActionsSchema, NcRuleInputSchema, NcRuleNotificationButtonSchema, NcRulePatchSchema, NcRuleSchema, NcRuleTargetSchema, NcScheduleSchema, NcScheduleWindowSchema, NcSnoozeInputSchema, NcSnoozeSchema, NcSnoozeScopeSchema, NcSnoozeSuppressedSchema, NcTaxonomyEntrySchema, NcTaxonomySchema, NcTestResultSchema, NcThrottleGranularitySchema, NcThrottleSchema, NcZoneConditionSchema, NetworkAccessStatusSchema, NetworkAddressSchema, NetworkEndpointSchema, NotificationActionIconSchema, NotificationActionSchema, NotificationFormatSchema, NotificationSchema, NotifierStatusSchema, NumericSensorStatusSchema, OPS_LOG_DEFAULT_LIMIT, OPS_LOG_RING_DEFAULT_MAX, OauthIntegrationDescriptorSchema, ObjectEventSchema, OpsLogDomainSchema, OpsLogEntrySchema, OpsLogOpSchema, OpsLogQueryInputSchema, OpsLogReasonSchema, OrchestratorMetricsSchema, OsdOverlayKindEnum, OsdOverlayPatchSchema, OsdOverlaySchema, OsdPositionEnum, OsdStatusSchema, PET_FEEDER_MANUAL_FEED_MAX, PET_FEEDER_MANUAL_FEED_MIN, PIPELINE_FLOW_CAPABILITY_NAMES, PIPELINE_OWNER_CAPABILITY_NAMES, PROVIDER_KIND_CAP_NAMES, PYTHON_SCRIPT, PackageUpdateSchema, PackageVersionInfoSchema, PasskeyLoginMethodSchema, PasskeySummarySchema, PcmSampleFormatSchema, PerScopeBreakdownSchema, PetFeederStatusSchema, PickStreamPreferencesSchema, PickStreamRequirementsSchema, PickedCamStreamSchema, PipelineAssignmentSchema, PipelineDefaultStepSchema, PipelineEngineChoiceSchema, PipelineRunResultBridge, PipelineStepInputSchema, PipelineValidationIssueSchema, PipelineValidationResultSchema, PlaceholderReasonSchema, PolygonPointSchema, PowerMeterStatusSchema, PresenceStatusSchema, PressureSensorStatusSchema, PrivacyMaskOptionsSchema, PrivacyMaskPatchSchema, PrivacyMaskRegionSchema, PrivacyMaskShapeSchema, PrivacyMaskStatusSchema, ProfileRtspEntrySchema, ProfileSlotSchema, ProfileSlotStatusSchema, ProviderStatusSchema, PtzAutotrackRuntimeStateSchema, PtzAutotrackSettingsSchema, PtzAutotrackStatusSchema, PtzAutotrackTargetOptionSchema, PtzMoveCommandSchema, PtzOptionsSchema, PtzPositionSchema, PtzPresetSchema, PtzStatusSchema, QueryFilterSchema, REACHABILITY_FAILURES_TO_OFFLINE, REACHABILITY_POLL_INTERVAL_MS, REACHABILITY_PROBE_TIMEOUT_MS, RECOGNITION_TYPES, RESERVED_BINDING_NAMES, RUNTIME_DEFAULTS, RUNTIME_TO_FORMAT, RawStateResultSchema, ReadSegmentBytesResultSchema, ReadinessRegistry, ReadinessTimeoutError, RecentTracksPageSchema, RecentTracksQueryInput, RecordingAvailabilitySchema, RecordingBandModeSchema, RecordingBandSchema, RecordingBandTriggersSchema, RecordingConfigSchema, RecordingDaysSchema, RecordingDeviceUsageSchema, RecordingLocationUsageSchema, RecordingManifestSchema, RecordingRangeSchema, RecordingRetentionSchema, RecordingStatusSchema, RecordingStorageModeSchema, RecordingStorageUsageSchema, RecordingTriggersSchema, RecordingWeekdaySchema, RedirectLoginMethodSchema, RelocateFootageInputSchema, RelocateJobSchema, RelocateJobStateSchema, RelocateMediaInputSchema, RenderedAsSchema, ReportMotionInputSchema, RingBuffer, RtpSourceSchema, RtspRestreamEntrySchema, RunnerCameraConfigSchema, RunnerCameraDeviceUIFields, RunnerFrameSourceSchema, RunnerInferenceDeviceSchema, RunnerLocalLoadSchema, RunnerLocalMetricsSchema, SCOPE_PRESETS, SCRUB_THUMBNAIL_PRESETS, SCRUB_THUMBNAIL_PRESET_LABELS, SCRUB_THUMBNAIL_PRESET_ORDER, SENSOR_FEATURES, SENSOR_MAP, SOURCE_INFO_METADATA_KEY, STREAM_PROFILE_META, STREAM_QUALITY_LABELS, SUB_DETECTION_TYPES, SYSTEM_CAP_NAMES, SceneCheckSchema, SceneConditionSchema, SceneMonitorSchema, SceneMonitorStateSchema, SceneMonitorStatusSchema, SceneReferenceSchema, ScopedTokenSchema, ScopedTokenSummarySchema, ScoredObjectEventSchema, ScriptRunnerStatusSchema, ScrubThumbnailPresetSchema, SearchResultSchema, SendEmailInputSchema, SendEmailResultSchema, SendResultSchema, SensorEventSchema, ServerBootModeSchema, ServerPackageStatusSchema, ServerRollbackInfoSchema, ServerUpdateActionResultSchema, ServerUpdateCheckResultSchema, ServerUpdateStateSchema, SettingsPatchSchema, SettingsRecordSchema, SettingsSchemaWithValuesSchema, SettingsUpdateResultSchema, ShmRingStatsSchema, SmokeStatusSchema, SmtpStatusSchema, SnapshotImageSchema, SourceInfoSchema, SpatialDetectionSchema, SsoBridgeClaimsSchema, StartEmbeddedInputSchema, StationaryObjectSchema, AbortUploadInputSchema as StorageAbortUploadInputSchema, BeginDownloadInputSchema as StorageBeginDownloadInputSchema, BeginDownloadResultSchema as StorageBeginDownloadResultSchema, BeginUploadInputSchema as StorageBeginUploadInputSchema, BeginUploadResultSchema as StorageBeginUploadResultSchema, EndDownloadInputSchema as StorageEndDownloadInputSchema, FinalizeUploadInputSchema as StorageFinalizeUploadInputSchema, StorageLocationDeclarationSchema, StorageLocationRefSchema, StorageLocationSchema, StorageLocationTypeSchema, ProviderInfoSchema as StorageProviderInfoSchema, ReadChunkInputSchema as StorageReadChunkInputSchema, TestLocationResultSchema as StorageTestLocationResultSchema, WriteChunkInputSchema as StorageWriteChunkInputSchema, StreamCodecSchema, StreamFormatSchema, StreamNetworkStatsSchema, StreamParamsOptionsSchema, StreamParamsStatusSchema, StreamProfileConfigSchema, StreamProfileOptionsSchema, StreamProfilePatchSchema, StreamProfileSchema, StreamSourceEntrySchema, StreamSourceSchema, SubscribeAudioChunksInputSchema, SubscribeAudioChunksResultSchema, SubscribeFramesInputSchema, SubscribeFramesResultSchema, SwitchStatusSchema, SystemMetricsSchema, SystemMirror, TAXONOMY_COLORS, TIMEZONES, TamperStatusSchema, TankStatusSchema, TargetKindCapsSchema, TargetKindLevelSchema, TargetKindSchema, TargetSchema, TemperatureSensorStatusSchema, TerminalProfileInfoSchema, TerminalSessionInfoSchema, TestConnectionResultSchema$1 as TestConnectionResultSchema, TestResultSchema, TimelapseRuleInputSchema, TimelapseRulePatchSchema, TimelapseRuleSchema, TimelapseTemplateSchema, ToastSchema, TokenScopeSchema, TopologyNodeSchema, TopologyProcessSchema, TopologyServiceSchema, TrackCascadeCountsSchema, TrackEnvelopeSchema, TrackProjectionSchema, TrackSchema, TrackStateSchema, TrackZoneFilterSchema, TrackedDetectionSchema, TurnServerSchema, UNIT_TABLE, BrokerInfoSchema$1 as UnifiedBrokerInfoSchema, UnitConversionError, UpdateIntegrationInputSchema, UpdateStatusSchema, UpdateUserInputSchema, UserRecordSchema, UserSummarySchema, VacuumControlStatusSchema, VacuumStateSchema, ValveStateSchema, ValveStatusSchema, VectorDeclareIndexInputSchema, VectorDeleteByFilterInputSchema, VectorDeleteInputSchema, VectorDeleteResultSchema, VectorFilterSchema, VectorGetInputSchema, VectorGetResultSchema, VectorItemSchema, VectorMatchSchema, VectorMetadataSchema, VectorMetricSchema, VectorQueryInputSchema, VectorQueryResultSchema, VectorStatsInputSchema, VectorStatsResultSchema, VectorUpsertInputSchema, VectorUpsertResultSchema, VibrationStatusSchema, VideoEncodeSchema, WELL_KNOWN_TABS, WELL_KNOWN_TAB_MAP, WaterHeaterStatusSchema, WeatherStatusSchema, WebrtcStreamChoiceSchema, WebrtcStreamTargetSchema, WhiteBalanceModeSchema, WidgetHostEnum, WidgetLoginMethodSchema, WidgetMetadataSchema, WidgetRemoteSchema, WidgetSizeEnum, YAMNET_TO_MACRO, ZoneCrossingDirectionSchema, ZoneCrossingSchema, ZoneKindEnum, ZoneRuleModeEnum, ZoneRuleSchema, ZoneRuleStageEnum, ZoneRulesArraySchema, ZoneSchema, ZoneScopeBreakdownSchema, accessoriesCapability, accessoryStableId, addonPagesCapability, addonPagesSourceCapability, addonRoutesCapability, addonSettingsCapability, addonWidgetsCapability, addonWidgetsSourceCapability, addonsCapability, adminUiCapability, airQualitySensorCapability, alarmPanelCapability, alertsCapability, ambientLightSensorCapability, applyTransform, asBoolean, asJsonArray, asJsonObject, asNumber, asString, audioAnalysisCapability, audioAnalyzerCapability, audioCodecCapability, audioMetricsCapability, authProviderCapability, autoAssignProfiles, automationControlCapability, backupCapability, batteryCapability, bestLocationMatch, binaryCapability, bindAddonActions, brightnessCapability, brokerCapability, buildAddonRouteProvider, buildEventKindDescriptor, buildModelVariantGroups, buildNcTaxonomy, buildStreamParamsConfigSchema, buttonCapability, cameraCredentialsCapability, cameraPipelineConfigCapability, cameraStreamsCapability, canConvertUnit, carbonMonoxideCapability, cellsToRects, classifyStream, classifyStreams, climateControlCapability, collectHydratedFieldEntries, collectHydratedFieldValues, colorCapability, colorForKind, compileExpression, compileExpressionSafe, connectivityCapability, consumablesCapability, contactCapability, controlCapability, convertUnit, coreBlocksCapability, cosineSimilarity, coverCapability, createDeviceProxy, createDurableState, createEvent, createExpressionScope, createLazyTrpcSource, createMirrorSource, createRuntimeStateBridge, createSliceHandle, createSystemProxy, customAction, customModelRegistryCapability, dataStoreProviderCapability, dayNightCapability, decodeVectorBase64, decoderCapability, defaultDeviceFor, defineCustomActions, deriveDetailCropRect, deriveRecordingMode, describeModelVariant, detectionPipelineCapability, deviceAdoptionCapability, deviceBackendToFormat, deviceCustomAction, deviceDiscoveryCapability, deviceExportCapability, deviceManagerCapability, deviceMatchesProfile, deviceOpsCapability, deviceProviderCapability, deviceStateCapability, deviceStatusCapability, doorbellCapability, embeddingEncoderCapability, emitDownForOwnedCaps, emitReadiness, encodeProfileFromStreamShape, encodeVectorBase64, enumSensorCapability, enumerateInferenceDevices, enumerateItemArrayFields, enumerateSchemaFields, errMsg, evaluateAst, evaluateLinkExpression, evaluateZoneRules, event, eventEmitterCapability, eventsCapability, expandCapMethods, extractNestedAddonId, extractSourceInfoFromMetadata, faceGalleryCapability, fanControlCapability, featureProbeCapability, filesystemBrowseCapability, findTimezone, floodCapability, formatForBackend, formatForRuntime, gasCapability, getAudioMacroClassIds, getByPath, getCapsByProviderKind, getTaxonomyEntry, hasMotionTrigger, hfModelUrl, htmlToText, humidifierCapability, humiditySensorCapability, hydrateSchema, imageCapability, imageSettingsCapability, integrationsCapability, intercomCapability, isAgentOnlyPlacement, isArrayOutputSchema, isBaseConditionKey, isCollectionArrayMethod, isDeployableToAgent, isDeviceConfigCap, isDeviceScopedCap, isEvent, isNode, isObjectInput, isVoidInput, jobKindSchema, kebabToCamel, knownValues, lawnMowerControlCapability, lifecycleJobSchema, lifecycleJobScopeSchema, lifecycleJobStateSchema, lifecycleTaskSchema, llmCapability, llmRuntimeCapability, localNetworkCapability, locationSimilarity, lockControlCapability, logDestinationCapability, logLevelAtMost, loginMethodCapability, looseSchema, makeProfileBrokerId, makeSourceBrokerId, mapAudioLabelToMacro, markdownToHtmlLite, markdownToText, maskUrlCredentials, mediaPlayerCapability, mergeSourceInfo, meshNetworkCapability, method, metricsProviderCapability, modelConvertCapability, modelDistributorCapability, modelFormatForRuntime, motionCapability, motionDetectionCapability, motionTriggerCapability, motionZonesCapability, mqttBrokerCapability, nativeObjectDetectionCapability, networkAccessCapability, networkQualityCapability, nodePin, nodesCapability, normalizeAddonInitResult, normalizeUnit, notificationOutputCapability, notificationRulesCapability, notifierCapability, numericSensorCapability, oauthIntegrationCapability, objectInputDeclaresAddonId, osdCapability, parseCameraStreamConfig, parseExpression, parseJsonArray, parseJsonObject, parseJsonUnknown, parseProfileBrokerId, parseStreamParamsFormPatch, petFeederCapability, pickAccessoryControl, pickDetailCropConvention, pickPreferredRtspEntry, pickerForCondition, pipelineAnalyticsCapability, pipelineExecutorCapability, pipelineOrchestratorCapability, pipelineRunnerCapability, plateGalleryCapability, platformProbeCapability, powerMeterCapability, prepareNotification, presenceCapability, pressureSensorCapability, privacyMaskCapability, procedureAuthKey, ptzAutotrackCapability, ptzCapability, pythonScriptForBackend, readDetailCropConvention, readDeviceStateFrom, readNodePin, readinessKey, rebootCapability, recordingCapability, recordingExportCapability, rectsToCells, requiresPython, resolveAddonExecution, resolveAddonGroup, resolveAddonPlacement, resolveAddonRuntime, resolveCapMount, resolveDetectionRuntime, resolveDeviceControlKind, resolveDeviceProfile, resolveFormat, resolveHydratedFieldValue, resolveModelFormat, resolveMutate, resolveRunnerId, resolveScrubThumbnailGeometry, resolveVariantModelId, runInferenceStep, runtimeDevices, sceneMonitorCapability, scopeKey, scoreRuntimes, scriptRunnerCapability, selectAssignedProfileSlots, serverManagementCapability, setByPath, settingsStoreCapability, sleep, sleepCancellable, smokeCapability, smtpProviderCapability, snapshotCapability, ssoBridgeCapability, startReachabilityPoll, stateVocabularyFor, storageCapability, storageEvictableCapability, storageProviderCapability, streamBrokerCapability, streamCatalogCapability, streamParamsCapability, streamPixels, streamQualityLabel, subKindsOf, supportedRuntimes, switchCapability, synthesizeSourceInfo, systemCapability, tamperCapability, taskLogEntrySchema, taskPhaseSchema, taskTargetSchema, temperatureSensorCapability, terminalSessionCapability, textToHtml, toDeviceSummary, toExpressionValue, toStreamSourceEntry, toastCapability, tokenize, transcodeBody, tryConvertUnit, turnProviderCapability, unitDimension, unitsForDimension, updateCapability, userManagementCapability, userPasskeysCapability, vacuumControlCapability, validateExpressionSource, valveCapability, vectorDimFromBase64, vectorStoreCapability, vibrationCapability, videoclipsCapability, viewerUiCapability, waterHeaterCapability, weatherCapability, webrtcClientHintsSchema, webrtcSessionCapability, wiringAddonHealthSchema, wiringHealthSnapshotSchema, wiringNodeHealthSchema, wiringProbeKindSchema, wiringProbeResultSchema, zodEntriesToConfigUI, zoneAnalyticsCapability, zoneRulesCapability, zonesCapability };

package/dist/pipeline/detail-crop.d.ts

@@ -0,0 +1,122 @@
+/**
+ * THE detail-crop convention — the single derivation of the rectangle a
+ * detail/enrichment step (clip-embedding, face-detection, plate-detection…)
+ * is fed.
+ *
+ * ## Why this is one module and not two constants
+ *
+ * `object-clip` is ONE vector index, and cosine similarity is only meaningful
+ * between vectors produced from the same crop convention. Two encode paths
+ * write into it — the live detail plane and the embedding rebuild — and they
+ * used to derive their crops independently: `DETAIL_CROP_PADDING_RATIO = 0.15`
+ * with no squaring on one side, `DEFAULT_CROP_MARGIN = 0.2` with squaring on
+ * by default on the other. Every rebuild therefore poured a second, silently
+ * incomparable feature space into the index it exists to keep consistent.
+ *
+ * So the rectangle is derived HERE, once, from ONE convention value. Both
+ * paths now reach this function through `pipelineRunner.runDetailSubtree` —
+ * the runner is the only process that cuts (see `detail-subtree.ts`), and the
+ * convention is a cluster-global `pipeline-orchestrator` setting. There is
+ * deliberately no per-node or per-device scope: a per-accelerator crop margin
+ * would reintroduce the same split, merely relocated.
+ *
+ * ## The default IS the live convention
+ *
+ * {@link DEFAULT_DETAIL_CROP_CONVENTION} reproduces what the live path has
+ * been storing (0.15, no squaring). Anything else would invalidate every
+ * vector already in the index on the day it shipped. Changing the convention
+ * is legitimate — that is what the operator knob is for — but it must be
+ * followed by a rebuild, which is now guaranteed to produce crops from this
+ * same function.
+ */
+import { z } from 'zod';
+/**
+ * Store identity of the convention in `pipeline-orchestrator`'s GLOBAL
+ * (cluster-wide) settings.
+ *
+ * These live here rather than in the orchestrator because the reader is a
+ * different addon — the pipeline runner, over the hub-routed `addon-settings`
+ * cap. Addons never import each other, so a key owned by the writer would have
+ * to be hand-copied by the reader, and a hand-copied key is how a setting
+ * silently stops arriving while both sides still look correct.
+ */
+export declare const DETAIL_CROP_SECTION_ID = "detail-crop";
+export declare const DETAIL_CROP_PADDING_KEY = "detailCropPaddingRatio";
+export declare const DETAIL_CROP_SQUARE_KEY = "detailCropSquare";
+/** A `{x,y,w,h}` rectangle in FRAME-space pixels. */
+export interface DetailCropRect {
+    readonly x: number;
+    readonly y: number;
+    readonly w: number;
+    readonly h: number;
+}
+/**
+ * Operator-tunable crop convention. Single-valued and cluster-wide — see the
+ * module docblock for why it cannot be scoped per node or per device.
+ */
+export declare const DetailCropConventionSchema: z.ZodObject<{
+    paddingRatio: z.ZodNumber;
+    square: z.ZodBoolean;
+}, z.core.$strip>;
+export type DetailCropConvention = z.infer<typeof DetailCropConventionSchema>;
+/**
+ * The convention in force when nobody has configured one — byte-for-byte the
+ * behaviour of the pre-unification LIVE path (`DETAIL_CROP_PADDING_RATIO`).
+ */
+export declare const DEFAULT_DETAIL_CROP_CONVENTION: DetailCropConvention;
+/**
+ * Narrow a FLAT settings record to the convention.
+ *
+ * Per-FIELD fallback, deliberately: a junk padding must not also discard a
+ * valid squaring choice. An absent or invalid value resolves to
+ * {@link DEFAULT_DETAIL_CROP_CONVENTION} — the historical live behaviour —
+ * rather than to a clamped number nobody chose, so a bad read can never
+ * quietly change what the stored vectors mean.
+ */
+export declare function readDetailCropConvention(config: Readonly<Record<string, unknown>>): DetailCropConvention;
+/** One section of an `addon-settings.getGlobalSettings` payload. */
+export interface HydratedSettingsSection {
+    readonly fields: readonly unknown[];
+}
+/**
+ * Minimal structural view of `ConfigUISchemaWithValues` — only what the
+ * convention extraction walks. Structural on purpose: the reader is an addon
+ * that must not depend on the writer's schema type.
+ */
+export interface HydratedSettingsView {
+    readonly sections: readonly HydratedSettingsSection[];
+}
+/**
+ * Extract the convention from an `addon-settings.getGlobalSettings` payload.
+ *
+ * Walks EVERY section rather than looking inside {@link DETAIL_CROP_SECTION_ID}
+ * alone: the keys are unique across the addon's schema, and a section rename
+ * must not silently revert the whole cluster to the default. A `null` payload
+ * (addon mid-boot) is the default convention.
+ */
+export declare function pickDetailCropConvention(view: HydratedSettingsView | null): DetailCropConvention;
+/** Slider bounds for the operator-facing padding knob (orchestrator settings UI). */
+export declare const DETAIL_CROP_PADDING_FIELD: {
+    readonly min: 0;
+    readonly max: 1;
+    readonly step: 0.05;
+    readonly default: number;
+};
+/**
+ * Derive the crop rectangle for one parent detection.
+ *
+ * Order: pad by `paddingRatio` of the box's own size → optionally square in
+ * pixel space around the padded centre → keep it inside the frame. Pure:
+ * always returns a new rect and never mutates `bbox`.
+ *
+ * Edge handling differs by mode, on purpose:
+ *
+ * - **unsquared** — TRUNCATED at the frame border, byte-for-byte what the live
+ *   path has always done (`padAndClampFrameBbox`). A subject against the edge
+ *   gets a slightly smaller window. Changing this would silently reinterpret
+ *   every edge-touching vector already in the index.
+ * - **squared** — SLID inward instead, because a truncated square is not
+ *   square and squaring exists precisely to preserve the aspect the model
+ *   sees. It only shrinks when the square is larger than the frame itself.
+ */
+export declare function deriveDetailCropRect(bbox: DetailCropRect, frameWidth: number, frameHeight: number, convention: DetailCropConvention): DetailCropRect;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/types",
-  "version": "1.2.40",
+  "version": "1.2.41",
   "description": "Shared types, interfaces, and model catalogs for the CamStack detection ecosystem",
   "keywords": [
     "camstack",