@openclaw/discord 2026.3.12 → 2026.5.1-beta.1

package/account-inspect-api.ts

@@ -0,0 +1,6 @@
+import type { OpenClawConfig } from "openclaw/plugin-sdk/config-types";
+import { inspectDiscordAccount } from "./src/account-inspect.js";
+
+export function inspectDiscordReadOnlyAccount(cfg: OpenClawConfig, accountId?: string | null) {
+  return inspectDiscordAccount({ cfg, accountId });
+}

package/action-runtime-api.ts

@@ -0,0 +1 @@
+export { handleDiscordAction } from "./src/actions/runtime.js";

package/api.ts

@@ -0,0 +1,132 @@
+export { discordPlugin } from "./src/channel.js";
+export { discordSetupPlugin } from "./src/channel.setup.js";
+export {
+  handleDiscordSubagentDeliveryTarget,
+  handleDiscordSubagentEnded,
+  handleDiscordSubagentSpawning,
+} from "./src/subagent-hooks.js";
+export {
+  type DiscordCredentialStatus,
+  inspectDiscordAccount,
+  type InspectedDiscordAccount,
+} from "./src/account-inspect.js";
+export {
+  createDiscordActionGate,
+  listDiscordAccountIds,
+  listEnabledDiscordAccounts,
+  mergeDiscordAccountConfig,
+  type ResolvedDiscordAccount,
+  resolveDefaultDiscordAccountId,
+  resolveDiscordAccount,
+  resolveDiscordAccountConfig,
+  resolveDiscordMaxLinesPerMessage,
+} from "./src/accounts.js";
+export { tryHandleDiscordMessageActionGuildAdmin } from "./src/actions/handle-action.guild-admin.js";
+export { buildDiscordComponentMessage } from "./src/components.js";
+type DiscordMessageActionHandler =
+  typeof import("./src/channel-actions.runtime.js").handleDiscordMessageAction;
+
+// Deprecated compatibility surface for existing @openclaw/discord/api.js consumers.
+export const handleDiscordMessageAction: DiscordMessageActionHandler = async (...args) =>
+  (await import("./src/channel-actions.runtime.js")).handleDiscordMessageAction(...args);
+export {
+  listDiscordDirectoryGroupsFromConfig,
+  listDiscordDirectoryPeersFromConfig,
+} from "./src/directory-config.js";
+export {
+  resolveDiscordGroupRequireMention,
+  resolveDiscordGroupToolPolicy,
+} from "./src/group-policy.js";
+export {
+  looksLikeDiscordTargetId,
+  normalizeDiscordMessagingTarget,
+  normalizeDiscordOutboundTarget,
+} from "./src/normalize.js";
+export { resolveOpenProviderRuntimeGroupPolicy as resolveDiscordRuntimeGroupPolicy } from "openclaw/plugin-sdk/runtime-group-policy";
+export { collectDiscordStatusIssues } from "./src/status-issues.js";
+
+export {
+  buildDiscordComponentCustomId,
+  buildDiscordComponentMessageFlags,
+  buildDiscordInteractiveComponents,
+  buildDiscordModalCustomId,
+  createDiscordFormModal,
+  DISCORD_COMPONENT_ATTACHMENT_PREFIX,
+  DISCORD_COMPONENT_CUSTOM_ID_KEY,
+  DISCORD_MODAL_CUSTOM_ID_KEY,
+  DiscordFormModal,
+  formatDiscordComponentEventText,
+  parseDiscordComponentCustomId,
+  parseDiscordComponentCustomIdForInteraction,
+  parseDiscordComponentCustomIdForInteraction as parseDiscordComponentCustomIdForCarbon,
+  parseDiscordModalCustomId,
+  parseDiscordModalCustomIdForInteraction,
+  parseDiscordModalCustomIdForInteraction as parseDiscordModalCustomIdForCarbon,
+  readDiscordComponentSpec,
+  resolveDiscordComponentAttachmentName,
+  type ComponentData,
+  type DiscordComponentBlock,
+  type DiscordComponentBuildResult,
+  type DiscordComponentButtonSpec,
+  type DiscordComponentButtonStyle,
+  type DiscordComponentEntry,
+  type DiscordComponentMessageSpec,
+  type DiscordComponentModalFieldType,
+  type DiscordComponentSectionAccessory,
+  type DiscordComponentSelectOption,
+  type DiscordComponentSelectSpec,
+  type DiscordComponentSelectType,
+  type DiscordModalEntry,
+  type DiscordModalFieldDefinition,
+  type DiscordModalFieldSpec,
+  type DiscordModalSpec,
+} from "./src/components.js";
+export {
+  getDiscordExecApprovalApprovers,
+  isDiscordExecApprovalApprover,
+  isDiscordExecApprovalClientEnabled,
+  shouldSuppressLocalDiscordExecApprovalPrompt,
+} from "./src/exec-approvals.js";
+export type {
+  DiscordInteractiveHandlerContext,
+  DiscordInteractiveHandlerRegistration,
+} from "./src/interactive-dispatch.js";
+export {
+  type DiscordPluralKitConfig,
+  fetchPluralKitMessageInfo,
+  type PluralKitMemberInfo,
+  type PluralKitMessageInfo,
+  type PluralKitSystemInfo,
+} from "./src/pluralkit.js";
+export {
+  fetchDiscordApplicationId,
+  fetchDiscordApplicationSummary,
+  parseApplicationIdFromToken,
+  probeDiscord,
+  resolveDiscordPrivilegedIntentsFromFlags,
+  type DiscordApplicationSummary,
+  type DiscordPrivilegedIntentsSummary,
+  type DiscordPrivilegedIntentStatus,
+  type DiscordProbe,
+} from "./src/probe.js";
+export { normalizeExplicitDiscordSessionKey } from "./src/session-key-normalization.js";
+export { parseDiscordSendTarget, type SendDiscordTarget } from "./src/send-target-parsing.js";
+export {
+  parseDiscordTarget,
+  resolveDiscordChannelId,
+  resolveDiscordTarget,
+  type DiscordTarget,
+  type DiscordTargetKind,
+  type DiscordTargetParseOptions,
+} from "./src/targets.js";
+export { collectDiscordSecurityAuditFindings } from "./src/security-audit.js";
+export {
+  DISCORD_ATTACHMENT_IDLE_TIMEOUT_MS,
+  DISCORD_ATTACHMENT_TOTAL_TIMEOUT_MS,
+  DISCORD_DEFAULT_INBOUND_WORKER_TIMEOUT_MS,
+  DISCORD_DEFAULT_LISTENER_TIMEOUT_MS,
+  mergeAbortSignals,
+} from "./src/monitor/timeouts.js";
+export type { DiscordSendComponents, DiscordSendEmbeds } from "./src/send.shared.js";
+export type { DiscordSendResult } from "./src/send.types.js";
+export type { DiscordTokenResolution } from "./src/token.js";

package/channel-config-api.ts

@@ -0,0 +1 @@
+export { DiscordChannelConfigSchema } from "./src/config-schema.js";

package/channel-plugin-api.ts

@@ -0,0 +1,3 @@
+// Keep bundled channel entry imports narrow so bootstrap/discovery paths do
+// not drag setup-only surfaces into lightweight channel plugin loads.
+export { discordPlugin } from "./src/channel.js";

package/config-api.ts

@@ -0,0 +1,4 @@
+export {
+  buildChannelConfigSchema,
+  DiscordConfigSchema,
+} from "openclaw/plugin-sdk/bundled-channel-config-schema";

package/configured-state.ts

@@ -0,0 +1,6 @@
+export function hasDiscordConfiguredState(params: { env?: NodeJS.ProcessEnv }): boolean {
+  return (
+    typeof params.env?.DISCORD_BOT_TOKEN === "string" &&
+    params.env.DISCORD_BOT_TOKEN.trim().length > 0
+  );
+}

package/contract-api.ts

@@ -0,0 +1,21 @@
+export { createThreadBindingManager } from "./src/monitor/thread-bindings.manager.js";
+export { __testing as discordThreadBindingTesting } from "./src/monitor/thread-bindings.manager.js";
+export {
+  listDiscordDirectoryGroupsFromConfig,
+  listDiscordDirectoryPeersFromConfig,
+} from "./src/directory-config.js";
+export { normalizeCompatibilityConfig, legacyConfigRules } from "./src/doctor-contract.js";
+export {
+  collectRuntimeConfigAssignments,
+  secretTargetRegistryEntries,
+} from "./src/secret-config-contract.js";
+export {
+  unsupportedSecretRefSurfacePatterns,
+  collectUnsupportedSecretRefConfigCandidates,
+} from "./src/security-contract.js";
+export { deriveLegacySessionChatType } from "./src/session-contract.js";
+export type {
+  DiscordInteractiveHandlerContext,
+  DiscordInteractiveHandlerRegistration,
+} from "./src/interactive-dispatch.js";
+export { collectDiscordSecurityAuditFindings } from "./src/security-audit.js";

package/directory-contract-api.ts

@@ -0,0 +1,4 @@
+export {
+  listDiscordDirectoryGroupsFromConfig,
+  listDiscordDirectoryPeersFromConfig,
+} from "./src/directory-config.js";

package/doctor-contract-api.ts

@@ -0,0 +1 @@
+export { normalizeCompatibilityConfig, legacyConfigRules } from "./src/doctor-contract.js";

package/index.test.ts

@@ -0,0 +1,13 @@
+import { assertBundledChannelEntries } from "openclaw/plugin-sdk/channel-test-helpers";
+import { describe } from "vitest";
+import entry from "./index.js";
+import setupEntry from "./setup-entry.js";
+
+describe("discord bundled entries", () => {
+  assertBundledChannelEntries({
+    entry,
+    expectedId: "discord",
+    expectedName: "Discord",
+    setupEntry,
+  });
+});

package/index.ts

@@ -1,19 +1,24 @@
-import type { OpenClawPluginApi } from "openclaw/plugin-sdk/discord";
-import { emptyPluginConfigSchema } from "openclaw/plugin-sdk/discord";
-import { discordPlugin } from "./src/channel.js";
-import { setDiscordRuntime } from "./src/runtime.js";
-import { registerDiscordSubagentHooks } from "./src/subagent-hooks.js";
+import { defineBundledChannelEntry } from "openclaw/plugin-sdk/channel-entry-contract";
+import { registerDiscordSubagentHooks } from "./subagent-hooks-api.js";
 
-const plugin = {
+export default defineBundledChannelEntry({
   id: "discord",
   name: "Discord",
   description: "Discord channel plugin",
-  configSchema: emptyPluginConfigSchema(),
-  register(api: OpenClawPluginApi) {
-    setDiscordRuntime(api.runtime);
-    api.registerChannel({ plugin: discordPlugin });
+  importMetaUrl: import.meta.url,
+  plugin: {
+    specifier: "./channel-plugin-api.js",
+    exportName: "discordPlugin",
+  },
+  runtime: {
+    specifier: "./runtime-setter-api.js",
+    exportName: "setDiscordRuntime",
+  },
+  accountInspect: {
+    specifier: "./account-inspect-api.js",
+    exportName: "inspectDiscordReadOnlyAccount",
+  },
+  registerFull(api) {
     registerDiscordSubagentHooks(api);
   },
-};
-
-export default plugin;
+});