@codeam/shared 2.61.42 → 2.61.44

package/dist/index.d.mts

@@ -351,7 +351,7 @@ declare function isHeadroomWrappable(agentId: string): boolean;
  * ubiquitous CLI for the tool → `cliEnv`; otherwise → `mcp`. A tool may
  * declare both.
  */
-type IntegrationId = 'jira' | 'sentry' | 'linear' | 'slack' | 'notion' | 'azure_devops' | 'figma' | 'microsoft_teams' | 'google_chat' | 'discord' | 'github_issues' | 'github' | 'gitlab';
+type IntegrationId = 'jira' | 'sentry' | 'linear' | 'slack' | 'notion' | 'azure_devops' | 'figma' | 'microsoft_teams' | 'google_chat' | 'discord' | 'resend' | 'github_issues' | 'github' | 'gitlab';
 /**
  * `derived` = no link flow of its own: the credential is BORROWED live from a
  * connection the user already made elsewhere (see `derivedFrom`). The backend
@@ -421,6 +421,12 @@ interface IntegrationDefinition {
     icon: string;
     category: IntegrationCategory;
     enabled: boolean;
+    /** A `comms` integration that only SENDS (e.g. Resend email) — it has no
+     *  readable threads, so it is EXCLUDED from From-Conversation's source list
+     *  (which needs `listRecentThreads`/`getThread`/`postReply`) while still being
+     *  a linkable comms tool the agent uses via its MCP delivery. Absent/false for
+     *  conversational comms (Slack, Discord). */
+    sendOnly?: boolean;
     auth: {
         kind: IntegrationAuthKind;
         scopes?: string[];
@@ -472,6 +478,12 @@ interface BrokeredIntegrationToken {
      *  MCP server needs it alongside the PAT (`AZURE_DEVOPS_ORG_URL`). Absent for
      *  non-ADO integrations. */
     orgUrl?: string;
+    /** Discord guild (server) id the app's bot was invited into for this user —
+     *  the `mcp-discord` server scopes to it (`DISCORD_GUILD_ID`). ⚠️ Discord OAuth
+     *  gives NO per-install token (unlike Slack): `accessToken` here is the app's
+     *  single BOT token, injected by the broker from config — the per-user
+     *  credential IS the guildId. Absent for non-Discord integrations. */
+    guildId?: string;
 }
 
 /**
@@ -519,7 +531,7 @@ interface IntegrationBranding {
     logoSvg: string;
 }
 declare const INTEGRATION_BRANDING: Record<string, IntegrationBranding>;
-declare const UPCOMING_INTEGRATION_IDS: readonly ["gmail", "posthog", "clickup", "figma", "trello", "resend", "vercel", "supabase", "asana", "postman", "n8n", "stripe", "mixpanel", "pendo", "pagerduty", "amplitude", "datadog"];
+declare const UPCOMING_INTEGRATION_IDS: readonly ["gmail", "posthog", "clickup", "figma", "trello", "vercel", "supabase", "asana", "postman", "n8n", "stripe", "mixpanel", "pendo", "pagerduty", "amplitude", "datadog"];
 declare function getIntegrationBranding(id: string): IntegrationBranding | null;
 
 /**

package/dist/index.d.ts

@@ -351,7 +351,7 @@ declare function isHeadroomWrappable(agentId: string): boolean;
  * ubiquitous CLI for the tool → `cliEnv`; otherwise → `mcp`. A tool may
  * declare both.
  */
-type IntegrationId = 'jira' | 'sentry' | 'linear' | 'slack' | 'notion' | 'azure_devops' | 'figma' | 'microsoft_teams' | 'google_chat' | 'discord' | 'github_issues' | 'github' | 'gitlab';
+type IntegrationId = 'jira' | 'sentry' | 'linear' | 'slack' | 'notion' | 'azure_devops' | 'figma' | 'microsoft_teams' | 'google_chat' | 'discord' | 'resend' | 'github_issues' | 'github' | 'gitlab';
 /**
  * `derived` = no link flow of its own: the credential is BORROWED live from a
  * connection the user already made elsewhere (see `derivedFrom`). The backend
@@ -421,6 +421,12 @@ interface IntegrationDefinition {
     icon: string;
     category: IntegrationCategory;
     enabled: boolean;
+    /** A `comms` integration that only SENDS (e.g. Resend email) — it has no
+     *  readable threads, so it is EXCLUDED from From-Conversation's source list
+     *  (which needs `listRecentThreads`/`getThread`/`postReply`) while still being
+     *  a linkable comms tool the agent uses via its MCP delivery. Absent/false for
+     *  conversational comms (Slack, Discord). */
+    sendOnly?: boolean;
     auth: {
         kind: IntegrationAuthKind;
         scopes?: string[];
@@ -472,6 +478,12 @@ interface BrokeredIntegrationToken {
      *  MCP server needs it alongside the PAT (`AZURE_DEVOPS_ORG_URL`). Absent for
      *  non-ADO integrations. */
     orgUrl?: string;
+    /** Discord guild (server) id the app's bot was invited into for this user —
+     *  the `mcp-discord` server scopes to it (`DISCORD_GUILD_ID`). ⚠️ Discord OAuth
+     *  gives NO per-install token (unlike Slack): `accessToken` here is the app's
+     *  single BOT token, injected by the broker from config — the per-user
+     *  credential IS the guildId. Absent for non-Discord integrations. */
+    guildId?: string;
 }
 
 /**
@@ -519,7 +531,7 @@ interface IntegrationBranding {
     logoSvg: string;
 }
 declare const INTEGRATION_BRANDING: Record<string, IntegrationBranding>;
-declare const UPCOMING_INTEGRATION_IDS: readonly ["gmail", "posthog", "clickup", "figma", "trello", "resend", "vercel", "supabase", "asana", "postman", "n8n", "stripe", "mixpanel", "pendo", "pagerduty", "amplitude", "datadog"];
+declare const UPCOMING_INTEGRATION_IDS: readonly ["gmail", "posthog", "clickup", "figma", "trello", "vercel", "supabase", "asana", "postman", "n8n", "stripe", "mixpanel", "pendo", "pagerduty", "amplitude", "datadog"];
 declare function getIntegrationBranding(id: string): IntegrationBranding | null;
 
 /**

package/dist/index.js

@@ -835,12 +835,79 @@ var INTEGRATION_REGISTRY = {
     name: "Discord",
     icon: "discord",
     category: "comms",
-    // COMING SOON — placeholder catalog entry (no OAuth provider / MCP yet). The
-    // agent will post review pings + read channels over the Discord API once the
-    // provider lands. `enabled:false` → dimmed "coming soon" tile.
-    enabled: false,
-    auth: { kind: "oauth_redirect" },
-    delivery: {}
+    // LIVE — the DiscordOAuthProvider + DISCORD_* secrets (client id/secret,
+    // bot token, per-env redirect) are registered; the backend provider is
+    // config-gated (503 if env unset). Follows the SLACK pattern (OAuth redirect, zero friction),
+    // EXCEPT Discord OAuth gives no per-install token: the user's `bot`-scope
+    // authorize INVITES the app's single bot into their guild, and we store the
+    // returned guild id as the per-user credential. The broker injects the app's
+    // BOT token as `accessToken` (from config), so `DISCORD_TOKEN` = that bot
+    // token and `DISCORD_GUILD_ID` = the user's guild.
+    enabled: true,
+    auth: {
+      kind: "oauth_redirect",
+      // `bot` invites the app's bot into the user's guild (Guild Install);
+      // `guilds` lets the exchange read the guild name for display. The bot's
+      // channel permissions (View Channels + Read Message History + Send
+      // Messages + Send Messages in Threads) are set on the app's bot, NOT here.
+      // ⚠️ The app's bot MUST have the Message Content privileged intent enabled
+      // or read_messages returns empty content.
+      scopes: ["bot", "guilds"]
+    },
+    delivery: {
+      mcp: {
+        // mcp-discord (barryyip0625) — Node stdio, BYO bot token headless via the
+        // DISCORD_TOKEN env (never argv). Version PINNED; bump only after
+        // re-verifying headless. Tools: list/read channels + messages, send
+        // message, reply in thread, add reaction. `DISCORD_GUILD_ID` scopes it to
+        // the user's invited guild.
+        command: "npx",
+        args: ["-y", "mcp-discord@1.3.4"],
+        envMapping: {
+          DISCORD_TOKEN: "accessToken",
+          DISCORD_GUILD_ID: "guildId"
+        }
+      }
+    }
+  },
+  resend: {
+    id: "resend",
+    name: "Resend",
+    icon: "resend",
+    category: "comms",
+    // LIVE — api_key (like Azure DevOps): the user pastes a Resend API key
+    // (`re_…`); Resend has NO OAuth, so there's no OAuth app / GSM secret /
+    // config-gated 503 — a backend VALIDATOR proves the key against the Resend
+    // API and vaults it. ⚠️ SEND-ONLY email → `sendOnly: true` keeps it OUT of
+    // From-Conversation (comms conversation sources need readable threads; Resend
+    // has none) while still being a linkable comms tool the agent uses via MCP.
+    enabled: true,
+    sendOnly: true,
+    auth: {
+      kind: "api_key",
+      fields: [
+        {
+          key: "accessToken",
+          label: "API Key",
+          placeholder: "re_xxxxxxxxxxxxxxxx",
+          secret: true,
+          help: 'Create in Resend \u2192 API Keys (https://resend.com/api-keys). "Sending access" is enough.'
+        }
+      ]
+    },
+    delivery: {
+      mcp: {
+        // The OFFICIAL resend-mcp (Node) in BYO-token mode: the API key is fed
+        // via RESEND_API_KEY (env only, never argv). Version PINNED; bump only
+        // after re-verifying headless. Tools: send email + contacts/broadcasts/
+        // domains.
+        command: "npx",
+        args: ["-y", "resend-mcp@2.6.1"],
+        envMapping: {
+          RESEND_API_KEY: "accessToken"
+        }
+      }
+    }
   },
   notion: {
     id: "notion",
@@ -1250,7 +1317,6 @@ var UPCOMING_INTEGRATION_IDS = [
   "clickup",
   "figma",
   "trello",
-  "resend",
   "vercel",
   "supabase",
   "asana",