@camstack/system 1.2.456 → 1.2.458

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

@@ -1,22 +1,39 @@
 import type { CoralInfo } from "@camstack/types";
 /**
-* Filesystem seam for Coral USB Edge TPU detection — mirrors the
-* `AcceleratorFs` pattern in `intel-accelerators.ts` so the classifier stays a
-* pure, unit-testable function over injected reads.
+* Filesystem seam for Coral Edge TPU detection (USB and PCIe/M.2) — mirrors
+* the `AcceleratorFs` pattern in `intel-accelerators.ts` so the classifier
+* stays a pure, unit-testable function over injected reads.
 */
 export interface CoralFs {
 	/** USB device directory names under `/sys/bus/usb/devices` (e.g. `2-4`). */
 	listUsbDevices(): readonly string[];
 	/** Read a `<sysfsNode>/<attr>` value (idVendor / idProduct), trimmed. */
 	readUsbAttr(device: string, attr: string): string;
-	/** Whether a filesystem path exists (the libedgetpu delegate). */
+	/** PCI function names under `/sys/bus/pci/devices` (e.g. `0000:03:00.0`). */
+	listPciDevices(): readonly string[];
+	/** Read a PCI function's `vendor` / `device` attribute (e.g. `0x1ac1`), trimmed. */
+	readPciAttr(device: string, attr: string): string;
+	/** Entry names under `/sys/class/apex` (the gasket/apex driver: `apex_0`, …). */
+	listApexClass(): readonly string[];
+	/** Whether this process can open a device node for read AND write. */
+	canOpen(path: string): boolean;
+	/** Whether a filesystem path exists (the libedgetpu delegate, `/dev/apex_N`). */
 	exists(path: string): boolean;
 }
 /**
-* Detect a Coral USB Edge TPU. Present when EITHER a matching USB device is
-* enumerated OR the libedgetpu delegate is installed (the delegate is the
-* hub-provisioned runtime prerequisite; on a container whose `/sys` USB view is
-* limited, its presence is a reliable operator-intent signal that the Coral is
-* wired through). Returns `null` when neither signal is found.
+* Detect Coral Edge TPUs on USB and PCIe/M.2.
+*
+* - USB: every matching USB device counts (multiple Corals run concurrently).
+* - 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.
+*
+* 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;
+/** The real filesystem view: `/sys` for enumeration, `/dev` for access. */
+export declare const nodeCoralFs: CoralFs;

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

@@ -3,62 +3,14 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 const require_chunk = require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-BpqA2CT0.js");
+const require_dist = require("../../dist-BZQjLPiz.js");
+const require_coral_accelerators = require("../../coral-accelerators-Bi_c3Rft.js");
 let node_util = require("node:util");
 let node_os = require("node:os");
 node_os = require_chunk.__toESM(node_os);
 let node_fs = require("node:fs");
 node_fs = require_chunk.__toESM(node_fs);
 let node_child_process = require("node:child_process");
-//#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"
-}];
-/**
-* 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";
-/**
-* Detect a Coral USB Edge TPU. Present when EITHER a matching USB device is
-* enumerated OR the libedgetpu delegate is installed (the delegate is the
-* hub-provisioned runtime prerequisite; on a container whose `/sys` USB view is
-* limited, its presence is a reliable operator-intent signal that the Coral is
-* wired through). Returns `null` when neither signal is found.
-*/
-function classifyCoralAccelerator(fsx) {
-	let count = 0;
-	for (const device of fsx.listUsbDevices()) {
-		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 (count > 0) return {
-		type: "coral-edgetpu",
-		bus: "usb",
-		count
-	};
-	const libPath = process.env["CAMSTACK_EDGETPU_LIB"] ?? DEFAULT_EDGETPU_LIB;
-	if (fsx.exists(libPath)) return {
-		type: "coral-edgetpu",
-		bus: "usb"
-	};
-	return null;
-}
-//#endregion
 //#region src/builtins/platform-probe/amd-npu.ts
 var amd_npu_exports = /* @__PURE__ */ require_chunk.__exportAll({
 	classifyAmdNpu: () => classifyAmdNpu,
@@ -462,24 +414,15 @@ var PlatformScorer = class {
 		} });
 		let gpu = null;
 		let npu = null;
-		const coral = classifyCoralAccelerator({
-			listUsbDevices: () => {
-				try {
-					return node_fs.readdirSync("/sys/bus/usb/devices");
-				} catch {
-					return [];
-				}
-			},
-			readUsbAttr: (device, attr) => {
-				try {
-					return node_fs.readFileSync(`/sys/bus/usb/devices/${device}/${attr}`, "utf8").trim();
-				} catch {
-					return "";
-				}
-			},
-			exists: (p) => node_fs.existsSync(p)
-		});
-		if (coral) this.logger.info("Coral USB Edge TPU detected", { meta: { bus: coral.bus } });
+		const coral = require_coral_accelerators.classifyCoralAccelerator(require_coral_accelerators.nodeCoralFs);
+		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: {
+				bus: unavailable.bus,
+				count: unavailable.count,
+				reason: unavailable.reason
+			} });
+		}
 		if (platform === "darwin" && arch === "arm64") {
 			gpu = {
 				type: "apple",

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

@@ -1,58 +1,10 @@
 import { o as __toESM, r as __exportAll } from "../../chunk-CNf5ZN-e.mjs";
-import { $r as BaseAddon, Gi as emitReadiness, Qn as platformProbeCapability, Qr as errMsg, Ta as EventCategory, gr as scoreRuntimes, in as enumerateInferenceDevices } from "../../dist-BSF_C8W2.mjs";
+import { Ji as emitReadiness, Oa as EventCategory, ni as BaseAddon, sn as enumerateInferenceDevices, ti as errMsg, tr as platformProbeCapability, yr as scoreRuntimes } from "../../dist-B_GRPhnY.mjs";
+import { n as nodeCoralFs, t as classifyCoralAccelerator } from "../../coral-accelerators-DcnZvctM.mjs";
 import { promisify } from "node:util";
 import * as os$1 from "node:os";
 import * as fs from "node:fs";
 import { execFile } from "node:child_process";
-//#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"
-}];
-/**
-* 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";
-/**
-* Detect a Coral USB Edge TPU. Present when EITHER a matching USB device is
-* enumerated OR the libedgetpu delegate is installed (the delegate is the
-* hub-provisioned runtime prerequisite; on a container whose `/sys` USB view is
-* limited, its presence is a reliable operator-intent signal that the Coral is
-* wired through). Returns `null` when neither signal is found.
-*/
-function classifyCoralAccelerator(fsx) {
-	let count = 0;
-	for (const device of fsx.listUsbDevices()) {
-		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 (count > 0) return {
-		type: "coral-edgetpu",
-		bus: "usb",
-		count
-	};
-	const libPath = process.env["CAMSTACK_EDGETPU_LIB"] ?? DEFAULT_EDGETPU_LIB;
-	if (fsx.exists(libPath)) return {
-		type: "coral-edgetpu",
-		bus: "usb"
-	};
-	return null;
-}
-//#endregion
 //#region src/builtins/platform-probe/amd-npu.ts
 var amd_npu_exports = /* @__PURE__ */ __exportAll({
 	classifyAmdNpu: () => classifyAmdNpu,
@@ -456,24 +408,15 @@ var PlatformScorer = class {
 		} });
 		let gpu = null;
 		let npu = null;
-		const coral = classifyCoralAccelerator({
-			listUsbDevices: () => {
-				try {
-					return fs.readdirSync("/sys/bus/usb/devices");
-				} catch {
-					return [];
-				}
-			},
-			readUsbAttr: (device, attr) => {
-				try {
-					return fs.readFileSync(`/sys/bus/usb/devices/${device}/${attr}`, "utf8").trim();
-				} catch {
-					return "";
-				}
-			},
-			exists: (p) => fs.existsSync(p)
-		});
-		if (coral) this.logger.info("Coral USB Edge TPU detected", { meta: { bus: coral.bus } });
+		const coral = classifyCoralAccelerator(nodeCoralFs);
+		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: {
+				bus: unavailable.bus,
+				count: unavailable.count,
+				reason: unavailable.reason
+			} });
+		}
 		if (platform === "darwin" && arch === "arm64") {
 			gpu = {
 				type: "apple",

package/dist/builtins/record-entries/index.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-BpqA2CT0.js");
+const require_dist = require("../../dist-BZQjLPiz.js");
 let zod = require("zod");
 let node_crypto = require("node:crypto");
 //#region src/builtins/record-entries/entries-service.ts

package/dist/builtins/record-entries/index.mjs

@@ -1,4 +1,4 @@
-import { $r as BaseAddon, Oi as UnknownRecordKindError, li as InvalidRecordError, pa as recordSecretRef, ra as mapSecretLeaves, tr as recordEntriesCapability } from "../../dist-BSF_C8W2.mjs";
+import { fi as InvalidRecordError, ga as recordSecretRef, ir as recordEntriesCapability, ji as UnknownRecordKindError, ni as BaseAddon, oa as mapSecretLeaves } from "../../dist-B_GRPhnY.mjs";
 import { z } from "zod";
 import { randomUUID } from "node:crypto";
 //#region src/builtins/record-entries/entries-service.ts

package/dist/builtins/remote-access-orchestrator/remote-access-orchestrator.addon.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-BpqA2CT0.js");
+const require_dist = require("../../dist-BZQjLPiz.js");
 //#region src/builtins/remote-access-orchestrator/enabled-providers-reconcile.ts
 /**
 * Reconcile the durable `enabledProviders` set against authoritative

package/dist/builtins/remote-access-orchestrator/remote-access-orchestrator.addon.mjs

@@ -1,4 +1,4 @@
-import { $r as BaseAddon, Ta as EventCategory } from "../../dist-BSF_C8W2.mjs";
+import { Oa as EventCategory, ni as BaseAddon } from "../../dist-B_GRPhnY.mjs";
 //#region src/builtins/remote-access-orchestrator/enabled-providers-reconcile.ts
 /**
 * Reconcile the durable `enabledProviders` set against authoritative

package/dist/builtins/snapshot/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-BpqA2CT0.js");
+const require_dist = require("../../dist-BZQjLPiz.js");
 const require_snapshot_courtesy = require("../../snapshot-courtesy-D_C5-nC0.js");
 let zod = require("zod");
 let node_crypto = require("node:crypto");

package/dist/builtins/snapshot/index.mjs

@@ -1,4 +1,4 @@
-import { $r as BaseAddon, Et as batteryCapability, Or as streamQualityLabel, Qr as errMsg, Ta as EventCategory, Tt as bareAddonId, Vn as memoizePinnedFfmpeg, Yr as DeviceFeature, Yt as deriveBatteryPresence, Zr as DeviceType, br as snapshotCapability, ia as nodePin, s as BatteryStatusSchema } from "../../dist-BSF_C8W2.mjs";
+import { Cr as snapshotCapability, Oa as EventCategory, Ot as bareAddonId, Qr as DeviceFeature, Qt as deriveBatteryPresence, Wn as memoizePinnedFfmpeg, ei as DeviceType, jr as streamQualityLabel, kt as batteryCapability, ni as BaseAddon, s as BatteryStatusSchema, sa as nodePin, ti as errMsg } from "../../dist-B_GRPhnY.mjs";
 import { i as renderCourtesyOverlayJpeg, n as courtesyCacheKey, r as renderCourtesyJpeg } from "../../snapshot-courtesy-CyFs1M3I.mjs";
 import { z } from "zod";
 import { randomUUID } from "node:crypto";

package/dist/builtins/sqlite-storage/filesystem-storage.addon.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 const require_chunk = require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-BpqA2CT0.js");
+const require_dist = require("../../dist-BZQjLPiz.js");
 let node_crypto = require("node:crypto");
 let node_fs_promises = require("node:fs/promises");
 let node_path = require("node:path");

package/dist/builtins/sqlite-storage/filesystem-storage.addon.mjs

@@ -1,4 +1,4 @@
-import { $r as BaseAddon, Er as storageProviderCapability, fn as filesystemBrowseCapability } from "../../dist-BSF_C8W2.mjs";
+import { hn as filesystemBrowseCapability, kr as storageProviderCapability, ni as BaseAddon } from "../../dist-B_GRPhnY.mjs";
 import { randomUUID } from "node:crypto";
 import { mkdir, readdir, realpath, statfs } from "node:fs/promises";
 import * as path$1 from "node:path";

package/dist/builtins/sqlite-storage/index.js

@@ -4,7 +4,7 @@ Object.defineProperties(exports, {
 });
 require("../../chunk-Cek0wNdY.js");
 const require_builtins_sqlite_storage_filesystem_storage_addon = require("./filesystem-storage.addon.js");
-const require_wal_maintenance = require("../../wal-maintenance-CNEs_I94.js");
+const require_wal_maintenance = require("../../wal-maintenance-DfSIOj24.js");
 const require_builtins_sqlite_storage_sqlite_settings_addon = require("./sqlite-settings.addon.js");
 //#region src/builtins/sqlite-storage/config-store.ts
 var ConfigStore = class {

package/dist/builtins/sqlite-storage/index.mjs

@@ -1,5 +1,5 @@
 import { FilesystemStorageAddon, t as FilesystemStorageProvider } from "./filesystem-storage.addon.mjs";
-import { A as SQLITE_MMAP_CEILING_BYTES, B as SQLITE_SLOW_CALL_MS, F as sqlitePageCacheKibFor, H as sqliteEngineStorm, I as SQLITE_ENGINE_STORM_WALL_SHARE, L as SQLITE_PROFILE_REPORT_FLOOR_MS, M as SQLITE_PAGE_CACHE_CEILING_KIB, N as SQLITE_PAGE_CACHE_FLOOR_KIB, P as sqliteMmapSizeFor, R as SQLITE_PROFILE_REPORT_INTERVAL_MS, V as SqliteOpProfiler, a as WalMaintenance, i as WAL_MAINTENANCE_INTERVAL_MS, j as SQLITE_MMAP_FLOOR_BYTES, k as SQLITE_JOURNAL_SIZE_LIMIT_BYTES, l as SqliteSettingsBackend, n as WAL_HIGH_WATER_BYTES, r as WAL_IDLE_QUIET_MS, t as WAL_CHECKPOINT_BUSY_TIMEOUT_MS, z as SQLITE_PROFILE_TOP_N } from "../../wal-maintenance-AerF4XE6.mjs";
+import { A as SQLITE_MMAP_CEILING_BYTES, B as SQLITE_SLOW_CALL_MS, F as sqlitePageCacheKibFor, H as sqliteEngineStorm, I as SQLITE_ENGINE_STORM_WALL_SHARE, L as SQLITE_PROFILE_REPORT_FLOOR_MS, M as SQLITE_PAGE_CACHE_CEILING_KIB, N as SQLITE_PAGE_CACHE_FLOOR_KIB, P as sqliteMmapSizeFor, R as SQLITE_PROFILE_REPORT_INTERVAL_MS, V as SqliteOpProfiler, a as WalMaintenance, i as WAL_MAINTENANCE_INTERVAL_MS, j as SQLITE_MMAP_FLOOR_BYTES, k as SQLITE_JOURNAL_SIZE_LIMIT_BYTES, l as SqliteSettingsBackend, n as WAL_HIGH_WATER_BYTES, r as WAL_IDLE_QUIET_MS, t as WAL_CHECKPOINT_BUSY_TIMEOUT_MS, z as SQLITE_PROFILE_TOP_N } from "../../wal-maintenance-Duejh7Lx.mjs";
 import { SqliteSettingsAddon } from "./sqlite-settings.addon.mjs";
 //#region src/builtins/sqlite-storage/config-store.ts
 var ConfigStore = class {

package/dist/builtins/sqlite-storage/sqlite-settings.addon.js

@@ -3,9 +3,9 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 const require_chunk = require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-BpqA2CT0.js");
+const require_dist = require("../../dist-BZQjLPiz.js");
 const require_retired_settings_keys = require("../../retired-settings-keys-D_VwZiDt.js");
-const require_wal_maintenance = require("../../wal-maintenance-CNEs_I94.js");
+const require_wal_maintenance = require("../../wal-maintenance-DfSIOj24.js");
 const require_sqlite_snapshot_protocol = require("../../sqlite-snapshot-protocol-B9OndqZv.js");
 const require_wal_checkpoint_policy = require("../../wal-checkpoint-policy-d2z2qPqx.js");
 let node_fs_promises = require("node:fs/promises");

package/dist/builtins/sqlite-storage/sqlite-settings.addon.mjs

@@ -1,6 +1,6 @@
-import { $r as BaseAddon, C as DATABASE_SNAPSHOT_TIMEOUT_MS, Fr as vectorStoreCapability, Gt as databaseSnapshotCapability, Oi as UnknownRecordKindError, Qr as errMsg, S as DATABASE_SNAPSHOT_SUFFIX, Sr as storageAdminCapability, Tt as bareAddonId, Wt as dataStoreProviderCapability, ai as DeclarationRefusedError, at as STORAGE_ADMIN_SCOPED_BASES, da as parseSettingsBrokersAdoptsFrom, hi as RECORD_SWEEP_INTERVAL_MS, it as STORAGE_ADMIN_MOVED_COLLECTIONS, nr as recordsCapability, oa as normalizeSecretOwner, ua as parseSettingsArrayAdoptsFrom, ui as NoCallerError, vi as RUNTIME_DEFAULTS, w as DATA_STORE_DATABASES, x as DATABASE_SNAPSHOT_PARTIAL_SUFFIX, xi as RecordKindDeclarationSchema } from "../../dist-BSF_C8W2.mjs";
+import { C as DATABASE_SNAPSHOT_TIMEOUT_MS, Jt as databaseSnapshotCapability, Ot as bareAddonId, Rr as vectorStoreCapability, S as DATABASE_SNAPSHOT_SUFFIX, Tr as storageAdminCapability, ar as recordsCapability, ci as DeclarationRefusedError, ji as UnknownRecordKindError, la as normalizeSecretOwner, ma as parseSettingsBrokersAdoptsFrom, ni as BaseAddon, ot as STORAGE_ADMIN_MOVED_COLLECTIONS, pa as parseSettingsArrayAdoptsFrom, pi as NoCallerError, qt as dataStoreProviderCapability, st as STORAGE_ADMIN_SCOPED_BASES, ti as errMsg, vi as RECORD_SWEEP_INTERVAL_MS, w as DATA_STORE_DATABASES, wi as RecordKindDeclarationSchema, x as DATABASE_SNAPSHOT_PARTIAL_SUFFIX, xi as RUNTIME_DEFAULTS } from "../../dist-B_GRPhnY.mjs";
 import { i as retiredKeyStoreOf, n as purgeRetiredSettingsKeys } from "../../retired-settings-keys-Bhwe4ymb.mjs";
-import { C as RecordsEngine, D as callVector, E as callRecords, O as controlTargetOf, S as trustResult, T as callData, _ as collectTransferables, a as WalMaintenance, c as vectorProviderOfOwnedFile, d as CrossDatabaseTransactError, f as DatabaseBusyError, l as SqliteSettingsBackend, m as rehydrateError, o as createVectorIndex, p as DuplicatePlacementError, s as vectorProviderOf, u as CollectionPlacementError, v as isFileHostMessage, w as callControl } from "../../wal-maintenance-AerF4XE6.mjs";
+import { C as RecordsEngine, D as callVector, E as callRecords, O as controlTargetOf, S as trustResult, T as callData, _ as collectTransferables, a as WalMaintenance, c as vectorProviderOfOwnedFile, d as CrossDatabaseTransactError, f as DatabaseBusyError, l as SqliteSettingsBackend, m as rehydrateError, o as createVectorIndex, p as DuplicatePlacementError, s as vectorProviderOf, u as CollectionPlacementError, v as isFileHostMessage, w as callControl } from "../../wal-maintenance-Duejh7Lx.mjs";
 import { r as isSnapshotWorkerMessage } from "../../sqlite-snapshot-protocol-2QaTouWV.mjs";
 import { a as isWorkerMessage, t as WAL_CHECKPOINT_LARGE_PASS_FRAMES } from "../../wal-checkpoint-policy-BahrTtyD.mjs";
 import { createRequire } from "node:module";

package/dist/builtins/storage-orchestrator/location-history-recorder.d.ts

@@ -0,0 +1,76 @@
+/**
+* Storage-location occupancy over time, through device-history (D850).
+*
+* The figures are the ones `listLocations` already serves, from their own
+* authorities — nothing is measured twice:
+*  - the VOLUME (`location-used-percent`, `location-free-bytes`) from the same
+*    statfs probe the UI's capacity reads (`readLocalVolumeCapacity`), which
+*    answers only for a location THIS node can measure;
+*  - what CamStack HOLDS there (`location-owned-bytes`) from the
+*    `storage-occupancy` slice (D388).
+*
+* A figure that is unknown is NO point, never 0 (D393, D315): a failed statfs,
+* a remote provider, a location nobody reports owned bytes for.
+*
+* Subject: the node the location lives on (`nodeId`), else the node that
+* measured it. Scope: the location id, so a location keeps one series for life.
+*/
+import type { DeviceHistoryIngestResult, IScopedLogger } from "@camstack/types";
+export declare const LOCATION_HISTORY_NAMES: {
+	readonly usedPercent: "location-used-percent";
+	readonly freeBytes: "location-free-bytes";
+	readonly ownedBytes: "location-owned-bytes";
+};
+/** One location's sweep reading. */
+export interface LocationReading {
+	readonly locationId: string;
+	readonly nodeId: string;
+	/** `null` when this node cannot take a measurement that is about the location. */
+	readonly capacity: {
+		readonly totalBytes: number;
+		readonly availableBytes: number;
+	} | null;
+	/** `undefined` when no provider reports what CamStack holds there. */
+	readonly ownedBytes: number | undefined;
+}
+export interface LocationHistoryPoint {
+	readonly key: string;
+	readonly subject: {
+		readonly kind: "node";
+		readonly nodeId: string;
+	};
+	readonly scope: string;
+	readonly ts: number;
+	readonly value: number;
+}
+export interface LocationHistoryClient {
+	declareSeries(input: {
+		name: string;
+		subjectKind: "node";
+		kind: "gauge";
+		displayName: string;
+		ingest: "points";
+		unit: string;
+	}): Promise<{
+		key: string;
+	}>;
+	record(input: {
+		points: readonly LocationHistoryPoint[];
+	}): Promise<DeviceHistoryIngestResult>;
+}
+export interface LocationHistoryRecorderDeps {
+	readonly deviceHistory: LocationHistoryClient;
+	readonly logger: IScopedLogger;
+}
+/** One reading per location per this many ms at most (the sweep runs every minute). */
+export declare const LOCATION_HISTORY_MIN_INTERVAL_MS = 6e4;
+export declare class LocationHistoryRecorder {
+	private readonly deps;
+	private readonly keys;
+	private readonly lastAt;
+	constructor(deps: LocationHistoryRecorderDeps);
+	private ensureDeclared;
+	/** The points of one sweep; pure apart from the per-location rate memory. */
+	pointsOf(readings: readonly LocationReading[], at: number): readonly LocationHistoryPoint[];
+	record(readings: readonly LocationReading[], at: number): Promise<void>;
+}

package/dist/builtins/storage-orchestrator/storage-orchestrator.addon.d.ts

@@ -18,6 +18,9 @@ export declare class StorageOrchestratorAddon extends BaseAddon<StorageOrchestra
 	private occupancySlice;
 	private get occupancy();
 	private pressureTimer;
+	/** Occupancy over time (device-history). Created with the timer that feeds it. */
+	private locationHistory;
+	private locationHistoryInFlight;
 	private pressureSweepInFlight;
 	private migration;
 	/** Guards every single-location repoint and arbitrates movers per physical root. */
@@ -108,6 +111,12 @@ export declare class StorageOrchestratorAddon extends BaseAddon<StorageOrchestra
 	/** Single-flighted pressure sweep — never overlaps a slow eviction round. */
 	private runPressureSweep;
 	/**
+	* One occupancy reading per location this node can read, into device-history.
+	* The volume figures come from the same probe `listLocations` serves, the
+	* held bytes from the occupancy slice; an unknown figure is no point (D393).
+	*/
+	private recordLocationHistory;
+	/**
 	* Sample free space for every managed location and emit NC band edges.
 	* A failed capacity read stays `null` and changes no band — never folded to 0 (D393).
 	*/

package/dist/builtins/storage-orchestrator/storage-orchestrator.addon.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 const require_chunk = require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-BpqA2CT0.js");
+const require_dist = require("../../dist-BZQjLPiz.js");
 const require_read_all_rows$1 = require("../../read-all-rows-CVoO1ONM.js");
 let zod = require("zod");
 let node_crypto = require("node:crypto");
@@ -3957,6 +3957,107 @@ var StorageLocationBandMonitor = class {
 	}
 };
 //#endregion
+//#region src/builtins/storage-orchestrator/location-history-recorder.ts
+var LOCATION_HISTORY_NAMES = {
+	usedPercent: "location-used-percent",
+	freeBytes: "location-free-bytes",
+	ownedBytes: "location-owned-bytes"
+};
+var DECLARATIONS = [
+	{
+		name: LOCATION_HISTORY_NAMES.usedPercent,
+		displayName: "Location volume used %",
+		unit: "%"
+	},
+	{
+		name: LOCATION_HISTORY_NAMES.freeBytes,
+		displayName: "Location volume free",
+		unit: "bytes"
+	},
+	{
+		name: LOCATION_HISTORY_NAMES.ownedBytes,
+		displayName: "Location held by CamStack",
+		unit: "bytes"
+	}
+];
+var LocationHistoryRecorder = class {
+	deps;
+	keys = /* @__PURE__ */ new Map();
+	lastAt = /* @__PURE__ */ new Map();
+	constructor(deps) {
+		this.deps = deps;
+	}
+	async ensureDeclared() {
+		if (this.keys.size === DECLARATIONS.length) return true;
+		try {
+			for (const d of DECLARATIONS) {
+				const { key } = await this.deps.deviceHistory.declareSeries({
+					name: d.name,
+					subjectKind: "node",
+					kind: "gauge",
+					displayName: d.displayName,
+					ingest: "points",
+					unit: d.unit
+				});
+				this.keys.set(d.name, key);
+			}
+			return true;
+		} catch (err) {
+			this.keys.clear();
+			this.deps.logger.warn("storage: location history declare failed — retried next sweep", { meta: { error: err instanceof Error ? err.message : String(err) } });
+			return false;
+		}
+	}
+	/** The points of one sweep; pure apart from the per-location rate memory. */
+	pointsOf(readings, at) {
+		const points = [];
+		for (const r of readings) {
+			const last = this.lastAt.get(r.locationId);
+			if (last !== void 0 && at >= last && at - last < 6e4) continue;
+			const add = (name, value) => {
+				const key = this.keys.get(name);
+				if (key === void 0 || !Number.isFinite(value)) return;
+				points.push({
+					key,
+					subject: {
+						kind: "node",
+						nodeId: r.nodeId
+					},
+					scope: r.locationId,
+					ts: at,
+					value
+				});
+			};
+			const before = points.length;
+			if (r.capacity !== null && r.capacity.totalBytes > 0) {
+				const used = r.capacity.totalBytes - r.capacity.availableBytes;
+				add(LOCATION_HISTORY_NAMES.usedPercent, Math.round(used / r.capacity.totalBytes * 1e3) / 10);
+				add(LOCATION_HISTORY_NAMES.freeBytes, r.capacity.availableBytes);
+			}
+			if (r.ownedBytes !== void 0) add(LOCATION_HISTORY_NAMES.ownedBytes, r.ownedBytes);
+			if (points.length > before) this.lastAt.set(r.locationId, at);
+		}
+		return points;
+	}
+	async record(readings, at) {
+		if (readings.length === 0 || !await this.ensureDeclared()) return;
+		const points = this.pointsOf(readings, at);
+		if (points.length === 0) return;
+		try {
+			const result = await this.deps.deviceHistory.record({ points });
+			if (result.refused.length > 0) {
+				if (result.refused.some((r) => r.reason === "undeclared")) this.keys.clear();
+				this.deps.logger.warn("storage: location history points refused", { meta: {
+					accepted: result.accepted,
+					refused: result.refused
+				} });
+			}
+		} catch (err) {
+			this.deps.logger.warn("storage: location history not stored", { meta: { error: err instanceof Error ? err.message : String(err) } });
+		}
+	}
+};
+//#endregion
 //#region src/builtins/storage-orchestrator/storage-orchestrator.addon.ts
 /**
 * `storage-orchestrator` builtin — singleton owner of the consumer-
@@ -4024,6 +4125,9 @@ var StorageOrchestratorAddon = class extends require_dist.BaseAddon {
 		return this.occupancySlice;
 	}
 	pressureTimer = null;
+	/** Occupancy over time (device-history). Created with the timer that feeds it. */
+	locationHistory = null;
+	locationHistoryInFlight = false;
 	pressureSweepInFlight = false;
 	migration = null;
 	/** Guards every single-location repoint and arbitrates movers per physical root. */
@@ -4440,8 +4544,16 @@ var StorageOrchestratorAddon = class extends require_dist.BaseAddon {
 				}
 			}
 		});
+		this.locationHistory = new LocationHistoryRecorder({
+			deviceHistory: {
+				declareSeries: (input) => this.ctx.api.deviceHistory.declareSeries.mutate(input),
+				record: (input) => this.ctx.api.deviceHistory.record.mutate({ points: [...input.points] })
+			},
+			logger: this.ctx.logger
+		});
 		this.pressureTimer = setInterval(() => {
 			this.runPressureSweep();
+			this.recordLocationHistory();
 		}, PRESSURE_SWEEP_INTERVAL_MS);
 		this.ctx.logger.info("Storage orchestrator initialized");
 		return [
@@ -4588,6 +4700,37 @@ var StorageOrchestratorAddon = class extends require_dist.BaseAddon {
 		}
 	}
 	/**
+	* One occupancy reading per location this node can read, into device-history.
+	* The volume figures come from the same probe `listLocations` serves, the
+	* held bytes from the occupancy slice; an unknown figure is no point (D393).
+	*/
+	async recordLocationHistory() {
+		const svc = this.service;
+		const recorder = this.locationHistory;
+		if (!svc || !recorder || this.locationHistoryInFlight) return;
+		this.locationHistoryInFlight = true;
+		try {
+			this.occupancy.serveAndRevalidate();
+			const localNode = svc.getLocalNodeId();
+			const readings = [];
+			for (const loc of svc.listLocations()) {
+				if (!require_dist.mayReadLocation(loc) || (loc.nodeId ?? HUB_NODE_ID) !== localNode) continue;
+				const capacity = await this.localCapacityOf(loc).catch(() => null);
+				readings.push({
+					locationId: loc.id,
+					nodeId: localNode,
+					capacity,
+					ownedBytes: this.occupancy.ownedFor(loc.id)?.bytes
+				});
+			}
+			await recorder.record(readings, Date.now());
+		} catch (err) {
+			this.ctxIfReady?.logger.warn("storage: location history pass failed", { meta: { error: err instanceof Error ? err.message : String(err) } });
+		} finally {
+			this.locationHistoryInFlight = false;
+		}
+	}
+	/**
 	* Sample free space for every managed location and emit NC band edges.
 	* A failed capacity read stays `null` and changes no band — never folded to 0 (D393).
 	*/