@camstack/types 1.2.165 → 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/capabilities/privacy-mask.cap.d.ts

@@ -62,7 +62,7 @@ export declare const PrivacyMaskRegionSchema: z.ZodObject<{
 /** Current on-camera privacy state — mask master enable + zones + microphone. */
 export declare const PrivacyMaskStatusSchema: z.ZodObject<{
     enabled: z.ZodBoolean;
-    regions: z.ZodArray<z.ZodObject<{
+    regions: z.ZodNullable<z.ZodArray<z.ZodObject<{
         id: z.ZodNumber;
         enabled: z.ZodBoolean;
         shape: z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -78,7 +78,7 @@ export declare const PrivacyMaskStatusSchema: z.ZodObject<{
                 y: z.ZodNumber;
             }, z.core.$strip>>;
         }, z.core.$strip>], "kind">;
-    }, z.core.$strip>>;
+    }, z.core.$strip>>>;
     audioEnabled: z.ZodNullable<z.ZodBoolean>;
     lastFetchedAt: z.ZodNumber;
 }, z.core.$strip>;
@@ -199,7 +199,7 @@ export declare const privacyMaskCapability: {
     readonly status: {
         readonly schema: z.ZodObject<{
             enabled: z.ZodBoolean;
-            regions: z.ZodArray<z.ZodObject<{
+            regions: z.ZodNullable<z.ZodArray<z.ZodObject<{
                 id: z.ZodNumber;
                 enabled: z.ZodBoolean;
                 shape: z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -215,7 +215,7 @@ export declare const privacyMaskCapability: {
                         y: z.ZodNumber;
                     }, z.core.$strip>>;
                 }, z.core.$strip>], "kind">;
-            }, z.core.$strip>>;
+            }, z.core.$strip>>>;
             audioEnabled: z.ZodNullable<z.ZodBoolean>;
             lastFetchedAt: z.ZodNumber;
         }, z.core.$strip>;
@@ -223,7 +223,7 @@ export declare const privacyMaskCapability: {
     };
     readonly runtimeState: z.ZodObject<{
         enabled: z.ZodBoolean;
-        regions: z.ZodArray<z.ZodObject<{
+        regions: z.ZodNullable<z.ZodArray<z.ZodObject<{
             id: z.ZodNumber;
             enabled: z.ZodBoolean;
             shape: z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -239,7 +239,7 @@ export declare const privacyMaskCapability: {
                     y: z.ZodNumber;
                 }, z.core.$strip>>;
             }, z.core.$strip>], "kind">;
-        }, z.core.$strip>>;
+        }, z.core.$strip>>>;
         audioEnabled: z.ZodNullable<z.ZodBoolean>;
         lastFetchedAt: z.ZodNumber;
     }, 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.
@@ -32200,8 +32230,27 @@ var PrivacyMaskRegionSchema = zod.z.object({
 /** Current on-camera privacy state — mask master enable + zones + microphone. */
 var PrivacyMaskStatusSchema = zod.z.object({
 	enabled: zod.z.boolean(),
-	/** Active zones (normalized 0..1). Length ≤ maxRegions. */
-	regions: zod.z.array(PrivacyMaskRegionSchema),
+	/**
+	* Active zones (normalized 0..1). Length ≤ maxRegions.
+	*
+	* `null` means "no answer" — the provider has never reached this camera
+	* (a cold `runtimeState` slice, a battery camera asleep) or the read
+	* failed. A consumer must render it as UNKNOWN and never as "this camera
+	* has no zones": those two look identical to an operator right up to the
+	* moment one of them is acted on, and acting on them differs completely.
+	* The switch group turned an unanswered read into *"nothing is set up for
+	* it to act on"* — an instruction to go and draw a zone that already
+	* exists — and this editor seeded an EMPTY canvas from it, one Save away
+	* from deleting the mask it could not read.
+	*
+	* Empty-and-answered is `[]` and stays a real answer: this camera genuinely
+	* has no zones. The distinction is the same one {@link
+	* PrivacyMaskStatusSchema.shape.audioEnabled} already draws for the
+	* microphone, on the very same payload — both planes come from ONE refresh,
+	* so it was never coherent for one of them to be able to say "unknown"
+	* while the other could not.
+	*/
+	regions: zod.z.array(PrivacyMaskRegionSchema).nullable(),
 	/**
 	* Is the camera capturing sound right now? Read from the camera, never from
 	* a server-side mirror.

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.
@@ -32199,8 +32229,27 @@ var PrivacyMaskRegionSchema = z.object({
 /** Current on-camera privacy state — mask master enable + zones + microphone. */
 var PrivacyMaskStatusSchema = z.object({
 	enabled: z.boolean(),
-	/** Active zones (normalized 0..1). Length ≤ maxRegions. */
-	regions: z.array(PrivacyMaskRegionSchema),
+	/**
+	* Active zones (normalized 0..1). Length ≤ maxRegions.
+	*
+	* `null` means "no answer" — the provider has never reached this camera
+	* (a cold `runtimeState` slice, a battery camera asleep) or the read
+	* failed. A consumer must render it as UNKNOWN and never as "this camera
+	* has no zones": those two look identical to an operator right up to the
+	* moment one of them is acted on, and acting on them differs completely.
+	* The switch group turned an unanswered read into *"nothing is set up for
+	* it to act on"* — an instruction to go and draw a zone that already
+	* exists — and this editor seeded an EMPTY canvas from it, one Save away
+	* from deleting the mask it could not read.
+	*
+	* Empty-and-answered is `[]` and stays a real answer: this camera genuinely
+	* has no zones. The distinction is the same one {@link
+	* PrivacyMaskStatusSchema.shape.audioEnabled} already draws for the
+	* microphone, on the very same payload — both planes come from ONE refresh,
+	* so it was never coherent for one of them to be able to say "unknown"
+	* while the other could not.
+	*/
+	regions: z.array(PrivacyMaskRegionSchema).nullable(),
 	/**
 	* Is the camera capturing sound right now? Read from the camera, never from
 	* a server-side mirror.

package/package.json

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