@openclaw/twitch 2026.5.9-beta.1 → 2026.5.10-beta.1

package/dist/api.js

@@ -1,3 +1,3 @@
-import { t as twitchPlugin } from "./plugin-CoIt3s7P.js";
+import { t as twitchPlugin } from "./plugin-BLMSYnzs.js";
 import { n as setTwitchRuntime } from "./runtime-QZ5I3GlI.js";
 export { setTwitchRuntime, twitchPlugin };

package/dist/channel-plugin-api.js

@@ -1,2 +1,2 @@
-import { t as twitchPlugin } from "./plugin-CoIt3s7P.js";
+import { t as twitchPlugin } from "./plugin-BLMSYnzs.js";
 export { twitchPlugin };

package/dist/{monitor-DmMYPZvJ.js → monitor-DvbgvvL4.js}

@@ -2,116 +2,127 @@ import { i as getOrCreateClientManager, n as stripMarkdownForTwitch } from "./ma
 import { t as getTwitchRuntime } from "./runtime-QZ5I3GlI.js";
 import { formatErrorMessage } from "openclaw/plugin-sdk/error-runtime";
 import { normalizeLowercaseStringOrEmpty } from "openclaw/plugin-sdk/text-runtime";
+import { createChannelIngressResolver, defineStableChannelIngressIdentity } from "openclaw/plugin-sdk/channel-ingress-runtime";
 //#region extensions/twitch/src/access-control.ts
-/**
-* Check if a Twitch message should be allowed based on account configuration
-*
-* This function implements the access control logic for incoming Twitch messages,
-* checking allowlists, role-based restrictions, and mention requirements.
-*
-* Priority order:
-* 1. If `requireMention` is true, message must mention the bot
-* 2. If `allowFrom` is set, sender must be in the allowlist (by user ID)
-* 3. If `allowedRoles` is set (and `allowFrom` is not), sender must have at least one role
-*
-* Note: `allowFrom` is a hard allowlist. When set, only those user IDs are allowed.
-* Use `allowedRoles` as an alternative when you don't want to maintain an allowlist.
-*
-* Available roles:
-* - "moderator": Moderators
-* - "owner": Channel owner/broadcaster
-* - "vip": VIPs
-* - "subscriber": Subscribers
-* - "all": Anyone in the chat
-*/
-function checkTwitchAccessControl(params) {
+const twitchUserIdentity = defineStableChannelIngressIdentity({
+	key: "sender-id",
+	entryIdPrefix: "twitch-user-entry"
+});
+const twitchRoleIdentity = defineStableChannelIngressIdentity({
+	key: "role-moderator",
+	kind: "role",
+	normalizeEntry: normalizeTwitchRole,
+	normalizeSubject: normalizeTwitchRole,
+	aliases: [
+		"owner",
+		"vip",
+		"subscriber"
+	].map((role) => ({
+		key: `role-${role}`,
+		kind: "role",
+		normalizeEntry: () => null,
+		normalizeSubject: normalizeTwitchRole
+	})),
+	isWildcardEntry: (entry) => normalizeTwitchRole(entry) === "all",
+	resolveEntryId: ({ entryIndex }) => `twitch-role-entry-${entryIndex + 1}`
+});
+async function checkTwitchAccessControl(params) {
 	const { message, account, botUsername } = params;
-	if (account.requireMention ?? true) {
-		if (!extractMentions(message.message).includes(normalizeLowercaseStringOrEmpty(botUsername))) return {
-			allowed: false,
-			reason: "message does not mention the bot (requireMention is enabled)"
-		};
-	}
-	if (account.allowFrom !== void 0) {
-		const allowFrom = account.allowFrom;
-		if (allowFrom.length === 0) return {
-			allowed: false,
-			reason: "sender is not in allowFrom allowlist"
-		};
-		const senderId = message.userId;
-		if (!senderId) return {
-			allowed: false,
-			reason: "sender user ID not available for allowlist check"
-		};
-		if (allowFrom.includes(senderId)) return {
+	const policyKind = resolveTwitchPolicyKind(account);
+	const decision = (await createChannelIngressResolver({
+		channelId: "twitch",
+		accountId: "default",
+		identity: policyKind === "role" ? twitchRoleIdentity : twitchUserIdentity
+	}).message({
+		subject: policyKind === "role" ? twitchRoleSubject(message) : { stableId: message.userId },
+		conversation: {
+			kind: "group",
+			id: message.channel
+		},
+		event: { mayPair: false },
+		mentionFacts: {
+			canDetectMention: true,
+			wasMentioned: mentionsBot(message.message, botUsername)
+		},
+		dmPolicy: "open",
+		groupPolicy: policyKind === "open" ? "open" : "allowlist",
+		policy: { activation: {
+			requireMention: account.requireMention ?? true,
+			allowTextCommands: false,
+			order: "before-sender"
+		} },
+		groupAllowFrom: policyKind === "allowFrom" ? account.allowFrom : policyKind === "role" ? account.allowedRoles : void 0
+	})).ingress;
+	if (decision.decisiveGateId === "activation" && decision.admission !== "dispatch") return {
+		allowed: false,
+		reason: "message does not mention the bot (requireMention is enabled)"
+	};
+	if (decision.admission === "dispatch") {
+		if (policyKind === "allowFrom") return {
 			allowed: true,
-			matchKey: senderId,
+			matchKey: params.message.userId,
 			matchSource: "allowlist"
 		};
-		return {
-			allowed: false,
-			reason: "sender is not in allowFrom allowlist"
-		};
-	}
-	if (account.allowedRoles && account.allowedRoles.length > 0) {
-		const allowedRoles = account.allowedRoles;
-		if (allowedRoles.includes("all")) return {
+		if (policyKind === "role") return {
 			allowed: true,
-			matchKey: "all",
+			matchKey: params.account.allowedRoles?.join(","),
 			matchSource: "role"
 		};
-		if (!checkSenderRoles({
-			message,
-			allowedRoles
-		})) return {
+		return { allowed: true };
+	}
+	if (policyKind === "allowFrom") {
+		if (!params.message.userId) return {
 			allowed: false,
-			reason: `sender does not have any of the required roles: ${allowedRoles.join(", ")}`
+			reason: "sender user ID not available for allowlist check"
 		};
 		return {
-			allowed: true,
-			matchKey: allowedRoles.join(","),
-			matchSource: "role"
+			allowed: false,
+			reason: "sender is not in allowFrom allowlist"
 		};
 	}
-	return { allowed: true };
+	if (policyKind === "role") return {
+		allowed: false,
+		reason: `sender does not have any of the required roles: ${params.account.allowedRoles?.join(", ") ?? ""}`
+	};
+	return {
+		allowed: false,
+		reason: reasonForTwitchIngressDecision(decision)
+	};
 }
-/**
-* Check if the sender has any of the allowed roles
-*/
-function checkSenderRoles(params) {
-	const { message, allowedRoles } = params;
-	const { isMod, isOwner, isVip, isSub } = message;
-	for (const role of allowedRoles) switch (role) {
-		case "moderator":
-			if (isMod) return true;
-			break;
-		case "owner":
-			if (isOwner) return true;
-			break;
-		case "vip":
-			if (isVip) return true;
-			break;
-		case "subscriber":
-			if (isSub) return true;
-			break;
+function resolveTwitchPolicyKind(account) {
+	if (account.allowFrom !== void 0) return "allowFrom";
+	if (account.allowedRoles && account.allowedRoles.length > 0) return "role";
+	return "open";
+}
+function twitchRoleSubject(message) {
+	return {
+		stableId: message.isMod ? "moderator" : void 0,
+		aliases: {
+			"role-owner": message.isOwner ? "owner" : void 0,
+			"role-vip": message.isVip ? "vip" : void 0,
+			"role-subscriber": message.isSub ? "subscriber" : void 0
+		}
+	};
+}
+function normalizeTwitchRole(value) {
+	const role = normalizeLowercaseStringOrEmpty(value);
+	if (role === "*") return "all";
+	return role === "moderator" || role === "owner" || role === "vip" || role === "subscriber" || role === "all" ? role : null;
+}
+function reasonForTwitchIngressDecision(decision) {
+	switch (decision.reasonCode) {
+		case "activation_skipped": return "message does not mention the bot (requireMention is enabled)";
+		case "group_policy_empty_allowlist":
+		case "group_policy_not_allowlisted": return "sender is not in allowFrom allowlist";
+		default: return decision.reasonCode;
 	}
-	return false;
 }
-/**
-* Extract @mentions from a Twitch chat message
-*
-* Returns a list of lowercase usernames that were mentioned in the message.
-* Twitch mentions are in the format @username.
-*/
-function extractMentions(message) {
+function mentionsBot(message, botUsername) {
+	const expected = normalizeLowercaseStringOrEmpty(botUsername);
 	const mentionRegex = /@(\w+)/g;
-	const mentions = [];
 	let match;
-	while ((match = mentionRegex.exec(message)) !== null) {
-		const username = match[1];
-		if (username) mentions.push(normalizeLowercaseStringOrEmpty(username));
-	}
-	return mentions;
+	while ((match = mentionRegex.exec(message)) !== null) if ((match[1] ? normalizeLowercaseStringOrEmpty(match[1]) : "") === expected) return true;
+	return false;
 }
 //#endregion
 //#region extensions/twitch/src/monitor.ts
@@ -292,23 +303,26 @@ async function monitorTwitchProvider(options) {
 	}
 	const unregisterHandler = clientManager.onMessage(account, (message) => {
 		if (stopped) return;
-		const botUsername = normalizeLowercaseStringOrEmpty(account.username);
-		if (normalizeLowercaseStringOrEmpty(message.username) === botUsername) return;
-		if (!checkTwitchAccessControl({
-			message,
-			account,
-			botUsername
-		}).allowed) return;
-		statusSink?.({ lastInboundAt: Date.now() });
-		processTwitchMessage({
-			message,
-			account,
-			accountId,
-			config,
-			runtime,
-			core,
-			statusSink
-		}).catch((err) => {
+		(async () => {
+			const botUsername = normalizeLowercaseStringOrEmpty(account.username);
+			if (normalizeLowercaseStringOrEmpty(message.username) === botUsername) return;
+			const access = await checkTwitchAccessControl({
+				message,
+				account,
+				botUsername
+			});
+			if (stopped || !access.allowed) return;
+			statusSink?.({ lastInboundAt: Date.now() });
+			await processTwitchMessage({
+				message,
+				account,
+				accountId,
+				config,
+				runtime,
+				core,
+				statusSink
+			});
+		})().catch((err) => {
 			runtime.error?.(`Message processing failed: ${String(err)}`);
 		});
 	});

package/dist/{plugin-CoIt3s7P.js → plugin-BLMSYnzs.js}

@@ -954,7 +954,7 @@ const twitchPlugin = createChatChannelPlugin({
 					lastError: null
 				});
 				ctx.log?.info(`Starting Twitch connection for ${account.username}`);
-				const { monitorTwitchProvider } = await import("./monitor-DmMYPZvJ.js");
+				const { monitorTwitchProvider } = await import("./monitor-DvbgvvL4.js");
 				await monitorTwitchProvider({
 					account,
 					accountId,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openclaw/twitch",
-  "version": "2026.5.9-beta.1",
+  "version": "2026.5.10-beta.1",
   "description": "OpenClaw Twitch channel plugin",
   "repository": {
     "type": "git",
@@ -26,10 +26,10 @@
       "minHostVersion": ">=2026.4.10"
     },
     "compat": {
-      "pluginApi": ">=2026.5.9-beta.1"
+      "pluginApi": ">=2026.5.10-beta.1"
     },
     "build": {
-      "openclawVersion": "2026.5.9-beta.1"
+      "openclawVersion": "2026.5.10-beta.1"
     },
     "channel": {
       "id": "twitch",
@@ -56,7 +56,7 @@
     "README.md"
   ],
   "peerDependencies": {
-    "openclaw": ">=2026.5.9-beta.1"
+    "openclaw": ">=2026.5.10-beta.1"
   },
   "peerDependenciesMeta": {
     "openclaw": {