@openclaw/irc 2026.7.2-beta.7 → 2026.8.1-beta.2

package/dist/api.js

@@ -1,3 +1,3 @@
-import { _ as resolveDefaultIrcAccountId, g as listIrcAccountIds, h as listEnabledIrcAccounts, n as ircSetupWizard, r as ircSetupAdapter, t as ircPlugin, v as resolveIrcAccount } from "./channel-DoavT7vs.js";
+import { _ as resolveDefaultIrcAccountId, g as listIrcAccountIds, h as listEnabledIrcAccounts, n as ircSetupWizard, r as ircSetupAdapter, t as ircPlugin, v as resolveIrcAccount } from "./channel-Bfg9kJRw.js";
 import { n as setIrcRuntime } from "./runtime-xy-FcjJC.js";
 export { ircPlugin, ircSetupAdapter, ircSetupWizard, listEnabledIrcAccounts, listIrcAccountIds, resolveDefaultIrcAccountId, resolveIrcAccount, setIrcRuntime };

package/dist/{channel-DoavT7vs.js → channel-Bfg9kJRw.js}

@@ -1,4 +1,4 @@
-import { t as IrcChannelConfigSchema } from "./config-schema-BPoye3--.js";
+import { t as IrcChannelConfigSchema } from "./config-schema-DdB_h5mL.js";
 import { t as getIrcRuntime } from "./runtime-xy-FcjJC.js";
 import { n as collectRuntimeConfigAssignments, r as secretTargetRegistryEntries } from "./secret-contract-D_DC3YWj.js";
 import { createAccountListHelpers, describeAccountSnapshot } from "openclaw/plugin-sdk/account-helpers";
@@ -18,7 +18,7 @@ import { normalizeResolvedSecretInputString } from "openclaw/plugin-sdk/secret-i
 import { normalizeLowercaseStringOrEmpty, normalizeOptionalLowercaseString, normalizeOptionalString, normalizeStringEntries, normalizeStringifiedOptionalString, uniqueStrings } from "openclaw/plugin-sdk/string-coerce-runtime";
 import { createAccountStatusSink, createMessageReceiptFromOutboundResults, defineChannelMessageAdapter, runPassiveAccountLifecycle, sanitizeForPlainText } from "openclaw/plugin-sdk/channel-outbound";
 import { PAIRING_APPROVED_MESSAGE } from "openclaw/plugin-sdk/channel-status";
-import { chunkTextForOutbound, convertMarkdownTables, sanitizeAssistantVisibleText } from "openclaw/plugin-sdk/text-chunking";
+import { chunkTextForOutbound, convertMarkdownTables, sanitizeAssistantVisibleText, stripMarkdown } from "openclaw/plugin-sdk/text-chunking";
 import { resolveMarkdownTableMode } from "openclaw/plugin-sdk/markdown-table-runtime";
 import { requireRuntimeConfig } from "openclaw/plugin-sdk/plugin-config-runtime";
 import net from "node:net";
@@ -183,7 +183,7 @@ const collectIrcMutableAllowlistWarnings = createDangerousNameMatchingMutableAll
 });
 //#endregion
 //#region extensions/irc/src/gateway.ts
-const loadIrcChannelRuntime$1 = createLazyRuntimeModule(() => import("./channel-runtime-DsN_0hPp.js"));
+const loadIrcChannelRuntime$1 = createLazyRuntimeModule(() => import("./channel-runtime-kWMtRD4g.js"));
 async function startIrcGatewayAccount(ctx) {
 	const account = ctx.account;
 	const statusSink = createAccountStatusSink({
@@ -334,7 +334,7 @@ function takeIrcPrivmsgChunk(text, maxChars, maxBytes) {
 	if (splitAt >= Math.floor(fitted.length / 2)) return fitted.slice(0, splitAt);
 	return fitted;
 }
-function toError(err) {
+function toIrcError(err) {
 	if (err instanceof Error) return err;
 	return new Error(typeof err === "string" ? err : JSON.stringify(err));
 }
@@ -391,7 +391,7 @@ async function connectIrcClient(options) {
 		rejectReady = reject;
 	});
 	const fail = (err) => {
-		const error = toError(err);
+		const error = toIrcError(err);
 		if (options.onError) options.onError(error);
 		if (!ready && rejectReady) {
 			rejectReady(error);
@@ -726,9 +726,9 @@ async function sendMessageIrc(to, text, opts) {
 		channel: "irc",
 		accountId: account.accountId
 	});
-	const prepared = convertMarkdownTables(text.trim(), tableMode);
+	const prepared = stripMarkdown(convertMarkdownTables(text.trim(), tableMode));
+	if (!prepared.trim()) throw new Error("Message must be non-empty for IRC sends");
 	const payload = opts.replyTo ? `${prepared}\n\n[reply:${opts.replyTo}]` : prepared;
-	if (!payload.trim()) throw new Error("Message must be non-empty for IRC sends");
 	const client = opts.client;
 	if (client?.isReady()) client.sendPrivmsg(target, payload);
 	else {
@@ -1028,7 +1028,8 @@ const ircSetupContract = defineChannelSetupContract({
 			cli: {
 				flags: "--use-env",
 				description: "Use IRC environment configuration"
-			}
+			},
+			envVars: ["IRC_HOST", "IRC_NICK"]
 		}
 	},
 	legacyAdapter: ircSetupAdapter
@@ -1398,7 +1399,7 @@ const meta = {
 	systemImage: "number",
 	markdownCapable: true
 };
-const loadIrcChannelRuntime = createLazyRuntimeModule(() => import("./channel-runtime-DsN_0hPp.js"));
+const loadIrcChannelRuntime = createLazyRuntimeModule(() => import("./channel-runtime-kWMtRD4g.js"));
 function normalizePairingTarget(raw) {
 	const normalized = normalizeIrcAllowEntry(raw);
 	if (!normalized) return "";
@@ -1470,7 +1471,6 @@ const ircPlugin = createChatChannelPlugin({
 			...meta,
 			quickstartAllowFrom: true
 		},
-		setup: ircSetupAdapter,
 		setupContract: ircSetupContract,
 		setupWizard: ircSetupWizard,
 		capabilities: {
@@ -1532,6 +1532,10 @@ const ircPlugin = createChatChannelPlugin({
 		messaging: {
 			targetPrefixes: ["irc"],
 			normalizeTarget: normalizeIrcMessagingTarget,
+			inferTargetChatType: ({ to }) => {
+				const target = normalizeIrcMessagingTarget(to);
+				return target ? isChannelTarget(target) ? "group" : "direct" : void 0;
+			},
 			resolveOutboundSessionRoute: (params) => resolveIrcOutboundSessionRoute(params),
 			targetResolver: {
 				looksLikeId: looksLikeIrcTargetId,

package/dist/channel-config-api.js

@@ -1,2 +1,2 @@
-import { t as IrcChannelConfigSchema } from "./config-schema-BPoye3--.js";
+import { t as IrcChannelConfigSchema } from "./config-schema-DdB_h5mL.js";
 export { IrcChannelConfigSchema };

package/dist/channel-plugin-api.js

@@ -1,2 +1,2 @@
-import { t as ircPlugin } from "./channel-DoavT7vs.js";
+import { t as ircPlugin } from "./channel-Bfg9kJRw.js";
 export { ircPlugin };

package/dist/{channel-runtime-DsN_0hPp.js → channel-runtime-kWMtRD4g.js}

@@ -1,10 +1,11 @@
-import { a as resolveIrcGroupRequireMention, c as buildIrcAllowlistCandidates, d as buildIrcConnectOptions, f as connectIrcClient, i as resolveIrcGroupMatch, l as isChannelTarget, m as parseIrcPrefix, o as sanitizeIrcAssistantText, p as parseIrcLine, s as sendMessageIrc, u as normalizeIrcAllowEntry, v as resolveIrcAccount } from "./channel-DoavT7vs.js";
+import { a as resolveIrcGroupRequireMention, c as buildIrcAllowlistCandidates, d as buildIrcConnectOptions, f as connectIrcClient, i as resolveIrcGroupMatch, l as isChannelTarget, m as parseIrcPrefix, o as sanitizeIrcAssistantText, p as parseIrcLine, s as sendMessageIrc, u as normalizeIrcAllowEntry, v as resolveIrcAccount } from "./channel-Bfg9kJRw.js";
 import { t as getIrcRuntime } from "./runtime-xy-FcjJC.js";
 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 { resolveLoggerBackedRuntime } from "openclaw/plugin-sdk/extension-shared";
-import { buildChannelInboundEventContext, logInboundDrop, resolveChannelInboundRouteEnvelope } from "openclaw/plugin-sdk/channel-inbound";
+import { channelReadyPatch } from "openclaw/plugin-sdk/gateway-runtime";
+import { logInboundDrop, resolveChannelInboundRouteEnvelope } from "openclaw/plugin-sdk/channel-inbound";
 import { channelIngressRoutes, createChannelIngressResolver, defineStableChannelIngressIdentity } from "openclaw/plugin-sdk/channel-ingress-runtime";
 import { createChannelPairingController } from "openclaw/plugin-sdk/channel-pairing";
 import { isDangerousNameMatchingEnabled } from "openclaw/plugin-sdk/dangerous-name-runtime";
@@ -46,6 +47,23 @@ const ircIngressIdentity = defineStableChannelIngressIdentity({
 	resolveEntryId: ({ entryIndex, fieldKey }) => `irc-entry-${entryIndex + 1}:${fieldKey === "irc-nick" ? "nick" : "id"}`
 });
 const escapeIrcRegexLiteral = (value) => value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+const IRC_NICK_CHARACTER = String.raw`[A-Za-z0-9_\-\[\]\\\x60^{}|~]`;
+const IRC_RFC1459_CASE_EQUIVALENTS = /* @__PURE__ */ new Map([
+	["[", "{"],
+	["{", "["],
+	["]", "}"],
+	["}", "]"],
+	["\\", "|"],
+	["|", "\\"],
+	["^", "~"],
+	["~", "^"]
+]);
+function buildIrcNickMentionPattern(value) {
+	return Array.from(value, (character) => {
+		const equivalent = IRC_RFC1459_CASE_EQUIVALENTS.get(character);
+		return equivalent ? `[${escapeIrcRegexLiteral(character)}${escapeIrcRegexLiteral(equivalent)}]` : escapeIrcRegexLiteral(character);
+	}).join("");
+}
 function isBareNick(value) {
 	return !value.includes("!") && !value.includes("@");
 }
@@ -165,7 +183,7 @@ async function handleIrcInbound(params) {
 	const hasControlCommand = core.channel.text.hasControlCommand(rawBody, config);
 	const mentionRegexes = core.channel.mentions.buildMentionRegexes(config);
 	const mentionNick = connectedNick?.trim() || account.nick;
-	const explicitMentionRegex = mentionNick ? new RegExp(`\\b${escapeIrcRegexLiteral(mentionNick)}\\b[:,]?`, "i") : null;
+	const explicitMentionRegex = mentionNick ? new RegExp(`(?<!${IRC_NICK_CHARACTER})${buildIrcNickMentionPattern(mentionNick)}(?!${IRC_NICK_CHARACTER})[:,]?`, "i") : null;
 	const wasMentioned = core.channel.mentions.matchesMentionPatterns(rawBody, mentionRegexes) || (explicitMentionRegex ? explicitMentionRegex.test(rawBody) : false);
 	const requireMention = message.isGroup ? resolveIrcGroupRequireMention({
 		groups: account.config.groups,
@@ -173,6 +191,17 @@ async function handleIrcInbound(params) {
 	}) : false;
 	const routeGroupAllowFrom = normalizeStringEntries(groupMatch.groupConfig?.allowFrom?.length ? groupMatch.groupConfig.allowFrom : groupMatch.wildcardConfig?.allowFrom);
 	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({
+		cfg: config,
+		channel: CHANNEL_ID,
+		accountId: account.accountId,
+		peer: {
+			kind: message.isGroup ? "group" : "direct",
+			id: peerId
+		}
+	});
 	const access = await createChannelIngressResolver({
 		channelId: CHANNEL_ID,
 		accountId: account.accountId,
@@ -185,6 +214,12 @@ async function handleIrcInbound(params) {
 			kind: message.isGroup ? "group" : "direct",
 			id: message.target
 		},
+		contextBinding: {
+			agentId: route.agentId,
+			sessionKey: route.sessionKey,
+			...message.messageId ? { messageId: message.messageId } : {},
+			inboundEventKind: "user_request"
+		},
 		route: routeDescriptorsForIrcGroup({
 			isGroup: message.isGroup,
 			groupPolicy,
@@ -262,17 +297,6 @@ async function handleIrcInbound(params) {
 		kind: "failed-retryable",
 		error: turnAdoptionLifecycle.abortSignal.reason
 	};
-	const channelTarget = message.target.startsWith("#") || message.target.startsWith("&") ? message.target : `#${message.target}`;
-	const peerId = message.isGroup ? channelTarget : message.senderNick;
-	const { route, buildEnvelope } = resolveChannelInboundRouteEnvelope({
-		cfg: config,
-		channel: CHANNEL_ID,
-		accountId: account.accountId,
-		peer: {
-			kind: message.isGroup ? "group" : "direct",
-			id: peerId
-		}
-	});
 	const fromLabel = message.isGroup ? message.target : senderDisplay;
 	const body = buildEnvelope({
 		channel: "IRC",
@@ -282,7 +306,8 @@ async function handleIrcInbound(params) {
 	});
 	const groupSystemPrompt = normalizeOptionalString(groupMatch.groupConfig?.systemPrompt);
 	const blockStreamingEnabled = resolveChannelStreamingBlockEnabled(account.config);
-	const ctxPayload = buildChannelInboundEventContext({
+	const ctxPayload = core.channel.inbound.buildContext({
+		channelIngress: access,
 		channel: CHANNEL_ID,
 		accountId: route.accountId,
 		messageId: message.messageId,
@@ -592,6 +617,7 @@ async function monitorIrcProvider(opts) {
 	});
 	function scheduleReconnect() {
 		if (stopped || monitorAbort.signal.aborted || reconnectTimer) return;
+		opts.statusSink?.({ lifecycle: "recovering" });
 		reconnectTimer = setTimeout(() => {
 			reconnectTimer = null;
 			connect().catch((error) => {
@@ -648,6 +674,7 @@ async function monitorIrcProvider(opts) {
 			return;
 		}
 		ingress.start();
+		opts.statusSink?.(channelReadyPatch());
 		logger.info(`[${account.accountId}] connected to ${account.host}:${account.port}${account.tls ? " (tls)" : ""} as ${nextClient.nick}`);
 	}
 	try {

package/dist/{config-schema-BPoye3--.js → config-schema-DdB_h5mL.js}

@@ -59,6 +59,7 @@ const IrcNickServSchema = z.object({
 const IrcChannelConfigSchema = buildChannelConfigSchema(buildMultiAccountChannelSchema(z.object({
 	name: z.string().optional(),
 	enabled: z.boolean().optional(),
+	configWrites: z.boolean().optional(),
 	dangerouslyAllowNameMatching: z.boolean().optional(),
 	host: z.string().optional(),
 	port: z.number().int().min(1).max(65535).optional(),

package/dist/doctor-contract-api.js

@@ -1,4 +1,4 @@
-import { defineChannelAliasMigration } from "openclaw/plugin-sdk/runtime-doctor";
+import { defineChannelAliasMigration } from "openclaw/plugin-sdk/runtime-doctor-migrations";
 //#region extensions/irc/doctor-contract-api.ts
 const streamingAliasMigration = defineChannelAliasMigration({
 	channelId: "irc",

package/openclaw.plugin.json

@@ -1,5 +1,8 @@
 {
   "id": "irc",
+  "doctorContract": {
+    "configRepair": true
+  },
   "activation": {
     "onStartup": false
   },
@@ -23,6 +26,9 @@
           "enabled": {
             "type": "boolean"
           },
+          "configWrites": {
+            "type": "boolean"
+          },
           "dangerouslyAllowNameMatching": {
             "type": "boolean"
           },
@@ -346,6 +352,9 @@
                 "enabled": {
                   "type": "boolean"
                 },
+                "configWrites": {
+                  "type": "boolean"
+                },
                 "dangerouslyAllowNameMatching": {
                   "type": "boolean"
                 },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openclaw/irc",
-  "version": "2026.7.2-beta.7",
+  "version": "2026.8.1-beta.2",
   "description": "OpenClaw IRC channel plugin",
   "type": "module",
   "openclaw": {
@@ -111,16 +111,20 @@
             "cli": {
               "flags": "--use-env",
               "description": "Use IRC environment configuration"
-            }
+            },
+            "envVars": [
+              "IRC_HOST",
+              "IRC_NICK"
+            ]
           }
         ]
       }
     },
     "compat": {
-      "pluginApi": ">=2026.7.2-beta.7"
+      "pluginApi": ">=2026.8.1-beta.2"
     },
     "build": {
-      "openclawVersion": "2026.7.2-beta.7",
+      "openclawVersion": "2026.8.1-beta.2",
       "bundledDist": false
     },
     "release": {
@@ -145,7 +149,7 @@
     "README.md"
   ],
   "peerDependencies": {
-    "openclaw": ">=2026.7.2-beta.7"
+    "openclaw": ">=2026.8.1-beta.2"
   },
   "peerDependenciesMeta": {
     "openclaw": {