@openclaw/twitch 2026.5.14-beta.1 → 2026.5.16-beta.1

package/dist/api.js

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

package/dist/channel-plugin-api.js

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

package/dist/{monitor-BQ5mdzvw.js → monitor-d1yhkO1M.js}

@@ -1,5 +1,5 @@
-import { i as getOrCreateClientManager, n as stripMarkdownForTwitch } from "./markdown-BbzAc3z0.js";
-import { t as getTwitchRuntime } from "./runtime-QZ5I3GlI.js";
+import { n as stripMarkdownForTwitch, r as getOrCreateClientManager } from "./plugin-CEhzoRMh.js";
+import { t as getTwitchRuntime } from "./runtime-C5O5cqdz.js";
 import { formatErrorMessage } from "openclaw/plugin-sdk/error-runtime";
 import { normalizeLowercaseStringOrEmpty } from "openclaw/plugin-sdk/string-coerce-runtime";
 import { createChannelIngressResolver, defineStableChannelIngressIdentity } from "openclaw/plugin-sdk/channel-ingress-runtime";

package/dist/{plugin-CxTwdtw4.js → plugin-CEhzoRMh.js}

@@ -1,20 +1,319 @@
-import { a as normalizeTwitchChannel, i as normalizeToken, n as isAccountConfigured, o as resolveTwitchToken, r as missingTargetError, t as generateMessageId } from "./twitch-BsSKTyqW.js";
-import { a as getAccountConfig, c as resolveTwitchAccountContext, i as DEFAULT_ACCOUNT_ID, l as resolveTwitchSnapshotAccountId, o as listAccountIds, r as twitchSetupWizard, s as resolveDefaultTwitchAccountId, t as twitchSetupAdapter } from "./setup-surface-C1-HFfeJ.js";
-import { a as removeClientManager, n as stripMarkdownForTwitch, r as getClientManager, t as chunkTextForTwitch } from "./markdown-BbzAc3z0.js";
+import { a as getAccountConfig, c as resolveTwitchAccountContext, d as isAccountConfigured, f as missingTargetError, h as resolveTwitchToken, i as DEFAULT_ACCOUNT_ID, l as resolveTwitchSnapshotAccountId, m as normalizeTwitchChannel, o as listAccountIds, p as normalizeToken, r as twitchSetupWizard, s as resolveDefaultTwitchAccountId, t as twitchSetupAdapter, u as generateMessageId } from "./setup-surface-BiDFQV9J.js";
 import { describeAccountSnapshot } from "openclaw/plugin-sdk/account-helpers";
 import { buildChannelConfigSchema } from "openclaw/plugin-sdk/channel-config-schema";
 import { createChatChannelPlugin } from "openclaw/plugin-sdk/channel-core";
 import { createLoggedPairingApprovalNotifier, createPairingPrefixStripper } from "openclaw/plugin-sdk/channel-pairing";
-import { buildPassiveProbedChannelStatusSummary } from "openclaw/plugin-sdk/extension-shared";
+import { buildPassiveProbedChannelStatusSummary, runStoppablePassiveMonitor } from "openclaw/plugin-sdk/extension-shared";
 import { createComputedAccountStatusAdapter, createDefaultChannelRuntimeState } from "openclaw/plugin-sdk/status-helpers";
 import { formatErrorMessage } from "openclaw/plugin-sdk/error-runtime";
 import { normalizeLowercaseStringOrEmpty } from "openclaw/plugin-sdk/string-coerce-runtime";
 import { createMessageReceiptFromOutboundResults, defineChannelMessageAdapter } from "openclaw/plugin-sdk/channel-message";
-import { StaticAuthProvider } from "@twurple/auth";
-import { ChatClient } from "@twurple/chat";
+import { RefreshingAuthProvider, StaticAuthProvider } from "@twurple/auth";
+import { ChatClient, LogLevel } from "@twurple/chat";
 import { MarkdownConfigSchema } from "openclaw/plugin-sdk/channel-config-primitives";
 import { z } from "zod";
 import { ApiClient } from "@twurple/api";
+//#region extensions/twitch/src/twitch-client.ts
+/**
+* Manages Twitch chat client connections
+*/
+var TwitchClientManager = class {
+	constructor(logger) {
+		this.logger = logger;
+		this.clients = /* @__PURE__ */ new Map();
+		this.messageHandlers = /* @__PURE__ */ new Map();
+	}
+	/**
+	* Create an auth provider for the account.
+	*/
+	async createAuthProvider(account, normalizedToken) {
+		if (!account.clientId) throw new Error("Missing Twitch client ID");
+		if (account.clientSecret) {
+			const authProvider = new RefreshingAuthProvider({
+				clientId: account.clientId,
+				clientSecret: account.clientSecret
+			});
+			await authProvider.addUserForToken({
+				accessToken: normalizedToken,
+				refreshToken: account.refreshToken ?? null,
+				expiresIn: account.expiresIn ?? null,
+				obtainmentTimestamp: account.obtainmentTimestamp ?? Date.now()
+			}).then((userId) => {
+				this.logger.info(`Added user ${userId} to RefreshingAuthProvider for ${account.username}`);
+			}).catch((err) => {
+				this.logger.error(`Failed to add user to RefreshingAuthProvider: ${formatErrorMessage(err)}`);
+			});
+			authProvider.onRefresh((userId, token) => {
+				this.logger.info(`Access token refreshed for user ${userId} (expires in ${token.expiresIn ? `${token.expiresIn}s` : "unknown"})`);
+			});
+			authProvider.onRefreshFailure((userId, error) => {
+				this.logger.error(`Failed to refresh access token for user ${userId}: ${error.message}`);
+			});
+			const refreshStatus = account.refreshToken ? "automatic token refresh enabled" : "token refresh disabled (no refresh token)";
+			this.logger.info(`Using RefreshingAuthProvider for ${account.username} (${refreshStatus})`);
+			return authProvider;
+		}
+		this.logger.info(`Using StaticAuthProvider for ${account.username} (no clientSecret provided)`);
+		return new StaticAuthProvider(account.clientId, normalizedToken);
+	}
+	/**
+	* Get or create a chat client for an account
+	*/
+	async getClient(account, cfg, accountId) {
+		const key = this.getAccountKey(account);
+		const existing = this.clients.get(key);
+		if (existing) return existing;
+		const tokenResolution = resolveTwitchToken(cfg, { accountId });
+		if (!tokenResolution.token) {
+			this.logger.error(`Missing Twitch token for account ${account.username} (set channels.twitch.accounts.${account.username}.token or OPENCLAW_TWITCH_ACCESS_TOKEN for default)`);
+			throw new Error("Missing Twitch token");
+		}
+		this.logger.debug?.(`Using ${tokenResolution.source} token source for ${account.username}`);
+		if (!account.clientId) {
+			this.logger.error(`Missing Twitch client ID for account ${account.username}`);
+			throw new Error("Missing Twitch client ID");
+		}
+		const normalizedToken = normalizeToken(tokenResolution.token);
+		const client = new ChatClient({
+			authProvider: await this.createAuthProvider(account, normalizedToken),
+			channels: [account.channel],
+			rejoinChannelsOnReconnect: true,
+			requestMembershipEvents: true,
+			logger: {
+				minLevel: LogLevel.WARNING,
+				custom: { log: (level, message) => {
+					switch (level) {
+						case LogLevel.CRITICAL:
+							this.logger.error(message);
+							break;
+						case LogLevel.ERROR:
+							this.logger.error(message);
+							break;
+						case LogLevel.WARNING:
+							this.logger.warn(message);
+							break;
+						case LogLevel.INFO:
+							this.logger.info(message);
+							break;
+						case LogLevel.DEBUG:
+							this.logger.debug?.(message);
+							break;
+						case LogLevel.TRACE:
+							this.logger.debug?.(message);
+							break;
+					}
+				} }
+			}
+		});
+		this.setupClientHandlers(client, account);
+		client.connect();
+		this.clients.set(key, client);
+		this.logger.info(`Connected to Twitch as ${account.username}`);
+		return client;
+	}
+	/**
+	* Set up message and event handlers for a client
+	*/
+	setupClientHandlers(client, account) {
+		const key = this.getAccountKey(account);
+		client.onMessage((channelName, _user, messageText, msg) => {
+			const handler = this.messageHandlers.get(key);
+			if (handler) {
+				const normalizedChannel = channelName.startsWith("#") ? channelName.slice(1) : channelName;
+				const from = `twitch:${msg.userInfo.userName}`;
+				const preview = messageText.slice(0, 100).replace(/\n/g, "\\n");
+				this.logger.debug?.(`twitch inbound: channel=${normalizedChannel} from=${from} len=${messageText.length} preview="${preview}"`);
+				handler({
+					username: msg.userInfo.userName,
+					displayName: msg.userInfo.displayName,
+					userId: msg.userInfo.userId,
+					message: messageText,
+					channel: normalizedChannel,
+					id: msg.id,
+					timestamp: /* @__PURE__ */ new Date(),
+					isMod: msg.userInfo.isMod,
+					isOwner: msg.userInfo.isBroadcaster,
+					isVip: msg.userInfo.isVip,
+					isSub: msg.userInfo.isSubscriber,
+					chatType: "group"
+				});
+			}
+		});
+		this.logger.info(`Set up handlers for ${key}`);
+	}
+	/**
+	* Set a message handler for an account
+	* @returns A function that removes the handler when called
+	*/
+	onMessage(account, handler) {
+		const key = this.getAccountKey(account);
+		this.messageHandlers.set(key, handler);
+		return () => {
+			this.messageHandlers.delete(key);
+		};
+	}
+	/**
+	* Disconnect a client
+	*/
+	async disconnect(account) {
+		const key = this.getAccountKey(account);
+		const client = this.clients.get(key);
+		if (client) {
+			client.quit();
+			this.clients.delete(key);
+			this.messageHandlers.delete(key);
+			this.logger.info(`Disconnected ${key}`);
+		}
+	}
+	/**
+	* Disconnect all clients
+	*/
+	async disconnectAll() {
+		this.clients.forEach((client) => client.quit());
+		this.clients.clear();
+		this.messageHandlers.clear();
+		this.logger.info(" Disconnected all clients");
+	}
+	/**
+	* Send a message to a channel
+	*/
+	async sendMessage(account, channel, message, cfg, accountId) {
+		try {
+			const client = await this.getClient(account, cfg, accountId);
+			const messageId = crypto.randomUUID();
+			await client.say(channel, message);
+			return {
+				ok: true,
+				messageId
+			};
+		} catch (error) {
+			this.logger.error(`Failed to send message: ${formatErrorMessage(error)}`);
+			return {
+				ok: false,
+				error: formatErrorMessage(error)
+			};
+		}
+	}
+	/**
+	* Generate a unique key for an account
+	*/
+	getAccountKey(account) {
+		return `${account.username}:${account.channel}`;
+	}
+	/**
+	* Clear all clients and handlers (for testing)
+	*/
+	_clearForTest() {
+		this.clients.clear();
+		this.messageHandlers.clear();
+	}
+};
+//#endregion
+//#region extensions/twitch/src/client-manager-registry.ts
+/**
+* Client manager registry for Twitch plugin.
+*
+* Manages the lifecycle of TwitchClientManager instances across the plugin,
+* ensuring proper cleanup when accounts are stopped or reconfigured.
+*/
+/**
+* Global registry of client managers.
+* Keyed by account ID.
+*/
+const registry = /* @__PURE__ */ new Map();
+/**
+* Get or create a client manager for an account.
+*
+* @param accountId - The account ID
+* @param logger - Logger instance
+* @returns The client manager
+*/
+function getOrCreateClientManager(accountId, logger) {
+	const existing = registry.get(accountId);
+	if (existing) return existing.manager;
+	const manager = new TwitchClientManager(logger);
+	registry.set(accountId, {
+		manager,
+		accountId,
+		logger,
+		createdAt: Date.now()
+	});
+	logger.info(`Registered client manager for account: ${accountId}`);
+	return manager;
+}
+/**
+* Get an existing client manager for an account.
+*
+* @param accountId - The account ID
+* @returns The client manager, or undefined if not registered
+*/
+function getClientManager(accountId) {
+	return registry.get(accountId)?.manager;
+}
+/**
+* Disconnect and remove a client manager from the registry.
+*
+* @param accountId - The account ID
+* @returns Promise that resolves when cleanup is complete
+*/
+async function removeClientManager(accountId) {
+	const entry = registry.get(accountId);
+	if (!entry) return;
+	await entry.manager.disconnectAll();
+	registry.delete(accountId);
+	entry.logger.info(`Unregistered client manager for account: ${accountId}`);
+}
+//#endregion
+//#region extensions/twitch/src/utils/markdown.ts
+/**
+* Markdown utilities for Twitch chat
+*
+* Twitch chat doesn't support markdown formatting, so we strip it before sending.
+* Based on OpenClaw's markdownToText in src/agents/tools/web-fetch-utils.ts.
+*/
+/**
+* Strip markdown formatting from text for Twitch compatibility.
+*
+* Removes images, links, bold, italic, strikethrough, code blocks, inline code,
+* headers, and list formatting. Replaces newlines with spaces since Twitch
+* is a single-line chat medium.
+*
+* @param markdown - The markdown text to strip
+* @returns Plain text with markdown removed
+*/
+function stripMarkdownForTwitch(markdown) {
+	return markdown.replace(/!\[[^\]]*]\([^)]+\)/g, "").replace(/\[([^\]]+)]\([^)]+\)/g, "$1").replace(/\*\*([^*]+)\*\*/g, "$1").replace(/__([^_]+)__/g, "$1").replace(/\*([^*]+)\*/g, "$1").replace(/_([^_]+)_/g, "$1").replace(/~~([^~]+)~~/g, "$1").replace(/```[\s\S]*?```/g, (block) => block.replace(/```[^\n]*\n?/g, "").replace(/```/g, "")).replace(/`([^`]+)`/g, "$1").replace(/^#{1,6}\s+/gm, "").replace(/^\s*[-*+]\s+/gm, "").replace(/^\s*\d+\.\s+/gm, "").replace(/\r/g, "").replace(/[ \t]+\n/g, "\n").replace(/\n/g, " ").replace(/[ \t]{2,}/g, " ").trim();
+}
+/**
+* Simple word-boundary chunker for Twitch (500 char limit).
+* Strips markdown before chunking to avoid breaking markdown patterns.
+*
+* @param text - The text to chunk
+* @param limit - Maximum characters per chunk (Twitch limit is 500)
+* @returns Array of text chunks
+*/
+function chunkTextForTwitch(text, limit) {
+	const cleaned = stripMarkdownForTwitch(text);
+	if (!cleaned) return [];
+	if (limit <= 0) return [cleaned];
+	if (cleaned.length <= limit) return [cleaned];
+	const chunks = [];
+	let remaining = cleaned;
+	while (remaining.length > limit) {
+		const window = remaining.slice(0, limit);
+		const lastSpaceIndex = window.lastIndexOf(" ");
+		if (lastSpaceIndex === -1) {
+			chunks.push(window);
+			remaining = remaining.slice(limit);
+		} else {
+			chunks.push(window.slice(0, lastSpaceIndex));
+			remaining = remaining.slice(lastSpaceIndex + 1);
+		}
+	}
+	if (remaining) chunks.push(remaining);
+	return chunks;
+}
+//#endregion
 //#region extensions/twitch/src/send.ts
 /**
 * Twitch message sending functions with dependency injection support.
@@ -954,13 +1253,18 @@ const twitchPlugin = createChatChannelPlugin({
 					lastError: null
 				});
 				ctx.log?.info(`Starting Twitch connection for ${account.username}`);
-				const { monitorTwitchProvider } = await import("./monitor-BQ5mdzvw.js");
-				await monitorTwitchProvider({
-					account,
-					accountId,
-					config: ctx.cfg,
-					runtime: ctx.runtime,
-					abortSignal: ctx.abortSignal
+				await runStoppablePassiveMonitor({
+					abortSignal: ctx.abortSignal,
+					start: async () => {
+						const { monitorTwitchProvider } = await import("./monitor-d1yhkO1M.js");
+						return monitorTwitchProvider({
+							account,
+							accountId,
+							config: ctx.cfg,
+							runtime: ctx.runtime,
+							abortSignal: ctx.abortSignal
+						});
+					}
 				});
 			},
 			stopAccount: async (ctx) => {
@@ -978,4 +1282,4 @@ const twitchPlugin = createChatChannelPlugin({
 	}
 });
 //#endregion
-export { twitchPlugin as t };
+export { stripMarkdownForTwitch as n, getOrCreateClientManager as r, twitchPlugin as t };

package/dist/setup-plugin-api.js

@@ -1,2 +1,2 @@
-import { n as twitchSetupPlugin } from "./setup-surface-C1-HFfeJ.js";
+import { n as twitchSetupPlugin } from "./setup-surface-BiDFQV9J.js";
 export { twitchSetupPlugin };

package/dist/{setup-surface-C1-HFfeJ.js → setup-surface-BiDFQV9J.js}

@@ -1,8 +1,134 @@
-import { n as isAccountConfigured, o as resolveTwitchToken } from "./twitch-BsSKTyqW.js";
-import { listCombinedAccountIds, normalizeAccountId, resolveNormalizedAccountEntry } from "openclaw/plugin-sdk/account-resolution";
+import { DEFAULT_ACCOUNT_ID, listCombinedAccountIds, normalizeAccountId, resolveNormalizedAccountEntry } from "openclaw/plugin-sdk/account-resolution";
+import { randomUUID } from "node:crypto";
+import { normalizeLowercaseStringOrEmpty } from "openclaw/plugin-sdk/string-coerce-runtime";
 import { normalizeOptionalAccountId } from "openclaw/plugin-sdk/account-id";
 import { getChatChannelMeta } from "openclaw/plugin-sdk/core";
-import { formatDocsLink, normalizeAccountId as normalizeAccountId$1 } from "openclaw/plugin-sdk/setup";
+import { createSetupTranslator, formatDocsLink, normalizeAccountId as normalizeAccountId$1 } from "openclaw/plugin-sdk/setup";
+//#region extensions/twitch/src/token.ts
+/**
+* Twitch access token resolution with environment variable support.
+*
+* Supports reading Twitch OAuth access tokens from config or environment variable.
+* The OPENCLAW_TWITCH_ACCESS_TOKEN env var is only used for the default account.
+*
+* Token resolution priority:
+* 1. Account access token from merged config (accounts.{id} or base-level for default)
+* 2. Environment variable: OPENCLAW_TWITCH_ACCESS_TOKEN (default account only)
+*/
+/**
+* Normalize a Twitch OAuth token - ensure it has the oauth: prefix
+*/
+function normalizeTwitchToken(raw) {
+	if (!raw) return;
+	const trimmed = raw.trim();
+	if (!trimmed) return;
+	return trimmed.startsWith("oauth:") ? trimmed : `oauth:${trimmed}`;
+}
+/**
+* Resolve Twitch access token from config or environment variable.
+*
+* Priority:
+* 1. Account access token (from merged config - base-level for default, or accounts.{accountId})
+* 2. Environment variable: OPENCLAW_TWITCH_ACCESS_TOKEN (default account only)
+*
+* The getAccountConfig function handles merging base-level config with accounts.default,
+* so this logic works for both simplified and multi-account patterns.
+*
+* @param cfg - OpenClaw config
+* @param opts - Options including accountId and optional envToken override
+* @returns Token resolution with source
+*/
+function resolveTwitchToken(cfg, opts = {}) {
+	const accountId = normalizeAccountId(opts.accountId);
+	const twitchCfg = cfg?.channels?.twitch;
+	const accounts = twitchCfg?.accounts;
+	const accountCfg = resolveNormalizedAccountEntry(accounts, accountId, normalizeAccountId);
+	let token;
+	if (accountId === DEFAULT_ACCOUNT_ID) token = normalizeTwitchToken((typeof twitchCfg?.accessToken === "string" ? twitchCfg.accessToken : void 0) || accountCfg?.accessToken);
+	else token = normalizeTwitchToken(accountCfg?.accessToken);
+	if (token) return {
+		token,
+		source: "config"
+	};
+	const envToken = accountId === DEFAULT_ACCOUNT_ID ? normalizeTwitchToken(opts.envToken ?? process.env.OPENCLAW_TWITCH_ACCESS_TOKEN) : void 0;
+	if (envToken) return {
+		token: envToken,
+		source: "env"
+	};
+	return {
+		token: "",
+		source: "none"
+	};
+}
+//#endregion
+//#region extensions/twitch/src/utils/twitch.ts
+/**
+* Twitch-specific utility functions
+*/
+/**
+* Normalize Twitch channel names.
+*
+* Removes the '#' prefix if present, converts to lowercase, and trims whitespace.
+* Twitch channel names are case-insensitive and don't use the '#' prefix in the API.
+*
+* @param channel - The channel name to normalize
+* @returns Normalized channel name
+*
+* @example
+* normalizeTwitchChannel("#TwitchChannel") // "twitchchannel"
+* normalizeTwitchChannel("MyChannel") // "mychannel"
+*/
+function normalizeTwitchChannel(channel) {
+	const trimmed = normalizeLowercaseStringOrEmpty(channel);
+	return trimmed.startsWith("#") ? trimmed.slice(1) : trimmed;
+}
+/**
+* Create a standardized error message for missing target.
+*
+* @param provider - The provider name (e.g., "Twitch")
+* @param hint - Optional hint for how to fix the issue
+* @returns Error object with descriptive message
+*/
+function missingTargetError(provider, hint) {
+	return /* @__PURE__ */ new Error(`Delivering to ${provider} requires target${hint ? ` ${hint}` : ""}`);
+}
+/**
+* Generate a unique message ID for Twitch messages.
+*
+* Twurple's say() doesn't return the message ID, so we generate one
+* for tracking purposes.
+*
+* @returns A unique message ID
+*/
+function generateMessageId() {
+	return `${Date.now()}-${randomUUID()}`;
+}
+/**
+* Normalize OAuth token by removing the "oauth:" prefix if present.
+*
+* Twurple doesn't require the "oauth:" prefix, so we strip it for consistency.
+*
+* @param token - The OAuth token to normalize
+* @returns Normalized token without "oauth:" prefix
+*
+* @example
+* normalizeToken("oauth:abc123") // "abc123"
+* normalizeToken("abc123") // "abc123"
+*/
+function normalizeToken(token) {
+	return token.startsWith("oauth:") ? token.slice(6) : token;
+}
+/**
+* Check if an account is properly configured with required credentials.
+*
+* @param account - The Twitch account config to check
+* @returns true if the account has required credentials
+*/
+function isAccountConfigured(account, resolvedToken) {
+	const token = resolvedToken ?? account?.accessToken;
+	return Boolean(account?.username && token && account?.clientId);
+}
+//#endregion
 //#region extensions/twitch/src/config.ts
 /**
 * Default account ID for Twitch
@@ -96,6 +222,7 @@ function resolveTwitchSnapshotAccountId(cfg, account) {
 * Twitch setup wizard surface for CLI setup.
 */
 const channel = "twitch";
+const t = createSetupTranslator();
 const INVALID_ACCOUNT_ID_MESSAGE = "Invalid Twitch account id";
 function normalizeRequestedSetupAccountId(accountId) {
 	const normalized = normalizeOptionalAccountId(accountId);
@@ -142,25 +269,25 @@ function setTwitchAccount(cfg, account, accountId = resolveSetupAccountId(cfg))
 }
 async function noteTwitchSetupHelp(prompter) {
 	await prompter.note([
-		"Twitch requires a bot account with OAuth token.",
-		"1. Create a Twitch application at https://dev.twitch.tv/console",
-		"2. Generate a token with scopes: chat:read and chat:write",
-		"   Use https://twitchtokengenerator.com/ or https://twitchapps.com/tmi/",
-		"3. Copy the token (starts with 'oauth:') and Client ID",
-		"Env vars supported: OPENCLAW_TWITCH_ACCESS_TOKEN",
+		t("wizard.twitch.helpRequiresBot"),
+		t("wizard.twitch.helpCreateApp"),
+		t("wizard.twitch.helpGenerateToken"),
+		t("wizard.twitch.helpTokenTools"),
+		t("wizard.twitch.helpCopyToken"),
+		t("wizard.twitch.helpEnvVars"),
 		`Docs: ${formatDocsLink("/channels/twitch", "channels/twitch")}`
-	].join("\n"), "Twitch setup");
+	].join("\n"), t("wizard.twitch.setupTitle"));
 }
 async function promptToken(prompter, account, envToken) {
 	const existingToken = account?.accessToken ?? "";
 	if (existingToken && !envToken) {
 		if (await prompter.confirm({
-			message: "Access token already configured. Keep it?",
+			message: t("wizard.twitch.accessTokenKeep"),
 			initialValue: true
 		})) return existingToken;
 	}
 	return (await prompter.text({
-		message: "Twitch OAuth token (oauth:...)",
+		message: t("wizard.twitch.oauthTokenPrompt"),
 		initialValue: envToken ?? "",
 		validate: (value) => {
 			const raw = value?.trim() ?? "";
@@ -171,38 +298,38 @@ async function promptToken(prompter, account, envToken) {
 }
 async function promptUsername(prompter, account) {
 	return (await prompter.text({
-		message: "Twitch bot username",
+		message: t("wizard.twitch.botUsernamePrompt"),
 		initialValue: account?.username ?? "",
 		validate: (value) => value?.trim() ? void 0 : "Required"
 	})).trim();
 }
 async function promptClientId(prompter, account) {
 	return (await prompter.text({
-		message: "Twitch Client ID",
+		message: t("wizard.twitch.clientIdPrompt"),
 		initialValue: account?.clientId ?? "",
 		validate: (value) => value?.trim() ? void 0 : "Required"
 	})).trim();
 }
 async function promptChannelName(prompter, account) {
 	return (await prompter.text({
-		message: "Channel to join",
+		message: t("wizard.twitch.channelJoinPrompt"),
 		initialValue: account?.channel ?? "",
 		validate: (value) => value?.trim() ? void 0 : "Required"
 	})).trim();
 }
 async function promptRefreshTokenSetup(prompter, account) {
 	if (!await prompter.confirm({
-		message: "Enable automatic token refresh (requires client secret and refresh token)?",
+		message: t("wizard.twitch.refreshTokenPrompt"),
 		initialValue: Boolean(account?.clientSecret && account?.refreshToken)
 	})) return {};
 	return {
 		clientSecret: (await prompter.text({
-			message: "Twitch Client Secret (for token refresh)",
+			message: t("wizard.twitch.clientSecretPrompt"),
 			initialValue: account?.clientSecret ?? "",
 			validate: (value) => value?.trim() ? void 0 : "Required"
 		})).trim() || void 0,
 		refreshToken: (await prompter.text({
-			message: "Twitch Refresh Token",
+			message: t("wizard.twitch.refreshTokenInputPrompt"),
 			initialValue: account?.refreshToken ?? "",
 			validate: (value) => value?.trim() ? void 0 : "Required"
 		})).trim() || void 0
@@ -212,7 +339,7 @@ async function configureWithEnvToken(cfg, prompter, account, envToken, forceAllo
 	const resolvedAccountId = accountId.trim() ? normalizeRequestedSetupAccountId(accountId) : resolveSetupAccountId(cfg);
 	if (resolvedAccountId !== "default") return null;
 	if (!await prompter.confirm({
-		message: "Twitch env var OPENCLAW_TWITCH_ACCESS_TOKEN detected. Use env token?",
+		message: t("wizard.twitch.envPrompt"),
 		initialValue: true
 	})) return null;
 	const cfgWithAccount = setTwitchAccount(cfg, {
@@ -273,7 +400,7 @@ const twitchDmPolicy = {
 		const account = getAccountConfig(cfg, resolvedAccountId);
 		const existingAllowFrom = account?.allowFrom ?? [];
 		const allowFrom = (await prompter.text({
-			message: "Twitch allowFrom (user IDs, one per line, recommended for security)",
+			message: t("wizard.twitch.allowFromPrompt"),
 			placeholder: "123456789",
 			initialValue: existingAllowFrom[0] || void 0
 		}) ?? "").split(/[\n,;]+/g).map((s) => s.trim()).filter(Boolean);
@@ -308,17 +435,17 @@ const twitchSetupWizard = {
 	resolveAccountIdForConfigure: ({ cfg, accountOverride }) => resolveSetupAccountId(cfg, accountOverride),
 	resolveShouldPromptAccountIds: () => false,
 	status: {
-		configuredLabel: "configured",
-		unconfiguredLabel: "needs username, token, and clientId",
-		configuredHint: "configured",
-		unconfiguredHint: "needs setup",
+		configuredLabel: t("wizard.channels.statusConfigured"),
+		unconfiguredLabel: t("wizard.channels.statusNeedsUsernameTokenClientId"),
+		configuredHint: t("wizard.channels.statusConfigured"),
+		unconfiguredHint: t("wizard.channels.statusNeedsSetup"),
 		resolveConfigured: ({ cfg, accountId }) => {
 			return resolveTwitchAccountContext(cfg, resolveSetupAccountId(cfg, accountId)).configured;
 		},
 		resolveStatusLines: ({ cfg, accountId }) => {
 			const resolvedAccountId = resolveSetupAccountId(cfg, accountId);
 			const configured = resolveTwitchAccountContext(cfg, resolvedAccountId).configured;
-			return [`Twitch${resolvedAccountId !== "default" ? ` (${resolvedAccountId})` : ""}: ${configured ? "configured" : "needs username, token, and clientId"}`];
+			return [`Twitch${resolvedAccountId !== "default" ? ` (${resolvedAccountId})` : ""}: ${configured ? t("wizard.channels.statusConfigured") : t("wizard.channels.statusNeedsUsernameTokenClientId")}`];
 		}
 	},
 	credentials: [],
@@ -397,4 +524,4 @@ const twitchSetupPlugin = {
 	setupWizard: twitchSetupWizard
 };
 //#endregion
-export { getAccountConfig as a, resolveTwitchAccountContext as c, DEFAULT_ACCOUNT_ID$1 as i, resolveTwitchSnapshotAccountId as l, twitchSetupPlugin as n, listAccountIds as o, twitchSetupWizard as r, resolveDefaultTwitchAccountId as s, twitchSetupAdapter as t };
+export { getAccountConfig as a, resolveTwitchAccountContext as c, isAccountConfigured as d, missingTargetError as f, resolveTwitchToken as h, DEFAULT_ACCOUNT_ID$1 as i, resolveTwitchSnapshotAccountId as l, normalizeTwitchChannel as m, twitchSetupPlugin as n, listAccountIds as o, normalizeToken as p, twitchSetupWizard as r, resolveDefaultTwitchAccountId as s, twitchSetupAdapter as t, generateMessageId as u };

package/package.json

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

package/dist/markdown-BbzAc3z0.js

@@ -1,306 +0,0 @@
-import { i as normalizeToken, o as resolveTwitchToken } from "./twitch-BsSKTyqW.js";
-import { formatErrorMessage } from "openclaw/plugin-sdk/error-runtime";
-import { RefreshingAuthProvider, StaticAuthProvider } from "@twurple/auth";
-import { ChatClient, LogLevel } from "@twurple/chat";
-//#region extensions/twitch/src/twitch-client.ts
-/**
-* Manages Twitch chat client connections
-*/
-var TwitchClientManager = class {
-	constructor(logger) {
-		this.logger = logger;
-		this.clients = /* @__PURE__ */ new Map();
-		this.messageHandlers = /* @__PURE__ */ new Map();
-	}
-	/**
-	* Create an auth provider for the account.
-	*/
-	async createAuthProvider(account, normalizedToken) {
-		if (!account.clientId) throw new Error("Missing Twitch client ID");
-		if (account.clientSecret) {
-			const authProvider = new RefreshingAuthProvider({
-				clientId: account.clientId,
-				clientSecret: account.clientSecret
-			});
-			await authProvider.addUserForToken({
-				accessToken: normalizedToken,
-				refreshToken: account.refreshToken ?? null,
-				expiresIn: account.expiresIn ?? null,
-				obtainmentTimestamp: account.obtainmentTimestamp ?? Date.now()
-			}).then((userId) => {
-				this.logger.info(`Added user ${userId} to RefreshingAuthProvider for ${account.username}`);
-			}).catch((err) => {
-				this.logger.error(`Failed to add user to RefreshingAuthProvider: ${formatErrorMessage(err)}`);
-			});
-			authProvider.onRefresh((userId, token) => {
-				this.logger.info(`Access token refreshed for user ${userId} (expires in ${token.expiresIn ? `${token.expiresIn}s` : "unknown"})`);
-			});
-			authProvider.onRefreshFailure((userId, error) => {
-				this.logger.error(`Failed to refresh access token for user ${userId}: ${error.message}`);
-			});
-			const refreshStatus = account.refreshToken ? "automatic token refresh enabled" : "token refresh disabled (no refresh token)";
-			this.logger.info(`Using RefreshingAuthProvider for ${account.username} (${refreshStatus})`);
-			return authProvider;
-		}
-		this.logger.info(`Using StaticAuthProvider for ${account.username} (no clientSecret provided)`);
-		return new StaticAuthProvider(account.clientId, normalizedToken);
-	}
-	/**
-	* Get or create a chat client for an account
-	*/
-	async getClient(account, cfg, accountId) {
-		const key = this.getAccountKey(account);
-		const existing = this.clients.get(key);
-		if (existing) return existing;
-		const tokenResolution = resolveTwitchToken(cfg, { accountId });
-		if (!tokenResolution.token) {
-			this.logger.error(`Missing Twitch token for account ${account.username} (set channels.twitch.accounts.${account.username}.token or OPENCLAW_TWITCH_ACCESS_TOKEN for default)`);
-			throw new Error("Missing Twitch token");
-		}
-		this.logger.debug?.(`Using ${tokenResolution.source} token source for ${account.username}`);
-		if (!account.clientId) {
-			this.logger.error(`Missing Twitch client ID for account ${account.username}`);
-			throw new Error("Missing Twitch client ID");
-		}
-		const normalizedToken = normalizeToken(tokenResolution.token);
-		const client = new ChatClient({
-			authProvider: await this.createAuthProvider(account, normalizedToken),
-			channels: [account.channel],
-			rejoinChannelsOnReconnect: true,
-			requestMembershipEvents: true,
-			logger: {
-				minLevel: LogLevel.WARNING,
-				custom: { log: (level, message) => {
-					switch (level) {
-						case LogLevel.CRITICAL:
-							this.logger.error(message);
-							break;
-						case LogLevel.ERROR:
-							this.logger.error(message);
-							break;
-						case LogLevel.WARNING:
-							this.logger.warn(message);
-							break;
-						case LogLevel.INFO:
-							this.logger.info(message);
-							break;
-						case LogLevel.DEBUG:
-							this.logger.debug?.(message);
-							break;
-						case LogLevel.TRACE:
-							this.logger.debug?.(message);
-							break;
-					}
-				} }
-			}
-		});
-		this.setupClientHandlers(client, account);
-		client.connect();
-		this.clients.set(key, client);
-		this.logger.info(`Connected to Twitch as ${account.username}`);
-		return client;
-	}
-	/**
-	* Set up message and event handlers for a client
-	*/
-	setupClientHandlers(client, account) {
-		const key = this.getAccountKey(account);
-		client.onMessage((channelName, _user, messageText, msg) => {
-			const handler = this.messageHandlers.get(key);
-			if (handler) {
-				const normalizedChannel = channelName.startsWith("#") ? channelName.slice(1) : channelName;
-				const from = `twitch:${msg.userInfo.userName}`;
-				const preview = messageText.slice(0, 100).replace(/\n/g, "\\n");
-				this.logger.debug?.(`twitch inbound: channel=${normalizedChannel} from=${from} len=${messageText.length} preview="${preview}"`);
-				handler({
-					username: msg.userInfo.userName,
-					displayName: msg.userInfo.displayName,
-					userId: msg.userInfo.userId,
-					message: messageText,
-					channel: normalizedChannel,
-					id: msg.id,
-					timestamp: /* @__PURE__ */ new Date(),
-					isMod: msg.userInfo.isMod,
-					isOwner: msg.userInfo.isBroadcaster,
-					isVip: msg.userInfo.isVip,
-					isSub: msg.userInfo.isSubscriber,
-					chatType: "group"
-				});
-			}
-		});
-		this.logger.info(`Set up handlers for ${key}`);
-	}
-	/**
-	* Set a message handler for an account
-	* @returns A function that removes the handler when called
-	*/
-	onMessage(account, handler) {
-		const key = this.getAccountKey(account);
-		this.messageHandlers.set(key, handler);
-		return () => {
-			this.messageHandlers.delete(key);
-		};
-	}
-	/**
-	* Disconnect a client
-	*/
-	async disconnect(account) {
-		const key = this.getAccountKey(account);
-		const client = this.clients.get(key);
-		if (client) {
-			client.quit();
-			this.clients.delete(key);
-			this.messageHandlers.delete(key);
-			this.logger.info(`Disconnected ${key}`);
-		}
-	}
-	/**
-	* Disconnect all clients
-	*/
-	async disconnectAll() {
-		this.clients.forEach((client) => client.quit());
-		this.clients.clear();
-		this.messageHandlers.clear();
-		this.logger.info(" Disconnected all clients");
-	}
-	/**
-	* Send a message to a channel
-	*/
-	async sendMessage(account, channel, message, cfg, accountId) {
-		try {
-			const client = await this.getClient(account, cfg, accountId);
-			const messageId = crypto.randomUUID();
-			await client.say(channel, message);
-			return {
-				ok: true,
-				messageId
-			};
-		} catch (error) {
-			this.logger.error(`Failed to send message: ${formatErrorMessage(error)}`);
-			return {
-				ok: false,
-				error: formatErrorMessage(error)
-			};
-		}
-	}
-	/**
-	* Generate a unique key for an account
-	*/
-	getAccountKey(account) {
-		return `${account.username}:${account.channel}`;
-	}
-	/**
-	* Clear all clients and handlers (for testing)
-	*/
-	_clearForTest() {
-		this.clients.clear();
-		this.messageHandlers.clear();
-	}
-};
-//#endregion
-//#region extensions/twitch/src/client-manager-registry.ts
-/**
-* Client manager registry for Twitch plugin.
-*
-* Manages the lifecycle of TwitchClientManager instances across the plugin,
-* ensuring proper cleanup when accounts are stopped or reconfigured.
-*/
-/**
-* Global registry of client managers.
-* Keyed by account ID.
-*/
-const registry = /* @__PURE__ */ new Map();
-/**
-* Get or create a client manager for an account.
-*
-* @param accountId - The account ID
-* @param logger - Logger instance
-* @returns The client manager
-*/
-function getOrCreateClientManager(accountId, logger) {
-	const existing = registry.get(accountId);
-	if (existing) return existing.manager;
-	const manager = new TwitchClientManager(logger);
-	registry.set(accountId, {
-		manager,
-		accountId,
-		logger,
-		createdAt: Date.now()
-	});
-	logger.info(`Registered client manager for account: ${accountId}`);
-	return manager;
-}
-/**
-* Get an existing client manager for an account.
-*
-* @param accountId - The account ID
-* @returns The client manager, or undefined if not registered
-*/
-function getClientManager(accountId) {
-	return registry.get(accountId)?.manager;
-}
-/**
-* Disconnect and remove a client manager from the registry.
-*
-* @param accountId - The account ID
-* @returns Promise that resolves when cleanup is complete
-*/
-async function removeClientManager(accountId) {
-	const entry = registry.get(accountId);
-	if (!entry) return;
-	await entry.manager.disconnectAll();
-	registry.delete(accountId);
-	entry.logger.info(`Unregistered client manager for account: ${accountId}`);
-}
-//#endregion
-//#region extensions/twitch/src/utils/markdown.ts
-/**
-* Markdown utilities for Twitch chat
-*
-* Twitch chat doesn't support markdown formatting, so we strip it before sending.
-* Based on OpenClaw's markdownToText in src/agents/tools/web-fetch-utils.ts.
-*/
-/**
-* Strip markdown formatting from text for Twitch compatibility.
-*
-* Removes images, links, bold, italic, strikethrough, code blocks, inline code,
-* headers, and list formatting. Replaces newlines with spaces since Twitch
-* is a single-line chat medium.
-*
-* @param markdown - The markdown text to strip
-* @returns Plain text with markdown removed
-*/
-function stripMarkdownForTwitch(markdown) {
-	return markdown.replace(/!\[[^\]]*]\([^)]+\)/g, "").replace(/\[([^\]]+)]\([^)]+\)/g, "$1").replace(/\*\*([^*]+)\*\*/g, "$1").replace(/__([^_]+)__/g, "$1").replace(/\*([^*]+)\*/g, "$1").replace(/_([^_]+)_/g, "$1").replace(/~~([^~]+)~~/g, "$1").replace(/```[\s\S]*?```/g, (block) => block.replace(/```[^\n]*\n?/g, "").replace(/```/g, "")).replace(/`([^`]+)`/g, "$1").replace(/^#{1,6}\s+/gm, "").replace(/^\s*[-*+]\s+/gm, "").replace(/^\s*\d+\.\s+/gm, "").replace(/\r/g, "").replace(/[ \t]+\n/g, "\n").replace(/\n/g, " ").replace(/[ \t]{2,}/g, " ").trim();
-}
-/**
-* Simple word-boundary chunker for Twitch (500 char limit).
-* Strips markdown before chunking to avoid breaking markdown patterns.
-*
-* @param text - The text to chunk
-* @param limit - Maximum characters per chunk (Twitch limit is 500)
-* @returns Array of text chunks
-*/
-function chunkTextForTwitch(text, limit) {
-	const cleaned = stripMarkdownForTwitch(text);
-	if (!cleaned) return [];
-	if (limit <= 0) return [cleaned];
-	if (cleaned.length <= limit) return [cleaned];
-	const chunks = [];
-	let remaining = cleaned;
-	while (remaining.length > limit) {
-		const window = remaining.slice(0, limit);
-		const lastSpaceIndex = window.lastIndexOf(" ");
-		if (lastSpaceIndex === -1) {
-			chunks.push(window);
-			remaining = remaining.slice(limit);
-		} else {
-			chunks.push(window.slice(0, lastSpaceIndex));
-			remaining = remaining.slice(lastSpaceIndex + 1);
-		}
-	}
-	if (remaining) chunks.push(remaining);
-	return chunks;
-}
-//#endregion
-export { removeClientManager as a, getOrCreateClientManager as i, stripMarkdownForTwitch as n, getClientManager as r, chunkTextForTwitch as t };

package/dist/twitch-BsSKTyqW.js

@@ -1,129 +0,0 @@
-import { DEFAULT_ACCOUNT_ID, normalizeAccountId, resolveNormalizedAccountEntry } from "openclaw/plugin-sdk/account-resolution";
-import { randomUUID } from "node:crypto";
-import { normalizeLowercaseStringOrEmpty } from "openclaw/plugin-sdk/string-coerce-runtime";
-//#region extensions/twitch/src/token.ts
-/**
-* Twitch access token resolution with environment variable support.
-*
-* Supports reading Twitch OAuth access tokens from config or environment variable.
-* The OPENCLAW_TWITCH_ACCESS_TOKEN env var is only used for the default account.
-*
-* Token resolution priority:
-* 1. Account access token from merged config (accounts.{id} or base-level for default)
-* 2. Environment variable: OPENCLAW_TWITCH_ACCESS_TOKEN (default account only)
-*/
-/**
-* Normalize a Twitch OAuth token - ensure it has the oauth: prefix
-*/
-function normalizeTwitchToken(raw) {
-	if (!raw) return;
-	const trimmed = raw.trim();
-	if (!trimmed) return;
-	return trimmed.startsWith("oauth:") ? trimmed : `oauth:${trimmed}`;
-}
-/**
-* Resolve Twitch access token from config or environment variable.
-*
-* Priority:
-* 1. Account access token (from merged config - base-level for default, or accounts.{accountId})
-* 2. Environment variable: OPENCLAW_TWITCH_ACCESS_TOKEN (default account only)
-*
-* The getAccountConfig function handles merging base-level config with accounts.default,
-* so this logic works for both simplified and multi-account patterns.
-*
-* @param cfg - OpenClaw config
-* @param opts - Options including accountId and optional envToken override
-* @returns Token resolution with source
-*/
-function resolveTwitchToken(cfg, opts = {}) {
-	const accountId = normalizeAccountId(opts.accountId);
-	const twitchCfg = cfg?.channels?.twitch;
-	const accounts = twitchCfg?.accounts;
-	const accountCfg = resolveNormalizedAccountEntry(accounts, accountId, normalizeAccountId);
-	let token;
-	if (accountId === DEFAULT_ACCOUNT_ID) token = normalizeTwitchToken((typeof twitchCfg?.accessToken === "string" ? twitchCfg.accessToken : void 0) || accountCfg?.accessToken);
-	else token = normalizeTwitchToken(accountCfg?.accessToken);
-	if (token) return {
-		token,
-		source: "config"
-	};
-	const envToken = accountId === DEFAULT_ACCOUNT_ID ? normalizeTwitchToken(opts.envToken ?? process.env.OPENCLAW_TWITCH_ACCESS_TOKEN) : void 0;
-	if (envToken) return {
-		token: envToken,
-		source: "env"
-	};
-	return {
-		token: "",
-		source: "none"
-	};
-}
-//#endregion
-//#region extensions/twitch/src/utils/twitch.ts
-/**
-* Twitch-specific utility functions
-*/
-/**
-* Normalize Twitch channel names.
-*
-* Removes the '#' prefix if present, converts to lowercase, and trims whitespace.
-* Twitch channel names are case-insensitive and don't use the '#' prefix in the API.
-*
-* @param channel - The channel name to normalize
-* @returns Normalized channel name
-*
-* @example
-* normalizeTwitchChannel("#TwitchChannel") // "twitchchannel"
-* normalizeTwitchChannel("MyChannel") // "mychannel"
-*/
-function normalizeTwitchChannel(channel) {
-	const trimmed = normalizeLowercaseStringOrEmpty(channel);
-	return trimmed.startsWith("#") ? trimmed.slice(1) : trimmed;
-}
-/**
-* Create a standardized error message for missing target.
-*
-* @param provider - The provider name (e.g., "Twitch")
-* @param hint - Optional hint for how to fix the issue
-* @returns Error object with descriptive message
-*/
-function missingTargetError(provider, hint) {
-	return /* @__PURE__ */ new Error(`Delivering to ${provider} requires target${hint ? ` ${hint}` : ""}`);
-}
-/**
-* Generate a unique message ID for Twitch messages.
-*
-* Twurple's say() doesn't return the message ID, so we generate one
-* for tracking purposes.
-*
-* @returns A unique message ID
-*/
-function generateMessageId() {
-	return `${Date.now()}-${randomUUID()}`;
-}
-/**
-* Normalize OAuth token by removing the "oauth:" prefix if present.
-*
-* Twurple doesn't require the "oauth:" prefix, so we strip it for consistency.
-*
-* @param token - The OAuth token to normalize
-* @returns Normalized token without "oauth:" prefix
-*
-* @example
-* normalizeToken("oauth:abc123") // "abc123"
-* normalizeToken("abc123") // "abc123"
-*/
-function normalizeToken(token) {
-	return token.startsWith("oauth:") ? token.slice(6) : token;
-}
-/**
-* Check if an account is properly configured with required credentials.
-*
-* @param account - The Twitch account config to check
-* @returns true if the account has required credentials
-*/
-function isAccountConfigured(account, resolvedToken) {
-	const token = resolvedToken ?? account?.accessToken;
-	return Boolean(account?.username && token && account?.clientId);
-}
-//#endregion
-export { normalizeTwitchChannel as a, normalizeToken as i, isAccountConfigured as n, resolveTwitchToken as o, missingTargetError as r, generateMessageId as t };