@openclaw/twitch 2026.5.12 → 2026.5.14-beta.2

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-6H4HbNEm.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-6H4HbNEm.js";
 export { twitchPlugin };

package/dist/{monitor-BQ5mdzvw.js → monitor-DAM8hrYU.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-6H4HbNEm.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-6H4HbNEm.js}

@@ -1,6 +1,4 @@
-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-B7FlQUTK.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";
@@ -10,11 +8,312 @@ import { createComputedAccountStatusAdapter, createDefaultChannelRuntimeState }
 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,7 +1253,7 @@ const twitchPlugin = createChatChannelPlugin({
 					lastError: null
 				});
 				ctx.log?.info(`Starting Twitch connection for ${account.username}`);
-				const { monitorTwitchProvider } = await import("./monitor-BQ5mdzvw.js");
+				const { monitorTwitchProvider } = await import("./monitor-DAM8hrYU.js");
 				await monitorTwitchProvider({
 					account,
 					accountId,
@@ -978,4 +1277,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-B7FlQUTK.js";
 export { twitchSetupPlugin };

package/dist/{setup-surface-C1-HFfeJ.js → setup-surface-B7FlQUTK.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";
+//#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
@@ -397,4 +523,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.12",
+  "version": "2026.5.14-beta.2",
   "description": "OpenClaw Twitch channel plugin",
   "repository": {
     "type": "git",
@@ -27,10 +27,10 @@
       "minHostVersion": ">=2026.4.10"
     },
     "compat": {
-      "pluginApi": ">=2026.5.12"
+      "pluginApi": ">=2026.5.14-beta.2"
     },
     "build": {
-      "openclawVersion": "2026.5.12"
+      "openclawVersion": "2026.5.14-beta.2"
     },
     "channel": {
       "id": "twitch",
@@ -57,7 +57,7 @@
     "README.md"
   ],
   "peerDependencies": {
-    "openclaw": ">=2026.5.12"
+    "openclaw": ">=2026.5.14-beta.2"
   },
   "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 };