fengming 0.3.4 → 0.3.5

package/dist/register.message-B8PYgZ-j.js

@@ -0,0 +1,404 @@
+import { a as normalizeLowercaseStringOrEmpty, c as normalizeOptionalString } from "./string-coerce-DKw2K5wM.js";
+import { _ as parseStrictPositiveInteger, g as parseStrictNonNegativeInteger } from "./number-coercion-D1aDmIZp.js";
+import "./parse-finite-number-CpgOyjPq.js";
+import { t as formatCliCommand } from "./command-format-Jv8eeOPe.js";
+import { t as formatDocsLink } from "./links-CgdQazeA.js";
+import { r as theme } from "./theme-CLQ2HbnQ.js";
+import { n as defaultRuntime, r as writeRuntimeJson } from "./runtime-BkTkFkXs.js";
+import { r as setVerbose } from "./global-state-BAD7XgmL.js";
+import "./agent-scope-DYvAPpmY.js";
+import { c as resolveDefaultAgentId } from "./agent-scope-config-BFfPgg3b.js";
+import { t as danger } from "./globals-644GLqmc.js";
+import { i as getRuntimeConfig } from "./io-DAZXanmU.js";
+import "./config-Dp73zulp.js";
+import { i as GATEWAY_CLIENT_NAMES, r as GATEWAY_CLIENT_MODES } from "./client-info-D6_UASoA.js";
+import { n as CHANNEL_TARGET_DESCRIPTION, t as CHANNEL_TARGETS_DESCRIPTION } from "./channel-target-BUdjgThl.js";
+import { o as runGlobalGatewayStopSafely } from "./hook-runner-global-lWQvOg8l.js";
+import { t as getChannelPlugin } from "./registry-BoFbe6qB.js";
+import "./plugins-CK1HU7pG.js";
+import { n as CHANNEL_MESSAGE_ACTION_NAMES, t as resolveMessageSecretScope } from "./message-secret-scope-DjkzDA8-.js";
+import { d as getScopedChannelsCommandSecretTargets } from "./command-secret-targets-BOJlcBil.js";
+import { n as runMessageAction } from "./message-action-runner-ByMT3_eb.js";
+import { r as withProgress } from "./progress-DNEvewzh.js";
+import { n as runCommandWithRuntime } from "./cli-utils-JYDDzCMN.js";
+import { t as formatHelpExamples } from "./help-format-CBGqVsX5.js";
+import { t as collectOption } from "./helpers-yckYmcNJ.js";
+import { t as createDefaultDeps } from "./deps-DMtOVZ9f.js";
+import { t as createOutboundSendDeps } from "./outbound-send-deps-B37JnKsh.js";
+import { t as resolveCommandConfigWithSecrets } from "./command-config-resolution-XCA63Yv8.js";
+import { t as ensurePluginRegistryLoaded } from "./runtime-registry-loader-DzhYCt4s.js";
+import "./plugin-registry-I1fegSdK.js";
+//#region src/commands/message.ts
+function extractMessageId(payload) {
+	if (!payload || typeof payload !== "object") return;
+	const record = payload;
+	const direct = normalizeOptionalString(record.messageId);
+	if (direct) return direct;
+	const result = record.result;
+	if (result && typeof result === "object") {
+		const nested = normalizeOptionalString(result.messageId);
+		if (nested) return nested;
+	}
+}
+function buildMessageCliJson(result) {
+	const messageId = extractMessageId(result.payload);
+	return {
+		action: result.action,
+		channel: result.channel,
+		dryRun: result.dryRun,
+		handledBy: result.handledBy,
+		...messageId ? { messageId } : {},
+		payload: result.payload
+	};
+}
+async function messageCommand(opts, deps, runtime) {
+	const loadedRaw = getRuntimeConfig();
+	const scope = resolveMessageSecretScope({
+		channel: opts.channel,
+		target: opts.target,
+		targets: opts.targets,
+		accountId: opts.accountId
+	});
+	const scopedTargets = getScopedChannelsCommandSecretTargets({
+		config: loadedRaw,
+		channel: scope.channel,
+		accountId: scope.accountId
+	});
+	const { effectiveConfig: cfg } = await resolveCommandConfigWithSecrets({
+		config: loadedRaw,
+		commandName: "message",
+		targetIds: scopedTargets.targetIds,
+		...scopedTargets.allowedPaths ? { allowedPaths: scopedTargets.allowedPaths } : {},
+		runtime,
+		autoEnable: true
+	});
+	const actionInput = (normalizeOptionalString(opts.action) ?? "") || "send";
+	const normalizedActionInput = normalizeLowercaseStringOrEmpty(actionInput);
+	const actionMatch = CHANNEL_MESSAGE_ACTION_NAMES.find((name) => normalizeLowercaseStringOrEmpty(name) === normalizedActionInput);
+	if (!actionMatch) throw new Error(`Unknown message action "${actionInput}". Use one of ${CHANNEL_MESSAGE_ACTION_NAMES.join(", ")}. Example: ${formatCliCommand("fengming message send --channel <channel> --target <id> --text <message>")}.`);
+	const action = actionMatch;
+	const outboundDeps = createOutboundSendDeps(deps);
+	const run = async () => await runMessageAction({
+		cfg,
+		action,
+		params: opts,
+		deps: outboundDeps,
+		agentId: resolveDefaultAgentId(cfg),
+		senderIsOwner: opts.senderIsOwner !== false,
+		gateway: {
+			clientName: GATEWAY_CLIENT_NAMES.CLI,
+			mode: GATEWAY_CLIENT_MODES.CLI
+		}
+	});
+	const json = opts.json === true;
+	const dryRun = opts.dryRun === true;
+	const result = !json && !dryRun && (action === "send" || action === "poll") ? await withProgress({
+		label: action === "poll" ? "Sending poll..." : "Sending...",
+		indeterminate: true,
+		enabled: true
+	}, run) : await run();
+	if (json) {
+		writeRuntimeJson(runtime, buildMessageCliJson(result));
+		return;
+	}
+	const { formatMessageCliText } = await import("./message-format-cCN1Owie.js");
+	for (const line of formatMessageCliText(result)) runtime.log(line);
+}
+//#endregion
+//#region src/cli/program/message/helpers.ts
+const GATEWAY_STOP_TIMEOUT_MS = 2500;
+const ACTIONS_WITHOUT_STOP_HOOKS = new Set(["read"]);
+const ACTIONS_REQUIRING_CONFIGURED_CHANNEL_PRELOAD = new Set(["broadcast"]);
+const CHANNEL_MESSAGE_ACTION_NAME_SET = new Set(CHANNEL_MESSAGE_ACTION_NAMES);
+const STRICT_POSITIVE_INTEGER_OPTIONS = new Map([
+	["pollDurationHours", "--poll-duration-hours"],
+	["pollDurationSeconds", "--poll-duration-seconds"],
+	["durationMin", "--duration-min"],
+	["limit", "--limit"],
+	["autoArchiveMin", "--auto-archive-min"]
+]);
+const STRICT_NON_NEGATIVE_INTEGER_OPTIONS = new Map([["deleteDays", "--delete-days"]]);
+function normalizeMessageOptions(opts) {
+	const { account, ...rest } = opts;
+	return {
+		...rest,
+		accountId: typeof account === "string" ? account : rest.accountId
+	};
+}
+function validateMessageNumericOptions(opts) {
+	for (const [key, flag] of STRICT_POSITIVE_INTEGER_OPTIONS) {
+		if (opts[key] === void 0) continue;
+		if (parseStrictPositiveInteger(opts[key]) === void 0) throw new Error(`${flag} must be a positive integer.`);
+	}
+	for (const [key, flag] of STRICT_NON_NEGATIVE_INTEGER_OPTIONS) {
+		if (opts[key] === void 0) continue;
+		if (parseStrictNonNegativeInteger(opts[key]) === void 0) throw new Error(`${flag} must be a non-negative integer.`);
+	}
+}
+async function runPluginStopHooks() {
+	let timeout = null;
+	const hookRun = runGlobalGatewayStopSafely({
+		event: { reason: "cli message action complete" },
+		ctx: {},
+		onError: (err) => defaultRuntime.error(danger(`gateway_stop hook failed: ${String(err)}`))
+	});
+	const bounded = new Promise((resolve) => {
+		timeout = setTimeout(() => resolve("timeout"), GATEWAY_STOP_TIMEOUT_MS);
+		timeout.unref?.();
+	});
+	const result = await Promise.race([hookRun.then(() => "done"), bounded]);
+	if (timeout) clearTimeout(timeout);
+	if (result === "timeout") defaultRuntime.error(danger(`gateway_stop hook exceeded ${GATEWAY_STOP_TIMEOUT_MS}ms; continuing`));
+}
+function resolveScopedMessageChannel(opts) {
+	return resolveMessageSecretScope({
+		channel: opts.channel,
+		target: opts.target,
+		targets: opts.targets
+	}).channel;
+}
+function asChannelMessageActionName(action) {
+	return CHANNEL_MESSAGE_ACTION_NAME_SET.has(action) ? action : void 0;
+}
+function isGatewayOwnedMessageAction(action, scopedChannel) {
+	const messageAction = asChannelMessageActionName(action);
+	if (!messageAction || !scopedChannel) return false;
+	return getChannelPlugin(scopedChannel)?.actions?.resolveExecutionMode?.({ action: messageAction }) === "gateway";
+}
+function resolveMessagePluginPreloadPlan(action, opts) {
+	const scopedChannel = resolveScopedMessageChannel(opts);
+	const loadOptions = scopedChannel ? {
+		scope: "configured-channels",
+		onlyChannelIds: [scopedChannel]
+	} : { scope: "configured-channels" };
+	if (opts.dryRun === true || ACTIONS_REQUIRING_CONFIGURED_CHANNEL_PRELOAD.has(action) || !isGatewayOwnedMessageAction(action, scopedChannel)) return {
+		preload: true,
+		loadOptions
+	};
+	return { preload: false };
+}
+function createMessageCliHelpers(message, messageChannelOptions) {
+	const withMessageBase = (command) => command.option("--channel <channel>", `Channel: ${messageChannelOptions}`).option("--account <id>", "Channel account id (accountId)").option("--json", "Output result as JSON", false).option("--dry-run", "Print payload and skip sending", false).option("--verbose", "Verbose logging", false);
+	const withMessageTarget = (command) => command.option("-t, --target <dest>", CHANNEL_TARGET_DESCRIPTION);
+	const withRequiredMessageTarget = (command) => command.requiredOption("-t, --target <dest>", CHANNEL_TARGET_DESCRIPTION);
+	const runMessageAction = async (action, opts) => {
+		setVerbose(Boolean(opts.verbose));
+		let failed = false;
+		await runCommandWithRuntime(defaultRuntime, async () => {
+			validateMessageNumericOptions(opts);
+			const preloadPlan = resolveMessagePluginPreloadPlan(action, opts);
+			if (preloadPlan.preload) ensurePluginRegistryLoaded(preloadPlan.loadOptions);
+			const deps = createDefaultDeps();
+			await messageCommand({
+				...normalizeMessageOptions(opts),
+				action
+			}, deps, defaultRuntime);
+		}, (err) => {
+			failed = true;
+			defaultRuntime.error(danger(String(err)));
+		});
+		if (!ACTIONS_WITHOUT_STOP_HOOKS.has(action)) await runPluginStopHooks();
+		defaultRuntime.exit(failed ? 1 : 0);
+	};
+	return {
+		withMessageBase,
+		withMessageTarget,
+		withRequiredMessageTarget,
+		runMessageAction
+	};
+}
+//#endregion
+//#region src/cli/program/message/register.broadcast.ts
+function registerMessageBroadcastCommand(message, helpers) {
+	helpers.withMessageBase(message.command("broadcast").description("Broadcast a message to multiple targets")).requiredOption("--targets <target...>", CHANNEL_TARGETS_DESCRIPTION).option("--message <text>", "Message to send").option("--media <url>", "Media URL").action(async (options) => {
+		await helpers.runMessageAction("broadcast", options);
+	});
+}
+//#endregion
+//#region src/cli/program/message/register.discord-admin.ts
+function registerMessageDiscordAdminCommands(message, helpers) {
+	const role = message.command("role").description("Role actions");
+	helpers.withMessageBase(role.command("info").description("List roles").requiredOption("--guild-id <id>", "Guild id")).action(async (opts) => {
+		await helpers.runMessageAction("role-info", opts);
+	});
+	helpers.withMessageBase(role.command("add").description("Add role to a member").requiredOption("--guild-id <id>", "Guild id").requiredOption("--user-id <id>", "User id").requiredOption("--role-id <id>", "Role id")).action(async (opts) => {
+		await helpers.runMessageAction("role-add", opts);
+	});
+	helpers.withMessageBase(role.command("remove").description("Remove role from a member").requiredOption("--guild-id <id>", "Guild id").requiredOption("--user-id <id>", "User id").requiredOption("--role-id <id>", "Role id")).action(async (opts) => {
+		await helpers.runMessageAction("role-remove", opts);
+	});
+	const channel = message.command("channel").description("Channel actions");
+	helpers.withMessageBase(helpers.withRequiredMessageTarget(channel.command("info").description("Fetch channel info"))).action(async (opts) => {
+		await helpers.runMessageAction("channel-info", opts);
+	});
+	helpers.withMessageBase(channel.command("list").description("List channels").requiredOption("--guild-id <id>", "Guild id")).action(async (opts) => {
+		await helpers.runMessageAction("channel-list", opts);
+	});
+	const member = message.command("member").description("Member actions");
+	helpers.withMessageBase(member.command("info").description("Fetch member info").requiredOption("--user-id <id>", "User id")).option("--guild-id <id>", "Guild id (Discord)").action(async (opts) => {
+		await helpers.runMessageAction("member-info", opts);
+	});
+	const voice = message.command("voice").description("Voice actions");
+	helpers.withMessageBase(voice.command("status").description("Fetch voice status").requiredOption("--guild-id <id>", "Guild id").requiredOption("--user-id <id>", "User id")).action(async (opts) => {
+		await helpers.runMessageAction("voice-status", opts);
+	});
+	const event = message.command("event").description("Event actions");
+	helpers.withMessageBase(event.command("list").description("List scheduled events").requiredOption("--guild-id <id>", "Guild id")).action(async (opts) => {
+		await helpers.runMessageAction("event-list", opts);
+	});
+	helpers.withMessageBase(event.command("create").description("Create a scheduled event").requiredOption("--guild-id <id>", "Guild id").requiredOption("--event-name <name>", "Event name").requiredOption("--start-time <iso>", "Event start time")).option("--end-time <iso>", "Event end time").option("--desc <text>", "Event description").option("--channel-id <id>", "Channel id").option("--location <text>", "Event location").option("--event-type <stage|external|voice>", "Event type").option("--image <url>", "Cover image URL or local file path").action(async (opts) => {
+		await helpers.runMessageAction("event-create", opts);
+	});
+	helpers.withMessageBase(message.command("timeout").description("Timeout a member").requiredOption("--guild-id <id>", "Guild id").requiredOption("--user-id <id>", "User id")).option("--duration-min <n>", "Timeout duration minutes").option("--until <iso>", "Timeout until").option("--reason <text>", "Moderation reason").action(async (opts) => {
+		await helpers.runMessageAction("timeout", opts);
+	});
+	helpers.withMessageBase(message.command("kick").description("Kick a member").requiredOption("--guild-id <id>", "Guild id").requiredOption("--user-id <id>", "User id")).option("--reason <text>", "Moderation reason").action(async (opts) => {
+		await helpers.runMessageAction("kick", opts);
+	});
+	helpers.withMessageBase(message.command("ban").description("Ban a member").requiredOption("--guild-id <id>", "Guild id").requiredOption("--user-id <id>", "User id")).option("--reason <text>", "Moderation reason").option("--delete-days <n>", "Ban delete message days").action(async (opts) => {
+		await helpers.runMessageAction("ban", opts);
+	});
+}
+//#endregion
+//#region src/cli/program/message/register.emoji-sticker.ts
+function registerMessageEmojiCommands(message, helpers) {
+	const emoji = message.command("emoji").description("Emoji actions");
+	helpers.withMessageBase(emoji.command("list").description("List emojis")).option("--guild-id <id>", "Guild id (Discord)").action(async (opts) => {
+		await helpers.runMessageAction("emoji-list", opts);
+	});
+	helpers.withMessageBase(emoji.command("upload").description("Upload an emoji").requiredOption("--guild-id <id>", "Guild id")).requiredOption("--emoji-name <name>", "Emoji name").requiredOption("--media <path-or-url>", "Emoji media (path or URL)").option("--role-ids <id>", "Role id (repeat)", collectOption, []).action(async (opts) => {
+		await helpers.runMessageAction("emoji-upload", opts);
+	});
+}
+function registerMessageStickerCommands(message, helpers) {
+	const sticker = message.command("sticker").description("Sticker actions");
+	helpers.withMessageBase(helpers.withRequiredMessageTarget(sticker.command("send").description("Send stickers"))).requiredOption("--sticker-id <id>", "Sticker id (repeat)", collectOption).option("-m, --message <text>", "Optional message body").action(async (opts) => {
+		await helpers.runMessageAction("sticker", opts);
+	});
+	helpers.withMessageBase(sticker.command("upload").description("Upload a sticker").requiredOption("--guild-id <id>", "Guild id")).requiredOption("--sticker-name <name>", "Sticker name").requiredOption("--sticker-desc <text>", "Sticker description").requiredOption("--sticker-tags <tags>", "Sticker tags").requiredOption("--media <path-or-url>", "Sticker media (path or URL)").action(async (opts) => {
+		await helpers.runMessageAction("sticker-upload", opts);
+	});
+}
+//#endregion
+//#region src/cli/program/message/register.permissions-search.ts
+function registerMessagePermissionsCommand(message, helpers) {
+	helpers.withMessageBase(helpers.withRequiredMessageTarget(message.command("permissions").description("Fetch channel permissions"))).action(async (opts) => {
+		await helpers.runMessageAction("permissions", opts);
+	});
+}
+function registerMessageSearchCommand(message, helpers) {
+	helpers.withMessageBase(message.command("search").description("Search Discord messages")).requiredOption("--guild-id <id>", "Guild id").requiredOption("--query <text>", "Search query").option("--channel-id <id>", "Channel id").option("--channel-ids <id>", "Channel id (repeat)", collectOption, []).option("--author-id <id>", "Author id").option("--author-ids <id>", "Author id (repeat)", collectOption, []).option("--limit <n>", "Result limit").action(async (opts) => {
+		await helpers.runMessageAction("search", opts);
+	});
+}
+//#endregion
+//#region src/cli/program/message/register.pins.ts
+function registerMessagePinCommands(message, helpers) {
+	helpers.withMessageBase(helpers.withRequiredMessageTarget(message.command("pin").description("Pin a message"))).requiredOption("--message-id <id>", "Message id").action(async (opts) => {
+		await helpers.runMessageAction("pin", opts);
+	}), helpers.withMessageBase(helpers.withRequiredMessageTarget(message.command("unpin").description("Unpin a message"))).requiredOption("--message-id <id>", "Message id (or pinned message resource id for MSTeams)").option("--pinned-message-id <id>", "Pinned message resource id (MSTeams: from pin or list-pins, not the chat message id)").action(async (opts) => {
+		await helpers.runMessageAction("unpin", opts);
+	}), helpers.withMessageBase(helpers.withRequiredMessageTarget(message.command("pins").description("List pinned messages"))).option("--limit <n>", "Result limit").action(async (opts) => {
+		await helpers.runMessageAction("list-pins", opts);
+	});
+}
+//#endregion
+//#region src/cli/program/message/register.poll.ts
+function registerMessagePollCommand(message, helpers) {
+	helpers.withMessageBase(helpers.withRequiredMessageTarget(message.command("poll").description("Send a poll"))).requiredOption("--poll-question <text>", "Poll question").option("--poll-option <choice>", "Poll option (repeat 2-12 times)", collectOption, []).option("--poll-multi", "Allow multiple selections", false).option("--poll-duration-hours <n>", "Poll duration in hours (Discord)").option("--poll-duration-seconds <n>", "Poll duration in seconds (Telegram; 5-600)").option("--poll-anonymous", "Send an anonymous poll (Telegram)", false).option("--poll-public", "Send a non-anonymous poll (Telegram)", false).option("-m, --message <text>", "Optional message body").option("--silent", "Send poll silently without notification (Telegram + Discord where supported)", false).option("--thread-id <id>", "Thread id (Telegram forum topic / Slack thread ts)").action(async (opts) => {
+		await helpers.runMessageAction("poll", opts);
+	});
+}
+//#endregion
+//#region src/cli/program/message/register.reactions.ts
+function registerMessageReactionsCommands(message, helpers) {
+	helpers.withMessageBase(helpers.withRequiredMessageTarget(message.command("react").description("Add or remove a reaction"))).requiredOption("--message-id <id>", "Message id").option("--emoji <emoji>", "Emoji for reactions").option("--remove", "Remove reaction", false).option("--participant <id>", "WhatsApp reaction participant").option("--from-me", "WhatsApp reaction fromMe", false).option("--target-author <id>", "Signal reaction target author (uuid or phone)").option("--target-author-uuid <uuid>", "Signal reaction target author uuid").action(async (opts) => {
+		await helpers.runMessageAction("react", opts);
+	});
+	helpers.withMessageBase(helpers.withRequiredMessageTarget(message.command("reactions").description("List reactions on a message"))).requiredOption("--message-id <id>", "Message id").option("--limit <n>", "Result limit").action(async (opts) => {
+		await helpers.runMessageAction("reactions", opts);
+	});
+}
+//#endregion
+//#region src/cli/program/message/register.read-edit-delete.ts
+function registerMessageReadEditDeleteCommands(message, helpers) {
+	helpers.withMessageBase(helpers.withRequiredMessageTarget(message.command("read").description("Read recent messages"))).option("--limit <n>", "Result limit").option("--message-id <id>", "Read a specific message id").option("--before <id>", "Read/search before id").option("--after <id>", "Read/search after id").option("--around <id>", "Read around id").option("--thread-id <id>", "Thread id (Slack thread timestamp)").option("--include-thread", "Include thread replies (Discord)", false).action(async (opts) => {
+		await helpers.runMessageAction("read", opts);
+	});
+	helpers.withMessageBase(helpers.withRequiredMessageTarget(message.command("edit").description("Edit a message").requiredOption("--message-id <id>", "Message id").requiredOption("-m, --message <text>", "Message body"))).option("--thread-id <id>", "Thread id (Telegram forum thread)").action(async (opts) => {
+		await helpers.runMessageAction("edit", opts);
+	});
+	helpers.withMessageBase(helpers.withRequiredMessageTarget(message.command("delete").description("Delete a message").requiredOption("--message-id <id>", "Message id"))).action(async (opts) => {
+		await helpers.runMessageAction("delete", opts);
+	});
+}
+//#endregion
+//#region src/cli/program/message/register.send.ts
+function registerMessageSendCommand(message, helpers) {
+	helpers.withMessageBase(helpers.withRequiredMessageTarget(message.command("send").description("Send a message").option("-m, --message <text>", "Message body (required unless --media is set)")).option("--media <path-or-url>", "Attach media (image/audio/video/document). Accepts local paths or URLs.").option("--presentation <json>", "Shared presentation payload as JSON (text, context, dividers, buttons, selects)").option("--delivery <json>", "Shared delivery preferences as JSON").option("--pin", "Request that the delivered message be pinned when supported", false).option("--reply-to <id>", "Reply-to message id").option("--thread-id <id>", "Thread id (Telegram forum thread)").option("--gif-playback", "Treat video media as GIF playback (WhatsApp only).", false).option("--force-document", "Send media as document to avoid channel compression (Telegram, WhatsApp). Applies to images, GIFs, and videos.", false).option("--silent", "Send message silently without notification (Telegram + Discord)", false)).action(async (opts) => {
+		await helpers.runMessageAction("send", opts);
+	});
+}
+//#endregion
+//#region src/cli/program/message/register.thread.ts
+function resolveThreadCreateRequest(opts) {
+	const channel = normalizeLowercaseStringOrEmpty(opts.channel);
+	if (channel) {
+		const request = getChannelPlugin(channel)?.actions?.resolveCliActionRequest?.({
+			action: "thread-create",
+			args: opts
+		});
+		if (request) return {
+			action: request.action,
+			params: request.args
+		};
+	}
+	return {
+		action: "thread-create",
+		params: opts
+	};
+}
+function registerMessageThreadCommands(message, helpers) {
+	const thread = message.command("thread").description("Thread actions");
+	helpers.withMessageBase(helpers.withRequiredMessageTarget(thread.command("create").description("Create a thread").requiredOption("--thread-name <name>", "Thread name"))).option("--message-id <id>", "Message id (optional)").option("-m, --message <text>", "Initial thread message text").option("--auto-archive-min <n>", "Thread auto-archive minutes").action(async (opts) => {
+		const request = resolveThreadCreateRequest(opts);
+		await helpers.runMessageAction(request.action, request.params);
+	});
+	helpers.withMessageBase(thread.command("list").description("List threads").requiredOption("--guild-id <id>", "Guild id")).option("--channel-id <id>", "Channel id").option("--include-archived", "Include archived threads", false).option("--before <id>", "Read/search before id").option("--limit <n>", "Result limit").action(async (opts) => {
+		await helpers.runMessageAction("thread-list", opts);
+	});
+	helpers.withMessageBase(helpers.withRequiredMessageTarget(thread.command("reply").description("Reply in a thread").requiredOption("-m, --message <text>", "Message body"))).option("--media <path-or-url>", "Attach media (image/audio/video/document). Accepts local paths or URLs.").option("--reply-to <id>", "Reply-to message id").action(async (opts) => {
+		await helpers.runMessageAction("thread-reply", opts);
+	});
+}
+//#endregion
+//#region src/cli/program/register.message.ts
+function registerMessageCommands(program, ctx) {
+	const message = program.command("message").description("Send, read, and manage messages and channel actions").addHelpText("after", () => `
+${theme.heading("Examples:")}
+${formatHelpExamples([
+		["fengming message send --target +15555550123 --message \"Hi\"", "Send a text message."],
+		["fengming message send --target +15555550123 --message \"Hi\" --media photo.jpg", "Send a message with media."],
+		["fengming message poll --channel discord --target channel:123 --poll-question \"Snack?\" --poll-option Pizza --poll-option Sushi", "Create a Discord poll."],
+		["fengming message react --channel discord --target 123 --message-id 456 --emoji \"✅\"", "React to a message."]
+	])}
+
+${theme.muted("Docs:")} ${formatDocsLink("/cli/message", "docs.fengming.ai/cli/message")}`).action(() => {
+		message.help({ error: true });
+	});
+	const helpers = createMessageCliHelpers(message, ctx.messageChannelOptions);
+	registerMessageSendCommand(message, helpers);
+	registerMessageBroadcastCommand(message, helpers);
+	registerMessagePollCommand(message, helpers);
+	registerMessageReactionsCommands(message, helpers);
+	registerMessageReadEditDeleteCommands(message, helpers);
+	registerMessagePinCommands(message, helpers);
+	registerMessagePermissionsCommand(message, helpers);
+	registerMessageSearchCommand(message, helpers);
+	registerMessageThreadCommands(message, helpers);
+	registerMessageEmojiCommands(message, helpers);
+	registerMessageStickerCommands(message, helpers);
+	registerMessageDiscordAdminCommands(message, helpers);
+}
+//#endregion
+export { registerMessageCommands };

package/dist/register.migrate-CieoN8zZ.js

@@ -0,0 +1,106 @@
+import { r as theme } from "./theme-CLQ2HbnQ.js";
+import { n as defaultRuntime } from "./runtime-BkTkFkXs.js";
+import { n as runCommandWithRuntime } from "./cli-utils-JYDDzCMN.js";
+import { t as formatHelpExamples } from "./help-format-CBGqVsX5.js";
+import { i as migratePlanCommand, n as migrateDefaultCommand, r as migrateListCommand, t as migrateApplyCommand } from "./migrate-BGuQC-1W.js";
+//#region src/cli/program/register.migrate.ts
+function collectMigrationSkill(value, previous) {
+	return [...previous ?? [], value];
+}
+function collectMigrationPlugin(value, previous) {
+	return [...previous ?? [], value];
+}
+function readMigrationSkills(value) {
+	if (!Array.isArray(value)) return;
+	const skills = value.filter((item) => typeof item === "string").map((item) => item.trim()).filter((item) => item.length > 0);
+	return skills.length > 0 ? skills : void 0;
+}
+function readMigrationPlugins(value) {
+	if (!Array.isArray(value)) return;
+	const plugins = value.filter((item) => typeof item === "string").map((item) => item.trim()).filter((item) => item.length > 0);
+	return plugins.length > 0 ? plugins : void 0;
+}
+function addMigrationSkillOption(command) {
+	return command.option("--skill <name>", "Select one skill to migrate by name or item id; repeat for multiple skills", collectMigrationSkill);
+}
+function addMigrationPluginOption(command) {
+	return command.option("--plugin <name>", "Select one Codex plugin to migrate by name or item id; repeat for multiple plugins", collectMigrationPlugin);
+}
+function addVerifyPluginAppsOption(command) {
+	return command.option("--verify-plugin-apps", "Codex only: verify source plugin app accessibility with app/list before planning native plugin activation", false);
+}
+function addMigrationOptions(command) {
+	return addVerifyPluginAppsOption(addMigrationPluginOption(addMigrationSkillOption(command.option("--from <path>", "Source directory to migrate from").option("--include-secrets", "Import supported credentials and secrets").option("--no-auth-credentials", "Skip auth credential migration").option("--overwrite", "Overwrite conflicting target files after item-level backups", false).option("--json", "Output JSON", false))));
+}
+function readVerifyPluginApps(value) {
+	return value === true;
+}
+function registerMigrateCommand(program) {
+	const migrate = addVerifyPluginAppsOption(program.command("migrate").description("Import state from another agent system").argument("[provider]", "Migration provider id, for example hermes").option("--from <path>", "Source directory to migrate from").option("--include-secrets", "Import supported credentials and secrets").option("--no-auth-credentials", "Skip auth credential migration").option("--overwrite", "Overwrite conflicting target files after item-level backups", false).option("--dry-run", "Preview only; do not apply changes", false).option("--yes", "Apply without prompting after preview", false).option("--skill <name>", "Select one skill to migrate by name or item id; repeat for multiple skills", collectMigrationSkill).option("--plugin <name>", "Select one Codex plugin to migrate by name or item id; repeat for multiple plugins", collectMigrationPlugin).option("--backup-output <path>", "Pre-migration backup archive path or directory").option("--no-backup", "Skip the pre-migration FengMing backup").option("--force", "Allow dangerous options such as --no-backup", false).option("--json", "Output JSON", false)).addHelpText("after", () => `\n${theme.heading("Examples:")}\n${formatHelpExamples([
+		["fengming migrate list", "Show available migration providers."],
+		["fengming migrate hermes", "Preview Hermes migration, then prompt before applying."],
+		["fengming migrate hermes --dry-run", "Preview Hermes migration only."],
+		["fengming migrate apply hermes --yes", "Apply Hermes migration non-interactively after writing a verified backup."],
+		["fengming migrate hermes --no-auth-credentials", "Preview and apply Hermes migration while skipping auth credential import."]
+	])}`).action(async (provider, opts) => {
+		await runCommandWithRuntime(defaultRuntime, async () => {
+			await migrateDefaultCommand(defaultRuntime, {
+				provider,
+				source: opts.from,
+				includeSecrets: opts.includeSecrets === true ? true : void 0,
+				authCredentials: opts.authCredentials,
+				overwrite: Boolean(opts.overwrite),
+				skills: readMigrationSkills(opts.skill),
+				plugins: readMigrationPlugins(opts.plugin),
+				verifyPluginApps: readVerifyPluginApps(opts.verifyPluginApps),
+				dryRun: Boolean(opts.dryRun),
+				yes: Boolean(opts.yes),
+				backupOutput: opts.backupOutput,
+				noBackup: opts.backup === false,
+				force: Boolean(opts.force),
+				json: Boolean(opts.json)
+			});
+		});
+	});
+	migrate.command("list").description("List migration providers").option("--json", "Output JSON", false).action(async (opts) => {
+		await runCommandWithRuntime(defaultRuntime, async () => {
+			await migrateListCommand(defaultRuntime, { json: Boolean(opts.json) });
+		});
+	});
+	addMigrationOptions(migrate.command("plan <provider>").description("Preview a migration without changing FengMing state")).action(async (provider, opts) => {
+		await runCommandWithRuntime(defaultRuntime, async () => {
+			await migratePlanCommand(defaultRuntime, {
+				provider,
+				source: opts.from,
+				includeSecrets: opts.includeSecrets === true ? true : void 0,
+				authCredentials: opts.authCredentials,
+				overwrite: Boolean(opts.overwrite),
+				skills: readMigrationSkills(opts.skill),
+				plugins: readMigrationPlugins(opts.plugin),
+				verifyPluginApps: readVerifyPluginApps(opts.verifyPluginApps),
+				json: Boolean(opts.json)
+			});
+		});
+	});
+	addMigrationOptions(migrate.command("apply <provider>").description("Apply a migration after a verified backup")).option("--yes", "Apply without prompting", false).option("--backup-output <path>", "Pre-migration backup archive path or directory").option("--no-backup", "Skip the pre-migration FengMing backup").option("--force", "Allow dangerous options such as --no-backup", false).action(async (provider, opts) => {
+		await runCommandWithRuntime(defaultRuntime, async () => {
+			await migrateApplyCommand(defaultRuntime, {
+				provider,
+				source: opts.from,
+				includeSecrets: opts.includeSecrets === true ? true : void 0,
+				authCredentials: opts.authCredentials,
+				overwrite: Boolean(opts.overwrite),
+				skills: readMigrationSkills(opts.skill),
+				plugins: readMigrationPlugins(opts.plugin),
+				verifyPluginApps: readVerifyPluginApps(opts.verifyPluginApps),
+				yes: Boolean(opts.yes),
+				backupOutput: opts.backupOutput,
+				noBackup: opts.backup === false,
+				force: Boolean(opts.force),
+				json: Boolean(opts.json)
+			});
+		});
+	});
+}
+//#endregion
+export { registerMigrateCommand };

package/dist/register.onboard-BqWDIDKH.js

@@ -0,0 +1,115 @@
+import { t as formatDocsLink } from "./links-CgdQazeA.js";
+import { r as theme } from "./theme-CLQ2HbnQ.js";
+import { t as parsePort } from "./parse-port-CNAxga8y.js";
+import { n as runCommandWithRuntime } from "./cli-utils-JYDDzCMN.js";
+import { a as resolveManifestProviderOnboardAuthFlags } from "./provider-auth-choices-DzwwEY5d.js";
+import { r as formatAuthChoiceChoicesForCli } from "./auth-choice-options-CBPIRIcJ.js";
+import { t as CORE_ONBOARD_AUTH_FLAGS } from "./onboard-core-auth-flags-CINE1eGu.js";
+//#region src/cli/program/register.onboard.ts
+function resolveInstallDaemonFlag(command, opts) {
+	if (!command || typeof command !== "object") return;
+	const getOptionValueSource = "getOptionValueSource" in command ? command.getOptionValueSource : void 0;
+	if (typeof getOptionValueSource !== "function") return;
+	if (getOptionValueSource.call(command, "skipDaemon") === "cli") return false;
+	if (getOptionValueSource.call(command, "installDaemon") === "cli") return Boolean(opts.installDaemon);
+}
+const AUTH_CHOICE_HELP = formatAuthChoiceChoicesForCli({
+	includeLegacyAliases: true,
+	includeSkip: true
+});
+function extractCliFlags(cliOption) {
+	return cliOption.split(/[ ,|]+/).filter((part) => part.startsWith("-")).map((part) => {
+		const equalsIndex = part.indexOf("=");
+		return equalsIndex === -1 ? part : part.slice(0, equalsIndex);
+	});
+}
+function resolveOnboardAuthFlags() {
+	const seenCliFlags = /* @__PURE__ */ new Set();
+	const flags = [];
+	for (const flag of [...CORE_ONBOARD_AUTH_FLAGS, ...resolveManifestProviderOnboardAuthFlags()]) {
+		const cliFlags = extractCliFlags(flag.cliOption);
+		if (cliFlags.some((cliFlag) => seenCliFlags.has(cliFlag))) continue;
+		for (const cliFlag of cliFlags) seenCliFlags.add(cliFlag);
+		flags.push(flag);
+	}
+	return flags;
+}
+const ONBOARD_AUTH_FLAGS = resolveOnboardAuthFlags();
+function pickOnboardProviderAuthOptionValues(opts) {
+	return Object.fromEntries(ONBOARD_AUTH_FLAGS.map((flag) => [flag.optionKey, opts[flag.optionKey]]));
+}
+function registerOnboardCommand(program) {
+	const command = program.command("onboard").description("Guided setup for auth, models, Gateway, workspace, channels, and skills").addHelpText("after", () => `\n${theme.muted("Docs:")} ${formatDocsLink("/cli/onboard", "docs.fengming.ai/cli/onboard")}\n`).option("--workspace <dir>", "Agent workspace directory (default: ~/.fengming/workspace)").option("--reset", "Reset config + credentials + sessions before running onboard (workspace only with --reset-scope full)").option("--reset-scope <scope>", "Reset scope: config|config+creds+sessions|full").option("--non-interactive", "Run without prompts", false).option("--modern", "Use the conversational setup/repair assistant", false).option("--accept-risk", "Acknowledge that agents are powerful and full system access is risky (required for --non-interactive)", false).option("--flow <flow>", "Onboard flow: quickstart|advanced|manual|import").option("--mode <mode>", "Onboard mode: local|remote").option("--auth-choice <choice>", `Auth: ${AUTH_CHOICE_HELP}`).option("--token-provider <id>", "Token provider id (non-interactive; used with --auth-choice token)").option("--token <token>", "Token value (non-interactive; used with --auth-choice token)").option("--token-profile-id <id>", "认证配置 id (non-interactive; default: <provider>:manual)").option("--token-expires-in <duration>", "Optional token expiry duration (e.g. 365d, 12h)").option("--secret-input-mode <mode>", "API key persistence mode: plaintext|ref (default: plaintext)").option("--cloudflare-ai-gateway-account-id <id>", "Cloudflare Account ID").option("--cloudflare-ai-gateway-gateway-id <id>", "Cloudflare AI Gateway ID");
+	for (const providerFlag of ONBOARD_AUTH_FLAGS) command.option(providerFlag.cliOption, providerFlag.description);
+	command.option("--custom-base-url <url>", "Custom provider base URL").option("--custom-api-key <key>", "Custom provider API key (optional)").option("--custom-model-id <id>", "Custom provider model ID").option("--custom-provider-id <id>", "Custom provider ID (optional; auto-derived by default)").option("--custom-compatibility <mode>", "Custom provider API compatibility: openai|anthropic (default: openai)").option("--custom-image-input", "Mark the custom provider model as image-capable").option("--custom-text-input", "Mark the custom provider model as text-only").option("--gateway-port <port>", "Gateway port").option("--gateway-bind <mode>", "Gateway bind: loopback|tailnet|lan|auto|custom").option("--gateway-auth <mode>", "Gateway auth: token|password").option("--gateway-token <token>", "Gateway token (token auth)").option("--gateway-token-ref-env <name>", "Gateway token SecretRef env var name (token auth; e.g. FENGMING_GATEWAY_TOKEN)").option("--gateway-password <password>", "Gateway password (password auth)").option("--remote-url <url>", "Remote Gateway WebSocket URL").option("--remote-token <token>", "Remote Gateway token (optional)").option("--tailscale <mode>", "Tailscale: off|serve|funnel").option("--tailscale-reset-on-exit", "Reset tailscale serve/funnel on exit").option("--install-daemon", "Install gateway service").option("--no-install-daemon", "Skip gateway service install").option("--skip-daemon", "Skip gateway service install").option("--daemon-runtime <runtime>", "Daemon runtime: node|bun").option("--skip-channels", "Skip channel setup").option("--skip-skills", "Skip skills setup").option("--skip-bootstrap", "Skip creating default agent workspace files").option("--skip-search", "Skip search provider setup").option("--skip-health", "Skip health check").option("--skip-ui", "Skip Control UI/TUI prompts").option("--suppress-gateway-token-output", "Suppress token-bearing Gateway/UI output").option("--skip-hooks", "Skip hook setup").option("--node-manager <name>", "Node manager for skills: npm|pnpm|bun").option("--import-from <provider>", "Migration provider to run during onboarding").option("--import-source <path>", "Source agent home for --import-from").option("--import-secrets", "Import supported secrets during onboarding migration", false).option("--json", "Output JSON summary", false);
+	command.action(async (opts, commandRuntime) => {
+		const { defaultRuntime } = await import("./runtime-DMT3sBEl.js");
+		await runCommandWithRuntime(defaultRuntime, async () => {
+			if (opts.modern) {
+				const { runCrestodian } = await import("./crestodian/crestodian.js");
+				await runCrestodian({
+					message: opts.nonInteractive ? "overview" : void 0,
+					yes: false,
+					json: Boolean(opts.json),
+					interactive: !opts.nonInteractive
+				});
+				return;
+			}
+			const installDaemon = resolveInstallDaemonFlag(commandRuntime, { installDaemon: Boolean(opts.installDaemon) });
+			const gatewayPort = parsePort(opts.gatewayPort);
+			const providerAuthOptionValues = pickOnboardProviderAuthOptionValues(opts);
+			const { setupWizardCommand } = await import("./onboard-I5tQlVm6.js");
+			await setupWizardCommand({
+				workspace: opts.workspace,
+				nonInteractive: Boolean(opts.nonInteractive),
+				acceptRisk: Boolean(opts.acceptRisk),
+				flow: opts.flow,
+				mode: opts.mode,
+				authChoice: opts.authChoice,
+				tokenProvider: opts.tokenProvider,
+				token: opts.token,
+				tokenProfileId: opts.tokenProfileId,
+				tokenExpiresIn: opts.tokenExpiresIn,
+				secretInputMode: opts.secretInputMode,
+				...providerAuthOptionValues,
+				cloudflareAiGatewayAccountId: opts.cloudflareAiGatewayAccountId,
+				cloudflareAiGatewayGatewayId: opts.cloudflareAiGatewayGatewayId,
+				customBaseUrl: opts.customBaseUrl,
+				customApiKey: opts.customApiKey,
+				customModelId: opts.customModelId,
+				customProviderId: opts.customProviderId,
+				customCompatibility: opts.customCompatibility,
+				customImageInput: opts.customTextInput === true ? false : opts.customImageInput === true ? true : void 0,
+				gatewayPort: gatewayPort ?? void 0,
+				gatewayBind: opts.gatewayBind,
+				gatewayAuth: opts.gatewayAuth,
+				gatewayToken: opts.gatewayToken,
+				gatewayTokenRefEnv: opts.gatewayTokenRefEnv,
+				gatewayPassword: opts.gatewayPassword,
+				remoteUrl: opts.remoteUrl,
+				remoteToken: opts.remoteToken,
+				tailscale: opts.tailscale,
+				tailscaleResetOnExit: Boolean(opts.tailscaleResetOnExit),
+				reset: Boolean(opts.reset),
+				resetScope: opts.resetScope,
+				installDaemon,
+				daemonRuntime: opts.daemonRuntime,
+				skipChannels: Boolean(opts.skipChannels),
+				skipSkills: Boolean(opts.skipSkills),
+				skipBootstrap: Boolean(opts.skipBootstrap),
+				skipSearch: Boolean(opts.skipSearch),
+				skipHealth: Boolean(opts.skipHealth),
+				skipUi: Boolean(opts.skipUi),
+				suppressGatewayTokenOutput: Boolean(opts.suppressGatewayTokenOutput),
+				skipHooks: Boolean(opts.skipHooks),
+				nodeManager: opts.nodeManager,
+				importFrom: opts.importFrom,
+				importSource: opts.importSource,
+				importSecrets: Boolean(opts.importSecrets),
+				json: Boolean(opts.json)
+			}, defaultRuntime);
+		});
+	});
+}
+//#endregion
+export { registerOnboardCommand };