@camstack/addon-terminal 0.1.9 → 0.1.11

package/dist/addon.js

@@ -23,6 +23,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 }) : target, mod));
 //#endregion
 let node_fs = require("node:fs");
+let node_module = require("node:module");
 let node_path = require("node:path");
 let sharp = require("sharp");
 sharp = __toESM(sharp);
@@ -21148,6 +21149,7 @@ var FaceInfoSchema = object({
 var FaceFilterEnum = _enum([
 	"unassigned",
 	"recognized",
+	"identified",
 	"all"
 ]);
 var MediaFileLiteSchema$1 = object({
@@ -21176,6 +21178,8 @@ method(_void(), array(IdentitySchema).readonly()), method(object({ name: string(
 	kind: "mutation",
 	auth: "admin"
 }), method(object({
+	/** Restrict to one camera. Absent keeps the cluster-wide gallery view. */
+	deviceId: number().int().optional(),
 	limit: number().int().positive().optional(),
 	filter: FaceFilterEnum.optional(),
 	/**
@@ -23405,6 +23409,10 @@ var OsdSourceSchema = discriminatedUnion("kind", [
 		capName: string().min(1).max(64),
 		/** Dot path inside the slice, e.g. `detected`, `value`, `mode`. */
 		valuePath: string().min(1).max(64)
+	}),
+	object({
+		kind: literal("latest-recognition"),
+		recognition: _enum(["person", "plate"])
 	})
 ]);
 var OsdSlotBindingSchema = object({
@@ -23510,6 +23518,15 @@ method(object({ deviceId: number().int() }), object({
 }), object({ success: literal(true) }), {
 	kind: "mutation",
 	auth: "admin"
+}), method(object({
+	sourceDeviceId: number().int(),
+	targetDeviceId: number().int()
+}), object({
+	copied: number().int().nonnegative(),
+	skipped: number().int().nonnegative()
+}), {
+	kind: "mutation",
+	auth: "admin"
 }), method(object({
 	deviceId: number().int(),
 	slotId: string().min(1),
@@ -30203,6 +30220,12 @@ Object.freeze({
 		addonId: null,
 		access: "delete"
 	},
+	"osdManager.copyDeviceConfiguration": {
+		capName: "osd-manager",
+		capScope: "system",
+		addonId: null,
+		access: "create"
+	},
 	"osdManager.getConditionSupport": {
 		capName: "osd-manager",
 		capScope: "system",
@@ -32970,6 +32993,7 @@ DEFAULT_NATIVE_LEASE_SETTINGS.admission;
 * a full-screen program (`btm`) gets no terminal and no runtime resize channel.
 * See docs/design/2026-07-26-terminal-session-design.md ("The pty").
 */
+var require$1 = (0, node_module.createRequire)(require("url").pathToFileURL(__filename).href);
 /**
 * Resolve `file` to an executable path the way a shell would: a path-qualified
 * name is checked directly, a bare name is searched on `PATH`. Returns the
@@ -32996,8 +33020,19 @@ function isExecutableFile(p) {
 	}
 }
 var cachedModule = null;
+function ensureSpawnHelperExecutable() {
+	if (process.platform === "win32") return;
+	const packageRoot = (0, node_path.dirname)(require$1.resolve("node-pty/package.json"));
+	const candidates = [(0, node_path.join)(packageRoot, "prebuilds", `${process.platform}-${process.arch}`, "spawn-helper"), (0, node_path.join)(packageRoot, "build", "Release", "spawn-helper")];
+	for (const candidate of candidates) {
+		if (!(0, node_fs.existsSync)(candidate)) continue;
+		const mode = (0, node_fs.statSync)(candidate).mode & 511;
+		if ((mode & 73) === 0) (0, node_fs.chmodSync)(candidate, mode | (mode & 292) >> 2);
+	}
+}
 async function loadNodePty() {
 	if (cachedModule) return cachedModule;
+	ensureSpawnHelperExecutable();
 	const mod = await import("node-pty");
 	cachedModule = mod;
 	return mod;
@@ -33043,6 +33078,22 @@ function createNodePtySpawner() {
 async function warmNodePty() {
 	await loadNodePty();
 }
+//#endregion
+//#region src/terminal-camera-declarations.ts
+function buildTerminalCameraDeclarations(nodes, profilesByNode) {
+	return nodes.flatMap((node) => {
+		const nodeLabel = node.isHub ? "Hub" : node.name;
+		return (profilesByNode.get(node.id) ?? []).map((profile) => ({
+			stableId: profile.profileId === "monitor" ? `terminal-camera-${node.id}` : `terminal-camera-${node.id}-${profile.profileId}`,
+			name: `Terminal ${profile.label} - ${nodeLabel}`,
+			config: {
+				nodeId: node.id,
+				profileId: profile.profileId,
+				profileLabel: profile.label
+			}
+		}));
+	});
+}
 function escapeXml(value) {
 	return value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll("\"", "&quot;").replaceAll("'", "&apos;");
 }
@@ -33057,7 +33108,11 @@ async function renderTerminalJpeg(lines) {
 }
 //#endregion
 //#region src/terminal-camera-device.ts
-var terminalCameraSchema = object({ nodeId: string().min(1) });
+var terminalCameraSchema = object({
+	nodeId: string().min(1),
+	profileId: string().min(1),
+	profileLabel: string().min(1)
+});
 var relay = null;
 function installTerminalCameraRelay(next) {
 	relay = next;
@@ -33076,18 +33131,19 @@ var TerminalCameraDevice = class extends BaseDevice {
 		const activeRelay = relay;
 		if (!activeRelay) throw new Error("terminal camera relay is unavailable");
 		const nodeId = this.config.get("nodeId");
-		return (await activeRelay.listProfiles(nodeId)).map((profile) => ({
-			camStreamId: profile.profileId,
+		const profileId = this.config.get("profileId");
+		return [{
+			camStreamId: profileId,
 			kind: "pull-http",
-			url: activeRelay.streamUrl(nodeId, profile.profileId),
+			url: activeRelay.streamUrl(nodeId, profileId),
 			codec: "h264",
 			resolution: {
 				width: 960,
 				height: 640
 			},
 			fps: 2,
-			label: profile.label
-		}));
+			label: this.config.get("profileLabel")
+		}];
 	}
 	setNodeOnline(online) {
 		this.markOnline(online);
@@ -38259,7 +38315,12 @@ function createTerminalDataPlaneHandler(manager) {
 var ProfileIdSchema = string().trim().min(1).max(64).regex(/^[a-z][a-z0-9-]*$/, "must be a lowercase slug");
 var ConfiguredTerminalProfileSchema = object({
 	enabled: boolean().default(true),
-	profileId: ProfileIdSchema.refine((id) => id !== "monitor" && id !== "shell", { message: "monitor and shell are reserved profile IDs" }),
+	profileId: ProfileIdSchema.refine((id) => ![
+		"monitor",
+		"top",
+		"glances",
+		"shell"
+	].includes(id), { message: "monitor, top, glances and shell are reserved profile IDs" }),
 	label: string().trim().min(1).max(100),
 	description: string().trim().max(500).optional().default(""),
 	executable: string().trim().min(1).max(1024).refine((value) => !value.includes("\0"), { message: "must not contain NUL bytes" }),
@@ -38274,17 +38335,36 @@ var ConfiguredTerminalProfileSchema = object({
 * surface.
 */
 function buildProfiles(options) {
-	const profiles = [{
+	const profiles = [];
+	if (options.btmEnabled !== false) profiles.push({
 		profileId: "monitor",
-		label: "System Monitor",
+		label: "BTM",
 		description: "bottom (btm) — CPU, memory, network and process monitor",
 		file: options.btmPath.trim().length > 0 ? options.btmPath.trim() : "btm",
-		args: [],
-		...options.btmPath.trim().length === 0 ? { fallbacks: [{
-			file: "top",
-			args: []
-		}] } : {}
-	}];
+		args: options.btmArgs ?? []
+	});
+	if (options.topEnabled !== false) profiles.push({
+		profileId: "top",
+		label: "Top",
+		description: "The operating system process and resource monitor",
+		file: options.topPath?.trim() || "top",
+		args: options.topArgs ?? []
+	});
+	if (options.glancesEnabled !== false) {
+		const configuredPath = options.glancesPath?.trim();
+		const pythonPath = options.glancesPythonPath?.trim();
+		profiles.push({
+			profileId: "glances",
+			label: "Glances",
+			description: "Cross-platform curses monitor installed in CamStack embedded Python",
+			file: configuredPath || pythonPath || "glances",
+			args: configuredPath || !pythonPath ? options.glancesArgs ?? [] : [
+				"-m",
+				"glances",
+				...options.glancesArgs ?? []
+			]
+		});
+	}
 	if (options.allowShell) profiles.push({
 		profileId: "shell",
 		label: "Shell (interactive)",
@@ -38357,6 +38437,15 @@ var TerminalSessionManager = class {
 		this.opts = opts;
 		this.profiles = buildProfiles({
 			btmPath: opts.btmPath,
+			btmEnabled: opts.btmEnabled,
+			btmArgs: opts.btmArgs,
+			topEnabled: opts.topEnabled,
+			topPath: opts.topPath,
+			topArgs: opts.topArgs,
+			glancesEnabled: opts.glancesEnabled,
+			glancesPath: opts.glancesPath,
+			glancesArgs: opts.glancesArgs,
+			glancesPythonPath: opts.glancesPythonPath,
 			allowShell: opts.allowShell,
 			shellPath: opts.shellPath,
 			customProfiles: opts.customProfiles,
@@ -38610,6 +38699,14 @@ var TerminalSessionManager = class {
 //#region src/addon.ts
 var DEFAULTS = {
 	btmPath: "",
+	btmEnabled: true,
+	btmArgs: [],
+	topEnabled: true,
+	topPath: "",
+	topArgs: [],
+	glancesEnabled: true,
+	glancesPath: "",
+	glancesArgs: [],
 	allowShell: false,
 	shellPath: "",
 	maxSessions: 4,
@@ -38623,17 +38720,29 @@ var TerminalAddon = class extends BaseAddon {
 	dataPlane = null;
 	cameraRelay = null;
 	cameraReconcileTimer = null;
+	cameraProfilesByNode = /* @__PURE__ */ new Map();
+	glancesPythonPath = "";
 	constructor() {
 		super({ ...DEFAULTS });
 	}
 	async onInitialize() {
 		await warmNodePty();
+		this.glancesPythonPath = await this.ctx.deps.ensurePython() ?? "";
 		const manager = new TerminalSessionManager({
 			spawn: createNodePtySpawner(),
 			screenFactory: createXtermScreen,
 			resolveBinary: resolveExecutable,
 			logger: this.ctx.logger,
 			btmPath: this.config.btmPath,
+			btmEnabled: this.config.btmEnabled,
+			btmArgs: this.config.btmArgs,
+			topEnabled: this.config.topEnabled,
+			topPath: this.config.topPath,
+			topArgs: this.config.topArgs,
+			glancesEnabled: this.config.glancesEnabled,
+			glancesPath: this.config.glancesPath,
+			glancesArgs: this.config.glancesArgs,
+			glancesPythonPath: this.glancesPythonPath,
 			allowShell: this.config.allowShell,
 			shellPath: this.config.shellPath,
 			maxSessions: this.config.maxSessions,
@@ -38678,6 +38787,15 @@ var TerminalAddon = class extends BaseAddon {
 	async onConfigChanged() {
 		this.manager?.reconfigureProfiles({
 			btmPath: this.config.btmPath,
+			btmEnabled: this.config.btmEnabled,
+			btmArgs: this.config.btmArgs,
+			topEnabled: this.config.topEnabled,
+			topPath: this.config.topPath,
+			topArgs: this.config.topArgs,
+			glancesEnabled: this.config.glancesEnabled,
+			glancesPath: this.config.glancesPath,
+			glancesArgs: this.config.glancesArgs,
+			glancesPythonPath: this.glancesPythonPath,
 			allowShell: this.config.allowShell,
 			shellPath: this.config.shellPath,
 			maxSessions: this.config.maxSessions,
@@ -38702,6 +38820,44 @@ var TerminalAddon = class extends BaseAddon {
 		const topology = await this.ctx.api.nodes.topology.query();
 		if (topology.length === 0) throw new Error("cluster topology returned no nodes; refusing to withdraw declared cameras");
 		const nodes = topology.filter((node) => typeof node.id === "string" && node.id.length > 0);
+		const unavailableNodeIds = /* @__PURE__ */ new Set();
+		await Promise.all(nodes.map(async (node) => {
+			try {
+				this.cameraProfilesByNode.set(node.id, await this.cameraRelay.listProfiles(node.id));
+			} catch (error) {
+				if (!this.cameraProfilesByNode.has(node.id)) {
+					unavailableNodeIds.add(node.id);
+					this.ctx.logger.warn("terminal profiles unavailable — preserving existing cameras for this node", { meta: {
+						nodeId: node.id,
+						error: error instanceof Error ? error.message : String(error)
+					} });
+				}
+			}
+		}));
+		const cameraDeclarations = [...buildTerminalCameraDeclarations(nodes, this.cameraProfilesByNode)];
+		if (unavailableNodeIds.size > 0) {
+			const existing = await this.ctx.api.deviceManager.listAll.query({ addonId: this.ctx.id });
+			const unavailableNodes = nodes.filter((node) => unavailableNodeIds.has(node.id)).sort((left, right) => right.id.length - left.id.length);
+			for (const row of existing) {
+				const node = unavailableNodes.find((candidate) => {
+					const base = `terminal-camera-${candidate.id}`;
+					return row.stableId === base || row.stableId.startsWith(`${base}-`);
+				});
+				if (!node || cameraDeclarations.some((camera) => camera.stableId === row.stableId)) continue;
+				const base = `terminal-camera-${node.id}`;
+				const profileId = row.stableId === base ? "monitor" : row.stableId.slice(base.length + 1);
+				const profileLabel = profileId === "monitor" ? "BTM" : profileId;
+				cameraDeclarations.push({
+					stableId: row.stableId,
+					name: `Terminal ${profileLabel} - ${node.isHub ? "Hub" : node.name}`,
+					config: {
+						nodeId: node.id,
+						profileId,
+						profileLabel
+					}
+				});
+			}
+		}
 		const result = await new DeclaredDevices({
 			logger: this.ctx.logger.child("camera-declaration"),
 			addonId: this.ctx.id,
@@ -38720,12 +38876,12 @@ var TerminalAddon = class extends BaseAddon {
 		}).reconcile({
 			integrationName: TERMINAL_CAMERA_INTEGRATION,
 			placement: "hub",
-			devices: nodes.map((node) => ({
-				stableId: `terminal-camera-${node.id}`,
-				name: node.isHub ? "Terminal Hub" : `Terminal ${node.name}`,
+			devices: cameraDeclarations.map((camera) => ({
+				stableId: camera.stableId,
+				name: camera.name,
 				type: DeviceType.Camera,
 				DeviceClass: TerminalCameraDevice,
-				config: { nodeId: node.id },
+				config: camera.config,
 				role: "terminal-camera"
 			}))
 		});
@@ -38742,15 +38898,78 @@ var TerminalAddon = class extends BaseAddon {
 			description: "Interactive terminal sessions in the Admin UI. Only pre-declared profiles can be opened; a free-form command is never accepted.",
 			columns: 2,
 			fields: [
+				this.field({
+					type: "boolean",
+					key: "btmEnabled",
+					label: "Enable BTM camera",
+					default: true,
+					perNode: true
+				}),
 				this.field({
 					type: "text",
 					key: "btmPath",
-					label: "Monitor binary",
+					label: "BTM binary",
 					description: "Path to the `btm` (bottom) executable. Leave empty to resolve from PATH.",
 					placeholder: "btm",
 					default: "",
 					perNode: true
 				}),
+				this.field({
+					type: "tags",
+					key: "btmArgs",
+					label: "BTM arguments",
+					description: "Exact arguments passed to btm.",
+					default: [],
+					perNode: true
+				}),
+				this.field({
+					type: "boolean",
+					key: "topEnabled",
+					label: "Enable Top camera",
+					default: true,
+					perNode: true
+				}),
+				this.field({
+					type: "text",
+					key: "topPath",
+					label: "Top binary",
+					placeholder: "top",
+					default: "",
+					perNode: true
+				}),
+				this.field({
+					type: "tags",
+					key: "topArgs",
+					label: "Top arguments",
+					description: "Exact arguments passed to top.",
+					default: [],
+					perNode: true
+				}),
+				this.field({
+					type: "boolean",
+					key: "glancesEnabled",
+					label: "Enable Glances camera",
+					description: "Glances is installed automatically into CamStack embedded Python.",
+					default: true,
+					perNode: true
+				}),
+				this.field({
+					type: "text",
+					key: "glancesPath",
+					label: "Glances binary override",
+					description: "Optional executable override. Empty uses the automatically managed Python package.",
+					placeholder: "glances",
+					default: "",
+					perNode: true
+				}),
+				this.field({
+					type: "tags",
+					key: "glancesArgs",
+					label: "Glances arguments",
+					description: "Exact arguments passed to Glances.",
+					default: [],
+					perNode: true
+				}),
 				this.field({
 					type: "number",
 					key: "maxSessions",
@@ -38782,7 +39001,7 @@ var TerminalAddon = class extends BaseAddon {
 		}, {
 			id: "terminal-profiles",
 			title: "Custom profiles",
-			description: "Define allowlisted programs available from the Terminal page on this node. Session requests only carry the profile ID; commands cannot be overridden by clients.",
+			description: "Each enabled profile creates its own Terminal camera on this node and is available from the Terminal page. Session requests only carry the profile ID; commands cannot be overridden by clients.",
 			columns: 1,
 			fields: [this.field({
 				type: "editable-array",

package/dist/addon.mjs

@@ -1,5 +1,6 @@
-import { accessSync, constants, statSync } from "node:fs";
-import { delimiter, join } from "node:path";
+import { createRequire } from "node:module";
+import { accessSync, chmodSync, constants, existsSync, statSync } from "node:fs";
+import { delimiter, dirname, join } from "node:path";
 import sharp from "sharp";
 import { createServer } from "node:http";
 //#region \0rolldown/runtime.js
@@ -21126,6 +21127,7 @@ var FaceInfoSchema = object({
 var FaceFilterEnum = _enum([
 	"unassigned",
 	"recognized",
+	"identified",
 	"all"
 ]);
 var MediaFileLiteSchema$1 = object({
@@ -21154,6 +21156,8 @@ method(_void(), array(IdentitySchema).readonly()), method(object({ name: string(
 	kind: "mutation",
 	auth: "admin"
 }), method(object({
+	/** Restrict to one camera. Absent keeps the cluster-wide gallery view. */
+	deviceId: number().int().optional(),
 	limit: number().int().positive().optional(),
 	filter: FaceFilterEnum.optional(),
 	/**
@@ -23383,6 +23387,10 @@ var OsdSourceSchema = discriminatedUnion("kind", [
 		capName: string().min(1).max(64),
 		/** Dot path inside the slice, e.g. `detected`, `value`, `mode`. */
 		valuePath: string().min(1).max(64)
+	}),
+	object({
+		kind: literal("latest-recognition"),
+		recognition: _enum(["person", "plate"])
 	})
 ]);
 var OsdSlotBindingSchema = object({
@@ -23488,6 +23496,15 @@ method(object({ deviceId: number().int() }), object({
 }), object({ success: literal(true) }), {
 	kind: "mutation",
 	auth: "admin"
+}), method(object({
+	sourceDeviceId: number().int(),
+	targetDeviceId: number().int()
+}), object({
+	copied: number().int().nonnegative(),
+	skipped: number().int().nonnegative()
+}), {
+	kind: "mutation",
+	auth: "admin"
 }), method(object({
 	deviceId: number().int(),
 	slotId: string().min(1),
@@ -30181,6 +30198,12 @@ Object.freeze({
 		addonId: null,
 		access: "delete"
 	},
+	"osdManager.copyDeviceConfiguration": {
+		capName: "osd-manager",
+		capScope: "system",
+		addonId: null,
+		access: "create"
+	},
 	"osdManager.getConditionSupport": {
 		capName: "osd-manager",
 		capScope: "system",
@@ -32948,6 +32971,7 @@ DEFAULT_NATIVE_LEASE_SETTINGS.admission;
 * a full-screen program (`btm`) gets no terminal and no runtime resize channel.
 * See docs/design/2026-07-26-terminal-session-design.md ("The pty").
 */
+var require = createRequire(import.meta.url);
 /**
 * Resolve `file` to an executable path the way a shell would: a path-qualified
 * name is checked directly, a bare name is searched on `PATH`. Returns the
@@ -32974,8 +32998,19 @@ function isExecutableFile(p) {
 	}
 }
 var cachedModule = null;
+function ensureSpawnHelperExecutable() {
+	if (process.platform === "win32") return;
+	const packageRoot = dirname(require.resolve("node-pty/package.json"));
+	const candidates = [join(packageRoot, "prebuilds", `${process.platform}-${process.arch}`, "spawn-helper"), join(packageRoot, "build", "Release", "spawn-helper")];
+	for (const candidate of candidates) {
+		if (!existsSync(candidate)) continue;
+		const mode = statSync(candidate).mode & 511;
+		if ((mode & 73) === 0) chmodSync(candidate, mode | (mode & 292) >> 2);
+	}
+}
 async function loadNodePty() {
 	if (cachedModule) return cachedModule;
+	ensureSpawnHelperExecutable();
 	const mod = await import("node-pty");
 	cachedModule = mod;
 	return mod;
@@ -33021,6 +33056,22 @@ function createNodePtySpawner() {
 async function warmNodePty() {
 	await loadNodePty();
 }
+//#endregion
+//#region src/terminal-camera-declarations.ts
+function buildTerminalCameraDeclarations(nodes, profilesByNode) {
+	return nodes.flatMap((node) => {
+		const nodeLabel = node.isHub ? "Hub" : node.name;
+		return (profilesByNode.get(node.id) ?? []).map((profile) => ({
+			stableId: profile.profileId === "monitor" ? `terminal-camera-${node.id}` : `terminal-camera-${node.id}-${profile.profileId}`,
+			name: `Terminal ${profile.label} - ${nodeLabel}`,
+			config: {
+				nodeId: node.id,
+				profileId: profile.profileId,
+				profileLabel: profile.label
+			}
+		}));
+	});
+}
 function escapeXml(value) {
 	return value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll("\"", "&quot;").replaceAll("'", "&apos;");
 }
@@ -33035,7 +33086,11 @@ async function renderTerminalJpeg(lines) {
 }
 //#endregion
 //#region src/terminal-camera-device.ts
-var terminalCameraSchema = object({ nodeId: string().min(1) });
+var terminalCameraSchema = object({
+	nodeId: string().min(1),
+	profileId: string().min(1),
+	profileLabel: string().min(1)
+});
 var relay = null;
 function installTerminalCameraRelay(next) {
 	relay = next;
@@ -33054,18 +33109,19 @@ var TerminalCameraDevice = class extends BaseDevice {
 		const activeRelay = relay;
 		if (!activeRelay) throw new Error("terminal camera relay is unavailable");
 		const nodeId = this.config.get("nodeId");
-		return (await activeRelay.listProfiles(nodeId)).map((profile) => ({
-			camStreamId: profile.profileId,
+		const profileId = this.config.get("profileId");
+		return [{
+			camStreamId: profileId,
 			kind: "pull-http",
-			url: activeRelay.streamUrl(nodeId, profile.profileId),
+			url: activeRelay.streamUrl(nodeId, profileId),
 			codec: "h264",
 			resolution: {
 				width: 960,
 				height: 640
 			},
 			fps: 2,
-			label: profile.label
-		}));
+			label: this.config.get("profileLabel")
+		}];
 	}
 	setNodeOnline(online) {
 		this.markOnline(online);
@@ -38237,7 +38293,12 @@ function createTerminalDataPlaneHandler(manager) {
 var ProfileIdSchema = string().trim().min(1).max(64).regex(/^[a-z][a-z0-9-]*$/, "must be a lowercase slug");
 var ConfiguredTerminalProfileSchema = object({
 	enabled: boolean().default(true),
-	profileId: ProfileIdSchema.refine((id) => id !== "monitor" && id !== "shell", { message: "monitor and shell are reserved profile IDs" }),
+	profileId: ProfileIdSchema.refine((id) => ![
+		"monitor",
+		"top",
+		"glances",
+		"shell"
+	].includes(id), { message: "monitor, top, glances and shell are reserved profile IDs" }),
 	label: string().trim().min(1).max(100),
 	description: string().trim().max(500).optional().default(""),
 	executable: string().trim().min(1).max(1024).refine((value) => !value.includes("\0"), { message: "must not contain NUL bytes" }),
@@ -38252,17 +38313,36 @@ var ConfiguredTerminalProfileSchema = object({
 * surface.
 */
 function buildProfiles(options) {
-	const profiles = [{
+	const profiles = [];
+	if (options.btmEnabled !== false) profiles.push({
 		profileId: "monitor",
-		label: "System Monitor",
+		label: "BTM",
 		description: "bottom (btm) — CPU, memory, network and process monitor",
 		file: options.btmPath.trim().length > 0 ? options.btmPath.trim() : "btm",
-		args: [],
-		...options.btmPath.trim().length === 0 ? { fallbacks: [{
-			file: "top",
-			args: []
-		}] } : {}
-	}];
+		args: options.btmArgs ?? []
+	});
+	if (options.topEnabled !== false) profiles.push({
+		profileId: "top",
+		label: "Top",
+		description: "The operating system process and resource monitor",
+		file: options.topPath?.trim() || "top",
+		args: options.topArgs ?? []
+	});
+	if (options.glancesEnabled !== false) {
+		const configuredPath = options.glancesPath?.trim();
+		const pythonPath = options.glancesPythonPath?.trim();
+		profiles.push({
+			profileId: "glances",
+			label: "Glances",
+			description: "Cross-platform curses monitor installed in CamStack embedded Python",
+			file: configuredPath || pythonPath || "glances",
+			args: configuredPath || !pythonPath ? options.glancesArgs ?? [] : [
+				"-m",
+				"glances",
+				...options.glancesArgs ?? []
+			]
+		});
+	}
 	if (options.allowShell) profiles.push({
 		profileId: "shell",
 		label: "Shell (interactive)",
@@ -38335,6 +38415,15 @@ var TerminalSessionManager = class {
 		this.opts = opts;
 		this.profiles = buildProfiles({
 			btmPath: opts.btmPath,
+			btmEnabled: opts.btmEnabled,
+			btmArgs: opts.btmArgs,
+			topEnabled: opts.topEnabled,
+			topPath: opts.topPath,
+			topArgs: opts.topArgs,
+			glancesEnabled: opts.glancesEnabled,
+			glancesPath: opts.glancesPath,
+			glancesArgs: opts.glancesArgs,
+			glancesPythonPath: opts.glancesPythonPath,
 			allowShell: opts.allowShell,
 			shellPath: opts.shellPath,
 			customProfiles: opts.customProfiles,
@@ -38588,6 +38677,14 @@ var TerminalSessionManager = class {
 //#region src/addon.ts
 var DEFAULTS = {
 	btmPath: "",
+	btmEnabled: true,
+	btmArgs: [],
+	topEnabled: true,
+	topPath: "",
+	topArgs: [],
+	glancesEnabled: true,
+	glancesPath: "",
+	glancesArgs: [],
 	allowShell: false,
 	shellPath: "",
 	maxSessions: 4,
@@ -38601,17 +38698,29 @@ var TerminalAddon = class extends BaseAddon {
 	dataPlane = null;
 	cameraRelay = null;
 	cameraReconcileTimer = null;
+	cameraProfilesByNode = /* @__PURE__ */ new Map();
+	glancesPythonPath = "";
 	constructor() {
 		super({ ...DEFAULTS });
 	}
 	async onInitialize() {
 		await warmNodePty();
+		this.glancesPythonPath = await this.ctx.deps.ensurePython() ?? "";
 		const manager = new TerminalSessionManager({
 			spawn: createNodePtySpawner(),
 			screenFactory: createXtermScreen,
 			resolveBinary: resolveExecutable,
 			logger: this.ctx.logger,
 			btmPath: this.config.btmPath,
+			btmEnabled: this.config.btmEnabled,
+			btmArgs: this.config.btmArgs,
+			topEnabled: this.config.topEnabled,
+			topPath: this.config.topPath,
+			topArgs: this.config.topArgs,
+			glancesEnabled: this.config.glancesEnabled,
+			glancesPath: this.config.glancesPath,
+			glancesArgs: this.config.glancesArgs,
+			glancesPythonPath: this.glancesPythonPath,
 			allowShell: this.config.allowShell,
 			shellPath: this.config.shellPath,
 			maxSessions: this.config.maxSessions,
@@ -38656,6 +38765,15 @@ var TerminalAddon = class extends BaseAddon {
 	async onConfigChanged() {
 		this.manager?.reconfigureProfiles({
 			btmPath: this.config.btmPath,
+			btmEnabled: this.config.btmEnabled,
+			btmArgs: this.config.btmArgs,
+			topEnabled: this.config.topEnabled,
+			topPath: this.config.topPath,
+			topArgs: this.config.topArgs,
+			glancesEnabled: this.config.glancesEnabled,
+			glancesPath: this.config.glancesPath,
+			glancesArgs: this.config.glancesArgs,
+			glancesPythonPath: this.glancesPythonPath,
 			allowShell: this.config.allowShell,
 			shellPath: this.config.shellPath,
 			maxSessions: this.config.maxSessions,
@@ -38680,6 +38798,44 @@ var TerminalAddon = class extends BaseAddon {
 		const topology = await this.ctx.api.nodes.topology.query();
 		if (topology.length === 0) throw new Error("cluster topology returned no nodes; refusing to withdraw declared cameras");
 		const nodes = topology.filter((node) => typeof node.id === "string" && node.id.length > 0);
+		const unavailableNodeIds = /* @__PURE__ */ new Set();
+		await Promise.all(nodes.map(async (node) => {
+			try {
+				this.cameraProfilesByNode.set(node.id, await this.cameraRelay.listProfiles(node.id));
+			} catch (error) {
+				if (!this.cameraProfilesByNode.has(node.id)) {
+					unavailableNodeIds.add(node.id);
+					this.ctx.logger.warn("terminal profiles unavailable — preserving existing cameras for this node", { meta: {
+						nodeId: node.id,
+						error: error instanceof Error ? error.message : String(error)
+					} });
+				}
+			}
+		}));
+		const cameraDeclarations = [...buildTerminalCameraDeclarations(nodes, this.cameraProfilesByNode)];
+		if (unavailableNodeIds.size > 0) {
+			const existing = await this.ctx.api.deviceManager.listAll.query({ addonId: this.ctx.id });
+			const unavailableNodes = nodes.filter((node) => unavailableNodeIds.has(node.id)).sort((left, right) => right.id.length - left.id.length);
+			for (const row of existing) {
+				const node = unavailableNodes.find((candidate) => {
+					const base = `terminal-camera-${candidate.id}`;
+					return row.stableId === base || row.stableId.startsWith(`${base}-`);
+				});
+				if (!node || cameraDeclarations.some((camera) => camera.stableId === row.stableId)) continue;
+				const base = `terminal-camera-${node.id}`;
+				const profileId = row.stableId === base ? "monitor" : row.stableId.slice(base.length + 1);
+				const profileLabel = profileId === "monitor" ? "BTM" : profileId;
+				cameraDeclarations.push({
+					stableId: row.stableId,
+					name: `Terminal ${profileLabel} - ${node.isHub ? "Hub" : node.name}`,
+					config: {
+						nodeId: node.id,
+						profileId,
+						profileLabel
+					}
+				});
+			}
+		}
 		const result = await new DeclaredDevices({
 			logger: this.ctx.logger.child("camera-declaration"),
 			addonId: this.ctx.id,
@@ -38698,12 +38854,12 @@ var TerminalAddon = class extends BaseAddon {
 		}).reconcile({
 			integrationName: TERMINAL_CAMERA_INTEGRATION,
 			placement: "hub",
-			devices: nodes.map((node) => ({
-				stableId: `terminal-camera-${node.id}`,
-				name: node.isHub ? "Terminal Hub" : `Terminal ${node.name}`,
+			devices: cameraDeclarations.map((camera) => ({
+				stableId: camera.stableId,
+				name: camera.name,
 				type: DeviceType.Camera,
 				DeviceClass: TerminalCameraDevice,
-				config: { nodeId: node.id },
+				config: camera.config,
 				role: "terminal-camera"
 			}))
 		});
@@ -38720,15 +38876,78 @@ var TerminalAddon = class extends BaseAddon {
 			description: "Interactive terminal sessions in the Admin UI. Only pre-declared profiles can be opened; a free-form command is never accepted.",
 			columns: 2,
 			fields: [
+				this.field({
+					type: "boolean",
+					key: "btmEnabled",
+					label: "Enable BTM camera",
+					default: true,
+					perNode: true
+				}),
 				this.field({
 					type: "text",
 					key: "btmPath",
-					label: "Monitor binary",
+					label: "BTM binary",
 					description: "Path to the `btm` (bottom) executable. Leave empty to resolve from PATH.",
 					placeholder: "btm",
 					default: "",
 					perNode: true
 				}),
+				this.field({
+					type: "tags",
+					key: "btmArgs",
+					label: "BTM arguments",
+					description: "Exact arguments passed to btm.",
+					default: [],
+					perNode: true
+				}),
+				this.field({
+					type: "boolean",
+					key: "topEnabled",
+					label: "Enable Top camera",
+					default: true,
+					perNode: true
+				}),
+				this.field({
+					type: "text",
+					key: "topPath",
+					label: "Top binary",
+					placeholder: "top",
+					default: "",
+					perNode: true
+				}),
+				this.field({
+					type: "tags",
+					key: "topArgs",
+					label: "Top arguments",
+					description: "Exact arguments passed to top.",
+					default: [],
+					perNode: true
+				}),
+				this.field({
+					type: "boolean",
+					key: "glancesEnabled",
+					label: "Enable Glances camera",
+					description: "Glances is installed automatically into CamStack embedded Python.",
+					default: true,
+					perNode: true
+				}),
+				this.field({
+					type: "text",
+					key: "glancesPath",
+					label: "Glances binary override",
+					description: "Optional executable override. Empty uses the automatically managed Python package.",
+					placeholder: "glances",
+					default: "",
+					perNode: true
+				}),
+				this.field({
+					type: "tags",
+					key: "glancesArgs",
+					label: "Glances arguments",
+					description: "Exact arguments passed to Glances.",
+					default: [],
+					perNode: true
+				}),
 				this.field({
 					type: "number",
 					key: "maxSessions",
@@ -38760,7 +38979,7 @@ var TerminalAddon = class extends BaseAddon {
 		}, {
 			id: "terminal-profiles",
 			title: "Custom profiles",
-			description: "Define allowlisted programs available from the Terminal page on this node. Session requests only carry the profile ID; commands cannot be overridden by clients.",
+			description: "Each enabled profile creates its own Terminal camera on this node and is available from the Terminal page. Session requests only carry the profile ID; commands cannot be overridden by clients.",
 			columns: 1,
 			fields: [this.field({
 				type: "editable-array",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/addon-terminal",
-  "version": "0.1.9",
+  "version": "0.1.11",
   "description": "Interactive terminal sessions (pty + xterm) as a CamStack addon",
   "keywords": [
     "camstack",
@@ -34,8 +34,11 @@
         "category": "system",
         "name": "Terminal",
         "version": "0.1.0",
-        "description": "Interactive terminal sessions on any cluster node, plus one virtual Terminal camera per node. Commands remain bound to administrator-configured profiles.",
+        "description": "Interactive terminal sessions on any cluster node, with one virtual camera for each configured profile. Commands remain bound to administrator-configured profiles.",
         "entry": "./dist/index.js",
+        "python": {
+          "requirements": "./python/requirements.txt"
+        },
         "icon": "assets/icon.svg",
         "color": "#0ea5e9",
         "instanceMode": "unique",
@@ -53,7 +56,8 @@
   },
   "files": [
     "dist",
-    "assets"
+    "assets",
+    "python"
   ],
   "scripts": {
     "build": "vite build",

package/python/requirements.txt

@@ -0,0 +1 @@
+glances>=4.3,<5