@camstack/system 1.0.7 → 1.1.0

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

@@ -161,7 +161,7 @@ var StorageOrchestratorService = class {
 		const resolver = this.nodeLocalResolver;
 		if (!resolver) return;
 		let stamped = 0;
-		for (const [id, loc] of [...this.locations]) {
+		for (const [id, loc] of Array.from(this.locations)) {
 			if (loc.nodeId) continue;
 			if (resolver(loc.providerId) !== true) continue;
 			const updated = {
@@ -301,7 +301,7 @@ var StorageOrchestratorService = class {
 			this.logger.warn("storage-orchestrator: skipping prune — no location declarations loaded (fail-safe)");
 			return;
 		}
-		for (const [id, loc] of [...this.locations]) {
+		for (const [id, loc] of Array.from(this.locations)) {
 			if (this.registry.cardinalityOf(loc.type) !== null) continue;
 			if (loc.isSystem) {
 				this.locations.delete(id);

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

@@ -154,7 +154,7 @@ var StorageOrchestratorService = class {
 		const resolver = this.nodeLocalResolver;
 		if (!resolver) return;
 		let stamped = 0;
-		for (const [id, loc] of [...this.locations]) {
+		for (const [id, loc] of Array.from(this.locations)) {
 			if (loc.nodeId) continue;
 			if (resolver(loc.providerId) !== true) continue;
 			const updated = {
@@ -294,7 +294,7 @@ var StorageOrchestratorService = class {
 			this.logger.warn("storage-orchestrator: skipping prune — no location declarations loaded (fail-safe)");
 			return;
 		}
-		for (const [id, loc] of [...this.locations]) {
+		for (const [id, loc] of Array.from(this.locations)) {
 			if (this.registry.cardinalityOf(loc.type) !== null) continue;
 			if (loc.isSystem) {
 				this.locations.delete(id);

package/dist/index.js

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_chunk = require("./chunk-Cek0wNdY.js");
-const require_model_download_service = require("./model-download-service-JtVQtbb6.js");
+const require_model_download_service = require("./model-download-service-1eEOkNeS.js");
 const require_resource_monitor = require("./resource-monitor-DNNomR-i.js");
 const require_builtins_sqlite_storage_filesystem_storage_addon = require("./builtins/sqlite-storage/filesystem-storage.addon.js");
 const require_builtins_sqlite_storage_sqlite_settings_addon = require("./builtins/sqlite-storage/sqlite-settings.addon.js");
@@ -20,7 +20,7 @@ const require_builtins_local_auth_local_auth_addon = require("./builtins/local-a
 require("./builtins/local-auth/index.js");
 const require_builtins_device_manager_device_manager_addon = require("./builtins/device-manager/device-manager.addon.js");
 require("./builtins/device-manager/index.js");
-const require_manifest_python_deps = require("./manifest-python-deps-eBDj5HEY.js");
+const require_manifest_python_deps = require("./manifest-python-deps-BWURo7dc.js");
 const require_custom_action_registry = require("./custom-action-registry-vLYEFTtv.js");
 const require_graceful_fs$1 = require("./graceful-fs-lg19SZNz.js");
 let _camstack_types_node = require("@camstack/types/node");
@@ -183,7 +183,7 @@ function proxyToUpstream(opts) {
 }
 //#endregion
 //#region src/python/python-env-manager.ts
-var execFileAsync$2 = (0, node_util.promisify)(node_child_process.execFile);
+var execFileAsync$3 = (0, node_util.promisify)(node_child_process.execFile);
 var PythonEnvManager = class {
 	venvPath;
 	cachedProbe = null;
@@ -193,12 +193,12 @@ var PythonEnvManager = class {
 	async probe() {
 		if (this.cachedProbe) return this.cachedProbe;
 		for (const cmd of ["python3", "python"]) try {
-			const { stdout } = await execFileAsync$2(cmd, ["--version"]);
+			const { stdout } = await execFileAsync$3(cmd, ["--version"]);
 			const version = stdout.trim().replace("Python ", "");
 			const major = parseInt(version.split(".")[0] ?? "0", 10);
 			const minor = parseInt(version.split(".")[1] ?? "0", 10);
 			if (major < 3 || major === 3 && minor < 10) continue;
-			const { stdout: pathOut } = await execFileAsync$2(cmd, ["-c", "import sys; print(sys.executable)"]);
+			const { stdout: pathOut } = await execFileAsync$3(cmd, ["-c", "import sys; print(sys.executable)"]);
 			this.cachedProbe = {
 				available: true,
 				version,
@@ -214,13 +214,13 @@ var PythonEnvManager = class {
 	async ensure(options) {
 		const probe = await this.probe();
 		if (!probe.available || !probe.path) throw new Error("Python 3.10+ is required but not found on this system");
-		if (!node_fs.existsSync(node_path.join(this.venvPath, "bin", "python"))) await execFileAsync$2(probe.path, [
+		if (!node_fs.existsSync(node_path.join(this.venvPath, "bin", "python"))) await execFileAsync$3(probe.path, [
 			"-m",
 			"venv",
 			this.venvPath
 		]);
 		const venvPython = node_path.join(this.venvPath, "bin", "python");
-		if (options.packages.length > 0) await execFileAsync$2(venvPython, [
+		if (options.packages.length > 0) await execFileAsync$3(venvPython, [
 			"-m",
 			"pip",
 			"install",
@@ -1419,12 +1419,11 @@ var StorageManager = class {
 		return namespace ? this.createNamespacedLocation(location, namespace) : location;
 	}
 	createLegacyShim() {
-		const self = this;
 		return {
 			async initialize() {},
 			async shutdown() {},
-			getLocation(name) {
-				return self.getLocation(name);
+			getLocation: (name) => {
+				return this.getLocation(name);
 			}
 		};
 	}
@@ -1700,7 +1699,7 @@ function matchPath(pattern, path) {
 }
 //#endregion
 //#region src/tls/cert-manager.ts
-var execFileAsync$1 = (0, node_util.promisify)(node_child_process.execFile);
+var execFileAsync$2 = (0, node_util.promisify)(node_child_process.execFile);
 /**
 * Ensure a self-signed TLS certificate exists in the given directory.
 * Generates one if missing. Returns paths to cert and key files.
@@ -1737,7 +1736,7 @@ async function ensureTlsCert(dataDir, options) {
 	for (const dns of sanDns) sanParts.push(`DNS:${dns}`);
 	for (const ip of sanIps) sanParts.push(`IP:${ip}`);
 	const sanString = sanParts.join(",");
-	await execFileAsync$1("openssl", [
+	await execFileAsync$2("openssl", [
 		"req",
 		"-x509",
 		"-newkey",
@@ -2570,6 +2569,7 @@ var AddonEngineManager = class {
 };
 //#endregion
 //#region src/kernel/fs-utils.ts
+var execFileAsync$1 = (0, node_util.promisify)(node_child_process.execFile);
 /**
 * Ensure a directory exists (recursive).
 * Single source of truth — replaces scattered mkdirSync calls.
@@ -2578,18 +2578,20 @@ function ensureDir(dirPath) {
 	node_fs.mkdirSync(dirPath, { recursive: true });
 }
 /**
-* Copy a directory recursively.
-* Single source of truth — extracted from addon-installer + first-boot-installer.
+* Copy a directory recursively — ASYNC so it never blocks the event loop.
+*
+* The hub installs addons into `/data/addons`, which on Unraid is a slow
+* shfs/FUSE mount. The former synchronous `fs.copyFileSync`-per-file loop
+* blocked the Node event loop for the whole copy of a large bundle (e.g.
+* `addon-pipeline`), which froze the hub's HTTP listener mid-`camstack deploy`
+* (accept backlog piling up, existing connections stuck in CLOSE_WAIT). Using
+* `fs.promises.cp` keeps the I/O off the event loop. (Node ≥18 stable.)
 */
-function copyDirRecursive(src, dest) {
-	ensureDir(dest);
-	const entries = node_fs.readdirSync(src, { withFileTypes: true });
-	for (const entry of entries) {
-		const srcPath = node_path.join(src, entry.name);
-		const destPath = node_path.join(dest, entry.name);
-		if (entry.isDirectory()) copyDirRecursive(srcPath, destPath);
-		else node_fs.copyFileSync(srcPath, destPath);
-	}
+async function copyDirRecursive(src, dest) {
+	await node_fs.promises.cp(src, dest, {
+		recursive: true,
+		force: true
+	});
 }
 /**
 * Strip @camstack/* dependencies and devDependencies from a package.json object.
@@ -2619,7 +2621,7 @@ function stripCamstackDeps(pkg) {
 * Copies directories (not individual files) from source to destination.
 * Skips "dist" (already handled) and glob patterns.
 */
-function copyExtraFileDirs(pkgJson, sourceDir, destDir) {
+async function copyExtraFileDirs(pkgJson, sourceDir, destDir) {
 	const rawFiles = pkgJson.files;
 	if (!Array.isArray(rawFiles)) return;
 	for (const fileEntry of rawFiles) {
@@ -2628,11 +2630,11 @@ function copyExtraFileDirs(pkgJson, sourceDir, destDir) {
 		const srcPath = node_path.join(sourceDir, fileEntry);
 		if (!node_fs.existsSync(srcPath)) continue;
 		const destPath = node_path.join(destDir, fileEntry);
-		const stat = node_fs.statSync(srcPath);
-		if (stat.isDirectory()) copyDirRecursive(srcPath, destPath);
+		const stat = await node_fs.promises.stat(srcPath);
+		if (stat.isDirectory()) await copyDirRecursive(srcPath, destPath);
 		else if (stat.isFile()) {
 			ensureDir(node_path.dirname(destPath));
-			node_fs.copyFileSync(srcPath, destPath);
+			await node_fs.promises.copyFile(srcPath, destPath);
 		}
 	}
 }
@@ -2677,12 +2679,16 @@ function ensureLibraryBuilt(packageName, packagesDir) {
 /**
 * Install a single npm package into a target directory (package.json + dist/).
 * No validation on camstack.addons -- works for any @camstack/* package.
-* Uses synchronous child_process calls (suitable for first-boot and update paths).
+*
+* ASYNC: uses `execFile`/`fs.promises` throughout so a package install on a
+* live node never blocks the event loop (the `npm pack` + tar extract + copy to
+* the slow shfs/FUSE `/data` would otherwise freeze the HTTP listener). See
+* `copyDirRecursive` for the wedge this prevents.
 */
-function installPackageFromNpmSync(packageName, targetDir) {
-	const tmpDir = node_fs.mkdtempSync(node_path.join(node_os.tmpdir(), "camstack-install-"));
+async function installPackageFromNpm(packageName, targetDir) {
+	const tmpDir = await node_fs.promises.mkdtemp(node_path.join(node_os.tmpdir(), "camstack-install-"));
 	try {
-		const tgzFilename = (0, node_child_process.execFileSync)("npm", [
+		const { stdout } = await execFileAsync$1("npm", [
 			"pack",
 			packageName,
 			"--pack-destination",
@@ -2690,12 +2696,13 @@ function installPackageFromNpmSync(packageName, targetDir) {
 		], {
 			timeout: 12e4,
 			encoding: "utf-8"
-		}).trim().split("\n").pop()?.trim();
+		});
+		const tgzFilename = stdout.trim().split("\n").pop()?.trim();
 		if (!tgzFilename) throw new Error("npm pack produced no output");
 		const tgzPath = node_path.join(tmpDir, tgzFilename);
 		const extractDir = node_path.join(tmpDir, "extracted");
 		ensureDir(extractDir);
-		(0, node_child_process.execFileSync)("tar", [
+		await execFileAsync$1("tar", [
 			"-xzf",
 			tgzPath,
 			"-C",
@@ -2703,20 +2710,20 @@ function installPackageFromNpmSync(packageName, targetDir) {
 		], { timeout: 3e4 });
 		const packageSubDir = node_path.join(extractDir, "package");
 		const srcPkgJsonDir = node_fs.existsSync(node_path.join(packageSubDir, "package.json")) ? packageSubDir : extractDir;
-		node_fs.rmSync(targetDir, {
+		await node_fs.promises.rm(targetDir, {
 			recursive: true,
 			force: true
 		});
 		ensureDir(targetDir);
-		node_fs.copyFileSync(node_path.join(srcPkgJsonDir, "package.json"), node_path.join(targetDir, "package.json"));
+		await node_fs.promises.copyFile(node_path.join(srcPkgJsonDir, "package.json"), node_path.join(targetDir, "package.json"));
 		const distSrc = node_path.join(srcPkgJsonDir, "dist");
-		if (node_fs.existsSync(distSrc)) copyDirRecursive(distSrc, node_path.join(targetDir, "dist"));
+		if (node_fs.existsSync(distSrc)) await copyDirRecursive(distSrc, node_path.join(targetDir, "dist"));
 		try {
-			const npmPkg = (0, _camstack_types.asJsonObject)((0, _camstack_types.parseJsonUnknown)(node_fs.readFileSync(node_path.join(srcPkgJsonDir, "package.json"), "utf-8")));
-			if (npmPkg) copyExtraFileDirs(npmPkg, srcPkgJsonDir, targetDir);
+			const npmPkg = (0, _camstack_types.asJsonObject)((0, _camstack_types.parseJsonUnknown)(await node_fs.promises.readFile(node_path.join(srcPkgJsonDir, "package.json"), "utf-8")));
+			if (npmPkg) await copyExtraFileDirs(npmPkg, srcPkgJsonDir, targetDir);
 		} catch {}
 	} finally {
-		node_fs.rmSync(tmpDir, {
+		await node_fs.promises.rm(tmpDir, {
 			recursive: true,
 			force: true
 		});
@@ -3166,15 +3173,15 @@ var AddonInstaller = class AddonInstaller {
 		await this.ensureBuilt(packageName, sourceDir, pkgData);
 		const distDir = node_path.join(sourceDir, "dist");
 		if (!node_fs.existsSync(distDir)) throw new Error(`${packageName} has no dist/ after build`);
-		node_fs.rmSync(targetDir, {
+		await node_fs.promises.rm(targetDir, {
 			recursive: true,
 			force: true
 		});
 		ensureDir(targetDir);
-		node_fs.writeFileSync(node_path.join(targetDir, "package.json"), JSON.stringify(stripCamstackDeps(pkgData), null, 2));
-		copyDirRecursive(distDir, node_path.join(targetDir, "dist"));
-		copyExtraFileDirs(pkgData, sourceDir, targetDir);
-		node_fs.writeFileSync(node_path.join(targetDir, ".install-source"), "local");
+		await node_fs.promises.writeFile(node_path.join(targetDir, "package.json"), JSON.stringify(stripCamstackDeps(pkgData), null, 2));
+		await copyDirRecursive(distDir, node_path.join(targetDir, "dist"));
+		await copyExtraFileDirs(pkgData, sourceDir, targetDir);
+		await node_fs.promises.writeFile(node_path.join(targetDir, ".install-source"), "local");
 		const localPkgVersion = (0, _camstack_types.asString)(pkgData.version, "0.0.0");
 		this.manifest.upsert(packageName, {
 			version: localPkgVersion,
@@ -3277,6 +3284,66 @@ var AddonInstaller = class AddonInstaller {
 		node_fs.writeFileSync(tgzPath, buf);
 		return tgzPath;
 	}
+	/**
+	* Evict an existing install dir by atomic rename-aside, then best-effort
+	* delete the aside copy.
+	*
+	* Why not a plain `fs.promises.rm(targetDir, {recursive})`: during a
+	* `camstack deploy` the addon's live runner still holds its native
+	* prebuilds (`.node`/`.so`) open. On the hub's shfs/FUSE `/data/addons`,
+	* a recursive rm of a held subdir fails `ENOTEMPTY` mid-walk and leaves
+	* the dir gutted. A rename only touches the dirent (metadata), so it
+	* succeeds with the inodes still open — the old runner keeps its fds on
+	* the moved inodes until it restarts.
+	*
+	* The aside copy is removed best-effort: the held native libs are only
+	* released once the post-install `restartAddon` recycles the runner, so a
+	* failure to delete it now must NOT fail the install. Any residue is swept
+	* on the next deploy.
+	*/
+	async evictInstallDir(targetDir) {
+		if (!node_fs.existsSync(targetDir)) return;
+		const graveyard = node_path.join(this.addonsDir, ".evicting");
+		ensureDir(graveyard);
+		await this.sweepGraveyard(graveyard);
+		const ts = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-");
+		const flatName = node_path.relative(this.addonsDir, targetDir).replace(/[/\\]/g, "-");
+		const asideDir = node_path.join(graveyard, `${flatName}-${ts}`);
+		try {
+			node_fs.renameSync(targetDir, asideDir);
+		} catch (renameErr) {
+			if (renameErr.code === "EXDEV") {
+				await node_fs.promises.rm(targetDir, {
+					recursive: true,
+					force: true
+				});
+				return;
+			}
+			throw renameErr;
+		}
+		await node_fs.promises.rm(asideDir, {
+			recursive: true,
+			force: true
+		}).catch((cleanupErr) => {
+			this.logger.debug("evictInstallDir: aside cleanup deferred (likely held open)", { meta: {
+				asideDir,
+				error: (0, _camstack_types.errMsg)(cleanupErr)
+			} });
+		});
+	}
+	/** Best-effort removal of leftover `.evicting/*` dirs from earlier deploys. */
+	async sweepGraveyard(graveyard) {
+		let entries;
+		try {
+			entries = node_fs.readdirSync(graveyard);
+		} catch {
+			return;
+		}
+		await Promise.all(entries.map((name) => node_fs.promises.rm(node_path.join(graveyard, name), {
+			recursive: true,
+			force: true
+		}).catch(() => void 0)));
+	}
 	/** Install addon from a tgz file (uploaded or downloaded) */
 	async installFromTgz(tgzPath) {
 		const tmpDir = node_fs.mkdtempSync(node_path.join(node_os.tmpdir(), "camstack-addon-install-"));
@@ -3294,17 +3361,14 @@ var AddonInstaller = class AddonInstaller {
 			if (!pkgView) throw new Error(`Invalid package.json at ${pkgJsonPath}`);
 			if (!pkgView.camstackAddons) throw new Error(`Package ${pkgView.name} has no camstack.addons manifest`);
 			const targetDir = node_path.join(this.addonsDir, pkgView.name);
-			node_fs.rmSync(targetDir, {
-				recursive: true,
-				force: true
-			});
+			await this.evictInstallDir(targetDir);
 			ensureDir(targetDir);
 			const sourceDir = node_path.dirname(pkgJsonPath);
 			const strippedManifest = stripCamstackDeps(pkgView.raw);
-			node_fs.writeFileSync(node_path.join(targetDir, "package.json"), JSON.stringify(strippedManifest, null, 2));
+			await node_fs.promises.writeFile(node_path.join(targetDir, "package.json"), JSON.stringify(strippedManifest, null, 2));
 			const sourceDist = node_path.join(sourceDir, "dist");
-			if (node_fs.existsSync(sourceDist)) copyDirRecursive(sourceDist, node_path.join(targetDir, "dist"));
-			copyExtraFileDirs(pkgView.raw, sourceDir, targetDir);
+			if (node_fs.existsSync(sourceDist)) await copyDirRecursive(sourceDist, node_path.join(targetDir, "dist"));
+			await copyExtraFileDirs(pkgView.raw, sourceDir, targetDir);
 			const strippedRuntimeDeps = strippedManifest["dependencies"];
 			if (strippedRuntimeDeps != null && typeof strippedRuntimeDeps === "object" && Object.keys(strippedRuntimeDeps).length > 0) {
 				this.logger.info(`${pkgView.name} — installing runtime dependencies`, { meta: { targetDir } });
@@ -3328,7 +3392,7 @@ var AddonInstaller = class AddonInstaller {
 			try {
 				await require_manifest_python_deps.installManifestNativeDeps(targetDir, pkgView.raw, this.logger, this.registry);
 			} catch (nativeErr) {
-				node_fs.rmSync(targetDir, {
+				await node_fs.promises.rm(targetDir, {
 					recursive: true,
 					force: true
 				});
@@ -3343,7 +3407,7 @@ var AddonInstaller = class AddonInstaller {
 				version: pkgView.version
 			};
 		} finally {
-			node_fs.rmSync(tmpDir, {
+			await node_fs.promises.rm(tmpDir, {
 				recursive: true,
 				force: true
 			});
@@ -4111,7 +4175,7 @@ var CapabilityRegistry = class CapabilityRegistry {
 		const bare = this.bareAddonId(addonId);
 		const nodeMap = this.singletonNodeOverrides.get(capabilityName);
 		if (nodeMap) {
-			for (const [nodeId, ov] of [...nodeMap]) if (ov === bare) nodeMap.delete(nodeId);
+			for (const [nodeId, ov] of Array.from(nodeMap)) if (ov === bare) nodeMap.delete(nodeId);
 			if (nodeMap.size === 0) this.singletonNodeOverrides.delete(capabilityName);
 		}
 		this.logger.info("Provider unregistered from capability", {
@@ -7388,20 +7452,20 @@ var ConfigManager = class ConfigManager {
 	setSettingsStore(store) {
 		this.settingsStore = store;
 	}
-	get(path) {
-		return this.resolveConfigValue(path);
+	get(configPath) {
+		return this.resolveConfigValue(configPath);
 	}
-	resolveConfigValue(path) {
-		const bootstrapValue = this.getFromBootstrap(path);
+	resolveConfigValue(configPath) {
+		const bootstrapValue = this.getFromBootstrap(configPath);
 		if (bootstrapValue !== void 0) return bootstrapValue;
 		if (this.settingsStore !== null) {
-			const storeValue = this.settingsStore.getSystem(path);
+			const storeValue = this.settingsStore.getSystem(configPath);
 			if (storeValue !== void 0) return storeValue;
-			const nested = this.getNestedFromSystemSettings(path);
+			const nested = this.getNestedFromSystemSettings(configPath);
 			if (nested !== null) return nested;
 		}
-		if (path in _camstack_types.RUNTIME_DEFAULTS) return _camstack_types.RUNTIME_DEFAULTS[path];
-		return this.getFromRuntimeDefaults(path) ?? void 0;
+		if (configPath in _camstack_types.RUNTIME_DEFAULTS) return _camstack_types.RUNTIME_DEFAULTS[configPath];
+		return this.getFromRuntimeDefaults(configPath) ?? void 0;
 	}
 	/**
 	* Write a value to the settings-store.
@@ -7617,8 +7681,8 @@ var ConfigManager = class ConfigManager {
 		};
 		this.saveRuntimeState();
 	}
-	getBootstrap(path) {
-		return this.getFromBootstrap(path);
+	getBootstrap(configPath) {
+		return this.getFromBootstrap(configPath);
 	}
 	/** Features accessor -- reads from settings-store when available, falls back to RUNTIME_DEFAULTS */
 	get features() {
@@ -7708,8 +7772,8 @@ var ConfigManager = class ConfigManager {
 	* Deep-set a value in a nested plain object using a dot-notation path.
 	* Returns a new object (immutable).
 	*/
-	setNested(obj, path, value) {
-		const [head, ...rest] = path.split(".");
+	setNested(obj, configPath, value) {
+		const [head, ...rest] = configPath.split(".");
 		if (!head) return obj;
 		if (rest.length === 0) return {
 			...obj,
@@ -7749,8 +7813,8 @@ var ConfigManager = class ConfigManager {
 	warnDefaultCredentials() {
 		if (this.bootstrapConfig.auth.adminPassword === "changeme") console.warn("[ConfigManager] Warning: Using default admin password \"changeme\". Set auth.adminPassword in your config.yaml or the CAMSTACK_ADMIN_PASS env var.");
 	}
-	getFromBootstrap(path) {
-		const keys = path.split(".");
+	getFromBootstrap(configPath) {
+		const keys = configPath.split(".");
 		let current = this.bootstrapConfig;
 		for (const key of keys) {
 			if (!isRecord(current)) return void 0;
@@ -7758,8 +7822,8 @@ var ConfigManager = class ConfigManager {
 		}
 		return current;
 	}
-	getFromRuntimeDefaults(path) {
-		const prefix = path + ".";
+	getFromRuntimeDefaults(configPath) {
+		const prefix = configPath + ".";
 		const result = {};
 		let found = false;
 		for (const [key, value] of Object.entries(_camstack_types.RUNTIME_DEFAULTS)) if (key.startsWith(prefix)) {
@@ -7774,10 +7838,10 @@ var ConfigManager = class ConfigManager {
 	* e.g. path='features' matches keys 'features.streaming', 'features.notifications', etc.
 	* Returns an object keyed by the sub-key, or undefined if nothing is found.
 	*/
-	getNestedFromSystemSettings(path) {
+	getNestedFromSystemSettings(configPath) {
 		if (this.settingsStore === null) return null;
 		const all = this.settingsStore.getAllSystem();
-		const prefix = path + ".";
+		const prefix = configPath + ".";
 		const result = {};
 		let found = false;
 		for (const [key, value] of Object.entries(all)) if (key.startsWith(prefix)) {
@@ -89897,6 +89961,15 @@ function normalizeHubUrl(raw, defaultPort) {
 	return `${/:\d+$/.test(hostPort) ? hostPort : `${hostPort}:${defaultPort}`}/${nodeId}`;
 }
 //#endregion
+//#region src/kernel/moleculer/addon-deploy-source.ts
+function isAddonDeploySource(v) {
+	if (!v || typeof v !== "object") return false;
+	const o = v;
+	if (o["kind"] === "npm") return typeof o["version"] === "string";
+	if (o["kind"] === "hub-http") return typeof o["url"] === "string" && typeof o["token"] === "string" && typeof o["sha256"] === "string" && typeof o["bytes"] === "number";
+	return false;
+}
+//#endregion
 //#region src/kernel/moleculer/core-cap-service.ts
 /**
 * Default Moleculer service name for the hub core-capability bridge.
@@ -90938,7 +91011,7 @@ function createProcessService(parentNodeId, dataDir, deps, parentTcpPort, parent
 						respawned.restartCount = prevRestartCount + 1;
 					});
 					restarted.push(name);
-				} catch (err) {
+				} catch {
 					failed.push(name);
 				}
 				return {
@@ -91333,8 +91406,8 @@ var LifecycleJobEngine = class {
 			} finally {
 				clearTimeout(timer);
 			}
-			if (packages.length === 0) throw new Error("stageFramework returned no packages");
 			const [firstPackage] = packages;
+			if (!firstPackage) throw new Error("stageFramework returned no packages");
 			this.advance(job.jobId, task, "staged", { stagedPath: firstPackage.stagedPath });
 			requestFrameworkSwap({
 				jobId: job.jobId,
@@ -91357,14 +91430,15 @@ var LifecycleJobEngine = class {
 	*/
 	async fetchAddonsBounded(job, addonTasks) {
 		const limit = Math.max(1, this.deps.fetchConcurrency ?? DEFAULT_FETCH_CONCURRENCY);
-		const outcomes = new Array(addonTasks.length);
+		const outcomes = Array.from({ length: addonTasks.length });
 		let nextIndex = 0;
 		const worker = async () => {
 			for (;;) {
 				const index = nextIndex;
 				nextIndex += 1;
-				if (index >= addonTasks.length) return;
-				outcomes[index] = await this.fetchAddonTask(job, addonTasks[index]);
+				const addonTask = addonTasks[index];
+				if (addonTask === void 0) return;
+				outcomes[index] = await this.fetchAddonTask(job, addonTask);
 			}
 		};
 		const workerCount = Math.min(limit, addonTasks.length);
@@ -91732,7 +91806,7 @@ exports.getWorkerDeviceRegistry = require_manifest_python_deps.getWorkerDeviceRe
 exports.hashClusterSecret = hashClusterSecret;
 exports.installManifestNativeDeps = require_manifest_python_deps.installManifestNativeDeps;
 exports.installManifestPythonDeps = require_manifest_python_deps.installManifestPythonDeps;
-exports.installPackageFromNpmSync = installPackageFromNpmSync;
+exports.installPackageFromNpm = installPackageFromNpm;
 Object.defineProperty(exports, "installPythonPackages", {
 	enumerable: true,
 	get: function() {
@@ -91747,6 +91821,7 @@ Object.defineProperty(exports, "installPythonRequirements", {
 });
 exports.ipcChildLink = require_manifest_python_deps.ipcChildLink;
 exports.ipcParentLink = require_manifest_python_deps.ipcParentLink;
+exports.isAddonDeploySource = isAddonDeploySource;
 exports.isClusterSecretMismatchError = isClusterSecretMismatchError;
 exports.isInfraCapability = isInfraCapability;
 exports.isModelDownloaded = require_model_download_service.isModelDownloaded;