@camstack/types 1.2.112 → 1.2.114

package/dist/interfaces/recording-config.d.ts

@@ -43,10 +43,36 @@ export declare const RecordingStorageModeSchema: z.ZodEnum<{
     continuous: "continuous";
 }>;
 export type RecordingStorageMode = z.infer<typeof RecordingStorageModeSchema>;
+/**
+ * Le macro classi che possono aprire una finestra di registrazione — le stesse
+ * tre offerte dallo step `object-detection`, da UNA lista
+ * ({@link FIRST_LEVEL_MACRO_CLASSES}).
+ */
+export declare const RecordingObjectTriggerClassSchema: z.ZodEnum<{
+    person: "person";
+    vehicle: "vehicle";
+    animal: "animal";
+}>;
+export type RecordingObjectTriggerClass = z.infer<typeof RecordingObjectTriggerClassSchema>;
+/**
+ * Quanti device sorgente una singola banda può ascoltare.
+ *
+ * Non è un gusto: ogni sorgente è una CHIAVE nel `TriggerState` del recorder, e
+ * il limite per chiave (`MAX_TRIGGER_WINDOWS = 32`) senza un limite sulle
+ * chiavi lascerebbe crescere la mappa con l'inventario dell'operatore. 16
+ * sensori su UNA camera è già oltre qualunque installazione osservata.
+ */
+export declare const MAX_SENSOR_TRIGGER_DEVICES = 16;
 /** Which detectors trigger an `events`-mode band. */
 export declare const RecordingTriggersSchema: z.ZodObject<{
     motion: z.ZodOptional<z.ZodBoolean>;
     audioThresholdDbfs: z.ZodOptional<z.ZodNumber>;
+    objectClasses: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        person: "person";
+        vehicle: "vehicle";
+        animal: "animal";
+    }>>>;
+    sensorDeviceIds: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
 }, z.core.$strip>;
 export type RecordingTriggers = z.infer<typeof RecordingTriggersSchema>;
 /**
@@ -69,6 +95,12 @@ export type RecordingBandMode = z.infer<typeof RecordingBandModeSchema>;
 export declare const RecordingBandTriggersSchema: z.ZodObject<{
     motion: z.ZodOptional<z.ZodBoolean>;
     audioThresholdDbfs: z.ZodOptional<z.ZodNumber>;
+    objectClasses: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        person: "person";
+        vehicle: "vehicle";
+        animal: "animal";
+    }>>>;
+    sensorDeviceIds: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
 }, z.core.$strip>;
 export type RecordingBandTriggers = z.infer<typeof RecordingBandTriggersSchema>;
 /**
@@ -90,6 +122,12 @@ export declare const RecordingBandSchema: z.ZodObject<{
     triggers: z.ZodOptional<z.ZodObject<{
         motion: z.ZodOptional<z.ZodBoolean>;
         audioThresholdDbfs: z.ZodOptional<z.ZodNumber>;
+        objectClasses: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            person: "person";
+            vehicle: "vehicle";
+            animal: "animal";
+        }>>>;
+        sensorDeviceIds: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
     }, z.core.$strip>>;
     preBufferSec: z.ZodOptional<z.ZodNumber>;
     postBufferSec: z.ZodOptional<z.ZodNumber>;
@@ -201,6 +239,12 @@ export declare const RecordingConfigSchema: z.ZodObject<{
         triggers: z.ZodOptional<z.ZodObject<{
             motion: z.ZodOptional<z.ZodBoolean>;
             audioThresholdDbfs: z.ZodOptional<z.ZodNumber>;
+            objectClasses: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                person: "person";
+                vehicle: "vehicle";
+                animal: "animal";
+            }>>>;
+            sensorDeviceIds: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
         }, z.core.$strip>>;
         preBufferSec: z.ZodOptional<z.ZodNumber>;
         postBufferSec: z.ZodOptional<z.ZodNumber>;

package/dist/pipeline/native-lease.d.ts

@@ -49,6 +49,7 @@ export declare const NATIVE_LEASE_BUDGET_KEY = "nativeLeaseBudgetMb";
 export declare const NATIVE_LEASE_ACTIVITY_KEY = "nativeLeaseActivityMs";
 export declare const NATIVE_LEASE_ADMISSION_KEY = "nativeLeaseAdmission";
 export declare const NATIVE_LEASE_TILE_BUDGET_KEY = "nativeTileBudgetMb";
+export declare const NATIVE_LEASE_SCENE_BUDGET_KEY = "nativeSceneBudgetMb";
 /**
  * WHICH delivered frames the decode worker retains a native copy of.
  *
@@ -86,6 +87,7 @@ export declare const NativeLeaseSettingsSchema: z.ZodObject<{
         inferred: "inferred";
     }>;
     tileBudgetMb: z.ZodNumber;
+    sceneBudgetMb: z.ZodNumber;
 }, z.core.$strip>;
 export type NativeLeaseSettings = z.infer<typeof NativeLeaseSettingsSchema>;
 /**
@@ -129,6 +131,12 @@ export declare const NATIVE_LEASE_TILE_BUDGET_FIELD: {
     readonly step: 16;
     readonly default: number;
 };
+export declare const NATIVE_LEASE_SCENE_BUDGET_FIELD: {
+    readonly min: 0;
+    readonly max: 1024;
+    readonly step: 16;
+    readonly default: number;
+};
 /** Select options for the admission knob (orchestrator settings UI). */
 export declare const NATIVE_LEASE_ADMISSION_FIELD: {
     readonly options: readonly [{
@@ -143,7 +151,7 @@ export declare const NATIVE_LEASE_ADMISSION_FIELD: {
 /** Every knob, as a key union. */
 export type NativeLeaseKnob = keyof NativeLeaseSettings;
 /** The knobs whose value is a bounded integer (everything but `admission`). */
-export type NativeLeaseNumberKnob = 'holdFrames' | 'budgetMb' | 'activityMs' | 'tileBudgetMb';
+export type NativeLeaseNumberKnob = 'holdFrames' | 'budgetMb' | 'activityMs' | 'tileBudgetMb' | 'sceneBudgetMb';
 /**
  * Narrow a FLAT settings record to the knobs the operator set.
  *

package/dist/types/detection.d.ts

@@ -1,3 +1,4 @@
+import type { FirstLevelMacroClass } from './labels.js';
 import type { BoundingBox as EngineBoundingBox, FrameInput, Landmark } from './io.js';
 export interface SpatialDetection {
     readonly class: string;
@@ -91,8 +92,16 @@ export interface ScoredLabel {
 }
 /** What kind of entry a detection is at the root of `detections[]`. */
 export type DetectionKind = 'first-level' | 'detail' | 'audio';
-/** First-level macro classes produced by object detectors. */
-export type FirstLevelMacro = 'person' | 'vehicle' | 'animal';
+/**
+ * First-level macro classes produced by object detectors.
+ *
+ * Alias di {@link FirstLevelMacroClass} — LA lista sta in `labels.ts`
+ * (`FIRST_LEVEL_MACRO_CLASSES`), che è anche l'offerta dello step
+ * `object-detection` e il dominio di `RecordingTriggers.objectClasses`. Non
+ * riscrivere l'union qui: erano due copie a mano, ed è così che una macro
+ * aggiunta in un posto solo passa inosservata.
+ */
+export type FirstLevelMacro = FirstLevelMacroClass;
 /** Detail macro classes produced by crop+recognize steps. */
 export type DetailMacro = 'face' | 'plate';
 /**

package/dist/types/labels.d.ts

@@ -22,6 +22,32 @@ export interface ClassMapDefinition {
 }
 /** Detection-macro targets a catalog `classMap` may resolve to. */
 export declare const CLASS_MAP_MACRO_TARGETS: readonly ["person", "vehicle", "animal", "package"];
+/**
+ * Le macro classi di PRIMO LIVELLO: quelle che un object detector emette e che
+ * un operatore può selezionare.
+ *
+ * Sono le tre offerte dallo step `object-detection`
+ * (`addon-pipeline/src/detection-pipeline/registry/step-definitions.ts`,
+ * `enabledMacroClasses`). `package` sta in {@link CLASS_MAP_MACRO_TARGETS} e in
+ * `MACRO_LABELS` — è una macro vera — ma NON qui: appartiene allo step
+ * `package-detection`, la cui abilitazione è guidata dalle zone, e offrire la
+ * stessa parola due volte ha già fatto accendere a un operatore il proxy COCO
+ * (suitcase/backpack/handbag) lasciando spento il detector dedicato.
+ *
+ * UNA lista. Prima di oggi le stesse tre erano scritte a mano nell'offerta
+ * dello step e una seconda volta come union `FirstLevelMacro`
+ * (`types/detection.ts`); una terza copia per il trigger di registrazione
+ * (`RecordingTriggers.objectClasses`) avrebbe reso invisibile la divergenza
+ * successiva.
+ */
+export declare const FIRST_LEVEL_MACRO_CLASSES: readonly ["person", "vehicle", "animal"];
+export type FirstLevelMacroClass = (typeof FIRST_LEVEL_MACRO_CLASSES)[number];
+/**
+ * True quando `value` è una macro di primo livello. Type guard, non cast: un
+ * `className` che arriva dal bus è una stringa qualunque finché non passa di
+ * qui.
+ */
+export declare function isFirstLevelMacroClass(value: string): value is FirstLevelMacroClass;
 /**
  * Wire schema for a per-model CATALOG classMap override
  * (`ModelCatalogEntry.classMap` / `ModelConvertMetadata.classMap`) —

package/package.json

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