hyperclaw 5.4.0 → 5.4.1

package/dist/multi-agent-tools-jzfvT4zP.js

@@ -0,0 +1,87 @@
+const require_chunk = require('./chunk-jS-bbMI5.js');
+const http = require_chunk.__toESM(require("http"));
+const https = require_chunk.__toESM(require("https"));
+
+//#region packages/core/src/agent/multi-agent-tools.ts
+function postChat(baseUrl, message, authToken, agentId) {
+	return new Promise((resolve, reject) => {
+		const u = new URL(baseUrl);
+		const isHttps = u.protocol === "https:";
+		const lib = isHttps ? https.default : http.default;
+		const body = JSON.stringify({
+			message,
+			...agentId ? { agentId } : {}
+		});
+		const headers = {
+			"Content-Type": "application/json",
+			"Content-Length": Buffer.byteLength(body).toString()
+		};
+		if (authToken) headers["Authorization"] = `Bearer ${authToken}`;
+		const opts = {
+			hostname: u.hostname,
+			port: u.port || (isHttps ? 443 : 80),
+			path: (u.pathname || "/").replace(/\/$/, "") + "/api/chat",
+			method: "POST",
+			headers
+		};
+		const req = lib.request(opts, (res) => {
+			let data = "";
+			res.on("data", (c) => data += c);
+			res.on("end", () => {
+				try {
+					const parsed = JSON.parse(data || "{}");
+					if (res.statusCode && res.statusCode >= 400) resolve({ error: parsed.error || `HTTP ${res.statusCode}` });
+					else resolve({ response: parsed.response });
+				} catch {
+					resolve({ error: data || `HTTP ${res.statusCode}` });
+				}
+			});
+		});
+		req.on("error", (e) => reject(e));
+		req.write(body);
+		req.end();
+	});
+}
+function getMultiAgentTools(cfg) {
+	const remotes = cfg?.multiAgent?.remotes;
+	if (!remotes || Object.keys(remotes).length === 0) return [];
+	const ids = Object.keys(remotes);
+	const tool = {
+		name: "call_remote_agent",
+		description: `Call another HyperClaw instance for collaborative tasks. Available remotes: ${ids.join(", ")}. Use when the user wants to delegate to a different agent or get help from another HyperClaw node.`,
+		input_schema: {
+			type: "object",
+			properties: {
+				remote_id: {
+					type: "string",
+					description: `Remote agent ID. One of: ${ids.join(", ")}`
+				},
+				message: {
+					type: "string",
+					description: "Message to send to the remote agent"
+				}
+			},
+			required: ["remote_id", "message"]
+		},
+		handler: async (input) => {
+			const remoteId = String(input.remote_id || "").trim();
+			const message = String(input.message || "");
+			if (!remotes[remoteId]) return `Error: Unknown remote "${remoteId}". Available: ${ids.join(", ")}. Configure via multiAgent.remotes in hyperclaw.json.`;
+			if (!message) return "Error: message is required.";
+			const r = remotes[remoteId];
+			try {
+				const res = await postChat(r.url, message, r.token, remoteId);
+				if (res.error) return `Remote ${remoteId}: ${res.error}`;
+				return res.response ?? "(empty response)";
+			} catch (e) {
+				return `Remote ${remoteId}: ${e.message}`;
+			}
+		}
+	};
+	return [tool];
+}
+var init_multi_agent_tools = require_chunk.__esm({ "packages/core/src/agent/multi-agent-tools.ts"() {} });
+
+//#endregion
+init_multi_agent_tools();
+exports.getMultiAgentTools = getMultiAgentTools;

package/dist/multimodal-zZdwqISl.js

@@ -0,0 +1,77 @@
+const require_chunk = require('./chunk-jS-bbMI5.js');
+const fs_extra = require_chunk.__toESM(require("fs-extra"));
+const path = require_chunk.__toESM(require("path"));
+const crypto = require_chunk.__toESM(require("crypto"));
+
+//#region packages/memory-lancedb/src/multimodal.ts
+const GEMINI_EMBED_MODEL = "models/gemini-embedding-2-preview";
+function createGeminiMultimodalEmbedder(apiKey) {
+	const base = "https://generativelanguage.googleapis.com/v1beta";
+	async function embedContent(parts) {
+		const res = await fetch(`${base}/${GEMINI_EMBED_MODEL}:embedContent?key=${encodeURIComponent(apiKey)}`, {
+			method: "POST",
+			headers: { "Content-Type": "application/json" },
+			body: JSON.stringify({
+				model: GEMINI_EMBED_MODEL,
+				content: { parts },
+				taskType: "RETRIEVAL_DOCUMENT"
+			})
+		});
+		if (!res.ok) {
+			const err = await res.text();
+			throw new Error(`Gemini multimodal embed failed: ${res.status} ${err}`);
+		}
+		const j = await res.json();
+		const vec = j.embedding?.values;
+		if (!Array.isArray(vec)) throw new Error("Gemini embed: missing embedding.values");
+		return vec;
+	}
+	return {
+		embedText: (text) => embedContent([{ text }]),
+		embedImage: (data, mimeType) => embedContent([{ inlineData: {
+			mimeType,
+			data
+		} }]),
+		embedAudio: (data, mimeType) => embedContent([{ inlineData: {
+			mimeType,
+			data
+		} }])
+	};
+}
+async function addImageToMemory(store, embedder, imagePath, caption) {
+	const buf = await fs_extra.default.readFile(imagePath);
+	const base64 = buf.toString("base64");
+	const ext = path.default.extname(imagePath).toLowerCase();
+	const mimeType = ext === ".png" ? "image/png" : ext === ".webp" ? "image/webp" : "image/jpeg";
+	const embedding = await embedder.embedImage(base64, mimeType);
+	const text = caption || `[image: ${path.default.basename(imagePath)}]`;
+	const item = {
+		id: (0, crypto.randomUUID)(),
+		text,
+		category: "image",
+		timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+		embedding
+	};
+	await store.add([item]);
+}
+async function addAudioToMemory(store, embedder, audioPath, transcript) {
+	const buf = await fs_extra.default.readFile(audioPath);
+	const base64 = buf.toString("base64");
+	const ext = path.default.extname(audioPath).toLowerCase();
+	const mimeType = ext === ".mp3" ? "audio/mpeg" : ext === ".wav" ? "audio/wav" : ext === ".webm" ? "audio/webm" : "audio/mpeg";
+	const embedding = await embedder.embedAudio(base64, mimeType);
+	const text = transcript || `[audio: ${path.default.basename(audioPath)}]`;
+	const item = {
+		id: (0, crypto.randomUUID)(),
+		text,
+		category: "audio",
+		timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+		embedding
+	};
+	await store.add([item]);
+}
+
+//#endregion
+exports.addAudioToMemory = addAudioToMemory;
+exports.addImageToMemory = addImageToMemory;
+exports.createGeminiMultimodalEmbedder = createGeminiMultimodalEmbedder;

package/dist/node-BYrxELx2.js

@@ -0,0 +1,251 @@
+const require_chunk = require('./chunk-jS-bbMI5.js');
+const require_paths = require('./paths-AIyBxIzm.js');
+const require_paths$1 = require('./paths-DPovhojT.js');
+const chalk = require_chunk.__toESM(require("chalk"));
+const inquirer = require_chunk.__toESM(require("inquirer"));
+const ora = require_chunk.__toESM(require("ora"));
+const fs_extra = require_chunk.__toESM(require("fs-extra"));
+const path = require_chunk.__toESM(require("path"));
+const os = require_chunk.__toESM(require("os"));
+
+//#region src/commands/node.ts
+require_paths$1.init_paths();
+const getNodesFile = () => path.default.join(require_paths.getHyperClawDir(), "nodes.json");
+async function loadNodes() {
+	try {
+		return await fs_extra.default.readJson(getNodesFile());
+	} catch {
+		return [];
+	}
+}
+async function saveNodes(nodes) {
+	const nodesFile = getNodesFile();
+	await fs_extra.default.ensureDir(path.default.dirname(nodesFile));
+	await fs_extra.default.writeJson(nodesFile, nodes, { spaces: 2 });
+}
+const TYPE_EMOJI = {
+	local: "💻",
+	remote: "🖥️",
+	android: "📱",
+	raspberrypi: "🍓",
+	docker: "🐳",
+	vm: "☁️"
+};
+const STATUS_COLOR = {
+	online: chalk.default.green,
+	offline: chalk.default.red,
+	unknown: chalk.default.gray,
+	degraded: chalk.default.yellow
+};
+async function nodeList() {
+	const nodes = await loadNodes();
+	console.log(chalk.default.bold.cyan("\n  📱 HYPERCLAW NODES\n"));
+	console.log(`  ${chalk.default.green("●")} ${chalk.default.white("Local (this machine)".padEnd(22))} ${chalk.default.cyan("[local]")}  ${chalk.default.green("online")}`);
+	console.log(`    ${chalk.default.gray(`Node.js ${process.version}  ${os.default.platform()} ${os.default.arch()}  port 18789`)}`);
+	console.log();
+	if (nodes.length === 0) {
+		console.log(chalk.default.gray("  No additional nodes registered."));
+		console.log(chalk.default.gray("  Add a remote node: hyperclaw node add\n"));
+		return;
+	}
+	for (const node of nodes) {
+		const dot = STATUS_COLOR[node.status]("●");
+		const emoji = TYPE_EMOJI[node.type];
+		const status = STATUS_COLOR[node.status](node.status);
+		console.log(`  ${dot} ${chalk.default.white(node.name.padEnd(22))} ${chalk.default.cyan(`[${node.type}]`)}  ${status}`);
+		if (node.host) console.log(`    ${chalk.default.gray(`${node.host}:${node.port || 18789}`)}`);
+		if (node.androidDeviceId) console.log(`    ${chalk.default.gray(`adb: ${node.androidDeviceId}`)}`);
+		if (node.capabilities.length > 0) console.log(`    ${chalk.default.gray("caps:")} ${node.capabilities.join(", ")}`);
+		if (node.lastSeenAt) {
+			const ago = Math.round((Date.now() - new Date(node.lastSeenAt).getTime()) / 1e3 / 60);
+			console.log(`    ${chalk.default.gray(`last seen: ${ago}m ago`)}`);
+		}
+		console.log();
+	}
+}
+async function nodeAdd() {
+	console.log(chalk.default.bold.cyan("\n  ➕ ADD NODE\n"));
+	const { type } = await inquirer.default.prompt([{
+		type: "list",
+		name: "type",
+		message: "Node type:",
+		choices: [
+			{
+				name: "🖥️  Remote server (SSH)",
+				value: "remote"
+			},
+			{
+				name: "📱  Android device (ADB)",
+				value: "android"
+			},
+			{
+				name: "🍓  Raspberry Pi",
+				value: "raspberrypi"
+			},
+			{
+				name: "🐳  Docker container",
+				value: "docker"
+			},
+			{
+				name: "☁️  VM / cloud instance",
+				value: "vm"
+			}
+		]
+	}]);
+	const { name } = await inquirer.default.prompt([{
+		type: "input",
+		name: "name",
+		message: "Node name:",
+		validate: (v) => !!v.trim() || "Required"
+	}]);
+	let extras = {};
+	if (type === "android") {
+		const { deviceId } = await inquirer.default.prompt([{
+			type: "input",
+			name: "deviceId",
+			message: "ADB device ID (run: adb devices):",
+			validate: (v) => !!v.trim() || "Required"
+		}]);
+		extras.androidDeviceId = deviceId;
+		extras.capabilities = ["channel:host", "always-on"];
+	} else {
+		const { host, port } = await inquirer.default.prompt([{
+			type: "input",
+			name: "host",
+			message: "Hostname or IP:",
+			validate: (v) => !!v.trim() || "Required"
+		}, {
+			type: "number",
+			name: "port",
+			message: "Gateway port:",
+			default: 18789
+		}]);
+		const { caps } = await inquirer.default.prompt([{
+			type: "checkbox",
+			name: "caps",
+			message: "Capabilities:",
+			choices: [
+				{
+					name: "Run agent inference",
+					value: "agent:run",
+					checked: true
+				},
+				{
+					name: "Host channel connections",
+					value: "channel:host"
+				},
+				{
+					name: "Execute code",
+					value: "code:execute"
+				},
+				{
+					name: "GPU acceleration",
+					value: "gpu"
+				},
+				{
+					name: "Always-on (24/7)",
+					value: "always-on"
+				}
+			]
+		}]);
+		extras = {
+			host,
+			port,
+			capabilities: caps
+		};
+	}
+	const node = {
+		id: name.toLowerCase().replace(/\s+/g, "-"),
+		name,
+		type,
+		status: "unknown",
+		addedAt: (/* @__PURE__ */ new Date()).toISOString(),
+		capabilities: extras.capabilities || [],
+		...extras
+	};
+	const nodes = await loadNodes();
+	nodes.push(node);
+	await saveNodes(nodes);
+	console.log(chalk.default.green(`\n  ✔  Node added: ${name}`));
+	console.log(chalk.default.gray("  Run: hyperclaw node probe   to test the connection\n"));
+}
+async function nodeProbe(id) {
+	const nodes = await loadNodes();
+	const targets = id ? nodes.filter((n) => n.id === id) : nodes;
+	console.log(chalk.default.bold.cyan("\n  🔍 PROBING NODES\n"));
+	console.log(`  ${chalk.default.cyan("○")} Local...`);
+	await new Promise((r) => setTimeout(r, 300));
+	console.log(`  ${chalk.default.green("✔")} Local — online (${os.default.platform()} ${os.default.arch()})\n`);
+	for (const node of targets) {
+		const spinner = (0, ora.default)(`  Probing ${node.name} (${node.host || node.androidDeviceId || node.type})...`).start();
+		await new Promise((r) => setTimeout(r, 1e3));
+		try {
+			if (node.host) {
+				const axios = (await import("axios")).default;
+				const res = await axios.get(`http://${node.host}:${node.port || 18789}/api/status`, { timeout: 3e3 });
+				node.status = "online";
+				node.version = res.data?.version;
+				node.lastSeenAt = (/* @__PURE__ */ new Date()).toISOString();
+				spinner.succeed(`${node.name} — online${node.version ? ` (v${node.version})` : ""}`);
+			} else if (node.type === "android") {
+				const { exec } = await import("child_process");
+				const { promisify } = await import("util");
+				const execAsync = promisify(exec);
+				await execAsync(`adb -s ${node.androidDeviceId} shell echo ok`);
+				node.status = "online";
+				node.lastSeenAt = (/* @__PURE__ */ new Date()).toISOString();
+				spinner.succeed(`${node.name} — online (ADB connected)`);
+			} else {
+				node.status = "unknown";
+				spinner.warn(`${node.name} — probe not supported for ${node.type}`);
+			}
+		} catch {
+			node.status = "offline";
+			spinner.fail(`${node.name} — offline / unreachable`);
+		}
+		console.log();
+	}
+	await saveNodes(nodes);
+}
+async function nodeRemove(id) {
+	const nodes = await loadNodes();
+	const idx = nodes.findIndex((n) => n.id === id);
+	if (idx === -1) {
+		console.log(chalk.default.red(`\n  ✖  Node not found: ${id}\n`));
+		return;
+	}
+	nodes.splice(idx, 1);
+	await saveNodes(nodes);
+	console.log(chalk.default.green(`\n  ✔  Node removed: ${id}\n`));
+}
+/** Show pending work queued for dormant nodes. */
+async function nodeQueue(nodeId) {
+	const { listPending } = await Promise.resolve().then(() => require("./node-pending-queue-iYpoWqxe.js"));
+	const pending = listPending(nodeId);
+	console.log(chalk.default.bold.cyan("\n  📋 NODE PENDING QUEUE\n"));
+	if (pending.length === 0) {
+		console.log(chalk.default.gray("  No pending work."));
+		if (nodeId) console.log(chalk.default.gray(`  (filter: ${nodeId})`));
+		console.log(chalk.default.gray("\n  Work is queued when a node is offline. Run `hyperclaw node probe` and the queue drains on success.\n"));
+		return;
+	}
+	const byNode = pending.reduce((acc, i) => {
+		if (!acc[i.nodeId]) acc[i.nodeId] = [];
+		acc[i.nodeId].push(i);
+		return acc;
+	}, {});
+	for (const [nid, items] of Object.entries(byNode)) {
+		console.log(`  ${chalk.default.yellow("●")} ${chalk.default.white(nid)} — ${items.length} pending`);
+		for (const i of items.slice(0, 5)) console.log(`    ${chalk.default.gray(i.id)}  ${i.type}  ${chalk.default.gray(i.createdAt)}`);
+		if (items.length > 5) console.log(chalk.default.gray(`    ... +${items.length - 5} more`));
+		console.log();
+	}
+	console.log(chalk.default.gray("  Drain on node online: hyperclaw node probe <nodeId>\n"));
+}
+
+//#endregion
+exports.nodeAdd = nodeAdd;
+exports.nodeList = nodeList;
+exports.nodeProbe = nodeProbe;
+exports.nodeQueue = nodeQueue;
+exports.nodeRemove = nodeRemove;

package/dist/node-CLWgPlAk.js

@@ -0,0 +1,251 @@
+const require_chunk = require('./chunk-jS-bbMI5.js');
+const require_paths = require('./paths-AIyBxIzm.js');
+const require_paths$1 = require('./paths-DPovhojT.js');
+const chalk = require_chunk.__toESM(require("chalk"));
+const inquirer = require_chunk.__toESM(require("inquirer"));
+const ora = require_chunk.__toESM(require("ora"));
+const fs_extra = require_chunk.__toESM(require("fs-extra"));
+const path = require_chunk.__toESM(require("path"));
+const os = require_chunk.__toESM(require("os"));
+
+//#region src/commands/node.ts
+require_paths$1.init_paths();
+const getNodesFile = () => path.default.join(require_paths.getHyperClawDir(), "nodes.json");
+async function loadNodes() {
+	try {
+		return await fs_extra.default.readJson(getNodesFile());
+	} catch {
+		return [];
+	}
+}
+async function saveNodes(nodes) {
+	const nodesFile = getNodesFile();
+	await fs_extra.default.ensureDir(path.default.dirname(nodesFile));
+	await fs_extra.default.writeJson(nodesFile, nodes, { spaces: 2 });
+}
+const TYPE_EMOJI = {
+	local: "💻",
+	remote: "🖥️",
+	android: "📱",
+	raspberrypi: "🍓",
+	docker: "🐳",
+	vm: "☁️"
+};
+const STATUS_COLOR = {
+	online: chalk.default.green,
+	offline: chalk.default.red,
+	unknown: chalk.default.gray,
+	degraded: chalk.default.yellow
+};
+async function nodeList() {
+	const nodes = await loadNodes();
+	console.log(chalk.default.bold.cyan("\n  📱 HYPERCLAW NODES\n"));
+	console.log(`  ${chalk.default.green("●")} ${chalk.default.white("Local (this machine)".padEnd(22))} ${chalk.default.cyan("[local]")}  ${chalk.default.green("online")}`);
+	console.log(`    ${chalk.default.gray(`Node.js ${process.version}  ${os.default.platform()} ${os.default.arch()}  port 18789`)}`);
+	console.log();
+	if (nodes.length === 0) {
+		console.log(chalk.default.gray("  No additional nodes registered."));
+		console.log(chalk.default.gray("  Add a remote node: hyperclaw node add\n"));
+		return;
+	}
+	for (const node of nodes) {
+		const dot = STATUS_COLOR[node.status]("●");
+		const emoji = TYPE_EMOJI[node.type];
+		const status = STATUS_COLOR[node.status](node.status);
+		console.log(`  ${dot} ${chalk.default.white(node.name.padEnd(22))} ${chalk.default.cyan(`[${node.type}]`)}  ${status}`);
+		if (node.host) console.log(`    ${chalk.default.gray(`${node.host}:${node.port || 18789}`)}`);
+		if (node.androidDeviceId) console.log(`    ${chalk.default.gray(`adb: ${node.androidDeviceId}`)}`);
+		if (node.capabilities.length > 0) console.log(`    ${chalk.default.gray("caps:")} ${node.capabilities.join(", ")}`);
+		if (node.lastSeenAt) {
+			const ago = Math.round((Date.now() - new Date(node.lastSeenAt).getTime()) / 1e3 / 60);
+			console.log(`    ${chalk.default.gray(`last seen: ${ago}m ago`)}`);
+		}
+		console.log();
+	}
+}
+async function nodeAdd() {
+	console.log(chalk.default.bold.cyan("\n  ➕ ADD NODE\n"));
+	const { type } = await inquirer.default.prompt([{
+		type: "list",
+		name: "type",
+		message: "Node type:",
+		choices: [
+			{
+				name: "🖥️  Remote server (SSH)",
+				value: "remote"
+			},
+			{
+				name: "📱  Android device (ADB)",
+				value: "android"
+			},
+			{
+				name: "🍓  Raspberry Pi",
+				value: "raspberrypi"
+			},
+			{
+				name: "🐳  Docker container",
+				value: "docker"
+			},
+			{
+				name: "☁️  VM / cloud instance",
+				value: "vm"
+			}
+		]
+	}]);
+	const { name } = await inquirer.default.prompt([{
+		type: "input",
+		name: "name",
+		message: "Node name:",
+		validate: (v) => !!v.trim() || "Required"
+	}]);
+	let extras = {};
+	if (type === "android") {
+		const { deviceId } = await inquirer.default.prompt([{
+			type: "input",
+			name: "deviceId",
+			message: "ADB device ID (run: adb devices):",
+			validate: (v) => !!v.trim() || "Required"
+		}]);
+		extras.androidDeviceId = deviceId;
+		extras.capabilities = ["channel:host", "always-on"];
+	} else {
+		const { host, port } = await inquirer.default.prompt([{
+			type: "input",
+			name: "host",
+			message: "Hostname or IP:",
+			validate: (v) => !!v.trim() || "Required"
+		}, {
+			type: "number",
+			name: "port",
+			message: "Gateway port:",
+			default: 18789
+		}]);
+		const { caps } = await inquirer.default.prompt([{
+			type: "checkbox",
+			name: "caps",
+			message: "Capabilities:",
+			choices: [
+				{
+					name: "Run agent inference",
+					value: "agent:run",
+					checked: true
+				},
+				{
+					name: "Host channel connections",
+					value: "channel:host"
+				},
+				{
+					name: "Execute code",
+					value: "code:execute"
+				},
+				{
+					name: "GPU acceleration",
+					value: "gpu"
+				},
+				{
+					name: "Always-on (24/7)",
+					value: "always-on"
+				}
+			]
+		}]);
+		extras = {
+			host,
+			port,
+			capabilities: caps
+		};
+	}
+	const node = {
+		id: name.toLowerCase().replace(/\s+/g, "-"),
+		name,
+		type,
+		status: "unknown",
+		addedAt: (/* @__PURE__ */ new Date()).toISOString(),
+		capabilities: extras.capabilities || [],
+		...extras
+	};
+	const nodes = await loadNodes();
+	nodes.push(node);
+	await saveNodes(nodes);
+	console.log(chalk.default.green(`\n  ✔  Node added: ${name}`));
+	console.log(chalk.default.gray("  Run: hyperclaw node probe   to test the connection\n"));
+}
+async function nodeProbe(id) {
+	const nodes = await loadNodes();
+	const targets = id ? nodes.filter((n) => n.id === id) : nodes;
+	console.log(chalk.default.bold.cyan("\n  🔍 PROBING NODES\n"));
+	console.log(`  ${chalk.default.cyan("○")} Local...`);
+	await new Promise((r) => setTimeout(r, 300));
+	console.log(`  ${chalk.default.green("✔")} Local — online (${os.default.platform()} ${os.default.arch()})\n`);
+	for (const node of targets) {
+		const spinner = (0, ora.default)(`  Probing ${node.name} (${node.host || node.androidDeviceId || node.type})...`).start();
+		await new Promise((r) => setTimeout(r, 1e3));
+		try {
+			if (node.host) {
+				const axios = (await import("axios")).default;
+				const res = await axios.get(`http://${node.host}:${node.port || 18789}/api/status`, { timeout: 3e3 });
+				node.status = "online";
+				node.version = res.data?.version;
+				node.lastSeenAt = (/* @__PURE__ */ new Date()).toISOString();
+				spinner.succeed(`${node.name} — online${node.version ? ` (v${node.version})` : ""}`);
+			} else if (node.type === "android") {
+				const { exec } = await import("child_process");
+				const { promisify } = await import("util");
+				const execAsync = promisify(exec);
+				await execAsync(`adb -s ${node.androidDeviceId} shell echo ok`);
+				node.status = "online";
+				node.lastSeenAt = (/* @__PURE__ */ new Date()).toISOString();
+				spinner.succeed(`${node.name} — online (ADB connected)`);
+			} else {
+				node.status = "unknown";
+				spinner.warn(`${node.name} — probe not supported for ${node.type}`);
+			}
+		} catch {
+			node.status = "offline";
+			spinner.fail(`${node.name} — offline / unreachable`);
+		}
+		console.log();
+	}
+	await saveNodes(nodes);
+}
+async function nodeRemove(id) {
+	const nodes = await loadNodes();
+	const idx = nodes.findIndex((n) => n.id === id);
+	if (idx === -1) {
+		console.log(chalk.default.red(`\n  ✖  Node not found: ${id}\n`));
+		return;
+	}
+	nodes.splice(idx, 1);
+	await saveNodes(nodes);
+	console.log(chalk.default.green(`\n  ✔  Node removed: ${id}\n`));
+}
+/** Show pending work queued for dormant nodes. */
+async function nodeQueue(nodeId) {
+	const { listPending } = await Promise.resolve().then(() => require("./node-pending-queue-DZp7cdfo.js"));
+	const pending = listPending(nodeId);
+	console.log(chalk.default.bold.cyan("\n  📋 NODE PENDING QUEUE\n"));
+	if (pending.length === 0) {
+		console.log(chalk.default.gray("  No pending work."));
+		if (nodeId) console.log(chalk.default.gray(`  (filter: ${nodeId})`));
+		console.log(chalk.default.gray("\n  Work is queued when a node is offline. Run `hyperclaw node probe` and the queue drains on success.\n"));
+		return;
+	}
+	const byNode = pending.reduce((acc, i) => {
+		if (!acc[i.nodeId]) acc[i.nodeId] = [];
+		acc[i.nodeId].push(i);
+		return acc;
+	}, {});
+	for (const [nid, items] of Object.entries(byNode)) {
+		console.log(`  ${chalk.default.yellow("●")} ${chalk.default.white(nid)} — ${items.length} pending`);
+		for (const i of items.slice(0, 5)) console.log(`    ${chalk.default.gray(i.id)}  ${i.type}  ${chalk.default.gray(i.createdAt)}`);
+		if (items.length > 5) console.log(chalk.default.gray(`    ... +${items.length - 5} more`));
+		console.log();
+	}
+	console.log(chalk.default.gray("  Drain on node online: hyperclaw node probe <nodeId>\n"));
+}
+
+//#endregion
+exports.nodeAdd = nodeAdd;
+exports.nodeList = nodeList;
+exports.nodeProbe = nodeProbe;
+exports.nodeQueue = nodeQueue;
+exports.nodeRemove = nodeRemove;