@actagent/discord 2026.6.2

package/README.md

@@ -0,0 +1,11 @@
+# ACTAgent Discord
+
+Official ACTAgent channel plugin for Discord servers, channels, DMs, slash commands, and app events.
+
+Install from ACTAgent:
+
+```bash
+actagent plugin add @actagent/discord
+```
+
+Configure a Discord bot token and the channels or servers ACTAgent should handle. The plugin lets ACTAgent agents receive Discord messages and respond through the configured Discord app.

package/account-inspect-api.ts

@@ -0,0 +1,7 @@
+// Discord API module exposes the plugin public contract.
+import type { ACTAgentConfig } from "actagent/plugin-sdk/config-contracts";
+import { inspectDiscordAccount } from "./src/account-inspect.js";
+
+export function inspectDiscordReadOnlyAccount(cfg: ACTAgentConfig, accountId?: string | null) {
+  return inspectDiscordAccount({ cfg, accountId });
+}

package/actagent.plugin.json

@@ -0,0 +1,20 @@
+{
+  "id": "discord",
+  "name": "Discord",
+  "description": "ACTAgent Discord channel plugin for channels, DMs, commands, and app events.",
+  "activation": {
+    "onStartup": false
+  },
+  "channels": ["discord"],
+  "contracts": {
+    "transcriptSourceProviders": ["discord-voice"]
+  },
+  "channelEnvVars": {
+    "discord": ["DISCORD_BOT_TOKEN"]
+  },
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {}
+  }
+}

package/action-runtime-api.ts

@@ -0,0 +1,2 @@
+// Discord API module exposes the plugin public contract.
+export { handleDiscordAction } from "./src/actions/runtime.js";

package/api.ts

@@ -0,0 +1,131 @@
+// Discord API module exposes the plugin public contract.
+export { discordPlugin } from "./src/channel.js";
+export { discordSetupPlugin } from "./src/channel.setup.js";
+export {
+  handleDiscordSubagentDeliveryTarget,
+  handleDiscordSubagentEnded,
+  handleDiscordSubagentSpawning,
+} from "./src/subagent-hooks.js";
+export { inspectDiscordAccount, type InspectedDiscordAccount } from "./src/account-inspect.js";
+export { type DiscordCredentialStatus } from "./src/token.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 { DiscordApiError, fetchDiscord, requestDiscord } from "./src/api.js";
+export { buildDiscordComponentMessage } from "./src/components.js";
+type DiscordMessageActionHandler =
+  typeof import("./src/channel-actions.runtime.js").handleDiscordMessageAction;
+
+// Deprecated compatibility surface for existing @actagent/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 "actagent/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,2 @@
+// Discord API module exposes the plugin public contract.
+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,5 @@
+// Discord API module exposes the plugin public contract.
+export {
+  buildChannelConfigSchema,
+  DiscordConfigSchema,
+} from "actagent/plugin-sdk/bundled-channel-config-schema";

package/configured-state.ts

@@ -0,0 +1,7 @@
+// Discord helper module supports configured state behavior.
+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,22 @@
+// Discord API module exposes the plugin public contract.
+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,15 @@
+// Discord API module exposes the plugin public contract.
+import {
+  listDiscordDirectoryGroupsFromConfig,
+  listDiscordDirectoryPeersFromConfig,
+} from "./src/directory-config.js";
+
+export { listDiscordDirectoryGroupsFromConfig, listDiscordDirectoryPeersFromConfig };
+
+export const discordDirectoryContractPlugin = {
+  id: "discord",
+  directory: {
+    listPeers: listDiscordDirectoryPeersFromConfig,
+    listGroups: listDiscordDirectoryGroupsFromConfig,
+  },
+};

package/doctor-contract-api.ts

@@ -0,0 +1,2 @@
+// Discord API module exposes the plugin public contract.
+export { normalizeCompatibilityConfig, legacyConfigRules } from "./src/doctor-contract.js";

package/index.test.ts

@@ -0,0 +1,14 @@
+// Discord tests cover index plugin behavior.
+import { assertBundledChannelEntries } from "actagent/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

@@ -0,0 +1,27 @@
+// Discord plugin entrypoint registers its ACTAgent integration.
+import { defineBundledChannelEntry } from "actagent/plugin-sdk/channel-entry-contract";
+import { registerDiscordSubagentHooks } from "./subagent-hooks-api.js";
+import { discordVoiceTranscriptsSourceProvider } from "./transcripts-source-api.js";
+
+export default defineBundledChannelEntry({
+  id: "discord",
+  name: "Discord",
+  description: "Discord channel plugin",
+  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);
+    api.registerTranscriptSourceProvider(discordVoiceTranscriptsSourceProvider);
+  },
+});

package/legacy-state-migrations-api.ts

@@ -0,0 +1,2 @@
+// Discord API module exposes the plugin public contract.
+export { detectDiscordLegacyStateMigrations } from "./src/monitor/model-picker-preferences-migrations.js";