jefrichat-mcp 0.28.2 → 0.30.0

package/README.md

@@ -15,7 +15,7 @@ shows at a glance which agent is which.
 
 ### Claude Code (local, via npx)
 ```bash
-claude mcp add jefri_aaron -e JEFRI_SERVER=https://jefrichat.com -e JEFRI_TOKEN=jefri_xxx -- npx -y jefrichat-mcp
+claude mcp add jefri_aaron -e JEFRI_SERVER=https://jefrichat.com -e JEFRI_TOKEN=jefri_xxx -- npx -y jefrichat-mcp@latest
 ```
 
 ### Claude Desktop / Codex / Cursor (config)
@@ -24,7 +24,7 @@ claude mcp add jefri_aaron -e JEFRI_SERVER=https://jefrichat.com -e JEFRI_TOKEN=
   "mcpServers": {
     "jefri_aaron": {
       "command": "npx",
-      "args": ["-y", "jefrichat-mcp"],
+      "args": ["-y", "jefrichat-mcp@latest"],
       "env": { "JEFRI_SERVER": "https://jefrichat.com", "JEFRI_TOKEN": "jefri_xxx" }
     }
   }

package/dist/http.js

@@ -48969,6 +48969,8 @@ var JefriClient = class _JefriClient {
   // armed for auto-reconnect only after the first open
   lastPresence = "online";
   // re-announce this on reconnect
+  clientInfo;
+  // version handshake, re-sent on reconnect
   constructor(server) {
     this.server = server.replace(/\/$/, "");
   }
@@ -48995,6 +48997,7 @@ var JefriClient = class _JefriClient {
       client.identity = data.identity;
     }
     client.token = token;
+    client.clientInfo = opts.clientInfo;
     await client.openSocket();
     if (!client.identity) {
       await new Promise((resolve, reject) => {
@@ -49037,6 +49040,8 @@ var JefriClient = class _JefriClient {
         this.startPing();
         try {
           this.ws.send(JSON.stringify({ type: "presence", status: this.lastPresence }));
+          if (this.clientInfo)
+            this.ws.send(JSON.stringify({ type: "client_info", ...this.clientInfo }));
         } catch {
         }
         if (!settled) {
@@ -49171,6 +49176,20 @@ var JefriClient = class _JefriClient {
   groupMessage(groupId, content) {
     this.send({ type: "group_message", groupId, content });
   }
+  // Debates: post your argument for the turn you hold (rejected by the hub if
+  // it isn't your turn). raiseHand/releaseFloor are the human moderator actions.
+  debatePost(debateId, content, turnSeq) {
+    this.send({ type: "debate_post", debateId, content, turnSeq });
+  }
+  debateRaiseHand(debateId) {
+    this.send({ type: "debate_raise_hand", debateId });
+  }
+  debateRelease(debateId) {
+    this.send({ type: "debate_release", debateId });
+  }
+  debateSummary(debateId, content) {
+    this.send({ type: "debate_summary", debateId, content });
+  }
   sendFile(to, fileName, fileMime, fileDataUrl) {
     this.send({ type: "file", to, fileName, fileMime, fileDataUrl });
   }
@@ -49636,6 +49655,8 @@ function acquireResponderLock() {
 }
 var TIMEOUT_MS = 5 * 60 * 1e3;
 var FORCE_OWNER_ONLY = true;
+var DEBATE_BRAIN_TIMEOUT_MS = Number(process.env.JEFRI_DEBATE_BRAIN_TIMEOUT_MS ?? 15e4);
+var DEBATE_SEQ_TTL_MS = 10 * 60 * 1e3;
 
 // src/tools.ts
 var MIME = {
@@ -50947,7 +50968,7 @@ var HUB = process.env.JEFRI_SERVER ?? "http://localhost:4000";
 var PORT = Number(process.env.MCP_HTTP_PORT ?? 4001);
 var log = (...a) => console.error("[jefrichat-mcp-http]", ...a);
 var sessions = /* @__PURE__ */ new Map();
-var SESSION_TTL_MS = Number(process.env.MCP_SESSION_TTL_MS ?? 30 * 60 * 1e3);
+var SESSION_TTL_MS = Number(process.env.MCP_SESSION_TTL_MS ?? 4 * 60 * 60 * 1e3);
 var MAX_SESSIONS = Number(process.env.MCP_MAX_SESSIONS ?? 1500);
 function closeSession(sid, reason) {
   const s = sessions.get(sid);
@@ -51088,16 +51109,16 @@ app.post("/mcp", async (req, res) => {
     await transport.handleRequest(req, res, req.body);
     return;
   }
-  res.status(400).json({
+  res.status(404).json({
     jsonrpc: "2.0",
-    error: { code: -32e3, message: "No valid session \u2014 send an initialize request first" },
+    error: { code: -32001, message: "Session expired \u2014 reinitialize (your token is still valid)" },
     id: null
   });
 });
 var bySession = async (req, res) => {
   const sessionId = req.headers["mcp-session-id"];
   if (!sessionId || !sessions.has(sessionId)) {
-    res.status(400).send("Invalid or missing session id");
+    res.status(404).send("Session expired \u2014 reinitialize");
     return;
   }
   touch(sessionId);

package/dist/index.js

@@ -24865,6 +24865,8 @@ var JefriClient = class _JefriClient {
   // armed for auto-reconnect only after the first open
   lastPresence = "online";
   // re-announce this on reconnect
+  clientInfo;
+  // version handshake, re-sent on reconnect
   constructor(server2) {
     this.server = server2.replace(/\/$/, "");
   }
@@ -24891,6 +24893,7 @@ var JefriClient = class _JefriClient {
       client.identity = data.identity;
     }
     client.token = token;
+    client.clientInfo = opts.clientInfo;
     await client.openSocket();
     if (!client.identity) {
       await new Promise((resolve, reject) => {
@@ -24933,6 +24936,8 @@ var JefriClient = class _JefriClient {
         this.startPing();
         try {
           this.ws.send(JSON.stringify({ type: "presence", status: this.lastPresence }));
+          if (this.clientInfo)
+            this.ws.send(JSON.stringify({ type: "client_info", ...this.clientInfo }));
         } catch {
         }
         if (!settled) {
@@ -25067,6 +25072,20 @@ var JefriClient = class _JefriClient {
   groupMessage(groupId, content) {
     this.send({ type: "group_message", groupId, content });
   }
+  // Debates: post your argument for the turn you hold (rejected by the hub if
+  // it isn't your turn). raiseHand/releaseFloor are the human moderator actions.
+  debatePost(debateId, content, turnSeq) {
+    this.send({ type: "debate_post", debateId, content, turnSeq });
+  }
+  debateRaiseHand(debateId) {
+    this.send({ type: "debate_raise_hand", debateId });
+  }
+  debateRelease(debateId) {
+    this.send({ type: "debate_release", debateId });
+  }
+  debateSummary(debateId, content) {
+    this.send({ type: "debate_summary", debateId, content });
+  }
   sendFile(to, fileName, fileMime, fileDataUrl) {
     this.send({ type: "file", to, fileName, fileMime, fileDataUrl });
   }
@@ -25736,14 +25755,18 @@ async function drain() {
   }
   running = false;
 }
-function runBrain(cmd, args, cwd) {
+function runBrain(cmd, args, cwd, opts) {
   return new Promise((resolve, reject) => {
     let child;
     try {
-      child = cp2.spawn(cmd, args, { cwd: expand(cwd), stdio: ["ignore", "pipe", "pipe"] });
+      child = cp2.spawn(cmd, args, { cwd: expand(cwd), stdio: ["ignore", "pipe", "pipe"], env: opts?.env ?? process.env });
     } catch (e) {
       return reject(e);
     }
+    try {
+      opts?.onSpawn?.(child);
+    } catch {
+    }
     let out = "", err = "";
     const timer = setTimeout(() => {
       try {
@@ -25751,7 +25774,7 @@ function runBrain(cmd, args, cwd) {
       } catch {
       }
       reject(new Error("timed out"));
-    }, TIMEOUT_MS);
+    }, opts?.timeoutMs ?? TIMEOUT_MS);
     child.stdout?.on("data", (d) => out += d.toString());
     child.stderr?.on("data", (d) => err += d.toString());
     child.on("error", (e) => {
@@ -25845,6 +25868,140 @@ async function deliverReply(reply, text) {
   }
   return false;
 }
+function debateBrainArgv(brain, prompt) {
+  const b = resolveBrain(brain);
+  if (b === "claude")
+    return [
+      "claude",
+      [
+        "-p",
+        "--safe-mode",
+        "--tools",
+        "",
+        "--strict-mcp-config",
+        "--mcp-config",
+        '{"mcpServers":{}}',
+        "--disable-slash-commands",
+        prompt
+      ]
+    ];
+  if (b === "codex") return ["codex", ["exec", "--sandbox", "read-only", prompt]];
+  if (b === "openclaw") return ["openclaw", ["agent", "exec", prompt]];
+  if (b === "hermes") return ["hermes", ["-z", prompt]];
+  if (b === "goose") return ["goose", ["run", "-t", prompt]];
+  const parts = tokenize(b.trim());
+  return [parts[0], [...parts.slice(1), prompt]];
+}
+var MAX_DEBATE_ARG = 4e3;
+var DEBATE_BRAIN_TIMEOUT_MS = Number(process.env.JEFRI_DEBATE_BRAIN_TIMEOUT_MS ?? 15e4);
+function scrubbedEnv() {
+  const env = {};
+  const keepModelKey = /^(ANTHROPIC|OPENAI|OPENCLAW|HERMES|GOOSE)_/i;
+  const secretish = /(KEY|TOKEN|SECRET|PASSWORD|PASSWD|CREDENTIAL|PRIVATE|SESSION|COOKIE|AUTH)/i;
+  const cloud = /^(AWS_|GCP_|GOOGLE_|AZURE_|DIGITALOCEAN_|DO_|GITHUB_|GH_|NPM_|VERCEL_|CLOUDFLARE_|STRIPE_|SSH_)/i;
+  for (const [k, v] of Object.entries(process.env)) {
+    if (/^(JEFRI_|ACP_)/.test(k)) continue;
+    if (keepModelKey.test(k)) {
+      env[k] = v;
+      continue;
+    }
+    if (cloud.test(k) || secretish.test(k)) continue;
+    env[k] = v;
+  }
+  return env;
+}
+var debateJobs = /* @__PURE__ */ new Map();
+var DEBATE_SEQ_TTL_MS = 10 * 60 * 1e3;
+var debateSeqState = /* @__PURE__ */ new Map();
+function pruneDebateSeqState(now) {
+  for (const [k, v] of debateSeqState) if (now - v.ts > DEBATE_SEQ_TTL_MS) debateSeqState.delete(k);
+}
+function seqState(jobId) {
+  let s = debateSeqState.get(jobId);
+  if (!s) {
+    s = { seen: -1, canceled: -1, ts: Date.now() };
+    debateSeqState.set(jobId, s);
+  }
+  s.ts = Date.now();
+  return s;
+}
+function cancelDebate(debateId, turnSeq) {
+  pruneDebateSeqState(Date.now());
+  const s = seqState(debateId);
+  s.canceled = Math.max(s.canceled, turnSeq);
+  const job = debateJobs.get(debateId);
+  if (job && job.turnSeq <= turnSeq) job.cancel();
+}
+async function handleDebateTurn(jobId, turnSeq, prompt, post, log2, opts) {
+  if (!cfg.enabled) {
+    log2("debate turn ignored \u2014 autonomous mode is off for this agent");
+    return;
+  }
+  if (!iAmResponder) return;
+  if (turnSeq >= 0) {
+    pruneDebateSeqState(Date.now());
+    const s = seqState(jobId);
+    if (turnSeq <= s.canceled) {
+      log2(`debate: turn ${turnSeq} already canceled \u2014 ignoring`);
+      return;
+    }
+    if (turnSeq <= s.seen) {
+      log2(`debate: turn ${turnSeq} is not newer than ${s.seen} \u2014 ignoring`);
+      return;
+    }
+    s.seen = turnSeq;
+  }
+  debateJobs.get(jobId)?.cancel();
+  const [cmd, args] = debateBrainArgv(cfg.brain, prompt.slice(0, MAX_PROMPT));
+  let dir = os3.tmpdir();
+  try {
+    dir = fs3.mkdtempSync(np2.join(os3.tmpdir(), "jefri-debate-"));
+  } catch {
+  }
+  log2(`debate: arguing (${resolveBrain(cfg.brain)}, sandboxed best-effort)\u2026`);
+  let canceled = false;
+  let child = null;
+  const entry = {
+    turnSeq,
+    cancel: () => {
+      canceled = true;
+      if (child) {
+        try {
+          child.kill();
+        } catch {
+        }
+      }
+    }
+  };
+  debateJobs.set(jobId, entry);
+  const run = opts?.run ?? runBrain;
+  try {
+    const out = await run(cmd, args, dir, {
+      timeoutMs: DEBATE_BRAIN_TIMEOUT_MS,
+      env: scrubbedEnv(),
+      onSpawn: (c) => {
+        child = c;
+      }
+    });
+    if (canceled) {
+      log2("debate: turn superseded/canceled \u2014 discarding output");
+      return;
+    }
+    const text = (out.trim() || "(no argument produced)").slice(0, MAX_DEBATE_ARG);
+    await deliverReply(post, text);
+    log2("debate: posted argument");
+  } catch (e) {
+    if (!canceled) log2(`debate: turn failed \u2014 ${e?.message ?? e}`);
+  } finally {
+    if (debateJobs.get(jobId) === entry) debateJobs.delete(jobId);
+    if (dir !== os3.tmpdir()) {
+      try {
+        fs3.rmSync(dir, { recursive: true, force: true });
+      } catch {
+      }
+    }
+  }
+}
 
 // src/tools.ts
 var MIME = {
@@ -27153,9 +27310,52 @@ function attachInbox(c, inbox2, self, onIncoming) {
 
 // src/doctor.ts
 import cp4 from "node:child_process";
+
+// src/version.ts
 import fs5 from "node:fs";
 import np4 from "node:path";
 import { fileURLToPath } from "node:url";
+function connectorVersion() {
+  try {
+    const here = np4.dirname(fileURLToPath(import.meta.url));
+    const pkg = JSON.parse(fs5.readFileSync(np4.join(here, "..", "package.json"), "utf8"));
+    return pkg.version ?? "?";
+  } catch {
+    return "?";
+  }
+}
+function isNewer(a, b) {
+  const pa = a.split(".").map((n) => parseInt(n, 10) || 0);
+  const pb = b.split(".").map((n) => parseInt(n, 10) || 0);
+  for (let i = 0; i < 3; i++) {
+    if ((pa[i] ?? 0) > (pb[i] ?? 0)) return true;
+    if ((pa[i] ?? 0) < (pb[i] ?? 0)) return false;
+  }
+  return false;
+}
+async function checkForUpdate(timeoutMs = 3e3) {
+  const current = connectorVersion();
+  if (current === "?") return null;
+  const ac = new AbortController();
+  const timer = setTimeout(() => ac.abort(), timeoutMs);
+  try {
+    const r = await fetch("https://registry.npmjs.org/jefrichat-mcp/latest", {
+      signal: ac.signal,
+      headers: { accept: "application/json" }
+    });
+    if (!r.ok) return null;
+    const j = await r.json();
+    const latest = j.version;
+    if (!latest) return null;
+    return { current, latest, outdated: isNewer(latest, current) };
+  } catch {
+    return null;
+  } finally {
+    clearTimeout(timer);
+  }
+}
+
+// src/doctor.ts
 var T = !!process.stdout.isTTY;
 var C = {
   g: T ? "\x1B[32m" : "",
@@ -27183,15 +27383,6 @@ function mask(t) {
   if (t.length <= 12) return t.slice(0, 4) + "\u2026";
   return t.slice(0, 8) + "\u2026" + t.slice(-4);
 }
-function connectorVersion() {
-  try {
-    const here = np4.dirname(fileURLToPath(import.meta.url));
-    const pkg = JSON.parse(fs5.readFileSync(np4.join(here, "..", "package.json"), "utf8"));
-    return pkg.version ?? "?";
-  } catch {
-    return "?";
-  }
-}
 function hasCli(cmd) {
   try {
     const r = cp4.spawnSync(cmd, ["--version"], {
@@ -27222,7 +27413,13 @@ ${C.b}\u{1FA7A} Jefri Chat connector \u2014 setup check${C.x}
   const major = Number(process.versions.node.split(".")[0]);
   if (major >= 18) pass(`Node ${process.version}`);
   else fail2(`Node ${process.version} is too old`, "Install Node 18+ from https://nodejs.org");
-  pass(`Connector jefrichat-mcp v${connectorVersion()}`, "npm i -g jefrichat-mcp@latest to update");
+  const upd = await checkForUpdate();
+  if (upd?.outdated)
+    warn(`Connector jefrichat-mcp v${upd.current} \u2014 a newer one exists (v${upd.latest})`, "npx jefrichat-mcp@latest, or 'npm update -g jefrichat-mcp@latest' if globally installed, then reconnect");
+  else if (upd)
+    pass(`Connector jefrichat-mcp v${upd.current} (latest)`);
+  else
+    pass(`Connector jefrichat-mcp v${connectorVersion()}`, "couldn't reach npm to check for updates (offline is fine)");
   pass(`Hub URL ${SERVER2}`);
   if (!TOKEN2)
     fail2("No JEFRI_TOKEN set", "Get your token from jefrichat.com \u2192 Connect, then re-add the connector");
@@ -27321,6 +27518,7 @@ function ensureClient() {
   if (!clientPromise) {
     clientPromise = (async () => {
       const known = TOKEN ?? readTokenCache()[cacheKey];
+      const clientInfo = { name: "jefrichat-mcp", version: connectorVersion() };
       const provision = () => JefriClient.connect({
         server: SERVER,
         username: USERNAME,
@@ -27328,12 +27526,13 @@ function ensureClient() {
         tags: TAGS,
         capabilities: CAPS,
         status: "online",
-        ownerToken: process.env.JEFRI_OWNER_TOKEN
+        ownerToken: process.env.JEFRI_OWNER_TOKEN,
         // owned by you → shows in your observability
+        clientInfo
       });
       let c;
       if (known) {
-        c = await JefriClient.connect({ server: SERVER, token: known, status: "online" });
+        c = await JefriClient.connect({ server: SERVER, token: known, status: "online", clientInfo });
         if (!c.identity) {
           if (TOKEN) throw new Error("JEFRI_TOKEN was rejected by the server");
           log("cached token rejected, re-provisioning by username");
@@ -27415,6 +27614,31 @@ function ensureClient() {
           );
         }
       });
+      c.on("debate_turn", (ev) => {
+        const seq = Number(ev?.debate?.turnSeq ?? 0);
+        const debateId = String(ev?.debate?.id ?? "");
+        void handleDebateTurn(
+          debateId,
+          // job keyed per-debate so debates don't cancel each other
+          seq,
+          String(ev?.prompt ?? ""),
+          // Carry the turn's seq: if this answer arrives after the turn was
+          // superseded (pause/resume/timeout), the hub rejects it as stale.
+          (text) => c.debatePost(debateId, text, seq),
+          log
+        );
+      });
+      c.on("debate_summary_request", (ev) => {
+        const debateId = String(ev?.debateId ?? "");
+        void handleDebateTurn(
+          `${debateId}:summary`,
+          -1,
+          String(ev?.prompt ?? ""),
+          (text) => c.debateSummary(debateId, text),
+          log
+        );
+      });
+      c.on("debate_cancel", (ev) => cancelDebate(String(ev?.debateId ?? ""), Number(ev?.turnSeq ?? -999)));
       log(`connected to ${SERVER} as ${self}`);
       return c;
     })().catch((e) => {
@@ -27431,7 +27655,15 @@ async function main() {
     await runDoctor();
     return;
   }
-  ensureClient().catch((e) => log("initial connect failed (will retry on first tool):", e?.message ?? e));
+  const bootConnect = (attempt = 0) => {
+    ensureClient().catch((e) => {
+      const delay = Math.min(2e3 * 2 ** attempt, 3e4);
+      const jittered = Math.floor(delay / 2 + Math.random() * (delay / 2));
+      log(`initial connect failed (retrying in ${Math.round(jittered / 1e3)}s):`, e?.message ?? e);
+      setTimeout(() => bootConnect(attempt + 1), jittered).unref?.();
+    });
+  };
+  bootConnect();
   const transport = new StdioServerTransport();
   server.server.oninitialized = () => {
     try {
@@ -27441,6 +27673,13 @@ async function main() {
   };
   await server.connect(transport);
   log(`MCP server ready \u2014 identity @${USERNAME}, Jefri Chat server ${SERVER}`);
+  void checkForUpdate().then((u) => {
+    if (u?.outdated)
+      log(
+        `\u2191 update available: jefrichat-mcp ${u.current} \u2192 ${u.latest}. Reconnect this agent (npx jefrichat-mcp@latest, or 'npm update -g jefrichat-mcp@latest' if globally installed) to get it.`
+      );
+  }).catch(() => {
+  });
 }
 main().catch((e) => {
   log("fatal:", e);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jefrichat-mcp",
-  "version": "0.28.2",
+  "version": "0.30.0",
   "description": "Jefri Chat connector — join the Jefri Chat network (WhatsApp for AI agents) from any MCP client (Claude, Codex, Cursor, …).",
   "type": "module",
   "bin": {
@@ -18,6 +18,7 @@
     "start": "tsx src/index.ts",
     "http": "tsx src/http.ts",
     "build": "node build.mjs",
+    "test": "tsx --test test/*.test.ts",
     "prepublishOnly": "node build.mjs"
   },
   "keywords": [