remoteclaw 0.0.0 → 0.0.1

package/dist/channels-cli-BfPB163m.js

@@ -0,0 +1,1436 @@
+import { Ct as theme, Et as getResolvedLoggerSettings, Y as isRecord, _ as defaultRuntime, _t as setVerbose, dt as danger } from "./entry.js";
+import { i as loadConfig, l as writeConfigFile, o as readConfigFileSnapshot } from "./config-qAZfcdDM.js";
+import "./host-env-security-axRnIi8d.js";
+import "./shell-env-DBS5su07.js";
+import "./version-3QUZW8EP.js";
+import { h as normalizeAccountId, m as DEFAULT_ACCOUNT_ID } from "./session-key-BF-9YzxC.js";
+import "./env-vars-CD2_baIP.js";
+import { d as resolveDefaultAgentId, l as resolveAgentWorkspaceDir } from "./agent-scope-FzE2oRm0.js";
+import "./zod-schema-7uqrpeBz.js";
+import "./dock-BFxpyZEm.js";
+import "./message-channel-tuc9CdEw.js";
+import "./sessions-Dg3febTj.js";
+import { a as resolveTelegramAccount } from "./accounts-B8PGQWQl.js";
+import "./accounts-CIVjmTg9.js";
+import { n as listChannelPlugins, r as normalizeChannelId, t as getChannelPlugin } from "./plugins-Ca4Ybd3t.js";
+import "./accounts-DHkGVGUR.js";
+import "./accounts-XFgBY644.js";
+import "./bindings-6FvW-Ys9.js";
+import { t as formatCliCommand } from "./command-format-BiiNHkWG.js";
+import "./logging-DRwtiLIS.js";
+import { t as parseDiscordTarget } from "./targets-D8Rv_6CT.js";
+import { _ as deleteTelegramUpdateOffset } from "./loader-BLMpE4uG.js";
+import "./chat-envelope-AJFUAuBM.js";
+import "./strip-inbound-meta-zmUXypSS.js";
+import "./client-CBpe99dr.js";
+import { n as callGateway } from "./call-Wjjo7gwP.js";
+import "./net-DSkFMHJ8.js";
+import "./logger-CPvz-aPM.js";
+import "./ip-MwCwRA7c.js";
+import "./tailnet-xt92Yaop.js";
+import "./lanes-1CBKdsiR.js";
+import "./subagent-registry-BCGOdOC-.js";
+import "./response-prefix-template-xsasdq1T.js";
+import "./agent-helpers-Bs2nBXeI.js";
+import "./tool-images-BWhy6WRN.js";
+import "./exec-epNpA1aU.js";
+import "./image-ops-CX41n0v5.js";
+import "./tokens-Dw7ZdYwT.js";
+import { $ as formatUsageReportLines, Q as loadProviderUsageSummary } from "./reply-DEPE5T_9.js";
+import "./hook-runner-global-nAi_RVmo.js";
+import "./redact-BW8tobyp.js";
+import "./tool-display-Bxs_1jIn.js";
+import "./markdown-tables-C48ANSSq.js";
+import "./chunk-BAMyFYtF.js";
+import "./media-DcDCPyuW.js";
+import "./render-BhKzKdV0.js";
+import "./tables-BFyFqtLB.js";
+import "./outbound-B3wlEY-e.js";
+import "./fs-safe-BjSd07M4.js";
+import "./mime-ViuhRuMM.js";
+import "./ssrf-CJIdPXuS.js";
+import "./fetch-Cky99wYB.js";
+import "./common-D4fL3S2m.js";
+import { u as loadAuthProfileStore } from "./auth-C1zx1O24.js";
+import "./file-lock-DXW9h9ek.js";
+import "./commands-keXWOHRq.js";
+import "./commands-registry-Cz77bvxB.js";
+import "./provider-auth-j-EQvvIk.js";
+import "./audio-DqlIYYTb.js";
+import "./targets-felDvoku.js";
+import "./pairing-store-CU4_h9xa.js";
+import "./fetch-DTsU2XnC.js";
+import "./retry-BWv_fy4u.js";
+import { t as createSlackWebClient } from "./client-D-R1YdRD.js";
+import { n as formatTimeAgo } from "./format-relative-Czf5fUjn.js";
+import "./errors-0dfGxeYQ.js";
+import "./channel-activity-BhT7NQ_v.js";
+import { Q as fetchChannelPermissionsDiscord } from "./send-DLLYgtkJ.js";
+import "./session-cost-usage-C-DsaOfN.js";
+import "./reply-directives-Bbyf2UON.js";
+import "./provider-dispatcher-DX896bb6.js";
+import "./store-CzhBjUCN.js";
+import "./reply-prefix-D7E0w0O2.js";
+import "./channel-web-DBCMnF6w.js";
+import "./ack-reactions-BapxA9fC.js";
+import "./session-C6VKWvx6.js";
+import "./resolve-route-BBOsg5KI.js";
+import "./login-B5TdMKIC.js";
+import { t as formatDocsLink } from "./links-CwTlzaPe.js";
+import { t as hasExplicitOptions } from "./command-options-D2nN4AXX.js";
+import { n as withProgress } from "./progress-DRLmcFiG.js";
+import { t as runCommandWithRuntime } from "./cli-utils-BUOtyfnU.js";
+import { t as formatHelpExamples } from "./help-format-CJQ7APRn.js";
+import { r as listChannelPluginCatalogEntries } from "./catalog-CU0Xn2G1.js";
+import "./preflight-Bq8rimP-.js";
+import { t as validateVoiceCredentials } from "./voice-credentials-DXU-y9z7.js";
+import "./prompt-style-CUuA6OCy.js";
+import "./note-D-EI0czq.js";
+import { t as createClackPrompter } from "./clack-prompter-DKcYqv3o.js";
+import { t as resolveChannelDefaultAccountId } from "./helpers-ndPQWl6m.js";
+import "./plugin-auto-enable-fc5IL3zs.js";
+import "./enable-C3I9dWel.js";
+import "./npm-registry-spec-PPyRXSpx.js";
+import "./installs-BmtDxAA-.js";
+import "./send-B5iWtbNX.js";
+import "./send-BuKAbt8a.js";
+import "./send-DO4RP5yz.js";
+import "./proxy-D-qGA1vm.js";
+import "./replies-nkw9sahT.js";
+import "./agent-HReIYVG-.js";
+import { n as resolveMessageChannelSelection } from "./channel-selection-DHUO7WUa.js";
+import "./deliver-D49hWPWI.js";
+import "./outbound-attachment-BZkefkAT.js";
+import "./delivery-queue-BDvalA10.js";
+import "./send-DpaTnM-a.js";
+import "./onboard-helpers-DdqoC3w8.js";
+import "./pairing-labels-Ks4ey7DT.js";
+import { a as reloadOnboardingPluginRegistry, i as ensureOnboardingPluginInstalled, r as setupChannels } from "./onboard-channels-8SAR1gMS.js";
+import { t as requireValidConfigSnapshot } from "./config-validation-DSXKFJHF.js";
+import { t as buildChannelAccountSnapshot } from "./status-BtRY0nXQ.js";
+import { t as parseLogLine } from "./parse-log-line-GisaZn5H.js";
+import { t as collectChannelStatusIssues } from "./channels-status-issues-BMadvA0-.js";
+import "./plugin-registry-nbb06LsB.js";
+import { t as formatCliChannelOptions } from "./channel-options-B1tMfA9G.js";
+import fsp from "node:fs/promises";
+
+//#region src/commands/channels/add-mutators.ts
+function applyAccountName(params) {
+	const accountId = normalizeAccountId(params.accountId);
+	const apply = getChannelPlugin(params.channel)?.setup?.applyAccountName;
+	return apply ? apply({
+		cfg: params.cfg,
+		accountId,
+		name: params.name
+	}) : params.cfg;
+}
+function applyChannelAccountConfig(params) {
+	const accountId = normalizeAccountId(params.accountId);
+	const apply = getChannelPlugin(params.channel)?.setup?.applyAccountConfig;
+	if (!apply) return params.cfg;
+	return apply({
+		cfg: params.cfg,
+		accountId,
+		input: params.input
+	});
+}
+
+//#endregion
+//#region src/commands/channels/shared.ts
+async function requireValidConfig(runtime = defaultRuntime) {
+	return await requireValidConfigSnapshot(runtime);
+}
+function formatAccountLabel(params) {
+	const base = params.accountId || DEFAULT_ACCOUNT_ID;
+	if (params.name?.trim()) return `${base} (${params.name.trim()})`;
+	return base;
+}
+const channelLabel = (channel) => {
+	return getChannelPlugin(channel)?.meta.label ?? channel;
+};
+function formatChannelAccountLabel(params) {
+	const channelText = channelLabel(params.channel);
+	const accountText = formatAccountLabel({
+		accountId: params.accountId,
+		name: params.name
+	});
+	return `${params.channelStyle ? params.channelStyle(channelText) : channelText} ${params.accountStyle ? params.accountStyle(accountText) : accountText}`;
+}
+function shouldUseWizard(params) {
+	return params?.hasFlags === false;
+}
+
+//#endregion
+//#region src/commands/channels/add.ts
+function parseList(value) {
+	if (!value?.trim()) return;
+	const parsed = value.split(/[\n,;]+/g).map((entry) => entry.trim()).filter(Boolean);
+	return parsed.length > 0 ? parsed : void 0;
+}
+function resolveCatalogChannelEntry(raw, cfg) {
+	const trimmed = raw.trim().toLowerCase();
+	if (!trimmed) return;
+	return listChannelPluginCatalogEntries({ workspaceDir: cfg ? resolveAgentWorkspaceDir(cfg, resolveDefaultAgentId(cfg)) : void 0 }).find((entry) => {
+		if (entry.id.toLowerCase() === trimmed) return true;
+		return (entry.meta.aliases ?? []).some((alias) => alias.trim().toLowerCase() === trimmed);
+	});
+}
+async function channelsAddCommand(opts, runtime = defaultRuntime, params) {
+	const cfg = await requireValidConfig(runtime);
+	if (!cfg) return;
+	let nextConfig = cfg;
+	if (shouldUseWizard(params)) {
+		const prompter = createClackPrompter();
+		let selection = [];
+		const accountIds = {};
+		await prompter.intro("Channel setup");
+		let nextConfig = await setupChannels(cfg, runtime, prompter, {
+			allowDisable: false,
+			allowSignalInstall: true,
+			promptAccountIds: true,
+			onSelection: (value) => {
+				selection = value;
+			},
+			onAccountId: (channel, accountId) => {
+				accountIds[channel] = accountId;
+			}
+		});
+		if (selection.length === 0) {
+			await prompter.outro("No channels selected.");
+			return;
+		}
+		if (await prompter.confirm({
+			message: "Add display names for these accounts? (optional)",
+			initialValue: false
+		})) for (const channel of selection) {
+			const accountId = accountIds[channel] ?? DEFAULT_ACCOUNT_ID;
+			const plugin = getChannelPlugin(channel);
+			const account = plugin?.config.resolveAccount(nextConfig, accountId);
+			const existingName = (plugin?.config.describeAccount?.(account, nextConfig))?.name ?? account?.name;
+			const name = await prompter.text({
+				message: `${channel} account name (${accountId})`,
+				initialValue: existingName
+			});
+			if (name?.trim()) nextConfig = applyAccountName({
+				cfg: nextConfig,
+				channel,
+				accountId,
+				name
+			});
+		}
+		await writeConfigFile(nextConfig);
+		await prompter.outro("Channels updated.");
+		return;
+	}
+	const rawChannel = String(opts.channel ?? "");
+	let channel = normalizeChannelId(rawChannel);
+	let catalogEntry = channel ? void 0 : resolveCatalogChannelEntry(rawChannel, nextConfig);
+	if (!channel && catalogEntry) {
+		const prompter = createClackPrompter();
+		const workspaceDir = resolveAgentWorkspaceDir(nextConfig, resolveDefaultAgentId(nextConfig));
+		const result = await ensureOnboardingPluginInstalled({
+			cfg: nextConfig,
+			entry: catalogEntry,
+			prompter,
+			runtime,
+			workspaceDir
+		});
+		nextConfig = result.cfg;
+		if (!result.installed) return;
+		reloadOnboardingPluginRegistry({
+			cfg: nextConfig,
+			runtime,
+			workspaceDir
+		});
+		channel = normalizeChannelId(catalogEntry.id) ?? catalogEntry.id;
+	}
+	if (!channel) {
+		const hint = catalogEntry ? `Plugin ${catalogEntry.meta.label} could not be loaded after install.` : `Unknown channel: ${String(opts.channel ?? "")}`;
+		runtime.error(hint);
+		runtime.exit(1);
+		return;
+	}
+	const plugin = getChannelPlugin(channel);
+	if (!plugin?.setup?.applyAccountConfig) {
+		runtime.error(`Channel ${channel} does not support add.`);
+		runtime.exit(1);
+		return;
+	}
+	const accountId = plugin.setup.resolveAccountId?.({
+		cfg: nextConfig,
+		accountId: opts.account
+	}) ?? normalizeAccountId(opts.account);
+	const useEnv = opts.useEnv === true;
+	const initialSyncLimit = typeof opts.initialSyncLimit === "number" ? opts.initialSyncLimit : typeof opts.initialSyncLimit === "string" && opts.initialSyncLimit.trim() ? Number.parseInt(opts.initialSyncLimit, 10) : void 0;
+	const groupChannels = parseList(opts.groupChannels);
+	const dmAllowlist = parseList(opts.dmAllowlist);
+	const input = {
+		name: opts.name,
+		token: opts.token,
+		tokenFile: opts.tokenFile,
+		botToken: opts.botToken,
+		appToken: opts.appToken,
+		signalNumber: opts.signalNumber,
+		cliPath: opts.cliPath,
+		dbPath: opts.dbPath,
+		service: opts.service,
+		region: opts.region,
+		authDir: opts.authDir,
+		httpUrl: opts.httpUrl,
+		httpHost: opts.httpHost,
+		httpPort: opts.httpPort,
+		webhookPath: opts.webhookPath,
+		webhookUrl: opts.webhookUrl,
+		audienceType: opts.audienceType,
+		audience: opts.audience,
+		homeserver: opts.homeserver,
+		userId: opts.userId,
+		accessToken: opts.accessToken,
+		password: opts.password,
+		deviceName: opts.deviceName,
+		initialSyncLimit,
+		useEnv,
+		ship: opts.ship,
+		url: opts.url,
+		code: opts.code,
+		groupChannels,
+		dmAllowlist,
+		autoDiscoverChannels: opts.autoDiscoverChannels
+	};
+	const validationError = plugin.setup.validateInput?.({
+		cfg: nextConfig,
+		accountId,
+		input
+	});
+	if (validationError) {
+		runtime.error(validationError);
+		runtime.exit(1);
+		return;
+	}
+	const previousTelegramToken = channel === "telegram" ? resolveTelegramAccount({
+		cfg: nextConfig,
+		accountId
+	}).token.trim() : "";
+	nextConfig = applyChannelAccountConfig({
+		cfg: nextConfig,
+		channel,
+		accountId,
+		input
+	});
+	if (channel === "telegram") {
+		if (previousTelegramToken !== resolveTelegramAccount({
+			cfg: nextConfig,
+			accountId
+		}).token.trim()) await deleteTelegramUpdateOffset({ accountId });
+	}
+	await writeConfigFile(nextConfig);
+	runtime.log(`Added ${channelLabel(channel)} account "${accountId}".`);
+	if (getChannelPlugin(channel)?.capabilities.voiceOnly) {
+		const report = await validateVoiceCredentials(nextConfig);
+		const warnings = [];
+		if (!report.stt.available) warnings.push("Warning: no STT credentials found. Voice channels require a speech-to-text provider.");
+		if (!report.tts.available) warnings.push("Warning: no TTS credentials found. Voice channels require a text-to-speech provider.");
+		for (const warning of warnings) runtime.log(warning);
+	}
+}
+
+//#endregion
+//#region src/slack/scopes.ts
+function collectScopes(value, into) {
+	if (!value) return;
+	if (Array.isArray(value)) {
+		for (const entry of value) if (typeof entry === "string" && entry.trim()) into.push(entry.trim());
+		return;
+	}
+	if (typeof value === "string") {
+		const raw = value.trim();
+		if (!raw) return;
+		const parts = raw.split(/[,\s]+/).map((part) => part.trim());
+		for (const part of parts) if (part) into.push(part);
+		return;
+	}
+	if (!isRecord(value)) return;
+	for (const entry of Object.values(value)) if (Array.isArray(entry) || typeof entry === "string") collectScopes(entry, into);
+}
+function normalizeScopes(scopes) {
+	return Array.from(new Set(scopes.map((scope) => scope.trim()).filter(Boolean))).toSorted();
+}
+function extractScopes(payload) {
+	if (!isRecord(payload)) return [];
+	const scopes = [];
+	collectScopes(payload.scopes, scopes);
+	collectScopes(payload.scope, scopes);
+	if (isRecord(payload.info)) {
+		collectScopes(payload.info.scopes, scopes);
+		collectScopes(payload.info.scope, scopes);
+		collectScopes(payload.info.user_scopes, scopes);
+		collectScopes(payload.info.bot_scopes, scopes);
+	}
+	return normalizeScopes(scopes);
+}
+function readError(payload) {
+	if (!isRecord(payload)) return;
+	const error = payload.error;
+	return typeof error === "string" && error.trim() ? error.trim() : void 0;
+}
+async function callSlack(client, method) {
+	try {
+		const result = await client.apiCall(method);
+		return isRecord(result) ? result : null;
+	} catch (err) {
+		return {
+			ok: false,
+			error: err instanceof Error ? err.message : String(err)
+		};
+	}
+}
+async function fetchSlackScopes(token, timeoutMs) {
+	const client = createSlackWebClient(token, { timeout: timeoutMs });
+	const attempts = ["auth.scopes", "apps.permissions.info"];
+	const errors = [];
+	for (const method of attempts) {
+		const result = await callSlack(client, method);
+		const scopes = extractScopes(result);
+		if (scopes.length > 0) return {
+			ok: true,
+			scopes,
+			source: method
+		};
+		const error = readError(result);
+		if (error) errors.push(`${method}: ${error}`);
+	}
+	return {
+		ok: false,
+		error: errors.length > 0 ? errors.join(" | ") : "no scopes returned"
+	};
+}
+
+//#endregion
+//#region src/commands/channels/capabilities.ts
+const REQUIRED_DISCORD_PERMISSIONS = ["ViewChannel", "SendMessages"];
+const TEAMS_GRAPH_PERMISSION_HINTS = {
+	"ChannelMessage.Read.All": "channel history",
+	"Chat.Read.All": "chat history",
+	"Channel.ReadBasic.All": "channel list",
+	"Team.ReadBasic.All": "team list",
+	"TeamsActivity.Read.All": "teams activity",
+	"Sites.Read.All": "files (SharePoint)",
+	"Files.Read.All": "files (OneDrive)"
+};
+function normalizeTimeout(raw, fallback = 1e4) {
+	const value = typeof raw === "string" ? Number(raw) : Number(raw);
+	if (!Number.isFinite(value) || value <= 0) return fallback;
+	return value;
+}
+function formatSupport(capabilities) {
+	if (!capabilities) return "unknown";
+	const bits = [];
+	if (capabilities.chatTypes?.length) bits.push(`chatTypes=${capabilities.chatTypes.join(",")}`);
+	if (capabilities.voiceOnly) bits.push("voiceOnly");
+	if (capabilities.polls) bits.push("polls");
+	if (capabilities.reactions) bits.push("reactions");
+	if (capabilities.edit) bits.push("edit");
+	if (capabilities.unsend) bits.push("unsend");
+	if (capabilities.reply) bits.push("reply");
+	if (capabilities.effects) bits.push("effects");
+	if (capabilities.groupManagement) bits.push("groupManagement");
+	if (capabilities.threads) bits.push("threads");
+	if (capabilities.media) bits.push("media");
+	if (capabilities.nativeCommands) bits.push("nativeCommands");
+	if (capabilities.blockStreaming) bits.push("blockStreaming");
+	return bits.length ? bits.join(" ") : "none";
+}
+function summarizeDiscordTarget(raw) {
+	if (!raw) return;
+	const target = parseDiscordTarget(raw, { defaultKind: "channel" });
+	if (!target) return { raw };
+	if (target.kind === "channel") return {
+		raw,
+		normalized: target.normalized,
+		kind: "channel",
+		channelId: target.id
+	};
+	if (target.kind === "user") return {
+		raw,
+		normalized: target.normalized,
+		kind: "user"
+	};
+	return {
+		raw,
+		normalized: target.normalized
+	};
+}
+function formatDiscordIntents(intents) {
+	if (!intents) return "unknown";
+	return [
+		`messageContent=${intents.messageContent ?? "unknown"}`,
+		`guildMembers=${intents.guildMembers ?? "unknown"}`,
+		`presence=${intents.presence ?? "unknown"}`
+	].join(" ");
+}
+function formatProbeLines(channelId, probe) {
+	const lines = [];
+	if (!probe || typeof probe !== "object") return lines;
+	const probeObj = probe;
+	if (channelId === "discord") {
+		const bot = probeObj.bot;
+		if (bot?.username) {
+			const botId = bot.id ? ` (${bot.id})` : "";
+			lines.push(`Bot: ${theme.accent(`@${bot.username}`)}${botId}`);
+		}
+		const app = probeObj.application;
+		if (app?.intents) lines.push(`Intents: ${formatDiscordIntents(app.intents)}`);
+	}
+	if (channelId === "telegram") {
+		const bot = probeObj.bot;
+		if (bot?.username) {
+			const botId = bot.id ? ` (${bot.id})` : "";
+			lines.push(`Bot: ${theme.accent(`@${bot.username}`)}${botId}`);
+		}
+		const flags = [];
+		const canJoinGroups = bot?.canJoinGroups;
+		const canReadAll = bot?.canReadAllGroupMessages;
+		const inlineQueries = bot?.supportsInlineQueries;
+		if (typeof canJoinGroups === "boolean") flags.push(`joinGroups=${canJoinGroups}`);
+		if (typeof canReadAll === "boolean") flags.push(`readAllGroupMessages=${canReadAll}`);
+		if (typeof inlineQueries === "boolean") flags.push(`inlineQueries=${inlineQueries}`);
+		if (flags.length > 0) lines.push(`Flags: ${flags.join(" ")}`);
+		const webhook = probeObj.webhook;
+		if (webhook?.url !== void 0) lines.push(`Webhook: ${webhook.url || "none"}`);
+	}
+	if (channelId === "slack") {
+		const bot = probeObj.bot;
+		const team = probeObj.team;
+		if (bot?.name) lines.push(`Bot: ${theme.accent(`@${bot.name}`)}`);
+		if (team?.name || team?.id) {
+			const id = team?.id ? ` (${team.id})` : "";
+			lines.push(`Team: ${team?.name ?? "unknown"}${id}`);
+		}
+	}
+	if (channelId === "signal") {
+		const version = probeObj.version;
+		if (version) lines.push(`Signal daemon: ${version}`);
+	}
+	if (channelId === "msteams") {
+		const appId = typeof probeObj.appId === "string" ? probeObj.appId.trim() : "";
+		if (appId) lines.push(`App: ${theme.accent(appId)}`);
+		const graph = probeObj.graph;
+		if (graph) {
+			const roles = Array.isArray(graph.roles) ? graph.roles.map((role) => String(role).trim()).filter(Boolean) : [];
+			const scopes = typeof graph.scopes === "string" ? graph.scopes.split(/\s+/).map((scope) => scope.trim()).filter(Boolean) : Array.isArray(graph.scopes) ? graph.scopes.map((scope) => String(scope).trim()).filter(Boolean) : [];
+			if (graph.ok === false) lines.push(`Graph: ${theme.error(graph.error ?? "failed")}`);
+			else if (roles.length > 0 || scopes.length > 0) {
+				const formatPermission = (permission) => {
+					const hint = TEAMS_GRAPH_PERMISSION_HINTS[permission];
+					return hint ? `${permission} (${hint})` : permission;
+				};
+				if (roles.length > 0) lines.push(`Graph roles: ${roles.map(formatPermission).join(", ")}`);
+				if (scopes.length > 0) lines.push(`Graph scopes: ${scopes.map(formatPermission).join(", ")}`);
+			} else if (graph.ok === true) lines.push("Graph: ok");
+		}
+	}
+	const ok = typeof probeObj.ok === "boolean" ? probeObj.ok : void 0;
+	if (ok === true && lines.length === 0) lines.push("Probe: ok");
+	if (ok === false) {
+		const error = typeof probeObj.error === "string" && probeObj.error ? ` (${probeObj.error})` : "";
+		lines.push(`Probe: ${theme.error(`failed${error}`)}`);
+	}
+	return lines;
+}
+async function buildDiscordPermissions(params) {
+	const target = summarizeDiscordTarget(params.target?.trim());
+	if (!target) return {};
+	if (target.kind !== "channel" || !target.channelId) return {
+		target,
+		report: { error: "Target looks like a DM user; pass channel:<id> to audit channel permissions." }
+	};
+	const token = params.account.token?.trim();
+	if (!token) return {
+		target,
+		report: {
+			channelId: target.channelId,
+			error: "Discord bot token missing for permission audit."
+		}
+	};
+	try {
+		const perms = await fetchChannelPermissionsDiscord(target.channelId, {
+			token,
+			accountId: params.account.accountId ?? void 0
+		});
+		const missing = REQUIRED_DISCORD_PERMISSIONS.filter((permission) => !perms.permissions.includes(permission));
+		return {
+			target,
+			report: {
+				channelId: perms.channelId,
+				guildId: perms.guildId,
+				isDm: perms.isDm,
+				channelType: perms.channelType,
+				permissions: perms.permissions,
+				missingRequired: missing.length ? missing : [],
+				raw: perms.raw
+			}
+		};
+	} catch (err) {
+		return {
+			target,
+			report: {
+				channelId: target.channelId,
+				error: err instanceof Error ? err.message : String(err)
+			}
+		};
+	}
+}
+async function resolveChannelReports(params) {
+	const { plugin, cfg, timeoutMs } = params;
+	const accountIds = params.accountOverride ? [params.accountOverride] : (() => {
+		const ids = plugin.config.listAccountIds(cfg);
+		return ids.length > 0 ? ids : [resolveChannelDefaultAccountId({
+			plugin,
+			cfg,
+			accountIds: ids
+		})];
+	})();
+	const reports = [];
+	const listedActions = plugin.actions?.listActions?.({ cfg }) ?? [];
+	const actions = Array.from(new Set([
+		"send",
+		"broadcast",
+		...listedActions.map((action) => String(action))
+	]));
+	for (const accountId of accountIds) {
+		const resolvedAccount = plugin.config.resolveAccount(cfg, accountId);
+		const configured = plugin.config.isConfigured ? await plugin.config.isConfigured(resolvedAccount, cfg) : Boolean(resolvedAccount);
+		const enabled = plugin.config.isEnabled ? plugin.config.isEnabled(resolvedAccount, cfg) : resolvedAccount.enabled !== false;
+		let probe;
+		if (configured && enabled && plugin.status?.probeAccount) try {
+			probe = await plugin.status.probeAccount({
+				account: resolvedAccount,
+				timeoutMs,
+				cfg
+			});
+		} catch (err) {
+			probe = {
+				ok: false,
+				error: err instanceof Error ? err.message : String(err)
+			};
+		}
+		let slackScopes;
+		if (plugin.id === "slack" && configured && enabled) {
+			const botToken = resolvedAccount.botToken?.trim();
+			const userToken = resolvedAccount.config?.userToken?.trim();
+			const scopeReports = [];
+			if (botToken) scopeReports.push({
+				tokenType: "bot",
+				result: await fetchSlackScopes(botToken, timeoutMs)
+			});
+			else scopeReports.push({
+				tokenType: "bot",
+				result: {
+					ok: false,
+					error: "Slack bot token missing."
+				}
+			});
+			if (userToken) scopeReports.push({
+				tokenType: "user",
+				result: await fetchSlackScopes(userToken, timeoutMs)
+			});
+			slackScopes = scopeReports;
+		}
+		let discordTarget;
+		let discordPermissions;
+		if (plugin.id === "discord" && params.target) {
+			const perms = await buildDiscordPermissions({
+				account: resolvedAccount,
+				target: params.target
+			});
+			discordTarget = perms.target;
+			discordPermissions = perms.report;
+		}
+		reports.push({
+			channel: plugin.id,
+			accountId,
+			accountName: typeof resolvedAccount.name === "string" ? resolvedAccount.name?.trim() || void 0 : void 0,
+			configured,
+			enabled,
+			support: plugin.capabilities,
+			probe,
+			target: discordTarget,
+			channelPermissions: discordPermissions,
+			actions,
+			slackScopes
+		});
+	}
+	return reports;
+}
+async function channelsCapabilitiesCommand(opts, runtime = defaultRuntime) {
+	const cfg = await requireValidConfig(runtime);
+	if (!cfg) return;
+	const timeoutMs = normalizeTimeout(opts.timeout, 1e4);
+	const rawChannel = typeof opts.channel === "string" ? opts.channel.trim().toLowerCase() : "";
+	const rawTarget = typeof opts.target === "string" ? opts.target.trim() : "";
+	if (opts.account && (!rawChannel || rawChannel === "all")) {
+		runtime.error(danger("--account requires a specific --channel."));
+		runtime.exit(1);
+		return;
+	}
+	if (rawTarget && rawChannel !== "discord") {
+		runtime.error(danger("--target requires --channel discord."));
+		runtime.exit(1);
+		return;
+	}
+	const plugins = listChannelPlugins();
+	const selected = !rawChannel || rawChannel === "all" ? plugins : (() => {
+		const plugin = getChannelPlugin(rawChannel);
+		if (!plugin) return null;
+		return [plugin];
+	})();
+	if (!selected || selected.length === 0) {
+		runtime.error(danger(`Unknown channel "${rawChannel}".`));
+		runtime.exit(1);
+		return;
+	}
+	const reports = [];
+	for (const plugin of selected) {
+		const accountOverride = opts.account?.trim() || void 0;
+		reports.push(...await resolveChannelReports({
+			plugin,
+			cfg,
+			timeoutMs,
+			accountOverride,
+			target: rawTarget && plugin.id === "discord" ? rawTarget : void 0
+		}));
+	}
+	if (opts.json) {
+		runtime.log(JSON.stringify({ channels: reports }, null, 2));
+		return;
+	}
+	const lines = [];
+	for (const report of reports) {
+		const label = formatChannelAccountLabel({
+			channel: report.channel,
+			accountId: report.accountId,
+			name: report.accountName,
+			channelStyle: theme.accent,
+			accountStyle: theme.heading
+		});
+		lines.push(theme.heading(label));
+		lines.push(`Support: ${formatSupport(report.support)}`);
+		if (report.actions && report.actions.length > 0) lines.push(`Actions: ${report.actions.join(", ")}`);
+		if (report.configured === false || report.enabled === false) {
+			const configuredLabel = report.configured === false ? "not configured" : "configured";
+			const enabledLabel = report.enabled === false ? "disabled" : "enabled";
+			lines.push(`Status: ${configuredLabel}, ${enabledLabel}`);
+		}
+		const probeLines = formatProbeLines(report.channel, report.probe);
+		if (probeLines.length > 0) lines.push(...probeLines);
+		else if (report.configured && report.enabled) lines.push(theme.muted("Probe: unavailable"));
+		if (report.channel === "slack" && report.slackScopes) for (const entry of report.slackScopes) {
+			const source = entry.result.source ? ` (${entry.result.source})` : "";
+			const label = entry.tokenType === "user" ? "User scopes" : "Bot scopes";
+			if (entry.result.ok && entry.result.scopes?.length) lines.push(`${label}${source}: ${entry.result.scopes.join(", ")}`);
+			else if (entry.result.error) lines.push(`${label}: ${theme.error(entry.result.error)}`);
+		}
+		if (report.channel === "discord" && report.channelPermissions) {
+			const perms = report.channelPermissions;
+			if (perms.error) lines.push(`Permissions: ${theme.error(perms.error)}`);
+			else {
+				const list = perms.permissions?.length ? perms.permissions.join(", ") : "none";
+				const label = perms.channelId ? ` (${perms.channelId})` : "";
+				lines.push(`Permissions${label}: ${list}`);
+				if (perms.missingRequired && perms.missingRequired.length > 0) lines.push(`${theme.warn("Missing required:")} ${perms.missingRequired.join(", ")}`);
+				else lines.push(theme.success("Missing required: none"));
+			}
+		} else if (report.channel === "discord" && rawTarget && !report.channelPermissions) lines.push(theme.muted("Permissions: skipped (no target)."));
+		lines.push("");
+	}
+	runtime.log(lines.join("\n").trimEnd());
+}
+
+//#endregion
+//#region src/commands/channels/list.ts
+const colorValue = (value) => {
+	if (value === "none") return theme.error(value);
+	if (value === "env") return theme.accent(value);
+	return theme.success(value);
+};
+function formatEnabled(value) {
+	return value === false ? theme.error("disabled") : theme.success("enabled");
+}
+function formatConfigured(value) {
+	return value ? theme.success("configured") : theme.warn("not configured");
+}
+function formatTokenSource(source) {
+	return `token=${colorValue(source || "none")}`;
+}
+function formatSource(label, source) {
+	return `${label}=${colorValue(source || "none")}`;
+}
+function formatLinked(value) {
+	return value ? theme.success("linked") : theme.warn("not linked");
+}
+function shouldShowConfigured(channel) {
+	return channel.meta.showConfigured !== false;
+}
+function formatAccountLine(params) {
+	const { channel, snapshot } = params;
+	const label = formatChannelAccountLabel({
+		channel: channel.id,
+		accountId: snapshot.accountId,
+		name: snapshot.name,
+		channelStyle: theme.accent,
+		accountStyle: theme.heading
+	});
+	const bits = [];
+	if (snapshot.linked !== void 0) bits.push(formatLinked(snapshot.linked));
+	if (shouldShowConfigured(channel) && typeof snapshot.configured === "boolean") bits.push(formatConfigured(snapshot.configured));
+	if (snapshot.tokenSource) bits.push(formatTokenSource(snapshot.tokenSource));
+	if (snapshot.botTokenSource) bits.push(formatSource("bot", snapshot.botTokenSource));
+	if (snapshot.appTokenSource) bits.push(formatSource("app", snapshot.appTokenSource));
+	if (snapshot.baseUrl) bits.push(`base=${theme.muted(snapshot.baseUrl)}`);
+	if (typeof snapshot.enabled === "boolean") bits.push(formatEnabled(snapshot.enabled));
+	return `- ${label}: ${bits.join(", ")}`;
+}
+async function loadUsageWithProgress(runtime) {
+	try {
+		return await withProgress({
+			label: "Fetching usage snapshot…",
+			indeterminate: true,
+			enabled: true
+		}, async () => await loadProviderUsageSummary());
+	} catch (err) {
+		runtime.error(String(err));
+		return null;
+	}
+}
+async function channelsListCommand(opts, runtime = defaultRuntime) {
+	const cfg = await requireValidConfig(runtime);
+	if (!cfg) return;
+	const includeUsage = opts.usage !== false;
+	const plugins = listChannelPlugins();
+	const authStore = loadAuthProfileStore();
+	const authProfiles = Object.entries(authStore.profiles).map(([profileId, profile]) => ({
+		id: profileId,
+		provider: profile.provider,
+		type: profile.type,
+		isExternal: false
+	}));
+	if (opts.json) {
+		const usage = includeUsage ? await loadProviderUsageSummary() : void 0;
+		const chat = {};
+		for (const plugin of plugins) chat[plugin.id] = plugin.config.listAccountIds(cfg);
+		const payload = {
+			chat,
+			auth: authProfiles,
+			...usage ? { usage } : {}
+		};
+		runtime.log(JSON.stringify(payload, null, 2));
+		return;
+	}
+	const lines = [];
+	lines.push(theme.heading("Chat channels:"));
+	for (const plugin of plugins) {
+		const accounts = plugin.config.listAccountIds(cfg);
+		if (!accounts || accounts.length === 0) continue;
+		for (const accountId of accounts) {
+			const snapshot = await buildChannelAccountSnapshot({
+				plugin,
+				cfg,
+				accountId
+			});
+			lines.push(formatAccountLine({
+				channel: plugin,
+				snapshot
+			}));
+		}
+	}
+	lines.push("");
+	lines.push(theme.heading("Auth providers (OAuth + API keys):"));
+	if (authProfiles.length === 0) lines.push(theme.muted("- none"));
+	else for (const profile of authProfiles) {
+		const external = profile.isExternal ? theme.muted(" (synced)") : "";
+		lines.push(`- ${theme.accent(profile.id)} (${theme.success(profile.type)}${external})`);
+	}
+	runtime.log(lines.join("\n"));
+	if (includeUsage) {
+		runtime.log("");
+		const usage = await loadUsageWithProgress(runtime);
+		if (usage) {
+			const usageLines = formatUsageReportLines(usage);
+			if (usageLines.length > 0) {
+				usageLines[0] = theme.accent(usageLines[0]);
+				runtime.log(usageLines.join("\n"));
+			}
+		}
+	}
+	runtime.log("");
+	runtime.log(`Docs: ${formatDocsLink("/gateway/configuration", "gateway/configuration")}`);
+}
+
+//#endregion
+//#region src/commands/channels/logs.ts
+const DEFAULT_LIMIT = 200;
+const MAX_BYTES = 1e6;
+const getChannelSet = () => new Set([...listChannelPlugins().map((plugin) => plugin.id), "all"]);
+function parseChannelFilter(raw) {
+	const trimmed = raw?.trim().toLowerCase();
+	if (!trimmed) return "all";
+	return getChannelSet().has(trimmed) ? trimmed : "all";
+}
+function matchesChannel(line, channel) {
+	if (channel === "all") return true;
+	const needle = `gateway/channels/${channel}`;
+	if (line.subsystem?.includes(needle)) return true;
+	if (line.module?.includes(channel)) return true;
+	return false;
+}
+async function readTailLines(file, limit) {
+	const stat = await fsp.stat(file).catch(() => null);
+	if (!stat) return [];
+	const size = stat.size;
+	const start = Math.max(0, size - MAX_BYTES);
+	const handle = await fsp.open(file, "r");
+	try {
+		const length = Math.max(0, size - start);
+		if (length === 0) return [];
+		const buffer = Buffer.alloc(length);
+		const readResult = await handle.read(buffer, 0, length, start);
+		let lines = buffer.toString("utf8", 0, readResult.bytesRead).split("\n");
+		if (start > 0) lines = lines.slice(1);
+		if (lines.length && lines[lines.length - 1] === "") lines = lines.slice(0, -1);
+		if (lines.length > limit) lines = lines.slice(lines.length - limit);
+		return lines;
+	} finally {
+		await handle.close();
+	}
+}
+async function channelsLogsCommand(opts, runtime = defaultRuntime) {
+	const channel = parseChannelFilter(opts.channel);
+	const limitRaw = typeof opts.lines === "string" ? Number(opts.lines) : opts.lines;
+	const limit = typeof limitRaw === "number" && Number.isFinite(limitRaw) && limitRaw > 0 ? Math.floor(limitRaw) : DEFAULT_LIMIT;
+	const file = getResolvedLoggerSettings().file;
+	const filtered = (await readTailLines(file, limit * 4)).map(parseLogLine).filter((line) => Boolean(line)).filter((line) => matchesChannel(line, channel));
+	const lines = filtered.slice(Math.max(0, filtered.length - limit));
+	if (opts.json) {
+		runtime.log(JSON.stringify({
+			file,
+			channel,
+			lines
+		}, null, 2));
+		return;
+	}
+	runtime.log(theme.info(`Log file: ${file}`));
+	if (channel !== "all") runtime.log(theme.info(`Channel: ${channel}`));
+	if (lines.length === 0) {
+		runtime.log(theme.muted("No matching log lines."));
+		return;
+	}
+	for (const line of lines) {
+		const ts = line.time ? `${line.time} ` : "";
+		const level = line.level ? `${line.level.toLowerCase()} ` : "";
+		runtime.log(`${ts}${level}${line.message}`.trim());
+	}
+}
+
+//#endregion
+//#region src/commands/channels/remove.ts
+function listAccountIds(cfg, channel) {
+	const plugin = getChannelPlugin(channel);
+	if (!plugin) return [];
+	return plugin.config.listAccountIds(cfg);
+}
+async function channelsRemoveCommand(opts, runtime = defaultRuntime, params) {
+	const cfg = await requireValidConfig(runtime);
+	if (!cfg) return;
+	const useWizard = shouldUseWizard(params);
+	const prompter = useWizard ? createClackPrompter() : null;
+	let channel = normalizeChannelId(opts.channel);
+	let accountId = normalizeAccountId(opts.account);
+	const deleteConfig = Boolean(opts.delete);
+	if (useWizard && prompter) {
+		await prompter.intro("Remove channel account");
+		const selectedChannel = await prompter.select({
+			message: "Channel",
+			options: listChannelPlugins().map((plugin) => ({
+				value: plugin.id,
+				label: plugin.meta.label
+			}))
+		});
+		channel = selectedChannel;
+		accountId = await (async () => {
+			const ids = listAccountIds(cfg, selectedChannel);
+			return normalizeAccountId(await prompter.select({
+				message: "Account",
+				options: ids.map((id) => ({
+					value: id,
+					label: id === DEFAULT_ACCOUNT_ID ? "default (primary)" : id
+				})),
+				initialValue: ids[0] ?? DEFAULT_ACCOUNT_ID
+			}));
+		})();
+		if (!await prompter.confirm({
+			message: `Disable ${channelLabel(selectedChannel)} account "${accountId}"? (keeps config)`,
+			initialValue: true
+		})) {
+			await prompter.outro("Cancelled.");
+			return;
+		}
+	} else {
+		if (!channel) {
+			runtime.error("Channel is required. Use --channel <name>.");
+			runtime.exit(1);
+			return;
+		}
+		if (!deleteConfig) {
+			if (!await createClackPrompter().confirm({
+				message: `Disable ${channelLabel(channel)} account "${accountId}"? (keeps config)`,
+				initialValue: true
+			})) return;
+		}
+	}
+	const plugin = getChannelPlugin(channel);
+	if (!plugin) {
+		runtime.error(`Unknown channel: ${channel}`);
+		runtime.exit(1);
+		return;
+	}
+	const resolvedAccountId = normalizeAccountId(accountId) ?? resolveChannelDefaultAccountId({
+		plugin,
+		cfg
+	});
+	const accountKey = resolvedAccountId || DEFAULT_ACCOUNT_ID;
+	let next = { ...cfg };
+	if (deleteConfig) {
+		if (!plugin.config.deleteAccount) {
+			runtime.error(`Channel ${channel} does not support delete.`);
+			runtime.exit(1);
+			return;
+		}
+		next = plugin.config.deleteAccount({
+			cfg: next,
+			accountId: resolvedAccountId
+		});
+		if (channel === "telegram") await deleteTelegramUpdateOffset({ accountId: resolvedAccountId });
+	} else {
+		if (!plugin.config.setAccountEnabled) {
+			runtime.error(`Channel ${channel} does not support disable.`);
+			runtime.exit(1);
+			return;
+		}
+		next = plugin.config.setAccountEnabled({
+			cfg: next,
+			accountId: resolvedAccountId,
+			enabled: false
+		});
+	}
+	await writeConfigFile(next);
+	if (useWizard && prompter) await prompter.outro(deleteConfig ? `Deleted ${channelLabel(channel)} account "${accountKey}".` : `Disabled ${channelLabel(channel)} account "${accountKey}".`);
+	else runtime.log(deleteConfig ? `Deleted ${channelLabel(channel)} account "${accountKey}".` : `Disabled ${channelLabel(channel)} account "${accountKey}".`);
+}
+
+//#endregion
+//#region src/commands/channels/resolve.ts
+function resolvePreferredKind(kind) {
+	if (!kind || kind === "auto") return;
+	if (kind === "user") return "user";
+	return "group";
+}
+function detectAutoKind(input) {
+	const trimmed = input.trim();
+	if (!trimmed) return "group";
+	if (trimmed.startsWith("@")) return "user";
+	if (/^<@!?/.test(trimmed)) return "user";
+	if (/^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(trimmed)) return "user";
+	if (/^(user|discord|slack|matrix|msteams|teams|zalo|zalouser|googlechat|google-chat|gchat):/i.test(trimmed)) return "user";
+	return "group";
+}
+function formatResolveResult(result) {
+	if (!result.resolved || !result.id) return `${result.input} -> unresolved`;
+	const name = result.name ? ` (${result.name})` : "";
+	const note = result.note ? ` [${result.note}]` : "";
+	return `${result.input} -> ${result.id}${name}${note}`;
+}
+async function channelsResolveCommand(opts, runtime) {
+	const cfg = loadConfig();
+	const entries = (opts.entries ?? []).map((entry) => entry.trim()).filter(Boolean);
+	if (entries.length === 0) throw new Error("At least one entry is required.");
+	const selection = await resolveMessageChannelSelection({
+		cfg,
+		channel: opts.channel ?? null
+	});
+	const plugin = getChannelPlugin(selection.channel);
+	if (!plugin?.resolver?.resolveTargets) throw new Error(`Channel ${selection.channel} does not support resolve.`);
+	const preferredKind = resolvePreferredKind(opts.kind);
+	let results = [];
+	if (preferredKind) results = (await plugin.resolver.resolveTargets({
+		cfg,
+		accountId: opts.account ?? null,
+		inputs: entries,
+		kind: preferredKind,
+		runtime
+	})).map((entry) => ({
+		input: entry.input,
+		resolved: entry.resolved,
+		id: entry.id,
+		name: entry.name,
+		note: entry.note
+	}));
+	else {
+		const byKind = /* @__PURE__ */ new Map();
+		for (const entry of entries) {
+			const kind = detectAutoKind(entry);
+			byKind.set(kind, [...byKind.get(kind) ?? [], entry]);
+		}
+		const resolved = [];
+		for (const [kind, inputs] of byKind.entries()) {
+			const batch = await plugin.resolver.resolveTargets({
+				cfg,
+				accountId: opts.account ?? null,
+				inputs,
+				kind,
+				runtime
+			});
+			resolved.push(...batch);
+		}
+		const byInput = new Map(resolved.map((entry) => [entry.input, entry]));
+		results = entries.map((input) => {
+			const entry = byInput.get(input);
+			return {
+				input,
+				resolved: entry?.resolved ?? false,
+				id: entry?.id,
+				name: entry?.name,
+				note: entry?.note
+			};
+		});
+	}
+	if (opts.json) {
+		runtime.log(JSON.stringify(results, null, 2));
+		return;
+	}
+	for (const result of results) if (result.resolved && result.id) runtime.log(formatResolveResult(result));
+	else runtime.error(danger(`${result.input} -> unresolved${result.error ? ` (${result.error})` : result.note ? ` (${result.note})` : ""}`));
+}
+
+//#endregion
+//#region src/commands/channels/status.ts
+function appendEnabledConfiguredLinkedBits(bits, account) {
+	if (typeof account.enabled === "boolean") bits.push(account.enabled ? "enabled" : "disabled");
+	if (typeof account.configured === "boolean") bits.push(account.configured ? "configured" : "not configured");
+	if (typeof account.linked === "boolean") bits.push(account.linked ? "linked" : "not linked");
+}
+function appendModeBit(bits, account) {
+	if (typeof account.mode === "string" && account.mode.length > 0) bits.push(`mode:${account.mode}`);
+}
+function appendTokenSourceBits(bits, account) {
+	if (typeof account.tokenSource === "string" && account.tokenSource) bits.push(`token:${account.tokenSource}`);
+	if (typeof account.botTokenSource === "string" && account.botTokenSource) bits.push(`bot:${account.botTokenSource}`);
+	if (typeof account.appTokenSource === "string" && account.appTokenSource) bits.push(`app:${account.appTokenSource}`);
+}
+function appendBaseUrlBit(bits, account) {
+	if (typeof account.baseUrl === "string" && account.baseUrl) bits.push(`url:${account.baseUrl}`);
+}
+function buildChannelAccountLine(provider, account, bits) {
+	return `- ${formatChannelAccountLabel({
+		channel: provider,
+		accountId: typeof account.accountId === "string" ? account.accountId : "default",
+		name: (typeof account.name === "string" ? account.name.trim() : "") || void 0
+	})}: ${bits.join(", ")}`;
+}
+function formatGatewayChannelsStatusLines(payload) {
+	const lines = [];
+	lines.push(theme.success("Gateway reachable."));
+	const accountLines = (provider, accounts) => accounts.map((account) => {
+		const bits = [];
+		appendEnabledConfiguredLinkedBits(bits, account);
+		if (typeof account.running === "boolean") bits.push(account.running ? "running" : "stopped");
+		if (typeof account.connected === "boolean") bits.push(account.connected ? "connected" : "disconnected");
+		const inboundAt = typeof account.lastInboundAt === "number" && Number.isFinite(account.lastInboundAt) ? account.lastInboundAt : null;
+		const outboundAt = typeof account.lastOutboundAt === "number" && Number.isFinite(account.lastOutboundAt) ? account.lastOutboundAt : null;
+		if (inboundAt) bits.push(`in:${formatTimeAgo(Date.now() - inboundAt)}`);
+		if (outboundAt) bits.push(`out:${formatTimeAgo(Date.now() - outboundAt)}`);
+		appendModeBit(bits, account);
+		const botUsername = (() => {
+			const bot = account.bot;
+			const probeBot = account.probe?.bot;
+			const raw = bot?.username ?? probeBot?.username ?? "";
+			if (typeof raw !== "string") return "";
+			const trimmed = raw.trim();
+			if (!trimmed) return "";
+			return trimmed.startsWith("@") ? trimmed : `@${trimmed}`;
+		})();
+		if (botUsername) bits.push(`bot:${botUsername}`);
+		if (typeof account.dmPolicy === "string" && account.dmPolicy.length > 0) bits.push(`dm:${account.dmPolicy}`);
+		if (Array.isArray(account.allowFrom) && account.allowFrom.length > 0) bits.push(`allow:${account.allowFrom.slice(0, 2).join(",")}`);
+		appendTokenSourceBits(bits, account);
+		const messageContent = account.application?.intents?.messageContent;
+		if (typeof messageContent === "string" && messageContent.length > 0 && messageContent !== "enabled") bits.push(`intents:content=${messageContent}`);
+		if (account.allowUnmentionedGroups === true) bits.push("groups:unmentioned");
+		appendBaseUrlBit(bits, account);
+		const probe = account.probe;
+		if (probe && typeof probe.ok === "boolean") bits.push(probe.ok ? "works" : "probe failed");
+		const audit = account.audit;
+		if (audit && typeof audit.ok === "boolean") bits.push(audit.ok ? "audit ok" : "audit failed");
+		if (typeof account.lastError === "string" && account.lastError) bits.push(`error:${account.lastError}`);
+		return buildChannelAccountLine(provider, account, bits);
+	});
+	const plugins = listChannelPlugins();
+	const accountsByChannel = payload.channelAccounts;
+	const accountPayloads = {};
+	for (const plugin of plugins) {
+		const raw = accountsByChannel?.[plugin.id];
+		if (Array.isArray(raw)) accountPayloads[plugin.id] = raw;
+	}
+	for (const plugin of plugins) {
+		const accounts = accountPayloads[plugin.id];
+		if (accounts && accounts.length > 0) lines.push(...accountLines(plugin.id, accounts));
+	}
+	lines.push("");
+	const issues = collectChannelStatusIssues(payload);
+	if (issues.length > 0) {
+		lines.push(theme.warn("Warnings:"));
+		for (const issue of issues) lines.push(`- ${issue.channel} ${issue.accountId}: ${issue.message}${issue.fix ? ` (${issue.fix})` : ""}`);
+		lines.push(`- Run: ${formatCliCommand("remoteclaw doctor")}`);
+		lines.push("");
+	}
+	lines.push(`Tip: ${formatDocsLink("/cli#status", "status --deep")} adds gateway health probes to status output (requires a reachable gateway).`);
+	return lines;
+}
+async function formatConfigChannelsStatusLines(cfg, meta) {
+	const lines = [];
+	lines.push(theme.warn("Gateway not reachable; showing config-only status."));
+	if (meta.path) lines.push(`Config: ${meta.path}`);
+	if (meta.mode) lines.push(`Mode: ${meta.mode}`);
+	if (meta.path || meta.mode) lines.push("");
+	const accountLines = (provider, accounts) => accounts.map((account) => {
+		const bits = [];
+		appendEnabledConfiguredLinkedBits(bits, account);
+		appendModeBit(bits, account);
+		appendTokenSourceBits(bits, account);
+		appendBaseUrlBit(bits, account);
+		return buildChannelAccountLine(provider, account, bits);
+	});
+	const plugins = listChannelPlugins();
+	for (const plugin of plugins) {
+		const accountIds = plugin.config.listAccountIds(cfg);
+		if (!accountIds.length) continue;
+		const snapshots = [];
+		for (const accountId of accountIds) {
+			const snapshot = await buildChannelAccountSnapshot({
+				plugin,
+				cfg,
+				accountId
+			});
+			snapshots.push(snapshot);
+		}
+		if (snapshots.length > 0) lines.push(...accountLines(plugin.id, snapshots));
+	}
+	lines.push("");
+	lines.push(`Tip: ${formatDocsLink("/cli#status", "status --deep")} adds gateway health probes to status output (requires a reachable gateway).`);
+	return lines;
+}
+async function channelsStatusCommand(opts, runtime = defaultRuntime) {
+	const timeoutMs = Number(opts.timeout ?? 1e4);
+	const statusLabel = opts.probe ? "Checking channel status (probe)…" : "Checking channel status…";
+	if (opts.json !== true && !process.stderr.isTTY) runtime.log(statusLabel);
+	try {
+		const payload = await withProgress({
+			label: statusLabel,
+			indeterminate: true,
+			enabled: opts.json !== true
+		}, async () => await callGateway({
+			method: "channels.status",
+			params: {
+				probe: Boolean(opts.probe),
+				timeoutMs
+			},
+			timeoutMs
+		}));
+		if (opts.json) {
+			runtime.log(JSON.stringify(payload, null, 2));
+			return;
+		}
+		runtime.log(formatGatewayChannelsStatusLines(payload).join("\n"));
+	} catch (err) {
+		runtime.error(`Gateway not reachable: ${String(err)}`);
+		const cfg = await requireValidConfig(runtime);
+		if (!cfg) return;
+		const snapshot = await readConfigFileSnapshot();
+		const mode = cfg.gateway?.mode === "remote" ? "remote" : "local";
+		runtime.log((await formatConfigChannelsStatusLines(cfg, {
+			path: snapshot.path,
+			mode
+		})).join("\n"));
+	}
+}
+
+//#endregion
+//#region src/cli/channel-auth.ts
+async function resolveChannelPluginForMode(opts, mode, cfg) {
+	const explicitChannel = opts.channel?.trim();
+	const channelInput = explicitChannel ? explicitChannel : (await resolveMessageChannelSelection({ cfg })).channel;
+	const channelId = normalizeChannelId(channelInput);
+	if (!channelId) throw new Error(`Unsupported channel: ${channelInput}`);
+	const plugin = getChannelPlugin(channelId);
+	if (!(mode === "login" ? Boolean(plugin?.auth?.login) : Boolean(plugin?.gateway?.logoutAccount))) throw new Error(`Channel ${channelId} does not support ${mode}`);
+	return {
+		channelInput,
+		channelId,
+		plugin
+	};
+}
+function resolveAccountContext(plugin, opts, cfg) {
+	return { accountId: opts.account?.trim() || resolveChannelDefaultAccountId({
+		plugin,
+		cfg
+	}) };
+}
+async function runChannelLogin(opts, runtime = defaultRuntime) {
+	const cfg = loadConfig();
+	const { channelInput, plugin } = await resolveChannelPluginForMode(opts, "login", cfg);
+	const login = plugin.auth?.login;
+	if (!login) throw new Error(`Channel ${channelInput} does not support login`);
+	setVerbose(Boolean(opts.verbose));
+	const { accountId } = resolveAccountContext(plugin, opts, cfg);
+	await login({
+		cfg,
+		accountId,
+		runtime,
+		verbose: Boolean(opts.verbose),
+		channelInput
+	});
+}
+async function runChannelLogout(opts, runtime = defaultRuntime) {
+	const cfg = loadConfig();
+	const { channelInput, plugin } = await resolveChannelPluginForMode(opts, "logout", cfg);
+	const logoutAccount = plugin.gateway?.logoutAccount;
+	if (!logoutAccount) throw new Error(`Channel ${channelInput} does not support logout`);
+	const { accountId } = resolveAccountContext(plugin, opts, cfg);
+	await logoutAccount({
+		cfg,
+		accountId,
+		account: plugin.config.resolveAccount(cfg, accountId),
+		runtime
+	});
+}
+
+//#endregion
+//#region src/cli/channels-cli.ts
+const optionNamesAdd = [
+	"channel",
+	"account",
+	"name",
+	"token",
+	"tokenFile",
+	"botToken",
+	"appToken",
+	"signalNumber",
+	"cliPath",
+	"dbPath",
+	"service",
+	"region",
+	"authDir",
+	"httpUrl",
+	"httpHost",
+	"httpPort",
+	"webhookPath",
+	"webhookUrl",
+	"audienceType",
+	"audience",
+	"useEnv",
+	"homeserver",
+	"userId",
+	"accessToken",
+	"password",
+	"deviceName",
+	"initialSyncLimit",
+	"ship",
+	"url",
+	"code",
+	"groupChannels",
+	"dmAllowlist",
+	"autoDiscoverChannels"
+];
+const optionNamesRemove = [
+	"channel",
+	"account",
+	"delete"
+];
+function runChannelsCommand(action) {
+	return runCommandWithRuntime(defaultRuntime, action);
+}
+function runChannelsCommandWithDanger(action, label) {
+	return runCommandWithRuntime(defaultRuntime, action, (err) => {
+		defaultRuntime.error(danger(`${label}: ${String(err)}`));
+		defaultRuntime.exit(1);
+	});
+}
+function registerChannelsCli(program) {
+	const channelNames = formatCliChannelOptions();
+	const channels = program.command("channels").description("Manage connected chat channels and accounts").addHelpText("after", () => `\n${theme.heading("Examples:")}\n${formatHelpExamples([
+		["remoteclaw channels list", "List configured channels and auth profiles."],
+		["remoteclaw channels status --probe", "Run channel status checks and probes."],
+		["remoteclaw channels add --channel telegram --token <token>", "Add or update a channel account non-interactively."],
+		["remoteclaw channels login --channel whatsapp", "Link a WhatsApp Web account."]
+	])}\n\n${theme.muted("Docs:")} ${formatDocsLink("/cli/channels", "docs.remoteclaw.org/cli/channels")}\n`);
+	channels.command("list").description("List configured channels + auth profiles").option("--no-usage", "Skip model provider usage/quota snapshots").option("--json", "Output JSON", false).action(async (opts) => {
+		await runChannelsCommand(async () => {
+			await channelsListCommand(opts, defaultRuntime);
+		});
+	});
+	channels.command("status").description("Show gateway channel status (use status --deep for local)").option("--probe", "Probe channel credentials", false).option("--timeout <ms>", "Timeout in ms", "10000").option("--json", "Output JSON", false).action(async (opts) => {
+		await runChannelsCommand(async () => {
+			await channelsStatusCommand(opts, defaultRuntime);
+		});
+	});
+	channels.command("capabilities").description("Show provider capabilities (intents/scopes + supported features)").option("--channel <name>", `Channel (${formatCliChannelOptions(["all"])})`).option("--account <id>", "Account id (only with --channel)").option("--target <dest>", "Channel target for permission audit (Discord channel:<id>)").option("--timeout <ms>", "Timeout in ms", "10000").option("--json", "Output JSON", false).action(async (opts) => {
+		await runChannelsCommand(async () => {
+			await channelsCapabilitiesCommand(opts, defaultRuntime);
+		});
+	});
+	channels.command("resolve").description("Resolve channel/user names to IDs").argument("<entries...>", "Entries to resolve (names or ids)").option("--channel <name>", `Channel (${channelNames})`).option("--account <id>", "Account id (accountId)").option("--kind <kind>", "Target kind (auto|user|group)", "auto").option("--json", "Output JSON", false).action(async (entries, opts) => {
+		await runChannelsCommand(async () => {
+			await channelsResolveCommand({
+				channel: opts.channel,
+				account: opts.account,
+				kind: opts.kind,
+				json: Boolean(opts.json),
+				entries: Array.isArray(entries) ? entries : [String(entries)]
+			}, defaultRuntime);
+		});
+	});
+	channels.command("logs").description("Show recent channel logs from the gateway log file").option("--channel <name>", `Channel (${formatCliChannelOptions(["all"])})`, "all").option("--lines <n>", "Number of lines (default: 200)", "200").option("--json", "Output JSON", false).action(async (opts) => {
+		await runChannelsCommand(async () => {
+			await channelsLogsCommand(opts, defaultRuntime);
+		});
+	});
+	channels.command("add").description("Add or update a channel account").option("--channel <name>", `Channel (${channelNames})`).option("--account <id>", "Account id (default when omitted)").option("--name <name>", "Display name for this account").option("--token <token>", "Bot token (Telegram/Discord)").option("--token-file <path>", "Bot token file (Telegram)").option("--bot-token <token>", "Slack bot token (xoxb-...)").option("--app-token <token>", "Slack app token (xapp-...)").option("--signal-number <e164>", "Signal account number (E.164)").option("--cli-path <path>", "CLI path (signal-cli or imsg)").option("--db-path <path>", "iMessage database path").option("--service <service>", "iMessage service (imessage|sms|auto)").option("--region <region>", "iMessage region (for SMS)").option("--auth-dir <path>", "WhatsApp auth directory override").option("--http-url <url>", "Signal HTTP daemon base URL").option("--http-host <host>", "Signal HTTP host").option("--http-port <port>", "Signal HTTP port").option("--webhook-path <path>", "Webhook path (Google Chat/BlueBubbles)").option("--webhook-url <url>", "Google Chat webhook URL").option("--audience-type <type>", "Google Chat audience type (app-url|project-number)").option("--audience <value>", "Google Chat audience value (app URL or project number)").option("--homeserver <url>", "Matrix homeserver URL").option("--user-id <id>", "Matrix user ID").option("--access-token <token>", "Matrix access token").option("--password <password>", "Matrix password").option("--device-name <name>", "Matrix device name").option("--initial-sync-limit <n>", "Matrix initial sync limit").option("--ship <ship>", "Tlon ship name (~sampel-palnet)").option("--url <url>", "Tlon ship URL").option("--code <code>", "Tlon login code").option("--group-channels <list>", "Tlon group channels (comma-separated)").option("--dm-allowlist <list>", "Tlon DM allowlist (comma-separated ships)").option("--auto-discover-channels", "Tlon auto-discover group channels").option("--no-auto-discover-channels", "Disable Tlon auto-discovery").option("--use-env", "Use env token (default account only)", false).action(async (opts, command) => {
+		await runChannelsCommand(async () => {
+			await channelsAddCommand(opts, defaultRuntime, { hasFlags: hasExplicitOptions(command, optionNamesAdd) });
+		});
+	});
+	channels.command("remove").description("Disable or delete a channel account").option("--channel <name>", `Channel (${channelNames})`).option("--account <id>", "Account id (default when omitted)").option("--delete", "Delete config entries (no prompt)", false).action(async (opts, command) => {
+		await runChannelsCommand(async () => {
+			await channelsRemoveCommand(opts, defaultRuntime, { hasFlags: hasExplicitOptions(command, optionNamesRemove) });
+		});
+	});
+	channels.command("login").description("Link a channel account (if supported)").option("--channel <channel>", "Channel alias (auto when only one is configured)").option("--account <id>", "Account id (accountId)").option("--verbose", "Verbose connection logs", false).action(async (opts) => {
+		await runChannelsCommandWithDanger(async () => {
+			await runChannelLogin({
+				channel: opts.channel,
+				account: opts.account,
+				verbose: Boolean(opts.verbose)
+			}, defaultRuntime);
+		}, "Channel login failed");
+	});
+	channels.command("logout").description("Log out of a channel session (if supported)").option("--channel <channel>", "Channel alias (auto when only one is configured)").option("--account <id>", "Account id (accountId)").action(async (opts) => {
+		await runChannelsCommandWithDanger(async () => {
+			await runChannelLogout({
+				channel: opts.channel,
+				account: opts.account
+			}, defaultRuntime);
+		}, "Channel logout failed");
+	});
+}
+
+//#endregion
+export { registerChannelsCli };