@mulmobridge/line 0.1.0

package/README.md

@@ -0,0 +1,66 @@
+# @mulmobridge/line
+
+> **Experimental** — please test and [report issues](https://github.com/receptron/mulmoclaude/issues/new).
+
+LINE bridge for [MulmoClaude](https://github.com/receptron/mulmoclaude). Uses webhook events — requires a public URL (ngrok for development).
+
+## Setup
+
+### 1. Create a LINE Messaging API Channel
+
+1. Go to [LINE Developers Console](https://developers.line.biz/console/) → create a Provider → create a **Messaging API** channel
+2. Note the **Channel secret** (Basic settings tab)
+3. Issue a **Channel access token** (Messaging API tab → long-lived)
+
+### 2. Set up ngrok (for development)
+
+```bash
+ngrok http 3002
+# Copy the https://xxxx.ngrok-free.app URL
+```
+
+### 3. Configure the webhook
+
+In the LINE Developers Console → Messaging API tab:
+- **Webhook URL**: `https://xxxx.ngrok-free.app/webhook`
+- **Use webhook**: enabled
+- **Auto-reply messages**: disabled (so LINE's default replies don't interfere)
+
+### 4. Run the bridge
+
+```bash
+# With mock server (testing)
+npx @mulmobridge/mock-server &
+LINE_CHANNEL_SECRET=... \
+LINE_CHANNEL_ACCESS_TOKEN=... \
+MULMOCLAUDE_AUTH_TOKEN=mock-test-token \
+npx @mulmobridge/line
+
+# With real MulmoClaude
+LINE_CHANNEL_SECRET=... \
+LINE_CHANNEL_ACCESS_TOKEN=... \
+npx @mulmobridge/line
+```
+
+### 5. Add the bot as a friend
+
+Scan the QR code in the LINE Developers Console → Messaging API tab. Send a message — MulmoClaude replies.
+
+## Environment Variables
+
+| Variable | Required | Description |
+|---|---|---|
+| `LINE_CHANNEL_SECRET` | Yes | Channel secret for signature verification |
+| `LINE_CHANNEL_ACCESS_TOKEN` | Yes | Long-lived channel access token |
+| `LINE_BRIDGE_PORT` | No | Webhook port (default: 3002) |
+| `MULMOCLAUDE_API_URL` | No | Default `http://localhost:3001` |
+| `MULMOCLAUDE_AUTH_TOKEN` | No | Bearer token |
+
+## Notes
+
+- LINE reply tokens expire in **1 minute**. Since Claude responses can take longer, the bridge uses **push messages** instead of reply messages. This requires your bot to be a verified/certified account for push to work with all users, OR the user must have added the bot as a friend first.
+- LINE limits messages to 5 per push call and ~5000 chars per message. Long replies are automatically chunked.
+
+## 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,126 @@
+#!/usr/bin/env node
+// @mulmobridge/line — LINE bridge for MulmoClaude.
+//
+// Runs a small HTTP server to receive LINE webhook events.
+// Requires a public URL (use ngrok for development).
+//
+// Required env vars:
+//   LINE_CHANNEL_SECRET      — Channel secret from LINE Developers Console
+//   LINE_CHANNEL_ACCESS_TOKEN — Channel access token (long-lived)
+//
+// Optional:
+//   LINE_BRIDGE_PORT          — Webhook listener port (default: 3002)
+//   MULMOCLAUDE_API_URL       — default http://localhost:3001
+//   MULMOCLAUDE_AUTH_TOKEN    — bearer token
+import "dotenv/config";
+import crypto from "crypto";
+import express from "express";
+import { createBridgeClient } from "@mulmobridge/client";
+const TRANSPORT_ID = "line";
+const PORT = Number(process.env.LINE_BRIDGE_PORT) || 3002;
+const channelSecret = process.env.LINE_CHANNEL_SECRET;
+const channelAccessToken = process.env.LINE_CHANNEL_ACCESS_TOKEN;
+if (!channelSecret || !channelAccessToken) {
+    console.error("LINE_CHANNEL_SECRET and LINE_CHANNEL_ACCESS_TOKEN are required.\n" +
+        "See README for setup instructions.");
+    process.exit(1);
+}
+const client = createBridgeClient({ transportId: TRANSPORT_ID });
+client.onPush((ev) => {
+    pushMessage(ev.chatId, ev.message).catch((err) => console.error(`[line] push send failed: ${err}`));
+});
+// ── LINE API helpers ────────────────────────────────────────────
+async function pushMessage(userId, text) {
+    const messages = chunkText(text).map((t) => ({ type: "text", text: t }));
+    // LINE allows max 5 messages per push
+    for (let i = 0; i < messages.length; i += 5) {
+        try {
+            const res = await fetch("https://api.line.me/v2/bot/message/push", {
+                method: "POST",
+                headers: {
+                    "Content-Type": "application/json",
+                    Authorization: `Bearer ${channelAccessToken}`,
+                },
+                body: JSON.stringify({
+                    to: userId,
+                    messages: messages.slice(i, i + 5),
+                }),
+                signal: AbortSignal.timeout(30_000),
+            });
+            if (!res.ok) {
+                const body = await res.text().catch(() => "");
+                console.error(`[line] pushMessage failed: ${res.status} ${body.slice(0, 200)}`);
+            }
+        }
+        catch (err) {
+            console.error(`[line] pushMessage network error: ${err}`);
+        }
+    }
+}
+function chunkText(text, max = 5000) {
+    if (text.length === 0)
+        return ["(empty reply)"];
+    const chunks = [];
+    for (let i = 0; i < text.length; i += max) {
+        chunks.push(text.slice(i, i + max));
+    }
+    return chunks;
+}
+// ── Signature verification ──────────────────────────────────────
+function verifySignature(body, signature) {
+    const expected = crypto
+        .createHmac("SHA256", channelSecret)
+        .update(body)
+        .digest("base64");
+    if (expected.length !== signature.length)
+        return false;
+    return crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(signature));
+}
+// ── Webhook server ──────────────────────────────────────────────
+const app = express();
+app.disable("x-powered-by");
+app.use(express.text({ type: "application/json" }));
+app.post("/webhook", async (req, res) => {
+    const signature = req.headers["x-line-signature"];
+    const bodyStr = req.body;
+    if (!signature || !verifySignature(bodyStr, signature)) {
+        res.status(401).send("Invalid signature");
+        return;
+    }
+    res.status(200).send("OK");
+    let body;
+    try {
+        body = JSON.parse(bodyStr);
+    }
+    catch {
+        console.error("[line] malformed JSON in webhook body");
+        return;
+    }
+    for (const event of body.events) {
+        if (event.type !== "message" || event.message?.type !== "text")
+            continue;
+        const userId = event.source?.userId;
+        const text = event.message?.text ?? "";
+        if (!userId || !text.trim())
+            continue;
+        console.log(`[line] message user=${userId} len=${text.length}`);
+        try {
+            const ack = await client.send(userId, text);
+            if (ack.ok) {
+                await pushMessage(userId, ack.reply ?? "");
+            }
+            else {
+                const status = ack.status ? ` (${ack.status})` : "";
+                await pushMessage(userId, `Error${status}: ${ack.error ?? "unknown"}`);
+            }
+        }
+        catch (err) {
+            console.error(`[line] message handling failed: ${err}`);
+        }
+    }
+});
+app.listen(PORT, () => {
+    console.log("MulmoClaude LINE bridge");
+    console.log(`Webhook listening on http://localhost:${PORT}/webhook`);
+    console.log("Set your LINE webhook URL to: <public-url>/webhook");
+});

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@mulmobridge/line",
+  "version": "0.1.0",
+  "description": "LINE bridge for MulmoBridge — connect a LINE bot to MulmoClaude",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "mulmobridge-line": "./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",
+    "dotenv": "^17.0.0",
+    "express": "^5.1.0"
+  },
+  "devDependencies": {
+    "@types/express": "^5.0.0",
+    "@types/node": "^25.6.0",
+    "typescript": "^6.0.3"
+  }
+}