feat(trogon-source-discord): add Discord interaction webhook receiver

Signed-off-by: Yordis Prieto <yordis.prieto@gmail.com>

Author: yordis

devops/docker/compose/compose.yml

@@ -67,6 +67,31 @@ services:
       start_period: 10s
       retries: 3
 
+  trogon-source-discord:
+    build:
+      context: ../../../rsworkspace
+      dockerfile: ../devops/docker/compose/services/trogon-source-discord/Dockerfile
+    environment:
+      NATS_URL: "nats:4222"
+      DISCORD_PUBLIC_KEY: "${DISCORD_PUBLIC_KEY:-}"
+      DISCORD_WEBHOOK_PORT: "${DISCORD_WEBHOOK_PORT:-8080}"
+      DISCORD_SUBJECT_PREFIX: "${DISCORD_SUBJECT_PREFIX:-discord}"
+      DISCORD_STREAM_NAME: "${DISCORD_STREAM_NAME:-DISCORD}"
+      DISCORD_STREAM_MAX_AGE_SECS: "${DISCORD_STREAM_MAX_AGE_SECS:-604800}"
+      DISCORD_NATS_ACK_TIMEOUT_SECS: "${DISCORD_NATS_ACK_TIMEOUT_SECS:-10}"
+      DISCORD_MAX_BODY_SIZE: "${DISCORD_MAX_BODY_SIZE:-4194304}"
+      RUST_LOG: "${RUST_LOG:-info}"
+    depends_on:
+      nats:
+        condition: service_healthy
+    restart: unless-stopped
+    healthcheck:
+      test: ["CMD", "curl", "-sf", "http://localhost:${DISCORD_WEBHOOK_PORT:-8080}/health"]
+      interval: 10s
+      timeout: 3s
+      start_period: 10s
+      retries: 3
+
   trogon-source-slack:
     build:
       context: ../../../rsworkspace
@@ -97,6 +122,7 @@ services:
     image: ngrok/ngrok:alpine
     environment:
       NGROK_AUTHTOKEN: "${NGROK_AUTHTOKEN:-}"
+      DISCORD_ADDR: "trogon-source-discord:${DISCORD_WEBHOOK_PORT:-8080}"
       GITHUB_ADDR: "trogon-source-github:${GITHUB_WEBHOOK_PORT:-8080}"
       LINEAR_ADDR: "trogon-source-linear:${LINEAR_WEBHOOK_PORT:-8080}"
       SLACK_ADDR: "trogon-source-slack:${SLACK_WEBHOOK_PORT:-3000}"
@@ -107,6 +133,9 @@ services:
         cat > /tmp/ngrok.yml <<EOF
         version: 3
         tunnels:
+          discord:
+            addr: $${DISCORD_ADDR}
+            proto: http
           github:
             addr: $${GITHUB_ADDR}
             proto: http
@@ -119,6 +148,8 @@ services:
         EOF
         exec ngrok start --all --config /tmp/ngrok.yml
     depends_on:
+      trogon-source-discord:
+        condition: service_healthy
       trogon-source-github:
         condition: service_healthy
       trogon-source-linear:

devops/docker/compose/services/trogon-source-discord/Dockerfile

@@ -0,0 +1,45 @@
+# ── Stage 1: chef — generate dependency recipe ──────────────────────────────
+FROM rust:1.93-slim AS chef
+
+RUN cargo install cargo-chef --locked
+
+WORKDIR /build
+
+# ── Stage 2: planner — capture dependency graph ─────────────────────────────
+FROM chef AS planner
+
+COPY Cargo.toml Cargo.lock ./
+COPY crates/ crates/
+
+RUN cargo chef prepare --recipe-path recipe.json
+
+# ── Stage 3: builder — cached dependency build + final compile ──────────────
+FROM chef AS builder
+
+COPY --from=planner /build/recipe.json recipe.json
+RUN cargo chef cook --release --recipe-path recipe.json -p trogon-source-discord
+
+COPY Cargo.toml Cargo.lock ./
+COPY crates/ crates/
+
+RUN cargo build --release -p trogon-source-discord && \
+    strip target/release/trogon-source-discord
+
+# ── Stage 4: runtime ────────────────────────────────────────────────────────
+FROM debian:bookworm-20250317-slim AS runtime
+
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    ca-certificates curl \
+    && rm -rf /var/lib/apt/lists/*
+
+RUN useradd --no-create-home --shell /usr/sbin/nologin trogon
+
+COPY --from=builder /build/target/release/trogon-source-discord /usr/local/bin/trogon-source-discord
+
+USER trogon
+
+EXPOSE 8080
+
+STOPSIGNAL SIGTERM
+
+ENTRYPOINT ["/usr/local/bin/trogon-source-discord"]

devops/docker/compose/services/trogon-source-discord/README.md

@@ -0,0 +1,61 @@
+# Receiving Discord Interactions Locally
+
+## Prerequisites
+
+- Docker Compose
+- A [Discord Application](https://discord.com/developers/applications) with an
+  Interactions Endpoint configured
+- An [ngrok](https://ngrok.com) account (free tier works)
+
+## 1. Get your public key
+
+1. Go to **Discord Developer Portal → Applications → your app → General Information**
+2. Copy the **Public Key** (hex string)
+
+## 2. Start the stack
+
+```bash
+DISCORD_PUBLIC_KEY=<your-hex-public-key> docker compose --profile dev up
+```
+
+This starts NATS, the webhook receiver, and ngrok. Find the public tunnel URL
+in the ngrok container logs:
+
+```bash
+docker compose logs ngrok
+```
+
+Look for the `discord` tunnel URL (e.g. `https://abc123.ngrok-free.app`).
+
+## 3. Configure your Discord Application
+
+1. Go to **Discord Developer Portal → Applications → your app → General Information**
+2. Set **Interactions Endpoint URL** to `https://<ngrok-url>/webhook`
+3. Discord will send a PING to verify the endpoint — the receiver handles this
+   automatically
+
+## 4. Verify
+
+Create a slash command or trigger an interaction. You should see:
+
+- The webhook receiver log the incoming interaction
+- The interaction published to NATS on `discord.{interaction_type}`
+
+You can inspect NATS with:
+
+```bash
+nats sub -s nats://nats.trogonai.orb.local:4222 "discord.>"
+```
+
+Without `--profile dev`, ngrok is excluded and only the core services start.
+
+## Environment variables
+
+| Variable | Required | Default | Description |
+|---|---|---|---|
+| `DISCORD_PUBLIC_KEY` | yes | — | Ed25519 public key (hex) from Discord app settings |
+| `NGROK_AUTHTOKEN` | yes (dev profile) | — | ngrok auth token |
+| `DISCORD_WEBHOOK_PORT` | no | `8080` | HTTP port for the webhook receiver |
+| `DISCORD_SUBJECT_PREFIX` | no | `discord` | NATS subject prefix |
+| `DISCORD_STREAM_NAME` | no | `DISCORD` | JetStream stream name |
+| `RUST_LOG` | no | `info` | Log level |

rsworkspace/Cargo.lock

@@ -5,6 +5,7 @@
 pub enum ServiceName {
     AcpNatsStdio,
     AcpNatsWs,
+    TrogonSourceDiscord,
     TrogonSourceGithub,
     TrogonSourceLinear,
     TrogonSourceSlack,
@@ -15,6 +16,7 @@ impl ServiceName {
         match self {
             Self::AcpNatsStdio => "acp-nats-stdio",
             Self::AcpNatsWs => "acp-nats-ws",
+            Self::TrogonSourceDiscord => "trogon-source-discord",
             Self::TrogonSourceGithub => "trogon-source-github",
             Self::TrogonSourceLinear => "trogon-source-linear",
             Self::TrogonSourceSlack => "trogon-source-slack",
@@ -36,6 +38,10 @@ mod tests {
     fn as_str_returns_expected_values() {
         assert_eq!(ServiceName::AcpNatsStdio.as_str(), "acp-nats-stdio");
         assert_eq!(ServiceName::AcpNatsWs.as_str(), "acp-nats-ws");
+        assert_eq!(
+            ServiceName::TrogonSourceDiscord.as_str(),
+            "trogon-source-discord"
+        );
         assert_eq!(
             ServiceName::TrogonSourceGithub.as_str(),
             "trogon-source-github"
@@ -54,6 +60,10 @@ mod tests {
     fn display_delegates_to_as_str() {
         assert_eq!(format!("{}", ServiceName::AcpNatsStdio), "acp-nats-stdio");
         assert_eq!(format!("{}", ServiceName::AcpNatsWs), "acp-nats-ws");
+        assert_eq!(
+            format!("{}", ServiceName::TrogonSourceDiscord),
+            "trogon-source-discord"
+        );
         assert_eq!(
             format!("{}", ServiceName::TrogonSourceGithub),
             "trogon-source-github"

rsworkspace/crates/acp-telemetry/src/service_name.rs

@@ -0,0 +1,33 @@
+[package]
+name = "trogon-source-discord"
+version = "0.1.0"
+edition = "2024"
+
+[lints]
+workspace = true
+
+[[bin]]
+name = "trogon-source-discord"
+path = "src/main.rs"
+
+[dependencies]
+acp-telemetry = { workspace = true }
+async-nats = { workspace = true, features = ["jetstream"] }
+axum = { workspace = true }
+bytes = { workspace = true }
+bytesize = "2.3.1"
+ed25519-dalek = { version = "2.1", features = ["std"] }
+hex = "0.4"
+serde_json = { workspace = true }
+tokio = { workspace = true, features = ["full"] }
+tower-http = { workspace = true, features = ["limit"] }
+tracing = { workspace = true }
+trogon-nats = { workspace = true }
+trogon-std = { workspace = true }
+
+[dev-dependencies]
+tokio = { workspace = true, features = ["macros", "rt-multi-thread"] }
+tower = "0.5"
+tracing-subscriber = { workspace = true }
+trogon-nats = { workspace = true, features = ["test-support"] }
+trogon-std = { workspace = true, features = ["test-support"] }