@mulmobridge/twilio-sms 0.1.1 → 1.0.1

package/README.md

@@ -51,6 +51,24 @@ Text the Twilio number — you'll get a reply.
 | `MULMOCLAUDE_AUTH_TOKEN` | no          | auto    | MulmoClaude bearer token override |
 | `MULMOCLAUDE_API_URL`    | no          | `http://localhost:3001` | MulmoClaude server URL |
 
+### Auth token persistence across server restarts
+
+The MulmoClaude server regenerates a fresh bearer token on every startup and writes it to `~/mulmoclaude/.session-token`. The bridge reads that file once at launch and keeps the token in memory — so if the server restarts while the bridge is running, the bridge keeps using the **old** token and every API call returns **401**, silently.
+
+**Fix**: set `MULMOCLAUDE_AUTH_TOKEN` to the same long random value on **both** the server and the bridge. The server uses it verbatim instead of regenerating, so the token survives restarts and the bridge stays authenticated.
+
+```bash
+# Server (one-time setup — same value across restarts)
+MULMOCLAUDE_AUTH_TOKEN=long-random-string yarn dev
+
+# Bridge (separate process / machine — same value)
+MULMOCLAUDE_AUTH_TOKEN=long-random-string \
+  <bridge-specific-envs> \
+  npx <this-package>@latest
+```
+
+Recommended: at least 32 characters of random data (the server logs a warning at startup for shorter values).
+
 ## How it works
 
 1. Twilio posts form-encoded `From`, `To`, `Body`, `MessageSid` to `/sms` every time an SMS arrives.
@@ -113,3 +131,10 @@ Part of the [`@mulmobridge/*`](https://www.npmjs.com/~mulmobridge) package famil
 - [`@mulmobridge/xmpp`](https://www.npmjs.com/package/@mulmobridge/xmpp) — XMPP / Jabber
 - [`@mulmobridge/zulip`](https://www.npmjs.com/package/@mulmobridge/zulip) — Zulip
 
+## Related projects
+
+Published from the MulmoClaude monorepo by [Receptron](https://github.com/receptron).
+
+- **[MulmoClaude](https://github.com/receptron/mulmoclaude)** — an open-source AI assistant platform that runs on your own computer. Claude Code as the engine, a personal wiki for long-term memory, schema-driven collections for your data, and chat that summons the right GUI (markdown, charts, forms, spreadsheets, wikis) for each task.
+- **[MulmoTerminal](https://github.com/receptron/mulmoterminal)** — a terminal-first cockpit for running many AI coding agents in parallel. One roster showing every session's summary and PR status, tmux-backed session persistence, git-worktree isolation, one-click PRs, and mobile push with remote reply.
+- **[MulmoTerminal manual](https://receptron.github.io/mulmoterminal/)** — setup, workflows, feature reference, configuration, mobile notifications, and alternative / local model providers. Available in English and Japanese.

package/dist/index.js

@@ -27,17 +27,22 @@ import "dotenv/config";
 import crypto from "crypto";
 import express from "express";
 import { createBridgeClient, chunkText } from "@mulmobridge/client";
+import { parseCsvSet } from "@mulmoclaude/common";
 const TRANSPORT_ID = "twilio-sms";
 const MAX_SMS_LEN = 1_600; // Twilio concatenates segments up to 1600 chars
 const FETCH_TIMEOUT_MS = 15_000;
 const PORT = Number(process.env.TWILIO_WEBHOOK_PORT) || 3010;
-const accountSid = process.env.TWILIO_ACCOUNT_SID;
-const authToken = process.env.TWILIO_AUTH_TOKEN;
-const fromNumber = process.env.TWILIO_FROM_NUMBER;
-if (!accountSid || !authToken || !fromNumber) {
-    console.error("TWILIO_ACCOUNT_SID, TWILIO_AUTH_TOKEN, and TWILIO_FROM_NUMBER are required.\n" + "See README for setup instructions.");
-    process.exit(1);
+function readRequiredEnv() {
+    const accountSid = process.env.TWILIO_ACCOUNT_SID;
+    const authToken = process.env.TWILIO_AUTH_TOKEN;
+    const fromNumber = process.env.TWILIO_FROM_NUMBER;
+    if (!accountSid || !authToken || !fromNumber) {
+        console.error("TWILIO_ACCOUNT_SID, TWILIO_AUTH_TOKEN, and TWILIO_FROM_NUMBER are required.\nSee README for setup instructions.");
+        process.exit(1);
+    }
+    return { accountSid, authToken, fromNumber };
 }
+const { accountSid, authToken, fromNumber } = readRequiredEnv();
 const publicUrl = process.env.TWILIO_PUBLIC_URL?.replace(/\/$/, "");
 const allowUnverified = process.env.TWILIO_ALLOW_UNVERIFIED === "1";
 if (!publicUrl && !allowUnverified) {
@@ -49,10 +54,7 @@ if (!publicUrl && !allowUnverified) {
 if (!publicUrl && allowUnverified) {
     console.warn("[twilio-sms] ⚠ TWILIO_ALLOW_UNVERIFIED=1 — signature verification DISABLED. Use only in local testing.");
 }
-const allowedNumbers = new Set((process.env.TWILIO_ALLOWED_NUMBERS ?? "")
-    .split(",")
-    .map((num) => num.trim())
-    .filter(Boolean));
+const allowedNumbers = parseCsvSet(process.env.TWILIO_ALLOWED_NUMBERS);
 const allowAll = allowedNumbers.size === 0;
 const mulmo = createBridgeClient({ transportId: TRANSPORT_ID });
 mulmo.onPush((pushEvent) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mulmobridge/twilio-sms",
-  "version": "0.1.1",
+  "version": "1.0.1",
   "description": "Twilio SMS bridge for MulmoBridge — inbound SMS via webhook, outbound via Twilio REST API",
   "type": "module",
   "main": "./dist/index.js",
@@ -16,19 +16,39 @@
     "build": "tsc",
     "prepack": "yarn build",
     "typecheck": "tsc --noEmit",
-    "test": "echo no tests yet"
+    "test": "echo no tests yet",
+    "lint": "eslint src"
   },
   "license": "MIT",
   "author": "Receptron Team",
   "dependencies": {
-    "@mulmobridge/client": "^0.1.4",
-    "@mulmobridge/protocol": "^0.1.4",
+    "@mulmobridge/client": "^1.0.1",
+    "@mulmobridge/protocol": "^1.0.1",
+    "@mulmoclaude/common": "^1.1.1",
     "dotenv": "^17.0.0",
     "express": "^5.0.0"
   },
   "devDependencies": {
     "@types/express": "^5.0.0",
-    "@types/node": "^25.6.0",
+    "@types/node": "^26.1.1",
     "typescript": "^6.0.3"
+  },
+  "homepage": "https://github.com/receptron/mulmoclaude/tree/main/packages/bridges/twilio-sms#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/receptron/mulmoclaude.git",
+    "directory": "packages/bridges/twilio-sms"
+  },
+  "keywords": [
+    "sms",
+    "twilio",
+    "mulmobridge",
+    "chatbot",
+    "bridge",
+    "ai-agent",
+    "mulmoclaude"
+  ],
+  "bugs": {
+    "url": "https://github.com/receptron/mulmoclaude/issues"
   }
 }