camstack 1.2.195 → 1.2.197

package/dist/cli.js

@@ -37,7 +37,7 @@ async function runServe(args) {
     ...typeof values.data === "string" ? { data: values.data } : {}
   };
   Object.assign(process.env, buildServeEnv(opts));
-  await import("./launcher-VKN5MWTJ.js");
+  await import("./launcher-I5A3WROT.js");
 }
 
 // src/commands/agent.ts
@@ -82,7 +82,7 @@ async function runAgent(args) {
     ...typeof values.port === "string" ? { port: values.port } : {}
   };
   Object.assign(process.env, buildAgentEnv(opts));
-  await import("./launcher-VKN5MWTJ.js");
+  await import("./launcher-I5A3WROT.js");
 }
 
 // src/commands/setup.ts

package/dist/{launcher-VKN5MWTJ.js → launcher-I5A3WROT.js}

@@ -122867,8 +122867,9 @@ var require_node = __commonJS({
         }
         return;
       }
+      const flags = format2 === "tar.xz" ? "-xJf" : format2 === "tar" ? "-xf" : "-xzf";
       deps.exec(tar, [
-        format2 === "tar.xz" ? "-xJf" : "-xzf",
+        flags,
         archivePath,
         "-C",
         destDir
@@ -123361,6 +123362,264 @@ ${(/* @__PURE__ */ new Date()).toISOString()}
         hash
       } });
     }
+    var AR_MAGIC = "!<arch>\n";
+    var AR_HEADER_BYTES = 60;
+    function readArMembers(archive) {
+      if (archive.subarray(0, 8).toString("latin1") !== AR_MAGIC) throw new Error('not an ar archive (a .deb starts with "!<arch>")');
+      const members = [];
+      let offset = 8;
+      while (offset + AR_HEADER_BYTES <= archive.length) {
+        const header = archive.subarray(offset, offset + AR_HEADER_BYTES).toString("latin1");
+        if (header.slice(58, 60) !== "`\n") throw new Error(`corrupt ar member header at byte ${offset}`);
+        const name = header.slice(0, 16).trim().replace(/\/$/, "");
+        const size = Number.parseInt(header.slice(48, 58).trim(), 10);
+        if (!Number.isInteger(size) || size < 0) throw new Error(`ar member "${name}" has no valid size`);
+        const start = offset + AR_HEADER_BYTES;
+        if (start + size > archive.length) throw new Error(`ar member "${name}" runs past the end of the archive`);
+        members.push({
+          name,
+          data: archive.subarray(start, start + size)
+        });
+        offset = start + size + size % 2;
+      }
+      return members;
+    }
+    function debDataMember(deb) {
+      const member = readArMembers(deb).find((m) => m.name.startsWith("data.tar"));
+      if (member === void 0) throw new Error(".deb has no data.tar member");
+      const suffix = member.name.slice(8);
+      const compression = suffix === ".zst" ? "zst" : suffix === ".xz" ? "xz" : suffix === ".gz" ? "gz" : suffix === "" ? "none" : null;
+      if (compression === null) throw new Error(`.deb payload ${member.name} uses a compression this extractor does not read`);
+      return {
+        compression,
+        data: member.data
+      };
+    }
+    function extractDebPayload(deb, destDir, workDir, extract = extractArchive) {
+      const payload = debDataMember(deb);
+      (0, node_fs.mkdirSync)(destDir, { recursive: true });
+      (0, node_fs.mkdirSync)(workDir, { recursive: true });
+      if (payload.compression === "xz") {
+        const xzPath = (0, node_path.join)(workDir, "data.tar.xz");
+        (0, node_fs.writeFileSync)(xzPath, payload.data);
+        extract(xzPath, "tar.xz", destDir);
+        return;
+      }
+      const tar = payload.compression === "zst" ? (0, node_zlib.zstdDecompressSync)(payload.data) : payload.compression === "gz" ? (0, node_zlib.gunzipSync)(payload.data) : payload.data;
+      const tarPath = (0, node_path.join)(workDir, "data.tar");
+      (0, node_fs.writeFileSync)(tarPath, tar);
+      extract(tarPath, "tar", destDir);
+    }
+    function findEntryByName(dir, name) {
+      for (const entry of (0, node_fs.readdirSync)(dir, { withFileTypes: true })) {
+        const full = (0, node_path.join)(dir, entry.name);
+        if ((entry.isFile() || entry.isSymbolicLink()) && entry.name === name) return full;
+        if (entry.isDirectory()) {
+          const nested = findEntryByName(full, name);
+          if (nested !== null) return nested;
+        }
+      }
+      return null;
+    }
+    function installLibraryFromDeb(debPath, memberName, targetPath2, workDir, extract = extractArchive) {
+      const tree = (0, node_path.join)(workDir, "tree");
+      try {
+        extractDebPayload((0, node_fs.readFileSync)(debPath), tree, workDir, extract);
+        const found = findEntryByName(tree, memberName);
+        if (found === null) throw new Error(`${memberName} not found inside ${debPath}`);
+        (0, node_fs.copyFileSync)(found, targetPath2);
+      } finally {
+        (0, node_fs.rmSync)(workDir, {
+          recursive: true,
+          force: true
+        });
+      }
+    }
+    var EDGETPU_LIB_ENV = "CAMSTACK_EDGETPU_LIB";
+    var EDGETPU_DELEGATE_RELEASE = "16.0TF2.17.1-1";
+    var LEGACY_EDGETPU_LIB = "/data/deps/edgetpu/lib/libedgetpu.so.1";
+    var FERANICK = `https://github.com/feranick/libedgetpu/releases/download/${EDGETPU_DELEGATE_RELEASE}`;
+    function linuxSet(deb, debSha, debSize, libusbUrl, libusbSha, libusbSize) {
+      return {
+        supported: true,
+        files: [{
+          url: `${FERANICK}/${deb}`,
+          sha256: debSha,
+          sizeBytes: debSize,
+          container: "deb",
+          member: "libedgetpu.so.1",
+          installAs: "libedgetpu.so.1"
+        }, {
+          url: libusbUrl,
+          sha256: libusbSha,
+          sizeBytes: libusbSize,
+          container: "deb",
+          member: "libusb-1.0.so.0",
+          installAs: "libusb-1.0.so.0"
+        }]
+      };
+    }
+    function getEdgetpuDelegateArtifact(platform, arch) {
+      if (platform === "linux" && arch === "x64") return linuxSet("libedgetpu1-std_16.0tf2.17.1-1.ubuntu24.04_amd64.deb", "3cd98ae42d26a0ab601673d2162eb968921f751d3879ef960687637cad1cba96", 389600, "http://archive.ubuntu.com/ubuntu/pool/main/libu/libusb-1.0/libusb-1.0-0_1.0.27-1_amd64.deb", "d59e679a82ee2b724c556397e831e879936adbe8a007705872b65a5e1ec887b5", 54008);
+      if (platform === "linux" && arch === "arm64") return linuxSet("libedgetpu1-std_16.0tf2.17.1-1.ubuntu24.04_arm64.deb", "6d53b6f6f9a19a6685a488e0c262aed2b11b6ff8c953f10e0aa14a16122f0d37", 338416, "http://ports.ubuntu.com/ubuntu-ports/pool/main/libu/libusb-1.0/libusb-1.0-0_1.0.27-1_arm64.deb", "c8c34ef4385b6be34fe94aabd4de06c7bbd5ae617e80e9306f412f4c979aa5e4", 54082);
+      if (platform === "darwin" && arch === "arm64") return {
+        supported: true,
+        files: [{
+          url: `${FERANICK}/libedgetpu-16.0-tf2.17.1-1_MacOS_Silicon.zip`,
+          sha256: "5d57b4ff80bfe70d1d9306a3a8a83f52b38e8a151c35aecf68d807744eacf1f4",
+          sizeBytes: 760105,
+          container: "zip",
+          member: "libedgetpu-16.0-tf2.17.1-1_MacOS_Silicon/throttled/darwin_arm64/libedgetpu.1.0.dylib",
+          installAs: "libedgetpu.1.dylib"
+        }]
+      };
+      if (platform === "darwin") return {
+        supported: false,
+        reason: "ai-edge-litert 2.1.6 publishes no macOS x86_64 wheel, and the Intel delegate links MacPorts libusb at /opt/local/lib"
+      };
+      if (platform === "win32") return {
+        supported: false,
+        reason: "no libedgetpu built against TF 2.17.1 exists for Windows (feranick ships Linux and macOS only)"
+      };
+      return {
+        supported: false,
+        reason: `no pinned libedgetpu build for ${platform}-${arch}`
+      };
+    }
+    function edgetpuDelegateFileName(platform) {
+      return platform === "darwin" ? "libedgetpu.1.dylib" : "libedgetpu.so.1";
+    }
+    function edgetpuLibDir(dataDir) {
+      return (0, node_path.join)(dataDir, "deps", "edgetpu", "lib");
+    }
+    function chooseEdgetpuDelegate(lookup) {
+      const override = lookup.override?.trim();
+      if (override !== void 0 && override.length > 0) return lookup.exists(override) ? {
+        path: override,
+        origin: "override"
+      } : null;
+      if (lookup.dataDir !== void 0 && lookup.dataDir.length > 0) {
+        const staged = (0, node_path.join)(edgetpuLibDir(lookup.dataDir), edgetpuDelegateFileName(lookup.platform));
+        if (lookup.exists(staged)) return {
+          path: staged,
+          origin: "staged"
+        };
+      }
+      if (lookup.exists("/data/deps/edgetpu/lib/libedgetpu.so.1")) return {
+        path: LEGACY_EDGETPU_LIB,
+        origin: "legacy"
+      };
+      return null;
+    }
+    function nodeDataRootFromEnv(env) {
+      return env["CAMSTACK_DATA"] ?? env["CAMSTACK_DATA_DIR"];
+    }
+    async function download(url, target) {
+      const response = await fetch(url, { redirect: "follow" });
+      if (!response.ok) throw new Error(`download failed: ${response.status} ${response.statusText} (${url})`);
+      (0, node_fs.writeFileSync)(target, Buffer.from(await response.arrayBuffer()));
+    }
+    async function stageFile(file, libDir, workRoot) {
+      const target = (0, node_path.join)(libDir, file.installAs);
+      if ((0, node_fs.existsSync)(target)) return;
+      const work = (0, node_path.join)(workRoot, file.installAs);
+      (0, node_fs.rmSync)(work, {
+        recursive: true,
+        force: true
+      });
+      (0, node_fs.mkdirSync)(work, { recursive: true });
+      const container = (0, node_path.join)(work, `download.${file.container}`);
+      const partial = `${target}.partial`;
+      try {
+        await download(file.url, container);
+        verifySha256(container, file.sha256, file.installAs, file.url);
+        if (file.container === "deb") installLibraryFromDeb(container, file.member, partial, (0, node_path.join)(work, "deb"));
+        else {
+          const tree = (0, node_path.join)(work, "tree");
+          (0, node_fs.mkdirSync)(tree, { recursive: true });
+          extractArchive(container, "zip", tree);
+          const inner = (0, node_path.join)(tree, file.member);
+          const found = (0, node_fs.existsSync)(inner) ? inner : findEntryByName(tree, file.member.split("/").pop() ?? file.member);
+          if (found === null) throw new Error(`${file.member} not found inside ${file.url}`);
+          (0, node_fs.copyFileSync)(found, partial);
+        }
+        (0, node_fs.renameSync)(partial, target);
+      } finally {
+        (0, node_fs.rmSync)(work, {
+          recursive: true,
+          force: true
+        });
+        (0, node_fs.rmSync)(partial, { force: true });
+      }
+    }
+    var EDGETPU_DELEGATE_DIRECTIVE = "# camstack-native-dep: edgetpu-delegate";
+    function declaresEdgetpuDelegate(requirementsText) {
+      return requirementsText.split(/\r?\n/).some((line) => line.trim() === EDGETPU_DELEGATE_DIRECTIVE);
+    }
+    async function ensureEdgetpuDelegate(dataDir, logger, opts = {}) {
+      const env = opts.env ?? process.env;
+      const platform = opts.platform ?? process.platform;
+      const arch = opts.arch ?? process.arch;
+      const override = env[EDGETPU_LIB_ENV]?.trim();
+      const present = chooseEdgetpuDelegate({
+        platform,
+        dataDir,
+        override,
+        exists: node_fs.existsSync
+      });
+      if (present !== null) {
+        logger.info("Coral delegate resolved", { meta: {
+          path: present.path,
+          origin: present.origin
+        } });
+        return {
+          kind: "ready",
+          path: present.path,
+          origin: present.origin
+        };
+      }
+      if (override !== void 0 && override.length > 0) {
+        const reason = `${EDGETPU_LIB_ENV} names a file that does not exist: ${override}`;
+        logger.error("Coral delegate not staged", { meta: { reason } });
+        return {
+          kind: "unavailable",
+          reason
+        };
+      }
+      const artifact = getEdgetpuDelegateArtifact(platform, arch);
+      if (!artifact.supported) {
+        logger.warn("Coral delegate not staged", { meta: { reason: artifact.reason } });
+        return {
+          kind: "unavailable",
+          reason: artifact.reason
+        };
+      }
+      const libDir = edgetpuLibDir(dataDir);
+      (0, node_fs.mkdirSync)(libDir, { recursive: true });
+      logger.info("Coral delegate is not on this node yet \u2014 downloading the pinned set", { meta: {
+        release: EDGETPU_DELEGATE_RELEASE,
+        files: artifact.files.map((f) => f.installAs).join(",")
+      } });
+      const workRoot = (0, node_path.join)(dataDir, "deps", ".edgetpu-staging");
+      try {
+        for (const file of artifact.files) await stageFile(file, libDir, workRoot);
+      } finally {
+        (0, node_fs.rmSync)(workRoot, {
+          recursive: true,
+          force: true
+        });
+      }
+      const path = (0, node_path.join)(libDir, edgetpuDelegateFileName(platform));
+      logger.info("Coral delegate resolved", { meta: {
+        path,
+        origin: "downloaded"
+      } });
+      return {
+        kind: "ready",
+        path,
+        origin: "downloaded"
+      };
+    }
     var DEFAULT_FIRST_UNIT_TIMEOUT_MS = 12e3;
     var FRAGMENT_LOG_EVERY = 30;
     var Fmp4FragmentChild = class {
@@ -124381,11 +124640,15 @@ ${(/* @__PURE__ */ new Date()).toISOString()}
       return input.persisted ?? input.fresh;
     }
     exports.ChildCostRegistry = ChildCostRegistry;
+    exports.EDGETPU_DELEGATE_DIRECTIVE = EDGETPU_DELEGATE_DIRECTIVE;
+    exports.EDGETPU_DELEGATE_RELEASE = EDGETPU_DELEGATE_RELEASE;
+    exports.EDGETPU_LIB_ENV = EDGETPU_LIB_ENV;
     exports.FFMPEG_RELEASE = require_composition.FFMPEG_RELEASE;
     exports.FfmpegProcess = FfmpegProcess;
     exports.FilesystemStorageProvider = FilesystemStorageProvider;
     exports.Fmp4FragmentChild = Fmp4FragmentChild;
     exports.Fmp4FragmentPlane = Fmp4FragmentPlane;
+    exports.LEGACY_EDGETPU_LIB = LEGACY_EDGETPU_LIB;
     exports.NO_COST_CLAIM = NO_COST_CLAIM;
     exports.NO_PINNED_FFMPEG_DETAIL = NO_PINNED_FFMPEG_DETAIL;
     exports.OwnerOnlyError = OwnerOnlyError;
@@ -124393,23 +124656,33 @@ ${(/* @__PURE__ */ new Date()).toISOString()}
     exports.buildBinaryPath = buildBinaryPath;
     exports.canonicalDeviceFingerprint = canonicalDeviceFingerprint;
     exports.canonicalHash = require_composition.canonicalHash;
+    exports.chooseEdgetpuDelegate = chooseEdgetpuDelegate;
     exports.containsOrEquals = containsOrEquals;
     exports.customizationBlockName = customizationBlockName;
+    exports.debDataMember = debDataMember;
+    exports.declaresEdgetpuDelegate = declaresEdgetpuDelegate;
     exports.defaultFfmpegSpawn = defaultFfmpegSpawn;
     exports.diffExportTargets = diffExportTargets;
     exports.downloadBinary = downloadBinary;
+    exports.edgetpuDelegateFileName = edgetpuDelegateFileName;
+    exports.edgetpuLibDir = edgetpuLibDir;
     exports.ensureBinary = ensureBinary;
+    exports.ensureEdgetpuDelegate = ensureEdgetpuDelegate;
     exports.ensureFfmpeg = ensureFfmpeg;
     exports.ensurePython = ensurePython;
+    exports.extractDebPayload = extractDebPayload;
     exports.findInPath = findInPath;
+    exports.getEdgetpuDelegateArtifact = getEdgetpuDelegateArtifact;
     exports.getFfmpegArtifact = require_composition.getFfmpegArtifact;
     exports.getFfmpegDownloadUrl = require_composition.getFfmpegDownloadUrl;
     exports.getPlatformInfo = getPlatformInfo;
     exports.getPythonDownloadUrl = getPythonDownloadUrl;
     exports.icaclsArgs = icaclsArgs;
+    exports.installLibraryFromDeb = installLibraryFromDeb;
     exports.installPythonPackages = installPythonPackages;
     exports.installPythonRequirements = installPythonRequirements;
     exports.mkdirOwnerOnlySync = mkdirOwnerOnlySync;
+    exports.nodeDataRootFromEnv = nodeDataRootFromEnv;
     exports.nodeProcStatReader = nodeProcStatReader;
     exports.parseFfmpegCapabilities = parseFfmpegCapabilities;
     exports.parseProcCpuSeconds = parseProcCpuSeconds;
@@ -124417,6 +124690,7 @@ ${(/* @__PURE__ */ new Date()).toISOString()}
     exports.physicalRootOf = physicalRootOf;
     exports.pinnedFfmpegSpawner = pinnedFfmpegSpawner;
     exports.probeFfmpegBinary = probeFfmpegBinary;
+    exports.readArMembers = readArMembers;
     exports.readProcessCost = readProcessCost;
     exports.resolveExportFingerprint = resolveExportFingerprint;
     exports.resolvePinnedFfmpegSpawner = resolvePinnedFfmpegSpawner;
@@ -158995,6 +159269,23 @@ var require_native_metrics_addon = __commonJS({
     var NODE_CONTAINER_CURRENT_KEY = keyOf("container-current-mib");
     keyOf("process-cpu-percent");
     keyOf("process-rss-mib");
+    var RUNNER_SAMPLE_MIN_INTERVAL_MS = 1e4;
+    var RUNNER_SAMPLE_RATE_SLACK_MS = 1e3;
+    function sampleIsDue(slot, ts) {
+      if (slot === void 0 || ts < slot.lastTs) return true;
+      return ts >= slot.nextDue - RUNNER_SAMPLE_RATE_SLACK_MS;
+    }
+    function nextSampleSlot(slot, ts) {
+      if (slot === void 0) return {
+        lastTs: ts,
+        nextDue: ts + RUNNER_SAMPLE_MIN_INTERVAL_MS
+      };
+      if (ts < slot.lastTs) return slot;
+      return {
+        lastTs: ts,
+        nextDue: Math.max(slot.nextDue, ts) + RUNNER_SAMPLE_MIN_INTERVAL_MS
+      };
+    }
     var DECLARATIONS = [
       {
         name: "runner-cpu-main-percent",
@@ -159084,6 +159375,8 @@ var require_native_metrics_addon = __commonJS({
       deps;
       declared = false;
       lastTotalsAt = /* @__PURE__ */ new Map();
+      /** Per node: the door's slot for the per-runner batch (see {@link sampleIsDue}). */
+      sampleSlots = /* @__PURE__ */ new Map();
       /** A not-ready skip was logged and device-history has not been ready since. */
       waitLogged = false;
       constructor(deps) {
@@ -159103,6 +159396,7 @@ var require_native_metrics_addon = __commonJS({
       }
       /** One process snapshot: per-runner sums plus the container's memory. */
       async recordSample(nodeId, atMs, processes, containerMemory) {
+        if (!sampleIsDue(this.sampleSlots.get(nodeId), atMs)) return;
         const subject = {
           kind: "node",
           nodeId
@@ -159146,7 +159440,7 @@ var require_native_metrics_addon = __commonJS({
           points.push(point(RUNNER_PROCESSES_KEY, scope, t.count));
         }
         if (containerMemory !== null) points.push(point(NODE_CONTAINER_CURRENT_KEY, "", Math.round(containerMemory.currentBytes / MIB)));
-        await this.write(nodeId, atMs, points);
+        if (await this.write(nodeId, atMs, points) > 0) this.sampleSlots.set(nodeId, nextSampleSlot(this.sampleSlots.get(nodeId), atMs));
       }
       /** One resources snapshot: the node's totals, at most every {@link NODE_TOTALS_MIN_INTERVAL_MS}. */
       async recordTotals(nodeId, atMs, snapshot) {
@@ -159176,8 +159470,8 @@ var require_native_metrics_addon = __commonJS({
         await this.write(nodeId, atMs, points);
       }
       async write(nodeId, atMs, points) {
-        if (points.length === 0) return;
-        if (!await this.ensureDeclared()) return;
+        if (points.length === 0) return 0;
+        if (!await this.ensureDeclared()) return 0;
         try {
           const result = await this.deps.deviceHistory.record({ points });
           if (result.refused.length > 0) {
@@ -159188,12 +159482,14 @@ var require_native_metrics_addon = __commonJS({
               refused: refusalCounts(result)
             } });
           }
+          return result.accepted;
         } catch (err) {
           this.deps.logger.warn("node metrics history sample not stored", { meta: {
             nodeId,
             atMs,
             error: err instanceof Error ? err.message : String(err)
           } });
+          return 0;
         }
       }
       async readContainerPoints(nodeId, sinceMs, maxPoints) {
@@ -164911,9 +165207,9 @@ var require_lib = __commonJS({
   }
 });
 
-// ../system/dist/wal-maintenance-DUHEp_09.js
-var require_wal_maintenance_DUHEp_09 = __commonJS({
-  "../system/dist/wal-maintenance-DUHEp_09.js"(exports) {
+// ../system/dist/wal-maintenance-CaJjuLHq.js
+var require_wal_maintenance_CaJjuLHq = __commonJS({
+  "../system/dist/wal-maintenance-CaJjuLHq.js"(exports) {
     "use strict";
     var require_chunk = require_chunk_Cek0wNdY();
     var require_dist10 = require_dist_Bn_RNanh();
@@ -165487,12 +165783,14 @@ CREATE TABLE IF NOT EXISTS _record_sequences (
       const eqCount = equalities.length;
       const eqSet = new Set(equalities.map((p) => p.field));
       const range = ranges[0];
-      const candidate = decl.indexes.find((index) => {
+      const candidates = decl.indexes.filter((index) => {
         const leading = index.fields.slice(0, eqCount);
         if (leading.length !== eqCount || !leading.every((f) => eqSet.has(f))) return false;
         if (range !== void 0 && index.fields[eqCount] !== range.field) return false;
         return extra.every((f) => index.fields.includes(f));
       });
+      const groupBy = opts.groupBy;
+      const candidate = (groupBy === void 0 ? void 0 : candidates.find((index) => index.fields[eqCount] === groupBy)) ?? candidates[0];
       if (candidate === void 0) {
         const declared = decl.indexes.map((i) => `${i.name}(${i.fields.join(", ")})`).join("; ");
         throw new require_dist10.UnindexedFilterError(`${kind}: no declared index serves [${[...predicates.map((p) => p.field), ...extra].join(", ")}]. Declared: ${declared.length > 0 ? declared : "none"}. A filter on an unindexed field does not compile - declare an index`);
@@ -165615,9 +165913,9 @@ CREATE TABLE IF NOT EXISTS _record_sequences (
       const params = [];
       const tag = `id:${dir}`;
       if (q.cursor !== void 0) {
-        assertCursor(q.cursor, tag, 1);
+        assertCursor(q.cursor, tag, 2);
         clauses.push(`id ${cmp} ?`);
-        params.push(...q.cursor.values);
+        params.push(q.cursor.values[0] ?? null);
       }
       return {
         sql: `SELECT ${ROW_COLUMNS}, id AS _k0 FROM records WHERE ${clauses.join(" AND ")} ORDER BY id ${dir} LIMIT ${q.limit + 1}`,
@@ -165668,7 +165966,8 @@ CREATE TABLE IF NOT EXISTS _record_sequences (
       if (extra.length === 0 && q.where === void 0) throw new require_dist10.InvalidRecordError(`${kind}: a count with no field and no groupBy is "count"`);
       const where = planWhere(kind, decl, q.where, {
         allowIn: true,
-        extraFields: extra
+        extraFields: extra,
+        groupBy: q.groupBy
       });
       if (where === null) throw new require_dist10.InvalidRecordError(`${kind}: aggregate has nothing to read`);
       const fn = q.op.toUpperCase();
@@ -169092,7 +169391,7 @@ var require_sqlite_settings_addon = __commonJS({
     var require_chunk = require_chunk_Cek0wNdY();
     var require_dist10 = require_dist_Bn_RNanh();
     var require_retired_settings_keys = require_retired_settings_keys_D_VwZiDt();
-    var require_wal_maintenance = require_wal_maintenance_DUHEp_09();
+    var require_wal_maintenance = require_wal_maintenance_CaJjuLHq();
     var require_sqlite_snapshot_protocol = require_sqlite_snapshot_protocol_B9OndqZv();
     var require_wal_checkpoint_policy = require_wal_checkpoint_policy_d2z2qPqx();
     var node_fs_promises = __require("fs/promises");
@@ -170819,7 +171118,7 @@ var require_sqlite_storage = __commonJS({
     });
     require_chunk_Cek0wNdY();
     var require_builtins_sqlite_storage_filesystem_storage_addon = require_filesystem_storage_addon();
-    var require_wal_maintenance = require_wal_maintenance_DUHEp_09();
+    var require_wal_maintenance = require_wal_maintenance_CaJjuLHq();
     var require_builtins_sqlite_storage_sqlite_settings_addon = require_sqlite_settings_addon();
     var ConfigStore = class {
       db;
@@ -288030,11 +288329,12 @@ var require_restore_archive_DM1OBYq4 = __commonJS({
   }
 });
 
-// ../system/dist/coral-accelerators-Bi_c3Rft.js
-var require_coral_accelerators_Bi_c3Rft = __commonJS({
-  "../system/dist/coral-accelerators-Bi_c3Rft.js"(exports) {
+// ../system/dist/coral-accelerators-oUXmmbc2.js
+var require_coral_accelerators_oUXmmbc2 = __commonJS({
+  "../system/dist/coral-accelerators-oUXmmbc2.js"(exports) {
     "use strict";
     var require_chunk = require_chunk_Cek0wNdY();
+    var _camstack_types_node = require_node();
     var node_fs = __require("fs");
     node_fs = require_chunk.__toESM(node_fs);
     var CORAL_USB_IDS = [{
@@ -288047,7 +288347,13 @@ var require_coral_accelerators_Bi_c3Rft = __commonJS({
     var CORAL_PCI_VENDOR = "0x1ac1";
     var CORAL_PCI_DEVICE = "0x089a";
     var APEX_ENTRY = /^apex_(\d+)$/;
-    var DEFAULT_EDGETPU_LIB = "/data/deps/edgetpu/lib/libedgetpu.so.1";
+    function currentDelegateHost() {
+      return {
+        platform: process.platform,
+        dataDir: (0, _camstack_types_node.nodeDataRootFromEnv)(process.env),
+        override: process.env[_camstack_types_node.EDGETPU_LIB_ENV]
+      };
+    }
     function countUsbCorals(fsx) {
       let count = 0;
       for (const device of fsx.listUsbDevices()) {
@@ -288083,7 +288389,7 @@ var require_coral_accelerators_Bi_c3Rft = __commonJS({
         driverMissing
       };
     }
-    function classifyCoralAccelerator(fsx) {
+    function classifyCoralAccelerator(fsx, delegateHost = currentDelegateHost()) {
       const usb = countUsbCorals(fsx);
       const pci = classifyPci(fsx);
       const units = [];
@@ -288114,8 +288420,10 @@ var require_coral_accelerators_Bi_c3Rft = __commonJS({
         type: "coral-edgetpu",
         units
       };
-      const libPath = process.env["CAMSTACK_EDGETPU_LIB"] ?? DEFAULT_EDGETPU_LIB;
-      if (fsx.exists(libPath)) return {
+      if ((0, _camstack_types_node.chooseEdgetpuDelegate)({
+        ...delegateHost,
+        exists: (p) => fsx.exists(p)
+      }) !== null) return {
         type: "coral-edgetpu",
         units: [{
           bus: "usb",
@@ -294795,7 +295103,7 @@ var require_dist3 = __commonJS({
     var require_builtins_native_metrics_native_metrics_addon = require_native_metrics_addon();
     var require_builtins_device_history_device_history_addon = require_device_history_addon();
     var require_builtins_sqlite_storage_filesystem_storage_addon = require_filesystem_storage_addon();
-    var require_wal_maintenance = require_wal_maintenance_DUHEp_09();
+    var require_wal_maintenance = require_wal_maintenance_CaJjuLHq();
     var require_builtins_sqlite_storage_sqlite_settings_addon = require_sqlite_settings_addon();
     var require_builtins_sqlite_storage_index = require_sqlite_storage();
     var require_builtins_storage_orchestrator_storage_orchestrator_addon = require_storage_orchestrator_addon();
@@ -294810,7 +295118,7 @@ var require_dist3 = __commonJS({
     var require_platform_key_source = require_platform_key_source_Di7HrlGR();
     var require_resource_monitor = require_resource_monitor_mio9dSCT();
     var require_restore_archive = require_restore_archive_DM1OBYq4();
-    var require_coral_accelerators = require_coral_accelerators_Bi_c3Rft();
+    var require_coral_accelerators = require_coral_accelerators_oUXmmbc2();
     var zod = require_zod();
     var node_crypto = __require("crypto");
     node_crypto = require_chunk.__toESM(node_crypto);
@@ -299706,6 +300014,20 @@ var require_dist3 = __commonJS({
       }
       async loadDeclaration(addonDir, declaration, packageName, packageVersion, packageDisplayName, bundle) {
         if (!declaration.entry) throw new Error(`Addon "${declaration.id}" has no entry point in package.json`);
+        const owner = this.addons.get(declaration.id);
+        if (owner !== void 0 && owner.packageName !== packageName) {
+          this.logger.warn(`Skipped addon "${declaration.id}" from ${packageName}: already provided by ${owner.packageName}`, {
+            tags: { addonId: declaration.id },
+            meta: {
+              skippedPackage: packageName,
+              skippedVersion: packageVersion,
+              skippedDir: addonDir,
+              ownerPackage: owner.packageName,
+              ownerVersion: owner.packageVersion
+            }
+          });
+          return;
+        }
         const entryFile = declaration.entry.replace(/^\.\//, "").replace(/^src\//, "dist/").replace(/\.ts$/, ".js");
         let entryPath = node_path.resolve(addonDir, entryFile);
         if (!node_fs.existsSync(entryPath)) {
@@ -313417,6 +313739,19 @@ var require_dist3 = __commonJS({
         const pythonPath = await this.ensurePython();
         if (!pythonPath) throw new Error("Cannot install Python requirements: Python is not available");
         await singleFlight(this.depsDir, "python-pip", () => (0, _camstack_types_node.installPythonRequirements)(pythonPath, requirementsFile, this.logger));
+        await this.stageNativeDepsDeclaredBy(requirementsFile);
+      }
+      /**
+      * The native library a requirements file says its packages need
+      * (`# camstack-native-dep: edgetpu-delegate`), staged under this node's
+      * deps dir. Runs on every call — not only the first pip install — so a
+      * node whose pip marker predates the line still gets the library. A
+      * platform without a build answers `unavailable` (logged, not thrown); a
+      * failed or tampered download throws, and provisioning reports it.
+      */
+      async stageNativeDepsDeclaredBy(requirementsFile) {
+        if (!(0, _camstack_types_node.declaresEdgetpuDelegate)(node_fs.readFileSync(requirementsFile, "utf8"))) return;
+        await singleFlight(this.depsDir, "edgetpu-delegate", () => (0, _camstack_types_node.ensureEdgetpuDelegate)(this.nodeRoot, this.logger));
       }
       getDepsDir() {
         return this.depsDir;
@@ -317677,6 +318012,7 @@ var require_dist3 = __commonJS({
     exports.RUNTIME_DEFAULTS = require_dist10.RUNTIME_DEFAULTS;
     exports.ReadinessRegistry = require_dist10.ReadinessRegistry;
     exports.ReadinessTimeoutError = require_dist10.ReadinessTimeoutError;
+    exports.RecordsEngine = require_wal_maintenance.RecordsEngine;
     exports.ReplEngine = ReplEngine;
     exports.RingBuffer = RingBuffer;
     exports.SERVER_AUTH_OID = require_agent_https.SERVER_AUTH_OID;
@@ -588165,8 +588501,12 @@ var require_addon_registry_service = __commonJS({
     function isShareViewKind(value) {
       return typeof value === "string" && types_1.SHARE_VIEW_KINDS.includes(value);
     }
+    var SELF_READYING_CAPABILITIES = /* @__PURE__ */ new Set([
+      "platform-probe",
+      "device-history"
+    ]);
     function shouldEmitProviderRegisteredReady(capability) {
-      return capability !== "platform-probe";
+      return !SELF_READYING_CAPABILITIES.has(capability);
     }
     var DEVICE_SCOPED_CAP_NAMES = new Set(types_1.ALL_CAPABILITY_DEFINITIONS.filter((def) => def.scope === "device").map((def) => def.name));
     function isDeviceScopedCapName(capName) {
@@ -589790,6 +590130,13 @@ var require_addon_registry_service = __commonJS({
         const failed = [];
         for (const registered of freshLoader.listAddons()) {
           const existing = this.addonEntries.get(registered.declaration.id);
+          if (existing && existing.packageName !== registered.packageName) {
+            this.logger.warn("loadNewAddons: skipped a package claiming a running addon id", {
+              tags: { addonId: registered.declaration.id },
+              meta: { skippedPackage: registered.packageName, ownerPackage: existing.packageName }
+            });
+            continue;
+          }
           if (existing) {
             existing.packageVersion = registered.packageVersion;
             existing.packageName = registered.packageName;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "camstack",
-  "version": "1.2.195",
+  "version": "1.2.197",
   "description": "CLI tool for managing and running CamStack server",
   "keywords": [
     "camstack",