@camstack/types 0.1.14 → 0.1.16

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

@@ -0,0 +1,201 @@
+import type { ModelCatalogEntry } from './models.js';
+import type { ClassMapDefinition } from './labels.js';
+import type { PipelineSlot } from './pipeline.js';
+import type { ConfigField } from '../interfaces/config-ui.js';
+/**
+ * Each pipeline step implements this interface as a class.
+ * `definition` holds the static metadata; `getConfigSchema()` declares
+ * per-step settings (class filters, thresholds, etc.) that the UI renders
+ * dynamically and that can be overridden per-run.
+ */
+export interface IPipelineStep {
+    readonly definition: StepDefinition;
+    getConfigSchema(): readonly ConfigField[];
+}
+export type PostprocessorType = 'yolo' | 'yolo-seg' | 'scrfd' | 'arcface' | 'softmax' | 'ctc' | 'saliency' | 'yamnet';
+export interface StepDefinition {
+    /** Unique step identifier (e.g., 'object-detection', 'face-detection') */
+    readonly id: string;
+    /** Human-readable name */
+    readonly name: string;
+    /** Pipeline slot type */
+    readonly slot: PipelineSlot;
+    /** Which postprocessor to apply to raw model output */
+    readonly postprocessor: PostprocessorType;
+    /** How this step receives its input */
+    readonly extractMode: 'full-frame' | 'crop-roi';
+    /** Classes this step accepts from a parent detector (null = root, accepts full frame) */
+    readonly inputClasses: readonly string[] | null;
+    /** Classes this step outputs (e.g., ['person','vehicle','animal'] for YOLO) */
+    readonly outputClasses: readonly string[];
+    /** Available models for this step */
+    readonly models: readonly ModelCatalogEntry[];
+    /** Default model when no user preference is set */
+    readonly defaultModelId: string;
+    /**
+     * Optional per-format model preference. When an agent seeds its
+     * `addonDefaults[this.id]`, it looks up `defaultModelIdByFormat[agent.activeEngine.format]`
+     * first, then falls back to `defaultModelId`. Lets a step express "on
+     * coreml prefer apple-soundanalysis, on onnx prefer yamnet-onnx" without
+     * duplicating the step definition per engine.
+     */
+    readonly defaultModelIdByFormat?: Readonly<Record<string, string>>;
+    /**
+     * Whether a newly-seeded agent has this addon enabled by default.
+     * Absent = `true`. Operators can always toggle this after boot; this
+     * flag only controls the initial seed for operator-first-touch
+     * convenience (e.g. keep refiners off by default so operators opt in
+     * rather than out).
+     */
+    readonly enabledByDefault?: boolean;
+    /** Default confidence threshold */
+    readonly defaultConfidence: number;
+    /** Runtime label lookup (e.g., class name arrays for softmax, charset for CTC) */
+    readonly labels?: readonly string[];
+    /** Character set for CTC decode (index 0 = blank token) */
+    readonly charset?: readonly string[];
+    /** COCO-to-macro class mapping (e.g., 'car' → 'vehicle') */
+    readonly classMap?: ClassMapDefinition;
+    /** UI grouping label — steps with the same group are displayed together (e.g., 'Segmentation') */
+    readonly group?: string;
+    /**
+     * Default minimum parent detection score to trigger this child step.
+     * Child steps are skipped if the parent detection's confidence is
+     * below this threshold. Saves inference for low-confidence detections.
+     * E.g., face-detection with minParentScore=0.7 only runs on persons
+     * detected with score ≥ 0.7. Configurable per-step via settings.
+     */
+    readonly defaultMinParentScore?: number;
+}
+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) */
+    readonly inputSize: number;
+    /** How to preprocess the image before inference */
+    readonly preprocessMode: 'letterbox' | 'resize';
+    /** Postprocessor to apply to raw output in Python */
+    readonly postprocessor: PostprocessorType;
+    /** Confidence threshold for NMS / filtering */
+    readonly confidence: number;
+    /** Label names for softmax-based classifiers */
+    readonly labels?: readonly string[];
+    /** Character set for CTC-based recognizers */
+    readonly charset?: readonly string[];
+    /** Number of classes (for YOLO: 80 COCO or 1 for plate) */
+    readonly numClasses?: number;
+    /** Anchor strides for SCRFD (default [8, 16, 32]) */
+    readonly strides?: readonly number[];
+    /** Mask threshold for saliency/segmentation */
+    readonly maskThreshold?: number;
+    /** Hardware device target (CoreML: cpu/gpu/ane/all, OpenVINO: auto/cpu/gpu/npu, ONNX: cpu/cuda/coreml) */
+    readonly device?: string;
+}
+export interface DetectionsOutput {
+    readonly kind: 'detections';
+    readonly detections: readonly {
+        readonly class: string;
+        readonly score: number;
+        readonly bbox: readonly [number, number, number, number];
+        readonly landmarks?: readonly {
+            readonly x: number;
+            readonly y: number;
+        }[];
+        /** Base64-encoded binary mask cropped to bbox (instance segmentation) */
+        readonly mask?: string;
+        /** Width of the decoded mask in pixels */
+        readonly maskWidth?: number;
+        /** Height of the decoded mask in pixels */
+        readonly maskHeight?: number;
+    }[];
+}
+export interface ClassificationsOutput {
+    readonly kind: 'classifications';
+    readonly classifications: readonly {
+        readonly class: string;
+        readonly score: number;
+    }[];
+    /** Full ranked list for debugging (top-N). Only populated when traceVerbosity is enabled. */
+    readonly alternates?: readonly {
+        readonly class: string;
+        readonly score: number;
+    }[];
+}
+export interface EmbeddingOutput {
+    readonly kind: 'embedding';
+    readonly embedding: readonly number[];
+    readonly embeddingNorm: readonly number[];
+}
+export interface TextOutput {
+    readonly kind: 'text';
+    readonly text: string;
+    readonly confidence: number;
+}
+export interface MaskOutput {
+    readonly kind: 'mask';
+    readonly mask: string;
+    readonly maskWidth: number;
+    readonly maskHeight: number;
+}
+/** Discriminated union for step output — use switch(output.kind) */
+export type StepOutput = DetectionsOutput | ClassificationsOutput | EmbeddingOutput | TextOutput | MaskOutput;
+export type TraceVerbosity = 'off' | 'summary' | 'full';
+export interface PipelineRunOptions {
+    readonly traceVerbosity?: TraceVerbosity;
+}
+export interface StepTrace {
+    readonly stepId: string;
+    readonly modelId: string;
+    readonly slot: PipelineSlot;
+    readonly postprocessor: PostprocessorType;
+    readonly preprocessMs: number;
+    readonly inferenceMs: number;
+    readonly postprocessMs: number;
+    readonly totalMs: number;
+    readonly inputType: 'full-frame' | 'crop-roi';
+    readonly inputSize: {
+        readonly width: number;
+        readonly height: number;
+    };
+    /** Class name of the parent detection that triggered this step */
+    readonly parentDetection?: string;
+    readonly outputKind: StepOutput['kind'];
+    readonly outputCount: number;
+    /** Human-readable top result (e.g., "person 0.92", "cat 0.88", "ABC123") */
+    readonly topResult?: string;
+    readonly error?: string;
+}
+export interface PipelineExecutionTrace {
+    readonly traceId: string;
+    readonly deviceId: number;
+    readonly timestamp: number;
+    readonly frameSize: {
+        readonly width: number;
+        readonly height: number;
+    };
+    readonly engineRuntime: string;
+    readonly steps: readonly StepTrace[];
+    readonly totalMs: number;
+    readonly detectionCount: number;
+    readonly [key: string]: unknown;
+}
+export interface MotionBox {
+    readonly bbox: readonly [number, number, number, number];
+    readonly changeScore: number;
+}
+export interface MotionRawEvent {
+    readonly type: 'motion.raw';
+    readonly deviceId: string;
+    readonly timestamp: number;
+    readonly boxes: readonly MotionBox[];
+    readonly frameSize: {
+        readonly width: number;
+        readonly height: number;
+    };
+    readonly motionScore: number;
+}
+export interface PipelineTraceEvent {
+    readonly type: 'pipeline.trace';
+    readonly trace: PipelineExecutionTrace;
+}
+//# sourceMappingURL=pipeline-step.d.ts.map

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

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

package/dist/types/pipeline.d.ts

@@ -1,14 +1,37 @@
 import type { DetectorOutput, CropperOutput, ClassifierOutput, RefinerOutput } from './detection.js';
-export type PipelineSlot = 'detector' | 'cropper' | 'classifier' | 'refiner';
+import type { ModelFormat } from './models.js';
+export type PipelineSlot = 'detector' | 'cropper' | 'classifier' | 'refiner' | 'audio-classifier';
+/**
+ * The selected inference environment — one per pipeline process.
+ * User picks this; all pipeline steps run within it.
+ */
+export interface PipelineEngineChoice {
+    readonly runtime: 'node' | 'python';
+    readonly backend: string;
+    readonly format: ModelFormat;
+    /** Target hardware device within the backend (e.g., 'cpu', 'gpu', 'npu', 'ane', 'auto', 'all') */
+    readonly device?: string;
+}
+/** Available devices for a specific engine backend */
+export interface EngineDeviceInfo {
+    readonly id: string;
+    readonly label: string;
+    readonly description?: string;
+}
 export interface PipelineNode {
     readonly step: string;
     readonly addon: string;
+    /** Per-step overrides — only modelId + confidence. Runtime/backend come from engine. */
     readonly configOverride?: Readonly<Record<string, unknown>>;
     readonly children?: readonly PipelineNode[];
 }
 export interface PipelineConfig {
+    /** The inference environment for ALL video steps in this pipeline */
+    readonly engine: PipelineEngineChoice;
     readonly video: readonly PipelineNode[];
     readonly audio?: PipelineNode;
+    /** Independent engine for audio classification (audio pipeline has its own runtime) */
+    readonly audioEngine?: PipelineEngineChoice;
 }
 export interface PipelineStatus {
     readonly addon: string;

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

@@ -1 +1 @@
-{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../src/types/pipeline.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAEpG,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG,SAAS,GAAG,YAAY,GAAG,SAAS,CAAA;AAE5E,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,cAAc,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;IAC3D,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,YAAY,EAAE,CAAA;CAC5C;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,KAAK,EAAE,SAAS,YAAY,EAAE,CAAA;IACvC,QAAQ,CAAC,KAAK,CAAC,EAAE,YAAY,CAAA;CAC9B;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAA;IAC3B,QAAQ,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,GAAG,SAAS,GAAG,OAAO,CAAA;IAC9D,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAC5B;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAA;CAClC;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAA;IAC3B,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,aAAa,GAAG,gBAAgB,GAAG,aAAa,CAAA;IAClF,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAA;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,CAAA;CAC3B;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,OAAO,EAAE,SAAS,UAAU,EAAE,CAAA;IACvC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;IAClD,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;CAChC"}
+{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../src/types/pipeline.ts"],"names":[],"mappings":"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"}

package/dist/utils/element-config-store.d.ts

@@ -0,0 +1,29 @@
+import type { IElementConfig } from '../interfaces/context.js';
+import type { ISettingsBackend } from '../interfaces/storage.js';
+/**
+ * Persisted config store for a single element.
+ * Reads/writes to the element's scoped storage under the 'config' collection.
+ * Notifies listeners on every change.
+ */
+export declare class ElementConfigStore implements IElementConfig {
+    private readonly elementId;
+    private cache;
+    private listeners;
+    private loaded;
+    private readonly getBackend;
+    constructor(elementId: string, settingsBackend: ISettingsBackend | (() => ISettingsBackend | null) | null);
+    /** Load config from storage into cache. Called once on first access. */
+    private ensureLoaded;
+    getAll(): Record<string, unknown>;
+    get<T = unknown>(key: string): T | undefined;
+    set(key: string, value: unknown): Promise<void>;
+    setAll(config: Record<string, unknown>): Promise<void>;
+    onChange(callback: (config: Record<string, unknown>) => void): () => void;
+    /** Initialize from storage — called by ContextFactory after creation */
+    load(): Promise<void>;
+    /** Initialize with default values (doesn't overwrite existing) */
+    loadDefaults(defaults: Record<string, unknown>): Promise<void>;
+    private persist;
+    private notifyListeners;
+}
+//# sourceMappingURL=element-config-store.d.ts.map

package/dist/utils/element-config-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"element-config-store.d.ts","sourceRoot":"","sources":["../../src/utils/element-config-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAA;AAC9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAA;AAEhE;;;;GAIG;AACH,qBAAa,kBAAmB,YAAW,cAAc;IAQrD,OAAO,CAAC,QAAQ,CAAC,SAAS;IAP5B,OAAO,CAAC,KAAK,CAA8B;IAC3C,OAAO,CAAC,SAAS,CAA4D;IAC7E,OAAO,CAAC,MAAM,CAAQ;IAEtB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA+B;gBAGvC,SAAS,EAAE,MAAM,EAClC,eAAe,EAAE,gBAAgB,GAAG,CAAC,MAAM,gBAAgB,GAAG,IAAI,CAAC,GAAG,IAAI;IAQ5E,wEAAwE;YAC1D,YAAY;IAiB1B,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAIjC,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAYtC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAO/C,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAO5D,QAAQ,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,GAAG,MAAM,IAAI;IAKzE,wEAAwE;IAClE,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B,kEAAkE;IAC5D,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;YAQtD,OAAO;IAWrB,OAAO,CAAC,eAAe;CAUxB"}

package/dist/utils/err-msg.d.ts

@@ -0,0 +1,7 @@
+/**
+import { errMsg } from '@camstack/types'
+ * Extract a human-readable message from an unknown error value.
+ * Replaces the ubiquitous `errMsg(err)` pattern.
+ */
+export declare function errMsg(err: unknown): string;
+//# sourceMappingURL=err-msg.d.ts.map

package/dist/utils/err-msg.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"err-msg.d.ts","sourceRoot":"","sources":["../../src/utils/err-msg.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAI3C"}

package/dist/utils/json-safe.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Type-safe JSON parsing helpers.
+ *
+ * `JSON.parse` is typed as `any` in lib.es5.d.ts, which triggers
+ * `no-unsafe-*` ESLint rules and destroys downstream inference. These
+ * wrappers return `unknown` — callers narrow structurally via type
+ * guards, `typeof` checks, or helpers like `asRecord`/`asString`.
+ */
+/**
+ * Parse JSON and return it as `unknown` — the only entry point for untrusted JSON.
+ *
+ * The optional generic overload `parseJsonUnknown<T>(text)` returns `T` for
+ * call sites that know the shape at parse time (e.g. MQTT payloads with a
+ * known protocol schema). This is a **type-level bridge only** — no runtime
+ * validation is performed. Callers that need runtime validation should parse
+ * as `unknown` and narrow via Zod or structural guards.
+ */
+export declare function parseJsonUnknown<T = unknown>(text: string): T;
+/** Narrow an unknown value to a plain `Record<string, unknown>` or return null. */
+export declare function asJsonObject(value: unknown): Record<string, unknown> | null;
+/** Narrow an unknown value to a `readonly unknown[]` or return an empty array. */
+export declare function asJsonArray(value: unknown): readonly unknown[];
+/** Safe string extraction from an unknown record field. */
+export declare function asString(value: unknown, fallback?: string): string;
+/** Safe number extraction from an unknown record field. */
+export declare function asNumber(value: unknown, fallback?: number): number;
+/** Safe boolean extraction from an unknown record field. */
+export declare function asBoolean(value: unknown, fallback?: boolean): boolean;
+/** Parse JSON + narrow to object in one step. */
+export declare function parseJsonObject(text: string): Record<string, unknown> | null;
+/** Parse JSON + narrow to array in one step. */
+export declare function parseJsonArray(text: string): readonly unknown[] | null;
+//# sourceMappingURL=json-safe.d.ts.map

package/dist/utils/json-safe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-safe.d.ts","sourceRoot":"","sources":["../../src/utils/json-safe.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,CAI7D;AAED,mFAAmF;AACnF,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAK3E;AAED,kFAAkF;AAClF,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,OAAO,EAAE,CAE9D;AAED,2DAA2D;AAC3D,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,SAAK,GAAG,MAAM,CAE9D;AAED,2DAA2D;AAC3D,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,SAAI,GAAG,MAAM,CAE7D;AAED,4DAA4D;AAC5D,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,UAAQ,GAAG,OAAO,CAEnE;AAED,iDAAiD;AACjD,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAM5E;AAED,gDAAgD;AAChD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,OAAO,EAAE,GAAG,IAAI,CAOtE"}

package/dist/utils/mask-url.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Strip the `userinfo` (`user:password@`) component from any URL we
+ * surface in logs or telemetry. Camera credentials live inside RTSP /
+ * RTMP / HTTP URLs by convention; emitting them verbatim leaks
+ * plaintext secrets into log files, support transcripts, and shared
+ * diagnostics. Returns the original string when the input is not a
+ * parseable URL — a log helper must never throw.
+ */
+export declare function maskUrlCredentials(rawUrl: string): string;
+//# sourceMappingURL=mask-url.d.ts.map

package/dist/utils/mask-url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mask-url.d.ts","sourceRoot":"","sources":["../../src/utils/mask-url.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAUzD"}

package/dist/utils/ring-buffer.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Fixed-capacity ring buffer. When full, push() overwrites the oldest entry.
+ * drain() returns up to maxCount items in FIFO order and removes them.
+ */
+export declare class RingBuffer<T> {
+    private readonly capacity;
+    private readonly items;
+    private head;
+    private tail;
+    private count;
+    constructor(capacity: number);
+    get size(): number;
+    push(item: T): void;
+    drain(maxCount: number): T[];
+}
+//# sourceMappingURL=ring-buffer.d.ts.map

package/dist/utils/ring-buffer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ring-buffer.d.ts","sourceRoot":"","sources":["../../src/utils/ring-buffer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,qBAAa,UAAU,CAAC,CAAC;IAMX,OAAO,CAAC,QAAQ,CAAC,QAAQ;IALrC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAsB;IAC5C,OAAO,CAAC,IAAI,CAAI;IAChB,OAAO,CAAC,IAAI,CAAI;IAChB,OAAO,CAAC,KAAK,CAAI;gBAEY,QAAQ,EAAE,MAAM;IAI7C,IAAI,IAAI,IAAI,MAAM,CAAsB;IAExC,IAAI,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI;IAUnB,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,CAAC,EAAE;CAW7B"}

package/dist/utils/run-inference-step.d.ts

@@ -0,0 +1,26 @@
+/**
+ * runInferenceStep — shared utility for executing a single inference call
+ * with timing, error capture, and optional timeout.
+ *
+ * Used by: pipeline-executor, benchmark-executor, benchmark.service,
+ * inference-engine-adapter — eliminating duplicated timing/error patterns.
+ */
+export interface InferenceStepResult<T> {
+    /** The inference output, or undefined if the call failed */
+    readonly output: T | undefined;
+    /** Wall-clock duration in ms (rounded to 2 decimals) */
+    readonly durationMs: number;
+    /** True if the call succeeded */
+    readonly ok: boolean;
+    /** Error message if the call failed */
+    readonly error?: string;
+}
+/**
+ * Execute an inference function with timing and error capture.
+ *
+ * @param fn - The inference call (e.g. `() => engine.infer(frame)`)
+ * @param timeoutMs - Optional timeout in ms. If exceeded, rejects with timeout error.
+ * @returns InferenceStepResult with output, timing, and error info
+ */
+export declare function runInferenceStep<T>(fn: () => Promise<T>, timeoutMs?: number): Promise<InferenceStepResult<T>>;
+//# sourceMappingURL=run-inference-step.d.ts.map

package/dist/utils/run-inference-step.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-inference-step.d.ts","sourceRoot":"","sources":["../../src/utils/run-inference-step.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AAEH,MAAM,WAAW,mBAAmB,CAAC,CAAC;IACpC,4DAA4D;IAC5D,QAAQ,CAAC,MAAM,EAAE,CAAC,GAAG,SAAS,CAAA;IAC9B,wDAAwD;IACxD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,iCAAiC;IACjC,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAA;IACpB,uCAAuC;IACvC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CACxB;AAED;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CAAC,CAAC,EACtC,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,CAqBjC"}

package/dist/utils/runtime-mapping.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Canonical runtime/backend/format mapping utilities.
+ *
+ * This is the SINGLE SOURCE OF TRUTH for mapping between:
+ * - Pipeline config (runtime: 'node'|'python', backend: 'cpu'|'coreml'|'cuda'|...)
+ * - DetectionRuntime ('onnx'|'coreml'|'pytorch'|'openvino'|'tflite')
+ * - ModelFormat ('onnx'|'coreml'|'openvino'|'tflite'|'pt')
+ *
+ * Import from '@camstack/types' — do NOT duplicate these mappings anywhere.
+ */
+import type { ModelFormat } from '../types/models.js';
+import type { DetectionRuntime } from '../types/config.js';
+/** Pipeline-level runtime: 'node' (ONNX Runtime in Node.js) or 'python' (Python inference) */
+export type PipelineRuntime = 'node' | 'python';
+/**
+ * Map a backend ID to the model format it requires.
+ *
+ * Node.js backends (cpu, coreml, cuda, tensorrt) all use ONNX format
+ * because onnxruntime-node loads .onnx and uses execution providers internally.
+ *
+ * Python backends use their native format.
+ */
+declare const BACKEND_TO_FORMAT: Readonly<Record<string, ModelFormat>>;
+/**
+ * Map DetectionRuntime to ModelFormat.
+ * Used when the addon receives an explicit runtime (not 'auto').
+ */
+declare const RUNTIME_TO_FORMAT: Readonly<Record<DetectionRuntime, ModelFormat>>;
+/**
+ * Map a Python backend to the Python inference script name.
+ */
+declare const PYTHON_SCRIPT: Readonly<Record<string, string>>;
+/**
+ * Resolve pipeline config (runtime + backend) to a DetectionRuntime.
+ *
+ * Pipeline config uses two levels:
+ *   runtime: 'node' | 'python'
+ *   backend: 'cpu' | 'coreml' | 'cuda' | 'openvino' | 'pytorch' | ...
+ *
+ * Addons expect a DetectionRuntime:
+ *   'onnx' | 'coreml' | 'pytorch' | 'openvino' | 'tflite'
+ *
+ * Mapping rules:
+ *   node + any backend   → 'onnx' (onnxruntime-node handles backend via EP)
+ *   python + coreml      → 'coreml' (native .mlpackage via coremltools)
+ *   python + openvino    → 'openvino'
+ *   python + pytorch     → 'pytorch'
+ *   python + onnx-py     → 'onnx'
+ *   python + <other>     → backend as-is
+ */
+export declare function resolveDetectionRuntime(pipelineRuntime: PipelineRuntime | string, backend: string): DetectionRuntime;
+/**
+ * Resolve pipeline config (runtime + backend) to a ModelFormat.
+ *
+ * Determines which model file format is needed (.onnx, .mlpackage, etc.)
+ */
+export declare function resolveModelFormat(pipelineRuntime: PipelineRuntime | string, backend: string): ModelFormat;
+/**
+ * Resolve pipeline runtime string to 'auto' | DetectionRuntime for addon consumption.
+ * Used when building addon addonConfig from pipeline step config.
+ *
+ *   'python' + 'coreml'   → 'coreml'
+ *   'node'   + 'coreml'   → 'onnx'
+ *   'node'   + 'cpu'      → 'onnx'
+ *   'auto'                → 'auto'
+ */
+export declare function resolveAddonRuntime(pipelineRuntime: string | undefined, backend: string | undefined): DetectionRuntime | 'auto';
+/**
+ * Get the model format needed for a given backend.
+ * Convenience wrapper for backend-only lookup (e.g., UI components).
+ */
+export declare function formatForBackend(backend: string): ModelFormat;
+/**
+ * Get the model format for a given DetectionRuntime.
+ */
+export declare function formatForRuntime(runtime: DetectionRuntime): ModelFormat;
+/**
+ * Get the Python inference script name for a backend.
+ * Returns undefined if no Python script is needed (e.g., 'cpu' uses ONNX).
+ */
+export declare function pythonScriptForBackend(backend: string): string | undefined;
+/**
+ * Check if a DetectionRuntime requires a Python binary.
+ * 'coreml', 'pytorch', 'openvino' need Python; 'onnx' and 'tflite' don't.
+ */
+export declare function requiresPython(runtime: DetectionRuntime | string): boolean;
+export { BACKEND_TO_FORMAT, RUNTIME_TO_FORMAT, PYTHON_SCRIPT };
+//# sourceMappingURL=runtime-mapping.d.ts.map

package/dist/utils/runtime-mapping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-mapping.d.ts","sourceRoot":"","sources":["../../src/utils/runtime-mapping.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AACrD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAM1D,8FAA8F;AAC9F,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,QAAQ,CAAA;AAM/C;;;;;;;GAOG;AACH,QAAA,MAAM,iBAAiB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAU5D,CAAA;AAED;;;GAGG;AACH,QAAA,MAAM,iBAAiB,EAAE,QAAQ,CAAC,MAAM,CAAC,gBAAgB,EAAE,WAAW,CAAC,CAMtE,CAAA;AAED;;GAEG;AACH,QAAA,MAAM,aAAa,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAInD,CAAA;AAMD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,uBAAuB,CACrC,eAAe,EAAE,eAAe,GAAG,MAAM,EACzC,OAAO,EAAE,MAAM,GACd,gBAAgB,CAWlB;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,eAAe,EAAE,eAAe,GAAG,MAAM,EACzC,OAAO,EAAE,MAAM,GACd,WAAW,CAab;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,eAAe,EAAE,MAAM,GAAG,SAAS,EACnC,OAAO,EAAE,MAAM,GAAG,SAAS,GAC1B,gBAAgB,GAAG,MAAM,CAG3B;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,CAE7D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,gBAAgB,GAAG,WAAW,CAEvE;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAE1E;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,GAAG,OAAO,CAE1E;AAGD,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,aAAa,EAAE,CAAA"}

package/dist/utils/zone-rule-eval.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Pure rules-driven zone evaluator. Shared between every consumer
+ * that gates items (motion regions, detections, future audio events,
+ * …) by `(zones, rules)` pairs. Lives in `@camstack/types/utils` so
+ * addon-motion-wasm + addon-detection-pipeline share one canonical
+ * implementation.
+ *
+ * Semantics — match the analytics zone-engine introduced in Phase 2a:
+ *   - any active include rule fires ⇒ whitelist mode (only items
+ *     satisfying at least one include rule pass)
+ *   - otherwise ⇒ blacklist mode (items in any exclude rule are
+ *     dropped, the rest pass)
+ *   - inactive rules (`enabled: false`) are skipped before the gate
+ *   - a rule's `classFilter` narrows it to the listed classes; an
+ *     item whose class isn't in the filter is invisible to that rule
+ *
+ * Test point: each item provides a normalised (0–1) center via the
+ * `getCenter` accessor; rules fire when the center lies inside any
+ * of the rule's referenced zone polygons (ray-cast point-in-polygon).
+ * Bbox-area overlap would be marginally more intuitive on tiny
+ * items but doubles the per-frame cost; the center test keeps the
+ * hot path cheap and matches the operator's intuition for
+ * "where is the activity centered".
+ */
+import type { Zone } from '../capabilities/zones.cap.js';
+import type { ZoneRule } from '../capabilities/schemas/zone-rule.js';
+export interface ZoneRuleEvalResult<T> {
+    readonly passed: readonly T[];
+    readonly excluded: readonly T[];
+}
+/**
+ * Evaluate `rules` against `items`. Returns the items partitioned
+ * into `passed` (kept by the gate) and `excluded` (dropped). When
+ * `rules` is empty or `zones` is empty everything passes — the gate
+ * is "off" without explicit configuration.
+ *
+ * `getCenter` returns the item's normalised (0–1) center point.
+ * `getClassName` is optional — when omitted, every rule's
+ * `classFilter` is treated as matching all classes (motion-stage
+ * semantics). Provide it for object detections so per-class rules
+ * narrow correctly.
+ */
+export declare function evaluateZoneRules<T>(items: readonly T[], zones: readonly Zone[], rules: readonly ZoneRule[], getCenter: (item: T) => {
+    readonly x: number;
+    readonly y: number;
+}, getClassName?: (item: T) => string | undefined): ZoneRuleEvalResult<T>;
+//# sourceMappingURL=zone-rule-eval.d.ts.map

package/dist/utils/zone-rule-eval.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zone-rule-eval.d.ts","sourceRoot":"","sources":["../../src/utils/zone-rule-eval.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,8BAA8B,CAAA;AACxD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sCAAsC,CAAA;AAEpE,MAAM,WAAW,kBAAkB,CAAC,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC,EAAE,CAAA;IAC7B,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC,EAAE,CAAA;CAChC;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EACjC,KAAK,EAAE,SAAS,CAAC,EAAE,EACnB,KAAK,EAAE,SAAS,IAAI,EAAE,EACtB,KAAK,EAAE,SAAS,QAAQ,EAAE,EAC1B,SAAS,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK;IAAE,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAA;CAAE,EAClE,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,GAAG,SAAS,GAC7C,kBAAkB,CAAC,CAAC,CAAC,CA2BvB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/types",
-  "version": "0.1.14",
+  "version": "0.1.16",
   "description": "Shared types, interfaces, and model catalogs for the CamStack detection ecosystem",
   "keywords": [
     "camstack",
@@ -24,6 +24,11 @@
       "import": "./dist/index.mjs",
       "require": "./dist/index.js"
     },
+    "./node": {
+      "types": "./dist/node.d.ts",
+      "import": "./dist/node.mjs",
+      "require": "./dist/node.js"
+    },
     "./catalogs": {
       "types": "./dist/catalogs/index.d.ts",
       "import": "./dist/catalogs/index.mjs",
@@ -35,7 +40,7 @@
     "dist"
   ],
   "scripts": {
-    "build": "tsup && tsc --declaration --emitDeclarationOnly --outDir dist --skipLibCheck",
+    "build": "vite build && tsc -p tsconfig.json --emitDeclarationOnly",
     "dev": "tsup --watch",
     "typecheck": "tsc --noEmit",
     "test": "vitest run",
@@ -43,9 +48,13 @@
     "publish": "npm publish --access public"
   },
   "devDependencies": {
+    "@trpc/client": "^11.16.0",
     "@trpc/server": "^11.16.0",
     "tsup": "^8.0.0",
     "typescript": "~5.9.0",
     "vitest": "^3.0.0"
+  },
+  "dependencies": {
+    "zod": "^4.3.6"
   }
 }

package/dist/__tests__/addon-capability-provider.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=addon-capability-provider.test.d.ts.map

package/dist/__tests__/addon-capability-provider.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"addon-capability-provider.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/addon-capability-provider.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/addon-declaration.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=addon-declaration.test.d.ts.map

package/dist/__tests__/addon-declaration.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"addon-declaration.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/addon-declaration.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/capability.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=capability.test.d.ts.map

package/dist/__tests__/capability.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"capability.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/capability.test.ts"],"names":[],"mappings":""}