@mulmobridge/discord 0.1.0

package/README.md

@@ -0,0 +1,53 @@
+# @mulmobridge/discord
+
+> **Experimental** — please test and [report issues](https://github.com/receptron/mulmoclaude/issues/new).
+
+Discord bridge for [MulmoClaude](https://github.com/receptron/mulmoclaude). The bot responds to messages in channels it has access to.
+
+## Setup
+
+### 1. Create a Discord Application
+
+1. Go to [discord.com/developers/applications](https://discord.com/developers/applications) → **New Application**
+2. Name it (e.g. "MulmoClaude")
+
+### 2. Create the Bot
+
+1. **Bot** tab → **Add Bot**
+2. Copy the **Token** (this is your `DISCORD_BOT_TOKEN`)
+3. Enable **Message Content Intent** under Privileged Gateway Intents
+
+### 3. Invite the bot to your server
+
+**OAuth2** → **URL Generator**:
+- Scopes: `bot`
+- Permissions: `Send Messages`, `Read Message History`
+
+Copy the generated URL and open it in your browser to invite the bot.
+
+### 4. Run the bridge
+
+```bash
+# With mock server (testing)
+npx @mulmobridge/mock-server &
+DISCORD_BOT_TOKEN=... \
+MULMOCLAUDE_AUTH_TOKEN=mock-test-token \
+npx @mulmobridge/discord
+
+# With real MulmoClaude
+DISCORD_BOT_TOKEN=... \
+npx @mulmobridge/discord
+```
+
+## Environment Variables
+
+| Variable | Required | Description |
+|---|---|---|
+| `DISCORD_BOT_TOKEN` | Yes | Bot token from Developer Portal |
+| `DISCORD_ALLOWED_CHANNELS` | No | CSV of channel IDs to restrict (empty = all) |
+| `MULMOCLAUDE_API_URL` | No | Default `http://localhost:3001` |
+| `MULMOCLAUDE_AUTH_TOKEN` | No | Bearer token (auto-read from workspace) |
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import "dotenv/config";

package/dist/index.js

@@ -0,0 +1,107 @@
+#!/usr/bin/env node
+// @mulmobridge/discord — Discord bridge for MulmoClaude.
+//
+// Required env vars:
+//   DISCORD_BOT_TOKEN      — Bot token from Discord Developer Portal
+//
+// Optional:
+//   DISCORD_ALLOWED_CHANNELS — CSV of channel IDs (empty = allow all)
+//   MULMOCLAUDE_API_URL      — default http://localhost:3001
+//   MULMOCLAUDE_AUTH_TOKEN   — bearer token (or read from workspace)
+import "dotenv/config";
+import { Client, GatewayIntentBits, Partials } from "discord.js";
+import { createBridgeClient } from "@mulmobridge/client";
+const TRANSPORT_ID = "discord";
+const MAX_DISCORD_LENGTH = 2000;
+const token = process.env.DISCORD_BOT_TOKEN;
+if (!token) {
+    console.error("DISCORD_BOT_TOKEN is required.\nSee README for setup instructions.");
+    process.exit(1);
+}
+const allowedChannels = new Set((process.env.DISCORD_ALLOWED_CHANNELS ?? "")
+    .split(",")
+    .map((s) => s.trim())
+    .filter(Boolean));
+const allowAll = allowedChannels.size === 0;
+const discord = new Client({
+    intents: [
+        GatewayIntentBits.Guilds,
+        GatewayIntentBits.GuildMessages,
+        GatewayIntentBits.DirectMessages,
+        GatewayIntentBits.MessageContent,
+    ],
+    // Partials.Channel is required to receive DM messageCreate events —
+    // DM channels are not cached by default in discord.js v14.
+    partials: [Partials.Channel],
+});
+const mulmo = createBridgeClient({ transportId: TRANSPORT_ID });
+mulmo.onPush(async (ev) => {
+    try {
+        const channel = discord.channels.cache.get(ev.chatId) ??
+            (await discord.channels.fetch(ev.chatId).catch(() => null));
+        if (channel?.isTextBased() && "send" in channel) {
+            const sendable = channel;
+            await sendChunkedToSendable(sendable, ev.message);
+        }
+        else {
+            console.warn(`[discord] push: channel ${ev.chatId} not found or not text-based`);
+        }
+    }
+    catch (err) {
+        console.error(`[discord] push send failed: ${err}`);
+    }
+});
+discord.on("messageCreate", async (msg) => {
+    if (msg.author.bot)
+        return;
+    const channelId = msg.channelId;
+    const text = msg.content.trim();
+    if (!text)
+        return;
+    if (!allowAll && !allowedChannels.has(channelId))
+        return;
+    console.log(`[discord] message channel=${channelId} user=${msg.author.tag} len=${text.length}`);
+    try {
+        const ack = await mulmo.send(channelId, text);
+        if (ack.ok) {
+            await sendChunked(msg, ack.reply ?? "");
+        }
+        else {
+            const status = ack.status ? ` (${ack.status})` : "";
+            await msg.reply(`Error${status}: ${ack.error ?? "unknown"}`);
+        }
+    }
+    catch (err) {
+        console.error(`[discord] message handling failed: ${err}`);
+    }
+});
+async function sendChunked(msg, text) {
+    if (text.length === 0) {
+        await msg.reply("(empty reply)");
+        return;
+    }
+    for (let i = 0; i < text.length; i += MAX_DISCORD_LENGTH) {
+        const chunk = text.slice(i, i + MAX_DISCORD_LENGTH);
+        if (i === 0) {
+            await msg.reply(chunk);
+        }
+        else if ("send" in msg.channel) {
+            await msg.channel.send(chunk);
+        }
+    }
+}
+async function sendChunkedToSendable(channel, text) {
+    const content = text.length === 0 ? "(empty reply)" : text;
+    for (let i = 0; i < content.length; i += MAX_DISCORD_LENGTH) {
+        await channel.send(content.slice(i, i + MAX_DISCORD_LENGTH));
+    }
+}
+discord.once("ready", () => {
+    console.log("MulmoClaude Discord bridge");
+    console.log(`Logged in as ${discord.user?.tag}`);
+    console.log(`Channels: ${allowAll ? "(all)" : [...allowedChannels].join(", ")}`);
+});
+discord.login(token).catch((err) => {
+    console.error("Fatal:", err);
+    process.exit(1);
+});

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@mulmobridge/discord",
+  "version": "0.1.0",
+  "description": "Discord bridge for MulmoBridge — connect a Discord bot to MulmoClaude",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "mulmobridge-discord": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepack": "yarn build",
+    "typecheck": "tsc --noEmit",
+    "test": "echo no tests yet"
+  },
+  "license": "MIT",
+  "author": "Receptron Team",
+  "dependencies": {
+    "@mulmobridge/client": "^0.1.0",
+    "@mulmobridge/protocol": "^0.1.0",
+    "discord.js": "^14.26.3",
+    "dotenv": "^17.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.6.0",
+    "typescript": "^6.0.3"
+  }
+}