@lobehub/cli 0.0.20 → 0.0.21

package/dist/index.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import { createRequire } from "node:module";
-import { EventEmitter } from "node:events";
+import { EventEmitter, once } from "node:events";
 import { execFile, execFileSync, spawn } from "node:child_process";
 import path, { basename, extname } from "node:path";
 import fs, { createReadStream, existsSync, readFileSync, writeFileSync } from "node:fs";
@@ -5023,8 +5023,8 @@ const log$7 = {
 
 //#endregion
 //#region src/settings/index.ts
-const LOBEHUB_DIR_NAME$1 = process.env.LOBEHUB_CLI_HOME || ".lobehub";
-const SETTINGS_DIR = path.join(os.homedir(), LOBEHUB_DIR_NAME$1);
+const LOBEHUB_DIR_NAME$2 = process.env.LOBEHUB_CLI_HOME || ".lobehub";
+const SETTINGS_DIR = path.join(os.homedir(), LOBEHUB_DIR_NAME$2);
 const SETTINGS_FILE = path.join(SETTINGS_DIR, "settings.json");
 function normalizeUrl(url) {
 	return url ? url.replace(/\/$/, "") : void 0;
@@ -5083,8 +5083,8 @@ function loadSettings() {
 
 //#endregion
 //#region src/auth/credentials.ts
-const LOBEHUB_DIR_NAME = process.env.LOBEHUB_CLI_HOME || ".lobehub";
-const CREDENTIALS_DIR = path.join(os.homedir(), LOBEHUB_DIR_NAME);
+const LOBEHUB_DIR_NAME$1 = process.env.LOBEHUB_CLI_HOME || ".lobehub";
+const CREDENTIALS_DIR = path.join(os.homedir(), LOBEHUB_DIR_NAME$1);
 const CREDENTIALS_FILE = path.join(CREDENTIALS_DIR, "credentials.json");
 function deriveKey() {
 	const material = `lobehub-cli:${os.hostname()}:${os.userInfo().username}`;
@@ -5437,6 +5437,7 @@ async function streamAgentEventsViaWebSocket(options) {
 		const jsonEvents = [];
 		const ctx = createRenderContext();
 		let heartbeatTimer;
+		let isSettled = false;
 		let jsonPrinted = false;
 		const cleanup = () => {
 			if (heartbeatTimer) clearInterval(heartbeatTimer);
@@ -5479,6 +5480,8 @@ async function streamAgentEventsViaWebSocket(options) {
 						jsonPrinted = true;
 						console.log(JSON.stringify(jsonEvents, null, 2));
 					} else if (!streamOpts.json) renderEnd(agentEvent);
+					if (isSettled) return;
+					isSettled = true;
 					cleanup();
 					resolve();
 					return;
@@ -5498,21 +5501,31 @@ async function streamAgentEventsViaWebSocket(options) {
 					jsonPrinted = true;
 					console.log(JSON.stringify(jsonEvents, null, 2));
 				}
+				if (isSettled) return;
+				isSettled = true;
 				cleanup();
 				resolve();
 			}
 		};
 		ws.onerror = (err) => {
 			cleanup();
-			reject(err);
+			if (isSettled) return;
+			if (streamOpts.json && jsonEvents.length > 0 && !jsonPrinted) {
+				jsonPrinted = true;
+				console.log(JSON.stringify(jsonEvents, null, 2));
+			}
+			isSettled = true;
+			reject(/* @__PURE__ */ new Error(`Agent gateway WebSocket failed: ${String(err)}`));
 		};
-		ws.onclose = () => {
+		ws.onclose = (event) => {
 			if (heartbeatTimer) clearInterval(heartbeatTimer);
+			if (isSettled) return;
 			if (streamOpts.json && jsonEvents.length > 0 && !jsonPrinted) {
 				jsonPrinted = true;
 				console.log(JSON.stringify(jsonEvents, null, 2));
 			}
-			resolve();
+			isSettled = true;
+			reject(/* @__PURE__ */ new Error(`Agent gateway WebSocket closed before completion: ${String(event)}`));
 		};
 	});
 }
@@ -7351,12 +7364,14 @@ const DEFAULT_AGENT_CHAT_CONFIG = {
 	enableAgentMode: true,
 	enableCompressHistory: true,
 	enableContextCompression: true,
+	enableFollowUpChips: false,
 	enableHistoryCount: false,
 	enableStreaming: true,
 	historyCount: 20,
 	reasoningBudgetToken: 1024,
 	searchFCModel: DEFAULT_AGENT_SEARCH_FC_MODEL,
-	searchMode: "auto"
+	searchMode: "auto",
+	selfIteration: { enabled: false }
 };
 const DEFAULT_AGENT_CONFIG = {
 	chatConfig: DEFAULT_AGENT_CHAT_CONFIG,
@@ -7574,11 +7589,20 @@ const DEFAULT_INPUT_COMPLETION_SYSTEM_AGENT_ITEM = {
 	model: DEFAULT_MINI_SYSTEM_AGENT_ITEM.model,
 	provider: DEFAULT_MINI_SYSTEM_AGENT_ITEM.provider
 };
+const DEFAULT_FOLLOW_UP_ACTION_SYSTEM_AGENT_ITEM = {
+	enabled: false,
+	model: DEFAULT_MINI_SYSTEM_AGENT_ITEM.model,
+	provider: DEFAULT_MINI_SYSTEM_AGENT_ITEM.provider
+};
 
 //#endregion
 //#region ../../packages/const/src/discover.ts
 const DEFAULT_CREATED_AT = (/* @__PURE__ */ new Date()).toISOString();
 
+//#endregion
+//#region ../../packages/const/src/empty.ts
+const EMPTY_ARRAY = Object.freeze([]);
+
 //#endregion
 //#region ../../packages/const/src/interests.ts
 const INTEREST_AREA_KEYS = [
@@ -16673,250 +16697,6 @@ async function resolveToken(options) {
 	process.exit(1);
 }
 
-//#endregion
-//#region src/daemon/taskRegistry.ts
-function getRegistryPath() {
-	return path.join(os.homedir(), ".lobehub", "task-registry.json");
-}
-function readRegistry() {
-	try {
-		return JSON.parse(fs.readFileSync(getRegistryPath(), "utf8"));
-	} catch {
-		return {};
-	}
-}
-function writeRegistry(entries) {
-	const dir = path.dirname(getRegistryPath());
-	fs.mkdirSync(dir, {
-		mode: 448,
-		recursive: true
-	});
-	fs.writeFileSync(getRegistryPath(), JSON.stringify(entries, null, 2), { mode: 384 });
-}
-function saveTask(entry) {
-	const registry = readRegistry();
-	registry[entry.taskId] = entry;
-	writeRegistry(registry);
-}
-function getTask(taskId) {
-	return readRegistry()[taskId];
-}
-function removeTask(taskId) {
-	const registry = readRegistry();
-	delete registry[taskId];
-	writeRegistry(registry);
-}
-function listTasks() {
-	return Object.values(readRegistry());
-}
-
-//#endregion
-//#region src/tools/heteroTask.ts
-const DEFAULT_HERMES_PORT = 3456;
-/** Resolve the absolute path to the `lh` binary to avoid PATH issues in child processes. */
-function resolveLhPath() {
-	try {
-		return execFileSync("which", ["lh"], { encoding: "utf8" }).trim();
-	} catch {
-		return "lh";
-	}
-}
-function getHermesPort() {
-	const env = process.env.HERMES_GATEWAY_PORT;
-	if (env) {
-		const parsed = Number.parseInt(env, 10);
-		if (!Number.isNaN(parsed)) return parsed;
-	}
-	return DEFAULT_HERMES_PORT;
-}
-async function isHermesGatewayRunning(port) {
-	try {
-		return (await fetch(`http://localhost:${port}/health`)).ok;
-	} catch {
-		return false;
-	}
-}
-async function startHermesGateway(port) {
-	spawn("hermes", ["gateway", "start"], {
-		detached: true,
-		env: { ...process.env },
-		stdio: "ignore"
-	}).unref();
-	const deadline = Date.now() + 1e4;
-	while (Date.now() < deadline) {
-		await new Promise((r) => setTimeout(r, 500));
-		if (await isHermesGatewayRunning(port)) return;
-	}
-	throw new Error(`Hermes gateway did not start within 10s on port ${port}`);
-}
-async function sendAutoNotify(topicId, taskId, text, agentId) {
-	try {
-		await (await getTrpcClient()).agentNotify.notify.mutate({
-			agentId,
-			content: text,
-			role: "assistant",
-			topicId
-		});
-	} catch (err) {
-		log$7.error("Failed to send auto-notify:", err instanceof Error ? err.message : String(err));
-	}
-}
-/**
-* Signal remote hetero task completion to the server so it can publish
-* `agent_runtime_end` to the gateway WS and close the frontend subscription.
-* Called on clean process exit (code=0, no signal) — error exits go through
-* `sendAutoNotify` which writes an error message AND triggers completion via
-* the `done` flag.
-*/
-async function sendDoneSignal(topicId, agentId) {
-	try {
-		await (await getTrpcClient()).agentNotify.notify.mutate({
-			agentId,
-			content: "",
-			done: true,
-			role: "assistant",
-			topicId
-		});
-	} catch (err) {
-		log$7.error("Failed to send done signal:", err instanceof Error ? err.message : String(err));
-	}
-}
-/**
-* Build the notify protocol injected into the first message of a new hetero-agent session.
-* Tells the agent how to push updates back to the LobeHub user via `lh notify`.
-*/
-function buildNotifyProtocol(lhPath, topicId) {
-	return `## Context: This task was dispatched by LobeHub
-
-This conversation / task was sent to you by the **LobeHub platform** on behalf of a user. You are running as a background agent; the user is waiting for your response inside the LobeHub chat interface.
-
-**When to call notify**: any time you have something meaningful to tell the user — a key finding, a decision you made, a result, a question, or your final answer. Think of it as speaking directly to the user in the chat window.
-
-**What to hide**: internal work details such as tool call sequences, file reads, intermediate command output, retries, or low-level reasoning steps. The user cares about outcomes and insights, not your step-by-step mechanics.
-
-## Sending messages back to the user
-
-Use the \`${lhPath} notify\` command. All your updates appear as a **single message bubble** in the UI — create it once and update it in place.\n\n**Step 1 — Open the bubble on your first meaningful update** (captures the messageId):\n\`\`\`\nMSG_ID=$(${lhPath} notify --topic ${topicId} --role assistant --content "Starting..." --json | grep -o '"messageId":"[^"]*"' | cut -d'"' -f4)\n\`\`\`\n\n**Step 2 — Update the same bubble as you make progress**:\n\`\`\`\n${lhPath} notify --topic ${topicId} --role assistant --message-id "$MSG_ID" --content "Still working..."\n\`\`\`\n\n**Step 3 — Replace with your complete, final response when done**:\n\`\`\`\n${lhPath} notify --topic ${topicId} --role assistant --message-id "$MSG_ID" --content "<your full response here>"\n\`\`\`\n\nRules:\n- Always use \`--json\` on the first call and capture \`messageId\` from the output.\n- Always pass \`--message-id\` on every subsequent call so updates overwrite the same bubble.\n- Write what matters to the user — not implementation steps or internal tool calls.\n- Call notify at least once when the task is done, even if there were no intermediate updates.`;
-}
-async function runHeteroTask(params) {
-	const { agentId, agentType, cwd, operationId, prompt, taskId, topicId } = params;
-	const workDir = cwd || process.cwd();
-	const lhPath = resolveLhPath();
-	if (agentType === "openclaw") {
-		const openclawAgent = process.env.OPENCLAW_AGENT_ID ?? "main";
-		const enrichedPrompt = `${prompt}\n\n${buildNotifyProtocol(lhPath, topicId)}`;
-		for (const existing of listTasks()) if (existing.topicId === topicId && existing.agentType === "openclaw") {
-			try {
-				process.kill(existing.pid, "SIGTERM");
-			} catch {}
-			removeTask(existing.taskId);
-		}
-		const child = spawn("openclaw", [
-			"agent",
-			"--agent",
-			openclawAgent,
-			"--session-id",
-			topicId,
-			"--message",
-			enrichedPrompt,
-			"--local"
-		], {
-			cwd: workDir,
-			detached: true,
-			env: { ...process.env },
-			stdio: "ignore"
-		});
-		const pid = child.pid;
-		if (pid === void 0) throw new Error("Failed to get PID for openclaw process");
-		child.unref();
-		saveTask({
-			agentId,
-			agentType,
-			operationId,
-			pid,
-			startedAt: (/* @__PURE__ */ new Date()).toISOString(),
-			taskId,
-			topicId
-		});
-		log$7.info(`OpenClaw task started: taskId=${taskId} pid=${pid} agent=${openclawAgent}`);
-		child.on("close", (code, signal) => {
-			removeTask(taskId);
-			if (code !== 0 || signal !== null) sendAutoNotify(topicId, taskId, signal ? `Task cancelled (signal: ${signal})` : `Task failed (exit code: ${code})`, agentId).finally(() => sendDoneSignal(topicId, agentId));
-			else sendDoneSignal(topicId, agentId);
-		});
-		return JSON.stringify({
-			pid,
-			taskId
-		});
-	}
-	if (agentType === "hermes") {
-		const port = getHermesPort();
-		if (!await isHermesGatewayRunning(port)) {
-			log$7.info(`Hermes gateway not running on port ${port}, starting...`);
-			await startHermesGateway(port);
-		}
-		const res = await fetch(`http://localhost:${port}/message`, {
-			body: JSON.stringify({
-				content: prompt,
-				operationId
-			}),
-			headers: { "Content-Type": "application/json" },
-			method: "POST"
-		});
-		if (!res.ok) throw new Error(`Hermes gateway returned ${res.status}: ${await res.text()}`);
-		saveTask({
-			agentId,
-			agentType,
-			operationId,
-			pid: 0,
-			startedAt: (/* @__PURE__ */ new Date()).toISOString(),
-			taskId,
-			topicId
-		});
-		log$7.info(`Hermes task dispatched: taskId=${taskId} operationId=${operationId}`);
-		return JSON.stringify({
-			operationId,
-			taskId
-		});
-	}
-	throw new Error(`Unsupported agentType: ${agentType}`);
-}
-async function cancelHeteroTask(params) {
-	const { signal = "SIGINT", taskId } = params;
-	const entry = getTask(taskId);
-	if (!entry) return JSON.stringify({
-		message: `No task found with taskId: ${taskId}`,
-		success: false
-	});
-	if (entry.agentType === "hermes") {
-		const port = getHermesPort();
-		try {
-			await fetch(`http://localhost:${port}/stop`, {
-				body: JSON.stringify({ operationId: entry.operationId }),
-				headers: { "Content-Type": "application/json" },
-				method: "POST"
-			});
-		} catch (err) {
-			log$7.warn(`Failed to send /stop to Hermes gateway: ${err instanceof Error ? err.message : String(err)}`);
-		}
-		removeTask(taskId);
-		await sendAutoNotify(entry.topicId, taskId, "Task cancelled", entry.agentId);
-		return JSON.stringify({ taskId });
-	}
-	try {
-		process.kill(entry.pid, signal);
-	} catch (err) {
-		log$7.warn(`Failed to send ${signal} to pid ${entry.pid}: ${err instanceof Error ? err.message : String(err)}`);
-		removeTask(taskId);
-		await sendAutoNotify(entry.topicId, taskId, "Task already completed or cancelled", entry.agentId);
-	}
-	return JSON.stringify({
-		pid: entry.pid,
-		signal,
-		taskId
-	});
-}
-
 //#endregion
 //#region src/tools/checkPlatformCapability.ts
 /**
@@ -16942,30 +16722,21 @@ async function checkPlatformCapability(params) {
 			reason: err instanceof Error ? err.message : "openclaw not found or failed to run"
 		};
 	}
-	if (platform === "hermes") {
-		const port = getHermesPort();
-		try {
-			const res = await fetch(`http://localhost:${port}/health`, { signal: AbortSignal.timeout(5e3) });
-			if (res.ok) {
-				let version;
-				try {
-					version = (await res.json()).version;
-				} catch {}
-				return {
-					available: true,
-					version
-				};
-			}
-			return {
-				available: false,
-				reason: `Hermes gateway returned HTTP ${res.status}`
-			};
-		} catch (err) {
-			return {
-				available: false,
-				reason: err instanceof Error ? err.message : `Hermes gateway not reachable on port ${port}`
-			};
-		}
+	if (platform === "hermes") try {
+		const output = execFileSync("hermes", ["--version"], {
+			encoding: "utf8",
+			timeout: 5e3
+		}).trim();
+		const versionMatch = output.match(/v(\d+\.\d+\.\d+)/);
+		return {
+			available: true,
+			version: versionMatch ? versionMatch[1] : output.split(/\s+/).at(-1)
+		};
+	} catch (err) {
+		return {
+			available: false,
+			reason: err instanceof Error ? err.message : "hermes not found or failed to run"
+		};
 	}
 	return {
 		available: false,
@@ -207213,20 +206984,327 @@ function getOpenClawProfile(agentId) {
 	};
 }
 /**
+* Read the active Hermes profile name from `hermes profile list` output.
+* The active profile is marked with ◆ in the first column.
+*/
+function getActiveHermesProfileName() {
+	try {
+		return execFileSync("hermes", ["profile", "list"], {
+			encoding: "utf8",
+			timeout: 5e3
+		}).match(/◆(\S+)/)?.[1];
+	} catch {
+		return;
+	}
+}
+/**
+* Read the filesystem path of a Hermes profile from `hermes profile show <name>`.
+*/
+function getHermesProfilePath(profileName) {
+	try {
+		return (execFileSync("hermes", [
+			"profile",
+			"show",
+			profileName
+		], {
+			encoding: "utf8",
+			timeout: 5e3
+		}).match(/^Path:\s+(.+)/m)?.[1]?.trim())?.replace(/^~(?=\/|$)/, os.homedir());
+	} catch {
+		return;
+	}
+}
+/**
+* Extract a one-line description from a Hermes SOUL.md file.
+* Strips HTML comments and Markdown headings, then returns the first
+* non-empty line of actual content.
+*/
+function readHermesSoulDescription(soulPath) {
+	try {
+		let stripped = fs.readFileSync(soulPath, "utf8");
+		let previous;
+		do {
+			previous = stripped;
+			stripped = stripped.replaceAll(/<!--[\s\S]*?-->/g, "").replaceAll(/[<>]/g, "").replaceAll(/^#+\s.*$/gm, "");
+		} while (stripped !== previous);
+		return stripped.split("\n").map((l) => l.trim()).find((l) => l.length > 0) || void 0;
+	} catch {
+		return;
+	}
+}
+function getHermesProfile() {
+	const profileName = getActiveHermesProfileName();
+	if (!profileName) return {};
+	const profilePath = getHermesProfilePath(profileName);
+	return {
+		avatar: "⚡",
+		description: profilePath ? readHermesSoulDescription(path.join(profilePath, "SOUL.md")) : void 0,
+		title: profileName
+	};
+}
+/**
 * Fetch the agent profile (title, avatar, description) from the platform
 * installed on this device. Dispatched by the server via `device.getAgentProfile`.
 *
 * - openclaw: `openclaw agents list --json` for name + emoji, workspace
 *             IDENTITY.md for description fallback
-* - hermes:   not yet implemented — returns empty profile
+* - hermes:   active profile name + SOUL.md description
 */
 async function getAgentProfile(params) {
 	const { platform, agentId } = params;
 	if (platform === "openclaw") return getOpenClawProfile(agentId);
-	if (platform === "hermes") return {};
+	if (platform === "hermes") return getHermesProfile();
 	return {};
 }
 
+//#endregion
+//#region src/daemon/taskRegistry.ts
+function getRegistryPath() {
+	return path.join(os.homedir(), ".lobehub", "task-registry.json");
+}
+function readRegistry() {
+	try {
+		return JSON.parse(fs.readFileSync(getRegistryPath(), "utf8"));
+	} catch {
+		return {};
+	}
+}
+function writeRegistry(entries) {
+	const dir = path.dirname(getRegistryPath());
+	fs.mkdirSync(dir, {
+		mode: 448,
+		recursive: true
+	});
+	fs.writeFileSync(getRegistryPath(), JSON.stringify(entries, null, 2), { mode: 384 });
+}
+function saveTask(entry) {
+	const registry = readRegistry();
+	registry[entry.taskId] = entry;
+	writeRegistry(registry);
+}
+function getTask(taskId) {
+	return readRegistry()[taskId];
+}
+function removeTask(taskId) {
+	const registry = readRegistry();
+	delete registry[taskId];
+	writeRegistry(registry);
+}
+function listTasks() {
+	return Object.values(readRegistry());
+}
+
+//#endregion
+//#region src/tools/heteroTask.ts
+const LOBEHUB_DIR_NAME = process.env.LOBEHUB_CLI_HOME || ".lobehub";
+const HERMES_SESSIONS_FILE = path.join(os.homedir(), LOBEHUB_DIR_NAME, "hermes-sessions.json");
+function getHermesSessionId(topicId) {
+	try {
+		return JSON.parse(fs.readFileSync(HERMES_SESSIONS_FILE, "utf8"))[topicId];
+	} catch {
+		return;
+	}
+}
+function saveHermesSessionId(topicId, sessionId) {
+	let data = {};
+	try {
+		data = JSON.parse(fs.readFileSync(HERMES_SESSIONS_FILE, "utf8"));
+	} catch {}
+	data[topicId] = sessionId;
+	fs.mkdirSync(path.dirname(HERMES_SESSIONS_FILE), { recursive: true });
+	fs.writeFileSync(HERMES_SESSIONS_FILE, JSON.stringify(data), "utf8");
+}
+/** Resolve the absolute path to the `lh` binary to avoid PATH issues in child processes. */
+function resolveLhPath() {
+	try {
+		return execFileSync("which", ["lh"], { encoding: "utf8" }).trim();
+	} catch {
+		return "lh";
+	}
+}
+async function sendAutoNotify(topicId, taskId, text, agentId) {
+	try {
+		await (await getTrpcClient()).agentNotify.notify.mutate({
+			agentId,
+			content: text,
+			role: "assistant",
+			topicId
+		});
+	} catch (err) {
+		log$7.error("Failed to send auto-notify:", err instanceof Error ? err.message : String(err));
+	}
+}
+/**
+* Signal remote hetero task completion to the server so it can publish
+* `agent_runtime_end` to the gateway WS and close the frontend subscription.
+* Called on clean process exit (code=0, no signal) — error exits go through
+* `sendAutoNotify` which writes an error message AND triggers completion via
+* the `done` flag.
+*/
+async function sendDoneSignal(topicId, agentId) {
+	try {
+		await (await getTrpcClient()).agentNotify.notify.mutate({
+			agentId,
+			content: "",
+			done: true,
+			role: "assistant",
+			topicId
+		});
+	} catch (err) {
+		log$7.error("Failed to send done signal:", err instanceof Error ? err.message : String(err));
+	}
+}
+/**
+* Build the notify protocol injected into the first message of a new hetero-agent session.
+* Tells the agent how to push updates back to the LobeHub user via `lh notify`.
+*/
+function buildNotifyProtocol(lhPath, topicId) {
+	return `## Context: This task was dispatched by LobeHub
+
+This conversation / task was sent to you by the **LobeHub platform** on behalf of a user. You are running as a background agent; the user is waiting for your response inside the LobeHub chat interface.
+
+**When to call notify**: any time you have something meaningful to tell the user — a key finding, a decision you made, a result, a question, or your final answer. Think of it as speaking directly to the user in the chat window.
+
+**What to hide**: internal work details such as tool call sequences, file reads, intermediate command output, retries, or low-level reasoning steps. The user cares about outcomes and insights, not your step-by-step mechanics.
+
+## Sending messages back to the user
+
+Use the \`${lhPath} notify\` command. All your updates appear as a **single message bubble** in the UI — create it once and update it in place.\n\n**Step 1 — Open the bubble on your first meaningful update** (captures the messageId):\n\`\`\`\nMSG_ID=$(${lhPath} notify --topic ${topicId} --role assistant --content "Starting..." --json | grep -o '"messageId":"[^"]*"' | cut -d'"' -f4)\n\`\`\`\n\n**Step 2 — Update the same bubble as you make progress**:\n\`\`\`\n${lhPath} notify --topic ${topicId} --role assistant --message-id "$MSG_ID" --content "Still working..."\n\`\`\`\n\n**Step 3 — Replace with your complete, final response when done**:\n\`\`\`\n${lhPath} notify --topic ${topicId} --role assistant --message-id "$MSG_ID" --content "<your full response here>"\n\`\`\`\n\nRules:\n- Always use \`--json\` on the first call and capture \`messageId\` from the output.\n- Always pass \`--message-id\` on every subsequent call so updates overwrite the same bubble.\n- Write what matters to the user — not implementation steps or internal tool calls.\n- Call notify at least once when the task is done, even if there were no intermediate updates.`;
+}
+async function runHeteroTask(params) {
+	const { agentId, agentType, cwd, operationId, prompt, taskId, topicId } = params;
+	const workDir = cwd || process.cwd();
+	const lhPath = resolveLhPath();
+	if (agentType === "openclaw") {
+		const openclawAgent = process.env.OPENCLAW_AGENT_ID ?? "main";
+		const enrichedPrompt = `${prompt}\n\n${buildNotifyProtocol(lhPath, topicId)}`;
+		for (const existing of listTasks()) if (existing.topicId === topicId && existing.agentType === "openclaw") {
+			try {
+				process.kill(existing.pid, "SIGTERM");
+			} catch {}
+			removeTask(existing.taskId);
+		}
+		const child = spawn("openclaw", [
+			"agent",
+			"--agent",
+			openclawAgent,
+			"--session-id",
+			topicId,
+			"--message",
+			enrichedPrompt,
+			"--local"
+		], {
+			cwd: workDir,
+			detached: true,
+			env: { ...process.env },
+			stdio: "ignore"
+		});
+		const pid = child.pid;
+		if (pid === void 0) throw new Error("Failed to get PID for openclaw process");
+		child.unref();
+		saveTask({
+			agentId,
+			agentType,
+			operationId,
+			pid,
+			startedAt: (/* @__PURE__ */ new Date()).toISOString(),
+			taskId,
+			topicId
+		});
+		log$7.info(`OpenClaw task started: taskId=${taskId} pid=${pid} agent=${openclawAgent}`);
+		child.on("close", (code, signal) => {
+			removeTask(taskId);
+			if (code !== 0 || signal !== null) sendAutoNotify(topicId, taskId, signal ? `Task cancelled (signal: ${signal})` : `Task failed (exit code: ${code})`, agentId).finally(() => sendDoneSignal(topicId, agentId));
+			else sendDoneSignal(topicId, agentId);
+		});
+		return JSON.stringify({
+			pid,
+			taskId
+		});
+	}
+	if (agentType === "hermes") {
+		for (const existing of listTasks()) if (existing.topicId === topicId && existing.agentType === "hermes") {
+			try {
+				process.kill(existing.pid, "SIGTERM");
+			} catch {}
+			removeTask(existing.taskId);
+		}
+		const existingSessionId = getHermesSessionId(topicId);
+		const hermesArgs = [
+			"chat",
+			"--query",
+			prompt,
+			"--quiet",
+			"--accept-hooks"
+		];
+		if (existingSessionId) hermesArgs.push("--resume", existingSessionId);
+		const child = spawn("hermes", hermesArgs, {
+			cwd: workDir,
+			detached: true,
+			env: { ...process.env },
+			stdio: [
+				"ignore",
+				"pipe",
+				"ignore"
+			]
+		});
+		const pid = child.pid;
+		if (pid === void 0) throw new Error("Failed to get PID for hermes process");
+		child.unref();
+		saveTask({
+			agentId,
+			agentType,
+			operationId,
+			pid,
+			startedAt: (/* @__PURE__ */ new Date()).toISOString(),
+			taskId,
+			topicId
+		});
+		log$7.info(`Hermes task started: taskId=${taskId} pid=${pid}`);
+		let stdout = "";
+		child.stdout.on("data", (chunk) => {
+			stdout += chunk.toString();
+		});
+		child.on("close", (code, signal) => {
+			removeTask(taskId);
+			if (code !== 0 || signal !== null) {
+				sendAutoNotify(topicId, taskId, signal ? `Task cancelled (signal: ${signal})` : `Task failed (exit code: ${code})`, agentId).finally(() => sendDoneSignal(topicId, agentId));
+				return;
+			}
+			const sessionId = stdout.match(/^session_id:\s*(\S+)/m)?.[1];
+			const response = stdout.replace(/^session_id:[^\n]*\n?/, "").trim();
+			if (sessionId) saveHermesSessionId(topicId, sessionId);
+			if (response) sendAutoNotify(topicId, taskId, response, agentId).finally(() => sendDoneSignal(topicId, agentId));
+			else sendDoneSignal(topicId, agentId);
+		});
+		return JSON.stringify({
+			pid,
+			taskId
+		});
+	}
+	throw new Error(`Unsupported agentType: ${agentType}`);
+}
+async function cancelHeteroTask(params) {
+	const { signal = "SIGINT", taskId } = params;
+	const entry = getTask(taskId);
+	if (!entry) return JSON.stringify({
+		message: `No task found with taskId: ${taskId}`,
+		success: false
+	});
+	try {
+		process.kill(entry.pid, signal);
+	} catch (err) {
+		log$7.warn(`Failed to send ${signal} to pid ${entry.pid}: ${err instanceof Error ? err.message : String(err)}`);
+		removeTask(taskId);
+		await sendAutoNotify(entry.topicId, taskId, "Task already completed or cancelled", entry.agentId);
+	}
+	return JSON.stringify({
+		pid: entry.pid,
+		signal,
+		taskId
+	});
+}
+
 //#endregion
 //#region src/tools/shell.ts
 const processManager = new ShellProcessManager();
@@ -210753,83 +210831,6 @@ const spawnAgent = async (options) => {
 	};
 };
 
-//#endregion
-//#region src/utils/BatchIngester.ts
-var NoopIngestSink = class {
-	async finish(_params) {}
-	async ingest(_events) {}
-};
-const MAX_BATCH = 50;
-const FLUSH_INTERVAL_MS = 250;
-const MAX_RETRIES = 5;
-const sleep$1 = (ms) => new Promise((r) => setTimeout(r, ms));
-/**
-* Buffers `AgentStreamEvent`s and flushes them in batches to an `IngestSink`.
-*
-* Flush triggers:
-*   - Buffer reaches MAX_BATCH (50) → immediate flush
-*   - FLUSH_INTERVAL_MS (250ms) timer fires → flush whatever is buffered
-*
-* Each batch is retried up to MAX_RETRIES (5) times with exponential back-off
-* starting at 500ms, doubling up to 8s.  After the final retry the error is
-* stored and re-thrown by `drain()`, allowing the caller to call
-* `sink.finish({ result: 'error' })` and exit(1).
-*
-* Call order: push() repeatedly → drain() once (before finish()).
-*/
-var BatchIngester = class {
-	buffer = [];
-	fatalError = null;
-	inflightFlush = Promise.resolve();
-	timer = null;
-	constructor(sink) {
-		this.sink = sink;
-	}
-	push(event) {
-		if (this.fatalError) return;
-		this.buffer.push(event);
-		if (this.buffer.length >= MAX_BATCH) {
-			if (this.timer) {
-				clearTimeout(this.timer);
-				this.timer = null;
-			}
-			this.triggerFlush();
-		} else if (!this.timer) this.timer = setTimeout(() => {
-			this.timer = null;
-			this.triggerFlush();
-		}, FLUSH_INTERVAL_MS);
-	}
-	/** Flush remaining buffer and wait for all in-flight sends to settle. */
-	async drain() {
-		if (this.timer) {
-			clearTimeout(this.timer);
-			this.timer = null;
-		}
-		this.triggerFlush();
-		await this.inflightFlush;
-		if (this.fatalError) throw this.fatalError;
-	}
-	async sendWithRetry(batch) {
-		let delay = 500;
-		for (let attempt = 0; attempt <= MAX_RETRIES; attempt++) try {
-			await this.sink.ingest(batch);
-			return;
-		} catch (err) {
-			if (attempt === MAX_RETRIES) {
-				this.fatalError = err instanceof Error ? err : new Error(String(err));
-				throw this.fatalError;
-			}
-			await sleep$1(delay);
-			delay = Math.min(delay * 2, 8e3);
-		}
-	}
-	triggerFlush() {
-		if (this.fatalError || this.buffer.length === 0) return;
-		const batch = this.buffer.splice(0);
-		this.inflightFlush = this.inflightFlush.then(() => this.sendWithRetry(batch)).catch(() => {});
-	}
-};
-
 //#endregion
 //#region src/utils/TrpcIngestSink.ts
 /**
@@ -210840,11 +210841,12 @@ var BatchIngester = class {
 * injected by the server before spawning the sandbox / desktop process).
 */
 var TrpcIngestSink = class {
-	constructor(client, agentType, operationId, topicId) {
+	constructor(client, agentType, operationId, topicId, assistantMessageId) {
 		this.client = client;
 		this.agentType = agentType;
 		this.operationId = operationId;
 		this.topicId = topicId;
+		this.assistantMessageId = assistantMessageId;
 	}
 	async finish(params) {
 		await this.client.aiAgent.heteroFinish.mutate({
@@ -210857,6 +210859,7 @@ var TrpcIngestSink = class {
 	async ingest(events) {
 		await this.client.aiAgent.heteroIngest.mutate({
 			agentType: this.agentType,
+			assistantMessageId: this.assistantMessageId,
 			events,
 			operationId: this.operationId,
 			topicId: this.topicId
@@ -211002,6 +211005,69 @@ const resolvePrompt = async (options) => {
 	};
 	return buildPromptFromText(raw, images);
 };
+var SerialServerIngester = class {
+	accumulatedText = "";
+	fatalError = null;
+	inflight = Promise.resolve();
+	nextSnapshotSeq = 0;
+	pendingTextEvent;
+	timer = null;
+	constructor(sink, snapshotFlushMs = 200) {
+		this.sink = sink;
+		this.snapshotFlushMs = snapshotFlushMs;
+	}
+	push(event) {
+		if (this.fatalError) return;
+		if (event.type === "stream_chunk" && event.data?.chunkType === "text" && typeof event.data?.content === "string") {
+			this.accumulatedText += event.data.content;
+			this.pendingTextEvent = event;
+			if (this.timer) clearTimeout(this.timer);
+			this.timer = setTimeout(() => {
+				this.timer = null;
+				this.queuePendingTextSnapshot();
+			}, this.snapshotFlushMs);
+			return;
+		}
+		this.queuePendingTextSnapshot();
+		this.enqueue(async () => {
+			await this.sink.ingest([event]);
+		});
+	}
+	async drain() {
+		this.queuePendingTextSnapshot();
+		try {
+			await this.inflight;
+		} catch {}
+		if (this.fatalError) throw this.fatalError;
+	}
+	enqueue(task) {
+		this.inflight = this.inflight.then(task).catch((err) => {
+			this.fatalError = err instanceof Error ? err : new Error(String(err));
+			throw this.fatalError;
+		});
+	}
+	queuePendingTextSnapshot() {
+		if (!this.pendingTextEvent || this.fatalError) return;
+		if (this.timer) {
+			clearTimeout(this.timer);
+			this.timer = null;
+		}
+		const baseEvent = this.pendingTextEvent;
+		this.pendingTextEvent = void 0;
+		const snapshotEvent = {
+			...baseEvent,
+			data: {
+				...baseEvent.data,
+				content: this.accumulatedText,
+				snapshotMode: "replace",
+				snapshotSeq: ++this.nextSnapshotSeq
+			}
+		};
+		this.enqueue(async () => {
+			await this.sink.ingest([snapshotEvent]);
+		});
+	}
+};
 const exec = async (options) => {
 	if (!SUPPORTED_AGENT_TYPES.has(options.type)) {
 		log$7.error(`Unsupported --type "${options.type}". Supported: ${[...SUPPORTED_AGENT_TYPES].join(", ")}`);
@@ -211027,11 +211093,13 @@ const exec = async (options) => {
 	const emitJsonl = options.render === "jsonl" || options.render === void 0 && !serverIngest;
 	const agentType = options.type;
 	let sink;
-	if (serverIngest) sink = new TrpcIngestSink(await getTrpcClient(), agentType, operationId, options.topic);
-	else sink = new NoopIngestSink();
-	const ingester = new BatchIngester(sink);
+	let serverIngester;
+	if (serverIngest) {
+		sink = new TrpcIngestSink(await getTrpcClient(), agentType, operationId, options.topic, process.env.LOBEHUB_ASSISTANT_MESSAGE_ID);
+		serverIngester = new SerialServerIngester(sink);
+	}
 	/**
-	* Spawn one agent process and stream all its events into `ingester`.
+	* Spawn one agent process and stream all its events into the server ingester.
 	*
 	* When `interceptResumeErrors` is true, any `error`-type event whose
 	* message matches `RESUME_RETRY_PATTERNS` is withheld from the
@@ -211057,6 +211125,7 @@ const exec = async (options) => {
 		}
 		const STDERR_CAP = 8 * 1024;
 		let stderrContent = "";
+		const stderrEnded = once(handle.stderr, "end").then(() => void 0);
 		handle.stderr.on("data", (chunk) => {
 			if (stderrContent.length < STDERR_CAP) stderrContent += chunk.toString();
 		});
@@ -211069,22 +211138,22 @@ const exec = async (options) => {
 			}
 			interrupted = true;
 			handle.kill("SIGINT");
-			if (serverIngest) try {
-				await ingester.drain();
+			if (serverIngester && sink) try {
+				await serverIngester.drain();
 				await sink.finish({ result: "cancelled" });
 			} catch {}
 		};
 		const onSigterm = async () => {
 			handle.kill("SIGTERM");
-			if (serverIngest) try {
-				await ingester.drain();
+			if (serverIngester && sink) try {
+				await serverIngester.drain();
 				await sink.finish({ result: "cancelled" });
 			} catch {}
 		};
 		process.on("SIGINT", onSigint);
 		process.on("SIGTERM", onSigterm);
 		let resumeNotFound = false;
-		let ingestError = false;
+		const ingestError = false;
 		try {
 			for await (const event of handle.events) {
 				if (interceptResumeErrors && event.type === "error") {
@@ -211096,12 +211165,12 @@ const exec = async (options) => {
 					}
 				}
 				if (emitJsonl) process.stdout.write(`${JSON.stringify(event)}\n`);
-				ingester.push(event);
+				serverIngester?.push(event);
 			}
 		} catch (err) {
 			log$7.error("Stream error from agent process:", err instanceof Error ? err.message : String(err));
-			if (serverIngest) try {
-				await ingester.drain();
+			if (serverIngester && sink) try {
+				await serverIngester.drain();
 				await sink.finish({
 					error: {
 						message: String(err),
@@ -211116,6 +211185,7 @@ const exec = async (options) => {
 			process.off("SIGTERM", onSigterm);
 		}
 		const { code, signal } = await handle.exit;
+		await stderrEnded;
 		if (interceptResumeErrors && !resumeNotFound && code !== 0 && looksLikeNeedsRetryWithoutResume(stderrContent)) resumeNotFound = true;
 		return {
 			code,
@@ -211147,9 +211217,9 @@ const exec = async (options) => {
 		}, false);
 	}
 	const { code, signal, sessionId } = result;
-	if (serverIngest) {
+	if (serverIngester && sink) {
 		try {
-			await ingester.drain();
+			await serverIngester.drain();
 		} catch (err) {
 			log$7.error("Failed to flush events to server:", err instanceof Error ? err.message : String(err));
 			result = {
@@ -215037,7 +215107,11 @@ function createProgram() {
 
 //#endregion
 //#region src/index.ts
-createProgram().parse(process.argv, { from: "node" });
+createProgram().parseAsync(process.argv, { from: "node" }).catch((error) => {
+	const message = error instanceof Error ? error.message : String(error);
+	log$7.error(message);
+	process.exit(1);
+});
 
 //#endregion
 export {  };

package/man/man1/lh.1

@@ -1,6 +1,6 @@
 .\" Code generated by `npm run man:generate`; DO NOT EDIT.
 .\" Manual command details come from the Commander command tree.
-.TH LH 1 "" "@lobehub/cli 0.0.20" "User Commands"
+.TH LH 1 "" "@lobehub/cli 0.0.21" "User Commands"
 .SH NAME
 lh \- LobeHub CLI \- manage and connect to LobeHub services
 .SH SYNOPSIS

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lobehub/cli",
-  "version": "0.0.20",
+  "version": "0.0.21",
   "type": "module",
   "bin": {
     "lh": "./dist/index.js",