@openclaw/irc 2026.10.2 → 2026.10.5-beta.2

package/dist/.setup/{channel-DP5YY5l3.mjs → channel-BXrFfvr6.mjs}

@@ -10,7 +10,6 @@ import { defineStableChannelIngressIdentity, identityEntryAuthenticationClassifi
 import { buildMutableAllowEntryDetector, collectStandardAllowlistLists, createAllowlistProviderOpenWarningCollector, createConditionalWarningCollector, createDangerousNameMatchingMutableAllowlistWarningCollector, resolveScopeKeyCaseInsensitive, resolveScopeRequireMention, resolveScopeToolsPolicy } from "openclaw/plugin-sdk/channel-policy";
 import { PAIRING_APPROVED_MESSAGE } from "openclaw/plugin-sdk/channel-status";
 import { createChannelDirectoryAdapter, createResolvedDirectoryEntriesLister } from "openclaw/plugin-sdk/directory-runtime";
-import { createLazyRuntimeModule } from "openclaw/plugin-sdk/lazy-runtime";
 import { buildBaseChannelStatusSummary, createComputedAccountStatusAdapter, createDefaultChannelRuntimeState } from "openclaw/plugin-sdk/status-helpers";
 import { resolveAccountWithDefaultFallback } from "openclaw/plugin-sdk/account-core";
 import { parseTcpPort } from "openclaw/plugin-sdk/number-runtime";
@@ -19,9 +18,12 @@ import { tryReadSecretFileSync } from "openclaw/plugin-sdk/secret-file-runtime";
 import { resolveSecretInputString } from "openclaw/plugin-sdk/secret-input";
 import { normalizeLowercaseStringOrEmpty, normalizeOptionalLowercaseString, normalizeOptionalString, normalizeStringEntries, normalizeStringifiedOptionalString, uniqueStrings } from "openclaw/plugin-sdk/string-coerce-runtime";
 import { createAccountStatusSink, createMessageReceiptFromOutboundResults, createReplyToFanout, defineChannelMessageAdapter, runPassiveAccountLifecycle, sanitizeForPlainText } from "openclaw/plugin-sdk/channel-outbound";
+import { containsAsciiControlCharacter as hasIrcControlChars } from "openclaw/plugin-sdk/string-normalization-runtime";
 import { attachChannelToResult } from "openclaw/plugin-sdk/channel-send-result";
 import { chunkTextForOutbound, convertMarkdownTables, sanitizeAssistantVisibleText, stripMarkdown } from "openclaw/plugin-sdk/text-chunking";
 import { randomUUID } from "node:crypto";
+import { createChannelPartialDeliveryError, isChannelPartialDeliveryError } from "openclaw/plugin-sdk/channel-inbound";
+import { captureEffectAuthority } from "openclaw/plugin-sdk/fetch-runtime";
 import { resolveMarkdownTableMode } from "openclaw/plugin-sdk/markdown-table-runtime";
 import { requireRuntimeConfig } from "openclaw/plugin-sdk/plugin-config-runtime";
 import net from "node:net";
@@ -197,7 +199,6 @@ const collectIrcMutableAllowlistWarnings = createDangerousNameMatchingMutableAll
 });
 //#endregion
 //#region extensions/irc/src/gateway.ts
-const loadIrcChannelRuntime$1 = createLazyRuntimeModule(() => import("./channel-runtime-BvC0hwF1.mjs"));
 async function startIrcGatewayAccount(ctx) {
 	const account = ctx.account;
 	const statusSink = createAccountStatusSink({
@@ -206,7 +207,7 @@ async function startIrcGatewayAccount(ctx) {
 	});
 	if (!account.configured) throw new Error(`IRC is not configured for account "${account.accountId}" (need host and nick in channels.irc).`);
 	ctx.log?.info?.(`[${account.accountId}] starting IRC provider (${account.host}:${account.port}${account.tls ? " tls" : ""})`);
-	const { monitorIrcProvider } = await loadIrcChannelRuntime$1();
+	const { monitorIrcProvider } = await import("./channel-runtime-FNBqToAo.mjs");
 	await runPassiveAccountLifecycle({
 		abortSignal: ctx.abortSignal,
 		start: async () => await monitorIrcProvider({
@@ -226,10 +227,6 @@ async function startIrcGatewayAccount(ctx) {
 function isIrcControlChar(charCode) {
 	return charCode <= 31 || charCode === 127;
 }
-function hasIrcControlChars(value) {
-	for (const char of value) if (isIrcControlChar(char.charCodeAt(0))) return true;
-	return false;
-}
 function stripIrcControlChars(value) {
 	let out = "";
 	for (const char of value) if (!isIrcControlChar(char.charCodeAt(0))) out += char;
@@ -352,7 +349,7 @@ function normalizeIrcNickHostEntry(value) {
 }
 function normalizeIrcNickUserEntry(value) {
 	const normalized = normalizeIrcAllowEntry(value);
-	if (!normalized || normalized === "*" || !isHostlessNickUser(normalized)) return null;
+	if (!isHostlessNickUser(normalized)) return null;
 	return normalized;
 }
 function normalizeIrcNickEntry(value) {
@@ -368,7 +365,7 @@ function createIrcIngressSubject(message) {
 		stableId: stableCandidates[stableCandidates.length - 1] ?? nick,
 		aliases: {
 			"irc-id-nick-user": candidates.find((candidate) => isHostlessNickUser(candidate)),
-			"irc-id-nick-host": stableCandidates.find((candidate) => !candidate.includes("!") && candidate.includes("@")),
+			"irc-id-nick-host": stableCandidates.find((candidate) => !candidate.includes("!")),
 			"irc-nick": nick
 		}
 	};
@@ -386,6 +383,51 @@ const ircOutboundBaseAdapter = {
 	sanitizeText: ({ text }) => sanitizeIrcAssistantText(text)
 };
 //#endregion
+//#region packages/normalization-core/src/utf16-slice.ts
+function isHighSurrogate(codeUnit) {
+	return codeUnit >= 55296 && codeUnit <= 56319;
+}
+function isLowSurrogate(codeUnit) {
+	return codeUnit >= 56320 && codeUnit <= 57343;
+}
+/** Moves a chunk boundary away from the middle of a UTF-16 surrogate pair. */
+function avoidTrailingHighSurrogateBreak(text, start, end) {
+	if (end <= start || end >= text.length || !isHighSurrogate(text.charCodeAt(end - 1)) || !isLowSurrogate(text.charCodeAt(end))) return end;
+	const adjusted = end - 1;
+	return adjusted > start ? adjusted : end + 1;
+}
+//#endregion
+//#region packages/normalization-core/src/grapheme.ts
+let graphemeSegmenter;
+function getGraphemeSegmenter() {
+	graphemeSegmenter ??= new Intl.Segmenter(void 0, { granularity: "grapheme" });
+	return graphemeSegmenter;
+}
+/** Uses the same source text that created segments. */
+function containingSegment(segments, text, index) {
+	const position = Number.isNaN(index) ? 0 : Math.trunc(index);
+	const codePoint = text.codePointAt(position);
+	return segments.containing(codePoint !== void 0 && codePoint > 65535 ? position + 1 : position);
+}
+/**
+* Chooses a whole-grapheme cut within the hard budget, honoring a usable preference.
+* If no whole grapheme fits, allowPartial permits a surrogate-safe progress cut;
+* a leading surrogate pair can exceed maxEnd by one code unit.
+*/
+function findGraphemeChunkEnd(text, start, maxEnd, preferredEnd = maxEnd, allowPartial = true) {
+	const hardEnd = Math.min(maxEnd, text.length);
+	if (hardEnd <= start) return start;
+	const preferred = Number.isInteger(preferredEnd) && preferredEnd > start && preferredEnd <= hardEnd ? preferredEnd : hardEnd;
+	if (preferred === text.length) return preferred;
+	const before = text.charCodeAt(preferred - 1);
+	const after = text.charCodeAt(preferred);
+	if (Number.isInteger(preferred) && before <= 127 && after <= 127 && !(before === 13 && after === 10)) return preferred;
+	const segments = getGraphemeSegmenter().segment(text);
+	let end = containingSegment(segments, text, preferred)?.index ?? preferred;
+	if (end <= start && preferred < hardEnd) end = hardEnd === text.length ? hardEnd : containingSegment(segments, text, hardEnd)?.index ?? hardEnd;
+	return end > start ? end : allowPartial ? avoidTrailingHighSurrogateBreak(text, start, hardEnd) : start;
+}
+//#endregion
 //#region extensions/irc/src/protocol.ts
 const IRC_TARGET_PATTERN = /^[^\s:]+$/u;
 function parseIrcLine(line) {
@@ -451,20 +493,13 @@ function parseIrcPrefix(prefix) {
 	if (prefix.includes(".")) return { server: prefix };
 	return { nick: prefix };
 }
-function decodeLiteralEscapes(input) {
-	return input.replace(/\\r/g, "\r").replace(/\\n/g, "\n").replace(/\\t/g, "	").replace(/\\0/g, "\0").replace(/\\x([0-9a-fA-F]{2})/g, (_, hex) => String.fromCharCode(Number.parseInt(hex, 16))).replace(/\\u([dD][89abAB][0-9a-fA-F]{2})\\u([dD][c-fC-F][0-9a-fA-F]{2})/g, (_match, h, l) => String.fromCodePoint(65536 + (Number.parseInt(h, 16) - 55296 << 10) + (Number.parseInt(l, 16) - 56320))).replace(/\\u([0-9a-fA-F]{4})/g, (match, hex) => {
-		const codePoint = Number.parseInt(hex, 16);
-		return codePoint >= 55296 && codePoint <= 57343 ? match : String.fromCharCode(codePoint);
-	});
-}
 function sanitizeIrcOutboundText(text) {
-	return stripIrcControlChars(decodeLiteralEscapes(text).replace(/\r?\n/g, " ")).trim();
+	return stripIrcControlChars(text.replace(/\r?\n/g, " ")).trim();
 }
 function sanitizeIrcTarget(raw) {
-	const decoded = decodeLiteralEscapes(raw);
-	if (!decoded) throw new Error("IRC target is required");
-	if (decoded !== decoded.trim() || hasIrcControlChars(decoded) || !IRC_TARGET_PATTERN.test(decoded)) throw new Error(`Invalid IRC target: ${raw}`);
-	return decoded;
+	if (!raw) throw new Error("IRC target is required");
+	if (raw !== raw.trim() || hasIrcControlChars(raw) || !IRC_TARGET_PATTERN.test(raw)) throw new Error(`Invalid IRC target: ${raw}`);
+	return raw;
 }
 //#endregion
 //#region extensions/irc/src/client.ts
@@ -475,6 +510,9 @@ const IRC_ERROR_CODES = /* @__PURE__ */ new Set([
 ]);
 const IRC_NICK_COLLISION_CODES = /* @__PURE__ */ new Set(["433", "436"]);
 const IRC_MAX_LINE_BYTES = 512;
+const IRC_MAX_RELAY_USER_BYTES = 11;
+const IRC_MAX_RELAY_HOST_BYTES = 63;
+const IRC_MAX_INBOUND_LINE_LENGTH = 16384;
 function takeIrcPrivmsgChunk(text, maxChars, maxBytes) {
 	let end = 0;
 	let bytes = 0;
@@ -486,11 +524,9 @@ function takeIrcPrivmsgChunk(text, maxChars, maxBytes) {
 	}
 	if (end === 0) throw new Error("IRC target leaves no room for message text within the 512-byte line limit");
 	if (end === text.length) return text;
-	const fitted = text.slice(0, end);
-	if (text[end] === " ") return fitted;
-	const splitAt = fitted.lastIndexOf(" ");
-	if (splitAt >= Math.floor(fitted.length / 2)) return fitted.slice(0, splitAt);
-	return fitted;
+	const splitAt = text.lastIndexOf(" ", end);
+	const preferredEnd = splitAt >= Math.floor(end / 2) ? splitAt : end;
+	return text.slice(0, findGraphemeChunkEnd(text, 0, end, preferredEnd));
 }
 function toIrcError(err) {
 	if (err instanceof Error) return err;
@@ -498,7 +534,7 @@ function toIrcError(err) {
 }
 let nickCollisionFallbackSeq = 0;
 function buildFallbackNick(nick) {
-	const base = nick.replace(/\s+/g, "").replace(/[^A-Za-z0-9_\-[\]\\`^{}|]/g, "") || "openclaw";
+	const base = nick.replace(/[^A-Za-z0-9_\-[\]\\`^{}|]/g, "") || "openclaw";
 	const seq = ++nickCollisionFallbackSeq;
 	const suffix = seq === 1 ? "_" : `_${seq}`;
 	const maxNickLen = 30;
@@ -586,18 +622,35 @@ async function connectIrcClient(options) {
 		if (!target.startsWith("#") && !target.startsWith("&")) throw new Error(`IRC JOIN target must be a channel: ${channel}`);
 		sendRaw(`JOIN ${target}`);
 	};
-	const sendPrivmsg = (target, text, replyTo) => {
+	const sendPrivmsg = async (target, text, replyTo) => {
+		const effect = captureEffectAuthority();
 		const normalizedTarget = sanitizeIrcTarget(target);
 		const cleaned = sanitizeIrcOutboundText(text);
 		if (!cleaned) throw new Error("Message must be non-empty for IRC sends");
-		const lineOverheadBytes = Buffer.byteLength(`PRIVMSG ${normalizedTarget} :\r\n`, "utf8");
+		const lineOverheadBytes = Buffer.byteLength(`:${currentNick}!@ `, "utf8") + IRC_MAX_RELAY_USER_BYTES + IRC_MAX_RELAY_HOST_BYTES + Buffer.byteLength(`PRIVMSG ${normalizedTarget} :\r\n`, "utf8");
 		const maxChunkBytes = IRC_MAX_LINE_BYTES - lineOverheadBytes;
 		let remaining = replyTo ? sanitizeIrcOutboundText(`${text}\n\n[reply:${replyTo}]`) : cleaned;
+		const chunks = [];
 		while (remaining.length > 0) {
 			const chunk = takeIrcPrivmsgChunk(remaining, messageChunkMaxChars, maxChunkBytes).trim();
-			sendRaw(`PRIVMSG ${normalizedTarget} :${chunk}`);
+			chunks.push(chunk);
 			remaining = remaining.slice(chunk.length).trimStart();
 		}
+		let sent = false;
+		await effect.initiate(() => {
+			for (const chunk of chunks) {
+				options.abortSignal?.throwIfAborted();
+				if (!ready || closed) throw new Error("IRC connection closed before send");
+				sendRaw(`PRIVMSG ${normalizedTarget} :${chunk}`);
+				sent = true;
+			}
+		}).catch((error) => {
+			if (sent) throw createChannelPartialDeliveryError(error, {
+				messageIds: [],
+				visibleReplySent: true
+			});
+			throw error;
+		});
 	};
 	const quit = (reason) => {
 		if (closed) return;
@@ -619,10 +672,22 @@ async function connectIrcClient(options) {
 		socket.destroy();
 	};
 	let buffer = "";
+	let receiveOverflowed = false;
+	const abortOversizedInput = () => {
+		receiveOverflowed = true;
+		buffer = "";
+		fail(/* @__PURE__ */ new Error(`IRC server sent a line longer than ${IRC_MAX_INBOUND_LINE_LENGTH} characters`));
+		socket.destroy();
+	};
 	socket.on("data", (chunk) => {
+		if (receiveOverflowed) return;
 		buffer += chunk;
 		let idx = buffer.indexOf("\n");
 		while (idx !== -1) {
+			if (idx > IRC_MAX_INBOUND_LINE_LENGTH) {
+				abortOversizedInput();
+				return;
+			}
 			const rawLine = buffer.slice(0, idx).replace(/\r$/, "");
 			buffer = buffer.slice(idx + 1);
 			idx = buffer.indexOf("\n");
@@ -687,10 +752,12 @@ async function connectIrcClient(options) {
 				});
 			}
 		}
+		if (buffer.length > IRC_MAX_INBOUND_LINE_LENGTH) abortOversizedInput();
 	});
 	socket.once("connect", () => {
 		try {
-			if (options.password && options.password.trim()) sendRaw(`PASS ${options.password.trim()}`);
+			const password = options.password?.trim();
+			if (password) sendRaw(password.includes(" ") || password.startsWith(":") ? `PASS :${password}` : `PASS ${password}`);
 			sendRaw(`NICK ${options.nick.trim()}`);
 			sendRaw(`USER ${options.username.trim()} 0 * :${sanitizeIrcOutboundText(options.realname)}`);
 		} catch (err) {
@@ -770,6 +837,7 @@ async function sendIrcMessages(to, text, opts, planMessages = (preparedText) =>
 	text: preparedText,
 	replyTo: opts.replyTo
 }], onDeliveryResult) {
+	const effect = captureEffectAuthority();
 	const cfg = requireRuntimeConfig(opts.cfg, "IRC send");
 	const account = resolveIrcAccount({
 		cfg,
@@ -796,19 +864,18 @@ async function sendIrcMessages(to, text, opts, planMessages = (preparedText) =>
 	const results = [];
 	try {
 		opts.abortSignal?.throwIfAborted();
-		if (transient && (target.startsWith("#") || target.startsWith("&"))) client.join(target);
+		if (transient && (target.startsWith("#") || target.startsWith("&"))) await effect.initiate(() => {
+			opts.abortSignal?.throwIfAborted();
+			if (!client.isReady()) throw new Error("IRC connection closed before join");
+			client.join(target);
+		});
 		for (const message of messages) {
 			opts.abortSignal?.throwIfAborted();
 			if (!client.isReady()) throw new Error("IRC connection closed before send");
 			await opts.onPlatformSendDispatch?.();
 			opts.abortSignal?.throwIfAborted();
 			if (!client.isReady()) throw new Error("IRC connection closed before send");
-			client.sendPrivmsg(target, message.text, message.replyTo);
-			getOptionalIrcRuntime()?.channel.activity.record({
-				channel: "irc",
-				accountId: account.accountId,
-				direction: "outbound"
-			});
+			await client.sendPrivmsg(target, message.text, message.replyTo);
 			const messageId = randomUUID();
 			const result = {
 				messageId,
@@ -824,9 +891,35 @@ async function sendIrcMessages(to, text, opts, planMessages = (preparedText) =>
 				})
 			};
 			results.push(result);
+			getOptionalIrcRuntime()?.channel.activity.record({
+				channel: "irc",
+				accountId: account.accountId,
+				direction: "outbound"
+			});
 			await onDeliveryResult?.(result);
 		}
 		return results;
+	} catch (error) {
+		if (results.length === 0) throw error;
+		const partial = isChannelPartialDeliveryError(error) ? error.deliveryResult : void 0;
+		const receipt = createMessageReceiptFromOutboundResults({
+			results: [
+				...results.map((result) => ({ receipt: result.receipt })),
+				...partial?.receipt ? [{ receipt: partial.receipt }] : [],
+				...(partial?.messageIds ?? []).filter((messageId) => !partial?.receipt?.platformMessageIds.includes(messageId)).map((messageId) => ({
+					channel: "irc",
+					messageId,
+					conversationId: target
+				}))
+			],
+			kind: "text"
+		});
+		throw createChannelPartialDeliveryError(error, {
+			...partial,
+			messageIds: receipt.platformMessageIds,
+			receipt,
+			visibleReplySent: true
+		});
 	} finally {
 		transient?.quit("sent");
 	}
@@ -972,8 +1065,8 @@ async function probeIrc(cfg, opts) {
 //#endregion
 //#region extensions/irc/src/setup-core.ts
 const channel$1 = "irc";
-const setIrcTopLevelDmPolicy = createTopLevelChannelDmPolicySetter({ channel: channel$1 });
-const setIrcTopLevelAllowFrom = createTopLevelChannelAllowFromSetter({ channel: channel$1 });
+const setIrcDmPolicy = createTopLevelChannelDmPolicySetter({ channel: channel$1 });
+const setIrcAllowFrom = createTopLevelChannelAllowFromSetter({ channel: channel$1 });
 const validateIrcRequiredSetupInput = createSetupInputPresenceValidator({ whenNotUseEnv: [{
 	someOf: ["host"],
 	message: "IRC requires host."
@@ -996,12 +1089,6 @@ function updateIrcAccountConfig(cfg, accountId, patch) {
 		ensureAccountEnabled: false
 	});
 }
-function setIrcDmPolicy(cfg, dmPolicy) {
-	return setIrcTopLevelDmPolicy(cfg, dmPolicy);
-}
-function setIrcAllowFrom(cfg, allowFrom) {
-	return setIrcTopLevelAllowFrom(cfg, allowFrom);
-}
 function setIrcNickServ(cfg, accountId, nickserv) {
 	return updateIrcAccountConfig(cfg, accountId, { nickserv });
 }
@@ -1156,7 +1243,7 @@ function normalizeGroupEntry(raw) {
 	return `#${normalized.replace(/^#+/, "")}`;
 }
 const promptIrcAllowFrom = createPromptParsedAllowFromForAccount({
-	defaultAccountId: (cfg) => resolveDefaultIrcAccountId(cfg),
+	defaultAccountId: resolveDefaultIrcAccountId,
 	noteTitle: t("wizard.irc.allowlistTitle"),
 	noteLines: [
 		t("wizard.irc.allowlistIntro"),
@@ -1222,11 +1309,7 @@ const ircDmPolicy = {
 	allowFromKey: "channels.irc.allowFrom",
 	getCurrent: (cfg) => cfg.channels?.irc?.dmPolicy ?? "pairing",
 	setPolicy: (cfg, policy) => setIrcDmPolicy(cfg, policy),
-	promptAllowFrom: async ({ cfg, prompter, accountId }) => await promptIrcAllowFrom({
-		cfg,
-		prompter,
-		accountId
-	})
+	promptAllowFrom: promptIrcAllowFrom
 };
 const ircSetupWizard = {
 	channel,
@@ -1459,7 +1542,6 @@ const meta = {
 	systemImage: "number",
 	markdownCapable: true
 };
-const loadIrcChannelRuntime = createLazyRuntimeModule(() => import("./channel-runtime-BvC0hwF1.mjs"));
 function normalizePairingTarget(raw) {
 	const normalized = normalizeIrcAllowEntry(raw);
 	if (!normalized) return "";
@@ -1697,7 +1779,7 @@ const ircPlugin = createChatChannelPlugin({
 		notify: async ({ cfg, id, message, accountId }) => {
 			const target = normalizePairingTarget(id);
 			if (!target) throw new Error(`invalid IRC pairing id: ${id}`);
-			const { sendMessageIrc } = await loadIrcChannelRuntime();
+			const { sendMessageIrc } = await import("./channel-runtime-FNBqToAo.mjs");
 			await sendMessageIrc(target, message, {
 				cfg,
 				accountId

package/dist/.setup/{channel-plugin-api-tjqFvfGT.mjs → channel-plugin-api-tb7ep4Ml.mjs}

@@ -1,3 +1,3 @@
-import { t as ircPlugin } from "./channel-DP5YY5l3.mjs";
+import { t as ircPlugin } from "./channel-BXrFfvr6.mjs";
 import "../channel-plugin-api.js";
 export { ircPlugin };

package/dist/.setup/{channel-runtime-BvC0hwF1.mjs → channel-runtime-FNBqToAo.mjs}

@@ -1,12 +1,14 @@
-import { a as resolveIrcGroupRequireMention, c as connectIrcClient, d as sanitizeIrcAssistantText, f as createIrcIngressSubject, h as normalizeIrcAllowEntry, i as resolveIrcGroupMatch, l as parseIrcLine, m as isChannelTarget, o as sendMessageIrc, p as ircIngressIdentity, s as buildIrcConnectOptions, u as parseIrcPrefix, y as resolveIrcAccount } from "./channel-DP5YY5l3.mjs";
+import { a as resolveIrcGroupRequireMention, c as connectIrcClient, d as sanitizeIrcAssistantText, f as createIrcIngressSubject, h as normalizeIrcAllowEntry, i as resolveIrcGroupMatch, l as parseIrcLine, m as isChannelTarget, o as sendMessageIrc, p as ircIngressIdentity, s as buildIrcConnectOptions, u as parseIrcPrefix, y as resolveIrcAccount } from "./channel-BXrFfvr6.mjs";
 import { t as getIrcRuntime } from "./runtime-C_V9tmpk.mjs";
 import { channelIngressRoutes } from "openclaw/plugin-sdk/channel-ingress-runtime";
+import { computeBackoff } from "openclaw/plugin-sdk/runtime-env";
 import { normalizeLowercaseStringOrEmpty, normalizeOptionalString, normalizeStringEntries } from "openclaw/plugin-sdk/string-coerce-runtime";
 import { bindIngressLifecycleToReplyOptions, createChannelIngressError, createChannelIngressMonitor, resolveChannelStreamingBlockEnabled } from "openclaw/plugin-sdk/channel-outbound";
 import { randomUUID } from "node:crypto";
+import { createChannelInboundEnvelopeBuilderAsync, logInboundDrop } from "openclaw/plugin-sdk/channel-inbound";
 import { resolveLoggerBackedRuntime } from "openclaw/plugin-sdk/extension-shared";
+import { resolveAgentRoute } from "openclaw/plugin-sdk/routing";
 import { channelReadyPatch } from "openclaw/plugin-sdk/gateway-runtime";
-import { logInboundDrop, resolveChannelInboundRouteEnvelope } from "openclaw/plugin-sdk/channel-inbound";
 import { createChannelPairingController } from "openclaw/plugin-sdk/channel-pairing";
 import { isDangerousNameMatchingEnabled } from "openclaw/plugin-sdk/dangerous-name-runtime";
 import { deliverFormattedTextWithAttachments } from "openclaw/plugin-sdk/reply-payload";
@@ -34,26 +36,6 @@ function buildIrcNickMentionPattern(value) {
 function hasEntries(entries) {
 	return normalizeStringEntries(entries).some((entry) => normalizeIrcAllowEntry(entry));
 }
-function routeDescriptorsForIrcGroup(params) {
-	if (!params.isGroup) return [];
-	return channelIngressRoutes(params.groupPolicy === "allowlist" && {
-		id: "irc:channel",
-		allowed: params.hasConfiguredGroups && params.groupAllowed,
-		precedence: 0,
-		matchId: "irc-channel",
-		blockReason: "channel_not_allowlisted"
-	}, !params.groupEnabled && {
-		id: "irc:channel-enabled",
-		enabled: false,
-		precedence: 10,
-		blockReason: "channel_disabled"
-	}, hasEntries(params.routeGroupAllowFrom) && {
-		id: "irc:channel-sender",
-		precedence: 20,
-		senderPolicy: "replace",
-		senderAllowFrom: params.routeGroupAllowFrom
-	});
-}
 async function deliverIrcReply(params) {
 	await deliverFormattedTextWithAttachments({
 		payload: {
@@ -123,7 +105,7 @@ async function handleIrcInbound(params) {
 	const accessGroupPolicy = groupPolicy === "open" && (hasEntries(account.config.groupAllowFrom) || hasEntries(routeGroupAllowFrom)) ? "allowlist" : groupPolicy;
 	const channelTarget = message.target.startsWith("#") || message.target.startsWith("&") ? message.target : `#${message.target}`;
 	const peerId = message.isGroup ? channelTarget : message.senderNick;
-	const { route, buildEnvelope } = resolveChannelInboundRouteEnvelope({
+	const route = resolveAgentRoute({
 		cfg: config,
 		channel: CHANNEL_ID,
 		accountId: account.accountId,
@@ -150,14 +132,23 @@ async function handleIrcInbound(params) {
 			...message.messageId ? { messageId: message.messageId } : {},
 			inboundEventKind: "user_request"
 		},
-		route: routeDescriptorsForIrcGroup({
-			isGroup: message.isGroup,
-			groupPolicy,
-			groupAllowed: groupMatch.allowed,
-			hasConfiguredGroups: groupMatch.hasConfiguredGroups,
-			groupEnabled: groupMatch.groupConfig?.enabled !== false && groupMatch.wildcardConfig?.enabled !== false,
-			routeGroupAllowFrom
-		}),
+		route: message.isGroup ? channelIngressRoutes(groupPolicy === "allowlist" && {
+			id: "irc:channel",
+			allowed: groupMatch.hasConfiguredGroups && groupMatch.allowed,
+			precedence: 0,
+			matchId: "irc-channel",
+			blockReason: "channel_not_allowlisted"
+		}, (groupMatch.groupConfig?.enabled === false || groupMatch.wildcardConfig?.enabled === false) && {
+			id: "irc:channel-enabled",
+			enabled: false,
+			precedence: 10,
+			blockReason: "channel_disabled"
+		}, hasEntries(routeGroupAllowFrom) && {
+			id: "irc:channel-sender",
+			precedence: 20,
+			senderPolicy: "replace",
+			senderAllowFrom: routeGroupAllowFrom
+		}) : [],
 		mentionFacts: message.isGroup ? {
 			canDetectMention: true,
 			wasMentioned,
@@ -229,7 +220,10 @@ async function handleIrcInbound(params) {
 		error: turnAdoptionLifecycle.abortSignal.reason
 	};
 	const fromLabel = message.isGroup ? message.target : senderDisplay;
-	const body = buildEnvelope({
+	const body = (await createChannelInboundEnvelopeBuilderAsync({
+		cfg: config,
+		route
+	}))({
 		channel: "IRC",
 		from: fromLabel,
 		timestamp: message.timestamp,
@@ -476,8 +470,31 @@ function createIrcIngressMonitor(options) {
 	};
 }
 //#endregion
+//#region extensions/irc/src/reconnect-backoff.ts
+const IRC_RECONNECT_BACKOFF = {
+	initialMs: 1e3,
+	maxMs: 3e4,
+	factor: 2,
+	jitter: .2
+};
+const IRC_RECONNECT_STABLE_MS = 6e4;
+function createIrcReconnectBackoff(now = Date.now) {
+	let attempt = 0;
+	let connectedAt;
+	return {
+		markConnected: () => {
+			connectedAt = now();
+		},
+		nextDelayMs: () => {
+			if (connectedAt !== void 0 && now() - connectedAt >= IRC_RECONNECT_STABLE_MS) attempt = 0;
+			connectedAt = void 0;
+			attempt += 1;
+			return computeBackoff(IRC_RECONNECT_BACKOFF, attempt);
+		}
+	};
+}
+//#endregion
 //#region extensions/irc/src/monitor.ts
-const IRC_MONITOR_RECONNECT_DELAY_MS = 1e3;
 async function monitorIrcProvider(opts) {
 	const core = getIrcRuntime();
 	const cfg = opts.config ?? core.config.current();
@@ -495,6 +512,7 @@ async function monitorIrcProvider(opts) {
 	let activeConnectionEpoch = null;
 	let ingressPause = Promise.resolve();
 	let reconnectTimer = null;
+	const reconnectBackoff = createIrcReconnectBackoff();
 	let stopped = false;
 	const monitorAbort = new AbortController();
 	const abortSignal = opts.abortSignal ? AbortSignal.any([opts.abortSignal, monitorAbort.signal]) : monitorAbort.signal;
@@ -528,7 +546,7 @@ async function monitorIrcProvider(opts) {
 					const replyClient = client;
 					if (!replyClient || !replyClient.isReady() || stopped || abortSignal.aborted) throw new Error("IRC transport disconnected before reply send.");
 					if (!message.isGroup && context.connectionEpoch !== activeConnectionEpoch) throw new Error("IRC connection changed before private reply send.");
-					replyClient.sendPrivmsg(target, text);
+					await replyClient.sendPrivmsg(target, text);
 					opts.statusSink?.({ lastOutboundAt: Date.now() });
 					core.channel.activity.record({
 						channel: "irc",
@@ -543,6 +561,7 @@ async function monitorIrcProvider(opts) {
 	function scheduleReconnect() {
 		if (stopped || abortSignal.aborted || reconnectTimer) return;
 		opts.statusSink?.({ lifecycle: "recovering" });
+		const delayMs = reconnectBackoff.nextDelayMs();
 		reconnectTimer = setTimeout(() => {
 			reconnectTimer = null;
 			connect().catch((error) => {
@@ -551,7 +570,8 @@ async function monitorIrcProvider(opts) {
 				logger.error(`[${account.accountId}] IRC reconnect failed: ${message}`);
 				scheduleReconnect();
 			});
-		}, IRC_MONITOR_RECONNECT_DELAY_MS);
+		}, delayMs);
+		return delayMs;
 	}
 	async function connect() {
 		if (stopped || abortSignal.aborted) return;
@@ -573,8 +593,8 @@ async function monitorIrcProvider(opts) {
 				ingressPause = ingress.pause();
 				if (activeConnectionEpoch === ingressConnection.connectionEpoch) activeConnectionEpoch = null;
 				client = null;
-				logger.warn?.(`[${account.accountId}] IRC connection closed; reconnecting in ${IRC_MONITOR_RECONNECT_DELAY_MS}ms`);
-				scheduleReconnect();
+				const delayMs = scheduleReconnect();
+				if (delayMs !== void 0) logger.warn?.(`[${account.accountId}] IRC connection closed; reconnecting in ${delayMs}ms`);
 			},
 			onPrivmsg: async (event) => {
 				await ingressConnection.accept(event.rawLine, event.connectedNick);
@@ -599,6 +619,7 @@ async function monitorIrcProvider(opts) {
 			return;
 		}
 		ingress.start();
+		reconnectBackoff.markConnected();
 		opts.statusSink?.(channelReadyPatch());
 		logger.info(`[${account.accountId}] connected to ${account.host}:${account.port}${account.tls ? " (tls)" : ""} as ${nextClient.nick}`);
 	}

package/dist/api.js

@@ -1,3 +1,3 @@
-import { _ as listIrcAccountIds, g as listEnabledIrcAccounts, n as ircSetupWizard, r as ircSetupAdapter, t as ircPlugin, v as resolveDefaultIrcAccountId, y as resolveIrcAccount } from "./.setup/channel-DP5YY5l3.mjs";
+import { _ as listIrcAccountIds, g as listEnabledIrcAccounts, n as ircSetupWizard, r as ircSetupAdapter, t as ircPlugin, v as resolveDefaultIrcAccountId, y as resolveIrcAccount } from "./.setup/channel-BXrFfvr6.mjs";
 import { r as setIrcRuntime } from "./.setup/runtime-C_V9tmpk.mjs";
 export { ircPlugin, ircSetupAdapter, ircSetupWizard, listEnabledIrcAccounts, listIrcAccountIds, resolveDefaultIrcAccountId, resolveIrcAccount, setIrcRuntime };

package/dist/channel-plugin-api.js

@@ -1,2 +1,2 @@
-import { t as ircPlugin } from "./.setup/channel-DP5YY5l3.mjs";
+import { t as ircPlugin } from "./.setup/channel-BXrFfvr6.mjs";
 export { ircPlugin };

package/dist/setup-entry.js

@@ -4,7 +4,7 @@ import { fileURLToPath } from "node:url";
 var setup_entry_default = defineBundledChannelSetupEntry({
 	importMetaUrl: import.meta.url,
 	plugin: {
-		specifier: fileURLToPath(new URL(".setup/channel-plugin-api-tjqFvfGT.mjs", import.meta.url).href),
+		specifier: fileURLToPath(new URL(".setup/channel-plugin-api-tb7ep4Ml.mjs", import.meta.url).href),
 		exportName: "ircPlugin"
 	},
 	secrets: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openclaw/irc",
-  "version": "2026.10.2",
+  "version": "2026.10.5-beta.2",
   "description": "OpenClaw IRC channel plugin",
   "type": "module",
   "openclaw": {
@@ -121,10 +121,10 @@
       }
     },
     "compat": {
-      "pluginApi": ">=2026.10.2"
+      "pluginApi": ">=2026.10.5-beta.2"
     },
     "build": {
-      "openclawVersion": "2026.10.2",
+      "openclawVersion": "2026.10.5-beta.2",
       "bundledDist": false
     },
     "release": {
@@ -151,7 +151,7 @@
     "assets/activity.svg"
   ],
   "peerDependencies": {
-    "openclaw": ">=2026.10.2"
+    "openclaw": ">=2026.10.5-beta.2"
   },
   "peerDependenciesMeta": {
     "openclaw": {