@camstack/types 1.1.43 → 1.1.45

package/dist/inference/runtime-capabilities.d.ts

@@ -9,7 +9,7 @@
  */
 import type { ModelFormat } from '../types/models.js';
 import type { HardwareInfo, PlatformScore } from '../interfaces/platform.js';
-export type RuntimeId = 'onnx' | 'openvino' | 'coreml';
+export type RuntimeId = 'onnx' | 'openvino' | 'coreml' | 'edgetpu';
 export interface DeviceOption {
     readonly value: string;
     readonly label: string;

package/dist/interfaces/addon.d.ts

@@ -352,7 +352,7 @@ export interface IKernelHwAccel {
      */
     readonly resolve: (prefer?: HwAccelBackend | 'none' | null) => Promise<HwAccelResolution>;
 }
-/** THIS node's inference accelerators (gpu/npu), probed locally in-process. */
+/** THIS node's inference accelerators (gpu/npu/coral), probed locally in-process. */
 export interface KernelInferenceHardware {
     readonly gpu: {
         readonly type: string;
@@ -360,6 +360,10 @@ export interface KernelInferenceHardware {
     readonly npu: {
         readonly type: string;
     } | null;
+    /** Coral USB Edge TPU, when present (gates the `edgetpu` runtime). */
+    readonly coral?: {
+        readonly type: string;
+    } | null;
 }
 export interface IKernelInferenceEngine {
     /**

package/dist/interfaces/advanced-notifier.d.ts

@@ -27,6 +27,8 @@ export interface NotificationRule {
             readonly text: string;
             readonly minSimilarity: number;
         };
+        /** Recognized-entity label match (face identity / plate vehicle name). */
+        readonly labels?: readonly string[];
     };
     readonly outputs: readonly string[];
     readonly template?: {

package/dist/interfaces/event-bus.d.ts

@@ -1,4 +1,4 @@
-import type { FrameResult, AudioResult } from '../types/detection.js';
+import type { FrameResult, AudioResult, ObjectDetection } from '../types/detection.js';
 import type { PipelineExecutionTrace, StepCadence } from '../types/pipeline-step.js';
 import type { MotionRegion } from '../capabilities/motion-detection.cap.js';
 import type { CameraPipelineConfig } from '../types/camera-pipeline.js';
@@ -120,6 +120,107 @@ export interface DetectionResultPayload {
     readonly capturedAt?: number;
     [key: string]: unknown;
 }
+/**
+ * Enriched frame emitted on `pipeline-analytics.frame-tracked` after
+ * post-analysis detail synthesis. Carries overlay-ready detections:
+ * first-level roots pass through from the inference frame; `kind:'detail'`
+ * entries (face/plate) are SYNTHESIZED per frame from per-track detail
+ * state (two-plane re-injection).
+ */
+export interface PipelineAnalyticsFrameTrackedPayload {
+    readonly deviceId: number;
+    readonly timestamp: number;
+    readonly frameWidth: number;
+    readonly frameHeight: number;
+    readonly detections: readonly ObjectDetection[];
+    [key: string]: unknown;
+}
+/** Lifecycle phase of a tracked object: it appears (`start`), its best
+ *  observation materially improves (`update`), then it ends (`end`). */
+export type TrackLifecyclePhase = 'start' | 'update' | 'end';
+/**
+ * Emitted on `pipeline-analytics.track-lifecycle` at three moments of a
+ * tracked object's life — `phase:'start'` when it first appears,
+ * `phase:'update'` when its best observation MATERIALLY improves (a
+ * clearer/larger frame, a newly-recognized identity or plate), and
+ * `phase:'end'` exactly once when it expires (TTL-gated). One typed
+ * payload shape across phases so a consumer subscribes once and branches
+ * on `phase`. Supersedes the thin `TrackStarted` / `TrackEnded` pair.
+ *
+ * Fields carry the BEST-so-far observation (final at `end`). `media`
+ * addresses the current representative image over HTTP. Telemetry
+ * semantics (D8): a lost event only misses a moment, never a correctness
+ * issue — the durable summary lives in the track store + events.
+ */
+export interface PipelineAnalyticsTrackLifecyclePayload {
+    readonly deviceId: number;
+    readonly trackId: string;
+    readonly phase: TrackLifecyclePhase;
+    /** Per-track observed-class set (deduplicated accumulator). */
+    readonly classes: readonly string[];
+    readonly bestClassName: string;
+    readonly bestConfidence: number;
+    /** Identity name / plate text, when resolved. */
+    readonly label?: string;
+    readonly identityId?: string;
+    readonly plateText?: string;
+    readonly firstSeen: number;
+    readonly lastSeen: number;
+    /** `lastSeen - firstSeen`; ~0 at start, grows over the track's life. */
+    readonly durationMs: number;
+    readonly zonesVisited?: readonly string[];
+    readonly totalDistance?: number;
+    readonly positionsCount?: number;
+    readonly importance?: number;
+    readonly importanceReason?: string;
+    /** Audio-classification labels heard on the camera during the track's
+     *  life (score ≥ device `classificationMinScore`), aggregated per label —
+     *  best-so-far at `update`, final at `end`. Mirrors `Track.audioLabels`. */
+    readonly audioLabels?: ReadonlyArray<{
+        readonly label: string;
+        readonly peakScore: number;
+        readonly count: number;
+        readonly firstAt: number;
+        readonly lastAt: number;
+    }>;
+    /** The current best image, addressable over HTTP. */
+    readonly media?: {
+        readonly keyFrameMediaKey?: string;
+        readonly bestCropMediaKey?: string;
+        readonly bestEventId?: string;
+    };
+    readonly embeddingId?: string;
+    readonly embeddingModelId?: string;
+    readonly [key: string]: unknown;
+}
+/**
+ * Emitted on `pipeline-analytics.face-gallery-changed` whenever a gallery
+ * face row changes. `kind:'buffered'` — a new face row was persisted
+ * (`FaceRecognizer.onTrackEnd`); `'assigned'` / `'unassigned'` — the face's
+ * identity link changed (`FaceGalleryProvider.assignFace`/`unassignFace`);
+ * `'deleted'` — the row was removed (`FaceGalleryProvider.deleteFace`).
+ * Telemetry semantics (D8): a lost event only delays a UI refresh, never a
+ * correctness issue. Consumer: `useFaceGalleryLiveRefresh` (admin-ui).
+ */
+export interface PipelineAnalyticsFaceGalleryChangedPayload {
+    readonly deviceId: number;
+    readonly faceId: string;
+    readonly kind: 'buffered' | 'assigned' | 'unassigned' | 'deleted';
+    readonly [key: string]: unknown;
+}
+/**
+ * Emitted when a plate-gallery row changes: `'buffered'` — a new read was
+ * persisted (`PlateRecognizer.onTrackEnd`); `'assigned'`/`'unassigned'` — the
+ * vehicle link changed (`PlateGalleryProvider`); `'deleted'` — the row was
+ * removed. Telemetry (D8): a lost event only delays a UI refresh. Consumer:
+ * `usePlateGalleryLiveRefresh` (admin-ui).
+ */
+export interface PipelineAnalyticsPlateGalleryChangedPayload {
+    readonly deviceId: number;
+    readonly plateId: string;
+    readonly kind: 'buffered' | 'assigned' | 'unassigned' | 'deleted';
+    readonly [key: string]: unknown;
+}
 /**
  * Child steps enabled for a camera + their scheduling policy, as read
  * from the pipeline catalog. Announced on `PipelineInferenceResultPayload`
@@ -602,6 +703,10 @@ export interface EventCatalog {
     'detection.motion-analysis': MotionAnalysisPayload;
     'detection.motion-zones-raw': MotionZonesRawPayload;
     'motion.on-motion-changed': MotionOnMotionChangedPayload;
+    'pipeline-analytics.frame-tracked': PipelineAnalyticsFrameTrackedPayload;
+    'pipeline-analytics.track-lifecycle': PipelineAnalyticsTrackLifecyclePayload;
+    'pipeline-analytics.face-gallery-changed': PipelineAnalyticsFaceGalleryChangedPayload;
+    'pipeline-analytics.plate-gallery-changed': PipelineAnalyticsPlateGalleryChangedPayload;
     /**
      * On-board detection coming straight from the camera firmware (Reolink
      * AI alarms, ONVIF analytics, etc.) — as opposed to `detection.result`
@@ -841,7 +946,7 @@ export interface EventCatalog {
      * every state change. Phase 2.
      */
     'pipeline.engine-provisioning': {
-        readonly runtimeId: 'onnx' | 'openvino' | 'coreml' | null;
+        readonly runtimeId: 'onnx' | 'openvino' | 'coreml' | 'edgetpu' | null;
         readonly device: string | null;
         readonly state: 'idle' | 'installing' | 'verifying' | 'ready' | 'failed';
         readonly progress?: number;

package/dist/interfaces/platform.d.ts

@@ -8,6 +8,12 @@ export interface HardwareInfo {
     readonly availableRAM_MB: number;
     readonly gpu: GpuInfo | null;
     readonly npu: NpuInfo | null;
+    /**
+     * Coral USB Edge TPU, when present. Optional so existing HardwareInfo
+     * construction sites and older cross-node probe reports stay valid; absent /
+     * null ⇒ no Coral ⇒ the `edgetpu` runtime is withheld.
+     */
+    readonly coral?: CoralInfo | null;
 }
 export interface GpuInfo {
     readonly type: 'nvidia' | 'amd' | 'intel' | 'apple';
@@ -17,6 +23,17 @@ export interface GpuInfo {
 export interface NpuInfo {
     readonly type: 'apple-ane' | 'intel-npu';
 }
+/**
+ * Coral USB Edge TPU (Google Coral). A discrete USB inference accelerator that
+ * coexists with the host GPU/NPU (e.g. the Unraid hub carries both an Intel NPU
+ * and a Coral). Tracked separately from {@link NpuInfo} so its presence gates
+ * the `edgetpu` inference runtime without colliding with the Intel-NPU signal.
+ */
+export interface CoralInfo {
+    readonly type: 'coral-edgetpu';
+    /** Bus location hint (e.g. `usb`), informational. */
+    readonly bus?: string;
+}
 /** A probed backend with availability and score */
 export interface PlatformScore {
     readonly runtime: 'node' | 'python';

package/dist/{sleep-DmvEGsRg.js → sleep-BdhADtqT.js}

@@ -474,10 +474,51 @@ var EventCategory = /* @__PURE__ */ function(EventCategory) {
 	EventCategory["EnrichmentEmbeddingStored"] = "enrichment.embedding.stored";
 	EventCategory["EnrichmentSceneStateChanged"] = "enrichment.scene.state-changed";
 	EventCategory["EnrichmentActivitySummary"] = "enrichment.activity.summary";
+	/**
+	* Unified track-lifecycle event: ONE category carrying `phase:
+	* 'start' | 'update' | 'end'` with a rich, typed
+	* `PipelineAnalyticsTrackLifecyclePayload`. Supersedes the thin
+	* `PipelineAnalyticsTrackStarted` / `PipelineAnalyticsTrackEnded`
+	* pair — a consumer subscribes once and branches on `phase`.
+	*/
+	EventCategory["PipelineAnalyticsTrackLifecycle"] = "pipeline-analytics.track-lifecycle";
+	/**
+	* @deprecated Superseded by {@link PipelineAnalyticsTrackLifecycle}
+	* (`phase:'start'`). Kept as a soft alias — no known subscribers.
+	*/
 	EventCategory["PipelineAnalyticsTrackStarted"] = "pipeline-analytics.track-started";
+	/**
+	* @deprecated Superseded by {@link PipelineAnalyticsTrackLifecycle}
+	* (`phase:'end'`). Kept as a soft alias — no known subscribers.
+	*/
 	EventCategory["PipelineAnalyticsTrackEnded"] = "pipeline-analytics.track-ended";
 	EventCategory["PipelineAnalyticsDetectionEvent"] = "pipeline-analytics.detection-event";
 	EventCategory["PipelineAnalyticsFrameTracked"] = "pipeline-analytics.frame-tracked";
+	/**
+	* Fired by `addon-post-analysis` when a parked (stationary) object appears
+	* (a track was promoted to a stationary-registry entry) or departs (the
+	* object moved / was removed). Telemetry (D8): lossy, drives a UI refresh of
+	* the dedicated "Stationary" section — never the live event feed. Payload:
+	* `{ deviceId, entryId, className, phase:'appeared'|'departed', timestamp }`.
+	*/
+	EventCategory["PipelineAnalyticsStationaryChanged"] = "pipeline-analytics.stationary-changed";
+	/**
+	* Fired by `addon-post-analysis` whenever a gallery face row changes:
+	* `kind:'buffered'` a new detected face was persisted, `'assigned'` /
+	* `'unassigned'` its identity link changed, `'deleted'` the row was
+	* removed. Telemetry semantics (D8): a lost event only delays a refresh,
+	* never a correctness issue. Payload `PipelineAnalyticsFaceGalleryChangedPayload`.
+	*/
+	EventCategory["PipelineAnalyticsFaceGalleryChanged"] = "pipeline-analytics.face-gallery-changed";
+	/**
+	* Fired by `addon-post-analysis` whenever a gallery plate row changes:
+	* `kind:'buffered'` a new read was persisted (`PlateRecognizer.onTrackEnd`),
+	* `'assigned'` / `'unassigned'` its vehicle link changed
+	* (`PlateGalleryProvider`), `'deleted'` the row was removed. Telemetry
+	* semantics (D8): a lost event only delays a refresh, never a correctness
+	* issue. Payload `PipelineAnalyticsPlateGalleryChangedPayload`.
+	*/
+	EventCategory["PipelineAnalyticsPlateGalleryChanged"] = "pipeline-analytics.plate-gallery-changed";
 	EventCategory["FrigateLiveEvent"] = "frigate.live-event";
 	EventCategory["CameraStreamsProfileSlotsChanged"] = "camera-streams.onProfileSlotsChanged";
 	/**
@@ -3159,6 +3200,7 @@ function createDeviceProxy(api, binding, opts) {
 			pressureSensor: createSliceHandle(stateSource, binding.deviceId, "pressure-sensor"),
 			privacyMask: createSliceHandle(stateSource, binding.deviceId, "privacy-mask"),
 			ptzAutotrack: createSliceHandle(stateSource, binding.deviceId, "ptz-autotrack"),
+			sceneMonitor: createSliceHandle(stateSource, binding.deviceId, "scene-monitor"),
 			scriptRunner: createSliceHandle(stateSource, binding.deviceId, "script-runner"),
 			smoke: createSliceHandle(stateSource, binding.deviceId, "smoke"),
 			streamParams: createSliceHandle(stateSource, binding.deviceId, "stream-params"),
@@ -3411,6 +3453,9 @@ function createDeviceProxy(api, binding, opts) {
 			getKeyEvents: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "getKeyEvents", "query", input),
 			getEventDensity: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "getEventDensity", "query", input),
 			pruneEventsBefore: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "pruneEventsBefore", "mutation", input),
+			pruneTracksBefore: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "pruneTracksBefore", "mutation", input),
+			wipeAllAnalytics: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "wipeAllAnalytics", "mutation", input),
+			deleteTracks: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "deleteTracks", "mutation", input),
 			getEventMedia: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "getEventMedia", "query", input),
 			getTrackMedia: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "getTrackMedia", "query", input),
 			searchObjectEvents: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "searchObjectEvents", "query", input),
@@ -3447,6 +3492,16 @@ function createDeviceProxy(api, binding, opts) {
 			setSettings: (input) => dispatch("ptz-autotrack", "ptzAutotrack", "setSettings", "mutation", input)
 		},
 		reboot: { reboot: (input) => dispatch("reboot", "reboot", "reboot", "mutation", input) },
+		sceneMonitor: {
+			listScenes: (input) => dispatch("scene-monitor", "sceneMonitor", "listScenes", "query", input),
+			createScene: (input) => dispatch("scene-monitor", "sceneMonitor", "createScene", "mutation", input),
+			updateScene: (input) => dispatch("scene-monitor", "sceneMonitor", "updateScene", "mutation", input),
+			deleteScene: (input) => dispatch("scene-monitor", "sceneMonitor", "deleteScene", "mutation", input),
+			captureReference: (input) => dispatch("scene-monitor", "sceneMonitor", "captureReference", "mutation", input),
+			deleteReference: (input) => dispatch("scene-monitor", "sceneMonitor", "deleteReference", "mutation", input),
+			recheckNow: (input) => dispatch("scene-monitor", "sceneMonitor", "recheckNow", "mutation", input),
+			getStatus: (input) => dispatch("scene-monitor", "sceneMonitor", "getStatus", "query", input)
+		},
 		scriptRunner: {
 			run: (input) => dispatch("script-runner", "scriptRunner", "run", "mutation", input),
 			stop: (input) => dispatch("script-runner", "scriptRunner", "stop", "mutation", input),

package/dist/{sleep-Baang_XW.mjs → sleep-_sv7WKkq.mjs}

@@ -474,10 +474,51 @@ var EventCategory = /* @__PURE__ */ function(EventCategory) {
 	EventCategory["EnrichmentEmbeddingStored"] = "enrichment.embedding.stored";
 	EventCategory["EnrichmentSceneStateChanged"] = "enrichment.scene.state-changed";
 	EventCategory["EnrichmentActivitySummary"] = "enrichment.activity.summary";
+	/**
+	* Unified track-lifecycle event: ONE category carrying `phase:
+	* 'start' | 'update' | 'end'` with a rich, typed
+	* `PipelineAnalyticsTrackLifecyclePayload`. Supersedes the thin
+	* `PipelineAnalyticsTrackStarted` / `PipelineAnalyticsTrackEnded`
+	* pair — a consumer subscribes once and branches on `phase`.
+	*/
+	EventCategory["PipelineAnalyticsTrackLifecycle"] = "pipeline-analytics.track-lifecycle";
+	/**
+	* @deprecated Superseded by {@link PipelineAnalyticsTrackLifecycle}
+	* (`phase:'start'`). Kept as a soft alias — no known subscribers.
+	*/
 	EventCategory["PipelineAnalyticsTrackStarted"] = "pipeline-analytics.track-started";
+	/**
+	* @deprecated Superseded by {@link PipelineAnalyticsTrackLifecycle}
+	* (`phase:'end'`). Kept as a soft alias — no known subscribers.
+	*/
 	EventCategory["PipelineAnalyticsTrackEnded"] = "pipeline-analytics.track-ended";
 	EventCategory["PipelineAnalyticsDetectionEvent"] = "pipeline-analytics.detection-event";
 	EventCategory["PipelineAnalyticsFrameTracked"] = "pipeline-analytics.frame-tracked";
+	/**
+	* Fired by `addon-post-analysis` when a parked (stationary) object appears
+	* (a track was promoted to a stationary-registry entry) or departs (the
+	* object moved / was removed). Telemetry (D8): lossy, drives a UI refresh of
+	* the dedicated "Stationary" section — never the live event feed. Payload:
+	* `{ deviceId, entryId, className, phase:'appeared'|'departed', timestamp }`.
+	*/
+	EventCategory["PipelineAnalyticsStationaryChanged"] = "pipeline-analytics.stationary-changed";
+	/**
+	* Fired by `addon-post-analysis` whenever a gallery face row changes:
+	* `kind:'buffered'` a new detected face was persisted, `'assigned'` /
+	* `'unassigned'` its identity link changed, `'deleted'` the row was
+	* removed. Telemetry semantics (D8): a lost event only delays a refresh,
+	* never a correctness issue. Payload `PipelineAnalyticsFaceGalleryChangedPayload`.
+	*/
+	EventCategory["PipelineAnalyticsFaceGalleryChanged"] = "pipeline-analytics.face-gallery-changed";
+	/**
+	* Fired by `addon-post-analysis` whenever a gallery plate row changes:
+	* `kind:'buffered'` a new read was persisted (`PlateRecognizer.onTrackEnd`),
+	* `'assigned'` / `'unassigned'` its vehicle link changed
+	* (`PlateGalleryProvider`), `'deleted'` the row was removed. Telemetry
+	* semantics (D8): a lost event only delays a refresh, never a correctness
+	* issue. Payload `PipelineAnalyticsPlateGalleryChangedPayload`.
+	*/
+	EventCategory["PipelineAnalyticsPlateGalleryChanged"] = "pipeline-analytics.plate-gallery-changed";
 	EventCategory["FrigateLiveEvent"] = "frigate.live-event";
 	EventCategory["CameraStreamsProfileSlotsChanged"] = "camera-streams.onProfileSlotsChanged";
 	/**
@@ -3159,6 +3200,7 @@ function createDeviceProxy(api, binding, opts) {
 			pressureSensor: createSliceHandle(stateSource, binding.deviceId, "pressure-sensor"),
 			privacyMask: createSliceHandle(stateSource, binding.deviceId, "privacy-mask"),
 			ptzAutotrack: createSliceHandle(stateSource, binding.deviceId, "ptz-autotrack"),
+			sceneMonitor: createSliceHandle(stateSource, binding.deviceId, "scene-monitor"),
 			scriptRunner: createSliceHandle(stateSource, binding.deviceId, "script-runner"),
 			smoke: createSliceHandle(stateSource, binding.deviceId, "smoke"),
 			streamParams: createSliceHandle(stateSource, binding.deviceId, "stream-params"),
@@ -3411,6 +3453,9 @@ function createDeviceProxy(api, binding, opts) {
 			getKeyEvents: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "getKeyEvents", "query", input),
 			getEventDensity: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "getEventDensity", "query", input),
 			pruneEventsBefore: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "pruneEventsBefore", "mutation", input),
+			pruneTracksBefore: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "pruneTracksBefore", "mutation", input),
+			wipeAllAnalytics: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "wipeAllAnalytics", "mutation", input),
+			deleteTracks: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "deleteTracks", "mutation", input),
 			getEventMedia: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "getEventMedia", "query", input),
 			getTrackMedia: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "getTrackMedia", "query", input),
 			searchObjectEvents: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "searchObjectEvents", "query", input),
@@ -3447,6 +3492,16 @@ function createDeviceProxy(api, binding, opts) {
 			setSettings: (input) => dispatch("ptz-autotrack", "ptzAutotrack", "setSettings", "mutation", input)
 		},
 		reboot: { reboot: (input) => dispatch("reboot", "reboot", "reboot", "mutation", input) },
+		sceneMonitor: {
+			listScenes: (input) => dispatch("scene-monitor", "sceneMonitor", "listScenes", "query", input),
+			createScene: (input) => dispatch("scene-monitor", "sceneMonitor", "createScene", "mutation", input),
+			updateScene: (input) => dispatch("scene-monitor", "sceneMonitor", "updateScene", "mutation", input),
+			deleteScene: (input) => dispatch("scene-monitor", "sceneMonitor", "deleteScene", "mutation", input),
+			captureReference: (input) => dispatch("scene-monitor", "sceneMonitor", "captureReference", "mutation", input),
+			deleteReference: (input) => dispatch("scene-monitor", "sceneMonitor", "deleteReference", "mutation", input),
+			recheckNow: (input) => dispatch("scene-monitor", "sceneMonitor", "recheckNow", "mutation", input),
+			getStatus: (input) => dispatch("scene-monitor", "sceneMonitor", "getStatus", "query", input)
+		},
 		scriptRunner: {
 			run: (input) => dispatch("script-runner", "scriptRunner", "run", "mutation", input),
 			stop: (input) => dispatch("script-runner", "scriptRunner", "stop", "mutation", input),

package/dist/types/models.d.ts

@@ -1,6 +1,7 @@
 import { z } from 'zod';
 import type { ClassMapDefinition, LabelDefinition } from './labels.js';
-export declare const MODEL_FORMATS: readonly ["onnx", "coreml", "openvino", "tflite", "pt"];
+import type { PostprocessorType } from './pipeline-step.js';
+export declare const MODEL_FORMATS: readonly ["onnx", "coreml", "openvino", "tflite", "pt", "gguf"];
 export type ModelFormat = (typeof MODEL_FORMATS)[number];
 export type ModelOutputFormat = 'yolo' | 'ssd' | 'embedding' | 'classification' | 'ocr' | 'segmentation';
 /**
@@ -93,6 +94,16 @@ export declare const ModelFormatsSchema: z.ZodObject<{
             python: "python";
         }>>>>;
     }, z.core.$strip>>;
+    gguf: z.ZodOptional<z.ZodObject<{
+        url: z.ZodString;
+        sizeMB: z.ZodNumber;
+        isDirectory: z.ZodOptional<z.ZodBoolean>;
+        files: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
+        runtimes: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodEnum<{
+            node: "node";
+            python: "python";
+        }>>>>;
+    }, z.core.$strip>>;
 }, z.core.$strip>;
 /**
  * Variant-selector grouping axes. Shared by the full `ModelCatalogEntry` and by
@@ -171,11 +182,22 @@ export declare const ModelCatalogEntrySchema: z.ZodObject<{
                 python: "python";
             }>>>>;
         }, z.core.$strip>>;
+        gguf: z.ZodOptional<z.ZodObject<{
+            url: z.ZodString;
+            sizeMB: z.ZodNumber;
+            isDirectory: z.ZodOptional<z.ZodBoolean>;
+            files: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
+            runtimes: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodEnum<{
+                node: "node";
+                python: "python";
+            }>>>>;
+        }, z.core.$strip>>;
     }, z.core.$strip>;
     inputSize: z.ZodObject<{
         width: z.ZodNumber;
         height: z.ZodNumber;
     }, z.core.$strip>;
+    inputChannels: z.ZodOptional<z.ZodNumber>;
     labels: z.ZodReadonly<z.ZodArray<z.ZodObject<{
         id: z.ZodString;
         name: z.ZodString;
@@ -196,6 +218,7 @@ export declare const ModelCatalogEntrySchema: z.ZodObject<{
         letterbox: "letterbox";
         resize: "resize";
     }>>;
+    postprocessor: z.ZodOptional<z.ZodCustom<PostprocessorType, PostprocessorType>>;
     faceAlignment: z.ZodOptional<z.ZodBoolean>;
     extraFiles: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodObject<{
         url: z.ZodString;
@@ -312,6 +335,7 @@ export declare const ConvertArtifactSchema: z.ZodObject<{
         openvino: "openvino";
         tflite: "tflite";
         pt: "pt";
+        gguf: "gguf";
     }>;
     precision: z.ZodOptional<z.ZodEnum<{
         int8: "int8";
@@ -378,11 +402,22 @@ export declare const ConvertResultSchema: z.ZodObject<{
                     python: "python";
                 }>>>>;
             }, z.core.$strip>>;
+            gguf: z.ZodOptional<z.ZodObject<{
+                url: z.ZodString;
+                sizeMB: z.ZodNumber;
+                isDirectory: z.ZodOptional<z.ZodBoolean>;
+                files: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
+                runtimes: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodEnum<{
+                    node: "node";
+                    python: "python";
+                }>>>>;
+            }, z.core.$strip>>;
         }, z.core.$strip>;
         inputSize: z.ZodObject<{
             width: z.ZodNumber;
             height: z.ZodNumber;
         }, z.core.$strip>;
+        inputChannels: z.ZodOptional<z.ZodNumber>;
         labels: z.ZodReadonly<z.ZodArray<z.ZodObject<{
             id: z.ZodString;
             name: z.ZodString;
@@ -403,6 +438,7 @@ export declare const ConvertResultSchema: z.ZodObject<{
             letterbox: "letterbox";
             resize: "resize";
         }>>;
+        postprocessor: z.ZodOptional<z.ZodCustom<PostprocessorType, PostprocessorType>>;
         faceAlignment: z.ZodOptional<z.ZodBoolean>;
         extraFiles: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodObject<{
             url: z.ZodString;
@@ -436,6 +472,7 @@ export declare const ConvertResultSchema: z.ZodObject<{
             openvino: "openvino";
             tflite: "tflite";
             pt: "pt";
+            gguf: "gguf";
         }>;
         precision: z.ZodOptional<z.ZodEnum<{
             int8: "int8";

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

@@ -12,7 +12,7 @@ export interface IPipelineStep {
     readonly definition: StepDefinition;
     getConfigSchema(): readonly ConfigField[];
 }
-export type PostprocessorType = 'yolo' | 'yolo-seg' | 'scrfd' | 'arcface' | 'clip' | 'softmax' | 'ctc' | 'saliency' | 'yamnet';
+export type PostprocessorType = 'yolo' | 'ssd' | 'yolo-seg' | 'scrfd' | 'arcface' | 'clip' | 'softmax' | 'ctc' | 'saliency' | 'yamnet';
 export interface StepDefinition {
     /** Unique step identifier (e.g., 'object-detection', 'face-detection') */
     readonly id: string;
@@ -108,8 +108,26 @@ export interface StepCadence {
 export interface PoolModelConfig {
     /** Absolute path to the model file (.mlpackage, .xml, .onnx) */
     readonly path: string;
-    /** Largest dimension of model input (e.g., 640 for 640×640) */
+    /**
+     * Largest dimension of model input (e.g., 640 for 640×640). Retained for
+     * backward compatibility and as the fallback when the explicit
+     * `inputWidth`/`inputHeight` are absent (square models).
+     */
     readonly inputSize: number;
+    /**
+     * Explicit input WIDTH in px. Present for every model; equals `inputSize`
+     * for square inputs. Non-square recognizers (plate-OCR VGG `384×64`) rely on
+     * this so the Python preprocess resizes to the real aspect instead of
+     * squaring the crop.
+     */
+    readonly inputWidth?: number;
+    /** Explicit input HEIGHT in px (see {@link inputWidth}). */
+    readonly inputHeight?: number;
+    /**
+     * Channel count of the model input tensor. Omit ⇒ 3 (RGB). `1` selects the
+     * grayscale CTC recognizer path (EasyOCR-normalized `[N,1,H,W]`).
+     */
+    readonly inputChannels?: number;
     /** How to preprocess the image before inference */
     readonly preprocessMode: 'letterbox' | 'resize';
     /** Postprocessor to apply to raw output in Python */

package/package.json

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