@camstack/types 1.2.265 → 1.2.267

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

@@ -97,9 +97,9 @@ export declare const CustomModelDescriptorSchema: z.ZodObject<{
         }>>;
         inputNormalization: z.ZodOptional<z.ZodEnum<{
             none: "none";
-            scrfd: "scrfd";
             "zero-one": "zero-one";
             imagenet: "imagenet";
+            scrfd: "scrfd";
         }>>;
         outputProbabilities: z.ZodOptional<z.ZodBoolean>;
         preprocessMode: z.ZodOptional<z.ZodEnum<{
@@ -107,6 +107,7 @@ export declare const CustomModelDescriptorSchema: z.ZodObject<{
             resize: "resize";
         }>>;
         postprocessor: z.ZodOptional<z.ZodCustom<import("../index.js").PostprocessorType, import("../index.js").PostprocessorType>>;
+        defaultConfidence: z.ZodOptional<z.ZodNumber>;
         faceAlignment: z.ZodOptional<z.ZodBoolean>;
         extraFiles: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodObject<{
             url: z.ZodString;
@@ -275,9 +276,9 @@ export declare const customModelRegistryCapability: {
                 }>>;
                 inputNormalization: z.ZodOptional<z.ZodEnum<{
                     none: "none";
-                    scrfd: "scrfd";
                     "zero-one": "zero-one";
                     imagenet: "imagenet";
+                    scrfd: "scrfd";
                 }>>;
                 outputProbabilities: z.ZodOptional<z.ZodBoolean>;
                 preprocessMode: z.ZodOptional<z.ZodEnum<{
@@ -285,6 +286,7 @@ export declare const customModelRegistryCapability: {
                     resize: "resize";
                 }>>;
                 postprocessor: z.ZodOptional<z.ZodCustom<import("../index.js").PostprocessorType, import("../index.js").PostprocessorType>>;
+                defaultConfidence: z.ZodOptional<z.ZodNumber>;
                 faceAlignment: z.ZodOptional<z.ZodBoolean>;
                 extraFiles: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodObject<{
                     url: z.ZodString;

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

@@ -22,9 +22,9 @@ export declare const ModelConvertInputSchema: z.ZodObject<{
         }>>;
         inputNormalization: z.ZodOptional<z.ZodEnum<{
             none: "none";
-            scrfd: "scrfd";
             "zero-one": "zero-one";
             imagenet: "imagenet";
+            scrfd: "scrfd";
         }>>;
         preprocessMode: z.ZodOptional<z.ZodEnum<{
             letterbox: "letterbox";
@@ -90,9 +90,9 @@ export declare const modelConvertCapability: {
                 }>>;
                 inputNormalization: z.ZodOptional<z.ZodEnum<{
                     none: "none";
-                    scrfd: "scrfd";
                     "zero-one": "zero-one";
                     imagenet: "imagenet";
+                    scrfd: "scrfd";
                 }>>;
                 preprocessMode: z.ZodOptional<z.ZodEnum<{
                     letterbox: "letterbox";
@@ -207,9 +207,9 @@ export declare const modelConvertCapability: {
                 }>>;
                 inputNormalization: z.ZodOptional<z.ZodEnum<{
                     none: "none";
-                    scrfd: "scrfd";
                     "zero-one": "zero-one";
                     imagenet: "imagenet";
+                    scrfd: "scrfd";
                 }>>;
                 outputProbabilities: z.ZodOptional<z.ZodBoolean>;
                 preprocessMode: z.ZodOptional<z.ZodEnum<{
@@ -217,6 +217,7 @@ export declare const modelConvertCapability: {
                     resize: "resize";
                 }>>;
                 postprocessor: z.ZodOptional<z.ZodCustom<import("../index.js").PostprocessorType, import("../index.js").PostprocessorType>>;
+                defaultConfidence: z.ZodOptional<z.ZodNumber>;
                 faceAlignment: z.ZodOptional<z.ZodBoolean>;
                 extraFiles: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodObject<{
                     url: z.ZodString;

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

@@ -99,9 +99,9 @@ export declare const ModelDistributeInputSchema: z.ZodObject<{
         }>>;
         inputNormalization: z.ZodOptional<z.ZodEnum<{
             none: "none";
-            scrfd: "scrfd";
             "zero-one": "zero-one";
             imagenet: "imagenet";
+            scrfd: "scrfd";
         }>>;
         outputProbabilities: z.ZodOptional<z.ZodBoolean>;
         preprocessMode: z.ZodOptional<z.ZodEnum<{
@@ -109,6 +109,7 @@ export declare const ModelDistributeInputSchema: z.ZodObject<{
             resize: "resize";
         }>>;
         postprocessor: z.ZodOptional<z.ZodCustom<import("../index.js").PostprocessorType, import("../index.js").PostprocessorType>>;
+        defaultConfidence: z.ZodOptional<z.ZodNumber>;
         faceAlignment: z.ZodOptional<z.ZodBoolean>;
         extraFiles: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodObject<{
             url: z.ZodString;
@@ -282,9 +283,9 @@ export declare const modelDistributorCapability: {
                 }>>;
                 inputNormalization: z.ZodOptional<z.ZodEnum<{
                     none: "none";
-                    scrfd: "scrfd";
                     "zero-one": "zero-one";
                     imagenet: "imagenet";
+                    scrfd: "scrfd";
                 }>>;
                 outputProbabilities: z.ZodOptional<z.ZodBoolean>;
                 preprocessMode: z.ZodOptional<z.ZodEnum<{
@@ -292,6 +293,7 @@ export declare const modelDistributorCapability: {
                     resize: "resize";
                 }>>;
                 postprocessor: z.ZodOptional<z.ZodCustom<import("../index.js").PostprocessorType, import("../index.js").PostprocessorType>>;
+                defaultConfidence: z.ZodOptional<z.ZodNumber>;
                 faceAlignment: z.ZodOptional<z.ZodBoolean>;
                 extraFiles: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodObject<{
                     url: z.ZodString;

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

@@ -1851,6 +1851,7 @@ export type EventPruneCounts = z.infer<typeof EventPruneCountsSchema>;
  *    - `reads-disagree` — the two reads named different choices.
  *  - `not-a-clip-model` — the CONFIRMED id has no CLIP metadata, so there is no
  *    index to fill and no dimension to check against (D649).
+ *  - `force-requires-max-tracks` — `force: true` with no `maxTracks` (D664).
  */
 export declare const RebuildObjectEmbeddingsRefusalSchema: z.ZodEnum<{
     "owner-not-ready": "owner-not-ready";
@@ -1863,6 +1864,7 @@ export declare const RebuildObjectEmbeddingsRefusalSchema: z.ZodEnum<{
     "read-failed": "read-failed";
     "reads-disagree": "reads-disagree";
     "not-a-clip-model": "not-a-clip-model";
+    "force-requires-max-tracks": "force-requires-max-tracks";
 }>;
 export type RebuildObjectEmbeddingsRefusal = z.infer<typeof RebuildObjectEmbeddingsRefusalSchema>;
 /**
@@ -4397,6 +4399,7 @@ export declare const pipelineAnalyticsCapability: {
             maxTracks: z.ZodOptional<z.ZodNumber>;
             executeOnNodeId: z.ZodOptional<z.ZodString>;
             pacingMs: z.ZodOptional<z.ZodNumber>;
+            force: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strip>, z.ZodObject<{
             started: z.ZodBoolean;
             alreadyRunning: z.ZodBoolean;
@@ -4411,6 +4414,7 @@ export declare const pipelineAnalyticsCapability: {
                 "read-failed": "read-failed";
                 "reads-disagree": "reads-disagree";
                 "not-a-clip-model": "not-a-clip-model";
+                "force-requires-max-tracks": "force-requires-max-tracks";
             }>>;
             modelId: z.ZodOptional<z.ZodString>;
             index: z.ZodOptional<z.ZodString>;
@@ -4420,7 +4424,17 @@ export declare const pipelineAnalyticsCapability: {
             scanned: z.ZodNumber;
             rebuilt: z.ZodNumber;
             missingKeyFrame: z.ZodNumber;
+            missingEvent: z.ZodNumber;
             missingBbox: z.ZodNumber;
+            boxSource: z.ZodObject<{
+                subjectBox: z.ZodNumber;
+                positions: z.ZodNumber;
+                event: z.ZodNumber;
+                refused: z.ZodNumber;
+            }, z.core.$strip>;
+            alreadyInSpace: z.ZodNumber;
+            force: z.ZodNullable<z.ZodBoolean>;
+            forcedInSpace: z.ZodNumber;
             notRunnable: z.ZodNumber;
             noCapableNode: z.ZodNumber;
             failed: z.ZodNumber;

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

@@ -203,6 +203,7 @@ declare const PipelineModelOptionSchema: z.ZodObject<{
         frigate: "frigate";
         scrypted: "scrypted";
     }>>;
+    defaultConfidence: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
 declare const PipelineAddonSchemaSchema: z.ZodObject<{
     id: z.ZodString;
@@ -250,6 +251,7 @@ declare const PipelineAddonSchemaSchema: z.ZodObject<{
             frigate: "frigate";
             scrypted: "scrypted";
         }>>;
+        defaultConfidence: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>>>;
     defaultModelId: z.ZodString;
     defaultModelIdByFormat: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
@@ -322,6 +324,7 @@ declare const PipelineSlotSchemaSchema: z.ZodObject<{
                 frigate: "frigate";
                 scrypted: "scrypted";
             }>>;
+            defaultConfidence: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strip>>>;
         defaultModelId: z.ZodString;
         defaultModelIdByFormat: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
@@ -430,6 +433,7 @@ declare const PipelineSchemaSchema: z.ZodObject<{
                     frigate: "frigate";
                     scrypted: "scrypted";
                 }>>;
+                defaultConfidence: z.ZodOptional<z.ZodNumber>;
             }, z.core.$strip>>>;
             defaultModelId: z.ZodString;
             defaultModelIdByFormat: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
@@ -784,6 +788,7 @@ export declare const pipelineExecutorCapability: {
                             frigate: "frigate";
                             scrypted: "scrypted";
                         }>>;
+                        defaultConfidence: z.ZodOptional<z.ZodNumber>;
                     }, z.core.$strip>>>;
                     defaultModelId: z.ZodString;
                     defaultModelIdByFormat: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;

package/dist/index.js

@@ -5314,6 +5314,16 @@ var ModelCatalogEntrySchema = zod.z.object({
 	*/
 	postprocessor: zod.z.custom().optional(),
 	/**
+	* Per-MODEL default confidence floor. Absent ⇒ the step's
+	* `StepDefinition.defaultConfidence` applies. A score is a property of one
+	* model's output scale, not of the step slot it sits in: YuNet's
+	* `sqrt(cls·obj)` is not SCRFD's score, and inheriting SCRFD's 0.5 filled the
+	* face gallery with wheels and hands (D662, amends D645). An operator's
+	* explicit value still wins over it. Resolved in ONE place —
+	* `addon-pipeline/.../registry/effective-confidence.ts`.
+	*/
+	defaultConfidence: zod.z.number().min(0).max(1).optional(),
+	/**
 	* When true, the executor produces a landmark-aligned crop (similarity warp
 	* onto the canonical template) before this step runs, instead of a plain
 	* axis-aligned bbox crop. Required for face-recognition embedders (ArcFace):
@@ -22926,7 +22936,15 @@ var RebuildObjectEmbeddingsInput = zod.z.object({
 	* force is logged at start and finish so a deliberately slow pass reads
 	* differently from a stalled one.
 	*/
-	pacingMs: zod.z.number().int().nonnegative().optional()
+	pacingMs: zod.z.number().int().nonnegative().optional(),
+	/**
+	* Re-embed ONLY the tracks whose vector is ALREADY in the pinned model's
+	* space (D664) — the in-space skip inverted. It exists to redo vectors
+	* written from the wrong box, which a normal pass would skip as done
+	* forever. Requires `maxTracks`: a forced pass without a bound is refused
+	* (`force-requires-max-tracks`).
+	*/
+	force: zod.z.boolean().optional()
 });
 /**
 * Result of emptying the CLIP index.
@@ -22962,6 +22980,7 @@ var WipeObjectEmbeddingsResultSchema = zod.z.object({
 *    - `reads-disagree` — the two reads named different choices.
 *  - `not-a-clip-model` — the CONFIRMED id has no CLIP metadata, so there is no
 *    index to fill and no dimension to check against (D649).
+*  - `force-requires-max-tracks` — `force: true` with no `maxTracks` (D664).
 */
 var RebuildObjectEmbeddingsRefusalSchema = zod.z.enum([
 	"stores-unavailable",
@@ -22969,7 +22988,8 @@ var RebuildObjectEmbeddingsRefusalSchema = zod.z.enum([
 	"method-unavailable",
 	"read-failed",
 	"reads-disagree",
-	"not-a-clip-model"
+	"not-a-clip-model",
+	"force-requires-max-tracks"
 ]);
 /**
 * Acknowledgement that a rebuild STARTED.
@@ -22994,11 +23014,32 @@ var RebuildStatusSchema = zod.z.object({
 	running: zod.z.boolean(),
 	scanned: zod.z.number(),
 	rebuilt: zod.z.number(),
-	/** Tracks whose key frame is gone — nothing to re-embed from. */
+	/** Tracks whose key frame is gone — nothing to re-embed from. Pixels ONLY:
+	*  `missingEvent` is its own field since D664, never summed in. */
 	missingKeyFrame: zod.z.number(),
-	/** Tracks with no usable detection box. */
+	/** Tracks with no object event at all (D664). */
+	missingEvent: zod.z.number(),
+	/** Tracks with no box measured on the pixels to cut — see `boxSource.refused`. */
 	missingBbox: zod.z.number(),
 	/**
+	* Which rule placed each judged track's box (D664): the key frame row's own
+	* `subjectBox`, `track.positions` at exactly its instant (older key frames),
+	* the event box (a key frame recovered from the recording, at the event's
+	* instant), or `refused` by name — the reasons are in the tagged log lines.
+	*/
+	boxSource: zod.z.object({
+		subjectBox: zod.z.number(),
+		positions: zod.z.number(),
+		event: zod.z.number(),
+		refused: zod.z.number()
+	}),
+	/** Tracks skipped because their vector is already in the pinned space. */
+	alreadyInSpace: zod.z.number(),
+	/** Whether the current / last pass was a `force` pass; `null` before any (D664). */
+	force: zod.z.boolean().nullable(),
+	/** In-space tracks a `force` pass selected for re-embedding. */
+	forcedInSpace: zod.z.number(),
+	/**
 	* Tracks an executing node REFUSED rather than broke on — an unreadable key
 	* frame, a step that threw. Separate from `failed` because the remedy is
 	* different, and because a whole camera silently contributing zero vectors
@@ -24185,7 +24226,8 @@ var PipelineModelOptionSchema = zod.z.object({
 	})),
 	group: ModelVariantGroupSchema.optional(),
 	legacy: zod.z.boolean().optional(),
-	provider: ModelProviderIdSchema.optional()
+	provider: ModelProviderIdSchema.optional(),
+	defaultConfidence: zod.z.number().optional()
 });
 var ConfigFieldBridge = zod.z.custom();
 var PipelineAddonSchemaSchema = zod.z.object({

package/dist/index.mjs

@@ -5313,6 +5313,16 @@ var ModelCatalogEntrySchema = z.object({
 	*/
 	postprocessor: z.custom().optional(),
 	/**
+	* Per-MODEL default confidence floor. Absent ⇒ the step's
+	* `StepDefinition.defaultConfidence` applies. A score is a property of one
+	* model's output scale, not of the step slot it sits in: YuNet's
+	* `sqrt(cls·obj)` is not SCRFD's score, and inheriting SCRFD's 0.5 filled the
+	* face gallery with wheels and hands (D662, amends D645). An operator's
+	* explicit value still wins over it. Resolved in ONE place —
+	* `addon-pipeline/.../registry/effective-confidence.ts`.
+	*/
+	defaultConfidence: z.number().min(0).max(1).optional(),
+	/**
 	* When true, the executor produces a landmark-aligned crop (similarity warp
 	* onto the canonical template) before this step runs, instead of a plain
 	* axis-aligned bbox crop. Required for face-recognition embedders (ArcFace):
@@ -22925,7 +22935,15 @@ var RebuildObjectEmbeddingsInput = z.object({
 	* force is logged at start and finish so a deliberately slow pass reads
 	* differently from a stalled one.
 	*/
-	pacingMs: z.number().int().nonnegative().optional()
+	pacingMs: z.number().int().nonnegative().optional(),
+	/**
+	* Re-embed ONLY the tracks whose vector is ALREADY in the pinned model's
+	* space (D664) — the in-space skip inverted. It exists to redo vectors
+	* written from the wrong box, which a normal pass would skip as done
+	* forever. Requires `maxTracks`: a forced pass without a bound is refused
+	* (`force-requires-max-tracks`).
+	*/
+	force: z.boolean().optional()
 });
 /**
 * Result of emptying the CLIP index.
@@ -22961,6 +22979,7 @@ var WipeObjectEmbeddingsResultSchema = z.object({
 *    - `reads-disagree` — the two reads named different choices.
 *  - `not-a-clip-model` — the CONFIRMED id has no CLIP metadata, so there is no
 *    index to fill and no dimension to check against (D649).
+*  - `force-requires-max-tracks` — `force: true` with no `maxTracks` (D664).
 */
 var RebuildObjectEmbeddingsRefusalSchema = z.enum([
 	"stores-unavailable",
@@ -22968,7 +22987,8 @@ var RebuildObjectEmbeddingsRefusalSchema = z.enum([
 	"method-unavailable",
 	"read-failed",
 	"reads-disagree",
-	"not-a-clip-model"
+	"not-a-clip-model",
+	"force-requires-max-tracks"
 ]);
 /**
 * Acknowledgement that a rebuild STARTED.
@@ -22993,11 +23013,32 @@ var RebuildStatusSchema = z.object({
 	running: z.boolean(),
 	scanned: z.number(),
 	rebuilt: z.number(),
-	/** Tracks whose key frame is gone — nothing to re-embed from. */
+	/** Tracks whose key frame is gone — nothing to re-embed from. Pixels ONLY:
+	*  `missingEvent` is its own field since D664, never summed in. */
 	missingKeyFrame: z.number(),
-	/** Tracks with no usable detection box. */
+	/** Tracks with no object event at all (D664). */
+	missingEvent: z.number(),
+	/** Tracks with no box measured on the pixels to cut — see `boxSource.refused`. */
 	missingBbox: z.number(),
 	/**
+	* Which rule placed each judged track's box (D664): the key frame row's own
+	* `subjectBox`, `track.positions` at exactly its instant (older key frames),
+	* the event box (a key frame recovered from the recording, at the event's
+	* instant), or `refused` by name — the reasons are in the tagged log lines.
+	*/
+	boxSource: z.object({
+		subjectBox: z.number(),
+		positions: z.number(),
+		event: z.number(),
+		refused: z.number()
+	}),
+	/** Tracks skipped because their vector is already in the pinned space. */
+	alreadyInSpace: z.number(),
+	/** Whether the current / last pass was a `force` pass; `null` before any (D664). */
+	force: z.boolean().nullable(),
+	/** In-space tracks a `force` pass selected for re-embedding. */
+	forcedInSpace: z.number(),
+	/**
 	* Tracks an executing node REFUSED rather than broke on — an unreadable key
 	* frame, a step that threw. Separate from `failed` because the remedy is
 	* different, and because a whole camera silently contributing zero vectors
@@ -24184,7 +24225,8 @@ var PipelineModelOptionSchema = z.object({
 	})),
 	group: ModelVariantGroupSchema.optional(),
 	legacy: z.boolean().optional(),
-	provider: ModelProviderIdSchema.optional()
+	provider: ModelProviderIdSchema.optional(),
+	defaultConfidence: z.number().optional()
 });
 var ConfigFieldBridge = z.custom();
 var PipelineAddonSchemaSchema = z.object({

package/dist/types/models.d.ts

@@ -260,9 +260,9 @@ export declare const ModelCatalogEntrySchema: z.ZodObject<{
     }>>;
     inputNormalization: z.ZodOptional<z.ZodEnum<{
         none: "none";
-        scrfd: "scrfd";
         "zero-one": "zero-one";
         imagenet: "imagenet";
+        scrfd: "scrfd";
     }>>;
     outputProbabilities: z.ZodOptional<z.ZodBoolean>;
     preprocessMode: z.ZodOptional<z.ZodEnum<{
@@ -270,6 +270,7 @@ export declare const ModelCatalogEntrySchema: z.ZodObject<{
         resize: "resize";
     }>>;
     postprocessor: z.ZodOptional<z.ZodCustom<PostprocessorType, PostprocessorType>>;
+    defaultConfidence: z.ZodOptional<z.ZodNumber>;
     faceAlignment: z.ZodOptional<z.ZodBoolean>;
     extraFiles: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodObject<{
         url: z.ZodString;
@@ -406,9 +407,9 @@ export declare const ModelConvertMetadataSchema: z.ZodObject<{
     }>>;
     inputNormalization: z.ZodOptional<z.ZodEnum<{
         none: "none";
-        scrfd: "scrfd";
         "zero-one": "zero-one";
         imagenet: "imagenet";
+        scrfd: "scrfd";
     }>>;
     preprocessMode: z.ZodOptional<z.ZodEnum<{
         letterbox: "letterbox";
@@ -531,9 +532,9 @@ export declare const ConvertResultSchema: z.ZodObject<{
         }>>;
         inputNormalization: z.ZodOptional<z.ZodEnum<{
             none: "none";
-            scrfd: "scrfd";
             "zero-one": "zero-one";
             imagenet: "imagenet";
+            scrfd: "scrfd";
         }>>;
         outputProbabilities: z.ZodOptional<z.ZodBoolean>;
         preprocessMode: z.ZodOptional<z.ZodEnum<{
@@ -541,6 +542,7 @@ export declare const ConvertResultSchema: z.ZodObject<{
             resize: "resize";
         }>>;
         postprocessor: z.ZodOptional<z.ZodCustom<PostprocessorType, PostprocessorType>>;
+        defaultConfidence: z.ZodOptional<z.ZodNumber>;
         faceAlignment: z.ZodOptional<z.ZodBoolean>;
         extraFiles: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodObject<{
             url: z.ZodString;

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

@@ -11,7 +11,12 @@ import type { PipelineSlot } from './pipeline.js';
  */
 export interface IPipelineStep {
     readonly definition: StepDefinition;
-    getConfigSchema(): readonly ConfigField[];
+    /**
+     * `model` — the catalog entry the step runs, when the caller knows it. A
+     * threshold slider's `default` is the MODEL's floor when it declares one
+     * (`ModelCatalogEntry.defaultConfidence`, D662); absent ⇒ the step's.
+     */
+    getConfigSchema(model?: ModelCatalogEntry): readonly ConfigField[];
 }
 export type PostprocessorType = 'yolo' | 'ssd' | 'rfdetr' | 'yolonas' | 'yolo-seg' | 'scrfd' | 'yunet' | 'arcface' | 'clip' | 'softmax' | 'ctc' | 'plate-slots' | 'saliency' | 'yamnet';
 export interface StepDefinition {

package/package.json

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