@camstack/system 1.2.470 → 1.2.472

package/dist/addon-runner.js

@@ -7447,7 +7447,7 @@ function toKebab(name) {
 	return name.replace(/[A-Z]/g, (m, i) => (i > 0 ? "-" : "") + m.toLowerCase());
 }
 /**
-* Parse an `op.path` (e.g. `"pipelineExecutor.getDefaultSteps"`) into
+* Parse an `op.path` (e.g. `"pipelineExecutor.getAvailableEngines"`) into
 * the capability name (kebab-case) and the method name.
 */
 function parsePath(path) {
@@ -7893,14 +7893,34 @@ function currentDelegateHost() {
 		override: process.env[_camstack_types_node.EDGETPU_LIB_ENV]
 	};
 }
-function countUsbCorals(devices, fsx) {
-	let count = 0;
+/** usbfs names a device `/dev/bus/usb/<busnum>/<devnum>`, each zero-padded to three digits. */
+function usbDeviceNode(device, fsx) {
+	const bus = Number.parseInt(fsx.readUsbAttr(device, "busnum"), 10);
+	const dev = Number.parseInt(fsx.readUsbAttr(device, "devnum"), 10);
+	if (!Number.isInteger(bus) || !Number.isInteger(dev) || bus <= 0 || dev <= 0) return null;
+	return `/dev/bus/usb/${String(bus).padStart(3, "0")}/${String(dev).padStart(3, "0")}`;
+}
+/**
+* USB units: sysfs is the HOST's view — a container whose `/dev/bus/usb`
+* mapping was removed still lists the stick under `/sys/bus/usb/devices`. A
+* listed Coral is usable only when its usbfs device node is in this process's
+* view AND opens read/write; otherwise it is present but not accessible.
+*/
+function classifyUsb(devices, fsx) {
+	let usable = 0;
+	const inaccessibleNodes = [];
 	for (const device of devices) {
 		const vendor = fsx.readUsbAttr(device, "idVendor").toLowerCase();
 		const product = fsx.readUsbAttr(device, "idProduct").toLowerCase();
-		if (CORAL_USB_IDS.some((id) => id.vendor === vendor && id.product === product)) count++;
+		if (!CORAL_USB_IDS.some((id) => id.vendor === vendor && id.product === product)) continue;
+		const node = usbDeviceNode(device, fsx);
+		if (node !== null && fsx.exists(node) && fsx.canOpen(node)) usable++;
+		else inaccessibleNodes.push(node ?? `/sys/bus/usb/devices/${device}`);
 	}
-	return count;
+	return {
+		usable,
+		inaccessibleNodes
+	};
 }
 function countPciCorals(fsx) {
 	let count = 0;
@@ -7943,7 +7963,9 @@ function classifyCoralAccelerator(fsx, delegateHost = currentDelegateHost()) {
 /**
 * Detect Coral Edge TPUs on USB and PCIe/M.2, with the evidence that decided.
 *
-* - USB: every matching USB device counts (multiple Corals run concurrently).
+* - USB: every matching USB device counts (multiple Corals run concurrently),
+*   usable only if its `/dev/bus/usb/<BBB>/<DDD>` node opens read/write — a
+*   listed stick whose node is missing or refused is `device-not-accessible`.
 * - PCIe: the apex driver's units, each usable only if its device node opens;
 *   a Coral PCI function the driver did not bind is `driver-missing`.
 * - Fallback: when the USB bus is NOT OBSERVABLE (`/sys/bus/usb/devices`
@@ -7960,18 +7982,28 @@ function classifyCoralAccelerator(fsx, delegateHost = currentDelegateHost()) {
 function detectCoralAccelerator(fsx, delegateHost = currentDelegateHost()) {
 	const usbDevices = fsx.listUsbDevices();
 	const usbBus = usbDevices !== null && usbDevices.length > 0 ? "observed" : "unobservable";
-	const usb = usbDevices === null ? 0 : countUsbCorals(usbDevices, fsx);
+	const usb = usbDevices === null ? {
+		usable: 0,
+		inaccessibleNodes: []
+	} : classifyUsb(usbDevices, fsx);
+	const usbSeen = usb.usable + usb.inaccessibleNodes.length;
+	const inaccessibleUsbNodes = usb.inaccessibleNodes;
 	const pci = classifyPci(fsx);
 	const units = [];
-	if (usb > 0) units.push({
+	if (usb.usable > 0) units.push({
 		bus: "usb",
-		count: usb
+		count: usb.usable
 	});
 	if (pci.usable > 0) units.push({
 		bus: "pci",
 		count: pci.usable
 	});
 	const unavailable = [];
+	if (usb.inaccessibleNodes.length > 0) unavailable.push({
+		bus: "usb",
+		count: usb.inaccessibleNodes.length,
+		reason: "device-not-accessible"
+	});
 	if (pci.driverMissing > 0) unavailable.push({
 		bus: "pci",
 		count: pci.driverMissing,
@@ -7992,7 +8024,8 @@ function detectCoralAccelerator(fsx, delegateHost = currentDelegateHost()) {
 			units
 		},
 		usbBus,
-		decidedBy: usb > 0 ? "usb-ids" : "pci"
+		decidedBy: usbSeen > 0 ? "usb-ids" : "pci",
+		inaccessibleUsbNodes
 	};
 	if (usbBus === "unobservable" && (0, _camstack_types_node.chooseEdgetpuDelegate)({
 		...delegateHost,
@@ -8006,12 +8039,14 @@ function detectCoralAccelerator(fsx, delegateHost = currentDelegateHost()) {
 			}]
 		},
 		usbBus,
-		decidedBy: "delegate-fallback"
+		decidedBy: "delegate-fallback",
+		inaccessibleUsbNodes
 	};
 	return {
 		info: null,
 		usbBus,
-		decidedBy: "none"
+		decidedBy: "none",
+		inaccessibleUsbNodes
 	};
 }
 function safeListOrNull(dir) {
@@ -8059,6 +8094,148 @@ var nodeCoralFs = {
 	}
 };
 //#endregion
+//#region src/kernel/hwaccel/vaapi-init-probe.ts
+/**
+* Can libva initialise the VA driver on this node's render node? (D926)
+*
+* Measured 2026-10-23 (intel-1.2.509, hub + little-unraid): Intel's iHD 25.2.4
+* exports only `__vaDriverInit_1_22`, the container's Ubuntu libva 2.20 looks
+* for `_1_20`, and `vaInitialize` failed — while the resolver kept offering
+* `qsv, vaapi`. Every session tried, failed and fell back to software: 722
+* `hwaccel 'vaapi' failed` lines a day and nothing that named the cause.
+*
+* One `vainfo --display drm --device <node>` per process answers it. A failure
+* reads the driver's exported `__vaDriverInit_1_N` so the verdict names the gap
+* (`driver iHD needs VA-API >= 1.22, libva has 1.20`). No `vainfo` on the host
+* (a bare install) is `unknown` — the resolver then behaves as it always did.
+*/
+var VAINFO_TIMEOUT_MS = 1e4;
+var INIT_SYMBOL = /__vaDriverInit_(\d+)_(\d+)/g;
+var VA_API_VERSION = /VA-API version:? (\d+)\.(\d+)/;
+var DRIVER_OPEN = /Trying to open (\S+_drv_video\.so)/g;
+function newestInitVersion(symbols) {
+	let best = null;
+	for (const symbol of symbols) for (const m of symbol.matchAll(INIT_SYMBOL)) {
+		const v = {
+			major: Number(m[1]),
+			minor: Number(m[2])
+		};
+		if (!best || v.major > best.major || v.major === best.major && v.minor > best.minor) best = v;
+	}
+	return best;
+}
+function lastMatch(text, re) {
+	let last = null;
+	for (const m of text.matchAll(re)) last = m[1] ?? null;
+	return last;
+}
+function lastLine(text) {
+	const lines = text.split("\n").map((l) => l.trim()).filter((l) => l.length > 0);
+	return lines[lines.length - 1] ?? "no output";
+}
+function driverName(driverPath) {
+	if (!driverPath) return "unknown";
+	return (0, node_path.basename)(driverPath).replace(/_drv_video\.so$/, "");
+}
+/** Classify one vainfo run plus the driver's exported init symbols. Pure. */
+function classifyVainfo(run, driverSymbols) {
+	const va = VA_API_VERSION.exec(run.output);
+	const vaApiVersion = va ? `${va[1]}.${va[2]}` : null;
+	const driverPath = lastMatch(run.output, DRIVER_OPEN);
+	const needs = newestInitVersion(driverSymbols);
+	const driverNeedsVaApi = needs ? `${needs.major}.${needs.minor}` : null;
+	const base = {
+		vaApiVersion,
+		driverPath,
+		driverNeedsVaApi
+	};
+	if (run.spawnError !== null) return {
+		...base,
+		state: "unknown",
+		summary: `vaapi: unknown (vainfo not run: ${run.spawnError})`
+	};
+	if (run.exitCode === 0) return {
+		...base,
+		state: "ok",
+		summary: `vaapi: ok (VA-API ${vaApiVersion ?? "?"}, driver ${driverName(driverPath)})`
+	};
+	const reason = needs !== null && va !== null && (needs.major > Number(va[1]) || needs.major === Number(va[1]) && needs.minor > Number(va[2])) ? `driver ${driverName(driverPath)} needs VA-API >= ${driverNeedsVaApi}, libva has ${vaApiVersion}` : lastLine(run.output);
+	return {
+		...base,
+		state: "init-failed",
+		summary: `vaapi: init-failed (${reason})`
+	};
+}
+/** Run `vainfo` against one render node; never throws. */
+function runVainfo(renderNode) {
+	return new Promise((resolve) => {
+		(0, node_child_process.execFile)("vainfo", [
+			"--display",
+			"drm",
+			"--device",
+			renderNode
+		], {
+			timeout: VAINFO_TIMEOUT_MS,
+			encoding: "utf8"
+		}, (err, stdout, stderr) => {
+			const output = `${stdout}\n${stderr}`;
+			if (err === null) {
+				resolve({
+					exitCode: 0,
+					output,
+					spawnError: null
+				});
+				return;
+			}
+			const code = err.code;
+			if (typeof code === "number") {
+				resolve({
+					exitCode: code,
+					output,
+					spawnError: null
+				});
+				return;
+			}
+			resolve({
+				exitCode: null,
+				output,
+				spawnError: code ?? (err.killed ? "timeout" : err.message)
+			});
+		});
+	});
+}
+/**
+* The `__vaDriverInit_N_M` names in a driver file, streamed (iHD is ~43 MB),
+* with an overlap so a name split across two chunks is still found.
+*/
+function readDriverInitSymbols(driverPath) {
+	return new Promise((resolve) => {
+		const found = /* @__PURE__ */ new Set();
+		let carry = "";
+		const stream = (0, node_fs.createReadStream)(driverPath, {
+			encoding: "latin1",
+			highWaterMark: 64 * 1024
+		});
+		stream.on("data", (chunk) => {
+			const text = carry + String(chunk);
+			for (const m of text.matchAll(INIT_SYMBOL)) if (m.index + m[0].length < text.length) found.add(m[0]);
+			carry = text.slice(-32);
+		});
+		stream.on("error", () => resolve([]));
+		stream.on("end", () => {
+			for (const m of carry.matchAll(INIT_SYMBOL)) found.add(m[0]);
+			resolve([...found].sort());
+		});
+	});
+}
+/** Probe one render node: vainfo, and on failure the driver's init symbols. */
+async function probeVaapiInit(renderNode) {
+	const run = await runVainfo(renderNode);
+	if (run.spawnError !== null || run.exitCode === 0) return classifyVainfo(run, []);
+	const driverPath = lastMatch(run.output, DRIVER_OPEN);
+	return classifyVainfo(run, driverPath ? await readDriverInitSymbols(driverPath) : []);
+}
+//#endregion
 //#region src/kernel/hwaccel/hwaccel-resolver.ts
 /**
 * Platform-probe for hardware video decode acceleration.
@@ -8128,7 +8305,23 @@ function probePlatform() {
 		coral: classifyCoralAccelerator(nodeCoralFs)
 	};
 }
-function pickBackendsForPlatform(signals) {
+/** The backends that open their device through libva on Linux. */
+var LIBVA_BACKENDS = ["vaapi", "qsv"];
+/**
+* The preference list for these signals. A `vaapi` verdict of `init-failed`
+* (libva cannot initialise the driver — D926) removes every libva-backed
+* backend and names the cause in the rationale; `ok`, `unknown` or `null`
+* change nothing.
+*/
+function pickBackendsForPlatform(signals, vaapi = null) {
+	const res = pickBackendsFromSignals(signals);
+	if (signals.platform !== "linux" || vaapi?.state !== "init-failed") return res;
+	return {
+		preferred: res.preferred.filter((b) => !LIBVA_BACKENDS.includes(b)),
+		rationale: `${res.rationale} ${vaapi.summary} — vaapi/qsv withheld, decode runs in software.`
+	};
+}
+function pickBackendsFromSignals(signals) {
 	switch (signals.platform) {
 		case "darwin": return {
 			preferred: ["videotoolbox"],
@@ -8189,13 +8382,49 @@ function resolveHwAccel(prefer) {
 	};
 	return pickBackendsForPlatform(probePlatform());
 }
+var RENDER_NODE = "/dev/dri/renderD128";
+/** Process-wide: the VA init failure is logged once per process, not per resolver. */
+var PROCESS_VAAPI_REPORT = { reported: false };
+/** Process-wide: hub-main builds one resolver per in-process addon; vainfo runs once. */
+var PROCESS_VAAPI_PROBES = /* @__PURE__ */ new Map();
+function probeVaapiOncePerProcess(renderNode) {
+	const known = PROCESS_VAAPI_PROBES.get(renderNode);
+	if (known) return known;
+	const probe = probeVaapiInit(renderNode);
+	PROCESS_VAAPI_PROBES.set(renderNode, probe);
+	return probe;
+}
 /**
 * Build the `IKernelHwAccel` provider used to populate `ctx.kernel.hwaccel`.
-* Thin async wrapper around the sync `resolveHwAccel` function so the
-* contract matches the per-node `$hwaccel.resolve` Moleculer action.
-*/
-function createKernelHwAccel() {
-	return { resolve: async (prefer) => resolveHwAccel(prefer) };
+* An auto resolve on a Linux host with a render node asks libva ONCE per
+* provider whether it can initialise the driver (D926); an explicit override
+* is never second-guessed.
+*/
+function createKernelHwAccel(options = {}) {
+	const probeSignals = options.probeSignals ?? probePlatform;
+	const probeVaapi = options.probeVaapi ?? probeVaapiOncePerProcess;
+	const reportOnce = options.reportOnce ?? PROCESS_VAAPI_REPORT;
+	let vaapi = null;
+	const vaapiVerdict = async () => {
+		if (vaapi === null) vaapi = probeVaapi(RENDER_NODE);
+		const status = await vaapi;
+		if (status.state === "init-failed" && !reportOnce.reported) {
+			reportOnce.reported = true;
+			options.logger?.error(`hwaccel: ${status.summary} — vaapi/qsv withheld, decode runs in software`, { meta: {
+				renderNode: RENDER_NODE,
+				vaApiVersion: status.vaApiVersion,
+				driverPath: status.driverPath,
+				driverNeedsVaApi: status.driverNeedsVaApi
+			} });
+		}
+		return status;
+	};
+	return { resolve: async (prefer) => {
+		if (prefer === "none" || prefer !== null && prefer !== void 0 && prefer.length > 0) return resolveHwAccel(prefer);
+		const signals = probeSignals();
+		if (signals.platform !== "linux" || !signals.hasRenderNode) return pickBackendsForPlatform(signals);
+		return pickBackendsForPlatform(signals, await vaapiVerdict());
+	} };
 }
 //#endregion
 //#region src/kernel/inference/inference-resolver.ts
@@ -10540,7 +10769,7 @@ async function buildAddonContext(runtime, declaration, dataDir, options) {
 					value
 				})
 			};
-			const hwaccel = createKernelHwAccel();
+			const hwaccel = createKernelHwAccel({ logger: scopedLogger });
 			const inferenceEngine = createKernelInferenceEngine();
 			return {
 				localNodeId: nodeId,