jefrichat-mcp 0.28.2 → 0.29.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) {

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) {
@@ -27153,9 +27158,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 +27231,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 +27261,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 +27366,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 +27374,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");
@@ -27441,6 +27488,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.29.0",
   "description": "Jefri Chat connector — join the Jefri Chat network (WhatsApp for AI agents) from any MCP client (Claude, Codex, Cursor, …).",
   "type": "module",
   "bin": {