@camstack/types 1.2.166 → 1.2.167

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

@@ -444,6 +444,11 @@ declare const TrackSchema: z.ZodObject<{
             w: z.ZodNumber;
             h: z.ZodNumber;
         }, z.core.$strip>;
+        source: z.ZodOptional<z.ZodEnum<{
+            frame: "frame";
+            recovery: "recovery";
+        }>>;
+        score: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>>>;
     snapshots: z.ZodReadonly<z.ZodArray<z.ZodObject<{
         timestamp: z.ZodNumber;
@@ -457,6 +462,11 @@ declare const TrackSchema: z.ZodObject<{
                 w: z.ZodNumber;
                 h: z.ZodNumber;
             }, z.core.$strip>;
+            source: z.ZodOptional<z.ZodEnum<{
+                frame: "frame";
+                recovery: "recovery";
+            }>>;
+            score: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strip>;
         mediaKey: z.ZodString;
     }, z.core.$strip>>>;
@@ -1240,6 +1250,11 @@ declare const RecentTracksPageSchema: z.ZodObject<{
                 w: z.ZodNumber;
                 h: z.ZodNumber;
             }, z.core.$strip>;
+            source: z.ZodOptional<z.ZodEnum<{
+                frame: "frame";
+                recovery: "recovery";
+            }>>;
+            score: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strip>>>;
         snapshots: z.ZodReadonly<z.ZodArray<z.ZodObject<{
             timestamp: z.ZodNumber;
@@ -1253,6 +1268,11 @@ declare const RecentTracksPageSchema: z.ZodObject<{
                     w: z.ZodNumber;
                     h: z.ZodNumber;
                 }, z.core.$strip>;
+                source: z.ZodOptional<z.ZodEnum<{
+                    frame: "frame";
+                    recovery: "recovery";
+                }>>;
+                score: z.ZodOptional<z.ZodNumber>;
             }, z.core.$strip>;
             mediaKey: z.ZodString;
         }, z.core.$strip>>>;
@@ -1705,6 +1725,11 @@ export declare const pipelineAnalyticsCapability: {
                     w: z.ZodNumber;
                     h: z.ZodNumber;
                 }, z.core.$strip>;
+                source: z.ZodOptional<z.ZodEnum<{
+                    frame: "frame";
+                    recovery: "recovery";
+                }>>;
+                score: z.ZodOptional<z.ZodNumber>;
             }, z.core.$strip>>>;
             snapshots: z.ZodReadonly<z.ZodArray<z.ZodObject<{
                 timestamp: z.ZodNumber;
@@ -1718,6 +1743,11 @@ export declare const pipelineAnalyticsCapability: {
                         w: z.ZodNumber;
                         h: z.ZodNumber;
                     }, z.core.$strip>;
+                    source: z.ZodOptional<z.ZodEnum<{
+                        frame: "frame";
+                        recovery: "recovery";
+                    }>>;
+                    score: z.ZodOptional<z.ZodNumber>;
                 }, z.core.$strip>;
                 mediaKey: z.ZodString;
             }, z.core.$strip>>>;
@@ -1804,6 +1834,11 @@ export declare const pipelineAnalyticsCapability: {
                     w: z.ZodNumber;
                     h: z.ZodNumber;
                 }, z.core.$strip>;
+                source: z.ZodOptional<z.ZodEnum<{
+                    frame: "frame";
+                    recovery: "recovery";
+                }>>;
+                score: z.ZodOptional<z.ZodNumber>;
             }, z.core.$strip>>>;
             snapshots: z.ZodReadonly<z.ZodArray<z.ZodObject<{
                 timestamp: z.ZodNumber;
@@ -1817,6 +1852,11 @@ export declare const pipelineAnalyticsCapability: {
                         w: z.ZodNumber;
                         h: z.ZodNumber;
                     }, z.core.$strip>;
+                    source: z.ZodOptional<z.ZodEnum<{
+                        frame: "frame";
+                        recovery: "recovery";
+                    }>>;
+                    score: z.ZodOptional<z.ZodNumber>;
                 }, z.core.$strip>;
                 mediaKey: z.ZodString;
             }, z.core.$strip>>>;
@@ -1932,6 +1972,11 @@ export declare const pipelineAnalyticsCapability: {
                     w: z.ZodNumber;
                     h: z.ZodNumber;
                 }, z.core.$strip>;
+                source: z.ZodOptional<z.ZodEnum<{
+                    frame: "frame";
+                    recovery: "recovery";
+                }>>;
+                score: z.ZodOptional<z.ZodNumber>;
             }, z.core.$strip>>>;
             snapshots: z.ZodReadonly<z.ZodArray<z.ZodObject<{
                 timestamp: z.ZodNumber;
@@ -1945,6 +1990,11 @@ export declare const pipelineAnalyticsCapability: {
                         w: z.ZodNumber;
                         h: z.ZodNumber;
                     }, z.core.$strip>;
+                    source: z.ZodOptional<z.ZodEnum<{
+                        frame: "frame";
+                        recovery: "recovery";
+                    }>>;
+                    score: z.ZodOptional<z.ZodNumber>;
                 }, z.core.$strip>;
                 mediaKey: z.ZodString;
             }, z.core.$strip>>>;
@@ -2056,6 +2106,11 @@ export declare const pipelineAnalyticsCapability: {
                         w: z.ZodNumber;
                         h: z.ZodNumber;
                     }, z.core.$strip>;
+                    source: z.ZodOptional<z.ZodEnum<{
+                        frame: "frame";
+                        recovery: "recovery";
+                    }>>;
+                    score: z.ZodOptional<z.ZodNumber>;
                 }, z.core.$strip>>>;
                 snapshots: z.ZodReadonly<z.ZodArray<z.ZodObject<{
                     timestamp: z.ZodNumber;
@@ -2069,6 +2124,11 @@ export declare const pipelineAnalyticsCapability: {
                             w: z.ZodNumber;
                             h: z.ZodNumber;
                         }, z.core.$strip>;
+                        source: z.ZodOptional<z.ZodEnum<{
+                            frame: "frame";
+                            recovery: "recovery";
+                        }>>;
+                        score: z.ZodOptional<z.ZodNumber>;
                     }, z.core.$strip>;
                     mediaKey: z.ZodString;
                 }, z.core.$strip>>>;

package/dist/index.js

@@ -18568,11 +18568,30 @@ var SensorEventSchema = zod.z.object({
 	value: zod.z.record(zod.z.string(), zod.z.unknown()).nullable(),
 	timestamp: zod.z.number()
 });
+/**
+* One stored sighting on a track's trajectory.
+*
+* The array these live in is returned in TIME order (D399) — it is APPENDED in
+* arrival order, and the two detector passes interleave, so a consumer must not
+* assume the two are the same on a row written by an older build.
+*/
 var TrackPositionSchema = zod.z.object({
 	x: zod.z.number(),
 	y: zod.z.number(),
 	timestamp: zod.z.number(),
-	bbox: BoundingBoxSchema
+	bbox: BoundingBoxSchema,
+	/**
+	* Which detector pass measured this box (D399): `frame` is the full-frame
+	* pass on the analysis raster, `recovery` is the native-resolution
+	* small-subject second pass (D377/D378). Both write into one array, and until
+	* this field existed the only way to tell them apart was that full-frame boxes
+	* are exact multiples of 1.2 while recovery boxes are full-precision floats.
+	* Absent on rows written before D399.
+	*/
+	source: zod.z.enum(["frame", "recovery"]).optional(),
+	/** Detection score of this box, so a position can be weighed and not only
+	*  plotted. Absent on rows written before D399. */
+	score: zod.z.number().optional()
 });
 var TrackSnapshotSchema = zod.z.object({
 	timestamp: zod.z.number(),
@@ -18999,14 +19018,25 @@ var TrackSchema = zod.z.object({
 	*/
 	hasRider: zod.z.boolean().optional(),
 	/**
-	* WHY this track ended without a NATIVE best-shot tile
-	* ([D276](../decisions/adr-0276-a-stand-in-tile-is-provisional-and-a-close-says-why.md)) —
+	* WHY this track ended without a NATIVE best-shot FRAME
+	* ([D276](../decisions/adr-0276-a-stand-in-tile-is-provisional-and-a-close-says-why.md),
+	* widened by [D400](../decisions/adr-0400-the-picture-is-judged-on-what-is-delivered.md)) —
 	* a composed token line (`no-key-frame capture=keyframe:native-missx4`,
-	* `derive-returned-null tile=standin`, …) written at close and CLEARED by
-	* the late-keyFrame upgrade when a native tile lands after all. The
-	* operator-facing answer to "perché manca l'immagine?" on a track whose
+	* `derive-returned-null tile=standin`,
+	* `native-tile tile=native no-key-frame-at-close`, …) written at close and
+	* CLEARED by the late-keyFrame upgrade when a native tile lands after all.
+	* The operator-facing answer to "perché manca l'immagine?" on a track whose
 	* tile is a face/plate stand-in, a raster crop, or an icon.
 	*
+	* **`no-key-frame-at-close` (D400).** The line used to be written ONLY when
+	* the TILE ranked below native, so a track whose thumbnail landed natively
+	* while its key frame missed carried no reason at all — three of the four
+	* `MISSING_KEYFRAME` tracks in the 2026-09-07 operator audit were exactly
+	* that shape, and their "niente ultimo" had no cause anywhere on the row.
+	* The key frame is the head of a cascade (`keyFrame ⇒ keyFrameSmall ⇒ the
+	* lastFrame copy source`), so its absence is now on this line whatever the
+	* tile ended up being.
+	*
 	* **Absent ≠ "missed silently"**: a row written before the column, a hub
 	* that predates the field, and every track whose tile landed native all
 	* omit it. Render nothing when absent.

package/dist/index.mjs

@@ -18567,11 +18567,30 @@ var SensorEventSchema = z.object({
 	value: z.record(z.string(), z.unknown()).nullable(),
 	timestamp: z.number()
 });
+/**
+* One stored sighting on a track's trajectory.
+*
+* The array these live in is returned in TIME order (D399) — it is APPENDED in
+* arrival order, and the two detector passes interleave, so a consumer must not
+* assume the two are the same on a row written by an older build.
+*/
 var TrackPositionSchema = z.object({
 	x: z.number(),
 	y: z.number(),
 	timestamp: z.number(),
-	bbox: BoundingBoxSchema
+	bbox: BoundingBoxSchema,
+	/**
+	* Which detector pass measured this box (D399): `frame` is the full-frame
+	* pass on the analysis raster, `recovery` is the native-resolution
+	* small-subject second pass (D377/D378). Both write into one array, and until
+	* this field existed the only way to tell them apart was that full-frame boxes
+	* are exact multiples of 1.2 while recovery boxes are full-precision floats.
+	* Absent on rows written before D399.
+	*/
+	source: z.enum(["frame", "recovery"]).optional(),
+	/** Detection score of this box, so a position can be weighed and not only
+	*  plotted. Absent on rows written before D399. */
+	score: z.number().optional()
 });
 var TrackSnapshotSchema = z.object({
 	timestamp: z.number(),
@@ -18998,14 +19017,25 @@ var TrackSchema = z.object({
 	*/
 	hasRider: z.boolean().optional(),
 	/**
-	* WHY this track ended without a NATIVE best-shot tile
-	* ([D276](../decisions/adr-0276-a-stand-in-tile-is-provisional-and-a-close-says-why.md)) —
+	* WHY this track ended without a NATIVE best-shot FRAME
+	* ([D276](../decisions/adr-0276-a-stand-in-tile-is-provisional-and-a-close-says-why.md),
+	* widened by [D400](../decisions/adr-0400-the-picture-is-judged-on-what-is-delivered.md)) —
 	* a composed token line (`no-key-frame capture=keyframe:native-missx4`,
-	* `derive-returned-null tile=standin`, …) written at close and CLEARED by
-	* the late-keyFrame upgrade when a native tile lands after all. The
-	* operator-facing answer to "perché manca l'immagine?" on a track whose
+	* `derive-returned-null tile=standin`,
+	* `native-tile tile=native no-key-frame-at-close`, …) written at close and
+	* CLEARED by the late-keyFrame upgrade when a native tile lands after all.
+	* The operator-facing answer to "perché manca l'immagine?" on a track whose
 	* tile is a face/plate stand-in, a raster crop, or an icon.
 	*
+	* **`no-key-frame-at-close` (D400).** The line used to be written ONLY when
+	* the TILE ranked below native, so a track whose thumbnail landed natively
+	* while its key frame missed carried no reason at all — three of the four
+	* `MISSING_KEYFRAME` tracks in the 2026-09-07 operator audit were exactly
+	* that shape, and their "niente ultimo" had no cause anywhere on the row.
+	* The key frame is the head of a cascade (`keyFrame ⇒ keyFrameSmall ⇒ the
+	* lastFrame copy source`), so its absence is now on this line whatever the
+	* tile ended up being.
+	*
 	* **Absent ≠ "missed silently"**: a row written before the column, a hub
 	* that predates the field, and every track whose tile landed native all
 	* omit it. Render nothing when absent.

package/package.json

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