@open-mercato/channel-discord 0.6.8-develop.7090.1.4dbca7b350

package/dist/modules/channel_discord/commands/update-ai-auto-reply.js

@@ -0,0 +1,104 @@
+import { z } from "zod";
+import { registerCommand } from "@open-mercato/shared/lib/commands";
+import { withAtomicFlush } from "@open-mercato/shared/lib/commands/flush";
+import { enforceCommandOptimisticLockWithGuards } from "@open-mercato/shared/lib/crud/optimistic-lock-command";
+import { findOneWithDecryption } from "@open-mercato/shared/lib/encryption/find";
+import { CommunicationChannel } from "@open-mercato/core/modules/communication_channels/data/entities";
+import { channelOrgScopeWhereFromFilter } from "@open-mercato/core/modules/communication_channels/lib/access-control";
+import { discordChannelStateSchema } from "../lib/credentials.js";
+const CHANNEL_DISCORD_CHANNEL_RESOURCE_KIND = "communication_channels.channel";
+const CHANNEL_DISCORD_UPDATE_AI_AUTO_REPLY_COMMAND_ID = "channel_discord.channel.update_ai_auto_reply";
+const discordAiAutoReplySettingsSchema = z.object({
+  aiAutoReplyEnabled: z.boolean(),
+  aiAgentId: z.string().trim().min(1).max(200).optional()
+}).refine((value) => !value.aiAutoReplyEnabled || Boolean(value.aiAgentId), {
+  // Arming auto-reply without naming an agent is the state that made the
+  // original subscriber dormant; the schema refuses to reproduce it.
+  path: ["aiAgentId"],
+  message: "channel_discord.aiAutoReply.errors.agentRequired"
+});
+const updateAiAutoReplySchema = z.object({
+  channelId: z.string().uuid(),
+  settings: discordAiAutoReplySettingsSchema,
+  scope: z.object({
+    tenantId: z.string().uuid(),
+    /** Organization the decryption scope is anchored to. */
+    organizationId: z.string().uuid().nullable(),
+    /**
+     * Organizations the caller may see, as resolved by the route. A Discord bot
+     * channel is usually tenant-scoped (`organization_id IS NULL`), so filtering
+     * on a single organization would hide the very channels this command
+     * configures — the hub's `channelOrgScopeWhereFromFilter` encodes the right
+     * rule and is reused here.
+     */
+    organizationIds: z.array(z.string().uuid()).nullable().optional()
+  }),
+  expectedUpdatedAt: z.string().optional()
+});
+const updateAiAutoReplyCommand = {
+  id: CHANNEL_DISCORD_UPDATE_AI_AUTO_REPLY_COMMAND_ID,
+  // Not undoable on purpose: replaying a stale snapshot could re-arm auto-reply
+  // on a channel an operator deliberately disarmed — for example after the bot
+  // answered something it should not have. Reverting is a deliberate act through
+  // the same form, which leaves its own audit entry.
+  isUndoable: false,
+  async execute(rawInput, ctx) {
+    const input = updateAiAutoReplySchema.parse(rawInput);
+    const em = ctx.container.resolve("em").fork();
+    const dscope = { tenantId: input.scope.tenantId, organizationId: input.scope.organizationId };
+    const channel = await findOneWithDecryption(
+      em,
+      CommunicationChannel,
+      {
+        id: input.channelId,
+        tenantId: input.scope.tenantId,
+        providerKey: "discord",
+        ...channelOrgScopeWhereFromFilter({ organizationIds: input.scope.organizationIds ?? void 0 }),
+        deletedAt: null
+      },
+      void 0,
+      dscope
+    );
+    if (!channel) return { status: "not_found" };
+    await enforceCommandOptimisticLockWithGuards(ctx.container, {
+      resourceKind: CHANNEL_DISCORD_CHANNEL_RESOURCE_KIND,
+      resourceId: channel.id,
+      current: channel.updatedAt,
+      expected: input.expectedUpdatedAt ?? null,
+      request: ctx.request ?? null
+    });
+    const current = discordChannelStateSchema.parse(channel.channelState ?? {});
+    const aiAgentId = input.settings.aiAutoReplyEnabled ? input.settings.aiAgentId : void 0;
+    await withAtomicFlush(
+      em,
+      [
+        () => {
+          channel.channelState = {
+            ...current,
+            aiAutoReplyEnabled: input.settings.aiAutoReplyEnabled,
+            // Clearing the agent when auto-reply is switched off keeps the stored
+            // state honest: a disabled channel does not keep pointing at an agent.
+            aiAgentId
+          };
+        }
+      ],
+      { transaction: true, label: "channel_discord.channel.update_ai_auto_reply" }
+    );
+    return {
+      status: "updated",
+      channelId: channel.id,
+      aiAutoReplyEnabled: input.settings.aiAutoReplyEnabled,
+      aiAgentId: aiAgentId ?? null,
+      updatedAt: channel.updatedAt ? channel.updatedAt.toISOString() : null
+    };
+  }
+};
+registerCommand(updateAiAutoReplyCommand);
+var update_ai_auto_reply_default = updateAiAutoReplyCommand;
+export {
+  CHANNEL_DISCORD_CHANNEL_RESOURCE_KIND,
+  CHANNEL_DISCORD_UPDATE_AI_AUTO_REPLY_COMMAND_ID,
+  update_ai_auto_reply_default as default,
+  discordAiAutoReplySettingsSchema
+};
+//# sourceMappingURL=update-ai-auto-reply.js.map

package/dist/modules/channel_discord/commands/update-ai-auto-reply.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/channel_discord/commands/update-ai-auto-reply.ts"],
+  "sourcesContent": ["import type { EntityManager } from '@mikro-orm/postgresql'\nimport { z } from 'zod'\nimport type { CommandHandler } from '@open-mercato/shared/lib/commands'\nimport { registerCommand } from '@open-mercato/shared/lib/commands'\nimport { withAtomicFlush } from '@open-mercato/shared/lib/commands/flush'\nimport { enforceCommandOptimisticLockWithGuards } from '@open-mercato/shared/lib/crud/optimistic-lock-command'\nimport { findOneWithDecryption } from '@open-mercato/shared/lib/encryption/find'\nimport { CommunicationChannel } from '@open-mercato/core/modules/communication_channels/data/entities'\nimport { channelOrgScopeWhereFromFilter } from '@open-mercato/core/modules/communication_channels/lib/access-control'\nimport { discordChannelStateSchema } from '../lib/credentials'\n\n/**\n * Resource kind the channel's optimistic-lock check is scoped under. It matches\n * the `resourceKind` the route's mutation guard uses, so an operator's stale tab\n * fails the same way here as it would on any other channel write.\n */\nexport const CHANNEL_DISCORD_CHANNEL_RESOURCE_KIND = 'communication_channels.channel'\n\nexport const CHANNEL_DISCORD_UPDATE_AI_AUTO_REPLY_COMMAND_ID =\n  'channel_discord.channel.update_ai_auto_reply'\n\nexport const discordAiAutoReplySettingsSchema = z\n  .object({\n    aiAutoReplyEnabled: z.boolean(),\n    aiAgentId: z.string().trim().min(1).max(200).optional(),\n  })\n  .refine((value) => !value.aiAutoReplyEnabled || Boolean(value.aiAgentId), {\n    // Arming auto-reply without naming an agent is the state that made the\n    // original subscriber dormant; the schema refuses to reproduce it.\n    path: ['aiAgentId'],\n    message: 'channel_discord.aiAutoReply.errors.agentRequired',\n  })\n\nexport type DiscordAiAutoReplySettings = z.infer<typeof discordAiAutoReplySettingsSchema>\n\nconst updateAiAutoReplySchema = z.object({\n  channelId: z.string().uuid(),\n  settings: discordAiAutoReplySettingsSchema,\n  scope: z.object({\n    tenantId: z.string().uuid(),\n    /** Organization the decryption scope is anchored to. */\n    organizationId: z.string().uuid().nullable(),\n    /**\n     * Organizations the caller may see, as resolved by the route. A Discord bot\n     * channel is usually tenant-scoped (`organization_id IS NULL`), so filtering\n     * on a single organization would hide the very channels this command\n     * configures \u2014 the hub's `channelOrgScopeWhereFromFilter` encodes the right\n     * rule and is reused here.\n     */\n    organizationIds: z.array(z.string().uuid()).nullable().optional(),\n  }),\n  expectedUpdatedAt: z.string().optional(),\n})\n\nexport type UpdateAiAutoReplyInput = z.infer<typeof updateAiAutoReplySchema>\n\nexport type UpdateAiAutoReplyResult =\n  | {\n      status: 'updated'\n      channelId: string\n      aiAutoReplyEnabled: boolean\n      aiAgentId: string | null\n      updatedAt: string | null\n    }\n  | { status: 'not_found' }\n\n/**\n * Persist a Discord channel's AI auto-reply settings (issue #4778).\n *\n * The write goes through the command bus rather than an entity write in the\n * route so it inherits the platform's audit trail, and so the two keys the\n * subscriber reads have exactly one writer.\n *\n * Two things it is careful about:\n *\n * - **It merges.** `channelState` is shared with the gateway worker, which writes\n *   resume state (`sessionId`, `sequence`, `resumeGatewayUrl`, `botUserId`) from\n *   a socket callback. Replacing the blob would drop a live session's cursor and\n *   force a re-IDENTIFY, so only the two AI keys are touched \u2014 the mirror image\n *   of what `lib/channel-state-store.ts` does from the other side.\n * - **It version-checks.** The settings form sends the channel's `updatedAt`, so\n *   a save from a tab opened before someone else changed the channel fails with\n *   the standard 409 conflict body instead of silently winning.\n */\nconst updateAiAutoReplyCommand: CommandHandler<UpdateAiAutoReplyInput, UpdateAiAutoReplyResult> = {\n  id: CHANNEL_DISCORD_UPDATE_AI_AUTO_REPLY_COMMAND_ID,\n  // Not undoable on purpose: replaying a stale snapshot could re-arm auto-reply\n  // on a channel an operator deliberately disarmed \u2014 for example after the bot\n  // answered something it should not have. Reverting is a deliberate act through\n  // the same form, which leaves its own audit entry.\n  isUndoable: false,\n  async execute(rawInput, ctx) {\n    const input = updateAiAutoReplySchema.parse(rawInput)\n    const em = (ctx.container.resolve('em') as EntityManager).fork()\n    const dscope = { tenantId: input.scope.tenantId, organizationId: input.scope.organizationId }\n\n    const channel = await findOneWithDecryption(\n      em,\n      CommunicationChannel,\n      {\n        id: input.channelId,\n        tenantId: input.scope.tenantId,\n        providerKey: 'discord',\n        ...channelOrgScopeWhereFromFilter({ organizationIds: input.scope.organizationIds ?? undefined }),\n        deletedAt: null,\n      },\n      undefined,\n      dscope,\n    )\n    // Existence masking, consistent with the hub's channel-scoped routes: a\n    // channel in another tenant and a channel that never existed answer alike.\n    if (!channel) return { status: 'not_found' }\n\n    // The DI-aware seam, not the bare synchronous helper: it runs the OSS\n    // `updated_at` floor first and then awaits the optional enterprise\n    // `record_locks` guard, so a channel someone else holds a lock on is\n    // protected on an enterprise build too.\n    await enforceCommandOptimisticLockWithGuards(ctx.container, {\n      resourceKind: CHANNEL_DISCORD_CHANNEL_RESOURCE_KIND,\n      resourceId: channel.id,\n      current: channel.updatedAt,\n      expected: input.expectedUpdatedAt ?? null,\n      request: ctx.request ?? null,\n    })\n\n    const current = discordChannelStateSchema.parse(channel.channelState ?? {})\n    const aiAgentId = input.settings.aiAutoReplyEnabled ? input.settings.aiAgentId : undefined\n\n    await withAtomicFlush(\n      em,\n      [\n        () => {\n          channel.channelState = {\n            ...current,\n            aiAutoReplyEnabled: input.settings.aiAutoReplyEnabled,\n            // Clearing the agent when auto-reply is switched off keeps the stored\n            // state honest: a disabled channel does not keep pointing at an agent.\n            aiAgentId,\n          }\n        },\n      ],\n      { transaction: true, label: 'channel_discord.channel.update_ai_auto_reply' },\n    )\n\n    return {\n      status: 'updated',\n      channelId: channel.id,\n      aiAutoReplyEnabled: input.settings.aiAutoReplyEnabled,\n      aiAgentId: aiAgentId ?? null,\n      updatedAt: channel.updatedAt ? channel.updatedAt.toISOString() : null,\n    }\n  },\n}\n\nregisterCommand(updateAiAutoReplyCommand as CommandHandler<unknown, unknown>)\n\nexport default updateAiAutoReplyCommand\n"],
+  "mappings": "AACA,SAAS,SAAS;AAElB,SAAS,uBAAuB;AAChC,SAAS,uBAAuB;AAChC,SAAS,8CAA8C;AACvD,SAAS,6BAA6B;AACtC,SAAS,4BAA4B;AACrC,SAAS,sCAAsC;AAC/C,SAAS,iCAAiC;AAOnC,MAAM,wCAAwC;AAE9C,MAAM,kDACX;AAEK,MAAM,mCAAmC,EAC7C,OAAO;AAAA,EACN,oBAAoB,EAAE,QAAQ;AAAA,EAC9B,WAAW,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG,EAAE,SAAS;AACxD,CAAC,EACA,OAAO,CAAC,UAAU,CAAC,MAAM,sBAAsB,QAAQ,MAAM,SAAS,GAAG;AAAA;AAAA;AAAA,EAGxE,MAAM,CAAC,WAAW;AAAA,EAClB,SAAS;AACX,CAAC;AAIH,MAAM,0BAA0B,EAAE,OAAO;AAAA,EACvC,WAAW,EAAE,OAAO,EAAE,KAAK;AAAA,EAC3B,UAAU;AAAA,EACV,OAAO,EAAE,OAAO;AAAA,IACd,UAAU,EAAE,OAAO,EAAE,KAAK;AAAA;AAAA,IAE1B,gBAAgB,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAQ3C,iBAAiB,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,SAAS,EAAE,SAAS;AAAA,EAClE,CAAC;AAAA,EACD,mBAAmB,EAAE,OAAO,EAAE,SAAS;AACzC,CAAC;AAgCD,MAAM,2BAA4F;AAAA,EAChG,IAAI;AAAA;AAAA;AAAA;AAAA;AAAA,EAKJ,YAAY;AAAA,EACZ,MAAM,QAAQ,UAAU,KAAK;AAC3B,UAAM,QAAQ,wBAAwB,MAAM,QAAQ;AACpD,UAAM,KAAM,IAAI,UAAU,QAAQ,IAAI,EAAoB,KAAK;AAC/D,UAAM,SAAS,EAAE,UAAU,MAAM,MAAM,UAAU,gBAAgB,MAAM,MAAM,eAAe;AAE5F,UAAM,UAAU,MAAM;AAAA,MACpB;AAAA,MACA;AAAA,MACA;AAAA,QACE,IAAI,MAAM;AAAA,QACV,UAAU,MAAM,MAAM;AAAA,QACtB,aAAa;AAAA,QACb,GAAG,+BAA+B,EAAE,iBAAiB,MAAM,MAAM,mBAAmB,OAAU,CAAC;AAAA,QAC/F,WAAW;AAAA,MACb;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAGA,QAAI,CAAC,QAAS,QAAO,EAAE,QAAQ,YAAY;AAM3C,UAAM,uCAAuC,IAAI,WAAW;AAAA,MAC1D,cAAc;AAAA,MACd,YAAY,QAAQ;AAAA,MACpB,SAAS,QAAQ;AAAA,MACjB,UAAU,MAAM,qBAAqB;AAAA,MACrC,SAAS,IAAI,WAAW;AAAA,IAC1B,CAAC;AAED,UAAM,UAAU,0BAA0B,MAAM,QAAQ,gBAAgB,CAAC,CAAC;AAC1E,UAAM,YAAY,MAAM,SAAS,qBAAqB,MAAM,SAAS,YAAY;AAEjF,UAAM;AAAA,MACJ;AAAA,MACA;AAAA,QACE,MAAM;AACJ,kBAAQ,eAAe;AAAA,YACrB,GAAG;AAAA,YACH,oBAAoB,MAAM,SAAS;AAAA;AAAA;AAAA,YAGnC;AAAA,UACF;AAAA,QACF;AAAA,MACF;AAAA,MACA,EAAE,aAAa,MAAM,OAAO,+CAA+C;AAAA,IAC7E;AAEA,WAAO;AAAA,MACL,QAAQ;AAAA,MACR,WAAW,QAAQ;AAAA,MACnB,oBAAoB,MAAM,SAAS;AAAA,MACnC,WAAW,aAAa;AAAA,MACxB,WAAW,QAAQ,YAAY,QAAQ,UAAU,YAAY,IAAI;AAAA,IACnE;AAAA,EACF;AACF;AAEA,gBAAgB,wBAA4D;AAE5E,IAAO,+BAAQ;",
+  "names": []
+}

package/dist/modules/channel_discord/di.js

@@ -0,0 +1,23 @@
+import { asValue } from "awilix";
+import {
+  hasChannelAdapter,
+  registerChannelAdapter
+} from "@open-mercato/core/modules/communication_channels/lib/adapter-registry-singleton";
+import { getDiscordChannelAdapter } from "./lib/adapter.js";
+import { channelDiscordHealthCheck } from "./lib/health.js";
+function register(container) {
+  if (!hasChannelAdapter("discord")) {
+    registerChannelAdapter(getDiscordChannelAdapter());
+  }
+  container.register({
+    channelDiscordAdapter: asValue(getDiscordChannelAdapter()),
+    // Registered under the exact service name declared in `integration.ts`
+    // (`healthCheck.service`). Without this, the hub's `container.resolve(...)`
+    // throws and the channel reports permanently 'unhealthy'.
+    channelDiscordHealthCheck: asValue(channelDiscordHealthCheck)
+  });
+}
+export {
+  register
+};
+//# sourceMappingURL=di.js.map

package/dist/modules/channel_discord/di.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/modules/channel_discord/di.ts"],
+  "sourcesContent": ["import { asValue } from 'awilix'\nimport type { AppContainer } from '@open-mercato/shared/lib/di/container'\nimport {\n  hasChannelAdapter,\n  registerChannelAdapter,\n} from '@open-mercato/core/modules/communication_channels/lib/adapter-registry-singleton'\nimport { getDiscordChannelAdapter } from './lib/adapter'\nimport { channelDiscordHealthCheck } from './lib/health'\n\n/**\n * Re-register the adapter on container creation as a safety net for runtime\n * environments that bypass module setup (worker-only nodes, ad-hoc CLI). The\n * underlying registry is process-wide so the registration is idempotent.\n */\nexport function register(container: AppContainer): void {\n  if (!hasChannelAdapter('discord')) {\n    registerChannelAdapter(getDiscordChannelAdapter())\n  }\n  container.register({\n    channelDiscordAdapter: asValue(getDiscordChannelAdapter()),\n    // Registered under the exact service name declared in `integration.ts`\n    // (`healthCheck.service`). Without this, the hub's `container.resolve(...)`\n    // throws and the channel reports permanently 'unhealthy'.\n    channelDiscordHealthCheck: asValue(channelDiscordHealthCheck),\n  })\n}\n"],
+  "mappings": "AAAA,SAAS,eAAe;AAExB;AAAA,EACE;AAAA,EACA;AAAA,OACK;AACP,SAAS,gCAAgC;AACzC,SAAS,iCAAiC;AAOnC,SAAS,SAAS,WAA+B;AACtD,MAAI,CAAC,kBAAkB,SAAS,GAAG;AACjC,2BAAuB,yBAAyB,CAAC;AAAA,EACnD;AACA,YAAU,SAAS;AAAA,IACjB,uBAAuB,QAAQ,yBAAyB,CAAC;AAAA;AAAA;AAAA;AAAA,IAIzD,2BAA2B,QAAQ,yBAAyB;AAAA,EAC9D,CAAC;AACH;",
+  "names": []
+}

package/dist/modules/channel_discord/index.js

@@ -0,0 +1,9 @@
+const metadata = {
+  id: "channel_discord",
+  title: "Discord Communication Channel",
+  description: "Connect a Discord bot as a two-way communication channel. Outbound via the Discord REST API; inbound in real time via a Gateway worker; signed (Ed25519) Interactions endpoint that acknowledges slash commands / buttons. Optional per-channel AI auto-reply answers straightforward messages and proposes the rest for human approval. Pairs with the Communications Hub."
+};
+export {
+  metadata
+};
+//# sourceMappingURL=index.js.map

package/dist/modules/channel_discord/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/modules/channel_discord/index.ts"],
+  "sourcesContent": ["export const metadata = {\n  id: 'channel_discord',\n  title: 'Discord Communication Channel',\n  description:\n    'Connect a Discord bot as a two-way communication channel. Outbound via the Discord REST API; inbound in real time via a Gateway worker; signed (Ed25519) Interactions endpoint that acknowledges slash commands / buttons. Optional per-channel AI auto-reply answers straightforward messages and proposes the rest for human approval. Pairs with the Communications Hub.',\n}\n"],
+  "mappings": "AAAO,MAAM,WAAW;AAAA,EACtB,IAAI;AAAA,EACJ,OAAO;AAAA,EACP,aACE;AACJ;",
+  "names": []
+}

package/dist/modules/channel_discord/integration.js

@@ -0,0 +1,96 @@
+import { buildIntegrationDetailWidgetSpotId } from "@open-mercato/shared/modules/integrations/types";
+const channelDiscordDetailWidgetSpotId = buildIntegrationDetailWidgetSpotId("channel_discord");
+const integration = {
+  id: "channel_discord",
+  title: "Discord",
+  // Kept within the 68–132 character range the six sibling providers occupy: the
+  // card grid gives every description the same fixed box, so a long one inflates
+  // its whole row. The operational caveats it used to carry (gateway worker,
+  // queue strategy) belong on the detail page and in the credential help texts,
+  // which is where they now live.
+  description: "Two-way Discord bot channel: REST outbound, real-time Gateway inbound, optional AI auto-reply.",
+  category: "communication",
+  hub: "communication_channels",
+  providerKey: "discord",
+  icon: "discord",
+  docsUrl: "https://discord.com/developers/docs/intro",
+  package: "@open-mercato/channel-discord",
+  // The provider descriptor's own version, deliberately independent of the
+  // monorepo release the package happens to ship in — a copied monorepo version
+  // rots on every release bump and reads as a claim it is not making.
+  version: "1.0.0",
+  author: "Open Mercato Team",
+  company: "Open Mercato",
+  license: "MIT",
+  // `ai` returns here in the same change that makes auto-reply real: an agent the
+  // repository ships, a service principal with real features, a settings surface
+  // that arms it, and an approval surface for everything it must not send.
+  tags: ["discord", "chat", "bot", "gateway", "communication", "ai"],
+  detailPage: {
+    widgetSpotId: channelDiscordDetailWidgetSpotId
+  },
+  apiVersions: [
+    {
+      id: "v10",
+      label: "Discord API v10",
+      status: "stable",
+      default: true,
+      changelog: "Discord API v10 (REST) + Gateway v10 real-time inbound + Ed25519-signed Interactions."
+    }
+  ],
+  credentials: {
+    fields: [
+      {
+        key: "botToken",
+        label: "Bot token",
+        type: "secret",
+        required: true,
+        helpText: "Developer Portal \u2192 Applications \u2192 your app \u2192 Bot \u2192 Reset Token. Grants full control of the bot user. Stored encrypted at rest; never logged."
+      },
+      {
+        key: "applicationId",
+        label: "Application ID",
+        type: "text",
+        required: true,
+        placeholder: "123456789012345678",
+        helpText: "Developer Portal \u2192 General Information \u2192 Application ID. Used to register slash commands (mercato channel_discord register-slash-commands) and to answer interactions."
+      },
+      {
+        key: "publicKey",
+        label: "Public key",
+        type: "text",
+        required: true,
+        placeholder: "64-character hex Ed25519 public key",
+        helpText: "Developer Portal \u2192 General Information \u2192 Public Key. Verifies signed interaction requests; a verified slash command or button press is recorded in the inbox and answered back in Discord."
+      },
+      {
+        key: "guildId",
+        label: "Guild (server) ID",
+        type: "text",
+        required: false,
+        placeholder: "123456789012345678",
+        helpText: "Recommended: scope the bot to a single server. Enable Developer Mode in Discord, right-click the server, Copy Server ID."
+      },
+      {
+        key: "defaultChannelId",
+        label: "Default channel ID",
+        type: "text",
+        required: false,
+        placeholder: "123456789012345678",
+        helpText: "Default text channel the adapter posts to when an outbound message names no Discord channel. The hub test-send endpoint accepts a channel snowflake as its recipient, so you can use it to verify this end to end."
+      }
+    ]
+  },
+  healthCheck: { service: "channelDiscordHealthCheck" }
+};
+const integrations = [integration];
+const bundles = [];
+const bundle = void 0;
+export {
+  bundle,
+  bundles,
+  channelDiscordDetailWidgetSpotId,
+  integration,
+  integrations
+};
+//# sourceMappingURL=integration.js.map

package/dist/modules/channel_discord/integration.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/modules/channel_discord/integration.ts"],
+  "sourcesContent": ["import { buildIntegrationDetailWidgetSpotId, type IntegrationBundle, type IntegrationDefinition } from '@open-mercato/shared/modules/integrations/types'\n\nexport const channelDiscordDetailWidgetSpotId = buildIntegrationDetailWidgetSpotId('channel_discord')\n\nexport const integration: IntegrationDefinition = {\n  id: 'channel_discord',\n  title: 'Discord',\n  // Kept within the 68\u2013132 character range the six sibling providers occupy: the\n  // card grid gives every description the same fixed box, so a long one inflates\n  // its whole row. The operational caveats it used to carry (gateway worker,\n  // queue strategy) belong on the detail page and in the credential help texts,\n  // which is where they now live.\n  description: 'Two-way Discord bot channel: REST outbound, real-time Gateway inbound, optional AI auto-reply.',\n  category: 'communication',\n  hub: 'communication_channels',\n  providerKey: 'discord',\n  icon: 'discord',\n  docsUrl: 'https://discord.com/developers/docs/intro',\n  package: '@open-mercato/channel-discord',\n  // The provider descriptor's own version, deliberately independent of the\n  // monorepo release the package happens to ship in \u2014 a copied monorepo version\n  // rots on every release bump and reads as a claim it is not making.\n  version: '1.0.0',\n  author: 'Open Mercato Team',\n  company: 'Open Mercato',\n  license: 'MIT',\n  // `ai` returns here in the same change that makes auto-reply real: an agent the\n  // repository ships, a service principal with real features, a settings surface\n  // that arms it, and an approval surface for everything it must not send.\n  tags: ['discord', 'chat', 'bot', 'gateway', 'communication', 'ai'],\n  detailPage: {\n    widgetSpotId: channelDiscordDetailWidgetSpotId,\n  },\n  apiVersions: [\n    {\n      id: 'v10',\n      label: 'Discord API v10',\n      status: 'stable',\n      default: true,\n      changelog: 'Discord API v10 (REST) + Gateway v10 real-time inbound + Ed25519-signed Interactions.',\n    },\n  ],\n  credentials: {\n    fields: [\n      {\n        key: 'botToken',\n        label: 'Bot token',\n        type: 'secret',\n        required: true,\n        helpText:\n          'Developer Portal \u2192 Applications \u2192 your app \u2192 Bot \u2192 Reset Token. Grants full control of the bot user. Stored encrypted at rest; never logged.',\n      },\n      {\n        key: 'applicationId',\n        label: 'Application ID',\n        type: 'text',\n        required: true,\n        placeholder: '123456789012345678',\n        helpText:\n          'Developer Portal \u2192 General Information \u2192 Application ID. Used to register slash commands'\n          + ' (mercato channel_discord register-slash-commands) and to answer interactions.',\n      },\n      {\n        key: 'publicKey',\n        label: 'Public key',\n        type: 'text',\n        required: true,\n        placeholder: '64-character hex Ed25519 public key',\n        helpText:\n          'Developer Portal \u2192 General Information \u2192 Public Key. Verifies signed interaction requests; a verified'\n          + ' slash command or button press is recorded in the inbox and answered back in Discord.',\n      },\n      {\n        key: 'guildId',\n        label: 'Guild (server) ID',\n        type: 'text',\n        required: false,\n        placeholder: '123456789012345678',\n        helpText: 'Recommended: scope the bot to a single server. Enable Developer Mode in Discord, right-click the server, Copy Server ID.',\n      },\n      {\n        key: 'defaultChannelId',\n        label: 'Default channel ID',\n        type: 'text',\n        required: false,\n        placeholder: '123456789012345678',\n        helpText:\n          'Default text channel the adapter posts to when an outbound message names no Discord channel. The hub'\n          + ' test-send endpoint accepts a channel snowflake as its recipient, so you can use it to verify this end to end.',\n      },\n    ],\n  },\n  healthCheck: { service: 'channelDiscordHealthCheck' },\n}\n\nexport const integrations: IntegrationDefinition[] = [integration]\nexport const bundles: IntegrationBundle[] = []\nexport const bundle: IntegrationBundle | undefined = undefined\n"],
+  "mappings": "AAAA,SAAS,0CAA8F;AAEhG,MAAM,mCAAmC,mCAAmC,iBAAiB;AAE7F,MAAM,cAAqC;AAAA,EAChD,IAAI;AAAA,EACJ,OAAO;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAMP,aAAa;AAAA,EACb,UAAU;AAAA,EACV,KAAK;AAAA,EACL,aAAa;AAAA,EACb,MAAM;AAAA,EACN,SAAS;AAAA,EACT,SAAS;AAAA;AAAA;AAAA;AAAA,EAIT,SAAS;AAAA,EACT,QAAQ;AAAA,EACR,SAAS;AAAA,EACT,SAAS;AAAA;AAAA;AAAA;AAAA,EAIT,MAAM,CAAC,WAAW,QAAQ,OAAO,WAAW,iBAAiB,IAAI;AAAA,EACjE,YAAY;AAAA,IACV,cAAc;AAAA,EAChB;AAAA,EACA,aAAa;AAAA,IACX;AAAA,MACE,IAAI;AAAA,MACJ,OAAO;AAAA,MACP,QAAQ;AAAA,MACR,SAAS;AAAA,MACT,WAAW;AAAA,IACb;AAAA,EACF;AAAA,EACA,aAAa;AAAA,IACX,QAAQ;AAAA,MACN;AAAA,QACE,KAAK;AAAA,QACL,OAAO;AAAA,QACP,MAAM;AAAA,QACN,UAAU;AAAA,QACV,UACE;AAAA,MACJ;AAAA,MACA;AAAA,QACE,KAAK;AAAA,QACL,OAAO;AAAA,QACP,MAAM;AAAA,QACN,UAAU;AAAA,QACV,aAAa;AAAA,QACb,UACE;AAAA,MAEJ;AAAA,MACA;AAAA,QACE,KAAK;AAAA,QACL,OAAO;AAAA,QACP,MAAM;AAAA,QACN,UAAU;AAAA,QACV,aAAa;AAAA,QACb,UACE;AAAA,MAEJ;AAAA,MACA;AAAA,QACE,KAAK;AAAA,QACL,OAAO;AAAA,QACP,MAAM;AAAA,QACN,UAAU;AAAA,QACV,aAAa;AAAA,QACb,UAAU;AAAA,MACZ;AAAA,MACA;AAAA,QACE,KAAK;AAAA,QACL,OAAO;AAAA,QACP,MAAM;AAAA,QACN,UAAU;AAAA,QACV,aAAa;AAAA,QACb,UACE;AAAA,MAEJ;AAAA,IACF;AAAA,EACF;AAAA,EACA,aAAa,EAAE,SAAS,4BAA4B;AACtD;AAEO,MAAM,eAAwC,CAAC,WAAW;AAC1D,MAAM,UAA+B,CAAC;AACtC,MAAM,SAAwC;",
+  "names": []
+}

package/dist/modules/channel_discord/lib/adapter.js

@@ -0,0 +1,248 @@
+import { discordCapabilities } from "./capabilities.js";
+import { parseDiscordCredentialsOrThrow, discordCredentialsSchema } from "./credentials.js";
+import {
+  DiscordApiError,
+  getDiscordRestClient
+} from "./discord-rest.js";
+import { convertOutboundForDiscord } from "./convert-outbound.js";
+import {
+  DISCORD_CONVERSATION_PREFIX,
+  normalizeInboundDiscordMessage
+} from "./normalize-inbound.js";
+import {
+  parseInteractionBody,
+  verifyDiscordSignature
+} from "./interactions-verify.js";
+class DiscordChannelAdapter {
+  constructor() {
+    this.providerKey = "discord";
+    this.channelType = "discord";
+    this.capabilities = discordCapabilities;
+  }
+  async sendMessage(input) {
+    const credentials = parseDiscordCredentialsOrThrow(input.credentials);
+    let native;
+    try {
+      native = await convertOutboundForDiscord({
+        body: input.content.text ?? input.content.html ?? "",
+        bodyFormat: input.content.bodyFormat ?? (input.content.html ? "html" : "text"),
+        attachments: input.content.attachments,
+        channelMetadata: input.metadata
+      });
+    } catch (error) {
+      const message = error instanceof Error ? error.message : "Outbound conversion failed";
+      return { externalMessageId: "", status: "failed", error: message };
+    }
+    const targetChannelId = resolveTargetChannelId(input, credentials.defaultChannelId);
+    if (!targetChannelId) {
+      return {
+        externalMessageId: "",
+        status: "failed",
+        error: "[internal] Discord send requires a target channel id (conversationId or defaultChannelId)"
+      };
+    }
+    const meta = native.metadata ?? {};
+    try {
+      const message = await getDiscordRestClient().createMessage(
+        { botToken: credentials.botToken },
+        {
+          channelId: targetChannelId,
+          content: native.content.text ?? "",
+          messageReferenceId: typeof meta.messageReferenceId === "string" ? meta.messageReferenceId : void 0,
+          allowedMentions: meta.allowedMentions ?? { parse: [] }
+        }
+      );
+      return {
+        externalMessageId: message.id,
+        conversationId: `${DISCORD_CONVERSATION_PREFIX}${message.channel_id}`,
+        status: "sent",
+        metadata: { discordChannelId: message.channel_id, discordMessageId: message.id }
+      };
+    } catch (error) {
+      if (error instanceof DiscordApiError && error.status === 401) {
+        return { externalMessageId: "", status: "failed", error: "requires_reauth" };
+      }
+      const message = error instanceof Error ? error.message : "Discord send failed";
+      return { externalMessageId: "", status: "failed", error: message };
+    }
+  }
+  async verifyWebhook(input) {
+    const rawBody = typeof input.rawBody === "string" ? input.rawBody : input.rawBody.toString("utf-8");
+    const interaction = parseInteractionBody(rawBody);
+    if (!interaction) {
+      return { raw: {}, eventType: "other", metadata: { reason: "discord-uses-gateway-for-messages" } };
+    }
+    const parsed = discordCredentialsSchema.safeParse(input.credentials);
+    const publicKeyHex = parsed.success ? parsed.data.publicKey : "";
+    const headers = normalizeHeaders(input.headers);
+    const ok = verifyDiscordSignature({
+      publicKeyHex,
+      signatureHex: headers["x-signature-ed25519"],
+      timestamp: headers["x-signature-timestamp"],
+      rawBody
+    });
+    if (!ok) {
+      throw new Error("[internal] Discord interaction signature verification failed");
+    }
+    return { raw: { discordInteraction: interaction }, eventType: "other", metadata: { interactionType: interaction.type } };
+  }
+  async getStatus(_input) {
+    return { status: "sent" };
+  }
+  async convertOutbound(input) {
+    return convertOutboundForDiscord(input);
+  }
+  async normalizeInbound(raw) {
+    const message = pickDiscordMessage(raw);
+    return normalizeInboundDiscordMessage(message);
+  }
+  async normalizeInboundReaction(raw) {
+    const payload = raw.raw?.discordReaction ?? raw.raw;
+    const emojiName = payload.emoji?.name ?? "";
+    const emoji = payload.emoji?.id ? `${emojiName}:${payload.emoji.id}` : emojiName;
+    return {
+      externalMessageId: payload.message_id ?? "",
+      externalConversationId: payload.channel_id ? `${DISCORD_CONVERSATION_PREFIX}${payload.channel_id}` : void 0,
+      emoji,
+      userIdentifier: payload.user_id ?? "unknown",
+      userDisplayName: payload.member?.user?.global_name ?? payload.member?.user?.username,
+      action: payload.action === "removed" ? "removed" : "added",
+      raw: payload
+    };
+  }
+  async sendReaction(input) {
+    const credentials = parseDiscordCredentialsOrThrow(input.credentials);
+    const channelId = stripConversationPrefix(input.conversationId) ?? credentials.defaultChannelId;
+    if (!channelId) throw new Error("[internal] Discord sendReaction requires a channel id");
+    await getDiscordRestClient().addReaction(
+      { botToken: credentials.botToken },
+      channelId,
+      input.externalMessageId,
+      input.emoji
+    );
+  }
+  async removeReaction(input) {
+    const credentials = parseDiscordCredentialsOrThrow(input.credentials);
+    const channelId = stripConversationPrefix(input.conversationId) ?? credentials.defaultChannelId;
+    if (!channelId) throw new Error("[internal] Discord removeReaction requires a channel id");
+    await getDiscordRestClient().removeReaction(
+      { botToken: credentials.botToken },
+      channelId,
+      input.externalMessageId,
+      input.emoji
+    );
+  }
+  async editMessage(input) {
+    const credentials = parseDiscordCredentialsOrThrow(input.credentials);
+    const channelId = stripConversationPrefix(input.conversationId) ?? credentials.defaultChannelId;
+    if (!channelId) throw new Error("[internal] Discord editMessage requires a channel id");
+    const content = input.newContent.text ?? input.newContent.html ?? "";
+    await getDiscordRestClient().editMessage(
+      { botToken: credentials.botToken },
+      channelId,
+      input.externalMessageId,
+      content
+    );
+  }
+  async deleteMessage(input) {
+    const credentials = parseDiscordCredentialsOrThrow(input.credentials);
+    const channelId = stripConversationPrefix(input.conversationId) ?? credentials.defaultChannelId;
+    if (!channelId) throw new Error("[internal] Discord deleteMessage requires a channel id");
+    await getDiscordRestClient().deleteMessage(
+      { botToken: credentials.botToken },
+      channelId,
+      input.externalMessageId
+    );
+  }
+  async fetchHistory(input) {
+    const credentials = parseDiscordCredentialsOrThrow(input.credentials);
+    const channelId = stripConversationPrefix(input.conversationId) ?? credentials.defaultChannelId;
+    if (!channelId) {
+      return { messages: [], hasMore: false };
+    }
+    const limit = Math.min(Math.max(input.limit ?? 50, 1), 100);
+    const raw = await getDiscordRestClient().listMessages(
+      { botToken: credentials.botToken },
+      channelId,
+      { before: input.cursor, limit }
+    );
+    const messages = raw.map((message) => normalizeInboundDiscordMessage(message));
+    const oldest = raw.length > 0 ? raw[raw.length - 1].id : void 0;
+    return {
+      messages,
+      nextCursor: raw.length >= limit ? oldest : void 0,
+      hasMore: raw.length >= limit
+    };
+  }
+  async resolveContact(input) {
+    const userId = input.senderIdentifier;
+    if (!userId || userId === "unknown") return null;
+    const displayName = input.senderDisplayName || (typeof input.channelMetadata?.discordAuthorUsername === "string" ? input.channelMetadata.discordAuthorUsername : void 0);
+    return {
+      displayName,
+      externalProfileUrl: `https://discord.com/users/${encodeURIComponent(userId)}`
+    };
+  }
+  async validateCredentials(input) {
+    const parsed = discordCredentialsSchema.safeParse(input.credentials);
+    if (!parsed.success) {
+      const errors = {};
+      for (const issue of parsed.error.issues) {
+        const path = issue.path[0];
+        if (typeof path !== "string") continue;
+        if (!errors[path]) errors[path] = issue.message;
+      }
+      return { ok: false, errors };
+    }
+    try {
+      await getDiscordRestClient().getCurrentUser({ botToken: parsed.data.botToken });
+      return { ok: true };
+    } catch (error) {
+      const status = error instanceof DiscordApiError ? error.status : 0;
+      return {
+        ok: false,
+        errors: {
+          botToken: status === 401 ? "Discord rejected the bot token. Reset it in the Developer Portal and paste the new value." : "Could not reach Discord to validate the bot token. Check the token and try again."
+        }
+      };
+    }
+  }
+}
+function normalizeHeaders(headers) {
+  const out = {};
+  for (const [key, value] of Object.entries(headers)) {
+    if (value === void 0) continue;
+    out[key.toLowerCase()] = Array.isArray(value) ? value[0] ?? "" : value;
+  }
+  return out;
+}
+function stripConversationPrefix(conversationId) {
+  if (!conversationId) return void 0;
+  return conversationId.startsWith(DISCORD_CONVERSATION_PREFIX) ? conversationId.slice(DISCORD_CONVERSATION_PREFIX.length) : conversationId;
+}
+function resolveTargetChannelId(input, defaultChannelId) {
+  const fromMeta = input.metadata?.discordChannelId;
+  if (typeof fromMeta === "string" && fromMeta.length > 0) return fromMeta;
+  const fromConversation = stripConversationPrefix(input.conversationId);
+  if (fromConversation && fromConversation.length > 0) return fromConversation;
+  const fromRecipient = input.metadata?.to;
+  if (typeof fromRecipient === "string" && fromRecipient.length > 0) return fromRecipient;
+  return defaultChannelId;
+}
+function pickDiscordMessage(raw) {
+  const candidate = raw.raw?.discordMessage ?? raw.raw;
+  if (!candidate || typeof candidate !== "object" || typeof candidate.id !== "string") {
+    throw new Error("[internal] Discord normalizeInbound requires `raw.discordMessage` to be a Discord message object");
+  }
+  return candidate;
+}
+let cachedAdapter = null;
+function getDiscordChannelAdapter() {
+  if (!cachedAdapter) cachedAdapter = new DiscordChannelAdapter();
+  return cachedAdapter;
+}
+export {
+  DiscordChannelAdapter,
+  getDiscordChannelAdapter
+};
+//# sourceMappingURL=adapter.js.map

package/dist/modules/channel_discord/lib/adapter.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/channel_discord/lib/adapter.ts"],
+  "sourcesContent": ["import type {\n  ChannelAdapter,\n  ChannelNativeContent,\n  ContactHint,\n  ConvertOutboundInput,\n  DeleteChannelMessageInput,\n  EditChannelMessageInput,\n  FetchHistoryInput,\n  GetMessageStatusInput,\n  HistoryPage,\n  InboundMessage,\n  InboundReactionEvent,\n  MessageStatus,\n  NormalizedInboundMessage,\n  RemoveReactionInput,\n  ResolveContactInput,\n  SendMessageInput,\n  SendMessageResult,\n  SendReactionInput,\n  ValidateCredentialsInput,\n  ValidateCredentialsResult,\n  VerifyWebhookInput,\n} from '@open-mercato/core/modules/communication_channels/lib/adapter'\nimport { discordCapabilities } from './capabilities'\nimport { parseDiscordCredentialsOrThrow, discordCredentialsSchema } from './credentials'\nimport {\n  DiscordApiError,\n  getDiscordRestClient,\n  type DiscordMessageObject,\n} from './discord-rest'\nimport { convertOutboundForDiscord } from './convert-outbound'\nimport {\n  DISCORD_CONVERSATION_PREFIX,\n  normalizeInboundDiscordMessage,\n} from './normalize-inbound'\nimport {\n  parseInteractionBody,\n  verifyDiscordSignature,\n} from './interactions-verify'\n\n/**\n * Discord `ChannelAdapter` (SPEC 2026-06-19).\n *\n * Transport split:\n *   - Outbound: Discord REST API (`sendMessage`, edit/delete/reactions).\n *   - Inbound messages: a provider-owned **Gateway worker** pushes\n *     `MESSAGE_CREATE` events into the hub's ingest command \u2014 NOT this\n *     `verifyWebhook` hook (Discord does not POST normal messages to a webhook).\n *   - Slash commands / buttons: a signed **Interactions** endpoint\n *     (`api/interactions` \u2192 `/api/channel_discord/interactions`) with Ed25519 verification.\n *\n * `verifyWebhook` security contract (fail-closed): the shared\n * `api/post/webhook/[provider]` route treats a non-throwing return as \"verified\".\n * For a Discord interaction body we verify the Ed25519 signature and THROW on any\n * failure; for a non-interaction body (a normal message never arrives here) we\n * return `eventType: 'other'` so the generic route acks without tenant-scoped\n * work. Live PING\u2192PONG handshakes are served by the dedicated interactions route,\n * which can answer synchronously (the generic route only 202-acks).\n */\nclass DiscordChannelAdapter implements ChannelAdapter {\n  readonly providerKey = 'discord'\n  readonly channelType = 'discord'\n  readonly capabilities = discordCapabilities\n\n  async sendMessage(input: SendMessageInput): Promise<SendMessageResult> {\n    const credentials = parseDiscordCredentialsOrThrow(input.credentials)\n\n    let native: ChannelNativeContent\n    try {\n      native = await convertOutboundForDiscord({\n        body: input.content.text ?? input.content.html ?? '',\n        bodyFormat: input.content.bodyFormat ?? (input.content.html ? 'html' : 'text'),\n        attachments: input.content.attachments,\n        channelMetadata: input.metadata,\n      })\n    } catch (error) {\n      const message = error instanceof Error ? error.message : 'Outbound conversion failed'\n      return { externalMessageId: '', status: 'failed', error: message }\n    }\n\n    const targetChannelId = resolveTargetChannelId(input, credentials.defaultChannelId)\n    if (!targetChannelId) {\n      return {\n        externalMessageId: '',\n        status: 'failed',\n        error: '[internal] Discord send requires a target channel id (conversationId or defaultChannelId)',\n      }\n    }\n\n    const meta = (native.metadata ?? {}) as Record<string, unknown>\n    try {\n      const message = await getDiscordRestClient().createMessage(\n        { botToken: credentials.botToken },\n        {\n          channelId: targetChannelId,\n          content: native.content.text ?? '',\n          messageReferenceId: typeof meta.messageReferenceId === 'string' ? meta.messageReferenceId : undefined,\n          allowedMentions: (meta.allowedMentions as Record<string, unknown> | undefined) ?? { parse: [] },\n        },\n      )\n      return {\n        externalMessageId: message.id,\n        conversationId: `${DISCORD_CONVERSATION_PREFIX}${message.channel_id}`,\n        status: 'sent',\n        metadata: { discordChannelId: message.channel_id, discordMessageId: message.id },\n      }\n    } catch (error) {\n      if (error instanceof DiscordApiError && error.status === 401) {\n        // Protocol sentinel the hub keys on (error-classification.isReauthError).\n        return { externalMessageId: '', status: 'failed', error: 'requires_reauth' }\n      }\n      const message = error instanceof Error ? error.message : 'Discord send failed'\n      return { externalMessageId: '', status: 'failed', error: message }\n    }\n  }\n\n  async verifyWebhook(input: VerifyWebhookInput): Promise<InboundMessage> {\n    const rawBody = typeof input.rawBody === 'string' ? input.rawBody : input.rawBody.toString('utf-8')\n    const interaction = parseInteractionBody(rawBody)\n    if (!interaction) {\n      // Not an interaction payload \u2014 Discord messages arrive via the gateway\n      // worker, so ack (202) without tenant-scoped work.\n      return { raw: {}, eventType: 'other', metadata: { reason: 'discord-uses-gateway-for-messages' } }\n    }\n\n    const parsed = discordCredentialsSchema.safeParse(input.credentials)\n    const publicKeyHex = parsed.success ? parsed.data.publicKey : ''\n    const headers = normalizeHeaders(input.headers)\n    const ok = verifyDiscordSignature({\n      publicKeyHex,\n      signatureHex: headers['x-signature-ed25519'],\n      timestamp: headers['x-signature-timestamp'],\n      rawBody,\n    })\n    if (!ok) {\n      // FAIL-CLOSED: throwing makes the shared route reject (401) and pins nothing.\n      throw new Error('[internal] Discord interaction signature verification failed')\n    }\n    // Verified interaction. The generic hub route cannot answer the synchronous\n    // PING\u2192PONG handshake, so real interactions are served by the dedicated\n    // `api/interactions` \u2192 `/api/channel_discord/interactions` route; here we only prove the\n    // signature and ack.\n    return { raw: { discordInteraction: interaction }, eventType: 'other', metadata: { interactionType: interaction.type } }\n  }\n\n  async getStatus(_input: GetMessageStatusInput): Promise<MessageStatus> {\n    // Discord exposes no per-message delivery-status API; best-effort placeholder.\n    return { status: 'sent' }\n  }\n\n  async convertOutbound(input: ConvertOutboundInput): Promise<ChannelNativeContent> {\n    return convertOutboundForDiscord(input)\n  }\n\n  async normalizeInbound(raw: InboundMessage): Promise<NormalizedInboundMessage> {\n    const message = pickDiscordMessage(raw)\n    return normalizeInboundDiscordMessage(message)\n  }\n\n  async normalizeInboundReaction(raw: InboundMessage): Promise<InboundReactionEvent> {\n    const payload = (raw.raw?.discordReaction ?? raw.raw) as {\n      message_id?: string\n      channel_id?: string\n      emoji?: { name?: string; id?: string | null }\n      user_id?: string\n      member?: { user?: { username?: string; global_name?: string | null } }\n      action?: 'added' | 'removed'\n    }\n    const emojiName = payload.emoji?.name ?? ''\n    const emoji = payload.emoji?.id ? `${emojiName}:${payload.emoji.id}` : emojiName\n    return {\n      externalMessageId: payload.message_id ?? '',\n      externalConversationId: payload.channel_id\n        ? `${DISCORD_CONVERSATION_PREFIX}${payload.channel_id}`\n        : undefined,\n      emoji,\n      userIdentifier: payload.user_id ?? 'unknown',\n      userDisplayName: payload.member?.user?.global_name ?? payload.member?.user?.username,\n      action: payload.action === 'removed' ? 'removed' : 'added',\n      raw: payload as Record<string, unknown>,\n    }\n  }\n\n  async sendReaction(input: SendReactionInput): Promise<void> {\n    const credentials = parseDiscordCredentialsOrThrow(input.credentials)\n    const channelId = stripConversationPrefix(input.conversationId) ?? credentials.defaultChannelId\n    if (!channelId) throw new Error('[internal] Discord sendReaction requires a channel id')\n    await getDiscordRestClient().addReaction(\n      { botToken: credentials.botToken },\n      channelId,\n      input.externalMessageId,\n      input.emoji,\n    )\n  }\n\n  async removeReaction(input: RemoveReactionInput): Promise<void> {\n    const credentials = parseDiscordCredentialsOrThrow(input.credentials)\n    const channelId = stripConversationPrefix(input.conversationId) ?? credentials.defaultChannelId\n    if (!channelId) throw new Error('[internal] Discord removeReaction requires a channel id')\n    await getDiscordRestClient().removeReaction(\n      { botToken: credentials.botToken },\n      channelId,\n      input.externalMessageId,\n      input.emoji,\n    )\n  }\n\n  async editMessage(input: EditChannelMessageInput): Promise<void> {\n    const credentials = parseDiscordCredentialsOrThrow(input.credentials)\n    const channelId = stripConversationPrefix(input.conversationId) ?? credentials.defaultChannelId\n    if (!channelId) throw new Error('[internal] Discord editMessage requires a channel id')\n    const content = input.newContent.text ?? input.newContent.html ?? ''\n    await getDiscordRestClient().editMessage(\n      { botToken: credentials.botToken },\n      channelId,\n      input.externalMessageId,\n      content,\n    )\n  }\n\n  async deleteMessage(input: DeleteChannelMessageInput): Promise<void> {\n    const credentials = parseDiscordCredentialsOrThrow(input.credentials)\n    const channelId = stripConversationPrefix(input.conversationId) ?? credentials.defaultChannelId\n    if (!channelId) throw new Error('[internal] Discord deleteMessage requires a channel id')\n    await getDiscordRestClient().deleteMessage(\n      { botToken: credentials.botToken },\n      channelId,\n      input.externalMessageId,\n    )\n  }\n\n  async fetchHistory(input: FetchHistoryInput): Promise<HistoryPage> {\n    const credentials = parseDiscordCredentialsOrThrow(input.credentials)\n    const channelId = stripConversationPrefix(input.conversationId) ?? credentials.defaultChannelId\n    if (!channelId) {\n      return { messages: [], hasMore: false }\n    }\n    const limit = Math.min(Math.max(input.limit ?? 50, 1), 100)\n    const raw = await getDiscordRestClient().listMessages(\n      { botToken: credentials.botToken },\n      channelId,\n      { before: input.cursor, limit },\n    )\n    // Discord returns newest-first; keep that order but expose the oldest id as\n    // the next `before` cursor for backward pagination.\n    const messages = raw.map((message) => normalizeInboundDiscordMessage(message))\n    const oldest = raw.length > 0 ? raw[raw.length - 1].id : undefined\n    return {\n      messages,\n      nextCursor: raw.length >= limit ? oldest : undefined,\n      hasMore: raw.length >= limit,\n    }\n  }\n\n  async resolveContact(input: ResolveContactInput): Promise<ContactHint | null> {\n    const userId = input.senderIdentifier\n    if (!userId || userId === 'unknown') return null\n    const displayName =\n      input.senderDisplayName ||\n      (typeof input.channelMetadata?.discordAuthorUsername === 'string'\n        ? (input.channelMetadata.discordAuthorUsername as string)\n        : undefined)\n    return {\n      displayName,\n      externalProfileUrl: `https://discord.com/users/${encodeURIComponent(userId)}`,\n    }\n  }\n\n  async validateCredentials(input: ValidateCredentialsInput): Promise<ValidateCredentialsResult> {\n    const parsed = discordCredentialsSchema.safeParse(input.credentials)\n    if (!parsed.success) {\n      const errors: Record<string, string> = {}\n      for (const issue of parsed.error.issues) {\n        const path = issue.path[0]\n        if (typeof path !== 'string') continue\n        if (!errors[path]) errors[path] = issue.message\n      }\n      return { ok: false, errors }\n    }\n    try {\n      await getDiscordRestClient().getCurrentUser({ botToken: parsed.data.botToken })\n      return { ok: true }\n    } catch (error) {\n      const status = error instanceof DiscordApiError ? error.status : 0\n      return {\n        ok: false,\n        errors: {\n          botToken:\n            status === 401\n              ? 'Discord rejected the bot token. Reset it in the Developer Portal and paste the new value.'\n              : 'Could not reach Discord to validate the bot token. Check the token and try again.',\n        },\n      }\n    }\n  }\n}\n\nfunction normalizeHeaders(headers: Record<string, string | string[] | undefined>): Record<string, string> {\n  const out: Record<string, string> = {}\n  for (const [key, value] of Object.entries(headers)) {\n    if (value === undefined) continue\n    out[key.toLowerCase()] = Array.isArray(value) ? (value[0] ?? '') : value\n  }\n  return out\n}\n\nfunction stripConversationPrefix(conversationId: string | undefined): string | undefined {\n  if (!conversationId) return undefined\n  return conversationId.startsWith(DISCORD_CONVERSATION_PREFIX)\n    ? conversationId.slice(DISCORD_CONVERSATION_PREFIX.length)\n    : conversationId\n}\n\n/**\n * Where an outbound message is actually posted, in priority order.\n *\n * `metadata.to` is in this list because of what QA found on #4391: the hub's\n * `test-send` route puts the operator's recipient in `metadata.to`, nothing\n * here read it, and every send therefore went to `defaultChannelId` while the\n * endpoint answered `200 sent`. Validating a recipient and then discarding it\n * is worse than rejecting it \u2014 an operator test-sending to one channel got a\n * success for a message that landed in another.\n *\n * `conversationId` deliberately outranks `metadata.to`: on a reply the thread\n * mapping is authoritative, and a stray `to` must never redirect a reply out of\n * its own conversation. `metadata.to` only decides when there is no\n * conversation to belong to, which is exactly the test-send case.\n *\n * With `capabilities.recipientFormat: 'provider-native'` the hub has already\n * applied its transport-safety checks to this value, but it stays untrusted\n * input: it reaches `/channels/{id}/messages` and a wrong-but-well-formed id\n * simply fails at Discord, which is the honest outcome.\n */\nfunction resolveTargetChannelId(input: SendMessageInput, defaultChannelId: string | undefined): string | undefined {\n  const fromMeta = input.metadata?.discordChannelId\n  if (typeof fromMeta === 'string' && fromMeta.length > 0) return fromMeta\n  const fromConversation = stripConversationPrefix(input.conversationId)\n  if (fromConversation && fromConversation.length > 0) return fromConversation\n  const fromRecipient = input.metadata?.to\n  if (typeof fromRecipient === 'string' && fromRecipient.length > 0) return fromRecipient\n  return defaultChannelId\n}\n\nfunction pickDiscordMessage(raw: InboundMessage): DiscordMessageObject {\n  const candidate = (raw.raw?.discordMessage ?? raw.raw) as DiscordMessageObject | undefined\n  if (!candidate || typeof candidate !== 'object' || typeof candidate.id !== 'string') {\n    throw new Error('[internal] Discord normalizeInbound requires `raw.discordMessage` to be a Discord message object')\n  }\n  return candidate\n}\n\nlet cachedAdapter: DiscordChannelAdapter | null = null\n\nexport function getDiscordChannelAdapter(): DiscordChannelAdapter {\n  if (!cachedAdapter) cachedAdapter = new DiscordChannelAdapter()\n  return cachedAdapter\n}\n\nexport { DiscordChannelAdapter }\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/modules/channel_discord/lib/ai-agent-directory.js

@@ -0,0 +1,45 @@
+import { authorizeFeatures } from "@open-mercato/shared/security/featurePolicy";
+import { createLogger } from "@open-mercato/shared/lib/logger";
+const logger = createLogger("channel_discord").child({ component: "ai-agent-directory" });
+async function listDiscordEligibleAgents() {
+  let mod;
+  try {
+    mod = await import("@open-mercato/ai-assistant");
+  } catch {
+    return { available: false };
+  }
+  if (typeof mod.loadAgentRegistry !== "function" || typeof mod.listAgents !== "function") {
+    return { available: false };
+  }
+  try {
+    await mod.loadAgentRegistry();
+  } catch (err) {
+    logger.warn("Failed to load the AI agent registry", { err });
+    return { available: false };
+  }
+  const agents = mod.listAgents().filter((agent) => agent.executionMode === "object" || Boolean(agent.output)).map((agent) => ({
+    id: agent.id,
+    label: agent.label ?? agent.id,
+    description: agent.description ?? "",
+    requiredFeatures: agent.requiredFeatures ?? []
+  }));
+  return { available: true, agents };
+}
+async function findDiscordEligibleAgent(agentId) {
+  const directory = await listDiscordEligibleAgents();
+  if (!directory.available) return null;
+  return directory.agents.find((agent) => agent.id === agentId) ?? null;
+}
+function missingAgentFeatures(requiredFeatures, principal) {
+  if (!requiredFeatures?.length) return [];
+  return requiredFeatures.filter((featureId) => !authorizeFeatures([featureId], {
+    grantedFeatures: principal.features,
+    unrestricted: principal.isSuperAdmin
+  }));
+}
+export {
+  findDiscordEligibleAgent,
+  listDiscordEligibleAgents,
+  missingAgentFeatures
+};
+//# sourceMappingURL=ai-agent-directory.js.map