@camstack/types 0.1.1 → 0.1.3

package/dist/types/benchmark.d.ts

@@ -0,0 +1,112 @@
+import type { BoundingBox } from './io.js';
+export type BenchmarkMode = 'single-addon' | 'full-pipeline' | 'compare-runtimes' | 'compare-models';
+export type BenchmarkSource = {
+    readonly type: 'reference';
+    readonly images: 'all' | readonly string[];
+} | {
+    readonly type: 'camera';
+    readonly deviceId: string;
+    readonly durationSec: number;
+};
+export type BenchmarkExecution = {
+    readonly type: 'local';
+} | {
+    readonly type: 'agent';
+    readonly agentId: string;
+} | {
+    readonly type: 'multi-agent';
+    readonly agentIds: readonly string[];
+} | {
+    readonly type: 'all-agents';
+};
+export interface BenchmarkTarget {
+    readonly label: string;
+    readonly addonId: string;
+    readonly config: Readonly<Record<string, unknown>>;
+}
+export interface BenchmarkConfig {
+    readonly mode: BenchmarkMode;
+    readonly source: BenchmarkSource;
+    readonly execution: BenchmarkExecution;
+    readonly iterations?: number;
+    readonly warmup?: number;
+    readonly targets: readonly BenchmarkTarget[];
+}
+export interface LatencyStats {
+    readonly mean: number;
+    readonly median: number;
+    readonly p95: number;
+    readonly p99: number;
+    readonly min: number;
+    readonly max: number;
+}
+export interface ResourceStats {
+    readonly peakMemoryMB: number;
+    readonly avgCpuPercent: number;
+    readonly avgGpuPercent?: number;
+}
+export interface AccuracyStats {
+    readonly mAP50?: number;
+    readonly precision?: number;
+    readonly recall?: number;
+}
+export interface SystemInfo {
+    readonly os: string;
+    readonly arch: string;
+    readonly cpuModel: string;
+    readonly cpuCores: number;
+    readonly totalMemoryMB: number;
+    readonly gpuModel?: string;
+    readonly pythonVersion?: string;
+    readonly nodeVersion: string;
+}
+export interface BenchmarkTargetResult {
+    readonly label: string;
+    readonly addonId: string;
+    readonly config: Readonly<Record<string, unknown>>;
+    readonly latency: LatencyStats;
+    readonly fps: number;
+    readonly accuracy?: AccuracyStats;
+    readonly resources: ResourceStats;
+    readonly stepBreakdown?: Readonly<Record<string, {
+        readonly meanMs: number;
+        readonly percentOfTotal: number;
+    }>>;
+}
+export type AgentBenchmarkStatus = 'completed' | 'partial' | 'failed' | 'disconnected';
+export interface MultiBenchmarkReport {
+    readonly timestamp: string;
+    readonly source: BenchmarkSource;
+    readonly agents: ReadonlyArray<{
+        readonly agentId: string;
+        readonly status: AgentBenchmarkStatus;
+        readonly systemInfo: SystemInfo;
+        readonly results: readonly BenchmarkTargetResult[];
+        readonly error?: string;
+        readonly completedIterations?: number;
+    }>;
+    readonly leaderboard: ReadonlyArray<{
+        readonly rank: number;
+        readonly agentId: string;
+        readonly label: string;
+        readonly meanMs: number;
+        readonly fps: number;
+        readonly peakMemoryMB: number;
+        readonly accuracy?: AccuracyStats;
+    }>;
+}
+export interface GroundTruthAnnotation {
+    readonly class: string;
+    readonly originalClass?: string;
+    readonly bbox: BoundingBox;
+    readonly children?: readonly GroundTruthAnnotation[];
+    readonly identity?: string;
+    readonly plateText?: string;
+    readonly species?: string;
+    readonly vehicleType?: string;
+}
+export interface GroundTruth {
+    readonly image: string;
+    readonly annotations: readonly GroundTruthAnnotation[];
+}
+//# sourceMappingURL=benchmark.d.ts.map

package/dist/types/benchmark.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"benchmark.d.ts","sourceRoot":"","sources":["../../src/types/benchmark.ts"],"names":[],"mappings":"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"}

package/dist/types/camera-detection.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Motion detection configuration per camera.
+ * Motion is a pipeline TRIGGER, not a pipeline step.
+ */
+export interface CameraMotionConfig {
+    /** 'stream' = frame-diff analysis on decoded frames (default)
+     *  'onboarded' = use camera's native motion signal via IMotionSensor capability
+     *  'smart' = AI-based motion detection */
+    readonly source: 'stream' | 'onboarded' | 'smart';
+    /** Frame-diff settings (only used when source='stream') */
+    readonly threshold?: number;
+    readonly minArea?: number;
+}
+/**
+ * Camera native AI detection configuration.
+ * These events are emitted for recording/notifications, NOT for inference pipeline.
+ * Uses the IObjectDetector device capability to receive detection events.
+ */
+export interface CameraNativeDetectionConfig {
+    /** Whether to listen for the camera's native AI events */
+    readonly enabled: boolean;
+    /** Source identifier for attribution */
+    readonly source: string;
+    /** Classes the camera reports natively */
+    readonly classes: readonly string[];
+}
+/**
+ * Combined camera detection capabilities config.
+ */
+export interface CameraDetectionCapabilities {
+    readonly motion: CameraMotionConfig;
+    readonly nativeDetection?: CameraNativeDetectionConfig;
+}
+//# sourceMappingURL=camera-detection.d.ts.map

package/dist/types/camera-detection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"camera-detection.d.ts","sourceRoot":"","sources":["../../src/types/camera-detection.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC;;8CAE0C;IAC1C,QAAQ,CAAC,MAAM,EAAE,QAAQ,GAAG,WAAW,GAAG,OAAO,CAAA;IACjD,2DAA2D;IAC3D,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAC1B;AAED;;;;GAIG;AACH,MAAM,WAAW,2BAA2B;IAC1C,0DAA0D;IAC1D,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,wCAAwC;IACxC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,0CAA0C;IAC1C,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAA;IACnC,QAAQ,CAAC,eAAe,CAAC,EAAE,2BAA2B,CAAA;CACvD"}

package/dist/types/config.d.ts

@@ -0,0 +1,37 @@
+import type { DetectionEventType } from './events.js';
+export type DetectionRuntime = 'onnx' | 'coreml' | 'pytorch' | 'openvino' | 'tflite';
+export type DetectionDevice = 'cpu' | 'gpu-cuda' | 'gpu-mps' | 'npu' | 'coral-edgetpu' | 'tensorrt';
+export type ProbeCapability = 'fp32' | 'fp16' | 'int8' | 'batch-inference';
+export interface ProbeResult {
+    readonly available: boolean;
+    readonly runtime: DetectionRuntime;
+    readonly device: DetectionDevice;
+    readonly capabilities: readonly ProbeCapability[];
+    readonly estimatedMemoryMB?: number;
+}
+export interface CameraAnalysisConfig {
+    readonly tracker: {
+        readonly maxAge: number;
+        readonly minHits: number;
+        readonly iouThreshold: number;
+    };
+    readonly stateAnalyzer: {
+        readonly stationaryThresholdSec: number;
+        readonly loiteringThresholdSec: number;
+        readonly velocityThreshold: number;
+    };
+    readonly snapshots: {
+        readonly enabled: boolean;
+        readonly saveThumbnail: boolean;
+        readonly saveAnnotatedFrame: boolean;
+        readonly saveDebugThumbnails: boolean;
+        readonly clipPreSec: number;
+        readonly clipPostSec: number;
+    };
+    readonly events: {
+        readonly minTrackAge: number;
+        readonly cooldownSec: number;
+        readonly enabledTypes: readonly DetectionEventType[];
+    };
+}
+//# sourceMappingURL=config.d.ts.map

package/dist/types/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAErD,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,GAAG,QAAQ,CAAA;AACpF,MAAM,MAAM,eAAe,GAAG,KAAK,GAAG,UAAU,GAAG,SAAS,GAAG,KAAK,GAAG,eAAe,GAAG,UAAU,CAAA;AACnG,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,iBAAiB,CAAA;AAE1E,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;IAC3B,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAA;IAClC,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAA;IAChC,QAAQ,CAAC,YAAY,EAAE,SAAS,eAAe,EAAE,CAAA;IACjD,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAA;CACpC;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,OAAO,EAAE;QAChB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;QACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;QACxB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;KAC9B,CAAA;IACD,QAAQ,CAAC,aAAa,EAAE;QACtB,QAAQ,CAAC,sBAAsB,EAAE,MAAM,CAAA;QACvC,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAA;QACtC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAA;KACnC,CAAA;IACD,QAAQ,CAAC,SAAS,EAAE;QAClB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;QACzB,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAA;QAC/B,QAAQ,CAAC,kBAAkB,EAAE,OAAO,CAAA;QACpC,QAAQ,CAAC,mBAAmB,EAAE,OAAO,CAAA;QACrC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;QAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;KAC7B,CAAA;IACD,QAAQ,CAAC,MAAM,EAAE;QACf,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;QAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;QAC5B,QAAQ,CAAC,YAAY,EAAE,SAAS,kBAAkB,EAAE,CAAA;KACrD,CAAA;CACF"}

package/dist/types/detection.d.ts

@@ -0,0 +1,93 @@
+import type { BoundingBox, Landmark, FrameInput } from './io.js';
+import type { DetectionZoneMembership } from './zones.js';
+export interface SpatialDetection {
+    readonly class: string;
+    readonly originalClass: string;
+    readonly score: number;
+    readonly bbox: BoundingBox;
+    readonly landmarks?: readonly Landmark[];
+    readonly mask?: Uint8Array;
+    readonly maskWidth?: number;
+    readonly maskHeight?: number;
+}
+export interface CropInput {
+    readonly frame: FrameInput;
+    readonly roi: BoundingBox;
+    readonly parentDetection: SpatialDetection;
+}
+export interface Classification {
+    readonly class: string;
+    readonly score: number;
+    readonly text?: string;
+    readonly embedding?: Float32Array;
+    readonly metadata?: Readonly<Record<string, unknown>>;
+}
+export interface DetectorOutput {
+    readonly detections: readonly SpatialDetection[];
+    readonly inferenceMs: number;
+    readonly modelId: string;
+}
+export interface CropperOutput {
+    readonly crops: readonly SpatialDetection[];
+    readonly inferenceMs: number;
+    readonly modelId: string;
+}
+export interface ClassifierOutput {
+    readonly classifications: readonly Classification[];
+    readonly inferenceMs: number;
+    readonly modelId: string;
+}
+export interface RefinerOutput {
+    /** Base64-encoded binary mask for the refined detection region */
+    readonly mask: string;
+    readonly maskWidth: number;
+    readonly maskHeight: number;
+    readonly inferenceMs: number;
+    readonly modelId: string;
+}
+/** Origin type of a label — what kind of pipeline step produced it */
+export type LabelOrigin = 'classification' | 'face' | 'plate' | 'recognition' | 'unknown';
+/** A label produced by any classifier/recognizer step in the pipeline */
+export interface LabelData {
+    /** The classification/recognition result (e.g., "Sunbird", "EA0202AA", "Dodge Journey SUV 2012") */
+    readonly label: string;
+    /** Confidence of the classification */
+    readonly score: number;
+    /** Bounding box of the source region this label applies to [x1, y1, x2, y2] */
+    readonly box: readonly [number, number, number, number];
+    /** Source addon that produced this label */
+    readonly addonId: string;
+    /** Origin type — what kind of step produced this label */
+    readonly origin: LabelOrigin;
+}
+/** A detection produced by the pipeline executor with accumulated labels */
+export interface PipelineDetection {
+    readonly className: string;
+    readonly originalClass?: string;
+    readonly confidence: number;
+    readonly bbox: readonly [number, number, number, number];
+    /** Accumulated labels from all classifier/recognizer steps in the pipeline */
+    readonly labelsData: readonly LabelData[];
+    /** Base64-encoded binary segmentation mask (when using -seg models or refiner) */
+    readonly mask?: string;
+    readonly maskWidth?: number;
+    readonly maskHeight?: number;
+    /** Sub-detections from cropper steps (face bbox, plate bbox) — for debug */
+    readonly children?: readonly PipelineDetection[];
+    readonly zones?: readonly DetectionZoneMembership[];
+    readonly embeddingId?: string;
+}
+export interface PipelineStepTiming {
+    readonly addonId: string;
+    readonly modelId: string;
+    readonly ms: number;
+    readonly detections: number;
+}
+export interface PipelineRunResult {
+    readonly detections: readonly PipelineDetection[];
+    readonly stepTimings: readonly PipelineStepTiming[];
+    readonly totalMs: number;
+    readonly imageWidth: number;
+    readonly imageHeight: number;
+}
+//# sourceMappingURL=detection.d.ts.map

package/dist/types/detection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detection.d.ts","sourceRoot":"","sources":["../../src/types/detection.ts"],"names":[],"mappings":"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"}

package/dist/types/device-type.d.ts

@@ -0,0 +1,10 @@
+export declare enum DeviceType {
+    Camera = "camera"
+}
+export interface DeviceTypeInfo {
+    readonly type: DeviceType;
+    readonly label: string;
+    readonly icon: string;
+}
+export declare const DEVICE_TYPE_INFO: Record<DeviceType, DeviceTypeInfo>;
+//# sourceMappingURL=device-type.d.ts.map

package/dist/types/device-type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"device-type.d.ts","sourceRoot":"","sources":["../../src/types/device-type.ts"],"names":[],"mappings":"AAAA,oBAAY,UAAU;IACpB,MAAM,WAAW;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAA;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACtB;AAED,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,UAAU,EAAE,cAAc,CAE/D,CAAA"}

package/dist/types/entities.d.ts

@@ -0,0 +1,35 @@
+export interface ZoneDefinition {
+    readonly id: string;
+    readonly name: string;
+    readonly cameraId: string;
+    readonly type: 'polygon' | 'tripwire';
+    readonly points: ReadonlyArray<{
+        readonly x: number;
+        readonly y: number;
+    }>;
+    readonly direction?: 'in' | 'out' | 'both';
+    readonly alertOnClasses?: readonly string[];
+    readonly color?: string;
+}
+export interface KnownFace {
+    readonly id: string;
+    readonly name: string;
+    readonly label?: string;
+    readonly embeddings: readonly Float32Array[];
+    readonly thumbnailPath?: string;
+    readonly createdAt: number;
+}
+export interface KnownPlate {
+    readonly id: string;
+    readonly plateText: string;
+    readonly label?: string;
+    readonly vehicleDescription?: string;
+    readonly createdAt: number;
+}
+export interface KnownAudioEvent {
+    readonly id: string;
+    readonly className: string;
+    readonly label: string;
+    readonly notifyAlways: boolean;
+}
+//# sourceMappingURL=entities.d.ts.map

package/dist/types/entities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entities.d.ts","sourceRoot":"","sources":["../../src/types/entities.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,UAAU,CAAA;IACrC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;QAAE,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAC1E,QAAQ,CAAC,SAAS,CAAC,EAAE,IAAI,GAAG,KAAK,GAAG,MAAM,CAAA;IAC1C,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAC3C,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CACxB;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,UAAU,EAAE,SAAS,YAAY,EAAE,CAAA;IAC5C,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAA;IAC/B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC3B;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAA;IACpC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC3B;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAA;CAC/B"}

package/dist/types/events.d.ts

@@ -0,0 +1,35 @@
+import type { BoundingBox } from './io.js';
+import type { Classification } from './detection.js';
+import type { TrackedDetection, TrackedObjectState } from './tracked.js';
+export type DetectionEventType = 'object.detected' | 'object.classified' | 'object.entering' | 'object.leaving' | 'object.stationary' | 'object.loitering' | 'zone.enter' | 'zone.exit' | 'tripwire.cross' | 'audio.detected';
+export type TrackEventType = 'track.new' | 'track.update' | 'track.stationary' | 'track.moving' | 'track.zone-enter' | 'track.zone-exit' | 'track.zone-dwell' | 'track.ended';
+export type AnalysisEventType = DetectionEventType | TrackEventType;
+export interface ZoneEvent {
+    readonly type: 'zone-enter' | 'zone-exit' | 'zone-loiter' | 'tripwire-cross';
+    readonly zoneId: string;
+    readonly zoneName: string;
+    readonly trackId: string;
+    readonly detection: TrackedDetection;
+    readonly direction?: 'in' | 'out' | 'left' | 'right';
+    readonly timestamp: number;
+}
+export interface EventSnapshot {
+    readonly thumbnailPath: string;
+    readonly annotatedFramePath: string;
+    readonly debugThumbnails?: Readonly<Record<string, string>>;
+    readonly clipPath?: string;
+    readonly clipDurationSec?: number;
+}
+export interface DetectionEvent {
+    readonly id: string;
+    readonly type: DetectionEventType;
+    readonly timestamp: number;
+    readonly deviceId: string;
+    readonly detection: TrackedDetection;
+    readonly classifications: readonly Classification[];
+    readonly objectState: TrackedObjectState;
+    readonly zoneEvents: readonly ZoneEvent[];
+    readonly snapshot?: EventSnapshot;
+    readonly trackPath: readonly BoundingBox[];
+}
+//# sourceMappingURL=events.d.ts.map

package/dist/types/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/types/events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAC1C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AACpD,OAAO,KAAK,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAA;AAExE,MAAM,MAAM,kBAAkB,GAC1B,iBAAiB,GACjB,mBAAmB,GACnB,iBAAiB,GACjB,gBAAgB,GAChB,mBAAmB,GACnB,kBAAkB,GAClB,YAAY,GACZ,WAAW,GACX,gBAAgB,GAChB,gBAAgB,CAAA;AAEpB,MAAM,MAAM,cAAc,GACtB,WAAW,GACX,cAAc,GACd,kBAAkB,GAClB,cAAc,GACd,kBAAkB,GAClB,iBAAiB,GACjB,kBAAkB,GAClB,aAAa,CAAA;AAEjB,MAAM,MAAM,iBAAiB,GAAG,kBAAkB,GAAG,cAAc,CAAA;AAEnE,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,YAAY,GAAG,WAAW,GAAG,aAAa,GAAG,gBAAgB,CAAA;IAC5E,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,SAAS,EAAE,gBAAgB,CAAA;IACpC,QAAQ,CAAC,SAAS,CAAC,EAAE,IAAI,GAAG,KAAK,GAAG,MAAM,GAAG,OAAO,CAAA;IACpD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC3B;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAA;IACnC,QAAQ,CAAC,eAAe,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;IAC3D,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAA;CAClC;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAA;IACjC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,SAAS,EAAE,gBAAgB,CAAA;IACpC,QAAQ,CAAC,eAAe,EAAE,SAAS,cAAc,EAAE,CAAA;IACnD,QAAQ,CAAC,WAAW,EAAE,kBAAkB,CAAA;IACxC,QAAQ,CAAC,UAAU,EAAE,SAAS,SAAS,EAAE,CAAA;IACzC,QAAQ,CAAC,QAAQ,CAAC,EAAE,aAAa,CAAA;IACjC,QAAQ,CAAC,SAAS,EAAE,SAAS,WAAW,EAAE,CAAA;CAC3C"}

package/dist/types/io.d.ts

@@ -0,0 +1,25 @@
+export interface BoundingBox {
+    readonly x: number;
+    readonly y: number;
+    readonly w: number;
+    readonly h: number;
+}
+export interface Landmark {
+    readonly x: number;
+    readonly y: number;
+    readonly label?: string;
+}
+export interface FrameInput {
+    readonly data: Buffer;
+    readonly format: 'jpeg' | 'rgb' | 'yuv420';
+    readonly width: number;
+    readonly height: number;
+    readonly timestamp: number;
+}
+export interface AudioChunkInput {
+    readonly data: Float32Array;
+    readonly sampleRate: number;
+    readonly channels: number;
+    readonly timestamp: number;
+}
+//# sourceMappingURL=io.d.ts.map

package/dist/types/io.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"io.d.ts","sourceRoot":"","sources":["../../src/types/io.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CACxB;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK,GAAG,QAAQ,CAAA;IAC1C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC3B;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAA;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC3B"}

package/dist/types/labels.d.ts

@@ -0,0 +1,12 @@
+export interface LabelDefinition {
+    readonly id: string;
+    readonly name: string;
+    readonly category?: string;
+    readonly description?: string;
+    readonly icon?: string;
+}
+export interface ClassMapDefinition {
+    readonly mapping: Readonly<Record<string, string>>;
+    readonly preserveOriginal: boolean;
+}
+//# sourceMappingURL=labels.d.ts.map

package/dist/types/labels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"labels.d.ts","sourceRoot":"","sources":["../../src/types/labels.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CACvB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;IAClD,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAA;CACnC"}

package/dist/types/live-state.d.ts

@@ -0,0 +1,47 @@
+import type { BoundingBox } from './io.js';
+import type { ObjectState } from './tracked.js';
+import type { DetectionEvent } from './events.js';
+import type { PipelineStatus } from './pipeline.js';
+export interface TrackedObjectSummary {
+    readonly trackId: string;
+    readonly class: string;
+    readonly originalClass: string;
+    readonly state: ObjectState;
+    readonly bbox: BoundingBox;
+    readonly velocity: {
+        readonly dx: number;
+        readonly dy: number;
+    };
+    readonly dwellTimeMs: number;
+    readonly inZones: readonly string[];
+    readonly identity?: string;
+    readonly plateText?: string;
+    readonly subClass?: string;
+}
+export interface ZoneLiveState {
+    readonly zoneId: string;
+    readonly zoneName: string;
+    readonly occupied: boolean;
+    readonly objectCount: number;
+    readonly objectsByClass: Readonly<Record<string, number>>;
+    readonly trackIds: readonly string[];
+    readonly avgDwellTimeMs: number;
+    readonly totalEntrancesToday: number;
+    readonly totalExitsToday: number;
+    readonly loiteringTracks: readonly string[];
+}
+export interface CameraLiveState {
+    readonly deviceId: string;
+    readonly lastFrameTimestamp: number;
+    readonly activeObjects: number;
+    readonly movingObjects: number;
+    readonly stationaryObjects: number;
+    readonly objectCounts: Readonly<Record<string, number>>;
+    readonly tracks: readonly TrackedObjectSummary[];
+    readonly zones: readonly ZoneLiveState[];
+    readonly lastEvent?: DetectionEvent;
+    readonly pipelineStatus: readonly PipelineStatus[];
+    readonly avgPipelineMs: number;
+    readonly currentFps: number;
+}
+//# sourceMappingURL=live-state.d.ts.map

package/dist/types/live-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"live-state.d.ts","sourceRoot":"","sources":["../../src/types/live-state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAC1C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAC/C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AACjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAEnD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAA;IAC3B,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAA;IAC1B,QAAQ,CAAC,QAAQ,EAAE;QAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAA;IAC/D,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;IACnC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAC3B;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,cAAc,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;IACzD,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAA;IACpC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;IAC/B,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAA;IACpC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAA;IAChC,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAA;CAC5C;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAA;IACnC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAA;IAClC,QAAQ,CAAC,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;IACvD,QAAQ,CAAC,MAAM,EAAE,SAAS,oBAAoB,EAAE,CAAA;IAChD,QAAQ,CAAC,KAAK,EAAE,SAAS,aAAa,EAAE,CAAA;IACxC,QAAQ,CAAC,SAAS,CAAC,EAAE,cAAc,CAAA;IACnC,QAAQ,CAAC,cAAc,EAAE,SAAS,cAAc,EAAE,CAAA;IAClD,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAC5B"}

package/dist/types/models.d.ts

@@ -0,0 +1,79 @@
+import type { LabelDefinition, ClassMapDefinition } from './labels.js';
+export type ModelFormat = 'onnx' | 'coreml' | 'openvino' | 'tflite' | 'pt';
+export type ModelOutputFormat = 'yolo' | 'ssd' | 'embedding' | 'classification' | 'ocr' | 'segmentation';
+export interface ModelFormatEntry {
+    readonly url: string;
+    readonly sizeMB: number;
+    /** Whether this format is a directory bundle (e.g., .mlpackage) rather than a single file */
+    readonly isDirectory?: boolean;
+    /**
+     * For directory formats: list of files relative to the directory root.
+     * The downloader fetches each file from `{url}/{file}` and saves to `{modelDir}/{file}`.
+     * If omitted for a directory format, the downloader probes HuggingFace API (slower).
+     */
+    readonly files?: readonly string[];
+    /** Runtime(s) that can use this format. If omitted, inferred from ModelFormat key */
+    readonly runtimes?: readonly ('node' | 'python')[];
+}
+/**
+ * Extra file that must be downloaded alongside the model (e.g., labels JSON, dict.txt).
+ * The downloader fetches from `url` and saves to `{modelsDir}/{filename}`.
+ */
+export interface ModelExtraFile {
+    readonly url: string;
+    readonly filename: string;
+    readonly sizeMB: number;
+}
+export interface ModelCatalogEntry {
+    readonly id: string;
+    readonly name: string;
+    readonly description: string;
+    readonly formats: Partial<Readonly<Record<ModelFormat, ModelFormatEntry>>>;
+    readonly inputSize: {
+        readonly width: number;
+        readonly height: number;
+    };
+    readonly labels: readonly LabelDefinition[];
+    readonly inputLayout?: 'nchw' | 'nhwc';
+    readonly inputNormalization?: 'zero-one' | 'imagenet' | 'none';
+    /**
+     * Auxiliary files required at runtime (labels JSON, charset dict, etc.).
+     * Downloaded into the same modelsDir alongside the model file.
+     */
+    readonly extraFiles?: readonly ModelExtraFile[];
+}
+export interface DetectionModel {
+    readonly id: string;
+    readonly name: string;
+    readonly labels: readonly string[];
+    readonly inputSize: {
+        readonly width: number;
+        readonly height: number;
+    };
+}
+export interface ModelDownloadOptions {
+    readonly url: string;
+    readonly fallbackUrls?: readonly string[];
+    readonly destDir: string;
+    readonly filename?: string;
+    readonly expectedSha256?: string;
+    readonly onProgress?: (downloaded: number, total: number) => void;
+}
+export interface ModelDownloadResult {
+    readonly filePath: string;
+    readonly downloadedBytes: number;
+    readonly fromCache: boolean;
+}
+export interface CustomModelMetadata {
+    readonly name: string;
+    readonly inputSize: {
+        readonly width: number;
+        readonly height: number;
+    };
+    readonly labels: readonly LabelDefinition[];
+    readonly classMap?: ClassMapDefinition;
+    readonly inputLayout?: 'nchw' | 'nhwc';
+    readonly inputNormalization?: 'zero-one' | 'imagenet' | 'none';
+    readonly outputFormat: ModelOutputFormat;
+}
+//# sourceMappingURL=models.d.ts.map

package/dist/types/models.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../../src/types/models.ts"],"names":[],"mappings":"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"}