@camstack/system 1.2.469 → 1.2.471

package/dist/builtins/winston-logging/index.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 const require_chunk = require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-DuBtzSCh.js");
+const require_dist = require("../../dist-BjcWEfRy.js");
 const require_formatter = require("../../formatter-DqAKDlvN.js");
 const require_log_file_read_protocol = require("../../log-file-read-protocol-D0WcLbIV.js");
 let node_path = require("node:path");

package/dist/builtins/winston-logging/index.mjs

@@ -1,4 +1,4 @@
-import { Ln as logDestinationCapability, ei as BaseAddon } from "../../dist-CtVVtyTX.mjs";
+import { Ln as logDestinationCapability, ei as BaseAddon } from "../../dist-5XUG7iYJ.mjs";
 import { t as formatLogLine } from "../../formatter-B7qW8bPJ.mjs";
 import { a as LogFileIndexStore, i as serveRead, n as isFromReader, t as CancelBook } from "../../log-file-read-protocol-B7M3X3bT.mjs";
 import { createRequire } from "node:module";

package/dist/{composition-sources-BGXTiUZm.js → composition-sources-B5uJZXZ1.js}

@@ -1,4 +1,4 @@
-const require_dist = require("./dist-DuBtzSCh.js");
+const require_dist = require("./dist-BjcWEfRy.js");
 //#region src/builtins/core-blocks/composition-sources.ts
 /**
 * Describe what a composition reads and writes for SAVE-time validation

package/dist/{composition-sources-DTdzzyf0.mjs → composition-sources-DRw_vBKH.mjs}

@@ -1,4 +1,4 @@
-import { $r as errMsg, Kr as compositionSourceKey } from "./dist-CtVVtyTX.mjs";
+import { $r as errMsg, Kr as compositionSourceKey } from "./dist-5XUG7iYJ.mjs";
 //#region src/builtins/core-blocks/composition-sources.ts
 /**
 * Describe what a composition reads and writes for SAVE-time validation

package/dist/{constants-md_POijo.mjs → constants-5lA8Z9d8.mjs}

@@ -1,4 +1,4 @@
-import { Ri as buildSecretRef } from "./dist-CtVVtyTX.mjs";
+import { Ri as buildSecretRef } from "./dist-5XUG7iYJ.mjs";
 /** `secret://system/global/meshCaKey` — EC P-256 PKCS#8 PEM of the hub mesh CA. */
 var MESH_CA_KEY_REF = buildSecretRef({
 	owner: "system",

package/dist/{constants-2mPqJjkR.js → constants-CToE4OFp.js}

@@ -1,5 +1,5 @@
 /** `secret://system/global/meshCaKey` — EC P-256 PKCS#8 PEM of the hub mesh CA. */
-var MESH_CA_KEY_REF = require("./dist-DuBtzSCh.js").buildSecretRef({
+var MESH_CA_KEY_REF = require("./dist-BjcWEfRy.js").buildSecretRef({
 	owner: "system",
 	scope: { kind: "global" },
 	fieldPath: "meshCaKey"

package/dist/{coral-accelerators-oUXmmbc2.js → coral-accelerators-BSVsBVzt.js}

@@ -29,14 +29,34 @@ function currentDelegateHost() {
 		override: process.env[_camstack_types_node.EDGETPU_LIB_ENV]
 	};
 }
-function countUsbCorals(fsx) {
-	let count = 0;
-	for (const device of fsx.listUsbDevices()) {
+/** 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;
@@ -70,32 +90,56 @@ function classifyPci(fsx) {
 	};
 }
 /**
-* Detect Coral Edge TPUs on USB and PCIe/M.2.
+* Detect Coral Edge TPUs on USB and PCIe/M.2 — the answer only. See
+* {@link detectCoralAccelerator} for the evidence that decided it.
+*/
+function classifyCoralAccelerator(fsx, delegateHost = currentDelegateHost()) {
+	return detectCoralAccelerator(fsx, delegateHost).info;
+}
+/**
+* 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 NO Coral signal of either bus is visible but the libedgetpu
-*   delegate is installed (a container whose `/sys` USB view is limited), one
-*   USB Coral is assumed — never when a PCI Coral was seen, since the delegate
-*   then says nothing about USB.
+* - Fallback: when the USB bus is NOT OBSERVABLE (`/sys/bus/usb/devices`
+*   missing, unreadable or empty — a macOS desktop, a restricted container)
+*   and no PCI Coral was seen, an installed libedgetpu delegate means one USB
+*   Coral is assumed. A bus that IS readable and lists no Coral id is the
+*   answer: no USB Coral. The delegate stays installed after a stick is
+*   unplugged or moved to another node, so it is evidence only where nothing
+*   better exists (D919).
 *
 * 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, delegateHost = currentDelegateHost()) {
-	const usb = countUsbCorals(fsx);
+function detectCoralAccelerator(fsx, delegateHost = currentDelegateHost()) {
+	const usbDevices = fsx.listUsbDevices();
+	const usbBus = usbDevices !== null && usbDevices.length > 0 ? "observed" : "unobservable";
+	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,
@@ -106,25 +150,47 @@ function classifyCoralAccelerator(fsx, delegateHost = currentDelegateHost()) {
 		count: pci.notAccessible,
 		reason: "device-not-accessible"
 	});
-	if (units.length > 0 || unavailable.length > 0) return unavailable.length > 0 ? {
-		type: "coral-edgetpu",
-		units,
-		unavailable
-	} : {
-		type: "coral-edgetpu",
-		units
+	if (units.length > 0 || unavailable.length > 0) return {
+		info: unavailable.length > 0 ? {
+			type: "coral-edgetpu",
+			units,
+			unavailable
+		} : {
+			type: "coral-edgetpu",
+			units
+		},
+		usbBus,
+		decidedBy: usbSeen > 0 ? "usb-ids" : "pci",
+		inaccessibleUsbNodes
 	};
-	if ((0, _camstack_types_node.chooseEdgetpuDelegate)({
+	if (usbBus === "unobservable" && (0, _camstack_types_node.chooseEdgetpuDelegate)({
 		...delegateHost,
 		exists: (p) => fsx.exists(p)
 	}) !== null) return {
-		type: "coral-edgetpu",
-		units: [{
-			bus: "usb",
-			count: 1
-		}]
+		info: {
+			type: "coral-edgetpu",
+			units: [{
+				bus: "usb",
+				count: 1
+			}]
+		},
+		usbBus,
+		decidedBy: "delegate-fallback",
+		inaccessibleUsbNodes
 	};
-	return null;
+	return {
+		info: null,
+		usbBus,
+		decidedBy: "none",
+		inaccessibleUsbNodes
+	};
+}
+function safeListOrNull(dir) {
+	try {
+		return node_fs.default.readdirSync(dir);
+	} catch {
+		return null;
+	}
 }
 function safeList(dir) {
 	try {
@@ -142,7 +208,7 @@ function safeRead(path) {
 }
 /** The real filesystem view: `/sys` for enumeration, `/dev` for access. */
 var nodeCoralFs = {
-	listUsbDevices: () => safeList("/sys/bus/usb/devices"),
+	listUsbDevices: () => safeListOrNull("/sys/bus/usb/devices"),
 	readUsbAttr: (device, attr) => safeRead(`/sys/bus/usb/devices/${device}/${attr}`),
 	listPciDevices: () => safeList("/sys/bus/pci/devices"),
 	readPciAttr: (device, attr) => safeRead(`/sys/bus/pci/devices/${device}/${attr}`),
@@ -170,6 +236,12 @@ Object.defineProperty(exports, "classifyCoralAccelerator", {
 		return classifyCoralAccelerator;
 	}
 });
+Object.defineProperty(exports, "detectCoralAccelerator", {
+	enumerable: true,
+	get: function() {
+		return detectCoralAccelerator;
+	}
+});
 Object.defineProperty(exports, "nodeCoralFs", {
 	enumerable: true,
 	get: function() {

package/dist/coral-accelerators-BW3OcrLD.mjs

@@ -0,0 +1,231 @@
+import { EDGETPU_LIB_ENV, chooseEdgetpuDelegate, nodeDataRootFromEnv } from "@camstack/types/node";
+import Kt from "node:fs";
+//#region src/builtins/platform-probe/coral-accelerators.ts
+/**
+* Coral USB Edge TPU USB identifiers.
+*
+* The device enumerates as `1a6e:089a` (Global Unichip) BEFORE the libedgetpu
+* firmware loads, then re-enumerates as `18d1:9302` (Google) AFTER. Either id
+* means a Coral is physically attached, so both count as a positive signal.
+*/
+var CORAL_USB_IDS = [{
+	vendor: "1a6e",
+	product: "089a"
+}, {
+	vendor: "18d1",
+	product: "9302"
+}];
+/** The PCIe / M.2 Coral's PCI function id (Global Unichip "Apex"). */
+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+)$/;
+function currentDelegateHost() {
+	return {
+		platform: process.platform,
+		dataDir: nodeDataRootFromEnv(process.env),
+		override: process.env[EDGETPU_LIB_ENV]
+	};
+}
+/** 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)) 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 {
+		usable,
+		inaccessibleNodes
+	};
+}
+function countPciCorals(fsx) {
+	let count = 0;
+	for (const device of fsx.listPciDevices()) {
+		const vendor = fsx.readPciAttr(device, "vendor").toLowerCase();
+		const product = fsx.readPciAttr(device, "device").toLowerCase();
+		if (vendor === CORAL_PCI_VENDOR && product === CORAL_PCI_DEVICE) count++;
+	}
+	return count;
+}
+/**
+* PCIe units: each `/sys/class/apex/apex_N` is a unit the driver bound; it is
+* usable only when `/dev/apex_N` is in this process's view AND opens read/write.
+* PCI functions with the Coral id beyond the bound units have no driver.
+*/
+function classifyPci(fsx) {
+	let usable = 0;
+	let notAccessible = 0;
+	for (const entry of fsx.listApexClass()) {
+		const match = APEX_ENTRY.exec(entry);
+		if (match === null) continue;
+		const node = `/dev/apex_${match[1]}`;
+		if (fsx.exists(node) && fsx.canOpen(node)) usable++;
+		else notAccessible++;
+	}
+	const driverMissing = Math.max(0, countPciCorals(fsx) - usable - notAccessible);
+	return {
+		usable,
+		notAccessible,
+		driverMissing
+	};
+}
+/**
+* Detect Coral Edge TPUs on USB and PCIe/M.2 — the answer only. See
+* {@link detectCoralAccelerator} for the evidence that decided it.
+*/
+function classifyCoralAccelerator(fsx, delegateHost = currentDelegateHost()) {
+	return detectCoralAccelerator(fsx, delegateHost).info;
+}
+/**
+* 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),
+*   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`
+*   missing, unreadable or empty — a macOS desktop, a restricted container)
+*   and no PCI Coral was seen, an installed libedgetpu delegate means one USB
+*   Coral is assumed. A bus that IS readable and lists no Coral id is the
+*   answer: no USB Coral. The delegate stays installed after a stick is
+*   unplugged or moved to another node, so it is evidence only where nothing
+*   better exists (D919).
+*
+* 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 detectCoralAccelerator(fsx, delegateHost = currentDelegateHost()) {
+	const usbDevices = fsx.listUsbDevices();
+	const usbBus = usbDevices !== null && usbDevices.length > 0 ? "observed" : "unobservable";
+	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.usable > 0) units.push({
+		bus: "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,
+		reason: "driver-missing"
+	});
+	if (pci.notAccessible > 0) unavailable.push({
+		bus: "pci",
+		count: pci.notAccessible,
+		reason: "device-not-accessible"
+	});
+	if (units.length > 0 || unavailable.length > 0) return {
+		info: unavailable.length > 0 ? {
+			type: "coral-edgetpu",
+			units,
+			unavailable
+		} : {
+			type: "coral-edgetpu",
+			units
+		},
+		usbBus,
+		decidedBy: usbSeen > 0 ? "usb-ids" : "pci",
+		inaccessibleUsbNodes
+	};
+	if (usbBus === "unobservable" && chooseEdgetpuDelegate({
+		...delegateHost,
+		exists: (p) => fsx.exists(p)
+	}) !== null) return {
+		info: {
+			type: "coral-edgetpu",
+			units: [{
+				bus: "usb",
+				count: 1
+			}]
+		},
+		usbBus,
+		decidedBy: "delegate-fallback",
+		inaccessibleUsbNodes
+	};
+	return {
+		info: null,
+		usbBus,
+		decidedBy: "none",
+		inaccessibleUsbNodes
+	};
+}
+function safeListOrNull(dir) {
+	try {
+		return Kt.readdirSync(dir);
+	} catch {
+		return null;
+	}
+}
+function safeList(dir) {
+	try {
+		return Kt.readdirSync(dir);
+	} catch {
+		return [];
+	}
+}
+function safeRead(path) {
+	try {
+		return Kt.readFileSync(path, "utf8").trim();
+	} catch {
+		return "";
+	}
+}
+/** The real filesystem view: `/sys` for enumeration, `/dev` for access. */
+var nodeCoralFs = {
+	listUsbDevices: () => safeListOrNull("/sys/bus/usb/devices"),
+	readUsbAttr: (device, attr) => safeRead(`/sys/bus/usb/devices/${device}/${attr}`),
+	listPciDevices: () => safeList("/sys/bus/pci/devices"),
+	readPciAttr: (device, attr) => safeRead(`/sys/bus/pci/devices/${device}/${attr}`),
+	listApexClass: () => safeList("/sys/class/apex"),
+	canOpen: (path) => {
+		try {
+			Kt.accessSync(path, Kt.constants.R_OK | Kt.constants.W_OK);
+			return true;
+		} catch {
+			return false;
+		}
+	},
+	exists: (path) => {
+		try {
+			return Kt.existsSync(path);
+		} catch {
+			return false;
+		}
+	}
+};
+//#endregion
+export { detectCoralAccelerator as n, nodeCoralFs as r, classifyCoralAccelerator as t };