remoteclaw 0.0.0 → 0.0.1

package/dist/message-action-names-BwpFcASf.js

@@ -0,0 +1,2520 @@
+import { _ as defaultRuntime } from "./entry.js";
+import { i as loadConfig } from "./config-qAZfcdDM.js";
+import { u as resolveThreadSessionKeys } from "./session-key-BF-9YzxC.js";
+import { f as resolveSessionAgentId } from "./agent-scope-FzE2oRm0.js";
+import { c as normalizeMessageChannel, f as GATEWAY_CLIENT_MODES, n as isDeliverableMessageChannel, p as GATEWAY_CLIENT_NAMES } from "./message-channel-tuc9CdEw.js";
+import { f as recordSessionMetaFromInbound, i as appendAssistantMessageToSessionTranscript } from "./sessions-Dg3febTj.js";
+import { _ as resolveDiscordAccount, a as isWhatsAppGroupJid, l as resolveSlackAccount, n as listChannelPlugins, o as normalizeWhatsAppTarget, r as normalizeChannelId, t as getChannelPlugin } from "./plugins-Ca4Ybd3t.js";
+import { t as parseSlackTarget } from "./targets-CmC5m7Ey.js";
+import { t as parseDiscordTarget } from "./targets-D8Rv_6CT.js";
+import { a as looksLikeUuid, c as resolveSignalSender, n as normalizeAllowListLower, o as resolveSignalPeerId, s as resolveSignalRecipient } from "./loader-BLMpE4uG.js";
+import { m as resolveStorePath } from "./chat-envelope-AJFUAuBM.js";
+import { a as randomIdempotencyKey, r as callGatewayLeastPrivilege } from "./call-Wjjo7gwP.js";
+import { h as normalizeTargetForProvider, m as normalizeChannelTargetInput, p as buildTargetResolverSignature } from "./hook-runner-global-nAi_RVmo.js";
+import { r as getAgentScopedMediaLocalRoots, t as loadWebMedia } from "./media-DcDCPyuW.js";
+import { n as normalizePollInput } from "./polls-BmymsJEe.js";
+import { n as extensionForMime } from "./mime-ViuhRuMM.js";
+import { d as readStringParam, l as readStringArrayParam, s as readNumberParam } from "./common-D4fL3S2m.js";
+import { r as unknownTargetError, t as ambiguousTargetError } from "./target-errors-GZXDqlUu.js";
+import { r as resolveOutboundTarget } from "./targets-felDvoku.js";
+import { t as createSlackWebClient } from "./client-D-R1YdRD.js";
+import { t as parseReplyDirectives } from "./reply-directives-Bbyf2UON.js";
+import { i as resolveTelegramTargetChatType, r as parseTelegramTarget } from "./targets-D01MJGnh.js";
+import { t as buildAgentSessionKey } from "./resolve-route-BBOsg5KI.js";
+import { E as buildTelegramGroupPeerId } from "./send-DO4RP5yz.js";
+import { n as resolveMessageChannelSelection, t as listConfiguredMessageChannels } from "./channel-selection-DHUO7WUa.js";
+import { o as normalizeReplyPayloadsForDelivery, s as throwIfAborted, t as deliverOutboundPayloads } from "./deliver-D49hWPWI.js";
+import { a as normalizeIMessageHandle, o as parseIMessageTarget } from "./send-DpaTnM-a.js";
+import { fileURLToPath } from "node:url";
+import path from "node:path";
+import fsp from "node:fs/promises";
+import { Container, Separator, TextDisplay } from "@buape/carbon";
+
+//#region src/infra/outbound/directory-cache.ts
+function buildDirectoryCacheKey(key) {
+	const signature = key.signature ?? "default";
+	return `${key.channel}:${key.accountId ?? "default"}:${key.kind}:${key.source}:${signature}`;
+}
+var DirectoryCache = class {
+	constructor(ttlMs, maxSize = 2e3) {
+		this.ttlMs = ttlMs;
+		this.cache = /* @__PURE__ */ new Map();
+		this.lastConfigRef = null;
+		this.maxSize = Math.max(1, Math.floor(maxSize));
+	}
+	get(key, cfg) {
+		this.resetIfConfigChanged(cfg);
+		this.pruneExpired(Date.now());
+		const entry = this.cache.get(key);
+		if (!entry) return;
+		return entry.value;
+	}
+	set(key, value, cfg) {
+		this.resetIfConfigChanged(cfg);
+		const now = Date.now();
+		this.pruneExpired(now);
+		if (this.cache.has(key)) this.cache.delete(key);
+		this.cache.set(key, {
+			value,
+			fetchedAt: now
+		});
+		this.evictToMaxSize();
+	}
+	clearMatching(match) {
+		for (const key of this.cache.keys()) if (match(key)) this.cache.delete(key);
+	}
+	clear(cfg) {
+		this.cache.clear();
+		if (cfg) this.lastConfigRef = cfg;
+	}
+	resetIfConfigChanged(cfg) {
+		if (this.lastConfigRef && this.lastConfigRef !== cfg) this.cache.clear();
+		this.lastConfigRef = cfg;
+	}
+	pruneExpired(now) {
+		if (this.ttlMs <= 0) return;
+		for (const [cacheKey, entry] of this.cache.entries()) if (now - entry.fetchedAt > this.ttlMs) this.cache.delete(cacheKey);
+	}
+	evictToMaxSize() {
+		while (this.cache.size > this.maxSize) {
+			const oldestKey = this.cache.keys().next().value;
+			if (typeof oldestKey !== "string") break;
+			this.cache.delete(oldestKey);
+		}
+	}
+};
+
+//#endregion
+//#region src/infra/outbound/target-resolver.ts
+async function resolveChannelTarget(params) {
+	return resolveMessagingTarget(params);
+}
+const directoryCache = new DirectoryCache(1800 * 1e3);
+function resetDirectoryCache(params) {
+	if (!params?.channel) {
+		directoryCache.clear();
+		return;
+	}
+	const channelKey = params.channel;
+	const accountKey = params.accountId ?? "default";
+	directoryCache.clearMatching((key) => {
+		if (!key.startsWith(`${channelKey}:`)) return false;
+		if (!params.accountId) return true;
+		return key.startsWith(`${channelKey}:${accountKey}:`);
+	});
+}
+function normalizeQuery(value) {
+	return value.trim().toLowerCase();
+}
+function stripTargetPrefixes(value) {
+	return value.replace(/^(channel|user):/i, "").replace(/^[@#]/, "").trim();
+}
+function formatTargetDisplay(params) {
+	const plugin = getChannelPlugin(params.channel);
+	if (plugin?.messaging?.formatTargetDisplay) return plugin.messaging.formatTargetDisplay({
+		target: params.target,
+		display: params.display,
+		kind: params.kind
+	});
+	const trimmedTarget = params.target.trim();
+	const lowered = trimmedTarget.toLowerCase();
+	const display = params.display?.trim();
+	const kind = params.kind ?? (lowered.startsWith("user:") ? "user" : lowered.startsWith("channel:") ? "group" : void 0);
+	if (display) {
+		if (display.startsWith("#") || display.startsWith("@")) return display;
+		if (kind === "user") return `@${display}`;
+		if (kind === "group" || kind === "channel") return `#${display}`;
+		return display;
+	}
+	if (!trimmedTarget) return trimmedTarget;
+	if (trimmedTarget.startsWith("#") || trimmedTarget.startsWith("@")) return trimmedTarget;
+	const channelPrefix = `${params.channel}:`;
+	const withoutPrefix = (trimmedTarget.toLowerCase().startsWith(channelPrefix) ? trimmedTarget.slice(channelPrefix.length) : trimmedTarget).replace(/^telegram:/i, "");
+	if (/^channel:/i.test(withoutPrefix)) return `#${withoutPrefix.replace(/^channel:/i, "")}`;
+	if (/^user:/i.test(withoutPrefix)) return `@${withoutPrefix.replace(/^user:/i, "")}`;
+	return withoutPrefix;
+}
+function preserveTargetCase(channel, raw, normalized) {
+	if (channel !== "slack") return normalized;
+	const trimmed = raw.trim();
+	if (/^channel:/i.test(trimmed) || /^user:/i.test(trimmed)) return trimmed;
+	if (trimmed.startsWith("#")) return `channel:${trimmed.slice(1).trim()}`;
+	if (trimmed.startsWith("@")) return `user:${trimmed.slice(1).trim()}`;
+	return trimmed;
+}
+function detectTargetKind(channel, raw, preferred) {
+	if (preferred) return preferred;
+	const trimmed = raw.trim();
+	if (!trimmed) return "group";
+	if (trimmed.startsWith("@") || /^<@!?/.test(trimmed) || /^user:/i.test(trimmed)) return "user";
+	if (trimmed.startsWith("#") || /^channel:/i.test(trimmed)) return "group";
+	if ((channel === "bluebubbles" || channel === "imessage") && /^\+?\d{6,}$/.test(trimmed)) return "user";
+	return "group";
+}
+function normalizeDirectoryEntryId(channel, entry) {
+	return normalizeTargetForProvider(channel, entry.id) ?? entry.id.trim();
+}
+function matchesDirectoryEntry(params) {
+	const query = normalizeQuery(params.query);
+	if (!query) return false;
+	return [
+		stripTargetPrefixes(normalizeDirectoryEntryId(params.channel, params.entry)),
+		params.entry.name ? stripTargetPrefixes(params.entry.name) : "",
+		params.entry.handle ? stripTargetPrefixes(params.entry.handle) : ""
+	].map((value) => normalizeQuery(value)).filter(Boolean).some((value) => value === query || value.includes(query));
+}
+function resolveMatch(params) {
+	const matches = params.entries.filter((entry) => matchesDirectoryEntry({
+		channel: params.channel,
+		entry,
+		query: params.query
+	}));
+	if (matches.length === 0) return { kind: "none" };
+	if (matches.length === 1) return {
+		kind: "single",
+		entry: matches[0]
+	};
+	return {
+		kind: "ambiguous",
+		entries: matches
+	};
+}
+async function listDirectoryEntries(params) {
+	const directory = getChannelPlugin(params.channel)?.directory;
+	if (!directory) return [];
+	const runtime = params.runtime ?? defaultRuntime;
+	const useLive = params.source === "live";
+	const fn = params.kind === "user" ? useLive ? directory.listPeersLive ?? directory.listPeers : directory.listPeers : useLive ? directory.listGroupsLive ?? directory.listGroups : directory.listGroups;
+	if (!fn) return [];
+	return await fn({
+		cfg: params.cfg,
+		accountId: params.accountId ?? void 0,
+		query: params.query ?? void 0,
+		limit: void 0,
+		runtime
+	});
+}
+async function getDirectoryEntries(params) {
+	const signature = buildTargetResolverSignature(params.channel);
+	const cacheKey = buildDirectoryCacheKey({
+		channel: params.channel,
+		accountId: params.accountId,
+		kind: params.kind,
+		source: "cache",
+		signature
+	});
+	const cached = directoryCache.get(cacheKey, params.cfg);
+	if (cached) return cached;
+	const entries = await listDirectoryEntries({
+		cfg: params.cfg,
+		channel: params.channel,
+		accountId: params.accountId,
+		kind: params.kind,
+		query: params.query,
+		runtime: params.runtime,
+		source: "cache"
+	});
+	if (entries.length > 0 || !params.preferLiveOnMiss) {
+		directoryCache.set(cacheKey, entries, params.cfg);
+		return entries;
+	}
+	const liveKey = buildDirectoryCacheKey({
+		channel: params.channel,
+		accountId: params.accountId,
+		kind: params.kind,
+		source: "live",
+		signature
+	});
+	const liveEntries = await listDirectoryEntries({
+		cfg: params.cfg,
+		channel: params.channel,
+		accountId: params.accountId,
+		kind: params.kind,
+		query: params.query,
+		runtime: params.runtime,
+		source: "live"
+	});
+	directoryCache.set(liveKey, liveEntries, params.cfg);
+	directoryCache.set(cacheKey, liveEntries, params.cfg);
+	return liveEntries;
+}
+function pickAmbiguousMatch(entries, mode) {
+	if (entries.length === 0) return null;
+	if (mode === "first") return entries[0] ?? null;
+	const ranked = entries.map((entry) => ({
+		entry,
+		rank: typeof entry.rank === "number" ? entry.rank : 0
+	}));
+	const bestRank = Math.max(...ranked.map((item) => item.rank));
+	return ranked.find((item) => item.rank === bestRank)?.entry ?? entries[0] ?? null;
+}
+async function resolveMessagingTarget(params) {
+	const raw = normalizeChannelTargetInput(params.input);
+	if (!raw) return {
+		ok: false,
+		error: /* @__PURE__ */ new Error("Target is required")
+	};
+	const plugin = getChannelPlugin(params.channel);
+	const providerLabel = plugin?.meta?.label ?? params.channel;
+	const hint = plugin?.messaging?.targetResolver?.hint;
+	const kind = detectTargetKind(params.channel, raw, params.preferredKind);
+	const normalized = normalizeTargetForProvider(params.channel, raw) ?? raw;
+	const looksLikeTargetId = () => {
+		const trimmed = raw.trim();
+		if (!trimmed) return false;
+		const lookup = plugin?.messaging?.targetResolver?.looksLikeId;
+		if (lookup) return lookup(trimmed, normalized);
+		if (/^(channel|group|user):/i.test(trimmed)) return true;
+		if (/^[@#]/.test(trimmed)) return true;
+		if (/^\+?\d{6,}$/.test(trimmed)) {
+			if (params.channel === "bluebubbles" || params.channel === "imessage") return false;
+			return true;
+		}
+		if (trimmed.includes("@thread")) return true;
+		if (/^(conversation|user):/i.test(trimmed)) return true;
+		return false;
+	};
+	if (looksLikeTargetId()) return {
+		ok: true,
+		target: {
+			to: preserveTargetCase(params.channel, raw, normalized),
+			kind,
+			display: stripTargetPrefixes(raw),
+			source: "normalized"
+		}
+	};
+	const query = stripTargetPrefixes(raw);
+	const entries = await getDirectoryEntries({
+		cfg: params.cfg,
+		channel: params.channel,
+		accountId: params.accountId,
+		kind: kind === "user" ? "user" : "group",
+		query,
+		runtime: params.runtime,
+		preferLiveOnMiss: true
+	});
+	const match = resolveMatch({
+		channel: params.channel,
+		entries,
+		query
+	});
+	if (match.kind === "single") {
+		const entry = match.entry;
+		return {
+			ok: true,
+			target: {
+				to: normalizeDirectoryEntryId(params.channel, entry),
+				kind,
+				display: entry.name ?? entry.handle ?? stripTargetPrefixes(entry.id),
+				source: "directory"
+			}
+		};
+	}
+	if (match.kind === "ambiguous") {
+		const mode = params.resolveAmbiguous ?? "error";
+		if (mode !== "error") {
+			const best = pickAmbiguousMatch(match.entries, mode);
+			if (best) return {
+				ok: true,
+				target: {
+					to: normalizeDirectoryEntryId(params.channel, best),
+					kind,
+					display: best.name ?? best.handle ?? stripTargetPrefixes(best.id),
+					source: "directory"
+				}
+			};
+		}
+		return {
+			ok: false,
+			error: ambiguousTargetError(providerLabel, raw, hint),
+			candidates: match.entries
+		};
+	}
+	if ((params.channel === "bluebubbles" || params.channel === "imessage") && /^\+?\d{6,}$/.test(query)) return {
+		ok: true,
+		target: {
+			to: preserveTargetCase(params.channel, raw, normalized),
+			kind,
+			display: stripTargetPrefixes(raw),
+			source: "normalized"
+		}
+	};
+	return {
+		ok: false,
+		error: unknownTargetError(providerLabel, raw, hint)
+	};
+}
+async function lookupDirectoryDisplay(params) {
+	const normalized = normalizeTargetForProvider(params.channel, params.targetId) ?? params.targetId;
+	const [groups, users] = await Promise.all([getDirectoryEntries({
+		cfg: params.cfg,
+		channel: params.channel,
+		accountId: params.accountId,
+		kind: "group",
+		runtime: params.runtime,
+		preferLiveOnMiss: false
+	}), getDirectoryEntries({
+		cfg: params.cfg,
+		channel: params.channel,
+		accountId: params.accountId,
+		kind: "user",
+		runtime: params.runtime,
+		preferLiveOnMiss: false
+	})]);
+	const findMatch = (candidates) => candidates.find((candidate) => normalizeDirectoryEntryId(params.channel, candidate) === normalized);
+	const entry = findMatch(groups) ?? findMatch(users);
+	return entry?.name ?? entry?.handle ?? void 0;
+}
+
+//#endregion
+//#region src/infra/outbound/outbound-session.ts
+const SLACK_CHANNEL_TYPE_CACHE = /* @__PURE__ */ new Map();
+function normalizeThreadId(value) {
+	if (value == null) return;
+	if (typeof value === "number") {
+		if (!Number.isFinite(value)) return;
+		return String(Math.trunc(value));
+	}
+	const trimmed = value.trim();
+	return trimmed ? trimmed : void 0;
+}
+function stripProviderPrefix(raw, channel) {
+	const trimmed = raw.trim();
+	const lower = trimmed.toLowerCase();
+	const prefix = `${channel.toLowerCase()}:`;
+	if (lower.startsWith(prefix)) return trimmed.slice(prefix.length).trim();
+	return trimmed;
+}
+function stripKindPrefix(raw) {
+	return raw.replace(/^(user|channel|group|conversation|room|dm):/i, "").trim();
+}
+function inferPeerKind(params) {
+	const resolvedKind = params.resolvedTarget?.kind;
+	if (resolvedKind === "user") return "direct";
+	if (resolvedKind === "channel") return "channel";
+	if (resolvedKind === "group") {
+		const chatTypes = getChannelPlugin(params.channel)?.capabilities?.chatTypes ?? [];
+		const supportsChannel = chatTypes.includes("channel");
+		const supportsGroup = chatTypes.includes("group");
+		if (supportsChannel && !supportsGroup) return "channel";
+		return "group";
+	}
+	return "direct";
+}
+function buildBaseSessionKey(params) {
+	return buildAgentSessionKey({
+		agentId: params.agentId,
+		channel: params.channel,
+		accountId: params.accountId,
+		peer: params.peer,
+		dmScope: params.cfg.session?.dmScope ?? "main",
+		identityLinks: params.cfg.session?.identityLinks
+	});
+}
+async function resolveSlackChannelType(params) {
+	const channelId = params.channelId.trim();
+	if (!channelId) return "unknown";
+	const cached = SLACK_CHANNEL_TYPE_CACHE.get(`${params.accountId ?? "default"}:${channelId}`);
+	if (cached) return cached;
+	const account = resolveSlackAccount({
+		cfg: params.cfg,
+		accountId: params.accountId
+	});
+	const groupChannels = normalizeAllowListLower(account.dm?.groupChannels);
+	const channelIdLower = channelId.toLowerCase();
+	if (groupChannels.includes(channelIdLower) || groupChannels.includes(`slack:${channelIdLower}`) || groupChannels.includes(`channel:${channelIdLower}`) || groupChannels.includes(`group:${channelIdLower}`) || groupChannels.includes(`mpim:${channelIdLower}`)) {
+		SLACK_CHANNEL_TYPE_CACHE.set(`${account.accountId}:${channelId}`, "group");
+		return "group";
+	}
+	if (Object.keys(account.channels ?? {}).some((key) => {
+		const normalized = key.trim().toLowerCase();
+		return normalized === channelIdLower || normalized === `channel:${channelIdLower}` || normalized.replace(/^#/, "") === channelIdLower;
+	})) {
+		SLACK_CHANNEL_TYPE_CACHE.set(`${account.accountId}:${channelId}`, "channel");
+		return "channel";
+	}
+	const token = account.botToken?.trim() || (typeof account.config.userToken === "string" ? account.config.userToken.trim() : "");
+	if (!token) {
+		SLACK_CHANNEL_TYPE_CACHE.set(`${account.accountId}:${channelId}`, "unknown");
+		return "unknown";
+	}
+	try {
+		const channel = (await createSlackWebClient(token).conversations.info({ channel: channelId })).channel;
+		const type = channel?.is_im ? "dm" : channel?.is_mpim ? "group" : "channel";
+		SLACK_CHANNEL_TYPE_CACHE.set(`${account.accountId}:${channelId}`, type);
+		return type;
+	} catch {
+		SLACK_CHANNEL_TYPE_CACHE.set(`${account.accountId}:${channelId}`, "unknown");
+		return "unknown";
+	}
+}
+async function resolveSlackSession(params) {
+	const parsed = parseSlackTarget(params.target, { defaultKind: "channel" });
+	if (!parsed) return null;
+	const isDm = parsed.kind === "user";
+	let peerKind = isDm ? "direct" : "channel";
+	if (!isDm && /^G/i.test(parsed.id)) {
+		const channelType = await resolveSlackChannelType({
+			cfg: params.cfg,
+			accountId: params.accountId,
+			channelId: parsed.id
+		});
+		if (channelType === "group") peerKind = "group";
+		if (channelType === "dm") peerKind = "direct";
+	}
+	const peer = {
+		kind: peerKind,
+		id: parsed.id
+	};
+	const baseSessionKey = buildBaseSessionKey({
+		cfg: params.cfg,
+		agentId: params.agentId,
+		channel: "slack",
+		accountId: params.accountId,
+		peer
+	});
+	const threadId = normalizeThreadId(params.threadId ?? params.replyToId);
+	return {
+		sessionKey: resolveThreadSessionKeys({
+			baseSessionKey,
+			threadId
+		}).sessionKey,
+		baseSessionKey,
+		peer,
+		chatType: peerKind === "direct" ? "direct" : "channel",
+		from: peerKind === "direct" ? `slack:${parsed.id}` : peerKind === "group" ? `slack:group:${parsed.id}` : `slack:channel:${parsed.id}`,
+		to: peerKind === "direct" ? `user:${parsed.id}` : `channel:${parsed.id}`,
+		threadId
+	};
+}
+function resolveDiscordSession(params) {
+	const parsed = parseDiscordTarget(params.target, { defaultKind: "channel" });
+	if (!parsed) return null;
+	const isDm = parsed.kind === "user";
+	const peer = {
+		kind: isDm ? "direct" : "channel",
+		id: parsed.id
+	};
+	const baseSessionKey = buildBaseSessionKey({
+		cfg: params.cfg,
+		agentId: params.agentId,
+		channel: "discord",
+		accountId: params.accountId,
+		peer
+	});
+	const explicitThreadId = normalizeThreadId(params.threadId);
+	return {
+		sessionKey: resolveThreadSessionKeys({
+			baseSessionKey,
+			threadId: explicitThreadId ?? normalizeThreadId(params.replyToId),
+			useSuffix: false
+		}).sessionKey,
+		baseSessionKey,
+		peer,
+		chatType: isDm ? "direct" : "channel",
+		from: isDm ? `discord:${parsed.id}` : `discord:channel:${parsed.id}`,
+		to: isDm ? `user:${parsed.id}` : `channel:${parsed.id}`,
+		threadId: explicitThreadId ?? void 0
+	};
+}
+function resolveTelegramSession(params) {
+	const parsed = parseTelegramTarget(params.target);
+	const chatId = parsed.chatId.trim();
+	if (!chatId) return null;
+	const parsedThreadId = parsed.messageThreadId;
+	const fallbackThreadId = normalizeThreadId(params.threadId);
+	const resolvedThreadId = parsedThreadId ?? (fallbackThreadId ? Number.parseInt(fallbackThreadId, 10) : void 0);
+	const chatType = resolveTelegramTargetChatType(params.target);
+	const isGroup = chatType === "group" || chatType === "unknown" && params.resolvedTarget?.kind && params.resolvedTarget.kind !== "user";
+	const peerId = isGroup ? buildTelegramGroupPeerId(chatId, resolvedThreadId) : chatId;
+	const peer = {
+		kind: isGroup ? "group" : "direct",
+		id: peerId
+	};
+	const baseSessionKey = buildBaseSessionKey({
+		cfg: params.cfg,
+		agentId: params.agentId,
+		channel: "telegram",
+		accountId: params.accountId,
+		peer
+	});
+	return {
+		sessionKey: baseSessionKey,
+		baseSessionKey,
+		peer,
+		chatType: isGroup ? "group" : "direct",
+		from: isGroup ? `telegram:group:${peerId}` : `telegram:${chatId}`,
+		to: `telegram:${chatId}`,
+		threadId: resolvedThreadId
+	};
+}
+function resolveWhatsAppSession(params) {
+	const normalized = normalizeWhatsAppTarget(params.target);
+	if (!normalized) return null;
+	const isGroup = isWhatsAppGroupJid(normalized);
+	const peer = {
+		kind: isGroup ? "group" : "direct",
+		id: normalized
+	};
+	const baseSessionKey = buildBaseSessionKey({
+		cfg: params.cfg,
+		agentId: params.agentId,
+		channel: "whatsapp",
+		accountId: params.accountId,
+		peer
+	});
+	return {
+		sessionKey: baseSessionKey,
+		baseSessionKey,
+		peer,
+		chatType: isGroup ? "group" : "direct",
+		from: normalized,
+		to: normalized
+	};
+}
+function resolveSignalSession(params) {
+	const stripped = stripProviderPrefix(params.target, "signal");
+	const lowered = stripped.toLowerCase();
+	if (lowered.startsWith("group:")) {
+		const groupId = stripped.slice(6).trim();
+		if (!groupId) return null;
+		const peer = {
+			kind: "group",
+			id: groupId
+		};
+		const baseSessionKey = buildBaseSessionKey({
+			cfg: params.cfg,
+			agentId: params.agentId,
+			channel: "signal",
+			accountId: params.accountId,
+			peer
+		});
+		return {
+			sessionKey: baseSessionKey,
+			baseSessionKey,
+			peer,
+			chatType: "group",
+			from: `group:${groupId}`,
+			to: `group:${groupId}`
+		};
+	}
+	let recipient = stripped.trim();
+	if (lowered.startsWith("username:")) recipient = stripped.slice(9).trim();
+	else if (lowered.startsWith("u:")) recipient = stripped.slice(2).trim();
+	if (!recipient) return null;
+	const uuidCandidate = recipient.toLowerCase().startsWith("uuid:") ? recipient.slice(5) : recipient;
+	const sender = resolveSignalSender({
+		sourceUuid: looksLikeUuid(uuidCandidate) ? uuidCandidate : null,
+		sourceNumber: looksLikeUuid(uuidCandidate) ? null : recipient
+	});
+	const peerId = sender ? resolveSignalPeerId(sender) : recipient;
+	const displayRecipient = sender ? resolveSignalRecipient(sender) : recipient;
+	const peer = {
+		kind: "direct",
+		id: peerId
+	};
+	const baseSessionKey = buildBaseSessionKey({
+		cfg: params.cfg,
+		agentId: params.agentId,
+		channel: "signal",
+		accountId: params.accountId,
+		peer
+	});
+	return {
+		sessionKey: baseSessionKey,
+		baseSessionKey,
+		peer,
+		chatType: "direct",
+		from: `signal:${displayRecipient}`,
+		to: `signal:${displayRecipient}`
+	};
+}
+function resolveIMessageSession(params) {
+	const parsed = parseIMessageTarget(params.target);
+	if (parsed.kind === "handle") {
+		const handle = normalizeIMessageHandle(parsed.to);
+		if (!handle) return null;
+		const peer = {
+			kind: "direct",
+			id: handle
+		};
+		const baseSessionKey = buildBaseSessionKey({
+			cfg: params.cfg,
+			agentId: params.agentId,
+			channel: "imessage",
+			accountId: params.accountId,
+			peer
+		});
+		return {
+			sessionKey: baseSessionKey,
+			baseSessionKey,
+			peer,
+			chatType: "direct",
+			from: `imessage:${handle}`,
+			to: `imessage:${handle}`
+		};
+	}
+	const peerId = parsed.kind === "chat_id" ? String(parsed.chatId) : parsed.kind === "chat_guid" ? parsed.chatGuid : parsed.chatIdentifier;
+	if (!peerId) return null;
+	const peer = {
+		kind: "group",
+		id: peerId
+	};
+	const baseSessionKey = buildBaseSessionKey({
+		cfg: params.cfg,
+		agentId: params.agentId,
+		channel: "imessage",
+		accountId: params.accountId,
+		peer
+	});
+	const toPrefix = parsed.kind === "chat_id" ? "chat_id" : parsed.kind === "chat_guid" ? "chat_guid" : "chat_identifier";
+	return {
+		sessionKey: baseSessionKey,
+		baseSessionKey,
+		peer,
+		chatType: "group",
+		from: `imessage:group:${peerId}`,
+		to: `${toPrefix}:${peerId}`
+	};
+}
+function resolveMatrixSession(params) {
+	const stripped = stripProviderPrefix(params.target, "matrix");
+	const isUser = params.resolvedTarget?.kind === "user" || stripped.startsWith("@") || /^user:/i.test(stripped);
+	const rawId = stripKindPrefix(stripped);
+	if (!rawId) return null;
+	const peer = {
+		kind: isUser ? "direct" : "channel",
+		id: rawId
+	};
+	const baseSessionKey = buildBaseSessionKey({
+		cfg: params.cfg,
+		agentId: params.agentId,
+		channel: "matrix",
+		accountId: params.accountId,
+		peer
+	});
+	return {
+		sessionKey: baseSessionKey,
+		baseSessionKey,
+		peer,
+		chatType: isUser ? "direct" : "channel",
+		from: isUser ? `matrix:${rawId}` : `matrix:channel:${rawId}`,
+		to: `room:${rawId}`
+	};
+}
+function resolveMSTeamsSession(params) {
+	let trimmed = params.target.trim();
+	if (!trimmed) return null;
+	trimmed = trimmed.replace(/^(msteams|teams):/i, "").trim();
+	const isUser = trimmed.toLowerCase().startsWith("user:");
+	const rawId = stripKindPrefix(trimmed);
+	if (!rawId) return null;
+	const conversationId = rawId.split(";")[0] ?? rawId;
+	const isChannel = !isUser && /@thread\.tacv2/i.test(conversationId);
+	const peer = {
+		kind: isUser ? "direct" : isChannel ? "channel" : "group",
+		id: conversationId
+	};
+	const baseSessionKey = buildBaseSessionKey({
+		cfg: params.cfg,
+		agentId: params.agentId,
+		channel: "msteams",
+		accountId: params.accountId,
+		peer
+	});
+	return {
+		sessionKey: baseSessionKey,
+		baseSessionKey,
+		peer,
+		chatType: isUser ? "direct" : isChannel ? "channel" : "group",
+		from: isUser ? `msteams:${conversationId}` : isChannel ? `msteams:channel:${conversationId}` : `msteams:group:${conversationId}`,
+		to: isUser ? `user:${conversationId}` : `conversation:${conversationId}`
+	};
+}
+function resolveMattermostSession(params) {
+	let trimmed = params.target.trim();
+	if (!trimmed) return null;
+	trimmed = trimmed.replace(/^mattermost:/i, "").trim();
+	const isUser = trimmed.toLowerCase().startsWith("user:") || trimmed.startsWith("@");
+	if (trimmed.startsWith("@")) trimmed = trimmed.slice(1).trim();
+	const rawId = stripKindPrefix(trimmed);
+	if (!rawId) return null;
+	const peer = {
+		kind: isUser ? "direct" : "channel",
+		id: rawId
+	};
+	const baseSessionKey = buildBaseSessionKey({
+		cfg: params.cfg,
+		agentId: params.agentId,
+		channel: "mattermost",
+		accountId: params.accountId,
+		peer
+	});
+	const threadId = normalizeThreadId(params.replyToId ?? params.threadId);
+	return {
+		sessionKey: resolveThreadSessionKeys({
+			baseSessionKey,
+			threadId
+		}).sessionKey,
+		baseSessionKey,
+		peer,
+		chatType: isUser ? "direct" : "channel",
+		from: isUser ? `mattermost:${rawId}` : `mattermost:channel:${rawId}`,
+		to: isUser ? `user:${rawId}` : `channel:${rawId}`,
+		threadId
+	};
+}
+function resolveBlueBubblesSession(params) {
+	const stripped = stripProviderPrefix(params.target, "bluebubbles");
+	const lower = stripped.toLowerCase();
+	const isGroup = lower.startsWith("chat_id:") || lower.startsWith("chat_guid:") || lower.startsWith("chat_identifier:") || lower.startsWith("group:");
+	const rawPeerId = isGroup ? stripKindPrefix(stripped) : stripped.replace(/^(imessage|sms|auto):/i, "");
+	const peerId = isGroup ? rawPeerId.replace(/^(chat_id|chat_guid|chat_identifier):/i, "") : rawPeerId;
+	if (!peerId) return null;
+	const peer = {
+		kind: isGroup ? "group" : "direct",
+		id: peerId
+	};
+	const baseSessionKey = buildBaseSessionKey({
+		cfg: params.cfg,
+		agentId: params.agentId,
+		channel: "bluebubbles",
+		accountId: params.accountId,
+		peer
+	});
+	return {
+		sessionKey: baseSessionKey,
+		baseSessionKey,
+		peer,
+		chatType: isGroup ? "group" : "direct",
+		from: isGroup ? `group:${peerId}` : `bluebubbles:${peerId}`,
+		to: `bluebubbles:${stripped}`
+	};
+}
+function resolveNextcloudTalkSession(params) {
+	let trimmed = params.target.trim();
+	if (!trimmed) return null;
+	trimmed = trimmed.replace(/^(nextcloud-talk|nc-talk|nc):/i, "").trim();
+	trimmed = trimmed.replace(/^room:/i, "").trim();
+	if (!trimmed) return null;
+	const peer = {
+		kind: "group",
+		id: trimmed
+	};
+	const baseSessionKey = buildBaseSessionKey({
+		cfg: params.cfg,
+		agentId: params.agentId,
+		channel: "nextcloud-talk",
+		accountId: params.accountId,
+		peer
+	});
+	return {
+		sessionKey: baseSessionKey,
+		baseSessionKey,
+		peer,
+		chatType: "group",
+		from: `nextcloud-talk:room:${trimmed}`,
+		to: `nextcloud-talk:${trimmed}`
+	};
+}
+function resolveZaloSession(params) {
+	return resolveZaloLikeSession(params, "zalo", /^(zl):/i);
+}
+function resolveZaloLikeSession(params, channel, aliasPrefix) {
+	const trimmed = stripProviderPrefix(params.target, channel).replace(aliasPrefix, "").trim();
+	if (!trimmed) return null;
+	const isGroup = trimmed.toLowerCase().startsWith("group:");
+	const peerId = stripKindPrefix(trimmed);
+	const peer = {
+		kind: isGroup ? "group" : "direct",
+		id: peerId
+	};
+	const baseSessionKey = buildBaseSessionKey({
+		cfg: params.cfg,
+		agentId: params.agentId,
+		channel,
+		accountId: params.accountId,
+		peer
+	});
+	return {
+		sessionKey: baseSessionKey,
+		baseSessionKey,
+		peer,
+		chatType: isGroup ? "group" : "direct",
+		from: isGroup ? `${channel}:group:${peerId}` : `${channel}:${peerId}`,
+		to: `${channel}:${peerId}`
+	};
+}
+function resolveZalouserSession(params) {
+	return resolveZaloLikeSession(params, "zalouser", /^(zlu):/i);
+}
+function resolveNostrSession(params) {
+	const trimmed = stripProviderPrefix(params.target, "nostr").trim();
+	if (!trimmed) return null;
+	const peer = {
+		kind: "direct",
+		id: trimmed
+	};
+	const baseSessionKey = buildBaseSessionKey({
+		cfg: params.cfg,
+		agentId: params.agentId,
+		channel: "nostr",
+		accountId: params.accountId,
+		peer
+	});
+	return {
+		sessionKey: baseSessionKey,
+		baseSessionKey,
+		peer,
+		chatType: "direct",
+		from: `nostr:${trimmed}`,
+		to: `nostr:${trimmed}`
+	};
+}
+function normalizeTlonShip(raw) {
+	const trimmed = raw.trim();
+	if (!trimmed) return trimmed;
+	return trimmed.startsWith("~") ? trimmed : `~${trimmed}`;
+}
+function resolveTlonSession(params) {
+	let trimmed = stripProviderPrefix(params.target, "tlon");
+	trimmed = trimmed.trim();
+	if (!trimmed) return null;
+	const lower = trimmed.toLowerCase();
+	let isGroup = lower.startsWith("group:") || lower.startsWith("room:") || lower.startsWith("chat/");
+	let peerId = trimmed;
+	if (lower.startsWith("group:") || lower.startsWith("room:")) {
+		peerId = trimmed.replace(/^(group|room):/i, "").trim();
+		if (!peerId.startsWith("chat/")) {
+			const parts = peerId.split("/").filter(Boolean);
+			if (parts.length === 2) peerId = `chat/${normalizeTlonShip(parts[0])}/${parts[1]}`;
+		}
+		isGroup = true;
+	} else if (lower.startsWith("dm:")) {
+		peerId = normalizeTlonShip(trimmed.slice(3));
+		isGroup = false;
+	} else if (lower.startsWith("chat/")) {
+		peerId = trimmed;
+		isGroup = true;
+	} else if (trimmed.includes("/")) {
+		const parts = trimmed.split("/").filter(Boolean);
+		if (parts.length === 2) {
+			peerId = `chat/${normalizeTlonShip(parts[0])}/${parts[1]}`;
+			isGroup = true;
+		}
+	} else peerId = normalizeTlonShip(trimmed);
+	const peer = {
+		kind: isGroup ? "group" : "direct",
+		id: peerId
+	};
+	const baseSessionKey = buildBaseSessionKey({
+		cfg: params.cfg,
+		agentId: params.agentId,
+		channel: "tlon",
+		accountId: params.accountId,
+		peer
+	});
+	return {
+		sessionKey: baseSessionKey,
+		baseSessionKey,
+		peer,
+		chatType: isGroup ? "group" : "direct",
+		from: isGroup ? `tlon:group:${peerId}` : `tlon:${peerId}`,
+		to: `tlon:${peerId}`
+	};
+}
+/**
+* Feishu ID formats:
+* - oc_xxx: chat_id (group chat)
+* - ou_xxx: user open_id (DM)
+* - on_xxx: user union_id (DM)
+* - cli_xxx: app_id (not a valid send target)
+*/
+function resolveFeishuSession(params) {
+	let trimmed = stripProviderPrefix(params.target, "feishu");
+	trimmed = stripProviderPrefix(trimmed, "lark").trim();
+	if (!trimmed) return null;
+	const lower = trimmed.toLowerCase();
+	let isGroup = false;
+	if (lower.startsWith("group:") || lower.startsWith("chat:")) {
+		trimmed = trimmed.replace(/^(group|chat):/i, "").trim();
+		isGroup = true;
+	} else if (lower.startsWith("user:") || lower.startsWith("dm:")) {
+		trimmed = trimmed.replace(/^(user|dm):/i, "").trim();
+		isGroup = false;
+	}
+	const idLower = trimmed.toLowerCase();
+	if (idLower.startsWith("oc_")) isGroup = true;
+	else if (idLower.startsWith("ou_") || idLower.startsWith("on_")) isGroup = false;
+	const peer = {
+		kind: isGroup ? "group" : "direct",
+		id: trimmed
+	};
+	const baseSessionKey = buildBaseSessionKey({
+		cfg: params.cfg,
+		agentId: params.agentId,
+		channel: "feishu",
+		accountId: params.accountId,
+		peer
+	});
+	return {
+		sessionKey: baseSessionKey,
+		baseSessionKey,
+		peer,
+		chatType: isGroup ? "group" : "direct",
+		from: isGroup ? `feishu:group:${trimmed}` : `feishu:${trimmed}`,
+		to: trimmed
+	};
+}
+function resolveFallbackSession(params) {
+	const trimmed = stripProviderPrefix(params.target, params.channel).trim();
+	if (!trimmed) return null;
+	const peerKind = inferPeerKind({
+		channel: params.channel,
+		resolvedTarget: params.resolvedTarget
+	});
+	const peerId = stripKindPrefix(trimmed);
+	if (!peerId) return null;
+	const peer = {
+		kind: peerKind,
+		id: peerId
+	};
+	const baseSessionKey = buildBaseSessionKey({
+		cfg: params.cfg,
+		agentId: params.agentId,
+		channel: params.channel,
+		peer
+	});
+	return {
+		sessionKey: baseSessionKey,
+		baseSessionKey,
+		peer,
+		chatType: peerKind === "direct" ? "direct" : peerKind === "channel" ? "channel" : "group",
+		from: peerKind === "direct" ? `${params.channel}:${peerId}` : `${params.channel}:${peerKind}:${peerId}`,
+		to: `${peerKind === "direct" ? "user" : "channel"}:${peerId}`
+	};
+}
+async function resolveOutboundSessionRoute(params) {
+	const target = params.target.trim();
+	if (!target) return null;
+	switch (params.channel) {
+		case "slack": return await resolveSlackSession({
+			...params,
+			target
+		});
+		case "discord": return resolveDiscordSession({
+			...params,
+			target
+		});
+		case "telegram": return resolveTelegramSession({
+			...params,
+			target
+		});
+		case "whatsapp": return resolveWhatsAppSession({
+			...params,
+			target
+		});
+		case "signal": return resolveSignalSession({
+			...params,
+			target
+		});
+		case "imessage": return resolveIMessageSession({
+			...params,
+			target
+		});
+		case "matrix": return resolveMatrixSession({
+			...params,
+			target
+		});
+		case "msteams": return resolveMSTeamsSession({
+			...params,
+			target
+		});
+		case "mattermost": return resolveMattermostSession({
+			...params,
+			target
+		});
+		case "bluebubbles": return resolveBlueBubblesSession({
+			...params,
+			target
+		});
+		case "nextcloud-talk": return resolveNextcloudTalkSession({
+			...params,
+			target
+		});
+		case "zalo": return resolveZaloSession({
+			...params,
+			target
+		});
+		case "zalouser": return resolveZalouserSession({
+			...params,
+			target
+		});
+		case "nostr": return resolveNostrSession({
+			...params,
+			target
+		});
+		case "tlon": return resolveTlonSession({
+			...params,
+			target
+		});
+		case "feishu": return resolveFeishuSession({
+			...params,
+			target
+		});
+		default: return resolveFallbackSession({
+			...params,
+			target
+		});
+	}
+}
+async function ensureOutboundSessionEntry(params) {
+	const storePath = resolveStorePath(params.cfg.session?.store, { agentId: params.agentId });
+	const ctx = {
+		From: params.route.from,
+		To: params.route.to,
+		SessionKey: params.route.sessionKey,
+		AccountId: params.accountId ?? void 0,
+		ChatType: params.route.chatType,
+		Provider: params.channel,
+		Surface: params.channel,
+		MessageThreadId: params.route.threadId,
+		OriginatingChannel: params.channel,
+		OriginatingTo: params.route.to
+	};
+	try {
+		await recordSessionMetaFromInbound({
+			storePath,
+			sessionKey: params.route.sessionKey,
+			ctx
+		});
+	} catch {}
+}
+
+//#endregion
+//#region src/channels/plugins/message-actions.ts
+const trustedRequesterRequiredByChannel = { discord: new Set([
+	"timeout",
+	"kick",
+	"ban"
+]) };
+function requiresTrustedRequesterSender(ctx) {
+	const actions = trustedRequesterRequiredByChannel[ctx.channel];
+	return Boolean(actions?.has(ctx.action) && ctx.toolContext);
+}
+function listChannelMessageActions(cfg) {
+	const actions = new Set(["send", "broadcast"]);
+	for (const plugin of listChannelPlugins()) {
+		const list = plugin.actions?.listActions?.({ cfg });
+		if (!list) continue;
+		for (const action of list) actions.add(action);
+	}
+	return Array.from(actions);
+}
+function supportsChannelMessageButtons(cfg) {
+	return supportsMessageFeature(cfg, (actions) => actions?.supportsButtons?.({ cfg }) === true);
+}
+function supportsChannelMessageButtonsForChannel(params) {
+	return supportsMessageFeatureForChannel(params, (actions) => actions.supportsButtons?.(params) === true);
+}
+function supportsChannelMessageCards(cfg) {
+	return supportsMessageFeature(cfg, (actions) => actions?.supportsCards?.({ cfg }) === true);
+}
+function supportsChannelMessageCardsForChannel(params) {
+	return supportsMessageFeatureForChannel(params, (actions) => actions.supportsCards?.(params) === true);
+}
+function supportsMessageFeature(cfg, check) {
+	for (const plugin of listChannelPlugins()) if (plugin.actions && check(plugin.actions)) return true;
+	return false;
+}
+function supportsMessageFeatureForChannel(params, check) {
+	if (!params.channel) return false;
+	const plugin = getChannelPlugin(params.channel);
+	return plugin?.actions ? check(plugin.actions) : false;
+}
+async function dispatchChannelMessageAction(ctx) {
+	if (requiresTrustedRequesterSender(ctx) && !ctx.requesterSenderId?.trim()) throw new Error(`Trusted sender identity is required for ${ctx.channel}:${ctx.action} in tool-driven contexts.`);
+	const plugin = getChannelPlugin(ctx.channel);
+	if (!plugin?.actions?.handleAction) return null;
+	if (plugin.actions.supportsAction && !plugin.actions.supportsAction({ action: ctx.action })) return null;
+	return await plugin.actions.handleAction(ctx);
+}
+
+//#endregion
+//#region src/infra/outbound/message-action-spec.ts
+const MESSAGE_ACTION_TARGET_MODE = {
+	send: "to",
+	broadcast: "none",
+	poll: "to",
+	react: "to",
+	reactions: "to",
+	read: "to",
+	edit: "to",
+	unsend: "to",
+	reply: "to",
+	sendWithEffect: "to",
+	renameGroup: "to",
+	setGroupIcon: "to",
+	addParticipant: "to",
+	removeParticipant: "to",
+	leaveGroup: "to",
+	sendAttachment: "to",
+	delete: "to",
+	pin: "to",
+	unpin: "to",
+	"list-pins": "to",
+	permissions: "to",
+	"thread-create": "to",
+	"thread-list": "none",
+	"thread-reply": "to",
+	search: "none",
+	sticker: "to",
+	"sticker-search": "none",
+	"member-info": "none",
+	"role-info": "none",
+	"emoji-list": "none",
+	"emoji-upload": "none",
+	"sticker-upload": "none",
+	"role-add": "none",
+	"role-remove": "none",
+	"channel-info": "channelId",
+	"channel-list": "none",
+	"channel-create": "none",
+	"channel-edit": "channelId",
+	"channel-delete": "channelId",
+	"channel-move": "channelId",
+	"category-create": "none",
+	"category-edit": "none",
+	"category-delete": "none",
+	"topic-create": "to",
+	"voice-status": "none",
+	"event-list": "none",
+	"event-create": "none",
+	timeout: "none",
+	kick: "none",
+	ban: "none",
+	"set-presence": "none"
+};
+const ACTION_TARGET_ALIASES = {
+	unsend: ["messageId"],
+	edit: ["messageId"],
+	react: [
+		"chatGuid",
+		"chatIdentifier",
+		"chatId"
+	],
+	renameGroup: [
+		"chatGuid",
+		"chatIdentifier",
+		"chatId"
+	],
+	setGroupIcon: [
+		"chatGuid",
+		"chatIdentifier",
+		"chatId"
+	],
+	addParticipant: [
+		"chatGuid",
+		"chatIdentifier",
+		"chatId"
+	],
+	removeParticipant: [
+		"chatGuid",
+		"chatIdentifier",
+		"chatId"
+	],
+	leaveGroup: [
+		"chatGuid",
+		"chatIdentifier",
+		"chatId"
+	]
+};
+function actionRequiresTarget(action) {
+	return MESSAGE_ACTION_TARGET_MODE[action] !== "none";
+}
+function actionHasTarget(action, params) {
+	if (typeof params.to === "string" ? params.to.trim() : "") return true;
+	if (typeof params.channelId === "string" ? params.channelId.trim() : "") return true;
+	const aliases = ACTION_TARGET_ALIASES[action];
+	if (!aliases) return false;
+	return aliases.some((alias) => {
+		const value = params[alias];
+		if (typeof value === "string") return value.trim().length > 0;
+		if (typeof value === "number") return Number.isFinite(value);
+		return false;
+	});
+}
+
+//#endregion
+//#region src/infra/outbound/channel-target.ts
+const CHANNEL_TARGET_DESCRIPTION = "Recipient/channel: E.164 for WhatsApp/Signal, Telegram chat id/@username, Discord/Slack channel/user, or iMessage handle/chat_id";
+const CHANNEL_TARGETS_DESCRIPTION = "Recipient/channel targets (same format as --target); accepts ids or names when the directory is available.";
+function applyTargetToParams(params) {
+	const target = typeof params.args.target === "string" ? params.args.target.trim() : "";
+	const hasLegacyTo = typeof params.args.to === "string";
+	const hasLegacyChannelId = typeof params.args.channelId === "string";
+	const mode = MESSAGE_ACTION_TARGET_MODE[params.action] ?? "none";
+	if (mode !== "none") {
+		if (hasLegacyTo || hasLegacyChannelId) throw new Error("Use `target` instead of `to`/`channelId`.");
+	} else if (hasLegacyTo) throw new Error("Use `target` for actions that accept a destination.");
+	if (!target) return;
+	if (mode === "channelId") {
+		params.args.channelId = target;
+		return;
+	}
+	if (mode === "to") {
+		params.args.to = target;
+		return;
+	}
+	throw new Error(`Action ${params.action} does not accept a target.`);
+}
+
+//#endregion
+//#region src/infra/outbound/message-action-params.ts
+function readBooleanParam(params, key) {
+	const raw = params[key];
+	if (typeof raw === "boolean") return raw;
+	if (typeof raw === "string") {
+		const trimmed = raw.trim().toLowerCase();
+		if (trimmed === "true") return true;
+		if (trimmed === "false") return false;
+	}
+}
+function resolveSlackAutoThreadId(params) {
+	const context = params.toolContext;
+	if (!context?.currentThreadTs || !context.currentChannelId) return;
+	if (context.replyToMode !== "all" && context.replyToMode !== "first") return;
+	const parsedTarget = parseSlackTarget(params.to, { defaultKind: "channel" });
+	if (!parsedTarget || parsedTarget.kind !== "channel") return;
+	if (parsedTarget.id.toLowerCase() !== context.currentChannelId.toLowerCase()) return;
+	if (context.replyToMode === "first" && context.hasRepliedRef?.value) return;
+	return context.currentThreadTs;
+}
+/**
+* Auto-inject Telegram forum topic thread ID when the message tool targets
+* the same chat the session originated from.  Mirrors the Slack auto-threading
+* pattern so media, buttons, and other tool-sent messages land in the correct
+* topic instead of the General Topic.
+*
+* Unlike Slack, we do not gate on `replyToMode` here: Telegram forum topics
+* are persistent sub-channels (not ephemeral reply threads), so auto-injection
+* should always apply when the target chat matches.
+*/
+function resolveTelegramAutoThreadId(params) {
+	const context = params.toolContext;
+	if (!context?.currentThreadTs || !context.currentChannelId) return;
+	const parsedTo = parseTelegramTarget(params.to);
+	const parsedChannel = parseTelegramTarget(context.currentChannelId);
+	if (parsedTo.chatId.toLowerCase() !== parsedChannel.chatId.toLowerCase()) return;
+	return context.currentThreadTs;
+}
+function resolveAttachmentMaxBytes(params) {
+	const accountId = typeof params.accountId === "string" ? params.accountId.trim() : "";
+	const channelCfg = params.cfg.channels?.[params.channel];
+	const channelObj = channelCfg && typeof channelCfg === "object" ? channelCfg : void 0;
+	const channelMediaMax = typeof channelObj?.mediaMaxMb === "number" ? channelObj.mediaMaxMb : void 0;
+	const accountsObj = channelObj?.accounts && typeof channelObj.accounts === "object" ? channelObj.accounts : void 0;
+	const accountCfg = accountId && accountsObj ? accountsObj[accountId] : void 0;
+	const accountMediaMax = accountCfg && typeof accountCfg === "object" ? accountCfg.mediaMaxMb : void 0;
+	const limitMb = (typeof accountMediaMax === "number" ? accountMediaMax : void 0) ?? channelMediaMax ?? params.cfg.agents?.defaults?.mediaMaxMb;
+	return typeof limitMb === "number" ? limitMb * 1024 * 1024 : void 0;
+}
+function inferAttachmentFilename(params) {
+	const mediaHint = params.mediaHint?.trim();
+	if (mediaHint) try {
+		if (mediaHint.startsWith("file://")) {
+			const filePath = fileURLToPath(mediaHint);
+			const base = path.basename(filePath);
+			if (base) return base;
+		} else if (/^https?:\/\//i.test(mediaHint)) {
+			const url = new URL(mediaHint);
+			const base = path.basename(url.pathname);
+			if (base) return base;
+		} else {
+			const base = path.basename(mediaHint);
+			if (base) return base;
+		}
+	} catch {}
+	const ext = params.contentType ? extensionForMime(params.contentType) : void 0;
+	return ext ? `attachment${ext}` : "attachment";
+}
+function normalizeBase64Payload(params) {
+	if (!params.base64) return {
+		base64: params.base64,
+		contentType: params.contentType
+	};
+	const match = /^data:([^;]+);base64,(.*)$/i.exec(params.base64.trim());
+	if (!match) return {
+		base64: params.base64,
+		contentType: params.contentType
+	};
+	const [, mime, payload] = match;
+	return {
+		base64: payload,
+		contentType: params.contentType ?? mime
+	};
+}
+function resolveAttachmentMediaPolicy(params) {
+	const sandboxRoot = params.sandboxRoot?.trim();
+	if (sandboxRoot) return {
+		mode: "sandbox",
+		sandboxRoot
+	};
+	return {
+		mode: "host",
+		localRoots: params.mediaLocalRoots
+	};
+}
+function buildAttachmentMediaLoadOptions(params) {
+	if (params.policy.mode === "sandbox") return {
+		maxBytes: params.maxBytes,
+		sandboxValidated: true,
+		readFile: (filePath) => fsp.readFile(filePath)
+	};
+	return {
+		maxBytes: params.maxBytes,
+		localRoots: params.policy.localRoots
+	};
+}
+async function hydrateAttachmentPayload(params) {
+	const contentTypeParam = params.contentTypeParam ?? void 0;
+	const rawBuffer = readStringParam(params.args, "buffer", { trim: false });
+	const normalized = normalizeBase64Payload({
+		base64: rawBuffer,
+		contentType: contentTypeParam ?? void 0
+	});
+	if (normalized.base64 !== rawBuffer && normalized.base64) {
+		params.args.buffer = normalized.base64;
+		if (normalized.contentType && !contentTypeParam) params.args.contentType = normalized.contentType;
+	}
+	const filename = readStringParam(params.args, "filename");
+	const mediaSource = (params.mediaHint ?? void 0) || (params.fileHint ?? void 0);
+	if (!params.dryRun && !readStringParam(params.args, "buffer", { trim: false }) && mediaSource) {
+		const maxBytes = resolveAttachmentMaxBytes({
+			cfg: params.cfg,
+			channel: params.channel,
+			accountId: params.accountId
+		});
+		const media = await loadWebMedia(mediaSource, buildAttachmentMediaLoadOptions({
+			policy: params.mediaPolicy,
+			maxBytes
+		}));
+		params.args.buffer = media.buffer.toString("base64");
+		if (!contentTypeParam && media.contentType) params.args.contentType = media.contentType;
+		if (!filename) params.args.filename = inferAttachmentFilename({
+			mediaHint: media.fileName ?? mediaSource,
+			contentType: media.contentType ?? contentTypeParam ?? void 0
+		});
+	} else if (!filename) params.args.filename = inferAttachmentFilename({
+		mediaHint: mediaSource,
+		contentType: contentTypeParam ?? void 0
+	});
+}
+async function normalizeSandboxMediaList(params) {
+	const normalized = [];
+	const seen = /* @__PURE__ */ new Set();
+	for (const value of params.values) {
+		const raw = value?.trim();
+		if (!raw) continue;
+		if (seen.has(raw)) continue;
+		seen.add(raw);
+		normalized.push(raw);
+	}
+	return normalized;
+}
+async function hydrateAttachmentActionPayload(params) {
+	const mediaHint = readStringParam(params.args, "media", { trim: false });
+	const fileHint = readStringParam(params.args, "path", { trim: false }) ?? readStringParam(params.args, "filePath", { trim: false });
+	const contentTypeParam = readStringParam(params.args, "contentType") ?? readStringParam(params.args, "mimeType");
+	if (params.allowMessageCaptionFallback) {
+		const caption = readStringParam(params.args, "caption", { allowEmpty: true })?.trim();
+		const message = readStringParam(params.args, "message", { allowEmpty: true })?.trim();
+		if (!caption && message) params.args.caption = message;
+	}
+	await hydrateAttachmentPayload({
+		cfg: params.cfg,
+		channel: params.channel,
+		accountId: params.accountId,
+		args: params.args,
+		dryRun: params.dryRun,
+		contentTypeParam,
+		mediaHint,
+		fileHint,
+		mediaPolicy: params.mediaPolicy
+	});
+}
+async function hydrateAttachmentParamsForAction(params) {
+	if (params.action !== "sendAttachment" && params.action !== "setGroupIcon") return;
+	await hydrateAttachmentActionPayload({
+		cfg: params.cfg,
+		channel: params.channel,
+		accountId: params.accountId,
+		args: params.args,
+		dryRun: params.dryRun,
+		mediaPolicy: params.mediaPolicy,
+		allowMessageCaptionFallback: params.action === "sendAttachment"
+	});
+}
+function parseButtonsParam(params) {
+	const raw = params.buttons;
+	if (typeof raw !== "string") return;
+	const trimmed = raw.trim();
+	if (!trimmed) {
+		delete params.buttons;
+		return;
+	}
+	try {
+		params.buttons = JSON.parse(trimmed);
+	} catch {
+		throw new Error("--buttons must be valid JSON");
+	}
+}
+function parseCardParam(params) {
+	const raw = params.card;
+	if (typeof raw !== "string") return;
+	const trimmed = raw.trim();
+	if (!trimmed) {
+		delete params.card;
+		return;
+	}
+	try {
+		params.card = JSON.parse(trimmed);
+	} catch {
+		throw new Error("--card must be valid JSON");
+	}
+}
+function parseComponentsParam(params) {
+	const raw = params.components;
+	if (typeof raw !== "string") return;
+	const trimmed = raw.trim();
+	if (!trimmed) {
+		delete params.components;
+		return;
+	}
+	try {
+		params.components = JSON.parse(trimmed);
+	} catch {
+		throw new Error("--components must be valid JSON");
+	}
+}
+
+//#endregion
+//#region src/discord/ui.ts
+const DEFAULT_DISCORD_ACCENT_COLOR = "#5865F2";
+function normalizeDiscordAccentColor(raw) {
+	const trimmed = (raw ?? "").trim();
+	if (!trimmed) return null;
+	const normalized = trimmed.startsWith("#") ? trimmed : `#${trimmed}`;
+	if (!/^#[0-9a-fA-F]{6}$/.test(normalized)) return null;
+	return normalized.toUpperCase();
+}
+function resolveDiscordAccentColor(params) {
+	return normalizeDiscordAccentColor(resolveDiscordAccount({
+		cfg: params.cfg,
+		accountId: params.accountId
+	}).config.ui?.components?.accentColor) ?? DEFAULT_DISCORD_ACCENT_COLOR;
+}
+var DiscordUiContainer = class extends Container {
+	constructor(params) {
+		const accentColor = normalizeDiscordAccentColor(params.accentColor) ?? resolveDiscordAccentColor({
+			cfg: params.cfg,
+			accountId: params.accountId
+		});
+		super(params.components, {
+			accentColor,
+			spoiler: params.spoiler
+		});
+	}
+};
+
+//#endregion
+//#region src/infra/outbound/channel-adapters.ts
+var CrossContextContainer = class extends DiscordUiContainer {
+	constructor({ originLabel, message, cfg, accountId }) {
+		const trimmed = message.trim();
+		const components = [];
+		if (trimmed) {
+			components.push(new TextDisplay(message));
+			components.push(new Separator({
+				divider: true,
+				spacing: "small"
+			}));
+		}
+		components.push(new TextDisplay(`*From ${originLabel}*`));
+		super({
+			cfg,
+			accountId,
+			components
+		});
+	}
+};
+const DEFAULT_ADAPTER = { supportsComponentsV2: false };
+const DISCORD_ADAPTER = {
+	supportsComponentsV2: true,
+	buildCrossContextComponents: ({ originLabel, message, cfg, accountId }) => [new CrossContextContainer({
+		originLabel,
+		message,
+		cfg,
+		accountId
+	})]
+};
+function getChannelMessageAdapter(channel) {
+	if (channel === "discord") return DISCORD_ADAPTER;
+	return DEFAULT_ADAPTER;
+}
+
+//#endregion
+//#region src/infra/outbound/outbound-policy.ts
+const CONTEXT_GUARDED_ACTIONS = new Set([
+	"send",
+	"poll",
+	"reply",
+	"sendWithEffect",
+	"sendAttachment",
+	"thread-create",
+	"thread-reply",
+	"sticker"
+]);
+const CONTEXT_MARKER_ACTIONS = new Set([
+	"send",
+	"poll",
+	"reply",
+	"sendWithEffect",
+	"sendAttachment",
+	"thread-reply",
+	"sticker"
+]);
+function resolveContextGuardTarget(action, params) {
+	if (!CONTEXT_GUARDED_ACTIONS.has(action)) return;
+	if (action === "thread-reply" || action === "thread-create") {
+		if (typeof params.channelId === "string") return params.channelId;
+		if (typeof params.to === "string") return params.to;
+		return;
+	}
+	if (typeof params.to === "string") return params.to;
+	if (typeof params.channelId === "string") return params.channelId;
+}
+function normalizeTarget(channel, raw) {
+	return normalizeTargetForProvider(channel, raw) ?? raw.trim();
+}
+function isCrossContextTarget(params) {
+	const currentTarget = params.toolContext?.currentChannelId?.trim();
+	if (!currentTarget) return false;
+	const normalizedTarget = normalizeTarget(params.channel, params.target);
+	const normalizedCurrent = normalizeTarget(params.channel, currentTarget);
+	if (!normalizedTarget || !normalizedCurrent) return false;
+	return normalizedTarget !== normalizedCurrent;
+}
+function enforceCrossContextPolicy(params) {
+	const currentTarget = params.toolContext?.currentChannelId?.trim();
+	if (!currentTarget) return;
+	if (!CONTEXT_GUARDED_ACTIONS.has(params.action)) return;
+	if (params.cfg.tools?.message?.allowCrossContextSend) return;
+	const currentProvider = params.toolContext?.currentChannelProvider;
+	const allowWithinProvider = params.cfg.tools?.message?.crossContext?.allowWithinProvider !== false;
+	const allowAcrossProviders = params.cfg.tools?.message?.crossContext?.allowAcrossProviders === true;
+	if (currentProvider && currentProvider !== params.channel) {
+		if (!allowAcrossProviders) throw new Error(`Cross-context messaging denied: action=${params.action} target provider "${params.channel}" while bound to "${currentProvider}".`);
+		return;
+	}
+	if (allowWithinProvider) return;
+	const target = resolveContextGuardTarget(params.action, params.args);
+	if (!target) return;
+	if (!isCrossContextTarget({
+		channel: params.channel,
+		target,
+		toolContext: params.toolContext
+	})) return;
+	throw new Error(`Cross-context messaging denied: action=${params.action} target="${target}" while bound to "${currentTarget}" (channel=${params.channel}).`);
+}
+async function buildCrossContextDecoration(params) {
+	if (!params.toolContext?.currentChannelId) return null;
+	if (params.toolContext.skipCrossContextDecoration) return null;
+	if (!isCrossContextTarget(params)) return null;
+	const markerConfig = params.cfg.tools?.message?.crossContext?.marker;
+	if (markerConfig?.enabled === false) return null;
+	const currentName = await lookupDirectoryDisplay({
+		cfg: params.cfg,
+		channel: params.channel,
+		targetId: params.toolContext.currentChannelId,
+		accountId: params.accountId ?? void 0
+	}) ?? params.toolContext.currentChannelId;
+	const originLabel = formatTargetDisplay({
+		channel: params.channel,
+		target: params.toolContext.currentChannelId,
+		display: currentName
+	});
+	const prefixTemplate = markerConfig?.prefix ?? "[from {channel}] ";
+	const suffixTemplate = markerConfig?.suffix ?? "";
+	const prefix = prefixTemplate.replaceAll("{channel}", originLabel);
+	const suffix = suffixTemplate.replaceAll("{channel}", originLabel);
+	const adapter = getChannelMessageAdapter(params.channel);
+	return {
+		prefix,
+		suffix,
+		componentsBuilder: adapter.supportsComponentsV2 ? adapter.buildCrossContextComponents ? (message) => adapter.buildCrossContextComponents({
+			originLabel,
+			message,
+			cfg: params.cfg,
+			accountId: params.accountId ?? void 0
+		}) : void 0 : void 0
+	};
+}
+function shouldApplyCrossContextMarker(action) {
+	return CONTEXT_MARKER_ACTIONS.has(action);
+}
+function applyCrossContextDecoration(params) {
+	if (params.preferComponents && params.decoration.componentsBuilder) return {
+		message: params.message,
+		componentsBuilder: params.decoration.componentsBuilder,
+		usedComponents: true
+	};
+	return {
+		message: `${params.decoration.prefix}${params.message}${params.decoration.suffix}`,
+		usedComponents: false
+	};
+}
+
+//#endregion
+//#region src/infra/outbound/message.ts
+async function resolveRequiredChannel(params) {
+	const channel = params.channel?.trim() ? normalizeChannelId(params.channel) : (await resolveMessageChannelSelection({ cfg: params.cfg })).channel;
+	if (!channel) throw new Error(`Unknown channel: ${params.channel}`);
+	return channel;
+}
+function resolveRequiredPlugin(channel) {
+	const plugin = getChannelPlugin(channel);
+	if (!plugin) throw new Error(`Unknown channel: ${channel}`);
+	return plugin;
+}
+function resolveGatewayOptions(opts) {
+	return {
+		url: opts?.mode === GATEWAY_CLIENT_MODES.BACKEND || opts?.clientName === GATEWAY_CLIENT_NAMES.GATEWAY_CLIENT ? void 0 : opts?.url,
+		token: opts?.token,
+		timeoutMs: typeof opts?.timeoutMs === "number" && Number.isFinite(opts.timeoutMs) ? Math.max(1, Math.floor(opts.timeoutMs)) : 1e4,
+		clientName: opts?.clientName ?? GATEWAY_CLIENT_NAMES.CLI,
+		clientDisplayName: opts?.clientDisplayName,
+		mode: opts?.mode ?? GATEWAY_CLIENT_MODES.CLI
+	};
+}
+async function callMessageGateway(params) {
+	const gateway = resolveGatewayOptions(params.gateway);
+	return await callGatewayLeastPrivilege({
+		url: gateway.url,
+		token: gateway.token,
+		method: params.method,
+		params: params.params,
+		timeoutMs: gateway.timeoutMs,
+		clientName: gateway.clientName,
+		clientDisplayName: gateway.clientDisplayName,
+		mode: gateway.mode
+	});
+}
+async function sendMessage(params) {
+	const cfg = params.cfg ?? loadConfig();
+	const channel = await resolveRequiredChannel({
+		cfg,
+		channel: params.channel
+	});
+	const deliveryMode = resolveRequiredPlugin(channel).outbound?.deliveryMode ?? "direct";
+	const normalizedPayloads = normalizeReplyPayloadsForDelivery([{
+		text: params.content,
+		mediaUrl: params.mediaUrl,
+		mediaUrls: params.mediaUrls
+	}]);
+	const mirrorText = normalizedPayloads.map((payload) => payload.text).filter(Boolean).join("\n");
+	const mirrorMediaUrls = normalizedPayloads.flatMap((payload) => payload.mediaUrls ?? (payload.mediaUrl ? [payload.mediaUrl] : []));
+	const primaryMediaUrl = mirrorMediaUrls[0] ?? params.mediaUrl ?? null;
+	if (params.dryRun) return {
+		channel,
+		to: params.to,
+		via: deliveryMode === "gateway" ? "gateway" : "direct",
+		mediaUrl: primaryMediaUrl,
+		mediaUrls: mirrorMediaUrls.length ? mirrorMediaUrls : void 0,
+		dryRun: true
+	};
+	if (deliveryMode !== "gateway") {
+		const outboundChannel = channel;
+		const resolvedTarget = resolveOutboundTarget({
+			channel: outboundChannel,
+			to: params.to,
+			cfg,
+			accountId: params.accountId,
+			mode: "explicit"
+		});
+		if (!resolvedTarget.ok) throw resolvedTarget.error;
+		const results = await deliverOutboundPayloads({
+			cfg,
+			channel: outboundChannel,
+			to: resolvedTarget.to,
+			agentId: params.agentId,
+			accountId: params.accountId,
+			payloads: normalizedPayloads,
+			replyToId: params.replyToId,
+			threadId: params.threadId,
+			gifPlayback: params.gifPlayback,
+			deps: params.deps,
+			bestEffort: params.bestEffort,
+			abortSignal: params.abortSignal,
+			silent: params.silent,
+			mirror: params.mirror ? {
+				...params.mirror,
+				text: mirrorText || params.content,
+				mediaUrls: mirrorMediaUrls.length ? mirrorMediaUrls : void 0
+			} : void 0
+		});
+		return {
+			channel,
+			to: params.to,
+			via: "direct",
+			mediaUrl: primaryMediaUrl,
+			mediaUrls: mirrorMediaUrls.length ? mirrorMediaUrls : void 0,
+			result: results.at(-1)
+		};
+	}
+	const result = await callMessageGateway({
+		gateway: params.gateway,
+		method: "send",
+		params: {
+			to: params.to,
+			message: params.content,
+			mediaUrl: params.mediaUrl,
+			mediaUrls: mirrorMediaUrls.length ? mirrorMediaUrls : params.mediaUrls,
+			gifPlayback: params.gifPlayback,
+			accountId: params.accountId,
+			channel,
+			sessionKey: params.mirror?.sessionKey,
+			idempotencyKey: params.idempotencyKey ?? randomIdempotencyKey()
+		}
+	});
+	return {
+		channel,
+		to: params.to,
+		via: "gateway",
+		mediaUrl: primaryMediaUrl,
+		mediaUrls: mirrorMediaUrls.length ? mirrorMediaUrls : void 0,
+		result
+	};
+}
+async function sendPoll(params) {
+	const channel = await resolveRequiredChannel({
+		cfg: params.cfg ?? loadConfig(),
+		channel: params.channel
+	});
+	const pollInput = {
+		question: params.question,
+		options: params.options,
+		maxSelections: params.maxSelections,
+		durationSeconds: params.durationSeconds,
+		durationHours: params.durationHours
+	};
+	const outbound = resolveRequiredPlugin(channel)?.outbound;
+	if (!outbound?.sendPoll) throw new Error(`Unsupported poll channel: ${channel}`);
+	const normalized = outbound.pollMaxOptions ? normalizePollInput(pollInput, { maxOptions: outbound.pollMaxOptions }) : normalizePollInput(pollInput);
+	if (params.dryRun) return {
+		channel,
+		to: params.to,
+		question: normalized.question,
+		options: normalized.options,
+		maxSelections: normalized.maxSelections,
+		durationSeconds: normalized.durationSeconds ?? null,
+		durationHours: normalized.durationHours ?? null,
+		via: "gateway",
+		dryRun: true
+	};
+	const result = await callMessageGateway({
+		gateway: params.gateway,
+		method: "poll",
+		params: {
+			to: params.to,
+			question: normalized.question,
+			options: normalized.options,
+			maxSelections: normalized.maxSelections,
+			durationSeconds: normalized.durationSeconds,
+			durationHours: normalized.durationHours,
+			threadId: params.threadId,
+			silent: params.silent,
+			isAnonymous: params.isAnonymous,
+			channel,
+			accountId: params.accountId,
+			idempotencyKey: params.idempotencyKey ?? randomIdempotencyKey()
+		}
+	});
+	return {
+		channel,
+		to: params.to,
+		question: normalized.question,
+		options: normalized.options,
+		maxSelections: normalized.maxSelections,
+		durationSeconds: normalized.durationSeconds ?? null,
+		durationHours: normalized.durationHours ?? null,
+		via: "gateway",
+		result
+	};
+}
+
+//#endregion
+//#region src/infra/outbound/tool-payload.ts
+function extractToolPayload(result) {
+	if (result.details !== void 0) return result.details;
+	const text = (Array.isArray(result.content) ? result.content.find((block) => block && typeof block === "object" && block.type === "text" && typeof block.text === "string") : void 0)?.text;
+	if (text) try {
+		return JSON.parse(text);
+	} catch {
+		return text;
+	}
+	return result.content ?? result;
+}
+
+//#endregion
+//#region src/infra/outbound/outbound-send-service.ts
+async function tryHandleWithPluginAction(params) {
+	if (params.ctx.dryRun) return null;
+	const mediaLocalRoots = getAgentScopedMediaLocalRoots(params.ctx.cfg, params.ctx.agentId ?? params.ctx.mirror?.agentId);
+	const handled = await dispatchChannelMessageAction({
+		channel: params.ctx.channel,
+		action: params.action,
+		cfg: params.ctx.cfg,
+		params: params.ctx.params,
+		mediaLocalRoots,
+		accountId: params.ctx.accountId ?? void 0,
+		gateway: params.ctx.gateway,
+		toolContext: params.ctx.toolContext,
+		dryRun: params.ctx.dryRun
+	});
+	if (!handled) return null;
+	await params.onHandled?.();
+	return {
+		handledBy: "plugin",
+		payload: extractToolPayload(handled),
+		toolResult: handled
+	};
+}
+async function executeSendAction(params) {
+	throwIfAborted(params.ctx.abortSignal);
+	const pluginHandled = await tryHandleWithPluginAction({
+		ctx: params.ctx,
+		action: "send",
+		onHandled: async () => {
+			if (!params.ctx.mirror) return;
+			const mirrorText = params.ctx.mirror.text ?? params.message;
+			const mirrorMediaUrls = params.ctx.mirror.mediaUrls ?? params.mediaUrls ?? (params.mediaUrl ? [params.mediaUrl] : void 0);
+			await appendAssistantMessageToSessionTranscript({
+				agentId: params.ctx.mirror.agentId,
+				sessionKey: params.ctx.mirror.sessionKey,
+				text: mirrorText,
+				mediaUrls: mirrorMediaUrls
+			});
+		}
+	});
+	if (pluginHandled) return pluginHandled;
+	throwIfAborted(params.ctx.abortSignal);
+	const result = await sendMessage({
+		cfg: params.ctx.cfg,
+		to: params.to,
+		content: params.message,
+		agentId: params.ctx.agentId,
+		mediaUrl: params.mediaUrl || void 0,
+		mediaUrls: params.mediaUrls,
+		channel: params.ctx.channel || void 0,
+		accountId: params.ctx.accountId ?? void 0,
+		replyToId: params.replyToId,
+		threadId: params.threadId,
+		gifPlayback: params.gifPlayback,
+		dryRun: params.ctx.dryRun,
+		bestEffort: params.bestEffort ?? void 0,
+		deps: params.ctx.deps,
+		gateway: params.ctx.gateway,
+		mirror: params.ctx.mirror,
+		abortSignal: params.ctx.abortSignal,
+		silent: params.ctx.silent
+	});
+	return {
+		handledBy: "core",
+		payload: result,
+		sendResult: result
+	};
+}
+async function executePollAction(params) {
+	const pluginHandled = await tryHandleWithPluginAction({
+		ctx: params.ctx,
+		action: "poll"
+	});
+	if (pluginHandled) return pluginHandled;
+	const result = await sendPoll({
+		cfg: params.ctx.cfg,
+		to: params.to,
+		question: params.question,
+		options: params.options,
+		maxSelections: params.maxSelections,
+		durationSeconds: params.durationSeconds ?? void 0,
+		durationHours: params.durationHours ?? void 0,
+		channel: params.ctx.channel,
+		accountId: params.ctx.accountId ?? void 0,
+		threadId: params.threadId ?? void 0,
+		silent: params.ctx.silent ?? void 0,
+		isAnonymous: params.isAnonymous ?? void 0,
+		dryRun: params.ctx.dryRun,
+		gateway: params.ctx.gateway
+	});
+	return {
+		handledBy: "core",
+		payload: result,
+		pollResult: result
+	};
+}
+
+//#endregion
+//#region src/infra/outbound/message-action-runner.ts
+function resolveAndApplyOutboundThreadId(params, ctx) {
+	const threadId = readStringParam(params, "threadId");
+	const slackAutoThreadId = ctx.allowSlackAutoThread && ctx.channel === "slack" && !threadId ? resolveSlackAutoThreadId({
+		to: ctx.to,
+		toolContext: ctx.toolContext
+	}) : void 0;
+	const telegramAutoThreadId = ctx.channel === "telegram" && !threadId ? resolveTelegramAutoThreadId({
+		to: ctx.to,
+		toolContext: ctx.toolContext
+	}) : void 0;
+	const resolved = threadId ?? slackAutoThreadId ?? telegramAutoThreadId;
+	if (resolved && !params.threadId) params.threadId = resolved;
+	return resolved ?? void 0;
+}
+function getToolResult(result) {
+	return "toolResult" in result ? result.toolResult : void 0;
+}
+function applyCrossContextMessageDecoration({ params, message, decoration, preferComponents }) {
+	const applied = applyCrossContextDecoration({
+		message,
+		decoration,
+		preferComponents
+	});
+	params.message = applied.message;
+	if (applied.componentsBuilder) params.components = applied.componentsBuilder;
+	return applied.message;
+}
+async function maybeApplyCrossContextMarker(params) {
+	if (!shouldApplyCrossContextMarker(params.action) || !params.toolContext) return params.message;
+	const decoration = await buildCrossContextDecoration({
+		cfg: params.cfg,
+		channel: params.channel,
+		target: params.target,
+		toolContext: params.toolContext,
+		accountId: params.accountId ?? void 0
+	});
+	if (!decoration) return params.message;
+	return applyCrossContextMessageDecoration({
+		params: params.args,
+		message: params.message,
+		decoration,
+		preferComponents: params.preferComponents
+	});
+}
+async function resolveChannel(cfg, params) {
+	return (await resolveMessageChannelSelection({
+		cfg,
+		channel: readStringParam(params, "channel")
+	})).channel;
+}
+async function resolveActionTarget(params) {
+	let resolvedTarget;
+	const toRaw = typeof params.args.to === "string" ? params.args.to.trim() : "";
+	if (toRaw) {
+		const resolved = await resolveChannelTarget({
+			cfg: params.cfg,
+			channel: params.channel,
+			input: toRaw,
+			accountId: params.accountId ?? void 0
+		});
+		if (resolved.ok) {
+			params.args.to = resolved.target.to;
+			resolvedTarget = resolved.target;
+		} else throw resolved.error;
+	}
+	const channelIdRaw = typeof params.args.channelId === "string" ? params.args.channelId.trim() : "";
+	if (channelIdRaw) {
+		const resolved = await resolveChannelTarget({
+			cfg: params.cfg,
+			channel: params.channel,
+			input: channelIdRaw,
+			accountId: params.accountId ?? void 0,
+			preferredKind: "group"
+		});
+		if (resolved.ok) {
+			if (resolved.target.kind === "user") throw new Error(`Channel id "${channelIdRaw}" resolved to a user target.`);
+			params.args.channelId = resolved.target.to.replace(/^(channel|group):/i, "");
+		} else throw resolved.error;
+	}
+	return resolvedTarget;
+}
+function resolveGateway(input) {
+	if (!input.gateway) return;
+	return {
+		url: input.gateway.url,
+		token: input.gateway.token,
+		timeoutMs: input.gateway.timeoutMs,
+		clientName: input.gateway.clientName,
+		clientDisplayName: input.gateway.clientDisplayName,
+		mode: input.gateway.mode
+	};
+}
+async function handleBroadcastAction(input, params) {
+	throwIfAborted(input.abortSignal);
+	if (!(input.cfg.tools?.message?.broadcast?.enabled !== false)) throw new Error("Broadcast is disabled. Set tools.message.broadcast.enabled to true.");
+	const rawTargets = readStringArrayParam(params, "targets", { required: true }) ?? [];
+	if (rawTargets.length === 0) throw new Error("Broadcast requires at least one target in --targets.");
+	const channelHint = readStringParam(params, "channel");
+	const configured = await listConfiguredMessageChannels(input.cfg);
+	if (configured.length === 0) throw new Error("Broadcast requires at least one configured channel.");
+	const targetChannels = channelHint && channelHint.trim().toLowerCase() !== "all" ? [await resolveChannel(input.cfg, { channel: channelHint })] : configured;
+	const results = [];
+	const isAbortError = (err) => err instanceof Error && err.name === "AbortError";
+	for (const targetChannel of targetChannels) {
+		throwIfAborted(input.abortSignal);
+		for (const target of rawTargets) {
+			throwIfAborted(input.abortSignal);
+			try {
+				const resolved = await resolveChannelTarget({
+					cfg: input.cfg,
+					channel: targetChannel,
+					input: target
+				});
+				if (!resolved.ok) throw resolved.error;
+				const sendResult = await runMessageAction({
+					...input,
+					action: "send",
+					params: {
+						...params,
+						channel: targetChannel,
+						target: resolved.target.to
+					}
+				});
+				results.push({
+					channel: targetChannel,
+					to: resolved.target.to,
+					ok: true,
+					result: sendResult.kind === "send" ? sendResult.sendResult : void 0
+				});
+			} catch (err) {
+				if (isAbortError(err)) throw err;
+				results.push({
+					channel: targetChannel,
+					to: target,
+					ok: false,
+					error: err instanceof Error ? err.message : String(err)
+				});
+			}
+		}
+	}
+	return {
+		kind: "broadcast",
+		channel: targetChannels[0] ?? "discord",
+		action: "broadcast",
+		handledBy: input.dryRun ? "dry-run" : "core",
+		payload: { results },
+		dryRun: Boolean(input.dryRun)
+	};
+}
+async function handleSendAction(ctx) {
+	const { cfg, params, channel, accountId, dryRun, gateway, input, agentId, resolvedTarget, abortSignal } = ctx;
+	throwIfAborted(abortSignal);
+	const action = "send";
+	const to = readStringParam(params, "to", { required: true });
+	const mediaHint = readStringParam(params, "media", { trim: false }) ?? readStringParam(params, "path", { trim: false }) ?? readStringParam(params, "filePath", { trim: false });
+	const hasCard = params.card != null && typeof params.card === "object";
+	const hasComponents = params.components != null && typeof params.components === "object";
+	const caption = readStringParam(params, "caption", { allowEmpty: true }) ?? "";
+	let message = readStringParam(params, "message", {
+		required: !mediaHint && !hasCard && !hasComponents,
+		allowEmpty: true
+	}) ?? "";
+	if (message.includes("\\n")) message = message.replaceAll("\\n", "\n");
+	if (!message.trim() && caption.trim()) message = caption;
+	const parsed = parseReplyDirectives(message);
+	const mergedMediaUrls = [];
+	const seenMedia = /* @__PURE__ */ new Set();
+	const pushMedia = (value) => {
+		const trimmed = value?.trim();
+		if (!trimmed) return;
+		if (seenMedia.has(trimmed)) return;
+		seenMedia.add(trimmed);
+		mergedMediaUrls.push(trimmed);
+	};
+	pushMedia(mediaHint);
+	for (const url of parsed.mediaUrls ?? []) pushMedia(url);
+	pushMedia(parsed.mediaUrl);
+	const normalizedMediaUrls = await normalizeSandboxMediaList({
+		values: mergedMediaUrls,
+		sandboxRoot: input.sandboxRoot
+	});
+	mergedMediaUrls.length = 0;
+	mergedMediaUrls.push(...normalizedMediaUrls);
+	message = parsed.text;
+	params.message = message;
+	if (!params.replyTo && parsed.replyToId) params.replyTo = parsed.replyToId;
+	if (!params.media) params.media = mergedMediaUrls[0] || void 0;
+	message = await maybeApplyCrossContextMarker({
+		cfg,
+		channel,
+		action,
+		target: to,
+		toolContext: input.toolContext,
+		accountId,
+		args: params,
+		message,
+		preferComponents: true
+	});
+	const mediaUrl = readStringParam(params, "media", { trim: false });
+	if (channel === "whatsapp") {
+		message = message.replace(/^(?:[ \t]*\r?\n)+/, "");
+		if (!message.trim()) message = "";
+	}
+	if (!message.trim() && !mediaUrl && mergedMediaUrls.length === 0 && !hasCard && !hasComponents) throw new Error("send requires text or media");
+	params.message = message;
+	const gifPlayback = readBooleanParam(params, "gifPlayback") ?? false;
+	const bestEffort = readBooleanParam(params, "bestEffort");
+	const silent = readBooleanParam(params, "silent");
+	const replyToId = readStringParam(params, "replyTo");
+	const resolvedThreadId = resolveAndApplyOutboundThreadId(params, {
+		channel,
+		to,
+		toolContext: input.toolContext,
+		allowSlackAutoThread: channel === "slack" && !replyToId
+	});
+	const outboundRoute = agentId && !dryRun ? await resolveOutboundSessionRoute({
+		cfg,
+		channel,
+		agentId,
+		accountId,
+		target: to,
+		resolvedTarget,
+		replyToId,
+		threadId: resolvedThreadId
+	}) : null;
+	if (outboundRoute && agentId && !dryRun) await ensureOutboundSessionEntry({
+		cfg,
+		agentId,
+		channel,
+		accountId,
+		route: outboundRoute
+	});
+	if (outboundRoute && !dryRun) params.__sessionKey = outboundRoute.sessionKey;
+	if (agentId) params.__agentId = agentId;
+	const mirrorMediaUrls = mergedMediaUrls.length > 0 ? mergedMediaUrls : mediaUrl ? [mediaUrl] : void 0;
+	throwIfAborted(abortSignal);
+	const send = await executeSendAction({
+		ctx: {
+			cfg,
+			channel,
+			params,
+			agentId,
+			accountId: accountId ?? void 0,
+			gateway,
+			toolContext: input.toolContext,
+			deps: input.deps,
+			dryRun,
+			mirror: outboundRoute && !dryRun ? {
+				sessionKey: outboundRoute.sessionKey,
+				agentId,
+				text: message,
+				mediaUrls: mirrorMediaUrls
+			} : void 0,
+			abortSignal,
+			silent: silent ?? void 0
+		},
+		to,
+		message,
+		mediaUrl: mediaUrl || void 0,
+		mediaUrls: mergedMediaUrls.length ? mergedMediaUrls : void 0,
+		gifPlayback,
+		bestEffort: bestEffort ?? void 0,
+		replyToId: replyToId ?? void 0,
+		threadId: resolvedThreadId ?? void 0
+	});
+	return {
+		kind: "send",
+		channel,
+		action,
+		to,
+		handledBy: send.handledBy,
+		payload: send.payload,
+		toolResult: send.toolResult,
+		sendResult: send.sendResult,
+		dryRun
+	};
+}
+async function handlePollAction(ctx) {
+	const { cfg, params, channel, accountId, dryRun, gateway, input, abortSignal } = ctx;
+	throwIfAborted(abortSignal);
+	const action = "poll";
+	const to = readStringParam(params, "to", { required: true });
+	const question = readStringParam(params, "pollQuestion", { required: true });
+	const options = readStringArrayParam(params, "pollOption", { required: true }) ?? [];
+	if (options.length < 2) throw new Error("pollOption requires at least two values");
+	const silent = readBooleanParam(params, "silent");
+	const allowMultiselect = readBooleanParam(params, "pollMulti") ?? false;
+	const pollAnonymous = readBooleanParam(params, "pollAnonymous");
+	const pollPublic = readBooleanParam(params, "pollPublic");
+	if (pollAnonymous && pollPublic) throw new Error("pollAnonymous and pollPublic are mutually exclusive");
+	const isAnonymous = pollAnonymous ? true : pollPublic ? false : void 0;
+	const durationHours = readNumberParam(params, "pollDurationHours", { integer: true });
+	const durationSeconds = readNumberParam(params, "pollDurationSeconds", { integer: true });
+	const maxSelections = allowMultiselect ? Math.max(2, options.length) : 1;
+	if (durationSeconds !== void 0 && channel !== "telegram") throw new Error("pollDurationSeconds is only supported for Telegram polls");
+	if (isAnonymous !== void 0 && channel !== "telegram") throw new Error("pollAnonymous/pollPublic are only supported for Telegram polls");
+	const resolvedThreadId = resolveAndApplyOutboundThreadId(params, {
+		channel,
+		to,
+		toolContext: input.toolContext,
+		allowSlackAutoThread: channel === "slack"
+	});
+	const base = typeof params.message === "string" ? params.message : "";
+	await maybeApplyCrossContextMarker({
+		cfg,
+		channel,
+		action,
+		target: to,
+		toolContext: input.toolContext,
+		accountId,
+		args: params,
+		message: base,
+		preferComponents: false
+	});
+	const poll = await executePollAction({
+		ctx: {
+			cfg,
+			channel,
+			params,
+			accountId: accountId ?? void 0,
+			gateway,
+			toolContext: input.toolContext,
+			dryRun,
+			silent: silent ?? void 0
+		},
+		to,
+		question,
+		options,
+		maxSelections,
+		durationSeconds: durationSeconds ?? void 0,
+		durationHours: durationHours ?? void 0,
+		threadId: resolvedThreadId ?? void 0,
+		isAnonymous
+	});
+	return {
+		kind: "poll",
+		channel,
+		action,
+		to,
+		handledBy: poll.handledBy,
+		payload: poll.payload,
+		toolResult: poll.toolResult,
+		pollResult: poll.pollResult,
+		dryRun
+	};
+}
+async function handlePluginAction(ctx) {
+	const { cfg, params, channel, accountId, dryRun, gateway, input, abortSignal } = ctx;
+	throwIfAborted(abortSignal);
+	const action = input.action;
+	if (dryRun) return {
+		kind: "action",
+		channel,
+		action,
+		handledBy: "dry-run",
+		payload: {
+			ok: true,
+			dryRun: true,
+			channel,
+			action
+		},
+		dryRun: true
+	};
+	const handled = await dispatchChannelMessageAction({
+		channel,
+		action,
+		cfg,
+		params,
+		accountId: accountId ?? void 0,
+		requesterSenderId: input.requesterSenderId ?? void 0,
+		gateway,
+		toolContext: input.toolContext,
+		dryRun
+	});
+	if (!handled) throw new Error(`Message action ${action} not supported for channel ${channel}.`);
+	return {
+		kind: "action",
+		channel,
+		action,
+		handledBy: "plugin",
+		payload: extractToolPayload(handled),
+		toolResult: handled,
+		dryRun
+	};
+}
+async function runMessageAction(input) {
+	const cfg = input.cfg;
+	const params = { ...input.params };
+	const resolvedAgentId = input.agentId ?? (input.sessionKey ? resolveSessionAgentId({
+		sessionKey: input.sessionKey,
+		config: cfg
+	}) : void 0);
+	parseButtonsParam(params);
+	parseCardParam(params);
+	parseComponentsParam(params);
+	const action = input.action;
+	if (action === "broadcast") return handleBroadcastAction(input, params);
+	const explicitTarget = typeof params.target === "string" ? params.target.trim() : "";
+	const hasLegacyTarget = typeof params.to === "string" && params.to.trim().length > 0 || typeof params.channelId === "string" && params.channelId.trim().length > 0;
+	if (explicitTarget && hasLegacyTarget) {
+		delete params.to;
+		delete params.channelId;
+	}
+	if (!explicitTarget && !hasLegacyTarget && actionRequiresTarget(action) && !actionHasTarget(action, params)) {
+		const inferredTarget = input.toolContext?.currentChannelId?.trim();
+		if (inferredTarget) params.target = inferredTarget;
+	}
+	if (!explicitTarget && actionRequiresTarget(action) && hasLegacyTarget) {
+		const legacyTo = typeof params.to === "string" ? params.to.trim() : "";
+		const legacyChannelId = typeof params.channelId === "string" ? params.channelId.trim() : "";
+		const legacyTarget = legacyTo || legacyChannelId;
+		if (legacyTarget) {
+			params.target = legacyTarget;
+			delete params.to;
+			delete params.channelId;
+		}
+	}
+	if (!(typeof params.channel === "string" ? params.channel.trim() : "")) {
+		const inferredChannel = normalizeMessageChannel(input.toolContext?.currentChannelProvider);
+		if (inferredChannel && isDeliverableMessageChannel(inferredChannel)) params.channel = inferredChannel;
+	}
+	applyTargetToParams({
+		action,
+		args: params
+	});
+	if (actionRequiresTarget(action)) {
+		if (!actionHasTarget(action, params)) throw new Error(`Action ${action} requires a target.`);
+	}
+	const channel = await resolveChannel(cfg, params);
+	const accountId = readStringParam(params, "accountId") ?? input.defaultAccountId;
+	if (accountId) params.accountId = accountId;
+	const dryRun = Boolean(input.dryRun ?? readBooleanParam(params, "dryRun"));
+	const mediaLocalRoots = getAgentScopedMediaLocalRoots(cfg, resolvedAgentId);
+	await hydrateAttachmentParamsForAction({
+		cfg,
+		channel,
+		accountId,
+		args: params,
+		action,
+		dryRun,
+		mediaPolicy: resolveAttachmentMediaPolicy({
+			sandboxRoot: input.sandboxRoot,
+			mediaLocalRoots
+		})
+	});
+	const resolvedTarget = await resolveActionTarget({
+		cfg,
+		channel,
+		action,
+		args: params,
+		accountId
+	});
+	enforceCrossContextPolicy({
+		channel,
+		action,
+		args: params,
+		toolContext: input.toolContext,
+		cfg
+	});
+	const gateway = resolveGateway(input);
+	if (action === "send") return handleSendAction({
+		cfg,
+		params,
+		channel,
+		accountId,
+		dryRun,
+		gateway,
+		input,
+		agentId: resolvedAgentId,
+		resolvedTarget,
+		abortSignal: input.abortSignal
+	});
+	if (action === "poll") return handlePollAction({
+		cfg,
+		params,
+		channel,
+		accountId,
+		dryRun,
+		gateway,
+		input,
+		abortSignal: input.abortSignal
+	});
+	return handlePluginAction({
+		cfg,
+		params,
+		channel,
+		accountId,
+		dryRun,
+		gateway,
+		input,
+		abortSignal: input.abortSignal
+	});
+}
+
+//#endregion
+//#region src/channels/plugins/message-action-names.ts
+const CHANNEL_MESSAGE_ACTION_NAMES = [
+	"send",
+	"broadcast",
+	"poll",
+	"react",
+	"reactions",
+	"read",
+	"edit",
+	"unsend",
+	"reply",
+	"sendWithEffect",
+	"renameGroup",
+	"setGroupIcon",
+	"addParticipant",
+	"removeParticipant",
+	"leaveGroup",
+	"sendAttachment",
+	"delete",
+	"pin",
+	"unpin",
+	"list-pins",
+	"permissions",
+	"thread-create",
+	"thread-list",
+	"thread-reply",
+	"search",
+	"sticker",
+	"sticker-search",
+	"member-info",
+	"role-info",
+	"emoji-list",
+	"emoji-upload",
+	"sticker-upload",
+	"role-add",
+	"role-remove",
+	"channel-info",
+	"channel-list",
+	"channel-create",
+	"channel-edit",
+	"channel-delete",
+	"channel-move",
+	"category-create",
+	"category-edit",
+	"category-delete",
+	"topic-create",
+	"voice-status",
+	"event-list",
+	"event-create",
+	"timeout",
+	"kick",
+	"ban",
+	"set-presence"
+];
+
+//#endregion
+export { CHANNEL_TARGET_DESCRIPTION as a, supportsChannelMessageButtonsForChannel as c, ensureOutboundSessionEntry as d, resolveOutboundSessionRoute as f, CHANNEL_TARGETS_DESCRIPTION as i, supportsChannelMessageCards as l, resetDirectoryCache as m, getToolResult as n, listChannelMessageActions as o, formatTargetDisplay as p, runMessageAction as r, supportsChannelMessageButtons as s, CHANNEL_MESSAGE_ACTION_NAMES as t, supportsChannelMessageCardsForChannel as u };