@camstack/system 1.0.7 → 1.1.0

package/dist/kernel/transport/child-cap-protocol.d.ts

@@ -23,6 +23,14 @@ export interface CapCallOutMessage {
     readonly method: string;
     readonly args: unknown;
     readonly deviceId?: number;
+    /**
+     * Optional per-call node pin (out-of-band; NOT part of the validated method
+     * args). When set, the parent routes this singleton/in-process cap call to
+     * the named node's provider instead of the default (hub) resolution — used to
+     * query a remote agent's in-process singleton (e.g. the agent's own
+     * `platform-probe` hardware). Set via `ctx.api`'s `onNode(nodeId)` modifier.
+     */
+    readonly nodeId?: string;
 }
 /** Child → parent: a system event produced by the child to be forwarded to the hub event bus. */
 export interface ChildEventMessage {
@@ -59,6 +67,8 @@ export interface CapCallMessage {
     readonly method: string;
     readonly args: unknown;
     readonly deviceId?: number;
+    /** Optional per-call node pin (out-of-band routing hint; see {@link CapCallOutMessage.nodeId}). */
+    readonly nodeId?: string;
 }
 /** Parent → child: a system event delivered by the hub for the child to handle locally. */
 export interface ParentEventMessage {

package/dist/{manifest-python-deps-eBDj5HEY.js → manifest-python-deps-BWURo7dc.js}

@@ -5,6 +5,7 @@ let node_fs = require("node:fs");
 node_fs = require_chunk.__toESM(node_fs);
 let node_path = require("node:path");
 node_path = require_chunk.__toESM(node_path);
+let _camstack_types = require("@camstack/types");
 let node_crypto = require("node:crypto");
 node_crypto = require_chunk.__toESM(node_crypto);
 let node_child_process = require("node:child_process");
@@ -3647,7 +3648,8 @@ var LocalChildRegistry = class {
 					capName: out.capName,
 					method: out.method,
 					args: out.args,
-					...out.deviceId !== void 0 ? { deviceId: out.deviceId } : {}
+					...out.deviceId !== void 0 ? { deviceId: out.deviceId } : {},
+					...out.nodeId !== void 0 ? { nodeId: out.nodeId } : {}
 				};
 				if (this.resolveChildId(out.capName, out.deviceId) !== null) {
 					if (!this.egressRoutedCaps.has(out.capName)) {
@@ -3892,7 +3894,8 @@ var LocalChildClient = class {
 			capName: input.capName,
 			method: input.method,
 			args: input.args,
-			...input.deviceId !== void 0 ? { deviceId: input.deviceId } : {}
+			...input.deviceId !== void 0 ? { deviceId: input.deviceId } : {},
+			...input.nodeId !== void 0 ? { nodeId: input.nodeId } : {}
 		};
 		return this.channel.request(msg);
 	}
@@ -4586,7 +4589,10 @@ function createParentUnownedCallHandler(deps) {
 		const deviceId = input.deviceId ?? extractDeviceId(input.args);
 		const resolver = deps.getResolver();
 		if (resolver !== null) try {
-			const route = resolver.resolveCapRoute(input.capName, deviceId !== void 0 ? { deviceId } : {});
+			const route = resolver.resolveCapRoute(input.capName, {
+				...input.nodeId !== void 0 ? { nodeId: input.nodeId } : {},
+				...deviceId !== void 0 ? { deviceId } : {}
+			});
 			return await resolver.dispatch(route, input.method, input.args);
 		} catch (err) {
 			if (!(err instanceof CapRouteError) || err.reason !== "no-provider") throw err;
@@ -4623,7 +4629,7 @@ function createParentUnownedCallHandler(deps) {
 			return await brokerCallForCap(deps.broker, input.capName, input.method, input.args);
 		} catch (cause) {
 			const reason = cause instanceof Error ? cause.message : String(cause);
-			throw new Error(`parent could not route child unowned cap call "${input.capName}.${input.method}": ${reason}`, cause instanceof Error ? { cause } : void 0);
+			throw new Error(`parent could not route child unowned cap call "${input.capName}.${input.method}": ${reason}`, { cause });
 		}
 	};
 }
@@ -5031,11 +5037,13 @@ function ipcParentLink(getCallOut) {
 			const input = op.input;
 			const inputObj = input && typeof input === "object" && !Array.isArray(input) ? input : null;
 			const deviceId = inputObj && typeof Reflect.get(inputObj, "deviceId") === "number" ? Reflect.get(inputObj, "deviceId") : void 0;
+			const pinnedNodeId = (0, _camstack_types.readNodePin)(op.context);
 			const capCallInput = {
 				capName: parsed.capName,
 				method: parsed.method,
 				args: op.input,
-				...deviceId !== void 0 ? { deviceId } : {}
+				...deviceId !== void 0 ? { deviceId } : {},
+				...pinnedNodeId !== void 0 ? { nodeId: pinnedNodeId } : {}
 			};
 			return observable((observer) => {
 				callOut(capCallInput).then((data) => {
@@ -5100,7 +5108,7 @@ var CapUsageRegistry = class {
 			let window = byCap.get(rec.capName);
 			if (!window) {
 				window = {
-					buckets: new Array(this.retentionSeconds).fill(0),
+					buckets: Array.from({ length: this.retentionSeconds }, () => 0),
 					lastCallAtMs: 0
 				};
 				byCap.set(rec.capName, window);
@@ -6277,16 +6285,25 @@ async function buildAddonContext(runtime, declaration, dataDir, options) {
 	};
 	const writeBlob = async (coll, key, value, namespace) => {
 		if (!settingsApi) return;
-		await settingsApi.set.mutate(namespace !== void 0 ? {
-			namespace,
-			collection: coll,
-			key,
-			value
-		} : {
-			collection: coll,
-			key,
-			value
-		});
+		try {
+			await settingsApi.set.mutate(namespace !== void 0 ? {
+				namespace,
+				collection: coll,
+				key,
+				value
+			} : {
+				collection: coll,
+				key,
+				value
+			});
+		} catch (err) {
+			const isTrpcError = err instanceof _trpc_client.TRPCClientError;
+			scopedLogger.warn(`settings write failed (${coll}/${key}) — ${isTrpcError ? "transport error" : "store error"}`, { meta: {
+				collection: coll,
+				key,
+				error: (0, _camstack_types_addon.errMsg)(err)
+			} });
+		}
 	};
 	const rmwChains = /* @__PURE__ */ new Map();
 	const serializeRmw = (coll, key, op) => {
@@ -6295,7 +6312,7 @@ async function buildAddonContext(runtime, declaration, dataDir, options) {
 		rmwChains.set(chainKey, next);
 		next.finally(() => {
 			if (rmwChains.get(chainKey) === next) rmwChains.delete(chainKey);
-		});
+		}).catch(() => void 0);
 		return next;
 	};
 	const settingsView = {

package/dist/{manifest-python-deps-CoJXeb9u.mjs → manifest-python-deps-BcrTzHH_.mjs}

@@ -4,6 +4,7 @@ import { createServer } from "node:http";
 import * as fs from "node:fs";
 import * as path$1 from "node:path";
 import { isAbsolute, join } from "node:path";
+import { readNodePin } from "@camstack/types";
 import * as crypto$1 from "node:crypto";
 import { randomBytes, randomUUID } from "node:crypto";
 import { execFile } from "node:child_process";
@@ -11,7 +12,7 @@ import { promisify } from "node:util";
 import * as os from "node:os";
 import { tmpdir } from "node:os";
 import { unlink } from "node:fs/promises";
-import { DATAPLANE_SECRET_HEADER, DeviceType, DisposerChain, EventCategory, ReadinessRegistry, asJsonObject, asString, createDeviceProxy, deviceOpsCapability, emitReadiness, errMsg, expandCapMethods, scopeKey, sleep } from "@camstack/types/addon";
+import { DATAPLANE_SECRET_HEADER as DATAPLANE_SECRET_HEADER$1, DeviceType as DeviceType$1, DisposerChain, EventCategory as EventCategory$1, ReadinessRegistry, asJsonObject as asJsonObject$1, asString as asString$1, createDeviceProxy, deviceOpsCapability, emitReadiness, errMsg as errMsg$1, expandCapMethods, scopeKey, sleep as sleep$1 } from "@camstack/types/addon";
 import { TRPCClientError, createTRPCClient } from "@trpc/client";
 import { connect, createServer as createServer$1 } from "node:net";
 //#region src/kernel/addon-class-resolver.ts
@@ -102,7 +103,7 @@ async function installManifestNativeDeps(addonDir, pkgRaw, logger, registry) {
 		} catch (err) {
 			logger.warn("Failed to write native deps marker", { meta: {
 				markerFile,
-				error: errMsg(err)
+				error: errMsg$1(err)
 			} });
 		}
 		return;
@@ -129,7 +130,7 @@ async function installManifestNativeDeps(addonDir, pkgRaw, logger, registry) {
 			timeout: 3e5
 		});
 	} catch (err) {
-		throw new Error(`npm install of native deps failed for ${addonDir}: ${errMsg(err)}`, { cause: err });
+		throw new Error(`npm install of native deps failed for ${addonDir}: ${errMsg$1(err)}`, { cause: err });
 	}
 	await rebuildNativeDeps(addonDir, pending.map(([name]) => name), logger);
 	try {
@@ -137,7 +138,7 @@ async function installManifestNativeDeps(addonDir, pkgRaw, logger, registry) {
 	} catch (err) {
 		logger.warn("Failed to write native deps marker", { meta: {
 			markerFile,
-			error: errMsg(err)
+			error: errMsg$1(err)
 		} });
 	}
 }
@@ -174,7 +175,7 @@ function copyPrebuiltNativeDep(name, addonDir, logger) {
 			logger.warn("Prebuilt native dep copy failed — will try npm install", { meta: {
 				name,
 				source,
-				error: errMsg(err)
+				error: errMsg$1(err)
 			} });
 		}
 	}
@@ -207,13 +208,13 @@ function candidateHoistedDirs(name, addonDir) {
 }
 /** Read & validate `camstack.nativeDependencies`. Returns null when absent. */
 function readNativeDeps(pkgRaw) {
-	const camstack = asJsonObject(pkgRaw["camstack"]);
+	const camstack = asJsonObject$1(pkgRaw["camstack"]);
 	if (!camstack) return null;
-	const native = asJsonObject(camstack["nativeDependencies"]);
+	const native = asJsonObject$1(camstack["nativeDependencies"]);
 	if (!native) return null;
 	const out = {};
 	for (const [k, v] of Object.entries(native)) {
-		const range = asString(v);
+		const range = asString$1(v);
 		if (range) out[k] = range;
 	}
 	return Object.keys(out).length > 0 ? out : null;
@@ -280,7 +281,7 @@ async function rebuildNativeDeps(addonDir, packageNames, logger) {
 		} catch (err) {
 			logger.warn("Electron rebuild failed (continuing — prebuilt binary may be present)", { meta: {
 				addonDir,
-				error: errMsg(err)
+				error: errMsg$1(err)
 			} });
 		}
 		return;
@@ -298,7 +299,7 @@ async function rebuildNativeDeps(addonDir, packageNames, logger) {
 	} catch (err) {
 		logger.warn("npm rebuild failed (continuing — prebuilt binary may be present)", { meta: {
 			addonDir,
-			error: errMsg(err)
+			error: errMsg$1(err)
 		} });
 	}
 }
@@ -1031,7 +1032,7 @@ async function callWithServiceDiscoveryRetry(broker, actionName, input) {
 		if (!(err instanceof Error ? err.message : String(err)).includes("is not found")) throw err;
 		attempt++;
 		if (attempt === 1) broker.logger.warn(`native-cap-bridge: service not found for "${actionName}", retrying with exponential backoff…`);
-		await sleep(delay);
+		await sleep$1(delay);
 		delay = Math.min(delay * 2, BACKOFF_MAX_MS);
 	}
 }
@@ -1136,7 +1137,7 @@ function createBrokerDeviceManagerApi(opts) {
 			parentDeviceId,
 			logger: (() => {
 				const base = opts.logger.child(stableId);
-				const containerDeviceId = parentDeviceId ?? (deviceMeta?.type === DeviceType.Container ? id : null);
+				const containerDeviceId = parentDeviceId ?? (deviceMeta?.type === DeviceType$1.Container ? id : null);
 				return base.withTags(containerDeviceId !== null ? {
 					deviceId: id,
 					containerDeviceId
@@ -1162,7 +1163,7 @@ function createBrokerDeviceManagerApi(opts) {
 				id,
 				stableId,
 				addonId,
-				type: DeviceType.Camera,
+				type: DeviceType$1.Camera,
 				name: stableId,
 				location: null,
 				disabled: false,
@@ -1228,7 +1229,7 @@ function createBrokerDeviceManagerApi(opts) {
 						type: "device",
 						id
 					},
-					category: EventCategory.DeviceBindingsChanged,
+					category: EventCategory$1.DeviceBindingsChanged,
 					data: {
 						deviceId: id,
 						capName: cap.name,
@@ -1612,7 +1613,7 @@ function createBrokerDeviceManagerApi(opts) {
 						type: "device",
 						id: device.id
 					},
-					category: EventCategory.DeviceReady,
+					category: EventCategory$1.DeviceReady,
 					data: { deviceId: device.id }
 				});
 			};
@@ -1751,7 +1752,7 @@ function createBrokerDeviceManagerApi(opts) {
 						type: "device",
 						id: deviceId
 					},
-					category: EventCategory.DeviceBindingsChanged,
+					category: EventCategory$1.DeviceBindingsChanged,
 					data: {
 						deviceId,
 						capName,
@@ -3646,7 +3647,8 @@ var LocalChildRegistry = class {
 					capName: out.capName,
 					method: out.method,
 					args: out.args,
-					...out.deviceId !== void 0 ? { deviceId: out.deviceId } : {}
+					...out.deviceId !== void 0 ? { deviceId: out.deviceId } : {},
+					...out.nodeId !== void 0 ? { nodeId: out.nodeId } : {}
 				};
 				if (this.resolveChildId(out.capName, out.deviceId) !== null) {
 					if (!this.egressRoutedCaps.has(out.capName)) {
@@ -3891,7 +3893,8 @@ var LocalChildClient = class {
 			capName: input.capName,
 			method: input.method,
 			args: input.args,
-			...input.deviceId !== void 0 ? { deviceId: input.deviceId } : {}
+			...input.deviceId !== void 0 ? { deviceId: input.deviceId } : {},
+			...input.nodeId !== void 0 ? { nodeId: input.nodeId } : {}
 		};
 		return this.channel.request(msg);
 	}
@@ -4585,7 +4588,10 @@ function createParentUnownedCallHandler(deps) {
 		const deviceId = input.deviceId ?? extractDeviceId(input.args);
 		const resolver = deps.getResolver();
 		if (resolver !== null) try {
-			const route = resolver.resolveCapRoute(input.capName, deviceId !== void 0 ? { deviceId } : {});
+			const route = resolver.resolveCapRoute(input.capName, {
+				...input.nodeId !== void 0 ? { nodeId: input.nodeId } : {},
+				...deviceId !== void 0 ? { deviceId } : {}
+			});
 			return await resolver.dispatch(route, input.method, input.args);
 		} catch (err) {
 			if (!(err instanceof CapRouteError) || err.reason !== "no-provider") throw err;
@@ -4622,7 +4628,7 @@ function createParentUnownedCallHandler(deps) {
 			return await brokerCallForCap(deps.broker, input.capName, input.method, input.args);
 		} catch (cause) {
 			const reason = cause instanceof Error ? cause.message : String(cause);
-			throw new Error(`parent could not route child unowned cap call "${input.capName}.${input.method}": ${reason}`, cause instanceof Error ? { cause } : void 0);
+			throw new Error(`parent could not route child unowned cap call "${input.capName}.${input.method}": ${reason}`, { cause });
 		}
 	};
 }
@@ -5030,11 +5036,13 @@ function ipcParentLink(getCallOut) {
 			const input = op.input;
 			const inputObj = input && typeof input === "object" && !Array.isArray(input) ? input : null;
 			const deviceId = inputObj && typeof Reflect.get(inputObj, "deviceId") === "number" ? Reflect.get(inputObj, "deviceId") : void 0;
+			const pinnedNodeId = readNodePin(op.context);
 			const capCallInput = {
 				capName: parsed.capName,
 				method: parsed.method,
 				args: op.input,
-				...deviceId !== void 0 ? { deviceId } : {}
+				...deviceId !== void 0 ? { deviceId } : {},
+				...pinnedNodeId !== void 0 ? { nodeId: pinnedNodeId } : {}
 			};
 			return observable((observer) => {
 				callOut(capCallInput).then((data) => {
@@ -5099,7 +5107,7 @@ var CapUsageRegistry = class {
 			let window = byCap.get(rec.capName);
 			if (!window) {
 				window = {
-					buckets: new Array(this.retentionSeconds).fill(0),
+					buckets: Array.from({ length: this.retentionSeconds }, () => 0),
 					lastCallAtMs: 0
 				};
 				byCap.set(rec.capName, window);
@@ -5319,7 +5327,7 @@ function createAddonDataPlaneFacility(args) {
 	let server = null;
 	let baseUrl = "";
 	const route = (req, res) => {
-		if (req.headers[DATAPLANE_SECRET_HEADER] !== secret) {
+		if (req.headers[DATAPLANE_SECRET_HEADER$1] !== secret) {
 			res.writeHead(403).end();
 			return;
 		}
@@ -5438,7 +5446,7 @@ function resolveNodeRoot() {
 var inFlight = /* @__PURE__ */ new Map();
 var LOCK_STALE_MS = 10 * 6e4;
 var LOCK_POLL_MS = 500;
-function sleep$1(ms) {
+function sleep$2(ms) {
 	return new Promise((resolve) => setTimeout(resolve, ms));
 }
 /**
@@ -5457,7 +5465,7 @@ async function withFileLock(lockPath, fn) {
 	} catch {
 		try {
 			if (Date.now() - fs.statSync(lockPath).mtimeMs > LOCK_STALE_MS) fs.rmSync(lockPath, { force: true });
-			else await sleep$1(LOCK_POLL_MS);
+			else await sleep$2(LOCK_POLL_MS);
 		} catch {}
 	}
 	try {
@@ -6249,7 +6257,7 @@ async function buildAddonContext(runtime, declaration, dataDir, options) {
 	} });
 	registerWorkerDisposerChain(nodeId, addonId, workerDisposerChain);
 	const bindingCache = /* @__PURE__ */ new Map();
-	scopedEventBus.subscribe({ category: EventCategory.DeviceBindingsChanged }, (e) => {
+	scopedEventBus.subscribe({ category: EventCategory$1.DeviceBindingsChanged }, (e) => {
 		const data = e.data ?? {};
 		if (typeof data.deviceId === "number") {
 			bindingCache.delete(data.deviceId);
@@ -6276,16 +6284,25 @@ async function buildAddonContext(runtime, declaration, dataDir, options) {
 	};
 	const writeBlob = async (coll, key, value, namespace) => {
 		if (!settingsApi) return;
-		await settingsApi.set.mutate(namespace !== void 0 ? {
-			namespace,
-			collection: coll,
-			key,
-			value
-		} : {
-			collection: coll,
-			key,
-			value
-		});
+		try {
+			await settingsApi.set.mutate(namespace !== void 0 ? {
+				namespace,
+				collection: coll,
+				key,
+				value
+			} : {
+				collection: coll,
+				key,
+				value
+			});
+		} catch (err) {
+			const isTrpcError = err instanceof TRPCClientError;
+			scopedLogger.warn(`settings write failed (${coll}/${key}) — ${isTrpcError ? "transport error" : "store error"}`, { meta: {
+				collection: coll,
+				key,
+				error: errMsg$1(err)
+			} });
+		}
 	};
 	const rmwChains = /* @__PURE__ */ new Map();
 	const serializeRmw = (coll, key, op) => {
@@ -6294,7 +6311,7 @@ async function buildAddonContext(runtime, declaration, dataDir, options) {
 		rmwChains.set(chainKey, next);
 		next.finally(() => {
 			if (rmwChains.get(chainKey) === next) rmwChains.delete(chainKey);
-		});
+		}).catch(() => void 0);
 		return next;
 	};
 	const settingsView = {

package/dist/{model-download-service-JtVQtbb6.js → model-download-service-1eEOkNeS.js}

@@ -301,6 +301,24 @@ function createFileDataPlaneHandler(opts) {
 }
 //#endregion
 //#region src/download/model-downloader.ts
+function isNonEmptyFile(filePath) {
+	return node_fs.existsSync(filePath) && node_fs.statSync(filePath).size > 0;
+}
+/**
+* Sibling files of a single-file (non-directory) format — extra files the
+* format needs, fetched from the same remote directory as `url` and stored
+* flat alongside the main file in `modelsDir`. Catalog-declared via
+* `formatEntry.files`, e.g. OpenVINO IR lists its `.bin` weights next to the
+* `.xml`. The downloader stays format-agnostic; the convention lives in the
+* catalog data (like `MLPACKAGE_FILES` for the directory case).
+*/
+function siblingFilesFor(formatEntry) {
+	return formatEntry.isDirectory ? [] : formatEntry.files ?? [];
+}
+/** Resolve a sibling's remote URL relative to the main file's directory. */
+function siblingUrl(mainUrl, sibling) {
+	return mainUrl.replace(/[^/]+$/, sibling);
+}
 /** Build fetch headers, including HF auth token for huggingface.co URLs */
 function buildHeaders(url) {
 	const headers = { "User-Agent": "CamStack/1.0" };
@@ -466,14 +484,18 @@ async function ensureModel(modelsDir, entry, format, onProgress) {
 	if (entry.extraFiles) for (const extra of entry.extraFiles) await downloadFile(extra.url, node_path.join(modelsDir, extra.filename));
 	const filename = formatEntry.url.split("/").pop() ?? `${entry.id}.${format}`;
 	const modelPath = node_path.join(modelsDir, filename);
+	const siblings = siblingFilesFor(formatEntry);
 	if (node_fs.existsSync(modelPath)) if (formatEntry.isDirectory && !node_fs.existsSync(node_path.join(modelPath, "Manifest.json"))) node_fs.rmSync(modelPath, {
 		recursive: true,
 		force: true
 	});
-	else return modelPath;
+	else if (siblings.some((f) => !isNonEmptyFile(node_path.join(modelsDir, f)))) {} else return modelPath;
 	node_fs.mkdirSync(modelsDir, { recursive: true });
 	if (formatEntry.isDirectory) await downloadDirectory(formatEntry.url, modelPath, formatEntry.files, onProgress);
-	else await downloadFile(formatEntry.url, modelPath, (downloaded, total) => onProgress?.(downloaded, total === 0 ? void 0 : total));
+	else {
+		await downloadFile(formatEntry.url, modelPath, (downloaded, total) => onProgress?.(downloaded, total === 0 ? void 0 : total));
+		for (const sibling of siblings) await downloadFile(siblingUrl(formatEntry.url, sibling), node_path.join(modelsDir, sibling));
+	}
 	return modelPath;
 }
 /** Compute the on-disk path for a given model + format, even when not yet downloaded. */
@@ -490,17 +512,25 @@ function isModelDownloaded(modelsDir, entry, format) {
 	const modelPath = getModelFilePath(modelsDir, entry, format);
 	if (!modelPath || !node_fs.existsSync(modelPath)) return false;
 	if (formatEntry.isDirectory) return node_fs.existsSync(node_path.join(modelPath, "Manifest.json"));
-	return node_fs.statSync(modelPath).size > 0;
+	if (node_fs.statSync(modelPath).size <= 0) return false;
+	return siblingFilesFor(formatEntry).every((f) => isNonEmptyFile(node_path.join(modelsDir, f)));
 }
 /** Remove the on-disk model file/directory. Returns true if something was deleted. */
 function deleteModelFromDisk(modelsDir, entry, format) {
 	const modelPath = getModelFilePath(modelsDir, entry, format);
 	if (!modelPath || !node_fs.existsSync(modelPath)) return false;
-	if (entry.formats[format]?.isDirectory) node_fs.rmSync(modelPath, {
+	const formatEntry = entry.formats[format];
+	if (formatEntry?.isDirectory) node_fs.rmSync(modelPath, {
 		recursive: true,
 		force: true
 	});
-	else node_fs.unlinkSync(modelPath);
+	else {
+		node_fs.unlinkSync(modelPath);
+		if (formatEntry) for (const sibling of siblingFilesFor(formatEntry)) {
+			const sibPath = node_path.join(modelsDir, sibling);
+			if (node_fs.existsSync(sibPath)) node_fs.unlinkSync(sibPath);
+		}
+	}
 	return true;
 }
 //#endregion

package/dist/{model-download-service-C7AjBsX9.mjs → model-download-service-RxAOiYvX.mjs}

@@ -300,6 +300,24 @@ function createFileDataPlaneHandler(opts) {
 }
 //#endregion
 //#region src/download/model-downloader.ts
+function isNonEmptyFile(filePath) {
+	return fs.existsSync(filePath) && fs.statSync(filePath).size > 0;
+}
+/**
+* Sibling files of a single-file (non-directory) format — extra files the
+* format needs, fetched from the same remote directory as `url` and stored
+* flat alongside the main file in `modelsDir`. Catalog-declared via
+* `formatEntry.files`, e.g. OpenVINO IR lists its `.bin` weights next to the
+* `.xml`. The downloader stays format-agnostic; the convention lives in the
+* catalog data (like `MLPACKAGE_FILES` for the directory case).
+*/
+function siblingFilesFor(formatEntry) {
+	return formatEntry.isDirectory ? [] : formatEntry.files ?? [];
+}
+/** Resolve a sibling's remote URL relative to the main file's directory. */
+function siblingUrl(mainUrl, sibling) {
+	return mainUrl.replace(/[^/]+$/, sibling);
+}
 /** Build fetch headers, including HF auth token for huggingface.co URLs */
 function buildHeaders(url) {
 	const headers = { "User-Agent": "CamStack/1.0" };
@@ -465,14 +483,18 @@ async function ensureModel(modelsDir, entry, format, onProgress) {
 	if (entry.extraFiles) for (const extra of entry.extraFiles) await downloadFile(extra.url, path$1.join(modelsDir, extra.filename));
 	const filename = formatEntry.url.split("/").pop() ?? `${entry.id}.${format}`;
 	const modelPath = path$1.join(modelsDir, filename);
+	const siblings = siblingFilesFor(formatEntry);
 	if (fs.existsSync(modelPath)) if (formatEntry.isDirectory && !fs.existsSync(path$1.join(modelPath, "Manifest.json"))) fs.rmSync(modelPath, {
 		recursive: true,
 		force: true
 	});
-	else return modelPath;
+	else if (siblings.some((f) => !isNonEmptyFile(path$1.join(modelsDir, f)))) {} else return modelPath;
 	fs.mkdirSync(modelsDir, { recursive: true });
 	if (formatEntry.isDirectory) await downloadDirectory(formatEntry.url, modelPath, formatEntry.files, onProgress);
-	else await downloadFile(formatEntry.url, modelPath, (downloaded, total) => onProgress?.(downloaded, total === 0 ? void 0 : total));
+	else {
+		await downloadFile(formatEntry.url, modelPath, (downloaded, total) => onProgress?.(downloaded, total === 0 ? void 0 : total));
+		for (const sibling of siblings) await downloadFile(siblingUrl(formatEntry.url, sibling), path$1.join(modelsDir, sibling));
+	}
 	return modelPath;
 }
 /** Compute the on-disk path for a given model + format, even when not yet downloaded. */
@@ -489,17 +511,25 @@ function isModelDownloaded(modelsDir, entry, format) {
 	const modelPath = getModelFilePath(modelsDir, entry, format);
 	if (!modelPath || !fs.existsSync(modelPath)) return false;
 	if (formatEntry.isDirectory) return fs.existsSync(path$1.join(modelPath, "Manifest.json"));
-	return fs.statSync(modelPath).size > 0;
+	if (fs.statSync(modelPath).size <= 0) return false;
+	return siblingFilesFor(formatEntry).every((f) => isNonEmptyFile(path$1.join(modelsDir, f)));
 }
 /** Remove the on-disk model file/directory. Returns true if something was deleted. */
 function deleteModelFromDisk(modelsDir, entry, format) {
 	const modelPath = getModelFilePath(modelsDir, entry, format);
 	if (!modelPath || !fs.existsSync(modelPath)) return false;
-	if (entry.formats[format]?.isDirectory) fs.rmSync(modelPath, {
+	const formatEntry = entry.formats[format];
+	if (formatEntry?.isDirectory) fs.rmSync(modelPath, {
 		recursive: true,
 		force: true
 	});
-	else fs.unlinkSync(modelPath);
+	else {
+		fs.unlinkSync(modelPath);
+		if (formatEntry) for (const sibling of siblingFilesFor(formatEntry)) {
+			const sibPath = path$1.join(modelsDir, sibling);
+			if (fs.existsSync(sibPath)) fs.unlinkSync(sibPath);
+		}
+	}
 	return true;
 }
 //#endregion

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/system",
-  "version": "1.0.7",
+  "version": "1.1.0",
   "description": "Core addon for CamStack — builtins, pipeline, process management, auth, logging, events",
   "keywords": [
     "camstack",