@camstack/types 1.2.257 → 1.2.259

package/dist/capabilities/custom-model-registry.cap.d.ts

@@ -103,6 +103,7 @@ export declare const CustomModelDescriptorSchema: z.ZodObject<{
         }>>;
         inputNormalization: z.ZodOptional<z.ZodEnum<{
             none: "none";
+            scrfd: "scrfd";
             "zero-one": "zero-one";
             imagenet: "imagenet";
         }>>;
@@ -256,6 +257,7 @@ export declare const customModelRegistryCapability: {
                 }>>;
                 inputNormalization: z.ZodOptional<z.ZodEnum<{
                     none: "none";
+                    scrfd: "scrfd";
                     "zero-one": "zero-one";
                     imagenet: "imagenet";
                 }>>;

package/dist/capabilities/model-convert.cap.d.ts

@@ -22,6 +22,7 @@ export declare const ModelConvertInputSchema: z.ZodObject<{
         }>>;
         inputNormalization: z.ZodOptional<z.ZodEnum<{
             none: "none";
+            scrfd: "scrfd";
             "zero-one": "zero-one";
             imagenet: "imagenet";
         }>>;
@@ -89,6 +90,7 @@ export declare const modelConvertCapability: {
                 }>>;
                 inputNormalization: z.ZodOptional<z.ZodEnum<{
                     none: "none";
+                    scrfd: "scrfd";
                     "zero-one": "zero-one";
                     imagenet: "imagenet";
                 }>>;
@@ -211,6 +213,7 @@ export declare const modelConvertCapability: {
                 }>>;
                 inputNormalization: z.ZodOptional<z.ZodEnum<{
                     none: "none";
+                    scrfd: "scrfd";
                     "zero-one": "zero-one";
                     imagenet: "imagenet";
                 }>>;

package/dist/capabilities/model-distributor.cap.d.ts

@@ -105,6 +105,7 @@ export declare const ModelDistributeInputSchema: z.ZodObject<{
         }>>;
         inputNormalization: z.ZodOptional<z.ZodEnum<{
             none: "none";
+            scrfd: "scrfd";
             "zero-one": "zero-one";
             imagenet: "imagenet";
         }>>;
@@ -263,6 +264,7 @@ export declare const modelDistributorCapability: {
                 }>>;
                 inputNormalization: z.ZodOptional<z.ZodEnum<{
                     none: "none";
+                    scrfd: "scrfd";
                     "zero-one": "zero-one";
                     imagenet: "imagenet";
                 }>>;

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

@@ -124,6 +124,10 @@ declare const DetailResultSchema: z.ZodObject<{
     labelModelId: z.ZodOptional<z.ZodString>;
     alignedCropJpeg: z.ZodOptional<z.ZodString>;
     nativeFaceShortSidePx: z.ZodOptional<z.ZodNumber>;
+    landmarks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+    }, z.core.$strip>>>;
 }, z.core.$strip>;
 export type DetailParent = z.infer<typeof DetailParentSchema>;
 export type DetailResult = z.infer<typeof DetailResultSchema>;
@@ -1011,6 +1015,10 @@ export declare const pipelineRunnerCapability: {
                 labelModelId: z.ZodOptional<z.ZodString>;
                 alignedCropJpeg: z.ZodOptional<z.ZodString>;
                 nativeFaceShortSidePx: z.ZodOptional<z.ZodNumber>;
+                landmarks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    x: z.ZodNumber;
+                    y: z.ZodNumber;
+                }, z.core.$strip>>>;
             }, z.core.$strip>>;
         }, z.core.$strip>>, "mutation">;
         /**
@@ -1091,6 +1099,10 @@ export declare const pipelineRunnerCapability: {
                 labelModelId: z.ZodOptional<z.ZodString>;
                 alignedCropJpeg: z.ZodOptional<z.ZodString>;
                 nativeFaceShortSidePx: z.ZodOptional<z.ZodNumber>;
+                landmarks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    x: z.ZodNumber;
+                    y: z.ZodNumber;
+                }, z.core.$strip>>>;
             }, z.core.$strip>>;
         }, z.core.$strip>, z.ZodObject<{
             kind: z.ZodLiteral<"refused">;

package/dist/index.js

@@ -5147,10 +5147,17 @@ var ModelCatalogEntrySchema = zod.z.object({
 	inputChannels: zod.z.number().int().positive().optional(),
 	labels: zod.z.array(LabelDefinitionSchema).readonly(),
 	inputLayout: zod.z.enum(["nchw", "nhwc"]).optional(),
+	/**
+	* `'scrfd'` applies InsightFace's SCRFD input contract, `(x - 127.5) / 128`
+	* (upstream `insightface/model_zoo/scrfd.py`), instead of the historical
+	* plain `/255`. Measured against COCO GT: 188 → 196 faces found on the
+	* `scrfd-2.5g` catalog entry (2026-09-26 model-replacement spike, §2.4-2).
+	*/
 	inputNormalization: zod.z.enum([
 		"zero-one",
 		"imagenet",
-		"none"
+		"none",
+		"scrfd"
 	]).optional(),
 	/**
 	* The model already applies softmax IN-GRAPH — its raw output is a
@@ -5252,7 +5259,8 @@ var ModelConvertMetadataSchema = zod.z.object({
 	inputNormalization: zod.z.enum([
 		"zero-one",
 		"imagenet",
-		"none"
+		"none",
+		"scrfd"
 	]).optional(),
 	preprocessMode: zod.z.enum(["letterbox", "resize"]).optional(),
 	outputFormat: zod.z.enum([
@@ -23862,7 +23870,17 @@ var DetailResultSchema = zod.z.object({
 	/** Face short side (px) measured on the NATIVE crop surface. The `bbox`
 	*  above is detection-frame px (≈6× smaller on a 4K camera) — min-face-size
 	*  consumers MUST prefer this when present (2026-07-22 native-gate fix). */
-	nativeFaceShortSidePx: zod.z.number().optional()
+	nativeFaceShortSidePx: zod.z.number().optional(),
+	/**
+	* The five facial landmarks of a `face` detail, in the SAME frame space as
+	* `bbox` (D644). Additive and optional: post-analysis stores them beside the
+	* face's source frame so a future alignment can be re-derived exactly; a
+	* runner that predates the field sends none and the face is stored without.
+	*/
+	landmarks: zod.z.array(zod.z.object({
+		x: zod.z.number(),
+		y: zod.z.number()
+	})).optional()
 });
 /**
 * Why an executing node REFUSED a stateless step run (`runStatelessStep`).

package/dist/index.mjs

@@ -5146,10 +5146,17 @@ var ModelCatalogEntrySchema = z.object({
 	inputChannels: z.number().int().positive().optional(),
 	labels: z.array(LabelDefinitionSchema).readonly(),
 	inputLayout: z.enum(["nchw", "nhwc"]).optional(),
+	/**
+	* `'scrfd'` applies InsightFace's SCRFD input contract, `(x - 127.5) / 128`
+	* (upstream `insightface/model_zoo/scrfd.py`), instead of the historical
+	* plain `/255`. Measured against COCO GT: 188 → 196 faces found on the
+	* `scrfd-2.5g` catalog entry (2026-09-26 model-replacement spike, §2.4-2).
+	*/
 	inputNormalization: z.enum([
 		"zero-one",
 		"imagenet",
-		"none"
+		"none",
+		"scrfd"
 	]).optional(),
 	/**
 	* The model already applies softmax IN-GRAPH — its raw output is a
@@ -5251,7 +5258,8 @@ var ModelConvertMetadataSchema = z.object({
 	inputNormalization: z.enum([
 		"zero-one",
 		"imagenet",
-		"none"
+		"none",
+		"scrfd"
 	]).optional(),
 	preprocessMode: z.enum(["letterbox", "resize"]).optional(),
 	outputFormat: z.enum([
@@ -23861,7 +23869,17 @@ var DetailResultSchema = z.object({
 	/** Face short side (px) measured on the NATIVE crop surface. The `bbox`
 	*  above is detection-frame px (≈6× smaller on a 4K camera) — min-face-size
 	*  consumers MUST prefer this when present (2026-07-22 native-gate fix). */
-	nativeFaceShortSidePx: z.number().optional()
+	nativeFaceShortSidePx: z.number().optional(),
+	/**
+	* The five facial landmarks of a `face` detail, in the SAME frame space as
+	* `bbox` (D644). Additive and optional: post-analysis stores them beside the
+	* face's source frame so a future alignment can be re-derived exactly; a
+	* runner that predates the field sends none and the face is stored without.
+	*/
+	landmarks: z.array(z.object({
+		x: z.number(),
+		y: z.number()
+	})).optional()
 });
 /**
 * Why an executing node REFUSED a stateless step run (`runStatelessStep`).

package/dist/types/detection.d.ts

@@ -412,6 +412,15 @@ export interface ObjectDetection extends DetectionBase {
      * Present iff the face path cut its aligned crop from a native surface.
      */
     readonly nativeFaceShortSidePx?: number;
+    /**
+     * The five facial landmarks the face detector regressed for THIS `face`
+     * detail, in the same absolute pixel space as `bbox` (D644). Only a face
+     * detail carries them; never inherited onto the parent.
+     */
+    readonly landmarks?: readonly {
+        readonly x: number;
+        readonly y: number;
+    }[];
 }
 /** Audio detection — flat, time-localised within the window. */
 export interface AudioDetection extends DetectionBase {

package/dist/types/models.d.ts

@@ -237,6 +237,7 @@ export declare const ModelCatalogEntrySchema: z.ZodObject<{
     }>>;
     inputNormalization: z.ZodOptional<z.ZodEnum<{
         none: "none";
+        scrfd: "scrfd";
         "zero-one": "zero-one";
         imagenet: "imagenet";
     }>>;
@@ -319,7 +320,7 @@ export interface CustomModelMetadata {
     readonly labels: readonly LabelDefinition[];
     readonly classMap?: ClassMapDefinition;
     readonly inputLayout?: 'nchw' | 'nhwc';
-    readonly inputNormalization?: 'zero-one' | 'imagenet' | 'none';
+    readonly inputNormalization?: 'zero-one' | 'imagenet' | 'none' | 'scrfd';
     readonly outputFormat: ModelOutputFormat;
 }
 export declare const ConvertTargetSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -352,6 +353,7 @@ export declare const ModelConvertMetadataSchema: z.ZodObject<{
     }>>;
     inputNormalization: z.ZodOptional<z.ZodEnum<{
         none: "none";
+        scrfd: "scrfd";
         "zero-one": "zero-one";
         imagenet: "imagenet";
     }>>;
@@ -482,6 +484,7 @@ export declare const ConvertResultSchema: z.ZodObject<{
         }>>;
         inputNormalization: z.ZodOptional<z.ZodEnum<{
             none: "none";
+            scrfd: "scrfd";
             "zero-one": "zero-one";
             imagenet: "imagenet";
         }>>;

package/dist/types/pipeline-step.d.ts

@@ -232,9 +232,12 @@ export interface PoolModelConfig {
      * its own scale). `'imagenet'` ⇒ additionally subtract the ImageNet
      * mean/std per channel — required by the EfficientNet/MobileNetV3 animal +
      * vehicle classifiers (their `labels.json` declares `normalize: imagenet`).
+     * `'scrfd'` ⇒ InsightFace's SCRFD input contract, `(x - 127.5) / 128`
+     * (upstream `insightface/model_zoo/scrfd.py`) — required by the
+     * `scrfd-2.5g` catalog entry (2026-09-26 model-replacement spike, §2.4-2).
      * Threaded from `ModelCatalogEntry.inputNormalization`.
      */
-    readonly inputNormalization?: 'zero-one' | 'imagenet' | 'none';
+    readonly inputNormalization?: 'zero-one' | 'imagenet' | 'none' | 'scrfd';
     /**
      * The model's output is ALREADY a softmax probability distribution (softmax
      * baked into the graph). When true the `softmax` postprocessor skips its own

package/package.json

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