@openclaw/discord 2026.7.1 → 2026.7.2-beta.1

package/npm-shrinkwrap.json

@@ -1,22 +1,23 @@
 {
   "name": "@openclaw/discord",
-  "version": "2026.7.1",
+  "version": "2026.7.2-beta.1",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@openclaw/discord",
-      "version": "2026.7.1",
+      "version": "2026.7.2-beta.1",
       "dependencies": {
         "@discordjs/voice": "0.19.2",
         "discord-api-types": "0.38.49",
         "libopus-wasm": "0.2.0",
+        "p-map": "7.0.5",
         "typebox": "1.3.3",
         "undici": "8.5.0",
         "ws": "8.21.0"
       },
       "peerDependencies": {
-        "openclaw": ">=2026.7.1"
+        "openclaw": ">=2026.7.2-beta.1"
       },
       "peerDependenciesMeta": {
         "openclaw": {
@@ -360,6 +361,18 @@
         "node": ">=20"
       }
     },
+    "node_modules/p-map": {
+      "version": "7.0.5",
+      "resolved": "https://registry.npmjs.org/p-map/-/p-map-7.0.5.tgz",
+      "integrity": "sha512-e8vJF4XdVkzqqSHguEMz41mQO1wKwxKm5ENrUJQUu9kLDCtn83cxbyHZcszr4QC5zEA7WffRRC4gsTecC7J9oA==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
     "node_modules/prism-media": {
       "version": "1.3.5",
       "resolved": "https://registry.npmjs.org/prism-media/-/prism-media-1.3.5.tgz",

package/openclaw.plugin.json

@@ -436,6 +436,9 @@
                   },
                   "commentary": {
                     "type": "boolean"
+                  },
+                  "narration": {
+                    "type": "boolean"
                   }
                 },
                 "additionalProperties": false
@@ -743,6 +746,29 @@
                     "type": "string"
                   }
                 },
+                "presenceEvents": {
+                  "type": "object",
+                  "properties": {
+                    "enabled": {
+                      "type": "boolean"
+                    },
+                    "channelId": {
+                      "type": "string",
+                      "pattern": "^\\d+$"
+                    },
+                    "users": {
+                      "type": "array",
+                      "items": {
+                        "type": "string",
+                        "pattern": "^\\d+$"
+                      }
+                    }
+                  },
+                  "required": [
+                    "channelId"
+                  ],
+                  "additionalProperties": false
+                },
                 "channels": {
                   "type": "object",
                   "propertyNames": {
@@ -2246,6 +2272,9 @@
                         },
                         "commentary": {
                           "type": "boolean"
+                        },
+                        "narration": {
+                          "type": "boolean"
                         }
                       },
                       "additionalProperties": false
@@ -2553,6 +2582,29 @@
                           "type": "string"
                         }
                       },
+                      "presenceEvents": {
+                        "type": "object",
+                        "properties": {
+                          "enabled": {
+                            "type": "boolean"
+                          },
+                          "channelId": {
+                            "type": "string",
+                            "pattern": "^\\d+$"
+                          },
+                          "users": {
+                            "type": "array",
+                            "items": {
+                              "type": "string",
+                              "pattern": "^\\d+$"
+                            }
+                          }
+                        },
+                        "required": [
+                          "channelId"
+                        ],
+                        "additionalProperties": false
+                      },
                       "channels": {
                         "type": "object",
                         "propertyNames": {
@@ -3754,7 +3806,7 @@
         },
         "streaming.progress.labels": {
           "label": "Discord Progress Label Pool",
-          "help": "Candidate labels for streaming.progress.label=\"auto\". Leave unset to use OpenClaw built-in progress labels."
+          "help": "Candidate labels for streaming.progress.label=\"auto\". Leave unset to use the built-in \"Working\" label."
         },
         "streaming.progress.maxLines": {
           "label": "Discord Progress Max Lines",
@@ -3874,7 +3926,7 @@
         },
         "voice.model": {
           "label": "Discord Voice Model",
-          "help": "Optional LLM model override for Discord voice channel responses and realtime agent consults (for example openai/gpt-5.5). Leave unset to inherit the routed agent model."
+          "help": "Optional LLM model override for Discord voice channel responses and realtime agent consults (for example openai/gpt-5.6-sol). Leave unset to inherit the routed agent model."
         },
         "voice.mode": {
           "label": "Discord Voice Mode",
@@ -4021,6 +4073,22 @@
           "label": "Discord Auto Presence Exhausted Text",
           "help": "Optional custom status text while runtime detects exhausted/unavailable model quota (dnd). Supports {reason} template placeholder."
         },
+        "guilds.*.presenceEvents": {
+          "label": "Discord Online Presence Events",
+          "help": "Route selected human offline-to-online transitions into the configured guild channel as agent system events. Requires the Guild Presences privileged intent and an enabled agent heartbeat."
+        },
+        "guilds.*.presenceEvents.enabled": {
+          "label": "Discord Online Presence Events Enabled",
+          "help": "Enable online-presence agent wakes for this guild. Defaults to true when presenceEvents is configured."
+        },
+        "guilds.*.presenceEvents.channelId": {
+          "label": "Discord Online Presence Target Channel",
+          "help": "Numeric Discord channel ID whose routed agent session receives online-presence events and greeting delivery."
+        },
+        "guilds.*.presenceEvents.users": {
+          "label": "Discord Online Presence User IDs",
+          "help": "Optional immutable Discord user ID allowlist. Omit to include all human members in the guild."
+        },
         "activityType": {
           "label": "Discord Presence Activity Type",
           "help": "Discord presence activity type (0=Playing,1=Streaming,2=Listening,3=Watching,4=Custom,5=Competing)."

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openclaw/discord",
-  "version": "2026.7.1",
+  "version": "2026.7.2-beta.1",
   "description": "OpenClaw Discord channel plugin for channels, DMs, commands, and app events.",
   "repository": {
     "type": "git",
@@ -11,12 +11,13 @@
     "@discordjs/voice": "0.19.2",
     "discord-api-types": "0.38.49",
     "libopus-wasm": "0.2.0",
+    "p-map": "7.0.5",
     "typebox": "1.3.3",
     "undici": "8.5.0",
     "ws": "8.21.0"
   },
   "peerDependencies": {
-    "openclaw": ">=2026.7.1"
+    "openclaw": ">=2026.7.2-beta.1"
   },
   "peerDependenciesMeta": {
     "openclaw": {
@@ -63,10 +64,10 @@
       "allowInvalidConfigRecovery": true
     },
     "compat": {
-      "pluginApi": ">=2026.7.1"
+      "pluginApi": ">=2026.7.2-beta.1"
     },
     "build": {
-      "openclawVersion": "2026.7.1"
+      "openclawVersion": "2026.7.2-beta.1"
     },
     "release": {
       "publishToClawHub": true,
@@ -88,6 +89,7 @@
     "@discordjs/voice",
     "discord-api-types",
     "libopus-wasm",
+    "p-map",
     "typebox",
     "undici",
     "ws"

package/dist/config-api-JiPdJeb0.js

@@ -1,2 +0,0 @@
-import { DiscordConfigSchema, buildChannelConfigSchema } from "openclaw/plugin-sdk/bundled-channel-config-schema";
-export { buildChannelConfigSchema as n, DiscordConfigSchema as t };

package/dist/conversation-identity-DWC5d8Sy.js

@@ -1,272 +0,0 @@
-import { Kt as parseDiscordTarget } from "./send.receipt-BpBQED_5.js";
-import { r as listDiscordAccountIds, s as resolveDiscordAccount } from "./accounts-P19jm1lf.js";
-import { normalizeLowercaseStringOrEmpty, normalizeOptionalLowercaseString, normalizeOptionalString } from "openclaw/plugin-sdk/string-coerce-runtime";
-import { createLazyChannelApprovalNativeRuntimeAdapter } from "openclaw/plugin-sdk/approval-handler-adapter-runtime";
-import { createChannelApproverDmTargetResolver, createChannelNativeOriginTargetResolver, doesApprovalRequestMatchChannelAccount, resolveApprovalRequestSessionConversation } from "openclaw/plugin-sdk/approval-native-runtime";
-import { getExecApprovalReplyMetadata, isChannelExecApprovalClientEnabledFromConfig, matchesApprovalRequestFilters } from "openclaw/plugin-sdk/approval-client-runtime";
-import { resolveApprovalApprovers } from "openclaw/plugin-sdk/approval-auth-runtime";
-import { createApproverRestrictedNativeApprovalCapability } from "openclaw/plugin-sdk/approval-delivery-runtime";
-//#region extensions/discord/src/exec-approvals.ts
-function normalizeDiscordApproverId(value) {
-	const trimmed = value.trim();
-	if (!trimmed) return;
-	if (/^\d+$/.test(trimmed)) return trimmed;
-	try {
-		const target = parseDiscordTarget(trimmed);
-		return target?.kind === "user" ? target.id : void 0;
-	} catch {
-		return;
-	}
-}
-function resolveDiscordOwnerApprovers(cfg) {
-	const ownerAllowFrom = cfg.commands?.ownerAllowFrom;
-	if (!Array.isArray(ownerAllowFrom) || ownerAllowFrom.length === 0) return [];
-	return resolveApprovalApprovers({
-		explicit: ownerAllowFrom,
-		normalizeApprover: (value) => normalizeDiscordApproverId(String(value))
-	});
-}
-function getDiscordExecApprovalApprovers(params) {
-	return resolveApprovalApprovers({
-		explicit: params.configOverride?.approvers ?? resolveDiscordAccount(params).config.execApprovals?.approvers ?? resolveDiscordOwnerApprovers(params.cfg),
-		normalizeApprover: (value) => normalizeDiscordApproverId(String(value))
-	});
-}
-function isDiscordExecApprovalClientEnabled(params) {
-	return isChannelExecApprovalClientEnabledFromConfig({
-		enabled: (params.configOverride ?? resolveDiscordAccount(params).config.execApprovals)?.enabled,
-		approverCount: getDiscordExecApprovalApprovers({
-			cfg: params.cfg,
-			accountId: params.accountId,
-			configOverride: params.configOverride
-		}).length
-	});
-}
-function isDiscordExecApprovalApprover(params) {
-	const senderId = params.senderId?.trim();
-	if (!senderId) return false;
-	return getDiscordExecApprovalApprovers({
-		cfg: params.cfg,
-		accountId: params.accountId,
-		configOverride: params.configOverride
-	}).includes(senderId);
-}
-function shouldSuppressLocalDiscordExecApprovalPrompt(params) {
-	const metadata = getExecApprovalReplyMetadata(params.payload);
-	const config = resolveDiscordAccount(params).config.execApprovals;
-	return params.hint?.kind === "approval-pending" && params.hint.nativeRouteActive === true && isDiscordExecApprovalClientEnabled(params) && metadata !== null && matchesApprovalRequestFilters({
-		request: {
-			agentId: metadata.agentId,
-			sessionKey: metadata.sessionKey
-		},
-		agentFilter: config?.agentFilter,
-		sessionFilter: config?.sessionFilter
-	});
-}
-//#endregion
-//#region extensions/discord/src/approval-shared.ts
-function shouldHandleDiscordApprovalRequest(params) {
-	const config = params.configOverride ?? resolveDiscordAccount({
-		cfg: params.cfg,
-		accountId: params.accountId
-	}).config.execApprovals;
-	const approvers = getDiscordExecApprovalApprovers({
-		cfg: params.cfg,
-		accountId: params.accountId,
-		configOverride: params.configOverride
-	});
-	if (!doesApprovalRequestMatchChannelAccount({
-		cfg: params.cfg,
-		request: params.request,
-		channel: "discord",
-		accountId: params.accountId
-	})) return false;
-	if (!isChannelExecApprovalClientEnabledFromConfig({
-		enabled: config?.enabled,
-		approverCount: approvers.length
-	})) return false;
-	return matchesApprovalRequestFilters({
-		request: params.request.request,
-		agentFilter: config?.agentFilter,
-		sessionFilter: config?.sessionFilter
-	});
-}
-//#endregion
-//#region extensions/discord/src/approval-native.ts
-function extractDiscordSessionKind(sessionKey) {
-	if (!sessionKey) return null;
-	const match = sessionKey.match(/discord:(?:[^:]+:)?(channel|group|dm|direct):/);
-	if (!match) return null;
-	const raw = match[1];
-	if (raw === "direct") return "dm";
-	return raw;
-}
-function normalizeDiscordOriginChannelId(value) {
-	if (!value) return null;
-	const trimmed = value.trim();
-	if (!trimmed) return null;
-	const prefixed = trimmed.match(/^(?:channel|group):(\d+)$/i);
-	if (prefixed) return prefixed[1];
-	return /^\d+$/.test(trimmed) ? trimmed : null;
-}
-function normalizeDiscordThreadId(value) {
-	if (typeof value === "number") return Number.isFinite(value) ? String(value) : void 0;
-	if (typeof value !== "string") return;
-	const normalized = value.trim();
-	return /^\d+$/.test(normalized) ? normalized : void 0;
-}
-function createDiscordOriginTargetResolver(configOverride) {
-	return createChannelNativeOriginTargetResolver({
-		channel: "discord",
-		shouldHandleRequest: ({ cfg, accountId, request }) => shouldHandleDiscordApprovalRequest({
-			cfg,
-			accountId,
-			request,
-			configOverride
-		}),
-		resolveTurnSourceTarget: (request) => {
-			const sessionConversation = resolveApprovalRequestSessionConversation({
-				request,
-				channel: "discord",
-				bundledFallback: false
-			});
-			const sessionKind = extractDiscordSessionKind(normalizeOptionalString(request.request.sessionKey) ?? null);
-			const turnSourceChannel = normalizeLowercaseStringOrEmpty(request.request.turnSourceChannel);
-			const rawTurnSourceTo = normalizeOptionalString(request.request.turnSourceTo) ?? "";
-			const turnSourceTo = normalizeDiscordOriginChannelId(rawTurnSourceTo);
-			const threadId = normalizeDiscordThreadId(request.request.turnSourceThreadId) ?? normalizeDiscordThreadId(sessionConversation?.threadId) ?? void 0;
-			const hasExplicitOriginTarget = /^(?:channel|group):/i.test(rawTurnSourceTo);
-			if (turnSourceChannel !== "discord" || !turnSourceTo || sessionKind === "dm") return null;
-			return hasExplicitOriginTarget || sessionKind === "channel" || sessionKind === "group" ? {
-				to: turnSourceTo,
-				threadId
-			} : null;
-		},
-		resolveSessionTarget: (sessionTarget, request) => {
-			const sessionConversation = resolveApprovalRequestSessionConversation({
-				request,
-				channel: "discord",
-				bundledFallback: false
-			});
-			if (extractDiscordSessionKind(request.request.sessionKey?.trim() || null) === "dm") return null;
-			const targetTo = normalizeDiscordOriginChannelId(sessionTarget.to);
-			return targetTo ? {
-				to: targetTo,
-				threadId: normalizeDiscordThreadId(sessionTarget.threadId) ?? normalizeDiscordThreadId(sessionConversation?.threadId) ?? void 0
-			} : null;
-		},
-		resolveFallbackTarget: (request) => {
-			const sessionConversation = resolveApprovalRequestSessionConversation({
-				request,
-				channel: "discord",
-				bundledFallback: false
-			});
-			if (extractDiscordSessionKind(request.request.sessionKey?.trim() || null) === "dm") return null;
-			const fallbackChannelId = normalizeDiscordOriginChannelId(sessionConversation?.id);
-			return fallbackChannelId ? {
-				to: fallbackChannelId,
-				threadId: normalizeDiscordThreadId(sessionConversation?.threadId) ?? void 0
-			} : null;
-		}
-	});
-}
-function createDiscordApproverDmTargetResolver(configOverride) {
-	return createChannelApproverDmTargetResolver({
-		shouldHandleRequest: ({ cfg, accountId, request }) => shouldHandleDiscordApprovalRequest({
-			cfg,
-			accountId,
-			request,
-			configOverride
-		}),
-		resolveApprovers: ({ cfg, accountId }) => getDiscordExecApprovalApprovers({
-			cfg,
-			accountId,
-			configOverride
-		}),
-		mapApprover: (approver) => ({ to: approver })
-	});
-}
-function createDiscordApprovalCapability(configOverride) {
-	return createApproverRestrictedNativeApprovalCapability({
-		channel: "discord",
-		channelLabel: "Discord",
-		describeExecApprovalSetup: ({ accountId }) => {
-			const prefix = accountId && accountId !== "default" ? `channels.discord.accounts.${accountId}` : "channels.discord";
-			return `Approve it from the Web UI or terminal UI for now. Discord supports native exec approvals for this account. Configure \`${prefix}.execApprovals.approvers\` or \`commands.ownerAllowFrom\`; set \`${prefix}.execApprovals.enabled\` to \`auto\` or \`true\`.`;
-		},
-		listAccountIds: listDiscordAccountIds,
-		hasApprovers: ({ cfg, accountId }) => getDiscordExecApprovalApprovers({
-			cfg,
-			accountId,
-			configOverride
-		}).length > 0,
-		isExecAuthorizedSender: ({ cfg, accountId, senderId }) => isDiscordExecApprovalApprover({
-			cfg,
-			accountId,
-			senderId,
-			configOverride
-		}),
-		isNativeDeliveryEnabled: ({ cfg, accountId }) => isDiscordExecApprovalClientEnabled({
-			cfg,
-			accountId,
-			configOverride
-		}),
-		resolveNativeDeliveryMode: ({ cfg, accountId }) => configOverride?.target ?? resolveDiscordAccount({
-			cfg,
-			accountId
-		}).config.execApprovals?.target ?? "dm",
-		resolveOriginTarget: createDiscordOriginTargetResolver(configOverride),
-		resolveApproverDmTargets: createDiscordApproverDmTargetResolver(configOverride),
-		notifyOriginWhenDmOnly: true,
-		nativeRuntime: createLazyChannelApprovalNativeRuntimeAdapter({
-			eventKinds: ["exec", "plugin"],
-			isConfigured: ({ cfg, accountId }) => isDiscordExecApprovalClientEnabled({
-				cfg,
-				accountId,
-				configOverride
-			}),
-			shouldHandle: ({ cfg, accountId, request }) => shouldHandleDiscordApprovalRequest({
-				cfg,
-				accountId,
-				request,
-				configOverride
-			}),
-			load: async () => (await import("./approval-handler.runtime-Bw2pZNk1.js").then((n) => n.t)).discordApprovalNativeRuntime
-		})
-	});
-}
-let cachedDiscordApprovalCapability;
-function getDiscordApprovalCapability() {
-	cachedDiscordApprovalCapability ??= createDiscordApprovalCapability();
-	return cachedDiscordApprovalCapability;
-}
-//#endregion
-//#region extensions/discord/src/conversation-identity.ts
-function normalizeDiscordTarget(raw, defaultKind) {
-	const trimmed = normalizeOptionalString(raw);
-	if (!trimmed) return;
-	return parseDiscordTarget(trimmed, { defaultKind })?.normalized;
-}
-function buildDiscordConversationIdentity(kind, rawId) {
-	const trimmed = normalizeOptionalString(rawId);
-	return trimmed ? `${kind}:${trimmed}` : void 0;
-}
-function resolveDiscordConversationIdentity(params) {
-	return params.isDirectMessage ? buildDiscordConversationIdentity("user", params.userId) : buildDiscordConversationIdentity("channel", params.channelId);
-}
-function resolveDiscordCurrentConversationIdentity(params) {
-	if (normalizeOptionalLowercaseString(params.chatType) === "direct") {
-		const senderTarget = normalizeDiscordTarget(params.from, "user");
-		if (senderTarget?.startsWith("user:")) return senderTarget;
-	}
-	for (const candidate of [
-		params.originatingTo,
-		params.commandTo,
-		params.fallbackTo
-	]) {
-		const target = normalizeDiscordTarget(candidate, "channel");
-		if (target) return target;
-	}
-}
-//#endregion
-export { getDiscordExecApprovalApprovers as a, shouldSuppressLocalDiscordExecApprovalPrompt as c, shouldHandleDiscordApprovalRequest as i, resolveDiscordCurrentConversationIdentity as n, isDiscordExecApprovalApprover as o, getDiscordApprovalCapability as r, isDiscordExecApprovalClientEnabled as s, resolveDiscordConversationIdentity as t };

package/dist/pluralkit-DcD-3EcL.js

@@ -1,24 +0,0 @@
-import { Jt as __exportAll } from "./send.receipt-BpBQED_5.js";
-import { resolveFetch } from "openclaw/plugin-sdk/fetch-runtime";
-import { readProviderJsonResponse, readResponseTextLimited } from "openclaw/plugin-sdk/provider-http";
-//#region extensions/discord/src/pluralkit.ts
-var pluralkit_exports = /* @__PURE__ */ __exportAll({ fetchPluralKitMessageInfo: () => fetchPluralKitMessageInfo });
-const PLURALKIT_API_BASE = "https://api.pluralkit.me/v2";
-const PLURALKIT_ERROR_BODY_LIMIT_BYTES = 8 * 1024;
-async function fetchPluralKitMessageInfo(params) {
-	if (!params.config?.enabled) return null;
-	const fetchImpl = resolveFetch(params.fetcher);
-	if (!fetchImpl) return null;
-	const headers = {};
-	if (params.config.token?.trim()) headers.Authorization = params.config.token.trim();
-	const res = await fetchImpl(`${PLURALKIT_API_BASE}/messages/${params.messageId}`, { headers });
-	if (res.status === 404) return null;
-	if (!res.ok) {
-		const text = await readResponseTextLimited(res, PLURALKIT_ERROR_BODY_LIMIT_BYTES).catch(() => "");
-		const detail = text.trim() ? `: ${text.trim()}` : "";
-		throw new Error(`PluralKit API failed (${res.status})${detail}`);
-	}
-	return await readProviderJsonResponse(res, "PluralKit message");
-}
-//#endregion
-export { pluralkit_exports as n, fetchPluralKitMessageInfo as t };

package/dist/preview-streaming-DXT8oJdo.js

@@ -1,8 +0,0 @@
-import { resolveChannelPreviewStreamMode } from "openclaw/plugin-sdk/channel-outbound";
-//#region extensions/discord/src/preview-streaming.ts
-function resolveDiscordPreviewStreamMode(params = {}) {
-	if (params.streaming === void 0 && params.streamMode === void 0) return "progress";
-	return resolveChannelPreviewStreamMode(params, "off");
-}
-//#endregion
-export { resolveDiscordPreviewStreamMode as t };

package/dist/provider.runtime-WrJXikSv.js

@@ -1,2 +0,0 @@
-import { t as monitorDiscordProvider } from "./provider-BkfbC9FQ.js";
-export { monitorDiscordProvider };

package/dist/runtime-api.monitor-C2_WVtJf.js

@@ -1,6 +0,0 @@
-import "./allow-list-C-MqM-B_.js";
-import "./timeouts-C5TBc_9x.js";
-import "./provider-BkfbC9FQ.js";
-import "./message-utils-B_3yA5bN.js";
-import "./message-handler-DcgvugZt.js";
-export {};

package/dist/targets-69w7c3vU.js

@@ -1,3 +0,0 @@
-import "./send.receipt-BpBQED_5.js";
-import "./target-resolver-CwHaSLt3.js";
-export {};