@camstack/system 1.2.459 → 1.2.460

package/dist/addon-runner.js

@@ -39,9 +39,9 @@ let node_vm = require("node:vm");
 node_vm = __toESM(node_vm);
 let node_fs_promises = require("node:fs/promises");
 let _trpc_client = require("@trpc/client");
+let _camstack_types_node = require("@camstack/types/node");
 let node_http = require("node:http");
 let node_events = require("node:events");
-let _camstack_types_node = require("@camstack/types/node");
 let node_module = require("node:module");
 let node_url = require("node:url");
 //#region src/kernel/addon-refused-error.ts
@@ -7885,13 +7885,13 @@ var CORAL_PCI_VENDOR = "0x1ac1";
 var CORAL_PCI_DEVICE = "0x089a";
 /** A unit the apex driver bound: `/sys/class/apex/apex_<N>` ↔ `/dev/apex_<N>`. */
 var APEX_ENTRY = /^apex_(\d+)$/;
-/**
-* Default install path of the libedgetpu delegate on the hub, provisioned
-* out-of-band by `/data/deps/edgetpu-install.sh` (it is a system shared
-* library, not a pip package). Overridable via `CAMSTACK_EDGETPU_LIB` — kept in
-* sync with the Python pool's own default in `inference_pool.py`.
-*/
-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()) {
@@ -7946,7 +7946,7 @@ function classifyPci(fsx) {
 * Returns `null` only when no Coral was found at all; a present-but-unusable
 * Coral is reported with its typed reason, never as absent (D393/D315).
 */
-function classifyCoralAccelerator(fsx) {
+function classifyCoralAccelerator(fsx, delegateHost = currentDelegateHost()) {
 	const usb = countUsbCorals(fsx);
 	const pci = classifyPci(fsx);
 	const units = [];
@@ -7977,8 +7977,10 @@ function classifyCoralAccelerator(fsx) {
 		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",
@@ -8987,6 +8989,19 @@ var AddonDepsManager = class {
 		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;

package/dist/addon-runner.mjs

@@ -16,9 +16,9 @@ import { monitorEventLoopDelay } from "node:perf_hooks";
 import * as vm from "node:vm";
 import { mkdir, rm, stat, unlink } from "node:fs/promises";
 import { TRPCClientError, createTRPCClient } from "@trpc/client";
+import { EDGETPU_LIB_ENV, chooseEdgetpuDelegate, declaresEdgetpuDelegate, ensureBinary, ensureEdgetpuDelegate, ensureFfmpeg, ensurePython, installPythonPackages, installPythonRequirements, nodeDataRootFromEnv } from "@camstack/types/node";
 import { createServer as createServer$1, request } from "node:http";
 import { once } from "node:events";
-import { ensureBinary, ensureFfmpeg, ensurePython, installPythonPackages, installPythonRequirements } from "@camstack/types/node";
 import { pathToFileURL } from "node:url";
 //#region src/kernel/addon-refused-error.ts
 /**
@@ -7861,13 +7861,13 @@ var CORAL_PCI_VENDOR = "0x1ac1";
 var CORAL_PCI_DEVICE = "0x089a";
 /** A unit the apex driver bound: `/sys/class/apex/apex_<N>` ↔ `/dev/apex_<N>`. */
 var APEX_ENTRY = /^apex_(\d+)$/;
-/**
-* Default install path of the libedgetpu delegate on the hub, provisioned
-* out-of-band by `/data/deps/edgetpu-install.sh` (it is a system shared
-* library, not a pip package). Overridable via `CAMSTACK_EDGETPU_LIB` — kept in
-* sync with the Python pool's own default in `inference_pool.py`.
-*/
-var DEFAULT_EDGETPU_LIB = "/data/deps/edgetpu/lib/libedgetpu.so.1";
+function currentDelegateHost() {
+	return {
+		platform: process.platform,
+		dataDir: nodeDataRootFromEnv(process.env),
+		override: process.env[EDGETPU_LIB_ENV]
+	};
+}
 function countUsbCorals(fsx) {
 	let count = 0;
 	for (const device of fsx.listUsbDevices()) {
@@ -7922,7 +7922,7 @@ function classifyPci(fsx) {
 * Returns `null` only when no Coral was found at all; a present-but-unusable
 * Coral is reported with its typed reason, never as absent (D393/D315).
 */
-function classifyCoralAccelerator(fsx) {
+function classifyCoralAccelerator(fsx, delegateHost = currentDelegateHost()) {
 	const usb = countUsbCorals(fsx);
 	const pci = classifyPci(fsx);
 	const units = [];
@@ -7953,8 +7953,10 @@ function classifyCoralAccelerator(fsx) {
 		type: "coral-edgetpu",
 		units
 	};
-	const libPath = process.env["CAMSTACK_EDGETPU_LIB"] ?? DEFAULT_EDGETPU_LIB;
-	if (fsx.exists(libPath)) return {
+	if (chooseEdgetpuDelegate({
+		...delegateHost,
+		exists: (p) => fsx.exists(p)
+	}) !== null) return {
 		type: "coral-edgetpu",
 		units: [{
 			bus: "usb",
@@ -8963,6 +8965,19 @@ var AddonDepsManager = class {
 		const pythonPath = await this.ensurePython();
 		if (!pythonPath) throw new Error("Cannot install Python requirements: Python is not available");
 		await singleFlight(this.depsDir, "python-pip", () => 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 (!declaresEdgetpuDelegate(fs$1.readFileSync(requirementsFile, "utf8"))) return;
+		await singleFlight(this.depsDir, "edgetpu-delegate", () => ensureEdgetpuDelegate(this.nodeRoot, this.logger));
 	}
 	getDepsDir() {
 		return this.depsDir;

package/dist/addon-utils.mjs

@@ -1,3 +1,3 @@
-import { C as isModelDownloaded, S as isModelDownloadHttpError, _ as downloadFile, a as startEventLoopStallMonitor, f as ModelDownloadService, g as deleteModelFromDisk, h as collectModelFiles, i as attributeStall, l as parseRangeHeader, m as adoptModelRevisions, n as STALL_REPORT_MS, o as createFileDataPlaneHandler, p as ModelDownloadHttpError, r as STALL_TICK_MS, s as contentTypeFor, t as CustomActionRegistry, w as resolveFormatRevision, x as getModelFilePath, y as ensureModel } from "./custom-action-registry-stpC3Zy-.mjs";
+import { C as isModelDownloaded, S as isModelDownloadHttpError, _ as downloadFile, a as startEventLoopStallMonitor, f as ModelDownloadService, g as deleteModelFromDisk, h as collectModelFiles, i as attributeStall, l as parseRangeHeader, m as adoptModelRevisions, n as STALL_REPORT_MS, o as createFileDataPlaneHandler, p as ModelDownloadHttpError, r as STALL_TICK_MS, s as contentTypeFor, t as CustomActionRegistry, w as resolveFormatRevision, x as getModelFilePath, y as ensureModel } from "./custom-action-registry-DStvrQKI.mjs";
 import { i as renderCourtesyOverlayJpeg, n as courtesyCacheKey, r as renderCourtesyJpeg, t as COURTESY_DEFAULT_WIDTH } from "./snapshot-courtesy-CyFs1M3I.mjs";
 export { COURTESY_DEFAULT_WIDTH, CustomActionRegistry, ModelDownloadHttpError, ModelDownloadService, STALL_REPORT_MS, STALL_TICK_MS, adoptModelRevisions, attributeStall, collectModelFiles, contentTypeFor, courtesyCacheKey, createFileDataPlaneHandler, deleteModelFromDisk, downloadFile, ensureModel, getModelFilePath, isModelDownloadHttpError, isModelDownloaded, parseRangeHeader, renderCourtesyJpeg, renderCourtesyOverlayJpeg, resolveFormatRevision, startEventLoopStallMonitor };

package/dist/builtins/addon-pages-aggregator/addon-pages-aggregator.addon.mjs

@@ -2,7 +2,7 @@ import { Ta as EventCategory, ni as BaseAddon, ti as errMsg, yt as addonPagesCap
 import { t as settleSourcesWithTimeout } from "../../settle-sources-CDtNC8ub.mjs";
 import { createHash, randomUUID } from "node:crypto";
 import * as path$1 from "node:path";
-import * as fs from "node:fs";
+import * as fs$1 from "node:fs";
 //#region src/builtins/addon-pages-aggregator/dedupe-pages.ts
 /** Stable identity for an addon page, independent of which node reported it. */
 function pageKey(info) {
@@ -211,11 +211,11 @@ var AddonPagesAggregatorAddon = class extends BaseAddon {
 		const bundlePath = this.resolveBundlePath(addonId, bundle);
 		if (bundlePath === null) return `/api/addon-pages/${addonId}/${bundle}?v=${Math.floor(Date.now())}`;
 		try {
-			const stat = fs.statSync(bundlePath);
+			const stat = fs$1.statSync(bundlePath);
 			const cacheKey = `${bundlePath}:${stat.size}:${stat.mtimeMs}`;
 			let v = this.bundleHashCache.get(cacheKey);
 			if (v === void 0) {
-				v = createHash("sha1").update(fs.readFileSync(bundlePath)).digest("hex").slice(0, 12);
+				v = createHash("sha1").update(fs$1.readFileSync(bundlePath)).digest("hex").slice(0, 12);
 				this.bundleHashCache.set(cacheKey, v);
 			}
 			return `/api/addon-pages/${addonId}/${bundle}?v=${v}`;

package/dist/builtins/addon-widgets-aggregator/addon-widgets-aggregator.addon.mjs

@@ -2,7 +2,7 @@ import { Ta as EventCategory, ni as BaseAddon, ti as errMsg, xt as addonWidgetsC
 import { t as settleSourcesWithTimeout } from "../../settle-sources-CDtNC8ub.mjs";
 import { createHash, randomUUID } from "node:crypto";
 import * as path$1 from "node:path";
-import * as fs from "node:fs";
+import * as fs$1 from "node:fs";
 //#region src/builtins/addon-widgets-aggregator/addon-widgets-aggregator.addon.ts
 /**
 * Addon Widgets Aggregator — hub-local builtin that owns the singleton
@@ -204,9 +204,9 @@ var AddonWidgetsAggregatorAddon = class extends BaseAddon {
 		if (entryPath === null) return String(Math.floor(Date.now()));
 		try {
 			const dir = path$1.dirname(entryPath);
-			const files = fs.readdirSync(dir).filter((f) => fs.statSync(path$1.join(dir, f)).isFile()).sort();
+			const files = fs$1.readdirSync(dir).filter((f) => fs$1.statSync(path$1.join(dir, f)).isFile()).sort();
 			const cacheKey = `${dir}#${files.map((f) => {
-				const s = fs.statSync(path$1.join(dir, f));
+				const s = fs$1.statSync(path$1.join(dir, f));
 				return `${f}:${s.size}:${s.mtimeMs}`;
 			}).join("|")}`;
 			const cached = this.bundleHashCache.get(cacheKey);
@@ -214,7 +214,7 @@ var AddonWidgetsAggregatorAddon = class extends BaseAddon {
 			const hash = createHash("sha1");
 			for (const f of files) {
 				hash.update(f);
-				hash.update(fs.readFileSync(path$1.join(dir, f)));
+				hash.update(fs$1.readFileSync(path$1.join(dir, f)));
 			}
 			const digest = hash.digest("hex").slice(0, 12);
 			this.bundleHashCache.set(cacheKey, digest);

package/dist/builtins/backup-orchestrator/backup-orchestrator.addon.mjs

@@ -1,10 +1,10 @@
 import { Dt as backupCapability, Or as storageOccupancyCapability, Ta as EventCategory, Un as mayWriteToLocation, ba as toNodeId, ni as BaseAddon, oa as nodePin } from "../../dist-Wy8cTxg6.mjs";
 import { t as require_read_all_rows } from "../../read-all-rows-TaPqdWNF.mjs";
-import { _ as backupRecordStoresOf, a as BackupSnapshotRefusedError, d as ENCRYPTED_BACKUP_SUFFIX, f as generateBackupKeyPair, g as backupOrchestratorRecordKinds, i as BackupCancelledError, l as BackupKeyFormatError, m as parseBackupSecretKey, n as precheckRestoreKey, o as DEFAULT_BACKUP_DATABASES, p as parseBackupPublicKey, r as prepareRestoreArchive, s as SystemBackupService } from "../../restore-archive-CmP-iiG9.mjs";
+import { _ as backupRecordStoresOf, a as BackupSnapshotRefusedError, d as ENCRYPTED_BACKUP_SUFFIX, f as generateBackupKeyPair, g as backupOrchestratorRecordKinds, i as BackupCancelledError, l as BackupKeyFormatError, m as parseBackupSecretKey, n as precheckRestoreKey, o as DEFAULT_BACKUP_DATABASES, p as parseBackupPublicKey, r as prepareRestoreArchive, s as SystemBackupService } from "../../restore-archive-CM23Pq9B.mjs";
 import { randomUUID } from "node:crypto";
 import * as fsp from "node:fs/promises";
 import * as path$1 from "node:path";
-import * as fs from "node:fs";
+import * as fs$1 from "node:fs";
 //#region src/builtins/backup-orchestrator/backup-databases.ts
 /** Stable id of the seeded weekly schedule. */
 var WEEKLY_SCHEDULE_ID = "weekly-events-history";
@@ -1232,7 +1232,7 @@ async function downloadArchiveToCache(input) {
 		location: input.locationId,
 		relativePath: input.filename
 	});
-	const writeStream = fs.createWriteStream(input.cachePath);
+	const writeStream = fs$1.createWriteStream(input.cachePath);
 	let offset = 0;
 	try {
 		while (offset < sizeBytes) {
@@ -2932,7 +2932,7 @@ var BackupOrchestratorAddon = class extends BaseAddon {
 		});
 		try {
 			let offset = 0;
-			const stream = fs.createReadStream(input.cachePath, { highWaterMark: UPLOAD_CHUNK_BYTES });
+			const stream = fs$1.createReadStream(input.cachePath, { highWaterMark: UPLOAD_CHUNK_BYTES });
 			for await (const rawChunk of stream) {
 				if (input.signal?.aborted) {
 					stream.destroy();

package/dist/builtins/local-auth/local-auth.addon.mjs

@@ -9,7 +9,7 @@ import * as crypto$1 from "node:crypto";
 import { X509Certificate, createHash, randomUUID, timingSafeEqual } from "node:crypto";
 import nodeCrypto from "crypto";
 import * as path$1 from "node:path";
-import * as fs from "node:fs";
+import * as fs$1 from "node:fs";
 //#region src/auth/parse-record.ts
 function parseRecord$2(kind, schema, data) {
 	try {
@@ -12347,8 +12347,8 @@ var LocalAuthAddon = class extends BaseAddon {
 					users: this.userManager,
 					dataDir: this.ctx.nodeDataDir,
 					fs: {
-						exists: (filePath) => fs.existsSync(filePath),
-						remove: (filePath) => fs.rmSync(filePath, { force: true })
+						exists: (filePath) => fs$1.existsSync(filePath),
+						remove: (filePath) => fs$1.rmSync(filePath, { force: true })
 					},
 					logger: this.ctx.logger
 				});

package/dist/builtins/native-metrics/native-metrics.addon.js

@@ -1063,6 +1063,36 @@ var NODE_GPU_TEMPERATURE_KEY = keyOf("node-gpu-temperature");
 var NODE_CONTAINER_CURRENT_KEY = keyOf("container-current-mib");
 keyOf("process-cpu-percent");
 keyOf("process-rss-mib");
+/**
+* The per-runner series are downsampled to device-history's point cadence:
+* one point per series per this many ms, sustained. Process snapshots arrive
+* at the load-series cadence (5–60 s, `load-series-config.ts`), and at 5 s
+* writing each one has every other batch refused whole for `rate`.
+*
+* These two numbers MIRROR `RECORD_MIN_INTERVAL_MS` / `RECORD_RATE_SLACK_MS`
+* of the ingest door (`device-history/ingest/producer-ingest.ts`) — a builtin
+* does not import another — and `node-metrics-history-cadence.spec.ts` pins
+* them equal, so the door moving fails a spec instead of a day of history.
+*/
+var RUNNER_SAMPLE_MIN_INTERVAL_MS = 1e4;
+var RUNNER_SAMPLE_RATE_SLACK_MS = 1e3;
+/** True when the door would take a point at `ts` after `slot`. */
+function sampleIsDue(slot, ts) {
+	if (slot === void 0 || ts < slot.lastTs) return true;
+	return ts >= slot.nextDue - RUNNER_SAMPLE_RATE_SLACK_MS;
+}
+/** The slot after a batch at `ts` was accepted — the door's own grid rule. */
+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",
@@ -1153,6 +1183,8 @@ var NodeMetricsHistoryRecorder = class {
 	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) {
@@ -1172,6 +1204,7 @@ var NodeMetricsHistoryRecorder = class {
 	}
 	/** 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
@@ -1215,7 +1248,7 @@ var NodeMetricsHistoryRecorder = class {
 			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) {
@@ -1245,8 +1278,8 @@ var NodeMetricsHistoryRecorder = class {
 		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) {
@@ -1257,12 +1290,14 @@ var NodeMetricsHistoryRecorder = class {
 					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) {

package/dist/builtins/native-metrics/native-metrics.addon.mjs

@@ -3,7 +3,7 @@ import { access, readFile, readdir } from "node:fs/promises";
 import { promisify } from "node:util";
 import * as os$1 from "node:os";
 import { platform } from "node:os";
-import * as fs from "node:fs";
+import * as fs$1 from "node:fs";
 import { constants, readFileSync } from "node:fs";
 import { execFile, execFileSync } from "node:child_process";
 //#region src/builtins/native-metrics/cgroup-memory.ts
@@ -1058,6 +1058,36 @@ var NODE_GPU_TEMPERATURE_KEY = keyOf("node-gpu-temperature");
 var NODE_CONTAINER_CURRENT_KEY = keyOf("container-current-mib");
 keyOf("process-cpu-percent");
 keyOf("process-rss-mib");
+/**
+* The per-runner series are downsampled to device-history's point cadence:
+* one point per series per this many ms, sustained. Process snapshots arrive
+* at the load-series cadence (5–60 s, `load-series-config.ts`), and at 5 s
+* writing each one has every other batch refused whole for `rate`.
+*
+* These two numbers MIRROR `RECORD_MIN_INTERVAL_MS` / `RECORD_RATE_SLACK_MS`
+* of the ingest door (`device-history/ingest/producer-ingest.ts`) — a builtin
+* does not import another — and `node-metrics-history-cadence.spec.ts` pins
+* them equal, so the door moving fails a spec instead of a day of history.
+*/
+var RUNNER_SAMPLE_MIN_INTERVAL_MS = 1e4;
+var RUNNER_SAMPLE_RATE_SLACK_MS = 1e3;
+/** True when the door would take a point at `ts` after `slot`. */
+function sampleIsDue(slot, ts) {
+	if (slot === void 0 || ts < slot.lastTs) return true;
+	return ts >= slot.nextDue - RUNNER_SAMPLE_RATE_SLACK_MS;
+}
+/** The slot after a batch at `ts` was accepted — the door's own grid rule. */
+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",
@@ -1148,6 +1178,8 @@ var NodeMetricsHistoryRecorder = class {
 	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) {
@@ -1167,6 +1199,7 @@ var NodeMetricsHistoryRecorder = class {
 	}
 	/** 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
@@ -1210,7 +1243,7 @@ var NodeMetricsHistoryRecorder = class {
 			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) {
@@ -1240,8 +1273,8 @@ var NodeMetricsHistoryRecorder = class {
 		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) {
@@ -1252,12 +1285,14 @@ var NodeMetricsHistoryRecorder = class {
 					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) {
@@ -1607,7 +1642,7 @@ var NativeMetricsProvider = class {
 		let swapUsedBytes = 0;
 		let swapTotalBytes = 0;
 		if (IS_LINUX) try {
-			const meminfo = fs.readFileSync("/proc/meminfo", "utf-8");
+			const meminfo = fs$1.readFileSync("/proc/meminfo", "utf-8");
 			const swapTotal = parseInt(meminfo.match(/SwapTotal:\s+(\d+)/)?.[1] ?? "0", 10) * 1024;
 			const swapFree = parseInt(meminfo.match(/SwapFree:\s+(\d+)/)?.[1] ?? "0", 10) * 1024;
 			swapTotalBytes = swapTotal;
@@ -1685,7 +1720,7 @@ function sampleMacMemory(provider) {
 }
 function getDiskSpaceInternal(dirPath) {
 	return new Promise((resolve, reject) => {
-		fs.statfs(dirPath, (err, stats) => {
+		fs$1.statfs(dirPath, (err, stats) => {
 			if (err) return reject(err);
 			const totalBytes = stats.blocks * stats.bsize;
 			const availableBytes = stats.bavail * stats.bsize;
@@ -1703,7 +1738,7 @@ function getDiskSpaceInternal(dirPath) {
 async function takeDiskIoSnapshot() {
 	const now = Date.now();
 	if (IS_LINUX) try {
-		const data = fs.readFileSync("/proc/diskstats", "utf-8");
+		const data = fs$1.readFileSync("/proc/diskstats", "utf-8");
 		let readOps = 0, readBytes = 0, writeOps = 0, writeBytes = 0;
 		for (const line of data.split("\n")) {
 			const parts = line.trim().split(/\s+/);
@@ -1734,7 +1769,7 @@ async function takeDiskIoSnapshot() {
 async function takeNetworkIoSnapshot() {
 	const now = Date.now();
 	if (IS_LINUX) try {
-		const data = fs.readFileSync("/proc/net/dev", "utf-8");
+		const data = fs$1.readFileSync("/proc/net/dev", "utf-8");
 		let rxBytes = 0, txBytes = 0, rxPackets = 0, txPackets = 0, rxErrors = 0, txErrors = 0;
 		for (const line of data.split("\n")) {
 			const match = line.match(/^\s*(\w+):\s+(.+)$/);
@@ -1795,7 +1830,7 @@ async function takeNetworkIoSnapshot() {
 }
 async function getCpuTemperatureInternal() {
 	if (IS_LINUX) for (const p of ["/sys/class/thermal/thermal_zone0/temp", "/sys/class/hwmon/hwmon0/temp1_input"]) try {
-		const raw = fs.readFileSync(p, "utf-8").trim();
+		const raw = fs$1.readFileSync(p, "utf-8").trim();
 		const millideg = parseInt(raw, 10);
 		if (!isNaN(millideg)) return Math.round(millideg / 100) / 10;
 	} catch {
@@ -1846,10 +1881,10 @@ function getProcessResources() {
 	let threadCount = 0;
 	if (IS_LINUX) {
 		try {
-			openFds = fs.readdirSync(`/proc/${process.pid}/fd`).length;
+			openFds = fs$1.readdirSync(`/proc/${process.pid}/fd`).length;
 		} catch {}
 		try {
-			const match = fs.readFileSync(`/proc/${process.pid}/status`, "utf-8").match(/Threads:\s+(\d+)/);
+			const match = fs$1.readFileSync(`/proc/${process.pid}/status`, "utf-8").match(/Threads:\s+(\d+)/);
 			if (match) threadCount = parseInt(match[1], 10);
 		} catch {}
 	}
@@ -1864,7 +1899,7 @@ function getProcessResources() {
 function getPressure(resource) {
 	if (!IS_LINUX) return null;
 	try {
-		const data = fs.readFileSync(`/proc/pressure/${resource}`, "utf-8");
+		const data = fs$1.readFileSync(`/proc/pressure/${resource}`, "utf-8");
 		const parseLine = (prefix) => {
 			const match = data.match(new RegExp(`${prefix} avg10=(\\d+\\.\\d+) avg60=(\\d+\\.\\d+) avg300=(\\d+\\.\\d+)`));
 			if (!match) return null;

package/dist/builtins/native-metrics/node-metrics-history-recorder.d.ts

@@ -45,6 +45,19 @@ export declare const NODE_PROCESS_RSS_KEY: MetricsKey<"process-rss-mib">;
 * point closer than 10 s to the previous one of its series (`rate`).
 */
 export declare const NODE_TOTALS_MIN_INTERVAL_MS = 15e3;
+/**
+* The per-runner series are downsampled to device-history's point cadence:
+* one point per series per this many ms, sustained. Process snapshots arrive
+* at the load-series cadence (5–60 s, `load-series-config.ts`), and at 5 s
+* writing each one has every other batch refused whole for `rate`.
+*
+* These two numbers MIRROR `RECORD_MIN_INTERVAL_MS` / `RECORD_RATE_SLACK_MS`
+* of the ingest door (`device-history/ingest/producer-ingest.ts`) — a builtin
+* does not import another — and `node-metrics-history-cadence.spec.ts` pins
+* them equal, so the door moving fails a spec instead of a day of history.
+*/
+export declare const RUNNER_SAMPLE_MIN_INTERVAL_MS = 1e4;
+export declare const RUNNER_SAMPLE_RATE_SLACK_MS = 1e3;
 export interface NodeHistoryPoint {
 	readonly key: string;
 	readonly subject: {
@@ -107,6 +120,8 @@ export declare class NodeMetricsHistoryRecorder {
 	private readonly deps;
 	private declared;
 	private readonly lastTotalsAt;
+	/** Per node: the door's slot for the per-runner batch (see {@link sampleIsDue}). */
+	private readonly sampleSlots;
 	/** A not-ready skip was logged and device-history has not been ready since. */
 	private waitLogged;
 	constructor(deps: NodeMetricsHistoryRecorderDeps);

package/dist/builtins/platform-probe/coral-accelerators.d.ts

@@ -1,4 +1,5 @@
 import type { CoralInfo } from "@camstack/types";
+import { type EdgetpuDelegateLookup } from "@camstack/types/node";
 /**
 * Filesystem seam for Coral Edge TPU detection (USB and PCIe/M.2) — mirrors
 * the `AcceleratorFs` pattern in `intel-accelerators.ts` so the classifier
@@ -21,6 +22,14 @@ export interface CoralFs {
 	exists(path: string): boolean;
 }
 /**
+* Where this node would find the libedgetpu delegate — the same lookup the
+* Python pool runs (`edgetpu_device.edgetpu_library_path`): the
+* `CAMSTACK_EDGETPU_LIB` override, the copy the deps downloader staged under
+* `<CAMSTACK_DATA>/deps/edgetpu/lib/`, the hub's historical
+* `/data/deps/edgetpu/lib/libedgetpu.so.1`.
+*/
+export type EdgetpuDelegateHost = Omit<EdgetpuDelegateLookup, "exists">;
+/**
 * Detect Coral Edge TPUs on USB and PCIe/M.2.
 *
 * - USB: every matching USB device counts (multiple Corals run concurrently).
@@ -34,6 +43,6 @@ export interface CoralFs {
 * Returns `null` only when no Coral was found at all; a present-but-unusable
 * Coral is reported with its typed reason, never as absent (D393/D315).
 */
-export declare function classifyCoralAccelerator(fsx: CoralFs): CoralInfo | null;
+export declare function classifyCoralAccelerator(fsx: CoralFs, delegateHost?: EdgetpuDelegateHost): CoralInfo | null;
 /** The real filesystem view: `/sys` for enumeration, `/dev` for access. */
 export declare const nodeCoralFs: CoralFs;

package/dist/builtins/platform-probe/index.js

@@ -4,7 +4,7 @@ Object.defineProperties(exports, {
 });
 const require_chunk = require("../../chunk-Cek0wNdY.js");
 const require_dist = require("../../dist-Bn-RNanh.js");
-const require_coral_accelerators = require("../../coral-accelerators-Bi_c3Rft.js");
+const require_coral_accelerators = require("../../coral-accelerators-oUXmmbc2.js");
 let node_util = require("node:util");
 let node_os = require("node:os");
 node_os = require_chunk.__toESM(node_os);
@@ -329,9 +329,12 @@ var PlatformScorer = class {
 	* lookup (dev / agent environments where Python is on PATH).
 	*/
 	embeddedPythonPath;
-	constructor(logger = noopLogger, embeddedPythonPath = null) {
+	/** Where the Coral scan reads `/sys` and `/dev` (the host's, unless a spec fakes one). */
+	coralFs;
+	constructor(logger = noopLogger, embeddedPythonPath = null, coralFs = require_coral_accelerators.nodeCoralFs) {
 		this.logger = logger;
 		this.embeddedPythonPath = embeddedPythonPath;
+		this.coralFs = coralFs;
 	}
 	/**
 	* Probe hardware + derive scores from pure rules and score all backend combos.
@@ -414,7 +417,7 @@ var PlatformScorer = class {
 		} });
 		let gpu = null;
 		let npu = null;
-		const coral = require_coral_accelerators.classifyCoralAccelerator(require_coral_accelerators.nodeCoralFs);
+		const coral = require_coral_accelerators.classifyCoralAccelerator(this.coralFs);
 		if (coral) {
 			if ((coral.units ?? []).length > 0) this.logger.info("Coral Edge TPU detected", { meta: { units: coral.units } });
 			for (const unavailable of coral.unavailable ?? []) this.logger.warn("Coral Edge TPU present but unusable", { meta: {