@lobehub/cli 0.0.16-beta.1 → 0.0.17

package/dist/index.js

@@ -11374,6 +11374,25 @@ const inferAttachmentType = (mimeType) => {
 	return "file";
 };
 /**
+* Resolve a list of `--attachment` flag values into `AttachmentInput[]`. Each
+* entry is either a URL or a local file path. Returns `undefined` when no
+* flags were passed so callers can omit the field on the wire entirely (the
+* TRPC schema treats absent vs empty differently). Bails the process on
+* load failures — a silently-dropped attachment would be worse than a
+* loud error here.
+*/
+const resolveAttachmentFlags = async (flags) => {
+	if (flags.length === 0) return void 0;
+	const out = [];
+	for (const raw of flags) try {
+		out.push(await parseAttachmentArg(raw));
+	} catch (error) {
+		log$7.error(`Failed to load attachment "${raw}": ${error.message}`);
+		process.exit(1);
+	}
+	return out;
+};
+/**
 * Parse a single `--attachment <value>` argument. Accepted forms:
 *   - `https://…` / `http://…`           → fetchUrl, type inferred from extension
 *   - any other string                    → treated as a local file path;
@@ -11399,22 +11418,29 @@ const parseAttachmentArg = async (raw) => {
 		type: inferAttachmentType(mimeType)
 	};
 };
+/**
+* Resolve the `<botIdOrAtKey>` positional argument into a `{ botId? |
+* messengerInstallationId? }` shape that matches the TRPC send procedures'
+* `exactly-one-of` constraint.
+*
+* Convention: a value prefixed with `@` is treated as a System Bot
+* messenger installation id (e.g. `@inst_abc123`); anything else is a
+* per-agent bot id. The `@` was chosen because `agent_bot_providers`.id is
+* always a UUID — no UUID starts with `@`, so the prefix unambiguously
+* disambiguates without breaking the existing UUID-only call sites.
+*/
+const resolveSendTargetArg = (value) => {
+	if (value.startsWith("@")) return { messengerInstallationId: value.slice(1) };
+	return { botId: value };
+};
 function registerBotMessageCommands(bot) {
 	const message = bot.command("message").description("Send and manage messages on connected platforms");
-	message.command("send <botId>").description("Send a message to a channel").requiredOption("--target <channelId>", "Target channel / conversation ID").requiredOption("--message <text>", "Message content").option("--attachment <pathOrUrl>", "Attach a file by local path or remote URL (repeatable). Local paths are base64-encoded; http(s) URLs are passed as fetchUrl.", collectOptions, []).option("--reply-to <messageId>", "Reply to a specific message").option("--json", "Output JSON").action(async (botId, options) => {
-		let attachments;
-		if (options.attachment.length > 0) {
-			attachments = [];
-			for (const raw of options.attachment) try {
-				attachments.push(await parseAttachmentArg(raw));
-			} catch (error) {
-				log$7.error(`Failed to load attachment "${raw}": ${error.message}`);
-				process.exit(1);
-			}
-		}
+	message.command("send <botIdOrAtKey>").description("Send a message to a channel. Pass a per-agent bot id, or \"@<messenger-install-id>\" to send through a System Bot messenger installation (see `lh bot messengers list`).").requiredOption("--target <channelId>", "Target channel / conversation ID").requiredOption("--message <text>", "Message content").option("--attachment <pathOrUrl>", "Attach a file by local path or remote URL (repeatable). Local paths are base64-encoded; http(s) URLs are passed as fetchUrl.", collectOptions, []).option("--reply-to <messageId>", "Reply to a specific message").option("--json", "Output JSON").action(async (botIdOrAtKey, options) => {
+		const attachments = await resolveAttachmentFlags(options.attachment);
+		const target = resolveSendTargetArg(botIdOrAtKey);
 		const result = await (await getTrpcClient()).botMessage.sendMessage.mutate({
+			...target,
 			attachments,
-			botId,
 			channelId: options.target,
 			content: options.message,
 			replyTo: options.replyTo
@@ -11427,6 +11453,23 @@ function registerBotMessageCommands(bot) {
 		const suffix = attachments?.length ? ` with ${attachments.length} attachment(s)` : "";
 		console.log(`${import_picocolors.default.green("✓")} Message sent${r.messageId ? ` (${import_picocolors.default.dim(r.messageId)})` : ""}${suffix}`);
 	});
+	message.command("dm <botIdOrAtKey>").description("Send a direct message to a platform user. Pass a per-agent bot id, or \"@<messenger-install-id>\" for a System Bot install.").requiredOption("--user-id <id>", "Target user ID on the platform").requiredOption("--message <text>", "Message content").option("--attachment <pathOrUrl>", "Attach a file by local path or remote URL (repeatable). Local paths are base64-encoded; http(s) URLs are passed as fetchUrl.", collectOptions, []).option("--json", "Output JSON").action(async (botIdOrAtKey, options) => {
+		const attachments = await resolveAttachmentFlags(options.attachment);
+		const target = resolveSendTargetArg(botIdOrAtKey);
+		const result = await (await getTrpcClient()).botMessage.sendDirectMessage.mutate({
+			...target,
+			attachments,
+			content: options.message,
+			userId: options.userId
+		});
+		if (options.json) {
+			outputJson(result);
+			return;
+		}
+		const r = result;
+		const suffix = attachments?.length ? ` with ${attachments.length} attachment(s)` : "";
+		console.log(`${import_picocolors.default.green("✓")} DM sent${r.messageId ? ` (${import_picocolors.default.dim(r.messageId)})` : ""}${suffix}`);
+	});
 	message.command("read <botId>").description("Read messages from a channel").requiredOption("--target <channelId>", "Target channel / conversation ID").option("--limit <n>", "Max messages to fetch", String(50)).option("--before <messageId>", "Read messages before this ID").option("--after <messageId>", "Read messages after this ID").option("--start-time <timestamp>", "Start time as Unix seconds (Feishu/Lark)").option("--end-time <timestamp>", "End time as Unix seconds (Feishu/Lark)").option("--cursor <token>", "Pagination cursor from a previous response (Feishu/Lark)").option("--json", "Output JSON").action(async (botId, options) => {
 		const result = await (await getTrpcClient()).botMessage.readMessages.query({
 			after: options.after,
@@ -11627,13 +11670,17 @@ function registerBotMessageCommands(bot) {
 			"MESSAGES"
 		]);
 	});
-	thread.command("reply <botId>").description("Reply to a thread").requiredOption("--thread-id <id>", "Thread ID").requiredOption("--message <text>", "Reply content").action(async (botId, options) => {
+	thread.command("reply <botIdOrAtKey>").description("Reply to a thread. Pass a per-agent bot id, or \"@<messenger-install-id>\" for a System Bot install.").requiredOption("--thread-id <id>", "Thread ID").requiredOption("--message <text>", "Reply content").option("--attachment <pathOrUrl>", "Attach a file by local path or remote URL (repeatable). Local paths are base64-encoded; http(s) URLs are passed as fetchUrl.", collectOptions, []).action(async (botIdOrAtKey, options) => {
+		const attachments = await resolveAttachmentFlags(options.attachment);
+		const target = resolveSendTargetArg(botIdOrAtKey);
 		const r = await (await getTrpcClient()).botMessage.replyToThread.mutate({
-			botId,
+			...target,
+			attachments,
 			content: options.message,
 			threadId: options.threadId
 		});
-		console.log(`${import_picocolors.default.green("✓")} Reply sent${r.messageId ? ` (${import_picocolors.default.dim(r.messageId)})` : ""}`);
+		const suffix = attachments?.length ? ` with ${attachments.length} attachment(s)` : "";
+		console.log(`${import_picocolors.default.green("✓")} Reply sent${r.messageId ? ` (${import_picocolors.default.dim(r.messageId)})` : ""}${suffix}`);
 	});
 	const channel = message.command("channel").description("Manage channels");
 	channel.command("list <botId>").description("List channels").option("--server-id <id>", "Server / workspace ID").option("--filter <type>", "Filter by type").option("--json", "Output JSON").action(async (botId, options) => {
@@ -11696,6 +11743,178 @@ function collectOptions(value, previous) {
 	return [...previous, value];
 }
 
+//#endregion
+//#region src/commands/botMessengers.ts
+const PLATFORMS = [
+	"telegram",
+	"slack",
+	"discord"
+];
+const validatePlatform = (value) => {
+	if (!PLATFORMS.includes(value)) throw new Error(`Unknown messenger platform: ${value}. Valid values: ${PLATFORMS.join(", ")}.`);
+	return value;
+};
+function registerBotMessengersCommands(bot) {
+	const messengers = bot.command("messengers").description("Manage System Bot messenger installations (Slack workspaces, Discord guilds, Telegram) and per-user account links");
+	messengers.command("list").description("List all System Bot installations the current user has connected.").option("--json", "Output JSON").action(async (options) => {
+		const installations = await (await getTrpcClient()).messenger.listMyInstallations.query();
+		if (options.json) {
+			outputJson(installations);
+			return;
+		}
+		if (installations.length === 0) {
+			console.log("No System Bot installations connected.");
+			console.log(`\nRun ${import_picocolors.default.dim("lh bot messengers platforms")} to see what's available, then install via ${import_picocolors.default.dim("Settings → Messenger")} (OAuth requires a browser).`);
+			return;
+		}
+		printTable(installations.map((i) => [
+			i.id || "",
+			i.platform || "",
+			i.tenantName || i.tenantId || "(global)",
+			i.applicationId || "",
+			i.installedAt ? new Date(i.installedAt).toISOString().slice(0, 10) : ""
+		]), [
+			"INSTALLATION ID",
+			"PLATFORM",
+			"TENANT",
+			"APP ID",
+			"INSTALLED"
+		]);
+		console.log(`\nUse ${import_picocolors.default.dim("@<INSTALLATION ID>")} as the positional argument on ${import_picocolors.default.dim("lh bot message send/dm/thread reply")} to route through a System Bot install.`);
+	});
+	messengers.command("view <installationId>").description("Show detail for one installation.").option("--json", "Output JSON").action(async (installationId, options) => {
+		const install = (await (await getTrpcClient()).messenger.listMyInstallations.query()).find((i) => i.id === installationId);
+		if (!install) {
+			if (options.json) outputJson(null);
+			else console.error(import_picocolors.default.red(`Installation not found: ${installationId}`));
+			process.exit(1);
+			return;
+		}
+		if (options.json) {
+			outputJson(install);
+			return;
+		}
+		console.log(`${import_picocolors.default.bold("Installation")} ${import_picocolors.default.dim(install.id)}`);
+		console.log(`  Platform:       ${install.platform}`);
+		console.log(`  Tenant:         ${install.tenantName || install.tenantId || "(global)"}`);
+		if (install.tenantId && install.tenantName) console.log(`  Tenant ID:      ${install.tenantId}`);
+		console.log(`  Application ID: ${install.applicationId}`);
+		if (install.scope) console.log(`  OAuth Scope:    ${install.scope}`);
+		if (install.installedAt) console.log(`  Installed:      ${new Date(install.installedAt).toISOString()}`);
+		if (install.enterpriseId) console.log(`  Enterprise ID:  ${install.enterpriseId}`);
+		if (install.isEnterpriseInstall) console.log(`  Enterprise:     yes`);
+	});
+	messengers.command("uninstall <installationId>").description("Revoke a workspace install. AFFECTS EVERY USER IN THAT WORKSPACE — for Slack this freezes the bot; for Discord it removes the audit entry (a guild admin must remove the bot separately). To disconnect only your own account, use `bot messengers links unlink`.").option("--yes", "Skip confirmation prompt").action(async (installationId, options) => {
+		const client = await getTrpcClient();
+		if (!options.yes) {
+			const install = (await client.messenger.listMyInstallations.query()).find((i) => i.id === installationId);
+			const label = install ? `${install.platform} (${install.tenantName || install.tenantId || "global"})` : installationId;
+			if (!await confirm(`${import_picocolors.default.yellow("⚠")}  Uninstall ${import_picocolors.default.bold(label)} — this revokes the install for the whole workspace. Continue?`)) {
+				console.log("Aborted.");
+				return;
+			}
+		}
+		await client.messenger.uninstallInstallation.mutate({ installationId });
+		console.log(`${import_picocolors.default.green("✓")} Installation ${import_picocolors.default.dim(installationId)} revoked.`);
+	});
+	messengers.command("platforms").description("List the platforms available for System Bot OAuth install.").option("--json", "Output JSON").action(async (options) => {
+		const platforms = await (await getTrpcClient()).messenger.availablePlatforms.query();
+		if (options.json) {
+			outputJson(platforms);
+			return;
+		}
+		if (platforms.length === 0) {
+			console.log("No System Bot platforms are configured on this deployment.");
+			return;
+		}
+		printTable(platforms.map((p) => [
+			p.id || "",
+			p.name || "",
+			p.appId || "",
+			p.botUsername || ""
+		]), [
+			"ID",
+			"NAME",
+			"APP ID",
+			"BOT USERNAME"
+		]);
+		console.log(`\nInstalls are initiated via ${import_picocolors.default.dim("Settings → Messenger")} in the web UI (OAuth needs a browser).`);
+	});
+	const links = messengers.command("links").description("Manage per-user account links — routing of inbound IM to your agents");
+	links.command("list").description("List all your account links across platforms and tenants.").option("--json", "Output JSON").action(async (options) => {
+		const linkRows = await (await getTrpcClient()).messenger.listMyLinks.query();
+		if (options.json) {
+			outputJson(linkRows);
+			return;
+		}
+		if (linkRows.length === 0) {
+			console.log("No account links yet. Complete verify-im on a platform first.");
+			return;
+		}
+		printTable(linkRows.map((l) => [
+			l.platform || "",
+			l.tenantId || "(global)",
+			l.activeAgentId || import_picocolors.default.dim("(unset)"),
+			l.platformUsername || l.platformUserId || ""
+		]), [
+			"PLATFORM",
+			"TENANT",
+			"ACTIVE AGENT",
+			"PLATFORM USER"
+		]);
+	});
+	links.command("view <platform>").description("Show one account link.").option("--tenant <id>", "Tenant scope (Slack workspace id). Omit for global-bot platforms.").option("--json", "Output JSON").action(async (platform, options) => {
+		const client = await getTrpcClient();
+		const platformValidated = validatePlatform(platform);
+		const link = await client.messenger.getMyLink.query({
+			platform: platformValidated,
+			tenantId: options.tenant
+		});
+		if (!link) {
+			console.error(import_picocolors.default.red(`No link found for ${platform}${options.tenant ? ` (tenant ${options.tenant})` : ""}`));
+			process.exit(1);
+			return;
+		}
+		if (options.json) {
+			outputJson(link);
+			return;
+		}
+		console.log(`${import_picocolors.default.bold("Link")} ${import_picocolors.default.dim(link.platform)}`);
+		if (link.tenantId) console.log(`  Tenant ID:        ${link.tenantId}`);
+		console.log(`  Platform User ID: ${link.platformUserId}`);
+		if (link.platformUsername) console.log(`  Platform User:    ${link.platformUsername}`);
+		console.log(`  Active Agent:     ${link.activeAgentId ?? import_picocolors.default.dim("(unset)")}`);
+	});
+	links.command("set-agent <platform>").description("Change which agent receives inbound IM on a platform link.").requiredOption("--agent <id>", "Agent id to route to, or \"none\" to clear the active agent.").option("--tenant <id>", "Tenant scope (Slack workspace id). Omit for global-bot platforms.").action(async (platform, options) => {
+		const client = await getTrpcClient();
+		const platformValidated = validatePlatform(platform);
+		const agentId = options.agent === "none" ? null : options.agent;
+		await client.messenger.setActiveAgent.mutate({
+			agentId,
+			platform: platformValidated,
+			tenantId: options.tenant
+		});
+		const scope = options.tenant ? ` (tenant ${options.tenant})` : "";
+		const target = agentId === null ? "cleared" : `set to agent ${import_picocolors.default.dim(agentId)}`;
+		console.log(`${import_picocolors.default.green("✓")} Active agent for ${platform}${scope} ${target}.`);
+	});
+	links.command("unlink <platform>").description("Remove your account link for a platform. Workspace install is unaffected — colleagues can still use the bot.").option("--tenant <id>", "Tenant scope (Slack workspace id). Omit for global-bot platforms.").option("--yes", "Skip confirmation prompt").action(async (platform, options) => {
+		const client = await getTrpcClient();
+		const platformValidated = validatePlatform(platform);
+		if (!options.yes) {
+			if (!await confirm(`Unlink your account from ${import_picocolors.default.bold(platform)}${options.tenant ? ` (tenant ${options.tenant})` : ""}?`)) {
+				console.log("Aborted.");
+				return;
+			}
+		}
+		await client.messenger.unlink.mutate({
+			platform: platformValidated,
+			tenantId: options.tenant
+		});
+		console.log(`${import_picocolors.default.green("✓")} Unlinked.`);
+	});
+}
+
 //#endregion
 //#region src/commands/bot.ts
 const DM_POLICIES = [
@@ -12004,6 +12223,7 @@ function registerWatchKeywordsCommand(bot) {
 function registerBotCommand(program) {
 	const bot = program.command("bot").description("Manage bot integrations");
 	registerBotMessageCommands(bot);
+	registerBotMessengersCommands(bot);
 	bot.command("platforms").description("List supported platforms and their required credentials").option("--json", "Output JSON").action(async (options) => {
 		const platforms = await (await getTrpcClient()).agentBotProvider.listPlatforms.query();
 		if (options.json) {
@@ -16453,6 +16673,318 @@ 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);
+}
+
+//#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";
+	}
+}
+/**
+* Check whether an openclaw session already exists for the given topicId.
+* The session key format is `agent:<agentId>:explicit:<sessionId>`.
+* Returns false on any error so that callers default to injecting the full protocol.
+*/
+function openclawSessionExists(agentId, topicId) {
+	try {
+		const raw = execFileSync("openclaw", [
+			"sessions",
+			"--agent",
+			agentId,
+			"--json"
+		], { encoding: "utf8" });
+		const data = JSON.parse(raw);
+		const expectedKey = `agent:${agentId}:explicit:${topicId}`;
+		return data.sessions?.some((s) => s.key === expectedKey) ?? false;
+	} catch {
+		return false;
+	}
+}
+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 child = spawn("openclaw", [
+			"agent",
+			"--agent",
+			openclawAgent,
+			"--session-id",
+			topicId,
+			"--message",
+			!openclawSessionExists(openclawAgent, topicId) ? `${prompt}\n\n${buildNotifyProtocol(lhPath, topicId)}` : prompt,
+			"--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);
+				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
+/**
+* Probe whether a specific agent platform is available on this device.
+* Dispatched by the server via `device.checkCapability` tRPC procedure.
+*
+* - openclaw: runs `openclaw --version` and parses the output
+* - hermes:   hits the gateway health endpoint on the configured port
+*/
+async function checkPlatformCapability(params) {
+	const { platform } = params;
+	if (platform === "openclaw") try {
+		return {
+			available: true,
+			version: execFileSync("openclaw", ["--version"], {
+				encoding: "utf8",
+				timeout: 5e3
+			}).trim().split(/\s+/).at(-1)
+		};
+	} catch (err) {
+		return {
+			available: false,
+			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}`
+			};
+		}
+	}
+	return {
+		available: false,
+		reason: `Unknown platform: ${platform}`
+	};
+}
+
 //#endregion
 //#region node_modules/.pnpm/diff@8.0.4/node_modules/diff/libesm/diff/base.js
 var Diff = class {
@@ -205897,6 +206429,11 @@ const TEXT_READABLE_FILE_TYPES = [
 	"scala",
 	"groovy",
 	"gradle",
+	"tex",
+	"sty",
+	"cls",
+	"bib",
+	"bbl",
 	"log",
 	"sql",
 	"patch",
@@ -206606,204 +207143,65 @@ async function runCommand$1({ command, cwd, description, env: extraEnv, run_in_b
 }
 
 //#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 {};
+//#region src/tools/getAgentProfile.ts
+const IDENTITY_FILES$1 = ["IDENTITY.md", "SOUL.md"];
+/**
+* Try to extract a description from the workspace identity file.
+* Looks for Creature / Vibe / Description fields in IDENTITY.md or SOUL.md.
+*/
+function readDescriptionFromWorkspace(workspacePath) {
+	for (const filename of IDENTITY_FILES$1) {
+		const filePath = path.join(workspacePath, filename);
+		if (!fs.existsSync(filePath)) continue;
+		const match = fs.readFileSync(filePath, "utf8").match(/\*{0,2}(?:Creature|Vibe|Description):?\*{0,2}\s*(.+)/i);
+		if (!match) continue;
+		const value = match[1].trim();
+		if (/^[_*(（].*[）)*_]$|^(?:tbd|todo|n\/?a|none|待定|未定)$/i.test(value)) continue;
+		return value;
 	}
 }
-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);
-}
-
-//#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() {
+function getOpenClawProfile(agentId) {
+	let output;
 	try {
-		return execFileSync("which", ["lh"], { encoding: "utf8" }).trim();
+		output = execFileSync("openclaw", [
+			"agents",
+			"list",
+			"--json"
+		], {
+			encoding: "utf8",
+			timeout: 5e3
+		});
 	} 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 {};
 	}
-	return DEFAULT_HERMES_PORT;
-}
-async function isHermesGatewayRunning(port) {
+	let agents;
 	try {
-		return (await fetch(`http://localhost:${port}/health`)).ok;
+		agents = JSON.parse(output);
 	} 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: JSON.stringify({
-				stage: "error",
-				taskId,
-				text
-			}),
-			topicId
-		});
-	} catch (err) {
-		log$7.error("Failed to send auto-notify:", err instanceof Error ? err.message : String(err));
-	}
-}
-async function runHeteroTask(params) {
-	const { agentId, agentType, cwd, operationId, prompt, taskId, topicId } = params;
-	const workDir = cwd || process.cwd();
-	if (agentType === "openclaw") {
-		const enrichedPrompt = `${prompt}\n\nWhen your task is complete, run this shell command to report back:\n${resolveLhPath()} notify --topic ${topicId} --content '${JSON.stringify({
-			stage: "done",
-			taskId,
-			text: "Task completed"
-		})}'`;
-		const openclawAgent = process.env.OPENCLAW_AGENT_ID ?? "main";
-		const child = spawn("openclaw", [
-			"agent",
-			"--agent",
-			openclawAgent,
-			"--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);
-		});
-		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
-		});
+		return {};
 	}
-	throw new Error(`Unsupported agentType: ${agentType}`);
+	const agent = agentId ? agents.find((a) => a.id === agentId) : agents.find((a) => a.isDefault) ?? agents[0];
+	if (!agent) return {};
+	const title = agent.identityName || void 0;
+	return {
+		avatar: agent.identityEmoji || "🦞",
+		description: agent.workspace ? readDescriptionFromWorkspace(agent.workspace) : void 0,
+		title
+	};
 }
-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
-	});
+/**
+* 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
+*/
+async function getAgentProfile(params) {
+	const { platform, agentId } = params;
+	if (platform === "openclaw") return getOpenClawProfile(agentId);
+	if (platform === "hermes") return {};
+	return {};
 }
 
 //#endregion
@@ -206829,6 +207227,8 @@ async function killCommand(params) {
 //#region src/tools/index.ts
 const methodMap = {
 	cancelHeteroTask,
+	checkPlatformCapability,
+	getAgentProfile,
 	editFile: editLocalFile,
 	getCommandOutput,
 	globFiles: globLocalFiles,
@@ -212383,13 +212783,16 @@ function registerModelCommand(program) {
 //#endregion
 //#region src/commands/notify.ts
 function registerNotifyCommand(program) {
-	program.command("notify").description("Send a callback message to a topic and trigger the agent to process it").requiredOption("--topic <topicId>", "Target topic ID").requiredOption("-c, --content <content>", "Message content").option("--agent-id <agentId>", "Agent ID (overrides topic default)").option("--thread-id <threadId>", "Thread ID for threaded conversations").option("--json", "Output JSON").action(async (options) => {
-		log$7.debug("notify: topic=%s, agentId=%s", options.topic, options.agentId);
+	program.command("notify").description("Send a callback message to a topic and trigger the agent to process it").requiredOption("--topic <topicId>", "Target topic ID").requiredOption("-c, --content <content>", "Message content").option("--agent-id <agentId>", "Agent ID (overrides topic default)").option("--thread-id <threadId>", "Thread ID for threaded conversations").option("--role <role>", "Message role: user (default, triggers agent reply) | assistant (writes directly as agent message)", "user").option("--message-id <messageId>", "When --role assistant: update an existing message instead of creating a new one (keeps a single bubble)").option("--continue", "When --role assistant: trigger a follow-up agent turn after writing the message").option("--json", "Output JSON").action(async (options) => {
+		log$7.debug("notify: topic=%s, agentId=%s, role=%s, messageId=%s", options.topic, options.agentId, options.role, options.messageId);
 		const client = await getTrpcClient();
 		try {
 			const result = await client.agentNotify.notify.mutate({
 				agentId: options.agentId,
 				content: options.content,
+				continue: options.continue,
+				messageId: options.messageId,
+				role: options.role,
 				threadId: options.threadId,
 				topicId: options.topic
 			});

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.16\-beta.1" "User Commands"
+.TH LH 1 "" "@lobehub/cli 0.0.17" "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.16-beta.1",
+  "version": "0.0.17",
   "type": "module",
   "bin": {
     "lh": "./dist/index.js",