@camstack/addon-ai 0.4.29 → 0.4.31

package/dist/addon.js

@@ -4,14 +4,11 @@ Object.defineProperties(exports, {
 });
 const require_chunk = require("./chunk-CVvi-lCc.js");
 let node_path = require("node:path");
-let node_path$1 = require_chunk.__toESM(node_path, 1);
 node_path = require_chunk.__toESM(node_path);
 let node_crypto = require("node:crypto");
 let node_net = require("node:net");
 let node_fs = require("node:fs");
-node_fs = require_chunk.__toESM(node_fs, 1);
-let node_util = require("node:util");
-let node_zlib = require("node:zlib");
+let _camstack_system_addon_utils = require("@camstack/system/addon-utils");
 let node_fs_promises = require("node:fs/promises");
 node_fs_promises = require_chunk.__toESM(node_fs_promises);
 let node_child_process = require("node:child_process");
@@ -6079,6 +6076,40 @@ var BaseAddon = class {
 	deviceSettingsSchema() {
 		return null;
 	}
+	/**
+	* INTEGRATION-LEVEL SETTINGS — declare which of this addon's global sections
+	* ARE the configuration of its integration.
+	*
+	* Return the `ConfigSection.id`s, from {@link globalSettingsSchema}, that an
+	* operator should find on the addon's integration page (System →
+	* Integrations → <name>) rather than only in the cluster-wide list of every
+	* addon. Empty (the default) means the addon has no integration-level
+	* settings and no such surface is offered — this is opt-in, because whether
+	* an addon's configuration IS its integration's configuration depends on the
+	* nature of the integration.
+	*
+	* WHAT THIS IS NOT. It is not a scope. The selected sections keep living in
+	* the ONE global schema, in the ONE addon store, written by the ONE
+	* `updateGlobalSettings` path. There is deliberately no
+	* `updateIntegrationSettings`: a second write path is how a surface acquires
+	* a second store key, and this repo has shipped that twice (`btmPath@hub`,
+	* D266). Selecting sections cannot introduce a key that selecting cannot.
+	*
+	* WHY IT IS A LIST OF SECTION IDS AND NOT A MARKER ON THE SECTION.
+	* `ConfigFieldBase` used to carry `scope?: 'device' | 'global'` and it was
+	* removed with the reason recorded at
+	* `packages/types/src/interfaces/config-ui.ts:249` — *"a field's scope is
+	* determined by WHICH schema it lives in, not by a field-level marker."* A
+	* marker sprinkled across sections also has to borrow a field that already
+	* means something else; borrowing `section.tab` put the literal word
+	* "integration" into an operator-facing tab bar, because `tab` means "how to
+	* GROUP this visually" and cannot also mean "where this lives" (D269
+	* supersedes D268). One declaration, in one place, next to the schema whose
+	* ids it names.
+	*/
+	integrationSettingSections() {
+		return [];
+	}
 	async getGlobalSettings(overlay, cap, nodeId) {
 		const schema = this.globalSettingsSchema(cap);
 		if (!schema) return { sections: [] };
@@ -6089,6 +6120,55 @@ var BaseAddon = class {
 		} : projected);
 	}
 	/**
+	* The integration-level view of this addon's settings: exactly the sections
+	* named by {@link integrationSettingSections}, hydrated from the SAME store
+	* `getGlobalSettings` reads, and narrowed to cluster-scoped fields.
+	*
+	* Returns `null` when the addon declared nothing — an addon that opts out has
+	* no integration settings surface at all, rather than an empty one that reads
+	* as a failed load.
+	*
+	* Three properties hold BY CONSTRUCTION, which is why they are here in core
+	* and not in whichever UI happens to render this:
+	*
+	*  1. **One key.** The payload is a SUBSET of the global schema, so a field
+	*     shown here is the same field, with the same bare key, that the addon's
+	*     own page shows. There is no integration-specific writer — callers save
+	*     through `updateGlobalSettings` — so a second store key is unreachable,
+	*     not merely discouraged.
+	*  2. **No node scope.** `perNode: true` fields are DROPPED. Their store key
+	*     is `<key>@<nodeId>` and an integration is not a node; whichever node
+	*     such a field silently picked would be a wrong answer for the operator
+	*     who opened the page (D266).
+	*  3. **No silent typo.** A declared id that names no section throws. The
+	*     alternative — skip it — turns a rename into a surface that quietly
+	*     empties, which looks exactly like an addon with nothing to configure.
+	*/
+	async getIntegrationSettings(nodeId) {
+		const declared = this.integrationSettingSections();
+		if (declared.length === 0) return null;
+		const schema = this.globalSettingsSchema();
+		if (!schema) throw new Error(`${this.constructor.name}: integrationSettingSections() names [${declared.join(", ")}] but globalSettingsSchema() returns null.`);
+		const byId = new Map(schema.sections.map((section) => [section.id, section]));
+		const sections = [];
+		for (const id of declared) {
+			const section = byId.get(id);
+			if (!section) throw new Error(`${this.constructor.name}: integrationSettingSections() names unknown section "${id}". Known sections: [${[...byId.keys()].join(", ")}].`);
+			const fields = dropPerNodeFields(section.fields);
+			if (fields.length === 0) continue;
+			sections.push({
+				...section,
+				fields
+			});
+		}
+		if (sections.length === 0) return null;
+		const projected = await this.resolveGlobalStore(nodeId);
+		return hydrateSchema({
+			...schema,
+			sections
+		}, projected);
+	}
+	/**
 	* The raw addon store PROJECTED onto the target node's bare per-node keys:
 	* every `perNode: true` field carries THAT node's scoped value on its bare
 	* key (absent scoped key ⇒ key absent, so the schema `default` wins — no
@@ -6392,6 +6472,41 @@ var BaseAddon = class {
 * `hydrateSchema` does. Valueless structural fields (separator/info/…)
 * don't declare `perNode` and are excluded by the `in` narrowing.
 */
+/**
+* The same fields with every `perNode: true` one removed, recursing into layout
+* containers exactly as {@link collectPerNodeFieldKeys} does. A container left
+* with no child is dropped rather than rendered empty.
+*
+* Used by `getIntegrationSettings`: an integration is not a node, so a field
+* whose store key is `<key>@<nodeId>` has no node to belong to there.
+*/
+function dropPerNodeFields(fields) {
+	const kept = [];
+	for (const field of fields) {
+		if (field.type === "group") {
+			const inner = dropPerNodeFields(field.fields);
+			if (inner.length > 0) kept.push({
+				...field,
+				fields: inner
+			});
+			continue;
+		}
+		if (field.type === "sub-tabs") {
+			const tabs = field.tabs.map((tab) => ({
+				...tab,
+				fields: dropPerNodeFields(tab.fields)
+			})).filter((tab) => tab.fields.length > 0);
+			if (tabs.length > 0) kept.push({
+				...field,
+				tabs
+			});
+			continue;
+		}
+		if ("perNode" in field && field.perNode === true) continue;
+		kept.push(field);
+	}
+	return kept;
+}
 function collectPerNodeFieldKeys(fields) {
 	const collected = [];
 	for (const field of fields) {
@@ -9604,6 +9719,9 @@ method(object({
 	kind: "mutation",
 	auth: "admin"
 }), method(object({
+	addonId: string(),
+	nodeId: string().optional()
+}), SettingsSchemaWithValuesSchema.nullable()), method(object({
 	addonId: string(),
 	deviceId: number$1(),
 	nodeId: string().optional()
@@ -28092,6 +28210,12 @@ Object.freeze({
 		addonId: null,
 		access: "view"
 	},
+	"addonSettings.getIntegrationSettings": {
+		capName: "addon-settings",
+		capScope: "system",
+		addonId: null,
+		access: "view"
+	},
 	"addonSettings.updateDeviceSettings": {
 		capName: "addon-settings",
 		capScope: "system",
@@ -61226,12 +61350,12 @@ var require_auth_config = /* @__PURE__ */ require_chunk.__commonJSMin(((exports,
 	});
 	module.exports = __toCommonJS(auth_config_exports);
 	var fs$1 = __toESM(require("fs"));
-	var path$2 = __toESM(require("path"));
+	var path$1 = __toESM(require("path"));
 	var import_token_util = require_token_util();
 	function getAuthConfigPath() {
 		const dataDir = (0, import_token_util.getVercelDataDir)();
 		if (!dataDir) throw new Error(`Unable to find Vercel CLI data directory. Your platform: ${process.platform}. Supported: darwin, linux, win32.`);
-		return path$2.join(dataDir, "auth.json");
+		return path$1.join(dataDir, "auth.json");
 	}
 	function readAuthConfig() {
 		try {
@@ -61246,7 +61370,7 @@ var require_auth_config = /* @__PURE__ */ require_chunk.__commonJSMin(((exports,
 	}
 	function writeAuthConfig(config) {
 		const authPath = getAuthConfigPath();
-		const authDir = path$2.dirname(authPath);
+		const authDir = path$1.dirname(authPath);
 		if (!fs$1.existsSync(authDir)) fs$1.mkdirSync(authDir, {
 			mode: 504,
 			recursive: true
@@ -61384,7 +61508,7 @@ var require_token_util = /* @__PURE__ */ require_chunk.__commonJSMin(((exports,
 		saveToken: () => saveToken
 	});
 	module.exports = __toCommonJS(token_util_exports);
-	var path$1 = __toESM(require("path"));
+	var path = __toESM(require("path"));
 	var fs = __toESM(require("fs"));
 	var import_token_error = require_token_error();
 	var import_token_io = require_token_io();
@@ -61395,7 +61519,7 @@ var require_token_util = /* @__PURE__ */ require_chunk.__commonJSMin(((exports,
 		const vercelFolder = "com.vercel.cli";
 		const dataDir = (0, import_token_io.getUserDataDir)();
 		if (!dataDir) return null;
-		return path$1.join(dataDir, vercelFolder);
+		return path.join(dataDir, vercelFolder);
 	}
 	async function getVercelToken(options) {
 		const authConfig = (0, import_auth_config.readAuthConfig)();
@@ -61443,7 +61567,7 @@ var require_token_util = /* @__PURE__ */ require_chunk.__commonJSMin(((exports,
 	function findProjectInfo() {
 		const dir = (0, import_token_io.findRootDir)();
 		if (!dir) throw new import_token_error.VercelOidcTokenError("Unable to find project root directory. Have you linked your project with `vc link?`");
-		const prjPath = path$1.join(dir, ".vercel", "project.json");
+		const prjPath = path.join(dir, ".vercel", "project.json");
 		if (!fs.existsSync(prjPath)) throw new import_token_error.VercelOidcTokenError("project.json not found, have you linked your project with `vc link?`");
 		const prj = JSON.parse(fs.readFileSync(prjPath, "utf8"));
 		if (typeof prj.projectId !== "string" && typeof prj.orgId !== "string") throw new TypeError("Expected a string-valued projectId property. Try running `vc link` to re-link your project.");
@@ -61455,9 +61579,9 @@ var require_token_util = /* @__PURE__ */ require_chunk.__commonJSMin(((exports,
 	function saveToken(token, projectId) {
 		const dir = (0, import_token_io.getUserDataDir)();
 		if (!dir) throw new import_token_error.VercelOidcTokenError("Unable to find user data directory. Please reach out to Vercel support.");
-		const tokenPath = path$1.join(dir, "com.vercel.token", `${projectId}.json`);
+		const tokenPath = path.join(dir, "com.vercel.token", `${projectId}.json`);
 		const tokenJson = JSON.stringify(token);
-		fs.mkdirSync(path$1.dirname(tokenPath), {
+		fs.mkdirSync(path.dirname(tokenPath), {
 			mode: 504,
 			recursive: true
 		});
@@ -61467,7 +61591,7 @@ var require_token_util = /* @__PURE__ */ require_chunk.__commonJSMin(((exports,
 	function loadToken(projectId) {
 		const dir = (0, import_token_io.getUserDataDir)();
 		if (!dir) throw new import_token_error.VercelOidcTokenError("Unable to find user data directory. Please reach out to Vercel support.");
-		const tokenPath = path$1.join(dir, "com.vercel.token", `${projectId}.json`);
+		const tokenPath = path.join(dir, "com.vercel.token", `${projectId}.json`);
 		if (!fs.existsSync(tokenPath)) return null;
 		const token = JSON.parse(fs.readFileSync(tokenPath, "utf8"));
 		assertVercelOidcTokenResponse(token);
@@ -73473,147 +73597,6 @@ function entryForRef(ref) {
 	};
 }
 //#endregion
-//#region ../system/dist/file-data-plane-BhKdxJgf.mjs
-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 ?? [];
-}
-/** Build fetch headers, including HF auth token for huggingface.co URLs */
-function buildHeaders(url) {
-	const headers = { "User-Agent": "CamStack/1.0" };
-	const hfToken = process.env["HF_TOKEN"] ?? process.env["HUGGING_FACE_HUB_TOKEN"];
-	if (hfToken && url.includes("huggingface.co")) headers["Authorization"] = `Bearer ${hfToken}`;
-	return headers;
-}
-var DEFAULT_MAX_REDIRECTS = 5;
-function normalizeDownloadOptions(third) {
-	if (typeof third === "function") return { onProgress: third };
-	return third ?? {};
-}
-function isRedirectStatus(status) {
-	return status === 301 || status === 302 || status === 303 || status === 307 || status === 308;
-}
-function resolveRedirectUrl(current, location) {
-	return new URL(location, current);
-}
-async function downloadFile(url, destPath, onProgressOrOptions) {
-	if (node_fs.existsSync(destPath)) return destPath;
-	const opts = normalizeDownloadOptions(onProgressOrOptions);
-	const fetchImpl = opts.fetchImpl ?? fetch;
-	const maxRedirects = opts.maxRedirects ?? DEFAULT_MAX_REDIRECTS;
-	node_fs.mkdirSync(node_path$1.dirname(destPath), { recursive: true });
-	const tmpPath = destPath + ".downloading";
-	try {
-		let current = url;
-		const seen = /* @__PURE__ */ new Set();
-		let response;
-		const manual = opts.redirectPolicy !== void 0;
-		for (let hop = 0; hop <= maxRedirects; hop++) {
-			const parsed = new URL(current);
-			if (opts.redirectPolicy) opts.redirectPolicy(parsed, hop);
-			if (seen.has(parsed.href)) throw new Error(`Redirect loop detected at ${parsed.href}`);
-			seen.add(parsed.href);
-			const controller = opts.timeoutMs !== void 0 ? new AbortController() : void 0;
-			const timer = controller && opts.timeoutMs !== void 0 ? setTimeout(() => controller.abort(), opts.timeoutMs) : void 0;
-			try {
-				response = await fetchImpl(current, {
-					redirect: manual ? "manual" : "follow",
-					headers: buildHeaders(current),
-					...controller ? { signal: controller.signal } : {}
-				});
-			} finally {
-				if (timer) clearTimeout(timer);
-			}
-			if (manual && isRedirectStatus(response.status)) {
-				const location = response.headers.get("location");
-				if (!location) throw new Error(`Redirect ${response.status} missing Location header`);
-				if (hop >= maxRedirects) throw new Error(`Too many redirects (max ${maxRedirects}) downloading ${url}`);
-				current = resolveRedirectUrl(current, location).href;
-				continue;
-			}
-			break;
-		}
-		if (!response) throw new Error(`No response downloading ${url}`);
-		if (manual && isRedirectStatus(response.status)) throw new Error(`Too many redirects (max ${maxRedirects}) downloading ${url}`);
-		if (!response.ok) throw new Error(`HTTP ${response.status} downloading ${url}`);
-		if (!response.body) throw new Error(`No response body from ${url}`);
-		const total = parseInt(response.headers.get("content-length") ?? "0", 10);
-		let downloaded = 0;
-		const fileStream = node_fs.createWriteStream(tmpPath);
-		const reader = response.body.getReader();
-		try {
-			for (;;) {
-				const { done, value } = await reader.read();
-				if (done || !value) break;
-				downloaded += value.length;
-				if (opts.maxBytes !== void 0 && downloaded > opts.maxBytes) throw new Error(`Downloaded ${downloaded} bytes exceeds the ${opts.maxBytes}-byte limit`);
-				fileStream.write(value);
-				opts.onProgress?.(downloaded, total);
-			}
-		} finally {
-			fileStream.end();
-			await new Promise((resolve, reject) => {
-				fileStream.on("finish", resolve);
-				fileStream.on("error", reject);
-			});
-		}
-		node_fs.renameSync(tmpPath, destPath);
-		return destPath;
-	} catch (err) {
-		try {
-			node_fs.unlinkSync(tmpPath);
-		} catch {}
-		throw err;
-	}
-}
-/** Compute the on-disk path for a given model + format, even when not yet downloaded. */
-function getModelFilePath(modelsDir, entry, format) {
-	const formatEntry = entry.formats[format];
-	if (!formatEntry) return null;
-	const filename = formatEntry.url.split("/").pop() ?? `${entry.id}.${format}`;
-	return node_path$1.join(modelsDir, filename);
-}
-/** True iff the model file (or `Manifest.json` for directory bundles) exists and is non-empty. */
-function isModelDownloaded(modelsDir, entry, format) {
-	const formatEntry = entry.formats[format];
-	if (!formatEntry) return false;
-	const modelPath = getModelFilePath(modelsDir, entry, format);
-	if (!modelPath || !node_fs.existsSync(modelPath)) return false;
-	if (formatEntry.isDirectory) return node_fs.existsSync(node_path$1.join(modelPath, "Manifest.json"));
-	if (node_fs.statSync(modelPath).size <= 0) return false;
-	return siblingFilesFor(formatEntry).every((f) => isNonEmptyFile(node_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 || !node_fs.existsSync(modelPath)) return false;
-	const formatEntry = entry.formats[format];
-	if (formatEntry?.isDirectory) node_fs.rmSync(modelPath, {
-		recursive: true,
-		force: true
-	});
-	else {
-		node_fs.unlinkSync(modelPath);
-		if (formatEntry) for (const sibling of siblingFilesFor(formatEntry)) {
-			const sibPath = node_path$1.join(modelsDir, sibling);
-			if (node_fs.existsSync(sibPath)) node_fs.unlinkSync(sibPath);
-		}
-	}
-	return true;
-}
-(0, node_util.promisify)(node_zlib.brotliCompress);
-(0, node_util.promisify)(node_zlib.gzip);
-//#endregion
 //#region src/runtime/model-ops.ts
 /**
 * Default `RuntimeModelOps` — the ONLY place the reused object-detection model
@@ -73677,7 +73660,7 @@ function createDefaultModelOps(modelsDir) {
 					downloadedBytes: carried,
 					...totalBytes > 0 ? { totalBytes } : {}
 				});
-				await downloadFile(file.url, file.destPath, (downloaded) => {
+				await (0, _camstack_system_addon_utils.downloadFile)(file.url, file.destPath, (downloaded) => {
 					onProgress({
 						file: file.filename,
 						fileIndex: index + 1,
@@ -73688,18 +73671,18 @@ function createDefaultModelOps(modelsDir) {
 				});
 				carried += (0, node_fs.existsSync)(file.destPath) ? (0, node_fs.statSync)(file.destPath).size : file.expectedBytes;
 			}
-			const main = getModelFilePath(modelsDir, entry, GGUF);
+			const main = (0, _camstack_system_addon_utils.getModelFilePath)(modelsDir, entry, GGUF);
 			if (main === null) throw new Error(`no gguf path for model ${entry.id}`);
 			return main;
 		},
-		isDownloaded: (entry) => isModelDownloaded(modelsDir, entry, GGUF),
+		isDownloaded: (entry) => (0, _camstack_system_addon_utils.isModelDownloaded)(modelsDir, entry, GGUF),
 		pathFor: (entry) => {
-			const p = getModelFilePath(modelsDir, entry, GGUF);
+			const p = (0, _camstack_system_addon_utils.getModelFilePath)(modelsDir, entry, GGUF);
 			if (p === null) throw new Error(`no gguf path for model ${entry.id}`);
 			return p;
 		},
 		delete: async (entry) => {
-			deleteModelFromDisk(modelsDir, entry, GGUF);
+			(0, _camstack_system_addon_utils.deleteModelFromDisk)(modelsDir, entry, GGUF);
 		},
 		extraFilePath: (_entry, filename) => node_path.join(modelsDir, filename)
 	};

package/dist/addon.mjs

@@ -1,11 +1,9 @@
 import { createRequire } from "node:module";
-import * as path$1 from "node:path";
+import * as path from "node:path";
 import { createHash, randomUUID } from "node:crypto";
 import { connect, createServer } from "node:net";
-import * as fs from "node:fs";
 import { createReadStream, existsSync, statSync } from "node:fs";
-import { promisify } from "node:util";
-import { brotliCompress, gzip } from "node:zlib";
+import { deleteModelFromDisk, downloadFile, getModelFilePath, isModelDownloaded } from "@camstack/system/addon-utils";
 import * as fsp from "node:fs/promises";
 import { spawn } from "node:child_process";
 //#region \0rolldown/runtime.js
@@ -6105,6 +6103,40 @@ var BaseAddon = class {
 	deviceSettingsSchema() {
 		return null;
 	}
+	/**
+	* INTEGRATION-LEVEL SETTINGS — declare which of this addon's global sections
+	* ARE the configuration of its integration.
+	*
+	* Return the `ConfigSection.id`s, from {@link globalSettingsSchema}, that an
+	* operator should find on the addon's integration page (System →
+	* Integrations → <name>) rather than only in the cluster-wide list of every
+	* addon. Empty (the default) means the addon has no integration-level
+	* settings and no such surface is offered — this is opt-in, because whether
+	* an addon's configuration IS its integration's configuration depends on the
+	* nature of the integration.
+	*
+	* WHAT THIS IS NOT. It is not a scope. The selected sections keep living in
+	* the ONE global schema, in the ONE addon store, written by the ONE
+	* `updateGlobalSettings` path. There is deliberately no
+	* `updateIntegrationSettings`: a second write path is how a surface acquires
+	* a second store key, and this repo has shipped that twice (`btmPath@hub`,
+	* D266). Selecting sections cannot introduce a key that selecting cannot.
+	*
+	* WHY IT IS A LIST OF SECTION IDS AND NOT A MARKER ON THE SECTION.
+	* `ConfigFieldBase` used to carry `scope?: 'device' | 'global'` and it was
+	* removed with the reason recorded at
+	* `packages/types/src/interfaces/config-ui.ts:249` — *"a field's scope is
+	* determined by WHICH schema it lives in, not by a field-level marker."* A
+	* marker sprinkled across sections also has to borrow a field that already
+	* means something else; borrowing `section.tab` put the literal word
+	* "integration" into an operator-facing tab bar, because `tab` means "how to
+	* GROUP this visually" and cannot also mean "where this lives" (D269
+	* supersedes D268). One declaration, in one place, next to the schema whose
+	* ids it names.
+	*/
+	integrationSettingSections() {
+		return [];
+	}
 	async getGlobalSettings(overlay, cap, nodeId) {
 		const schema = this.globalSettingsSchema(cap);
 		if (!schema) return { sections: [] };
@@ -6115,6 +6147,55 @@ var BaseAddon = class {
 		} : projected);
 	}
 	/**
+	* The integration-level view of this addon's settings: exactly the sections
+	* named by {@link integrationSettingSections}, hydrated from the SAME store
+	* `getGlobalSettings` reads, and narrowed to cluster-scoped fields.
+	*
+	* Returns `null` when the addon declared nothing — an addon that opts out has
+	* no integration settings surface at all, rather than an empty one that reads
+	* as a failed load.
+	*
+	* Three properties hold BY CONSTRUCTION, which is why they are here in core
+	* and not in whichever UI happens to render this:
+	*
+	*  1. **One key.** The payload is a SUBSET of the global schema, so a field
+	*     shown here is the same field, with the same bare key, that the addon's
+	*     own page shows. There is no integration-specific writer — callers save
+	*     through `updateGlobalSettings` — so a second store key is unreachable,
+	*     not merely discouraged.
+	*  2. **No node scope.** `perNode: true` fields are DROPPED. Their store key
+	*     is `<key>@<nodeId>` and an integration is not a node; whichever node
+	*     such a field silently picked would be a wrong answer for the operator
+	*     who opened the page (D266).
+	*  3. **No silent typo.** A declared id that names no section throws. The
+	*     alternative — skip it — turns a rename into a surface that quietly
+	*     empties, which looks exactly like an addon with nothing to configure.
+	*/
+	async getIntegrationSettings(nodeId) {
+		const declared = this.integrationSettingSections();
+		if (declared.length === 0) return null;
+		const schema = this.globalSettingsSchema();
+		if (!schema) throw new Error(`${this.constructor.name}: integrationSettingSections() names [${declared.join(", ")}] but globalSettingsSchema() returns null.`);
+		const byId = new Map(schema.sections.map((section) => [section.id, section]));
+		const sections = [];
+		for (const id of declared) {
+			const section = byId.get(id);
+			if (!section) throw new Error(`${this.constructor.name}: integrationSettingSections() names unknown section "${id}". Known sections: [${[...byId.keys()].join(", ")}].`);
+			const fields = dropPerNodeFields(section.fields);
+			if (fields.length === 0) continue;
+			sections.push({
+				...section,
+				fields
+			});
+		}
+		if (sections.length === 0) return null;
+		const projected = await this.resolveGlobalStore(nodeId);
+		return hydrateSchema({
+			...schema,
+			sections
+		}, projected);
+	}
+	/**
 	* The raw addon store PROJECTED onto the target node's bare per-node keys:
 	* every `perNode: true` field carries THAT node's scoped value on its bare
 	* key (absent scoped key ⇒ key absent, so the schema `default` wins — no
@@ -6418,6 +6499,41 @@ var BaseAddon = class {
 * `hydrateSchema` does. Valueless structural fields (separator/info/…)
 * don't declare `perNode` and are excluded by the `in` narrowing.
 */
+/**
+* The same fields with every `perNode: true` one removed, recursing into layout
+* containers exactly as {@link collectPerNodeFieldKeys} does. A container left
+* with no child is dropped rather than rendered empty.
+*
+* Used by `getIntegrationSettings`: an integration is not a node, so a field
+* whose store key is `<key>@<nodeId>` has no node to belong to there.
+*/
+function dropPerNodeFields(fields) {
+	const kept = [];
+	for (const field of fields) {
+		if (field.type === "group") {
+			const inner = dropPerNodeFields(field.fields);
+			if (inner.length > 0) kept.push({
+				...field,
+				fields: inner
+			});
+			continue;
+		}
+		if (field.type === "sub-tabs") {
+			const tabs = field.tabs.map((tab) => ({
+				...tab,
+				fields: dropPerNodeFields(tab.fields)
+			})).filter((tab) => tab.fields.length > 0);
+			if (tabs.length > 0) kept.push({
+				...field,
+				tabs
+			});
+			continue;
+		}
+		if ("perNode" in field && field.perNode === true) continue;
+		kept.push(field);
+	}
+	return kept;
+}
 function collectPerNodeFieldKeys(fields) {
 	const collected = [];
 	for (const field of fields) {
@@ -9630,6 +9746,9 @@ method(object({
 	kind: "mutation",
 	auth: "admin"
 }), method(object({
+	addonId: string(),
+	nodeId: string().optional()
+}), SettingsSchemaWithValuesSchema.nullable()), method(object({
 	addonId: string(),
 	deviceId: number$1(),
 	nodeId: string().optional()
@@ -28118,6 +28237,12 @@ Object.freeze({
 		addonId: null,
 		access: "view"
 	},
+	"addonSettings.getIntegrationSettings": {
+		capName: "addon-settings",
+		capScope: "system",
+		addonId: null,
+		access: "view"
+	},
 	"addonSettings.updateDeviceSettings": {
 		capName: "addon-settings",
 		capScope: "system",
@@ -61251,7 +61376,7 @@ var require_auth_config = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 		writeAuthConfig: () => writeAuthConfig
 	});
 	module.exports = __toCommonJS(auth_config_exports);
-	var fs$2 = __toESM(__require("fs"));
+	var fs$1 = __toESM(__require("fs"));
 	var path$2 = __toESM(__require("path"));
 	var import_token_util = require_token_util();
 	function getAuthConfigPath() {
@@ -61262,8 +61387,8 @@ var require_auth_config = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 	function readAuthConfig() {
 		try {
 			const authPath = getAuthConfigPath();
-			if (!fs$2.existsSync(authPath)) return null;
-			const content = fs$2.readFileSync(authPath, "utf8");
+			if (!fs$1.existsSync(authPath)) return null;
+			const content = fs$1.readFileSync(authPath, "utf8");
 			if (!content) return null;
 			return JSON.parse(content);
 		} catch (error) {
@@ -61273,11 +61398,11 @@ var require_auth_config = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 	function writeAuthConfig(config) {
 		const authPath = getAuthConfigPath();
 		const authDir = path$2.dirname(authPath);
-		if (!fs$2.existsSync(authDir)) fs$2.mkdirSync(authDir, {
+		if (!fs$1.existsSync(authDir)) fs$1.mkdirSync(authDir, {
 			mode: 504,
 			recursive: true
 		});
-		fs$2.writeFileSync(authPath, JSON.stringify(config, null, 2), { mode: 384 });
+		fs$1.writeFileSync(authPath, JSON.stringify(config, null, 2), { mode: 384 });
 	}
 	function isValidAccessToken(authConfig, expirationBufferMs = 0) {
 		if (!authConfig.token) return false;
@@ -61410,8 +61535,8 @@ var require_token_util = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 		saveToken: () => saveToken
 	});
 	module.exports = __toCommonJS(token_util_exports);
-	var path = __toESM(__require("path"));
-	var fs$1 = __toESM(__require("fs"));
+	var path$1 = __toESM(__require("path"));
+	var fs = __toESM(__require("fs"));
 	var import_token_error = require_token_error();
 	var import_token_io = require_token_io();
 	var import_auth_config = require_auth_config();
@@ -61421,7 +61546,7 @@ var require_token_util = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 		const vercelFolder = "com.vercel.cli";
 		const dataDir = (0, import_token_io.getUserDataDir)();
 		if (!dataDir) return null;
-		return path.join(dataDir, vercelFolder);
+		return path$1.join(dataDir, vercelFolder);
 	}
 	async function getVercelToken(options) {
 		const authConfig = (0, import_auth_config.readAuthConfig)();
@@ -61469,9 +61594,9 @@ var require_token_util = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 	function findProjectInfo() {
 		const dir = (0, import_token_io.findRootDir)();
 		if (!dir) throw new import_token_error.VercelOidcTokenError("Unable to find project root directory. Have you linked your project with `vc link?`");
-		const prjPath = path.join(dir, ".vercel", "project.json");
-		if (!fs$1.existsSync(prjPath)) throw new import_token_error.VercelOidcTokenError("project.json not found, have you linked your project with `vc link?`");
-		const prj = JSON.parse(fs$1.readFileSync(prjPath, "utf8"));
+		const prjPath = path$1.join(dir, ".vercel", "project.json");
+		if (!fs.existsSync(prjPath)) throw new import_token_error.VercelOidcTokenError("project.json not found, have you linked your project with `vc link?`");
+		const prj = JSON.parse(fs.readFileSync(prjPath, "utf8"));
 		if (typeof prj.projectId !== "string" && typeof prj.orgId !== "string") throw new TypeError("Expected a string-valued projectId property. Try running `vc link` to re-link your project.");
 		return {
 			projectId: prj.projectId,
@@ -61481,21 +61606,21 @@ var require_token_util = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 	function saveToken(token, projectId) {
 		const dir = (0, import_token_io.getUserDataDir)();
 		if (!dir) throw new import_token_error.VercelOidcTokenError("Unable to find user data directory. Please reach out to Vercel support.");
-		const tokenPath = path.join(dir, "com.vercel.token", `${projectId}.json`);
+		const tokenPath = path$1.join(dir, "com.vercel.token", `${projectId}.json`);
 		const tokenJson = JSON.stringify(token);
-		fs$1.mkdirSync(path.dirname(tokenPath), {
+		fs.mkdirSync(path$1.dirname(tokenPath), {
 			mode: 504,
 			recursive: true
 		});
-		fs$1.writeFileSync(tokenPath, tokenJson);
-		fs$1.chmodSync(tokenPath, 432);
+		fs.writeFileSync(tokenPath, tokenJson);
+		fs.chmodSync(tokenPath, 432);
 	}
 	function loadToken(projectId) {
 		const dir = (0, import_token_io.getUserDataDir)();
 		if (!dir) throw new import_token_error.VercelOidcTokenError("Unable to find user data directory. Please reach out to Vercel support.");
-		const tokenPath = path.join(dir, "com.vercel.token", `${projectId}.json`);
-		if (!fs$1.existsSync(tokenPath)) return null;
-		const token = JSON.parse(fs$1.readFileSync(tokenPath, "utf8"));
+		const tokenPath = path$1.join(dir, "com.vercel.token", `${projectId}.json`);
+		if (!fs.existsSync(tokenPath)) return null;
+		const token = JSON.parse(fs.readFileSync(tokenPath, "utf8"));
 		assertVercelOidcTokenResponse(token);
 		return token;
 	}
@@ -73499,147 +73624,6 @@ function entryForRef(ref) {
 	};
 }
 //#endregion
-//#region ../system/dist/file-data-plane-BhKdxJgf.mjs
-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 ?? [];
-}
-/** Build fetch headers, including HF auth token for huggingface.co URLs */
-function buildHeaders(url) {
-	const headers = { "User-Agent": "CamStack/1.0" };
-	const hfToken = process.env["HF_TOKEN"] ?? process.env["HUGGING_FACE_HUB_TOKEN"];
-	if (hfToken && url.includes("huggingface.co")) headers["Authorization"] = `Bearer ${hfToken}`;
-	return headers;
-}
-var DEFAULT_MAX_REDIRECTS = 5;
-function normalizeDownloadOptions(third) {
-	if (typeof third === "function") return { onProgress: third };
-	return third ?? {};
-}
-function isRedirectStatus(status) {
-	return status === 301 || status === 302 || status === 303 || status === 307 || status === 308;
-}
-function resolveRedirectUrl(current, location) {
-	return new URL(location, current);
-}
-async function downloadFile(url, destPath, onProgressOrOptions) {
-	if (fs.existsSync(destPath)) return destPath;
-	const opts = normalizeDownloadOptions(onProgressOrOptions);
-	const fetchImpl = opts.fetchImpl ?? fetch;
-	const maxRedirects = opts.maxRedirects ?? DEFAULT_MAX_REDIRECTS;
-	fs.mkdirSync(path$1.dirname(destPath), { recursive: true });
-	const tmpPath = destPath + ".downloading";
-	try {
-		let current = url;
-		const seen = /* @__PURE__ */ new Set();
-		let response;
-		const manual = opts.redirectPolicy !== void 0;
-		for (let hop = 0; hop <= maxRedirects; hop++) {
-			const parsed = new URL(current);
-			if (opts.redirectPolicy) opts.redirectPolicy(parsed, hop);
-			if (seen.has(parsed.href)) throw new Error(`Redirect loop detected at ${parsed.href}`);
-			seen.add(parsed.href);
-			const controller = opts.timeoutMs !== void 0 ? new AbortController() : void 0;
-			const timer = controller && opts.timeoutMs !== void 0 ? setTimeout(() => controller.abort(), opts.timeoutMs) : void 0;
-			try {
-				response = await fetchImpl(current, {
-					redirect: manual ? "manual" : "follow",
-					headers: buildHeaders(current),
-					...controller ? { signal: controller.signal } : {}
-				});
-			} finally {
-				if (timer) clearTimeout(timer);
-			}
-			if (manual && isRedirectStatus(response.status)) {
-				const location = response.headers.get("location");
-				if (!location) throw new Error(`Redirect ${response.status} missing Location header`);
-				if (hop >= maxRedirects) throw new Error(`Too many redirects (max ${maxRedirects}) downloading ${url}`);
-				current = resolveRedirectUrl(current, location).href;
-				continue;
-			}
-			break;
-		}
-		if (!response) throw new Error(`No response downloading ${url}`);
-		if (manual && isRedirectStatus(response.status)) throw new Error(`Too many redirects (max ${maxRedirects}) downloading ${url}`);
-		if (!response.ok) throw new Error(`HTTP ${response.status} downloading ${url}`);
-		if (!response.body) throw new Error(`No response body from ${url}`);
-		const total = parseInt(response.headers.get("content-length") ?? "0", 10);
-		let downloaded = 0;
-		const fileStream = fs.createWriteStream(tmpPath);
-		const reader = response.body.getReader();
-		try {
-			for (;;) {
-				const { done, value } = await reader.read();
-				if (done || !value) break;
-				downloaded += value.length;
-				if (opts.maxBytes !== void 0 && downloaded > opts.maxBytes) throw new Error(`Downloaded ${downloaded} bytes exceeds the ${opts.maxBytes}-byte limit`);
-				fileStream.write(value);
-				opts.onProgress?.(downloaded, total);
-			}
-		} finally {
-			fileStream.end();
-			await new Promise((resolve, reject) => {
-				fileStream.on("finish", resolve);
-				fileStream.on("error", reject);
-			});
-		}
-		fs.renameSync(tmpPath, destPath);
-		return destPath;
-	} catch (err) {
-		try {
-			fs.unlinkSync(tmpPath);
-		} catch {}
-		throw err;
-	}
-}
-/** Compute the on-disk path for a given model + format, even when not yet downloaded. */
-function getModelFilePath(modelsDir, entry, format) {
-	const formatEntry = entry.formats[format];
-	if (!formatEntry) return null;
-	const filename = formatEntry.url.split("/").pop() ?? `${entry.id}.${format}`;
-	return path$1.join(modelsDir, filename);
-}
-/** True iff the model file (or `Manifest.json` for directory bundles) exists and is non-empty. */
-function isModelDownloaded(modelsDir, entry, format) {
-	const formatEntry = entry.formats[format];
-	if (!formatEntry) return false;
-	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"));
-	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;
-	const formatEntry = entry.formats[format];
-	if (formatEntry?.isDirectory) fs.rmSync(modelPath, {
-		recursive: true,
-		force: true
-	});
-	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;
-}
-promisify(brotliCompress);
-promisify(gzip);
-//#endregion
 //#region src/runtime/model-ops.ts
 /**
 * Default `RuntimeModelOps` — the ONLY place the reused object-detection model
@@ -73675,14 +73659,14 @@ function planFiles(modelsDir, entry) {
 		const filename = formatEntry.url.split("/").pop() ?? `${entry.id}.${GGUF}`;
 		out.push({
 			url: formatEntry.url,
-			destPath: path$1.join(modelsDir, filename),
+			destPath: path.join(modelsDir, filename),
 			filename,
 			expectedBytes: formatEntry.sizeMB * BYTES_PER_MB
 		});
 	}
 	for (const extra of entry.extraFiles ?? []) out.push({
 		url: extra.url,
-		destPath: path$1.join(modelsDir, extra.filename),
+		destPath: path.join(modelsDir, extra.filename),
 		filename: extra.filename,
 		expectedBytes: extra.sizeMB * BYTES_PER_MB
 	});
@@ -73727,7 +73711,7 @@ function createDefaultModelOps(modelsDir) {
 		delete: async (entry) => {
 			deleteModelFromDisk(modelsDir, entry, GGUF);
 		},
-		extraFilePath: (_entry, filename) => path$1.join(modelsDir, filename)
+		extraFilePath: (_entry, filename) => path.join(modelsDir, filename)
 	};
 }
 //#endregion
@@ -74437,7 +74421,7 @@ function createLlmRuntimeProvider(deps) {
 		deleteModel: async ({ file }) => {
 			const loaded = deps.supervisor.status().modelPath;
 			if (loaded !== void 0 && basename(loaded) === file) throw new Error(`cannot delete ${file}: loaded by the running runtime`);
-			await fsp.rm(path$1.join(deps.modelsDir, file), { force: true });
+			await fsp.rm(path.join(deps.modelsDir, file), { force: true });
 		},
 		listLocalModels: async () => {
 			return (await listGgufFiles(deps.modelsDir)).map((f) => {
@@ -74445,7 +74429,7 @@ function createLlmRuntimeProvider(deps) {
 				return {
 					file: f.file,
 					sizeBytes: f.sizeBytes,
-					path: path$1.join(deps.modelsDir, f.file),
+					path: path.join(deps.modelsDir, f.file),
 					...catalogId !== void 0 ? { catalogId } : {}
 				};
 			});
@@ -74470,7 +74454,7 @@ async function listGgufFiles(dir) {
 	for (const name of names) {
 		if (!name.endsWith(".gguf")) continue;
 		try {
-			const stat = await fsp.stat(path$1.join(dir, name));
+			const stat = await fsp.stat(path.join(dir, name));
 			out.push({
 				file: name,
 				sizeBytes: stat.size
@@ -75804,7 +75788,7 @@ var AiAddon = class extends BaseAddon {
 		this.supervisor = supervisor;
 		const settingsPort = api !== void 0 ? createApiSettingsStorePort(api) : createMemorySettingsStorePort();
 		if (api === void 0) logger.warn("addon-ai: no ctx.api — profiles are in-memory only");
-		const binDir = path$1.join(ctx.nodeDataDir, "bin");
+		const binDir = path.join(ctx.nodeDataDir, "bin");
 		const { ensureLlamaServer } = await import("./ensure-llama-server-D_uzfSep.mjs").then((n) => n.r);
 		const assembly = await assembleAi({
 			nodeId: ownNodeId,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/addon-ai",
-  "version": "0.4.29",
+  "version": "0.4.31",
   "description": "AI addon for CamStack — the `llm` collection provider (cloud, LAN, and camstack-managed local llama.cpp profiles) plus the per-node `llm-runtime` managed executor.",
   "keywords": [
     "camstack",