@camstack/types 1.2.157 → 1.2.158

package/dist/types/detection.d.ts

@@ -9,6 +9,13 @@ export interface SpatialDetection {
     readonly mask?: Uint8Array;
     readonly maskWidth?: number;
     readonly maskHeight?: number;
+    /**
+     * Mirrored from {@link ObjectDetection.nativeRecovery} when this detection
+     * enters the tracker. The tracker's SPAWN gates (per-class score floor,
+     * person-over-animal dedup) are tuned for the coarse full-frame pass; a box
+     * measured at native resolution is not the thing they exist to kill.
+     */
+    readonly nativeRecovery?: NativeRecoveryEvidence;
 }
 export interface CropInput {
     readonly frame: FrameInput;
@@ -216,6 +223,37 @@ export interface DetectionBase {
     readonly labels: readonly ScoredLabel[];
     readonly track?: TrackInfo;
     readonly debug?: DetectionDebug;
+    /**
+     * Present when this box did NOT come from the full-frame pass but from a
+     * SECOND detector pass on a native-resolution crop of a motion region
+     * (`small-subject-recovery.ts` in the runner). See
+     * {@link NativeRecoveryEvidence}.
+     */
+    readonly nativeRecovery?: NativeRecoveryEvidence;
+}
+/**
+ * What a native-resolution second pass ALREADY measured about a box.
+ *
+ * The first-level detector sees a 4K frame at 320 px: a 100 px dog is 8 px and
+ * is not emitted. The runner's recovery pass re-runs THE SAME detector on a
+ * 640–800 px native square around the moving region and finds it at 0.82–0.91
+ * (`docs/benchmarks/pipeline-frame-model-eval.md`, case `miss-dog-615`). That
+ * pass is already a second look at better pixels — so every downstream gate
+ * whose job is to ask "did the coarse pass see a real thing?" has its answer,
+ * and re-deriving a THIRD, tighter crop of the same subject can only lose
+ * information (D377).
+ *
+ * Carried from the runner to post-analysis on the emitted frame result and
+ * mirrored onto the tracker's {@link SpatialDetection}. Plain data: no pixels,
+ * no handle — the crop it names is long gone, and its VERDICT is what travels.
+ */
+export interface NativeRecoveryEvidence {
+    /** Score the second pass measured, on the native crop, with the same model. */
+    readonly score: number;
+    /** Side of the native square the crop was cut from, in native pixels. */
+    readonly cropSidePx: number;
+    /** Side of the compressed view the model actually saw, in pixels. */
+    readonly viewPx: number;
 }
 /** Object detection (first-level person/vehicle/animal OR detail face/plate). */
 export interface ObjectDetection extends DetectionBase {

package/package.json

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