@camstack/vision 0.1.0

package/dist/index.js

@@ -0,0 +1,2775 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var src_exports = {};
+__export(src_exports, {
+  AnimalClassifierAddon: () => AnimalClassifierAddon,
+  AudioClassificationAddon: () => AudioClassificationAddon,
+  BirdGlobalClassifierAddon: () => BirdGlobalClassifierAddon,
+  BirdNABirdsClassifierAddon: () => BirdNABirdsClassifierAddon,
+  CameraNativeDetectionAddon: () => CameraNativeDetectionAddon,
+  FaceDetectionAddon: () => FaceDetectionAddon,
+  FaceRecognitionAddon: () => FaceRecognitionAddon,
+  MotionDetectionAddon: () => MotionDetectionAddon,
+  NodeInferenceEngine: () => NodeInferenceEngine,
+  ObjectDetectionAddon: () => ObjectDetectionAddon,
+  PlateDetectionAddon: () => PlateDetectionAddon,
+  PlateRecognitionAddon: () => PlateRecognitionAddon,
+  PythonInferenceEngine: () => PythonInferenceEngine,
+  cosineSimilarity: () => cosineSimilarity,
+  cropRegion: () => cropRegion,
+  ctcDecode: () => ctcDecode,
+  detectMotion: () => detectMotion,
+  iou: () => iou,
+  jpegToRgb: () => jpegToRgb,
+  l2Normalize: () => l2Normalize,
+  letterbox: () => letterbox,
+  nms: () => nms,
+  probeOnnxBackends: () => probeOnnxBackends,
+  resizeAndNormalize: () => resizeAndNormalize,
+  resolveEngine: () => resolveEngine,
+  rgbToGrayscale: () => rgbToGrayscale,
+  scrfdPostprocess: () => scrfdPostprocess,
+  yamnetPostprocess: () => yamnetPostprocess,
+  yoloPostprocess: () => yoloPostprocess
+});
+module.exports = __toCommonJS(src_exports);
+
+// src/shared/image-utils.ts
+var import_sharp = __toESM(require("sharp"));
+async function jpegToRgb(jpeg) {
+  const { data, info } = await (0, import_sharp.default)(jpeg).removeAlpha().raw().toBuffer({ resolveWithObject: true });
+  return { data, width: info.width, height: info.height };
+}
+async function cropRegion(jpeg, roi) {
+  return (0, import_sharp.default)(jpeg).extract({
+    left: Math.round(roi.x),
+    top: Math.round(roi.y),
+    width: Math.round(roi.w),
+    height: Math.round(roi.h)
+  }).jpeg().toBuffer();
+}
+async function letterbox(jpeg, targetSize) {
+  const meta = await (0, import_sharp.default)(jpeg).metadata();
+  const originalWidth = meta.width ?? 0;
+  const originalHeight = meta.height ?? 0;
+  const scale = Math.min(targetSize / originalWidth, targetSize / originalHeight);
+  const scaledWidth = Math.round(originalWidth * scale);
+  const scaledHeight = Math.round(originalHeight * scale);
+  const padX = Math.floor((targetSize - scaledWidth) / 2);
+  const padY = Math.floor((targetSize - scaledHeight) / 2);
+  const { data } = await (0, import_sharp.default)(jpeg).resize(scaledWidth, scaledHeight).extend({
+    top: padY,
+    bottom: targetSize - scaledHeight - padY,
+    left: padX,
+    right: targetSize - scaledWidth - padX,
+    background: { r: 114, g: 114, b: 114 }
+  }).removeAlpha().raw().toBuffer({ resolveWithObject: true });
+  const numPixels = targetSize * targetSize;
+  const float32 = new Float32Array(3 * numPixels);
+  for (let i = 0; i < numPixels; i++) {
+    const srcBase = i * 3;
+    float32[0 * numPixels + i] = data[srcBase] / 255;
+    float32[1 * numPixels + i] = data[srcBase + 1] / 255;
+    float32[2 * numPixels + i] = data[srcBase + 2] / 255;
+  }
+  return { data: float32, scale, padX, padY, originalWidth, originalHeight };
+}
+async function resizeAndNormalize(jpeg, targetWidth, targetHeight, normalization, layout) {
+  const { data } = await (0, import_sharp.default)(jpeg).resize(targetWidth, targetHeight).removeAlpha().raw().toBuffer({ resolveWithObject: true });
+  const numPixels = targetWidth * targetHeight;
+  const float32 = new Float32Array(3 * numPixels);
+  const mean = [0.485, 0.456, 0.406];
+  const std = [0.229, 0.224, 0.225];
+  if (layout === "nchw") {
+    for (let i = 0; i < numPixels; i++) {
+      const srcBase = i * 3;
+      for (let c = 0; c < 3; c++) {
+        const raw = data[srcBase + c] / 255;
+        let val;
+        if (normalization === "zero-one") {
+          val = raw;
+        } else if (normalization === "imagenet") {
+          val = (raw - mean[c]) / std[c];
+        } else {
+          val = data[srcBase + c];
+        }
+        float32[c * numPixels + i] = val;
+      }
+    }
+  } else {
+    for (let i = 0; i < numPixels; i++) {
+      const srcBase = i * 3;
+      for (let c = 0; c < 3; c++) {
+        const raw = data[srcBase + c] / 255;
+        let val;
+        if (normalization === "zero-one") {
+          val = raw;
+        } else if (normalization === "imagenet") {
+          val = (raw - mean[c]) / std[c];
+        } else {
+          val = data[srcBase + c];
+        }
+        float32[i * 3 + c] = val;
+      }
+    }
+  }
+  return float32;
+}
+function rgbToGrayscale(rgb, width, height) {
+  const numPixels = width * height;
+  const gray = new Uint8Array(numPixels);
+  for (let i = 0; i < numPixels; i++) {
+    const r = rgb[i * 3];
+    const g = rgb[i * 3 + 1];
+    const b = rgb[i * 3 + 2];
+    gray[i] = Math.round(0.299 * r + 0.587 * g + 0.114 * b);
+  }
+  return gray;
+}
+
+// src/shared/postprocess/yolo.ts
+function iou(a, b) {
+  const ax1 = a.x;
+  const ay1 = a.y;
+  const ax2 = a.x + a.w;
+  const ay2 = a.y + a.h;
+  const bx1 = b.x;
+  const by1 = b.y;
+  const bx2 = b.x + b.w;
+  const by2 = b.y + b.h;
+  const interX1 = Math.max(ax1, bx1);
+  const interY1 = Math.max(ay1, by1);
+  const interX2 = Math.min(ax2, bx2);
+  const interY2 = Math.min(ay2, by2);
+  const interW = Math.max(0, interX2 - interX1);
+  const interH = Math.max(0, interY2 - interY1);
+  const interArea = interW * interH;
+  if (interArea === 0) return 0;
+  const areaA = a.w * a.h;
+  const areaB = b.w * b.h;
+  const unionArea = areaA + areaB - interArea;
+  return unionArea === 0 ? 0 : interArea / unionArea;
+}
+function nms(boxes, iouThreshold) {
+  const indices = boxes.map((_, i) => i).sort((a, b) => boxes[b].score - boxes[a].score);
+  const kept = [];
+  const suppressed = /* @__PURE__ */ new Set();
+  for (const idx of indices) {
+    if (suppressed.has(idx)) continue;
+    kept.push(idx);
+    for (const other of indices) {
+      if (other === idx || suppressed.has(other)) continue;
+      if (iou(boxes[idx].bbox, boxes[other].bbox) > iouThreshold) {
+        suppressed.add(other);
+      }
+    }
+  }
+  return kept;
+}
+function yoloPostprocess(output, numClasses, numBoxes, options) {
+  const { confidence, iouThreshold, labels, scale, padX, padY, originalWidth, originalHeight } = options;
+  const candidates = [];
+  for (let i = 0; i < numBoxes; i++) {
+    const cx = output[0 * numBoxes + i];
+    const cy = output[1 * numBoxes + i];
+    const w = output[2 * numBoxes + i];
+    const h = output[3 * numBoxes + i];
+    let bestScore = -Infinity;
+    let bestClass = 0;
+    for (let j = 0; j < numClasses; j++) {
+      const score = output[(4 + j) * numBoxes + i];
+      if (score > bestScore) {
+        bestScore = score;
+        bestClass = j;
+      }
+    }
+    if (bestScore < confidence) continue;
+    const bbox = {
+      x: cx - w / 2,
+      y: cy - h / 2,
+      w,
+      h
+    };
+    candidates.push({ bbox, score: bestScore, classIdx: bestClass });
+  }
+  if (candidates.length === 0) return [];
+  const keptIndices = nms(candidates, iouThreshold);
+  return keptIndices.map((idx) => {
+    const { bbox, score, classIdx } = candidates[idx];
+    const label = labels[classIdx] ?? String(classIdx);
+    const x = Math.max(0, Math.min(originalWidth, (bbox.x - padX) / scale));
+    const y = Math.max(0, Math.min(originalHeight, (bbox.y - padY) / scale));
+    const x2 = Math.max(0, Math.min(originalWidth, (bbox.x + bbox.w - padX) / scale));
+    const y2 = Math.max(0, Math.min(originalHeight, (bbox.y + bbox.h - padY) / scale));
+    const finalBbox = { x, y, w: x2 - x, h: y2 - y };
+    return {
+      class: label,
+      originalClass: label,
+      score,
+      bbox: finalBbox
+    };
+  });
+}
+
+// src/shared/postprocess/scrfd.ts
+var STRIDES = [8, 16, 32];
+var NUM_ANCHORS_PER_STRIDE = 2;
+function generateAnchors(stride, inputSize) {
+  const featureSize = Math.ceil(inputSize / stride);
+  const anchors = [];
+  for (let y = 0; y < featureSize; y++) {
+    for (let x = 0; x < featureSize; x++) {
+      for (let k = 0; k < NUM_ANCHORS_PER_STRIDE; k++) {
+        anchors.push({
+          cx: (x + 0.5) * stride,
+          cy: (y + 0.5) * stride
+        });
+      }
+    }
+  }
+  return anchors;
+}
+function scrfdPostprocess(outputs, confidence, inputSize, originalWidth, originalHeight) {
+  const scaleX = originalWidth / inputSize;
+  const scaleY = originalHeight / inputSize;
+  const candidates = [];
+  for (const stride of STRIDES) {
+    const scoreKey = Object.keys(outputs).find((k) => k.includes(`score_${stride}`) || k.includes(`_${stride}_score`));
+    const bboxKey = Object.keys(outputs).find((k) => k.includes(`bbox_${stride}`) || k.includes(`_${stride}_bbox`));
+    const kpsKey = Object.keys(outputs).find((k) => k.includes(`kps_${stride}`) || k.includes(`_${stride}_kps`));
+    if (!scoreKey || !bboxKey) continue;
+    const scores = outputs[scoreKey];
+    const bboxes = outputs[bboxKey];
+    const kps = kpsKey ? outputs[kpsKey] : void 0;
+    const anchors = generateAnchors(stride, inputSize);
+    const n = anchors.length;
+    for (let i = 0; i < n; i++) {
+      const score = scores[i];
+      if (score < confidence) continue;
+      const anchor = anchors[i];
+      const x1 = anchor.cx - bboxes[i * 4] * stride;
+      const y1 = anchor.cy - bboxes[i * 4 + 1] * stride;
+      const x2 = anchor.cx + bboxes[i * 4 + 2] * stride;
+      const y2 = anchor.cy + bboxes[i * 4 + 3] * stride;
+      const bbox = {
+        x: x1 * scaleX,
+        y: y1 * scaleY,
+        w: (x2 - x1) * scaleX,
+        h: (y2 - y1) * scaleY
+      };
+      let landmarks;
+      if (kps) {
+        const pts = [];
+        for (let p = 0; p < 5; p++) {
+          pts.push({
+            x: (anchor.cx + kps[i * 10 + p * 2] * stride) * scaleX,
+            y: (anchor.cy + kps[i * 10 + p * 2 + 1] * stride) * scaleY
+          });
+        }
+        landmarks = pts;
+      }
+      candidates.push({ bbox, score, landmarks });
+    }
+  }
+  if (candidates.length === 0) return [];
+  const keptIndices = nms(candidates, 0.45);
+  return keptIndices.map((idx) => {
+    const { bbox, score, landmarks } = candidates[idx];
+    return {
+      class: "face",
+      originalClass: "face",
+      score,
+      bbox,
+      ...landmarks ? { landmarks } : {}
+    };
+  });
+}
+
+// src/shared/postprocess/arcface.ts
+function l2Normalize(vec) {
+  let sumSq = 0;
+  for (let i = 0; i < vec.length; i++) {
+    sumSq += vec[i] * vec[i];
+  }
+  const norm = Math.sqrt(sumSq);
+  if (norm === 0) return new Float32Array(vec.length);
+  const out = new Float32Array(vec.length);
+  for (let i = 0; i < vec.length; i++) {
+    out[i] = vec[i] / norm;
+  }
+  return out;
+}
+function cosineSimilarity(a, b) {
+  if (a.length !== b.length) throw new Error("Embedding length mismatch");
+  let dot = 0;
+  for (let i = 0; i < a.length; i++) {
+    dot += a[i] * b[i];
+  }
+  return dot;
+}
+
+// src/shared/postprocess/paddleocr.ts
+function ctcDecode(output, seqLen, numChars, charset) {
+  let totalLogScore = 0;
+  const rawIndices = [];
+  for (let t = 0; t < seqLen; t++) {
+    const offset = t * numChars;
+    let bestIdx = 0;
+    let bestVal = output[offset];
+    for (let c = 1; c < numChars; c++) {
+      const val = output[offset + c];
+      if (val > bestVal) {
+        bestVal = val;
+        bestIdx = c;
+      }
+    }
+    rawIndices.push(bestIdx);
+    totalLogScore += bestVal;
+  }
+  const collapsed = [];
+  for (let i = 0; i < rawIndices.length; i++) {
+    const cur = rawIndices[i];
+    if (i === 0 || cur !== rawIndices[i - 1]) {
+      collapsed.push(cur);
+    }
+  }
+  const filtered = collapsed.filter((idx) => idx !== 0);
+  const text = filtered.map((idx) => charset[idx] ?? "").join("");
+  const confidence = seqLen > 0 ? totalLogScore / seqLen : 0;
+  return { text, confidence };
+}
+
+// src/shared/postprocess/yamnet.ts
+function yamnetPostprocess(output, numFrames, numClasses, classNames, minScore) {
+  const avgScores = new Float32Array(numClasses);
+  for (let f = 0; f < numFrames; f++) {
+    for (let c = 0; c < numClasses; c++) {
+      const prev = avgScores[c] ?? 0;
+      avgScores[c] = prev + (output[f * numClasses + c] ?? 0);
+    }
+  }
+  if (numFrames > 0) {
+    for (let c = 0; c < numClasses; c++) {
+      const val = avgScores[c] ?? 0;
+      avgScores[c] = val / numFrames;
+    }
+  }
+  const results = [];
+  for (let c = 0; c < numClasses; c++) {
+    const score = avgScores[c];
+    if (score >= minScore) {
+      results.push({
+        className: classNames[c] ?? String(c),
+        score
+      });
+    }
+  }
+  return results.sort((a, b) => b.score - a.score);
+}
+
+// src/shared/node-engine.ts
+var path = __toESM(require("path"));
+var BACKEND_TO_PROVIDER = {
+  cpu: "cpu",
+  coreml: "coreml",
+  cuda: "cuda",
+  tensorrt: "tensorrt",
+  dml: "dml"
+};
+var BACKEND_TO_DEVICE = {
+  cpu: "cpu",
+  coreml: "gpu-mps",
+  cuda: "gpu-cuda",
+  tensorrt: "tensorrt"
+};
+var NodeInferenceEngine = class {
+  constructor(modelPath, backend) {
+    this.modelPath = modelPath;
+    this.backend = backend;
+    this.device = BACKEND_TO_DEVICE[backend] ?? "cpu";
+  }
+  runtime = "onnx";
+  device;
+  session = null;
+  async initialize() {
+    const ort = await import("onnxruntime-node");
+    const provider = BACKEND_TO_PROVIDER[this.backend] ?? "cpu";
+    const absModelPath = path.isAbsolute(this.modelPath) ? this.modelPath : path.resolve(process.cwd(), this.modelPath);
+    const sessionOptions = {
+      executionProviders: [provider]
+    };
+    this.session = await ort.InferenceSession.create(absModelPath, sessionOptions);
+  }
+  async run(input, inputShape) {
+    if (!this.session) {
+      throw new Error("NodeInferenceEngine: not initialized \u2014 call initialize() first");
+    }
+    const ort = await import("onnxruntime-node");
+    const sess = this.session;
+    const inputName = sess.inputNames[0];
+    const tensor = new ort.Tensor("float32", input, [...inputShape]);
+    const feeds = { [inputName]: tensor };
+    const results = await sess.run(feeds);
+    const outputName = sess.outputNames[0];
+    const outputTensor = results[outputName];
+    return outputTensor.data;
+  }
+  async runMultiOutput(input, inputShape) {
+    if (!this.session) {
+      throw new Error("NodeInferenceEngine: not initialized \u2014 call initialize() first");
+    }
+    const ort = await import("onnxruntime-node");
+    const sess = this.session;
+    const inputName = sess.inputNames[0];
+    const tensor = new ort.Tensor("float32", input, [...inputShape]);
+    const feeds = { [inputName]: tensor };
+    const results = await sess.run(feeds);
+    const out = {};
+    for (const name of sess.outputNames) {
+      out[name] = results[name].data;
+    }
+    return out;
+  }
+  async dispose() {
+    this.session = null;
+  }
+};
+
+// src/shared/python-engine.ts
+var import_node_child_process = require("child_process");
+var PythonInferenceEngine = class {
+  constructor(pythonPath, runtime, modelPath, extraArgs = []) {
+    this.pythonPath = pythonPath;
+    this.modelPath = modelPath;
+    this.extraArgs = extraArgs;
+    this.runtime = runtime;
+    const runtimeDeviceMap = {
+      onnx: "cpu",
+      coreml: "gpu-mps",
+      pytorch: "cpu",
+      openvino: "cpu",
+      tflite: "cpu"
+    };
+    this.device = runtimeDeviceMap[runtime];
+  }
+  runtime;
+  device;
+  process = null;
+  receiveBuffer = Buffer.alloc(0);
+  pendingResolve = null;
+  pendingReject = null;
+  async initialize() {
+    const args = [this.modelPath, ...this.extraArgs];
+    this.process = (0, import_node_child_process.spawn)(this.pythonPath, args, {
+      stdio: ["pipe", "pipe", "pipe"]
+    });
+    if (!this.process.stdout || !this.process.stdin) {
+      throw new Error("PythonInferenceEngine: failed to create process pipes");
+    }
+    this.process.stderr?.on("data", (chunk) => {
+      process.stderr.write(`[python-engine] ${chunk.toString()}`);
+    });
+    this.process.on("error", (err) => {
+      this.pendingReject?.(err);
+      this.pendingReject = null;
+      this.pendingResolve = null;
+    });
+    this.process.on("exit", (code) => {
+      if (code !== 0) {
+        const err = new Error(`PythonInferenceEngine: process exited with code ${code}`);
+        this.pendingReject?.(err);
+        this.pendingReject = null;
+        this.pendingResolve = null;
+      }
+    });
+    this.process.stdout.on("data", (chunk) => {
+      this.receiveBuffer = Buffer.concat([this.receiveBuffer, chunk]);
+      this._tryReceive();
+    });
+    await new Promise((resolve2, reject) => {
+      const timeout = setTimeout(() => resolve2(), 2e3);
+      this.process?.on("error", (err) => {
+        clearTimeout(timeout);
+        reject(err);
+      });
+      this.process?.on("exit", (code) => {
+        clearTimeout(timeout);
+        if (code !== 0) {
+          reject(new Error(`PythonInferenceEngine: process exited early with code ${code}`));
+        }
+      });
+    });
+  }
+  _tryReceive() {
+    if (this.receiveBuffer.length < 4) return;
+    const length = this.receiveBuffer.readUInt32LE(0);
+    if (this.receiveBuffer.length < 4 + length) return;
+    const jsonBytes = this.receiveBuffer.subarray(4, 4 + length);
+    this.receiveBuffer = this.receiveBuffer.subarray(4 + length);
+    const resolve2 = this.pendingResolve;
+    const reject = this.pendingReject;
+    this.pendingResolve = null;
+    this.pendingReject = null;
+    if (!resolve2) return;
+    try {
+      const parsed = JSON.parse(jsonBytes.toString("utf8"));
+      resolve2(parsed);
+    } catch (err) {
+      reject?.(err instanceof Error ? err : new Error(String(err)));
+    }
+  }
+  /** Send JPEG buffer, receive JSON detection results */
+  async runJpeg(jpeg) {
+    if (!this.process?.stdin) {
+      throw new Error("PythonInferenceEngine: process not initialized");
+    }
+    return new Promise((resolve2, reject) => {
+      this.pendingResolve = resolve2;
+      this.pendingReject = reject;
+      const lengthBuf = Buffer.allocUnsafe(4);
+      lengthBuf.writeUInt32LE(jpeg.length, 0);
+      this.process.stdin.write(Buffer.concat([lengthBuf, jpeg]));
+    });
+  }
+  /** IInferenceEngine.run — wraps runJpeg for compatibility */
+  async run(_input, _inputShape) {
+    throw new Error(
+      "PythonInferenceEngine: use runJpeg() directly \u2014 this engine operates on JPEG input"
+    );
+  }
+  /** IInferenceEngine.runMultiOutput — not supported by Python engine (operates on JPEG input) */
+  async runMultiOutput(_input, _inputShape) {
+    throw new Error(
+      "PythonInferenceEngine: runMultiOutput() is not supported \u2014 this engine operates on JPEG input"
+    );
+  }
+  async dispose() {
+    if (this.process) {
+      this.process.stdin?.end();
+      this.process.kill("SIGTERM");
+      this.process = null;
+    }
+  }
+};
+
+// src/shared/engine-resolver.ts
+var fs = __toESM(require("fs"));
+var path2 = __toESM(require("path"));
+var AUTO_BACKEND_PRIORITY = ["coreml", "cuda", "tensorrt", "cpu"];
+var BACKEND_TO_FORMAT = {
+  cpu: "onnx",
+  coreml: "coreml",
+  cuda: "onnx",
+  tensorrt: "onnx"
+};
+var RUNTIME_TO_FORMAT = {
+  onnx: "onnx",
+  coreml: "coreml",
+  openvino: "openvino",
+  tflite: "tflite",
+  pytorch: "pt"
+};
+function modelFilePath(modelsDir, modelEntry, format) {
+  const formatEntry = modelEntry.formats[format];
+  if (!formatEntry) {
+    throw new Error(`Model ${modelEntry.id} has no ${format} format`);
+  }
+  const urlParts = formatEntry.url.split("/");
+  const filename = urlParts[urlParts.length - 1] ?? `${modelEntry.id}.${format}`;
+  return path2.join(modelsDir, filename);
+}
+function modelExists(filePath) {
+  try {
+    return fs.existsSync(filePath);
+  } catch {
+    return false;
+  }
+}
+async function resolveEngine(options) {
+  const { runtime, backend, modelEntry, modelsDir, downloadModel } = options;
+  let selectedFormat;
+  let selectedBackend;
+  if (runtime === "auto") {
+    const available = await probeOnnxBackends();
+    let chosen = null;
+    for (const b of AUTO_BACKEND_PRIORITY) {
+      if (!available.includes(b)) continue;
+      const fmt = BACKEND_TO_FORMAT[b];
+      if (!fmt) continue;
+      if (!modelEntry.formats[fmt]) continue;
+      chosen = { backend: b, format: fmt };
+      break;
+    }
+    if (!chosen) {
+      throw new Error(
+        `resolveEngine: no compatible backend found for model ${modelEntry.id}. Available backends: ${available.join(", ")}`
+      );
+    }
+    selectedFormat = chosen.format;
+    selectedBackend = chosen.backend;
+  } else {
+    const fmt = RUNTIME_TO_FORMAT[runtime];
+    if (!fmt) {
+      throw new Error(`resolveEngine: unsupported runtime "${runtime}"`);
+    }
+    if (!modelEntry.formats[fmt]) {
+      throw new Error(
+        `resolveEngine: model ${modelEntry.id} has no ${fmt} format for runtime ${runtime}`
+      );
+    }
+    selectedFormat = fmt;
+    selectedBackend = runtime === "onnx" ? backend || "cpu" : runtime;
+  }
+  let modelPath = modelFilePath(modelsDir, modelEntry, selectedFormat);
+  if (!modelExists(modelPath)) {
+    if (downloadModel) {
+      const formatEntry = modelEntry.formats[selectedFormat];
+      modelPath = await downloadModel(formatEntry.url, modelsDir);
+    } else {
+      throw new Error(
+        `resolveEngine: model file not found at ${modelPath} and no downloadModel function provided`
+      );
+    }
+  }
+  if (selectedFormat === "onnx" || selectedFormat === "coreml") {
+    const engine = new NodeInferenceEngine(modelPath, selectedBackend);
+    await engine.initialize();
+    return { engine, format: selectedFormat, modelPath };
+  }
+  const fallbackPath = modelFilePath(modelsDir, modelEntry, "onnx");
+  if (modelEntry.formats["onnx"] && modelExists(fallbackPath)) {
+    const engine = new NodeInferenceEngine(fallbackPath, "cpu");
+    await engine.initialize();
+    return { engine, format: "onnx", modelPath: fallbackPath };
+  }
+  throw new Error(
+    `resolveEngine: format ${selectedFormat} is not yet supported by NodeInferenceEngine and no ONNX fallback is available`
+  );
+}
+async function probeOnnxBackends() {
+  const available = ["cpu"];
+  try {
+    const ort = await import("onnxruntime-node");
+    const providers = ort.env?.webgl?.disabled !== void 0 ? ort.InferenceSession?.getAvailableProviders?.() ?? [] : [];
+    for (const p of providers) {
+      const normalized = p.toLowerCase().replace("executionprovider", "");
+      if (normalized === "coreml") available.push("coreml");
+      else if (normalized === "cuda") available.push("cuda");
+      else if (normalized === "tensorrt") available.push("tensorrt");
+    }
+  } catch {
+  }
+  if (process.platform === "darwin" && !available.includes("coreml")) {
+    available.push("coreml");
+  }
+  return [...new Set(available)];
+}
+
+// src/addons/motion-detection/frame-diff.ts
+function detectMotion(current, previous, width, height, threshold, minArea) {
+  const numPixels = width * height;
+  const mask = new Uint8Array(numPixels);
+  for (let i = 0; i < numPixels; i++) {
+    mask[i] = Math.abs((current[i] ?? 0) - (previous[i] ?? 0)) > threshold ? 1 : 0;
+  }
+  const labels = new Int32Array(numPixels).fill(0);
+  const parent = new Int32Array(numPixels + 1).fill(0);
+  let nextLabel = 1;
+  function findRoot(x) {
+    while (parent[x] !== x) {
+      parent[x] = parent[parent[x]];
+      x = parent[x];
+    }
+    return x;
+  }
+  function union(a, b) {
+    const ra = findRoot(a);
+    const rb = findRoot(b);
+    if (ra !== rb) parent[rb] = ra;
+    return ra;
+  }
+  for (let i = 0; i <= numPixels; i++) {
+    parent[i] = i;
+  }
+  for (let y = 0; y < height; y++) {
+    for (let x = 0; x < width; x++) {
+      const idx = y * width + x;
+      if (!mask[idx]) continue;
+      const above = y > 0 ? labels[(y - 1) * width + x] ?? 0 : 0;
+      const left = x > 0 ? labels[y * width + (x - 1)] ?? 0 : 0;
+      if (above === 0 && left === 0) {
+        labels[idx] = nextLabel;
+        parent[nextLabel] = nextLabel;
+        nextLabel++;
+      } else if (above !== 0 && left === 0) {
+        labels[idx] = above;
+      } else if (above === 0 && left !== 0) {
+        labels[idx] = left;
+      } else {
+        labels[idx] = union(above, left);
+      }
+    }
+  }
+  for (let i = 0; i < numPixels; i++) {
+    if (labels[i]) {
+      labels[i] = findRoot(labels[i]);
+    }
+  }
+  const bboxMap = /* @__PURE__ */ new Map();
+  for (let y = 0; y < height; y++) {
+    for (let x = 0; x < width; x++) {
+      const idx = y * width + x;
+      const label = labels[idx];
+      if (!label) continue;
+      const diff = Math.abs((current[idx] ?? 0) - (previous[idx] ?? 0));
+      const existing = bboxMap.get(label);
+      if (existing) {
+        existing.minX = Math.min(existing.minX, x);
+        existing.minY = Math.min(existing.minY, y);
+        existing.maxX = Math.max(existing.maxX, x);
+        existing.maxY = Math.max(existing.maxY, y);
+        existing.count++;
+        existing.intensitySum += diff;
+      } else {
+        bboxMap.set(label, {
+          minX: x,
+          minY: y,
+          maxX: x,
+          maxY: y,
+          count: 1,
+          intensitySum: diff
+        });
+      }
+    }
+  }
+  const regions = [];
+  for (const [, info] of bboxMap) {
+    if (info.count < minArea) continue;
+    regions.push({
+      bbox: {
+        x: info.minX,
+        y: info.minY,
+        w: info.maxX - info.minX + 1,
+        h: info.maxY - info.minY + 1
+      },
+      pixelCount: info.count,
+      intensity: info.intensitySum / info.count
+    });
+  }
+  return regions;
+}
+
+// src/addons/object-detection/index.ts
+var import_types = require("@camstack/types");
+
+// src/shared/postprocess/yolo-seg.ts
+function sigmoid(x) {
+  return 1 / (1 + Math.exp(-x));
+}
+function computeRawMask(coeffs, protos, numMaskCoeffs, maskH, maskW) {
+  const maskSize = maskH * maskW;
+  const rawMask = new Float32Array(maskSize);
+  for (let px = 0; px < maskSize; px++) {
+    let val = 0;
+    for (let k = 0; k < numMaskCoeffs; k++) {
+      val += (coeffs[k] ?? 0) * (protos[k * maskSize + px] ?? 0);
+    }
+    rawMask[px] = sigmoid(val);
+  }
+  return rawMask;
+}
+function cropAndThresholdMask(rawMask, maskH, maskW, bbox, maskThreshold, maskScale) {
+  const cropX1 = Math.max(0, Math.floor(bbox.x * maskScale));
+  const cropY1 = Math.max(0, Math.floor(bbox.y * maskScale));
+  const cropX2 = Math.min(maskW, Math.ceil((bbox.x + bbox.w) * maskScale));
+  const cropY2 = Math.min(maskH, Math.ceil((bbox.y + bbox.h) * maskScale));
+  const cropW = Math.max(1, cropX2 - cropX1);
+  const cropH = Math.max(1, cropY2 - cropY1);
+  const data = new Uint8Array(cropW * cropH);
+  for (let row = 0; row < cropH; row++) {
+    const srcRow = cropY1 + row;
+    for (let col = 0; col < cropW; col++) {
+      const srcCol = cropX1 + col;
+      const srcIdx = srcRow * maskW + srcCol;
+      data[row * cropW + col] = (rawMask[srcIdx] ?? 0) > maskThreshold ? 255 : 0;
+    }
+  }
+  return { data, width: cropW, height: cropH };
+}
+function yoloSegPostprocess(segOutput, options) {
+  const {
+    detectionOutput,
+    protoOutput,
+    numClasses,
+    numBoxes,
+    numMaskCoeffs,
+    maskHeight,
+    maskWidth
+  } = segOutput;
+  const {
+    confidence,
+    iouThreshold,
+    labels,
+    scale,
+    padX,
+    padY,
+    originalWidth,
+    originalHeight,
+    maskThreshold = 0.5
+  } = options;
+  const yoloInputSize = 640;
+  const maskScale = maskHeight / yoloInputSize;
+  const candidates = [];
+  for (let i = 0; i < numBoxes; i++) {
+    const cx = detectionOutput[0 * numBoxes + i] ?? 0;
+    const cy = detectionOutput[1 * numBoxes + i] ?? 0;
+    const w = detectionOutput[2 * numBoxes + i] ?? 0;
+    const h = detectionOutput[3 * numBoxes + i] ?? 0;
+    let bestScore = -Infinity;
+    let bestClass = 0;
+    for (let j = 0; j < numClasses; j++) {
+      const score = detectionOutput[(4 + j) * numBoxes + i] ?? 0;
+      if (score > bestScore) {
+        bestScore = score;
+        bestClass = j;
+      }
+    }
+    if (bestScore < confidence) continue;
+    const bbox = {
+      x: cx - w / 2,
+      y: cy - h / 2,
+      w,
+      h
+    };
+    const coeffs = new Float32Array(numMaskCoeffs);
+    for (let k = 0; k < numMaskCoeffs; k++) {
+      coeffs[k] = detectionOutput[(4 + numClasses + k) * numBoxes + i] ?? 0;
+    }
+    candidates.push({ bbox, score: bestScore, classIdx: bestClass, coeffs });
+  }
+  if (candidates.length === 0) return [];
+  const keptIndices = nms(candidates, iouThreshold);
+  return keptIndices.map((idx) => {
+    const { bbox, score, classIdx, coeffs } = candidates[idx];
+    const label = labels[classIdx] ?? String(classIdx);
+    const x = Math.max(0, Math.min(originalWidth, (bbox.x - padX) / scale));
+    const y = Math.max(0, Math.min(originalHeight, (bbox.y - padY) / scale));
+    const x2 = Math.max(0, Math.min(originalWidth, (bbox.x + bbox.w - padX) / scale));
+    const y2 = Math.max(0, Math.min(originalHeight, (bbox.y + bbox.h - padY) / scale));
+    const finalBbox = { x, y, w: x2 - x, h: y2 - y };
+    const rawMask = computeRawMask(coeffs, protoOutput, numMaskCoeffs, maskHeight, maskWidth);
+    const { data: maskData, width: mW, height: mH } = cropAndThresholdMask(
+      rawMask,
+      maskHeight,
+      maskWidth,
+      bbox,
+      maskThreshold,
+      maskScale
+    );
+    return {
+      class: label,
+      originalClass: label,
+      score,
+      bbox: finalBbox,
+      mask: maskData,
+      maskWidth: mW,
+      maskHeight: mH
+    };
+  });
+}
+
+// src/addons/object-detection/index.ts
+function isSegModel(modelId) {
+  return modelId.includes("-seg");
+}
+var ALL_DETECTION_MODELS = [
+  ...import_types.OBJECT_DETECTION_MODELS,
+  ...import_types.SEGMENTATION_MODELS
+];
+function applyClassMap(detections, classMap) {
+  return detections.filter((d) => classMap.mapping[d.class] !== void 0).map((d) => ({
+    ...d,
+    originalClass: d.class,
+    class: classMap.mapping[d.class]
+  }));
+}
+var ObjectDetectionAddon = class {
+  id = "object-detection";
+  slot = "detector";
+  inputClasses = null;
+  outputClasses = ["person", "vehicle", "animal"];
+  slotPriority = 0;
+  manifest = {
+    id: "object-detection",
+    name: "Object Detection",
+    version: "0.1.0",
+    description: "YOLO-based object detection \u2014 detects persons, vehicles, and animals",
+    packageName: "@camstack/vision",
+    slot: "detector",
+    inputClasses: void 0,
+    outputClasses: ["person", "vehicle", "animal"],
+    supportsCustomModels: true,
+    mayRequirePython: false,
+    defaultConfig: {
+      modelId: "yolov8n",
+      runtime: "auto",
+      backend: "cpu",
+      confidence: 0.5,
+      iouThreshold: 0.45
+    }
+  };
+  engine;
+  modelEntry;
+  confidence = 0.5;
+  iouThreshold = 0.45;
+  async initialize(ctx) {
+    const cfg = ctx.addonConfig;
+    const modelId = cfg["modelId"] ?? "yolov8n";
+    const runtime = cfg["runtime"] ?? "auto";
+    const backend = cfg["backend"] ?? "cpu";
+    this.confidence = cfg["confidence"] ?? 0.5;
+    this.iouThreshold = cfg["iouThreshold"] ?? 0.45;
+    const entry = ALL_DETECTION_MODELS.find((m) => m.id === modelId);
+    if (!entry) {
+      throw new Error(`ObjectDetectionAddon: unknown modelId "${modelId}"`);
+    }
+    this.modelEntry = entry;
+    const resolved = await resolveEngine({
+      runtime,
+      backend,
+      modelEntry: entry,
+      modelsDir: ctx.locationPaths.models
+    });
+    this.engine = resolved.engine;
+  }
+  async detect(frame) {
+    const start = Date.now();
+    const { width: inputW, height: inputH } = this.modelEntry.inputSize;
+    const targetSize = Math.max(inputW, inputH);
+    const lb = await letterbox(frame.data, targetSize);
+    const numClasses = this.modelEntry.labels.length;
+    const labels = this.modelEntry.labels.map((l) => l.id);
+    const postprocessOpts = {
+      confidence: this.confidence,
+      iouThreshold: this.iouThreshold,
+      labels,
+      scale: lb.scale,
+      padX: lb.padX,
+      padY: lb.padY,
+      originalWidth: lb.originalWidth,
+      originalHeight: lb.originalHeight
+    };
+    let rawDetections;
+    if (isSegModel(this.modelEntry.id)) {
+      const outputs = await this.engine.runMultiOutput(lb.data, [1, 3, targetSize, targetSize]);
+      const outputNames = Object.keys(outputs);
+      if (outputNames.length < 2) {
+        throw new Error(
+          `ObjectDetectionAddon: seg model "${this.modelEntry.id}" returned ${outputNames.length} output(s); expected 2`
+        );
+      }
+      const detectionOutput = outputs[outputNames[0]];
+      const protoOutput = outputs[outputNames[1]];
+      const numMaskCoeffs = 32;
+      const numBoxes = detectionOutput.length / (4 + numClasses + numMaskCoeffs);
+      const maskHeight = 160;
+      const maskWidth = 160;
+      rawDetections = yoloSegPostprocess(
+        {
+          detectionOutput,
+          protoOutput,
+          numClasses,
+          numBoxes,
+          numMaskCoeffs,
+          maskHeight,
+          maskWidth
+        },
+        postprocessOpts
+      );
+    } else {
+      const output = await this.engine.run(lb.data, [1, 3, targetSize, targetSize]);
+      const numBoxes = output.length / (4 + numClasses);
+      rawDetections = yoloPostprocess(output, numClasses, numBoxes, postprocessOpts);
+    }
+    const detections = applyClassMap(rawDetections, import_types.COCO_TO_MACRO);
+    return {
+      detections,
+      inferenceMs: Date.now() - start,
+      modelId: this.modelEntry.id
+    };
+  }
+  async shutdown() {
+    await this.engine?.dispose();
+  }
+  getConfigSchema() {
+    return {
+      sections: [
+        {
+          id: "model",
+          title: "Model",
+          columns: 2,
+          fields: [
+            {
+              key: "modelId",
+              label: "Model",
+              type: "model-selector",
+              catalog: [...ALL_DETECTION_MODELS],
+              allowCustom: true,
+              allowConversion: true,
+              acceptFormats: ["onnx", "coreml", "openvino", "tflite"],
+              requiredMetadata: ["inputSize", "labels", "outputFormat"],
+              outputFormatHint: "yolo"
+            }
+          ]
+        },
+        {
+          id: "runtime",
+          title: "Runtime",
+          columns: 2,
+          fields: [
+            {
+              key: "runtime",
+              label: "Runtime",
+              type: "select",
+              options: [
+                { value: "auto", label: "Auto (recommended)" },
+                { value: "onnx", label: "ONNX Runtime" },
+                { value: "coreml", label: "CoreML (Apple)" },
+                { value: "openvino", label: "OpenVINO (Intel)" }
+              ]
+            },
+            {
+              key: "backend",
+              label: "Backend",
+              type: "select",
+              dependsOn: { runtime: "onnx" },
+              options: [
+                { value: "cpu", label: "CPU" },
+                { value: "coreml", label: "CoreML" },
+                { value: "cuda", label: "CUDA (NVIDIA)" },
+                { value: "tensorrt", label: "TensorRT (NVIDIA)" }
+              ]
+            }
+          ]
+        },
+        {
+          id: "thresholds",
+          title: "Detection Thresholds",
+          columns: 2,
+          fields: [
+            {
+              key: "confidence",
+              label: "Confidence Threshold",
+              type: "slider",
+              min: 0.1,
+              max: 1,
+              step: 0.05,
+              default: 0.5
+            },
+            {
+              key: "iouThreshold",
+              label: "IoU Threshold (NMS)",
+              type: "slider",
+              min: 0.1,
+              max: 1,
+              step: 0.05,
+              default: 0.45
+            }
+          ]
+        }
+      ]
+    };
+  }
+  getClassMap() {
+    return import_types.COCO_TO_MACRO;
+  }
+  getModelCatalog() {
+    return [...ALL_DETECTION_MODELS];
+  }
+  getAvailableModels() {
+    return [];
+  }
+  getActiveLabels() {
+    return import_types.MACRO_LABELS;
+  }
+  async probe() {
+    return {
+      available: true,
+      runtime: this.engine?.runtime ?? "onnx",
+      device: this.engine?.device ?? "cpu",
+      capabilities: ["fp32"]
+    };
+  }
+};
+
+// src/addons/motion-detection/index.ts
+var MOTION_LABEL = { id: "motion", name: "Motion" };
+var MOTION_LABELS = [MOTION_LABEL];
+var EMPTY_CLASS_MAP = { mapping: {}, preserveOriginal: true };
+var MotionDetectionAddon = class {
+  id = "motion-detection";
+  slot = "detector";
+  inputClasses = null;
+  outputClasses = ["motion"];
+  slotPriority = 10;
+  // runs first — feeds other detectors
+  manifest = {
+    id: "motion-detection",
+    name: "Motion Detection",
+    version: "0.1.0",
+    description: "Frame-differencing motion detector \u2014 no inference engine required",
+    packageName: "@camstack/vision",
+    slot: "detector",
+    inputClasses: void 0,
+    outputClasses: ["motion"],
+    supportsCustomModels: false,
+    mayRequirePython: false,
+    defaultConfig: {
+      threshold: 25,
+      minArea: 500
+    }
+  };
+  previousGray = null;
+  previousWidth = 0;
+  previousHeight = 0;
+  threshold = 25;
+  minArea = 500;
+  async initialize(ctx) {
+    const cfg = ctx.addonConfig;
+    this.threshold = cfg["threshold"] ?? 25;
+    this.minArea = cfg["minArea"] ?? 500;
+  }
+  async detect(frame) {
+    const start = Date.now();
+    const { data, width, height } = await jpegToRgb(frame.data);
+    const currentGray = rgbToGrayscale(data, width, height);
+    if (!this.previousGray || this.previousWidth !== width || this.previousHeight !== height) {
+      this.previousGray = currentGray;
+      this.previousWidth = width;
+      this.previousHeight = height;
+      return { detections: [], inferenceMs: Date.now() - start, modelId: "frame-diff" };
+    }
+    const regions = detectMotion(
+      currentGray,
+      this.previousGray,
+      width,
+      height,
+      this.threshold,
+      this.minArea
+    );
+    this.previousGray = currentGray;
+    const detections = regions.map((r) => ({
+      class: "motion",
+      originalClass: "motion",
+      score: Math.min(1, r.intensity / 255),
+      bbox: r.bbox
+    }));
+    return {
+      detections,
+      inferenceMs: Date.now() - start,
+      modelId: "frame-diff"
+    };
+  }
+  async shutdown() {
+    this.previousGray = null;
+  }
+  getConfigSchema() {
+    return {
+      sections: [
+        {
+          id: "motion",
+          title: "Motion Detection",
+          columns: 2,
+          fields: [
+            {
+              key: "threshold",
+              label: "Pixel Difference Threshold",
+              description: "Minimum per-pixel intensity change to count as motion (0-255)",
+              type: "slider",
+              min: 5,
+              max: 100,
+              step: 5,
+              default: 25
+            },
+            {
+              key: "minArea",
+              label: "Minimum Region Area (px)",
+              description: "Minimum number of changed pixels to report a motion region",
+              type: "number",
+              min: 50,
+              max: 1e4
+            }
+          ]
+        }
+      ]
+    };
+  }
+  getClassMap() {
+    return EMPTY_CLASS_MAP;
+  }
+  getModelCatalog() {
+    return [];
+  }
+  getAvailableModels() {
+    return [];
+  }
+  getActiveLabels() {
+    return MOTION_LABELS;
+  }
+  async probe() {
+    return {
+      available: true,
+      runtime: "onnx",
+      // no inference; satisfies the type (any runtime works)
+      device: "cpu",
+      capabilities: ["fp32"]
+    };
+  }
+};
+
+// src/addons/face-detection/index.ts
+var import_types2 = require("@camstack/types");
+var FACE_LABEL = { id: "face", name: "Face" };
+var FACE_LABELS = [FACE_LABEL];
+var FACE_CLASS_MAP = { mapping: {}, preserveOriginal: true };
+var FaceDetectionAddon = class {
+  id = "face-detection";
+  slot = "cropper";
+  inputClasses = ["person"];
+  outputClasses = ["face"];
+  slotPriority = 0;
+  manifest = {
+    id: "face-detection",
+    name: "Face Detection",
+    version: "0.1.0",
+    description: "SCRFD-based face detector \u2014 crops face regions from person detections",
+    packageName: "@camstack/vision",
+    slot: "cropper",
+    inputClasses: ["person"],
+    outputClasses: ["face"],
+    supportsCustomModels: false,
+    mayRequirePython: false,
+    defaultConfig: {
+      modelId: "scrfd-500m",
+      runtime: "auto",
+      backend: "cpu",
+      confidence: 0.5
+    }
+  };
+  engine;
+  modelEntry;
+  confidence = 0.5;
+  async initialize(ctx) {
+    const cfg = ctx.addonConfig;
+    const modelId = cfg["modelId"] ?? "scrfd-500m";
+    const runtime = cfg["runtime"] ?? "auto";
+    const backend = cfg["backend"] ?? "cpu";
+    this.confidence = cfg["confidence"] ?? 0.5;
+    const entry = import_types2.FACE_DETECTION_MODELS.find((m) => m.id === modelId);
+    if (!entry) {
+      throw new Error(`FaceDetectionAddon: unknown modelId "${modelId}"`);
+    }
+    this.modelEntry = entry;
+    const resolved = await resolveEngine({
+      runtime,
+      backend,
+      modelEntry: entry,
+      modelsDir: ctx.locationPaths.models
+    });
+    this.engine = resolved.engine;
+  }
+  async crop(input) {
+    const start = Date.now();
+    const { width: inputW, height: inputH } = this.modelEntry.inputSize;
+    const targetSize = Math.max(inputW, inputH);
+    const personCrop = await cropRegion(input.frame.data, input.roi);
+    const lb = await letterbox(personCrop, targetSize);
+    const engineWithMulti = this.engine;
+    let outputs;
+    if (typeof engineWithMulti.runMultiOutput === "function") {
+      outputs = await engineWithMulti.runMultiOutput(lb.data, [1, 3, targetSize, targetSize]);
+    } else {
+      const single = await this.engine.run(lb.data, [1, 3, targetSize, targetSize]);
+      outputs = { output0: single };
+    }
+    const crops = scrfdPostprocess(
+      outputs,
+      this.confidence,
+      targetSize,
+      lb.originalWidth,
+      lb.originalHeight
+    );
+    return {
+      crops,
+      inferenceMs: Date.now() - start,
+      modelId: this.modelEntry.id
+    };
+  }
+  async shutdown() {
+    await this.engine?.dispose();
+  }
+  getConfigSchema() {
+    return {
+      sections: [
+        {
+          id: "model",
+          title: "Model",
+          columns: 1,
+          fields: [
+            {
+              key: "modelId",
+              label: "Model",
+              type: "model-selector",
+              catalog: [...import_types2.FACE_DETECTION_MODELS],
+              allowCustom: false,
+              allowConversion: false,
+              acceptFormats: ["onnx", "coreml", "openvino"],
+              requiredMetadata: ["inputSize", "labels", "outputFormat"],
+              outputFormatHint: "ssd"
+            }
+          ]
+        },
+        {
+          id: "thresholds",
+          title: "Detection Thresholds",
+          columns: 1,
+          fields: [
+            {
+              key: "confidence",
+              label: "Confidence Threshold",
+              type: "slider",
+              min: 0.1,
+              max: 1,
+              step: 0.05,
+              default: 0.5
+            }
+          ]
+        }
+      ]
+    };
+  }
+  getClassMap() {
+    return FACE_CLASS_MAP;
+  }
+  getModelCatalog() {
+    return [...import_types2.FACE_DETECTION_MODELS];
+  }
+  getAvailableModels() {
+    return [];
+  }
+  getActiveLabels() {
+    return FACE_LABELS;
+  }
+  async probe() {
+    return {
+      available: true,
+      runtime: this.engine?.runtime ?? "onnx",
+      device: this.engine?.device ?? "cpu",
+      capabilities: ["fp32"]
+    };
+  }
+};
+
+// src/addons/face-recognition/index.ts
+var import_types3 = require("@camstack/types");
+var IDENTITY_LABEL = { id: "identity", name: "Identity" };
+var IDENTITY_LABELS = [IDENTITY_LABEL];
+var FACE_REC_CLASS_MAP = { mapping: {}, preserveOriginal: true };
+var REQUIRED_STEPS = [
+  { slot: "cropper", outputClasses: ["face"], description: "Requires a face detector" }
+];
+var FaceRecognitionAddon = class {
+  id = "face-recognition";
+  slot = "classifier";
+  inputClasses = ["face"];
+  outputClasses = ["identity:*"];
+  slotPriority = 0;
+  requiredSteps = REQUIRED_STEPS;
+  manifest = {
+    id: "face-recognition",
+    name: "Face Recognition",
+    version: "0.1.0",
+    description: "ArcFace-based face recognition \u2014 produces 512-d identity embeddings",
+    packageName: "@camstack/vision",
+    slot: "classifier",
+    inputClasses: ["face"],
+    outputClasses: ["identity:*"],
+    requiredSteps: REQUIRED_STEPS,
+    supportsCustomModels: false,
+    mayRequirePython: false,
+    defaultConfig: {
+      modelId: "arcface-r100",
+      runtime: "auto",
+      backend: "cpu"
+    }
+  };
+  engine;
+  modelEntry;
+  async initialize(ctx) {
+    const cfg = ctx.addonConfig;
+    const modelId = cfg["modelId"] ?? "arcface-r100";
+    const runtime = cfg["runtime"] ?? "auto";
+    const backend = cfg["backend"] ?? "cpu";
+    const entry = import_types3.FACE_RECOGNITION_MODELS.find((m) => m.id === modelId);
+    if (!entry) {
+      throw new Error(`FaceRecognitionAddon: unknown modelId "${modelId}"`);
+    }
+    this.modelEntry = entry;
+    const resolved = await resolveEngine({
+      runtime,
+      backend,
+      modelEntry: entry,
+      modelsDir: ctx.locationPaths.models
+    });
+    this.engine = resolved.engine;
+  }
+  async classify(input) {
+    const start = Date.now();
+    const { width: inputW, height: inputH } = this.modelEntry.inputSize;
+    const faceCrop = await cropRegion(input.frame.data, input.roi);
+    const layout = this.modelEntry.inputLayout ?? "nhwc";
+    const normalization = this.modelEntry.inputNormalization ?? "zero-one";
+    const normalized = await resizeAndNormalize(faceCrop, inputW, inputH, normalization, layout);
+    const rawEmbedding = await this.engine.run(normalized, [1, inputH, inputW, 3]);
+    const embedding = l2Normalize(rawEmbedding);
+    return {
+      classifications: [
+        {
+          class: "identity",
+          score: 1,
+          embedding
+        }
+      ],
+      inferenceMs: Date.now() - start,
+      modelId: this.modelEntry.id
+    };
+  }
+  async shutdown() {
+    await this.engine?.dispose();
+  }
+  getConfigSchema() {
+    return {
+      sections: [
+        {
+          id: "model",
+          title: "Model",
+          columns: 1,
+          fields: [
+            {
+              key: "modelId",
+              label: "Model",
+              type: "model-selector",
+              catalog: [...import_types3.FACE_RECOGNITION_MODELS],
+              allowCustom: false,
+              allowConversion: false,
+              acceptFormats: ["onnx", "coreml", "openvino"],
+              requiredMetadata: ["inputSize", "labels", "outputFormat"],
+              outputFormatHint: "embedding"
+            }
+          ]
+        },
+        {
+          id: "runtime",
+          title: "Runtime",
+          columns: 2,
+          fields: [
+            {
+              key: "runtime",
+              label: "Runtime",
+              type: "select",
+              options: [
+                { value: "auto", label: "Auto (recommended)" },
+                { value: "onnx", label: "ONNX Runtime" },
+                { value: "coreml", label: "CoreML (Apple)" }
+              ]
+            },
+            {
+              key: "backend",
+              label: "Backend",
+              type: "select",
+              dependsOn: { runtime: "onnx" },
+              options: [
+                { value: "cpu", label: "CPU" },
+                { value: "coreml", label: "CoreML" },
+                { value: "cuda", label: "CUDA (NVIDIA)" }
+              ]
+            }
+          ]
+        }
+      ]
+    };
+  }
+  getClassMap() {
+    return FACE_REC_CLASS_MAP;
+  }
+  getModelCatalog() {
+    return [...import_types3.FACE_RECOGNITION_MODELS];
+  }
+  getAvailableModels() {
+    return [];
+  }
+  getActiveLabels() {
+    return IDENTITY_LABELS;
+  }
+  async probe() {
+    return {
+      available: true,
+      runtime: this.engine?.runtime ?? "onnx",
+      device: this.engine?.device ?? "cpu",
+      capabilities: ["fp32"]
+    };
+  }
+};
+
+// src/addons/plate-detection/index.ts
+var import_types4 = require("@camstack/types");
+var PLATE_LABEL = { id: "plate", name: "License Plate" };
+var PLATE_LABELS = [PLATE_LABEL];
+var PLATE_CLASS_MAP = { mapping: {}, preserveOriginal: true };
+var PlateDetectionAddon = class {
+  id = "plate-detection";
+  slot = "cropper";
+  inputClasses = ["vehicle"];
+  outputClasses = ["plate"];
+  slotPriority = 0;
+  manifest = {
+    id: "plate-detection",
+    name: "License Plate Detection",
+    version: "0.1.0",
+    description: "YOLO-based license plate detector \u2014 crops plate regions from vehicle detections",
+    packageName: "@camstack/vision",
+    slot: "cropper",
+    inputClasses: ["vehicle"],
+    outputClasses: ["plate"],
+    supportsCustomModels: false,
+    mayRequirePython: false,
+    defaultConfig: {
+      modelId: "yolov8n-plate",
+      runtime: "auto",
+      backend: "cpu",
+      confidence: 0.5,
+      iouThreshold: 0.45
+    }
+  };
+  engine;
+  modelEntry;
+  confidence = 0.5;
+  iouThreshold = 0.45;
+  async initialize(ctx) {
+    const cfg = ctx.addonConfig;
+    const modelId = cfg["modelId"] ?? "yolov8n-plate";
+    const runtime = cfg["runtime"] ?? "auto";
+    const backend = cfg["backend"] ?? "cpu";
+    this.confidence = cfg["confidence"] ?? 0.5;
+    this.iouThreshold = cfg["iouThreshold"] ?? 0.45;
+    const entry = import_types4.PLATE_DETECTION_MODELS.find((m) => m.id === modelId);
+    if (!entry) {
+      throw new Error(`PlateDetectionAddon: unknown modelId "${modelId}"`);
+    }
+    this.modelEntry = entry;
+    const resolved = await resolveEngine({
+      runtime,
+      backend,
+      modelEntry: entry,
+      modelsDir: ctx.locationPaths.models
+    });
+    this.engine = resolved.engine;
+  }
+  async crop(input) {
+    const start = Date.now();
+    const { width: inputW, height: inputH } = this.modelEntry.inputSize;
+    const targetSize = Math.max(inputW, inputH);
+    const vehicleCrop = await cropRegion(input.frame.data, input.roi);
+    const lb = await letterbox(vehicleCrop, targetSize);
+    const output = await this.engine.run(lb.data, [1, 3, targetSize, targetSize]);
+    const numClasses = this.modelEntry.labels.length;
+    const numBoxes = output.length / (4 + numClasses);
+    const labels = this.modelEntry.labels.map((l) => l.id);
+    const plates = yoloPostprocess(output, numClasses, numBoxes, {
+      confidence: this.confidence,
+      iouThreshold: this.iouThreshold,
+      labels,
+      scale: lb.scale,
+      padX: lb.padX,
+      padY: lb.padY,
+      originalWidth: lb.originalWidth,
+      originalHeight: lb.originalHeight
+    });
+    const crops = plates.map((p) => ({ ...p, class: "plate", originalClass: p.originalClass }));
+    return {
+      crops,
+      inferenceMs: Date.now() - start,
+      modelId: this.modelEntry.id
+    };
+  }
+  async shutdown() {
+    await this.engine?.dispose();
+  }
+  getConfigSchema() {
+    return {
+      sections: [
+        {
+          id: "thresholds",
+          title: "Detection Thresholds",
+          columns: 2,
+          fields: [
+            {
+              key: "confidence",
+              label: "Confidence Threshold",
+              type: "slider",
+              min: 0.1,
+              max: 1,
+              step: 0.05,
+              default: 0.5
+            },
+            {
+              key: "iouThreshold",
+              label: "IoU Threshold (NMS)",
+              type: "slider",
+              min: 0.1,
+              max: 1,
+              step: 0.05,
+              default: 0.45
+            }
+          ]
+        }
+      ]
+    };
+  }
+  getClassMap() {
+    return PLATE_CLASS_MAP;
+  }
+  getModelCatalog() {
+    return [...import_types4.PLATE_DETECTION_MODELS];
+  }
+  getAvailableModels() {
+    return [];
+  }
+  getActiveLabels() {
+    return PLATE_LABELS;
+  }
+  async probe() {
+    return {
+      available: true,
+      runtime: this.engine?.runtime ?? "onnx",
+      device: this.engine?.device ?? "cpu",
+      capabilities: ["fp32"]
+    };
+  }
+};
+
+// src/addons/plate-recognition/index.ts
+var import_types5 = require("@camstack/types");
+var fs2 = __toESM(require("fs"));
+var path3 = __toESM(require("path"));
+var PLATE_TEXT_LABEL = { id: "plate-text", name: "Plate Text" };
+var PLATE_TEXT_LABELS = [PLATE_TEXT_LABEL];
+var PLATE_REC_CLASS_MAP = { mapping: {}, preserveOriginal: true };
+function loadCharset(modelsDir, modelId) {
+  const dictNames = [
+    `camstack-${modelId}-dict.txt`,
+    `camstack-paddleocr-latin-dict.txt`,
+    `camstack-paddleocr-en-dict.txt`
+  ];
+  for (const name of dictNames) {
+    const dictPath = path3.join(modelsDir, name);
+    if (fs2.existsSync(dictPath)) {
+      const lines = fs2.readFileSync(dictPath, "utf-8").split("\n").filter((l) => l.length > 0);
+      return ["", ...lines, " "];
+    }
+  }
+  throw new Error(`PlateRecognitionAddon: dict.txt not found in ${modelsDir}`);
+}
+var CHARSET = [];
+var REQUIRED_STEPS2 = [
+  { slot: "cropper", outputClasses: ["plate"], description: "Requires a plate detector" }
+];
+var PlateRecognitionAddon = class {
+  id = "plate-recognition";
+  slot = "classifier";
+  inputClasses = ["plate"];
+  outputClasses = ["plate-text:*"];
+  slotPriority = 0;
+  requiredSteps = REQUIRED_STEPS2;
+  manifest = {
+    id: "plate-recognition",
+    name: "License Plate Recognition (OCR)",
+    version: "0.1.0",
+    description: "PaddleOCR-based license plate text recognition",
+    packageName: "@camstack/vision",
+    slot: "classifier",
+    inputClasses: ["plate"],
+    outputClasses: ["plate-text:*"],
+    requiredSteps: REQUIRED_STEPS2,
+    supportsCustomModels: false,
+    mayRequirePython: false,
+    defaultConfig: {
+      modelId: "paddleocr-latin",
+      runtime: "auto",
+      backend: "cpu",
+      minConfidence: 0.5
+    }
+  };
+  engine;
+  modelEntry;
+  minConfidence = 0.5;
+  async initialize(ctx) {
+    const cfg = ctx.addonConfig;
+    const modelId = cfg["modelId"] ?? "paddleocr-latin";
+    const runtime = cfg["runtime"] ?? "auto";
+    const backend = cfg["backend"] ?? "cpu";
+    this.minConfidence = cfg["minConfidence"] ?? 0.5;
+    const entry = import_types5.PLATE_RECOGNITION_MODELS.find((m) => m.id === modelId);
+    if (!entry) {
+      throw new Error(`PlateRecognitionAddon: unknown modelId "${modelId}"`);
+    }
+    this.modelEntry = entry;
+    CHARSET = loadCharset(ctx.locationPaths.models, modelId);
+    const resolved = await resolveEngine({
+      runtime,
+      backend,
+      modelEntry: entry,
+      modelsDir: ctx.locationPaths.models
+    });
+    this.engine = resolved.engine;
+  }
+  async classify(input) {
+    const start = Date.now();
+    const { width: inputW, height: inputH } = this.modelEntry.inputSize;
+    const plateCrop = await cropRegion(input.frame.data, input.roi);
+    const normalized = await resizeAndNormalize(plateCrop, inputW, inputH, "zero-one", "nchw");
+    const output = await this.engine.run(normalized, [1, 3, inputH, inputW]);
+    const numChars = CHARSET.length;
+    const seqLen = output.length / numChars;
+    const { text, confidence } = ctcDecode(output, seqLen, numChars, CHARSET);
+    if (confidence < this.minConfidence || text.trim().length === 0) {
+      return {
+        classifications: [],
+        inferenceMs: Date.now() - start,
+        modelId: this.modelEntry.id
+      };
+    }
+    return {
+      classifications: [
+        {
+          class: "plate-text",
+          score: confidence,
+          text
+        }
+      ],
+      inferenceMs: Date.now() - start,
+      modelId: this.modelEntry.id
+    };
+  }
+  async shutdown() {
+    await this.engine?.dispose();
+  }
+  getConfigSchema() {
+    return {
+      sections: [
+        {
+          id: "model",
+          title: "Model",
+          columns: 1,
+          fields: [
+            {
+              key: "modelId",
+              label: "Model",
+              type: "model-selector",
+              catalog: [...import_types5.PLATE_RECOGNITION_MODELS],
+              allowCustom: false,
+              allowConversion: false,
+              acceptFormats: ["onnx", "openvino"],
+              requiredMetadata: ["inputSize", "labels", "outputFormat"],
+              outputFormatHint: "ocr"
+            }
+          ]
+        },
+        {
+          id: "thresholds",
+          title: "Recognition Settings",
+          columns: 1,
+          fields: [
+            {
+              key: "minConfidence",
+              label: "Minimum Confidence",
+              type: "slider",
+              min: 0.1,
+              max: 1,
+              step: 0.05,
+              default: 0.5
+            }
+          ]
+        }
+      ]
+    };
+  }
+  getClassMap() {
+    return PLATE_REC_CLASS_MAP;
+  }
+  getModelCatalog() {
+    return [...import_types5.PLATE_RECOGNITION_MODELS];
+  }
+  getAvailableModels() {
+    return [];
+  }
+  getActiveLabels() {
+    return PLATE_TEXT_LABELS;
+  }
+  async probe() {
+    return {
+      available: true,
+      runtime: this.engine?.runtime ?? "onnx",
+      device: this.engine?.device ?? "cpu",
+      capabilities: ["fp32"]
+    };
+  }
+};
+
+// src/addons/audio-classification/index.ts
+var import_types6 = require("@camstack/types");
+var YAMNET_NUM_CLASSES = 521;
+var AUDIO_EVENT_LABEL = { id: "audio-event", name: "Audio Event" };
+var AUDIO_LABELS = [AUDIO_EVENT_LABEL];
+var AUDIO_CLASS_MAP = { mapping: {}, preserveOriginal: true };
+var AudioClassificationAddon = class {
+  id = "audio-classification";
+  slot = "classifier";
+  inputClasses = null;
+  outputClasses = ["audio-event:*"];
+  slotPriority = 0;
+  manifest = {
+    id: "audio-classification",
+    name: "Audio Classification",
+    version: "0.1.0",
+    description: "YAMNet-based audio event classification from audio waveform",
+    packageName: "@camstack/vision",
+    slot: "classifier",
+    inputClasses: void 0,
+    outputClasses: ["audio-event:*"],
+    supportsCustomModels: false,
+    mayRequirePython: false,
+    defaultConfig: {
+      modelId: "yamnet",
+      runtime: "auto",
+      backend: "cpu",
+      minScore: 0.3
+    }
+  };
+  engine;
+  modelEntry;
+  minScore = 0.3;
+  async initialize(ctx) {
+    const cfg = ctx.addonConfig;
+    const modelId = cfg["modelId"] ?? "yamnet";
+    const runtime = cfg["runtime"] ?? "auto";
+    const backend = cfg["backend"] ?? "cpu";
+    this.minScore = cfg["minScore"] ?? 0.3;
+    const entry = import_types6.AUDIO_CLASSIFICATION_MODELS.find((m) => m.id === modelId);
+    if (!entry) {
+      throw new Error(`AudioClassificationAddon: unknown modelId "${modelId}"`);
+    }
+    this.modelEntry = entry;
+    const resolved = await resolveEngine({
+      runtime,
+      backend,
+      modelEntry: entry,
+      modelsDir: ctx.locationPaths.models
+    });
+    this.engine = resolved.engine;
+  }
+  /**
+   * classify() receives a CropInput but internally treats input.frame.data as raw audio context.
+   * For audio, the actual audio chunk data should be stored in frame.data as a Float32Array
+   * serialized into a Buffer (little-endian float32 samples at 16 kHz).
+   *
+   * The CropInput.roi is not used for audio — it is ignored.
+   */
+  async classify(input) {
+    const start = Date.now();
+    const buf = input.frame.data;
+    const numSamples = Math.floor(buf.length / 4);
+    const audioData = new Float32Array(numSamples);
+    for (let i = 0; i < numSamples; i++) {
+      audioData[i] = buf.readFloatLE(i * 4);
+    }
+    const output = await this.engine.run(audioData, [numSamples]);
+    const numFrames = output.length / YAMNET_NUM_CLASSES;
+    const classNames = this.modelEntry.labels.map((l) => l.id);
+    while (classNames.length < YAMNET_NUM_CLASSES) {
+      classNames.push(`class_${classNames.length}`);
+    }
+    const results = yamnetPostprocess(
+      output,
+      Math.round(numFrames),
+      YAMNET_NUM_CLASSES,
+      classNames,
+      this.minScore
+    );
+    const classifications = results.map((r) => ({
+      class: `audio-event:${r.className}`,
+      score: r.score
+    }));
+    return {
+      classifications,
+      inferenceMs: Date.now() - start,
+      modelId: this.modelEntry.id
+    };
+  }
+  async shutdown() {
+    await this.engine?.dispose();
+  }
+  getConfigSchema() {
+    return {
+      sections: [
+        {
+          id: "runtime",
+          title: "Runtime",
+          columns: 2,
+          fields: [
+            {
+              key: "runtime",
+              label: "Runtime",
+              type: "select",
+              options: [
+                { value: "auto", label: "Auto (recommended)" },
+                { value: "onnx", label: "ONNX Runtime" },
+                { value: "openvino", label: "OpenVINO (Intel)" }
+              ]
+            },
+            {
+              key: "backend",
+              label: "Backend",
+              type: "select",
+              dependsOn: { runtime: "onnx" },
+              options: [
+                { value: "cpu", label: "CPU" },
+                { value: "cuda", label: "CUDA (NVIDIA)" }
+              ]
+            }
+          ]
+        },
+        {
+          id: "thresholds",
+          title: "Classification Settings",
+          columns: 1,
+          fields: [
+            {
+              key: "minScore",
+              label: "Minimum Score",
+              type: "slider",
+              min: 0.05,
+              max: 1,
+              step: 0.05,
+              default: 0.3
+            }
+          ]
+        }
+      ]
+    };
+  }
+  getClassMap() {
+    return AUDIO_CLASS_MAP;
+  }
+  getModelCatalog() {
+    return [...import_types6.AUDIO_CLASSIFICATION_MODELS];
+  }
+  getAvailableModels() {
+    return [];
+  }
+  getActiveLabels() {
+    return AUDIO_LABELS;
+  }
+  async probe() {
+    return {
+      available: true,
+      runtime: this.engine?.runtime ?? "onnx",
+      device: this.engine?.device ?? "cpu",
+      capabilities: ["fp32"]
+    };
+  }
+};
+
+// src/addons/camera-native-detection/index.ts
+var NATIVE_LABELS = [
+  { id: "person", name: "Person" },
+  { id: "vehicle", name: "Vehicle" },
+  { id: "motion", name: "Motion" },
+  { id: "face", name: "Face" }
+];
+var NATIVE_CLASS_MAP = { mapping: {}, preserveOriginal: true };
+var CameraNativeDetectionAddon = class {
+  id = "camera-native-detection";
+  slot = "detector";
+  inputClasses = null;
+  outputClasses = ["person", "vehicle", "motion", "face"];
+  slotPriority = 5;
+  manifest = {
+    id: "camera-native-detection",
+    name: "Camera Native Detection",
+    version: "0.1.0",
+    description: "Passthrough adapter for camera-native events (Frigate, Scrypted, ONVIF) \u2014 no inference engine",
+    packageName: "@camstack/vision",
+    slot: "detector",
+    inputClasses: void 0,
+    outputClasses: ["person", "vehicle", "motion", "face"],
+    supportsCustomModels: false,
+    mayRequirePython: false,
+    defaultConfig: {}
+  };
+  // eslint-disable-next-line @typescript-eslint/no-unused-vars
+  async initialize(_ctx) {
+  }
+  // eslint-disable-next-line @typescript-eslint/no-unused-vars
+  async detect(_frame) {
+    return {
+      detections: [],
+      inferenceMs: 0,
+      modelId: "camera-native"
+    };
+  }
+  async shutdown() {
+  }
+  getConfigSchema() {
+    return {
+      sections: [
+        {
+          id: "info",
+          title: "Camera Native Detection",
+          description: "This addon forwards detections from native camera events (Frigate webhooks, Scrypted push notifications, ONVIF events). No configuration required.",
+          fields: []
+        }
+      ]
+    };
+  }
+  getClassMap() {
+    return NATIVE_CLASS_MAP;
+  }
+  getModelCatalog() {
+    return [];
+  }
+  getAvailableModels() {
+    return [];
+  }
+  getActiveLabels() {
+    return NATIVE_LABELS;
+  }
+  async probe() {
+    return {
+      available: true,
+      runtime: "onnx",
+      // no runtime used; satisfies the type
+      device: "cpu",
+      capabilities: ["fp32"]
+    };
+  }
+};
+
+// src/addons/bird-global-classifier/index.ts
+var import_types7 = require("@camstack/types");
+var fs3 = __toESM(require("fs"));
+var path4 = __toESM(require("path"));
+var SPECIES_LABEL = { id: "species", name: "Bird Species" };
+var SPECIES_LABELS = [SPECIES_LABEL];
+var BIRD_CLASS_MAP = { mapping: {}, preserveOriginal: true };
+function loadLabels(modelsDir, modelId) {
+  const labelNames = [
+    `camstack-${modelId}-labels.json`,
+    `camstack-bird-species-525-labels.json`
+  ];
+  for (const name of labelNames) {
+    const labelPath = path4.join(modelsDir, name);
+    if (fs3.existsSync(labelPath)) {
+      const raw = fs3.readFileSync(labelPath, "utf-8");
+      return JSON.parse(raw);
+    }
+  }
+  throw new Error(`BirdGlobalClassifierAddon: labels JSON not found in ${modelsDir}`);
+}
+function softmax(logits) {
+  const max = logits.reduce((a, b) => Math.max(a, b), -Infinity);
+  const exps = logits.map((v) => Math.exp(v - max));
+  const sum = exps.reduce((a, b) => a + b, 0);
+  return exps.map((v) => v / sum);
+}
+var BirdGlobalClassifierAddon = class {
+  id = "bird-global-classifier";
+  slot = "classifier";
+  inputClasses = ["animal"];
+  outputClasses = ["species:*"];
+  slotPriority = 0;
+  requiredSteps = [];
+  manifest = {
+    id: "bird-global-classifier",
+    name: "Bird Classifier (Global, 525 species)",
+    version: "0.1.0",
+    description: "EfficientNet \u2014 525 worldwide bird species (MIT license, ONNX only)",
+    packageName: "@camstack/vision",
+    slot: "classifier",
+    inputClasses: ["animal"],
+    outputClasses: ["species:*"],
+    supportsCustomModels: false,
+    mayRequirePython: false,
+    defaultConfig: {
+      modelId: "bird-species-525",
+      runtime: "auto",
+      backend: "cpu",
+      minConfidence: 0.3
+    }
+  };
+  engine;
+  modelEntry;
+  labels = [];
+  minConfidence = 0.3;
+  async initialize(ctx) {
+    const cfg = ctx.addonConfig;
+    const modelId = cfg["modelId"] ?? "bird-species-525";
+    const runtime = cfg["runtime"] ?? "auto";
+    const backend = cfg["backend"] ?? "cpu";
+    this.minConfidence = cfg["minConfidence"] ?? 0.3;
+    const entry = import_types7.BIRD_SPECIES_MODELS.find((m) => m.id === modelId);
+    if (!entry) {
+      throw new Error(`BirdGlobalClassifierAddon: unknown modelId "${modelId}"`);
+    }
+    this.modelEntry = entry;
+    this.labels = loadLabels(ctx.locationPaths.models, modelId);
+    const resolved = await resolveEngine({
+      runtime,
+      backend,
+      modelEntry: entry,
+      modelsDir: ctx.locationPaths.models
+    });
+    this.engine = resolved.engine;
+  }
+  async classify(input) {
+    const start = Date.now();
+    const { width: inputW, height: inputH } = this.modelEntry.inputSize;
+    const animalCrop = await cropRegion(input.frame.data, input.roi);
+    const normalized = await resizeAndNormalize(animalCrop, inputW, inputH, "imagenet", "nchw");
+    const rawOutput = await this.engine.run(normalized, [1, 3, inputH, inputW]);
+    const probs = softmax(rawOutput);
+    let maxIdx = 0;
+    let maxScore = probs[0] ?? 0;
+    for (let i = 1; i < probs.length; i++) {
+      const score = probs[i] ?? 0;
+      if (score > maxScore) {
+        maxScore = score;
+        maxIdx = i;
+      }
+    }
+    if (maxScore < this.minConfidence) {
+      return {
+        classifications: [],
+        inferenceMs: Date.now() - start,
+        modelId: this.modelEntry.id
+      };
+    }
+    const label = this.labels[maxIdx] ?? `species_${maxIdx}`;
+    return {
+      classifications: [
+        {
+          class: label,
+          score: maxScore
+        }
+      ],
+      inferenceMs: Date.now() - start,
+      modelId: this.modelEntry.id
+    };
+  }
+  async shutdown() {
+    await this.engine?.dispose();
+  }
+  getConfigSchema() {
+    return {
+      sections: [
+        {
+          id: "model",
+          title: "Model",
+          columns: 1,
+          fields: [
+            {
+              key: "modelId",
+              label: "Model",
+              type: "model-selector",
+              catalog: [...import_types7.BIRD_SPECIES_MODELS],
+              allowCustom: false,
+              allowConversion: false,
+              acceptFormats: ["onnx", "coreml", "openvino"],
+              requiredMetadata: ["inputSize", "labels"],
+              outputFormatHint: "classification"
+            }
+          ]
+        },
+        {
+          id: "thresholds",
+          title: "Classification Settings",
+          columns: 1,
+          fields: [
+            {
+              key: "minConfidence",
+              label: "Minimum Confidence",
+              type: "slider",
+              min: 0.05,
+              max: 1,
+              step: 0.05,
+              default: 0.3
+            }
+          ]
+        },
+        {
+          id: "runtime",
+          title: "Runtime",
+          columns: 2,
+          fields: [
+            {
+              key: "runtime",
+              label: "Runtime",
+              type: "select",
+              options: [
+                { value: "auto", label: "Auto (recommended)" },
+                { value: "onnx", label: "ONNX Runtime" },
+                { value: "coreml", label: "CoreML (Apple)" }
+              ]
+            },
+            {
+              key: "backend",
+              label: "Backend",
+              type: "select",
+              dependsOn: { runtime: "onnx" },
+              options: [
+                { value: "cpu", label: "CPU" },
+                { value: "coreml", label: "CoreML" },
+                { value: "cuda", label: "CUDA (NVIDIA)" }
+              ]
+            }
+          ]
+        }
+      ]
+    };
+  }
+  getClassMap() {
+    return BIRD_CLASS_MAP;
+  }
+  getModelCatalog() {
+    return [...import_types7.BIRD_SPECIES_MODELS];
+  }
+  getAvailableModels() {
+    return [];
+  }
+  getActiveLabels() {
+    return SPECIES_LABELS;
+  }
+  async probe() {
+    return {
+      available: true,
+      runtime: this.engine?.runtime ?? "onnx",
+      device: this.engine?.device ?? "cpu",
+      capabilities: ["fp32"]
+    };
+  }
+};
+
+// src/addons/bird-nabirds-classifier/index.ts
+var import_types8 = require("@camstack/types");
+var fs4 = __toESM(require("fs"));
+var path5 = __toESM(require("path"));
+var SPECIES_LABEL2 = { id: "species", name: "Bird Species" };
+var SPECIES_LABELS2 = [SPECIES_LABEL2];
+var BIRD_CLASS_MAP2 = { mapping: {}, preserveOriginal: true };
+function loadLabels2(modelsDir, modelId) {
+  const labelNames = [
+    `camstack-${modelId}-labels.json`,
+    `camstack-bird-nabirds-404-labels.json`
+  ];
+  for (const name of labelNames) {
+    const labelPath = path5.join(modelsDir, name);
+    if (fs4.existsSync(labelPath)) {
+      const raw = fs4.readFileSync(labelPath, "utf-8");
+      return JSON.parse(raw);
+    }
+  }
+  throw new Error(`BirdNABirdsClassifierAddon: labels JSON not found in ${modelsDir}`);
+}
+function softmax2(logits) {
+  const max = logits.reduce((a, b) => Math.max(a, b), -Infinity);
+  const exps = logits.map((v) => Math.exp(v - max));
+  const sum = exps.reduce((a, b) => a + b, 0);
+  return exps.map((v) => v / sum);
+}
+var BirdNABirdsClassifierAddon = class {
+  id = "bird-nabirds-classifier";
+  slot = "classifier";
+  inputClasses = ["animal"];
+  outputClasses = ["species:*"];
+  slotPriority = 0;
+  requiredSteps = [];
+  manifest = {
+    id: "bird-nabirds-classifier",
+    name: "Bird Classifier (NABirds, 404 species)",
+    version: "0.1.0",
+    description: "ResNet50 \u2014 404 North American bird species (NABirds dataset, ONNX + CoreML + OpenVINO)",
+    packageName: "@camstack/vision",
+    slot: "classifier",
+    inputClasses: ["animal"],
+    outputClasses: ["species:*"],
+    supportsCustomModels: false,
+    mayRequirePython: false,
+    defaultConfig: {
+      modelId: "bird-nabirds-404",
+      runtime: "auto",
+      backend: "cpu",
+      minConfidence: 0.3
+    }
+  };
+  engine;
+  modelEntry;
+  labels = [];
+  minConfidence = 0.3;
+  allowedSpecies;
+  async initialize(ctx) {
+    const cfg = ctx.addonConfig;
+    const modelId = cfg["modelId"] ?? "bird-nabirds-404";
+    const runtime = cfg["runtime"] ?? "auto";
+    const backend = cfg["backend"] ?? "cpu";
+    this.minConfidence = cfg["minConfidence"] ?? 0.3;
+    this.allowedSpecies = cfg["allowedSpecies"];
+    const entry = import_types8.BIRD_NABIRDS_MODELS.find((m) => m.id === modelId);
+    if (!entry) {
+      throw new Error(`BirdNABirdsClassifierAddon: unknown modelId "${modelId}"`);
+    }
+    this.modelEntry = entry;
+    this.labels = loadLabels2(ctx.locationPaths.models, modelId);
+    const resolved = await resolveEngine({
+      runtime,
+      backend,
+      modelEntry: entry,
+      modelsDir: ctx.locationPaths.models
+    });
+    this.engine = resolved.engine;
+  }
+  applyRegionFilter(scores, labels) {
+    if (!this.allowedSpecies || this.allowedSpecies.length === 0) return;
+    const allowedSet = new Set(this.allowedSpecies.map((s) => s.toLowerCase()));
+    for (let i = 0; i < scores.length; i++) {
+      if (!allowedSet.has(labels[i].toLowerCase())) {
+        scores[i] = 0;
+      }
+    }
+  }
+  async classify(input) {
+    const start = Date.now();
+    const { width: inputW, height: inputH } = this.modelEntry.inputSize;
+    const animalCrop = await cropRegion(input.frame.data, input.roi);
+    const normalized = await resizeAndNormalize(animalCrop, inputW, inputH, "imagenet", "nchw");
+    const rawOutput = await this.engine.run(normalized, [1, 3, inputH, inputW]);
+    const probs = softmax2(rawOutput);
+    this.applyRegionFilter(probs, this.labels);
+    const filteredSum = probs.reduce((a, b) => a + b, 0);
+    if (filteredSum > 0) {
+      for (let i = 0; i < probs.length; i++) {
+        probs[i] = (probs[i] ?? 0) / filteredSum;
+      }
+    }
+    let maxIdx = 0;
+    let maxScore = probs[0] ?? 0;
+    for (let i = 1; i < probs.length; i++) {
+      const score = probs[i] ?? 0;
+      if (score > maxScore) {
+        maxScore = score;
+        maxIdx = i;
+      }
+    }
+    if (maxScore < this.minConfidence) {
+      return {
+        classifications: [],
+        inferenceMs: Date.now() - start,
+        modelId: this.modelEntry.id
+      };
+    }
+    const label = this.labels[maxIdx] ?? `species_${maxIdx}`;
+    return {
+      classifications: [
+        {
+          class: label,
+          score: maxScore
+        }
+      ],
+      inferenceMs: Date.now() - start,
+      modelId: this.modelEntry.id
+    };
+  }
+  async shutdown() {
+    await this.engine?.dispose();
+  }
+  getConfigSchema() {
+    return {
+      sections: [
+        {
+          id: "model",
+          title: "Model",
+          columns: 1,
+          fields: [
+            {
+              key: "modelId",
+              label: "Model",
+              type: "model-selector",
+              catalog: [...import_types8.BIRD_NABIRDS_MODELS],
+              allowCustom: false,
+              allowConversion: false,
+              acceptFormats: ["onnx", "coreml", "openvino"],
+              requiredMetadata: ["inputSize", "labels"],
+              outputFormatHint: "classification"
+            }
+          ]
+        },
+        {
+          id: "thresholds",
+          title: "Classification Settings",
+          columns: 1,
+          fields: [
+            {
+              key: "minConfidence",
+              label: "Minimum Confidence",
+              type: "slider",
+              min: 0.05,
+              max: 1,
+              step: 0.05,
+              default: 0.3
+            }
+          ]
+        },
+        {
+          id: "region",
+          title: "Regional Filter",
+          columns: 1,
+          fields: [
+            {
+              key: "regionFilter",
+              label: "Region Preset",
+              type: "select",
+              options: [
+                { value: "", label: "None (all 404 species)" },
+                { value: "north-america-east", label: "North America \u2014 Eastern" },
+                { value: "north-america-west", label: "North America \u2014 Western" },
+                { value: "north-america-south", label: "North America \u2014 Southern" }
+              ]
+            },
+            {
+              key: "allowedSpecies",
+              label: "Custom Allowed Species (comma-separated)",
+              type: "text"
+            }
+          ]
+        },
+        {
+          id: "runtime",
+          title: "Runtime",
+          columns: 2,
+          fields: [
+            {
+              key: "runtime",
+              label: "Runtime",
+              type: "select",
+              options: [
+                { value: "auto", label: "Auto (recommended)" },
+                { value: "onnx", label: "ONNX Runtime" },
+                { value: "coreml", label: "CoreML (Apple)" },
+                { value: "openvino", label: "OpenVINO (Intel)" }
+              ]
+            },
+            {
+              key: "backend",
+              label: "Backend",
+              type: "select",
+              dependsOn: { runtime: "onnx" },
+              options: [
+                { value: "cpu", label: "CPU" },
+                { value: "coreml", label: "CoreML" },
+                { value: "cuda", label: "CUDA (NVIDIA)" }
+              ]
+            }
+          ]
+        }
+      ]
+    };
+  }
+  getClassMap() {
+    return BIRD_CLASS_MAP2;
+  }
+  getModelCatalog() {
+    return [...import_types8.BIRD_NABIRDS_MODELS];
+  }
+  getAvailableModels() {
+    return [];
+  }
+  getActiveLabels() {
+    return SPECIES_LABELS2;
+  }
+  async probe() {
+    return {
+      available: true,
+      runtime: this.engine?.runtime ?? "onnx",
+      device: this.engine?.device ?? "cpu",
+      capabilities: ["fp32"]
+    };
+  }
+};
+
+// src/addons/animal-classifier/index.ts
+var import_types9 = require("@camstack/types");
+var ANIMAL_TYPE_LABEL = { id: "animal-type", name: "Animal Type" };
+var ANIMAL_TYPE_LABELS = [ANIMAL_TYPE_LABEL];
+var ANIMAL_CLASS_MAP = { mapping: {}, preserveOriginal: true };
+var ANIMAL_10_CLASSES = [
+  "cat",
+  "cow",
+  "dog",
+  "dolphin",
+  "eagle",
+  "giant panda",
+  "horse",
+  "monkey",
+  "sheep",
+  "spider"
+];
+function softmax3(logits) {
+  const max = logits.reduce((a, b) => Math.max(a, b), -Infinity);
+  const exps = logits.map((v) => Math.exp(v - max));
+  const sum = exps.reduce((a, b) => a + b, 0);
+  return exps.map((v) => v / sum);
+}
+var AnimalClassifierAddon = class {
+  id = "animal-classifier";
+  slot = "classifier";
+  inputClasses = ["animal"];
+  outputClasses = ["animal-type:*"];
+  slotPriority = 0;
+  requiredSteps = [];
+  manifest = {
+    id: "animal-classifier",
+    name: "Animal Classifier",
+    version: "0.1.0",
+    description: "ViT-based animal type classifier \u2014 10 common species",
+    packageName: "@camstack/vision",
+    slot: "classifier",
+    inputClasses: ["animal"],
+    outputClasses: ["animal-type:*"],
+    supportsCustomModels: false,
+    mayRequirePython: false,
+    defaultConfig: {
+      modelId: "animals-10",
+      runtime: "auto",
+      backend: "cpu",
+      minConfidence: 0.3
+    }
+  };
+  engine;
+  modelEntry;
+  minConfidence = 0.3;
+  async initialize(ctx) {
+    const cfg = ctx.addonConfig;
+    const modelId = cfg["modelId"] ?? "animals-10";
+    const runtime = cfg["runtime"] ?? "auto";
+    const backend = cfg["backend"] ?? "cpu";
+    this.minConfidence = cfg["minConfidence"] ?? 0.3;
+    const entry = import_types9.ANIMAL_TYPE_MODELS.find((m) => m.id === modelId);
+    if (!entry) {
+      throw new Error(`AnimalClassifierAddon: unknown modelId "${modelId}"`);
+    }
+    this.modelEntry = entry;
+    const resolved = await resolveEngine({
+      runtime,
+      backend,
+      modelEntry: entry,
+      modelsDir: ctx.locationPaths.models
+    });
+    this.engine = resolved.engine;
+  }
+  async classify(input) {
+    const start = Date.now();
+    const { width: inputW, height: inputH } = this.modelEntry.inputSize;
+    const animalCrop = await cropRegion(input.frame.data, input.roi);
+    const normalized = await resizeAndNormalize(animalCrop, inputW, inputH, "imagenet", "nchw");
+    const rawOutput = await this.engine.run(normalized, [1, 3, inputH, inputW]);
+    const probs = softmax3(rawOutput);
+    let maxIdx = 0;
+    let maxScore = probs[0] ?? 0;
+    for (let i = 1; i < probs.length; i++) {
+      const score = probs[i] ?? 0;
+      if (score > maxScore) {
+        maxScore = score;
+        maxIdx = i;
+      }
+    }
+    if (maxScore < this.minConfidence) {
+      return {
+        classifications: [],
+        inferenceMs: Date.now() - start,
+        modelId: this.modelEntry.id
+      };
+    }
+    const label = ANIMAL_10_CLASSES[maxIdx] ?? `animal_${maxIdx}`;
+    return {
+      classifications: [
+        {
+          class: label,
+          score: maxScore
+        }
+      ],
+      inferenceMs: Date.now() - start,
+      modelId: this.modelEntry.id
+    };
+  }
+  async shutdown() {
+    await this.engine?.dispose();
+  }
+  getConfigSchema() {
+    return {
+      sections: [
+        {
+          id: "model",
+          title: "Model",
+          columns: 1,
+          fields: [
+            {
+              key: "modelId",
+              label: "Model",
+              type: "model-selector",
+              catalog: [...import_types9.ANIMAL_TYPE_MODELS],
+              allowCustom: false,
+              allowConversion: false,
+              acceptFormats: ["onnx", "coreml", "openvino"],
+              requiredMetadata: ["inputSize", "labels"],
+              outputFormatHint: "classification"
+            }
+          ]
+        },
+        {
+          id: "thresholds",
+          title: "Classification Settings",
+          columns: 1,
+          fields: [
+            {
+              key: "minConfidence",
+              label: "Minimum Confidence",
+              type: "slider",
+              min: 0.05,
+              max: 1,
+              step: 0.05,
+              default: 0.3
+            }
+          ]
+        },
+        {
+          id: "runtime",
+          title: "Runtime",
+          columns: 2,
+          fields: [
+            {
+              key: "runtime",
+              label: "Runtime",
+              type: "select",
+              options: [
+                { value: "auto", label: "Auto (recommended)" },
+                { value: "onnx", label: "ONNX Runtime" },
+                { value: "coreml", label: "CoreML (Apple)" }
+              ]
+            },
+            {
+              key: "backend",
+              label: "Backend",
+              type: "select",
+              dependsOn: { runtime: "onnx" },
+              options: [
+                { value: "cpu", label: "CPU" },
+                { value: "coreml", label: "CoreML" },
+                { value: "cuda", label: "CUDA (NVIDIA)" }
+              ]
+            }
+          ]
+        }
+      ]
+    };
+  }
+  getClassMap() {
+    return ANIMAL_CLASS_MAP;
+  }
+  getModelCatalog() {
+    return [...import_types9.ANIMAL_TYPE_MODELS];
+  }
+  getAvailableModels() {
+    return [];
+  }
+  getActiveLabels() {
+    return ANIMAL_TYPE_LABELS;
+  }
+  async probe() {
+    return {
+      available: true,
+      runtime: this.engine?.runtime ?? "onnx",
+      device: this.engine?.device ?? "cpu",
+      capabilities: ["fp32"]
+    };
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  AnimalClassifierAddon,
+  AudioClassificationAddon,
+  BirdGlobalClassifierAddon,
+  BirdNABirdsClassifierAddon,
+  CameraNativeDetectionAddon,
+  FaceDetectionAddon,
+  FaceRecognitionAddon,
+  MotionDetectionAddon,
+  NodeInferenceEngine,
+  ObjectDetectionAddon,
+  PlateDetectionAddon,
+  PlateRecognitionAddon,
+  PythonInferenceEngine,
+  cosineSimilarity,
+  cropRegion,
+  ctcDecode,
+  detectMotion,
+  iou,
+  jpegToRgb,
+  l2Normalize,
+  letterbox,
+  nms,
+  probeOnnxBackends,
+  resizeAndNormalize,
+  resolveEngine,
+  rgbToGrayscale,
+  scrfdPostprocess,
+  yamnetPostprocess,
+  yoloPostprocess
+});
+//# sourceMappingURL=index.js.map