remoteclaw 0.1.0-next.2abd2fa → 0.1.0-next.2e9a6cd

package/dist/channel-activity-CwiF_QMr.js

@@ -0,0 +1,94 @@
+import { t as createSubsystemLogger } from "./subsystem-BgxIzx7w.js";
+import { n as formatErrorMessage } from "./errors-CdmXrBic.js";
+import { n as retryAsync, t as resolveRetryConfig } from "./retry-BcZuGfnV.js";
+import { RateLimitError } from "@buape/carbon";
+
+//#region src/infra/retry-policy.ts
+const DISCORD_RETRY_DEFAULTS = {
+	attempts: 3,
+	minDelayMs: 500,
+	maxDelayMs: 3e4,
+	jitter: .1
+};
+const TELEGRAM_RETRY_DEFAULTS = {
+	attempts: 3,
+	minDelayMs: 400,
+	maxDelayMs: 3e4,
+	jitter: .1
+};
+const TELEGRAM_RETRY_RE = /429|timeout|connect|reset|closed|unavailable|temporarily/i;
+const log = createSubsystemLogger("retry-policy");
+function getTelegramRetryAfterMs(err) {
+	if (!err || typeof err !== "object") return;
+	const candidate = "parameters" in err && err.parameters && typeof err.parameters === "object" ? err.parameters.retry_after : "response" in err && err.response && typeof err.response === "object" && "parameters" in err.response ? err.response.parameters?.retry_after : "error" in err && err.error && typeof err.error === "object" && "parameters" in err.error ? err.error.parameters?.retry_after : void 0;
+	return typeof candidate === "number" && Number.isFinite(candidate) ? candidate * 1e3 : void 0;
+}
+function createDiscordRetryRunner(params) {
+	const retryConfig = resolveRetryConfig(DISCORD_RETRY_DEFAULTS, {
+		...params.configRetry,
+		...params.retry
+	});
+	return (fn, label) => retryAsync(fn, {
+		...retryConfig,
+		label,
+		shouldRetry: (err) => err instanceof RateLimitError,
+		retryAfterMs: (err) => err instanceof RateLimitError ? err.retryAfter * 1e3 : void 0,
+		onRetry: params.verbose ? (info) => {
+			const labelText = info.label ?? "request";
+			const maxRetries = Math.max(1, info.maxAttempts - 1);
+			log.warn(`discord ${labelText} rate limited, retry ${info.attempt}/${maxRetries} in ${info.delayMs}ms`);
+		} : void 0
+	});
+}
+function createTelegramRetryRunner(params) {
+	const retryConfig = resolveRetryConfig(TELEGRAM_RETRY_DEFAULTS, {
+		...params.configRetry,
+		...params.retry
+	});
+	const shouldRetry = params.shouldRetry ? (err) => params.shouldRetry?.(err) || TELEGRAM_RETRY_RE.test(formatErrorMessage(err)) : (err) => TELEGRAM_RETRY_RE.test(formatErrorMessage(err));
+	return (fn, label) => retryAsync(fn, {
+		...retryConfig,
+		label,
+		shouldRetry,
+		retryAfterMs: getTelegramRetryAfterMs,
+		onRetry: params.verbose ? (info) => {
+			const maxRetries = Math.max(1, info.maxAttempts - 1);
+			log.warn(`telegram send retry ${info.attempt}/${maxRetries} for ${info.label ?? label ?? "request"} in ${info.delayMs}ms: ${formatErrorMessage(info.err)}`);
+		} : void 0
+	});
+}
+
+//#endregion
+//#region src/infra/channel-activity.ts
+const activity = /* @__PURE__ */ new Map();
+function keyFor(channel, accountId) {
+	return `${channel}:${accountId || "default"}`;
+}
+function ensureEntry(channel, accountId) {
+	const key = keyFor(channel, accountId);
+	const existing = activity.get(key);
+	if (existing) return existing;
+	const created = {
+		inboundAt: null,
+		outboundAt: null
+	};
+	activity.set(key, created);
+	return created;
+}
+function recordChannelActivity(params) {
+	const at = typeof params.at === "number" ? params.at : Date.now();
+	const accountId = params.accountId?.trim() || "default";
+	const entry = ensureEntry(params.channel, accountId);
+	if (params.direction === "inbound") entry.inboundAt = at;
+	if (params.direction === "outbound") entry.outboundAt = at;
+}
+function getChannelActivity(params) {
+	const accountId = params.accountId?.trim() || "default";
+	return activity.get(keyFor(params.channel, accountId)) ?? {
+		inboundAt: null,
+		outboundAt: null
+	};
+}
+
+//#endregion
+export { createTelegramRetryRunner as i, recordChannelActivity as n, createDiscordRetryRunner as r, getChannelActivity as t };

package/dist/channel-activity-daCpxHdT.js

@@ -0,0 +1,292 @@
+import { T as resolveNodeRequireFromMeta, t as createSubsystemLogger } from "./subsystem-BCkt9Ocb.js";
+import { n as retryAsync, t as resolveRetryConfig } from "./retry-BzWBtFpP.js";
+import { RateLimitError } from "@buape/carbon";
+
+//#region src/security/safe-regex.ts
+const SAFE_REGEX_CACHE_MAX = 256;
+const safeRegexCache = /* @__PURE__ */ new Map();
+function hasNestedRepetition(source) {
+	const frames = [{
+		lastToken: null,
+		containsRepetition: false
+	}];
+	let inCharClass = false;
+	const emitToken = (token) => {
+		const frame = frames[frames.length - 1];
+		frame.lastToken = token;
+		if (token.containsRepetition) frame.containsRepetition = true;
+	};
+	for (let i = 0; i < source.length; i += 1) {
+		const ch = source[i];
+		if (ch === "\\") {
+			i += 1;
+			emitToken({ containsRepetition: false });
+			continue;
+		}
+		if (inCharClass) {
+			if (ch === "]") inCharClass = false;
+			continue;
+		}
+		if (ch === "[") {
+			inCharClass = true;
+			emitToken({ containsRepetition: false });
+			continue;
+		}
+		if (ch === "(") {
+			frames.push({
+				lastToken: null,
+				containsRepetition: false
+			});
+			continue;
+		}
+		if (ch === ")") {
+			if (frames.length > 1) emitToken({ containsRepetition: frames.pop().containsRepetition });
+			continue;
+		}
+		if (ch === "|") {
+			const frame = frames[frames.length - 1];
+			frame.lastToken = null;
+			continue;
+		}
+		const quantifier = readQuantifier(source, i);
+		if (quantifier) {
+			const frame = frames[frames.length - 1];
+			const token = frame.lastToken;
+			if (!token) continue;
+			if (token.containsRepetition) return true;
+			token.containsRepetition = true;
+			frame.containsRepetition = true;
+			i += quantifier.consumed - 1;
+			continue;
+		}
+		emitToken({ containsRepetition: false });
+	}
+	return false;
+}
+function readQuantifier(source, index) {
+	const ch = source[index];
+	if (ch === "*" || ch === "+" || ch === "?") return { consumed: source[index + 1] === "?" ? 2 : 1 };
+	if (ch !== "{") return null;
+	let i = index + 1;
+	while (i < source.length && /\d/.test(source[i])) i += 1;
+	if (i === index + 1) return null;
+	if (source[i] === ",") {
+		i += 1;
+		while (i < source.length && /\d/.test(source[i])) i += 1;
+	}
+	if (source[i] !== "}") return null;
+	i += 1;
+	if (source[i] === "?") i += 1;
+	return { consumed: i - index };
+}
+function compileSafeRegex(source, flags = "") {
+	const trimmed = source.trim();
+	if (!trimmed) return null;
+	const cacheKey = `${flags}::${trimmed}`;
+	if (safeRegexCache.has(cacheKey)) return safeRegexCache.get(cacheKey) ?? null;
+	let compiled = null;
+	if (!hasNestedRepetition(trimmed)) try {
+		compiled = new RegExp(trimmed, flags);
+	} catch {
+		compiled = null;
+	}
+	safeRegexCache.set(cacheKey, compiled);
+	if (safeRegexCache.size > SAFE_REGEX_CACHE_MAX) {
+		const oldestKey = safeRegexCache.keys().next().value;
+		if (oldestKey) safeRegexCache.delete(oldestKey);
+	}
+	return compiled;
+}
+
+//#endregion
+//#region src/logging/redact.ts
+const requireConfig = resolveNodeRequireFromMeta(import.meta.url);
+const DEFAULT_REDACT_MODE = "tools";
+const DEFAULT_REDACT_MIN_LENGTH = 18;
+const DEFAULT_REDACT_KEEP_START = 6;
+const DEFAULT_REDACT_KEEP_END = 4;
+const DEFAULT_REDACT_PATTERNS = [
+	String.raw`\b[A-Z0-9_]*(?:KEY|TOKEN|SECRET|PASSWORD|PASSWD)\b\s*[=:]\s*(["']?)([^\s"'\\]+)\1`,
+	String.raw`"(?:apiKey|token|secret|password|passwd|accessToken|refreshToken)"\s*:\s*"([^"]+)"`,
+	String.raw`--(?:api[-_]?key|token|secret|password|passwd)\s+(["']?)([^\s"']+)\1`,
+	String.raw`Authorization\s*[:=]\s*Bearer\s+([A-Za-z0-9._\-+=]+)`,
+	String.raw`\bBearer\s+([A-Za-z0-9._\-+=]{18,})\b`,
+	String.raw`-----BEGIN [A-Z ]*PRIVATE KEY-----[\s\S]+?-----END [A-Z ]*PRIVATE KEY-----`,
+	String.raw`\b(sk-[A-Za-z0-9_-]{8,})\b`,
+	String.raw`\b(ghp_[A-Za-z0-9]{20,})\b`,
+	String.raw`\b(github_pat_[A-Za-z0-9_]{20,})\b`,
+	String.raw`\b(xox[baprs]-[A-Za-z0-9-]{10,})\b`,
+	String.raw`\b(xapp-[A-Za-z0-9-]{10,})\b`,
+	String.raw`\b(gsk_[A-Za-z0-9_-]{10,})\b`,
+	String.raw`\b(AIza[0-9A-Za-z\-_]{20,})\b`,
+	String.raw`\b(pplx-[A-Za-z0-9_-]{10,})\b`,
+	String.raw`\b(npm_[A-Za-z0-9]{10,})\b`,
+	String.raw`\bbot(\d{6,}:[A-Za-z0-9_-]{20,})\b`,
+	String.raw`\b(\d{6,}:[A-Za-z0-9_-]{20,})\b`
+];
+function normalizeMode(value) {
+	return value === "off" ? "off" : DEFAULT_REDACT_MODE;
+}
+function parsePattern(raw) {
+	if (!raw.trim()) return null;
+	const match = raw.match(/^\/(.+)\/([gimsuy]*)$/);
+	if (match) {
+		const flags = match[2].includes("g") ? match[2] : `${match[2]}g`;
+		return compileSafeRegex(match[1], flags);
+	}
+	return compileSafeRegex(raw, "gi");
+}
+function resolvePatterns(value) {
+	return (value?.length ? value : DEFAULT_REDACT_PATTERNS).map(parsePattern).filter((re) => Boolean(re));
+}
+function maskToken(token) {
+	if (token.length < DEFAULT_REDACT_MIN_LENGTH) return "***";
+	return `${token.slice(0, DEFAULT_REDACT_KEEP_START)}…${token.slice(-DEFAULT_REDACT_KEEP_END)}`;
+}
+function redactPemBlock(block) {
+	const lines = block.split(/\r?\n/).filter(Boolean);
+	if (lines.length < 2) return "***";
+	return `${lines[0]}\n…redacted…\n${lines[lines.length - 1]}`;
+}
+function redactMatch(match, groups) {
+	if (match.includes("PRIVATE KEY-----")) return redactPemBlock(match);
+	const token = groups.filter((value) => typeof value === "string" && value.length > 0).at(-1) ?? match;
+	const masked = maskToken(token);
+	if (token === match) return masked;
+	return match.replace(token, masked);
+}
+function redactText(text, patterns) {
+	let next = text;
+	for (const pattern of patterns) next = next.replace(pattern, (...args) => redactMatch(args[0], args.slice(1, args.length - 2)));
+	return next;
+}
+function resolveConfigRedaction() {
+	let cfg;
+	try {
+		cfg = (requireConfig?.("../config/config.js"))?.loadConfig?.().logging;
+	} catch {
+		cfg = void 0;
+	}
+	return {
+		mode: normalizeMode(cfg?.redactSensitive),
+		patterns: cfg?.redactPatterns
+	};
+}
+function redactSensitiveText(text, options) {
+	if (!text) return text;
+	const resolved = options ?? resolveConfigRedaction();
+	if (normalizeMode(resolved.mode) === "off") return text;
+	const patterns = resolvePatterns(resolved.patterns);
+	if (!patterns.length) return text;
+	return redactText(text, patterns);
+}
+
+//#endregion
+//#region src/infra/errors.ts
+function extractErrorCode(err) {
+	if (!err || typeof err !== "object") return;
+	const code = err.code;
+	if (typeof code === "string") return code;
+	if (typeof code === "number") return String(code);
+}
+function formatErrorMessage(err) {
+	let formatted;
+	if (err instanceof Error) formatted = err.message || err.name || "Error";
+	else if (typeof err === "string") formatted = err;
+	else if (typeof err === "number" || typeof err === "boolean" || typeof err === "bigint") formatted = String(err);
+	else try {
+		formatted = JSON.stringify(err);
+	} catch {
+		formatted = Object.prototype.toString.call(err);
+	}
+	return redactSensitiveText(formatted);
+}
+function formatUncaughtError(err) {
+	if (extractErrorCode(err) === "INVALID_CONFIG") return formatErrorMessage(err);
+	if (err instanceof Error) return redactSensitiveText(err.stack ?? err.message ?? err.name);
+	return formatErrorMessage(err);
+}
+
+//#endregion
+//#region src/infra/retry-policy.ts
+const DISCORD_RETRY_DEFAULTS = {
+	attempts: 3,
+	minDelayMs: 500,
+	maxDelayMs: 3e4,
+	jitter: .1
+};
+const TELEGRAM_RETRY_DEFAULTS = {
+	attempts: 3,
+	minDelayMs: 400,
+	maxDelayMs: 3e4,
+	jitter: .1
+};
+const TELEGRAM_RETRY_RE = /429|timeout|connect|reset|closed|unavailable|temporarily/i;
+const log = createSubsystemLogger("retry-policy");
+function getTelegramRetryAfterMs(err) {
+	if (!err || typeof err !== "object") return;
+	const candidate = "parameters" in err && err.parameters && typeof err.parameters === "object" ? err.parameters.retry_after : "response" in err && err.response && typeof err.response === "object" && "parameters" in err.response ? err.response.parameters?.retry_after : "error" in err && err.error && typeof err.error === "object" && "parameters" in err.error ? err.error.parameters?.retry_after : void 0;
+	return typeof candidate === "number" && Number.isFinite(candidate) ? candidate * 1e3 : void 0;
+}
+function createDiscordRetryRunner(params) {
+	const retryConfig = resolveRetryConfig(DISCORD_RETRY_DEFAULTS, {
+		...params.configRetry,
+		...params.retry
+	});
+	return (fn, label) => retryAsync(fn, {
+		...retryConfig,
+		label,
+		shouldRetry: (err) => err instanceof RateLimitError,
+		retryAfterMs: (err) => err instanceof RateLimitError ? err.retryAfter * 1e3 : void 0,
+		onRetry: params.verbose ? (info) => {
+			const labelText = info.label ?? "request";
+			const maxRetries = Math.max(1, info.maxAttempts - 1);
+			log.warn(`discord ${labelText} rate limited, retry ${info.attempt}/${maxRetries} in ${info.delayMs}ms`);
+		} : void 0
+	});
+}
+function createTelegramRetryRunner(params) {
+	const retryConfig = resolveRetryConfig(TELEGRAM_RETRY_DEFAULTS, {
+		...params.configRetry,
+		...params.retry
+	});
+	const shouldRetry = params.shouldRetry ? (err) => params.shouldRetry?.(err) || TELEGRAM_RETRY_RE.test(formatErrorMessage(err)) : (err) => TELEGRAM_RETRY_RE.test(formatErrorMessage(err));
+	return (fn, label) => retryAsync(fn, {
+		...retryConfig,
+		label,
+		shouldRetry,
+		retryAfterMs: getTelegramRetryAfterMs,
+		onRetry: params.verbose ? (info) => {
+			const maxRetries = Math.max(1, info.maxAttempts - 1);
+			log.warn(`telegram send retry ${info.attempt}/${maxRetries} for ${info.label ?? label ?? "request"} in ${info.delayMs}ms: ${formatErrorMessage(info.err)}`);
+		} : void 0
+	});
+}
+
+//#endregion
+//#region src/infra/channel-activity.ts
+const activity = /* @__PURE__ */ new Map();
+function keyFor(channel, accountId) {
+	return `${channel}:${accountId || "default"}`;
+}
+function ensureEntry(channel, accountId) {
+	const key = keyFor(channel, accountId);
+	const existing = activity.get(key);
+	if (existing) return existing;
+	const created = {
+		inboundAt: null,
+		outboundAt: null
+	};
+	activity.set(key, created);
+	return created;
+}
+function recordChannelActivity(params) {
+	const at = typeof params.at === "number" ? params.at : Date.now();
+	const accountId = params.accountId?.trim() || "default";
+	const entry = ensureEntry(params.channel, accountId);
+	if (params.direction === "inbound") entry.inboundAt = at;
+	if (params.direction === "outbound") entry.outboundAt = at;
+}
+
+//#endregion
+export { formatErrorMessage as a, extractErrorCode as i, createDiscordRetryRunner as n, formatUncaughtError as o, createTelegramRetryRunner as r, redactSensitiveText as s, recordChannelActivity as t };

package/dist/channel-options-CAlClffy.js

@@ -0,0 +1,33 @@
+import { u as CHAT_CHANNEL_ORDER } from "./subsystem-BgxIzx7w.js";
+import { t as isTruthyEnvValue } from "./env-DUb5GiQe.js";
+import { n as listChannelPlugins } from "./plugins-D6-JJ1il.js";
+import { r as listChannelPluginCatalogEntries } from "./catalog-CUY_iTaG.js";
+import { t as ensurePluginRegistryLoaded } from "./plugin-registry-CV5pfXOU.js";
+
+//#region src/cli/channel-options.ts
+function dedupe(values) {
+	const seen = /* @__PURE__ */ new Set();
+	const resolved = [];
+	for (const value of values) {
+		if (!value || seen.has(value)) continue;
+		seen.add(value);
+		resolved.push(value);
+	}
+	return resolved;
+}
+function resolveCliChannelOptions() {
+	const catalog = listChannelPluginCatalogEntries().map((entry) => entry.id);
+	const base = dedupe([...CHAT_CHANNEL_ORDER, ...catalog]);
+	if (isTruthyEnvValue(process.env.REMOTECLAW_EAGER_CHANNEL_OPTIONS)) {
+		ensurePluginRegistryLoaded();
+		const pluginIds = listChannelPlugins().map((plugin) => plugin.id);
+		return dedupe([...base, ...pluginIds]);
+	}
+	return base;
+}
+function formatCliChannelOptions(extra = []) {
+	return [...extra, ...resolveCliChannelOptions()].join("|");
+}
+
+//#endregion
+export { resolveCliChannelOptions as n, formatCliChannelOptions as t };

package/dist/channel-options-Hl_ep3UG.js

@@ -0,0 +1,32 @@
+import { C as CHAT_CHANNEL_ORDER, n as isTruthyEnvValue } from "./entry.js";
+import { n as listChannelPlugins } from "./plugins-B4waLB_f.js";
+import { r as listChannelPluginCatalogEntries } from "./catalog-p6W09S2j.js";
+import { t as ensurePluginRegistryLoaded } from "./plugin-registry-CmG34W0u.js";
+
+//#region src/cli/channel-options.ts
+function dedupe(values) {
+	const seen = /* @__PURE__ */ new Set();
+	const resolved = [];
+	for (const value of values) {
+		if (!value || seen.has(value)) continue;
+		seen.add(value);
+		resolved.push(value);
+	}
+	return resolved;
+}
+function resolveCliChannelOptions() {
+	const catalog = listChannelPluginCatalogEntries().map((entry) => entry.id);
+	const base = dedupe([...CHAT_CHANNEL_ORDER, ...catalog]);
+	if (isTruthyEnvValue(process.env.REMOTECLAW_EAGER_CHANNEL_OPTIONS)) {
+		ensurePluginRegistryLoaded();
+		const pluginIds = listChannelPlugins().map((plugin) => plugin.id);
+		return dedupe([...base, ...pluginIds]);
+	}
+	return base;
+}
+function formatCliChannelOptions(extra = []) {
+	return [...extra, ...resolveCliChannelOptions()].join("|");
+}
+
+//#endregion
+export { resolveCliChannelOptions as n, formatCliChannelOptions as t };

package/dist/channel-selection-CHJ7TumC.js

@@ -0,0 +1,51 @@
+import { c as normalizeMessageChannel, s as listDeliverableMessageChannels } from "./message-channel-D72Bc6Tb.js";
+import { n as listChannelPlugins } from "./plugins-B4waLB_f.js";
+
+//#region src/infra/outbound/channel-selection.ts
+const getMessageChannels = () => listDeliverableMessageChannels();
+function isKnownChannel(value) {
+	return getMessageChannels().includes(value);
+}
+function isAccountEnabled(account) {
+	if (!account || typeof account !== "object") return true;
+	return account.enabled !== false;
+}
+async function isPluginConfigured(plugin, cfg) {
+	const accountIds = plugin.config.listAccountIds(cfg);
+	if (accountIds.length === 0) return false;
+	for (const accountId of accountIds) {
+		const account = plugin.config.resolveAccount(cfg, accountId);
+		if (!(plugin.config.isEnabled ? plugin.config.isEnabled(account, cfg) : isAccountEnabled(account))) continue;
+		if (!plugin.config.isConfigured) return true;
+		if (await plugin.config.isConfigured(account, cfg)) return true;
+	}
+	return false;
+}
+async function listConfiguredMessageChannels(cfg) {
+	const channels = [];
+	for (const plugin of listChannelPlugins()) {
+		if (!isKnownChannel(plugin.id)) continue;
+		if (await isPluginConfigured(plugin, cfg)) channels.push(plugin.id);
+	}
+	return channels;
+}
+async function resolveMessageChannelSelection(params) {
+	const normalized = normalizeMessageChannel(params.channel);
+	if (normalized) {
+		if (!isKnownChannel(normalized)) throw new Error(`Unknown channel: ${String(normalized)}`);
+		return {
+			channel: normalized,
+			configured: await listConfiguredMessageChannels(params.cfg)
+		};
+	}
+	const configured = await listConfiguredMessageChannels(params.cfg);
+	if (configured.length === 1) return {
+		channel: configured[0],
+		configured
+	};
+	if (configured.length === 0) throw new Error("Channel is required (no configured channels detected).");
+	throw new Error(`Channel is required when multiple channels are configured: ${configured.join(", ")}`);
+}
+
+//#endregion
+export { resolveMessageChannelSelection as n, listConfiguredMessageChannels as t };

package/dist/channel-selection-DR7eW8UG.js

@@ -0,0 +1,51 @@
+import { c as normalizeMessageChannel, s as listDeliverableMessageChannels } from "./message-channel-DF4I2vOK.js";
+import { n as listChannelPlugins } from "./plugins-D6-JJ1il.js";
+
+//#region src/infra/outbound/channel-selection.ts
+const getMessageChannels = () => listDeliverableMessageChannels();
+function isKnownChannel(value) {
+	return getMessageChannels().includes(value);
+}
+function isAccountEnabled(account) {
+	if (!account || typeof account !== "object") return true;
+	return account.enabled !== false;
+}
+async function isPluginConfigured(plugin, cfg) {
+	const accountIds = plugin.config.listAccountIds(cfg);
+	if (accountIds.length === 0) return false;
+	for (const accountId of accountIds) {
+		const account = plugin.config.resolveAccount(cfg, accountId);
+		if (!(plugin.config.isEnabled ? plugin.config.isEnabled(account, cfg) : isAccountEnabled(account))) continue;
+		if (!plugin.config.isConfigured) return true;
+		if (await plugin.config.isConfigured(account, cfg)) return true;
+	}
+	return false;
+}
+async function listConfiguredMessageChannels(cfg) {
+	const channels = [];
+	for (const plugin of listChannelPlugins()) {
+		if (!isKnownChannel(plugin.id)) continue;
+		if (await isPluginConfigured(plugin, cfg)) channels.push(plugin.id);
+	}
+	return channels;
+}
+async function resolveMessageChannelSelection(params) {
+	const normalized = normalizeMessageChannel(params.channel);
+	if (normalized) {
+		if (!isKnownChannel(normalized)) throw new Error(`Unknown channel: ${String(normalized)}`);
+		return {
+			channel: normalized,
+			configured: await listConfiguredMessageChannels(params.cfg)
+		};
+	}
+	const configured = await listConfiguredMessageChannels(params.cfg);
+	if (configured.length === 1) return {
+		channel: configured[0],
+		configured
+	};
+	if (configured.length === 0) throw new Error("Channel is required (no configured channels detected).");
+	throw new Error(`Channel is required when multiple channels are configured: ${configured.join(", ")}`);
+}
+
+//#endregion
+export { resolveMessageChannelSelection as n, listConfiguredMessageChannels as t };