jefrichat-mcp 0.48.7 → 0.48.9

package/dist/http.js

@@ -20888,8 +20888,8 @@ var require_application = __commonJS({
       tryRender(view, renderOptions, done);
     };
     app2.listen = function listen() {
-      var server = http2.createServer(this);
-      return server.listen.apply(server, arguments);
+      var server2 = http2.createServer(this);
+      return server2.listen.apply(server2, arguments);
     };
     function logerror(err) {
       if (this.get("env") !== "test") console.error(err.stack || err.toString());
@@ -33214,10 +33214,10 @@ var require_websocket_server = __commonJS({
             process.nextTick(emitClose, this);
           }
         } else {
-          const server = this._server;
+          const server2 = this._server;
           this._removeListeners();
           this._removeListeners = this._server = null;
-          server.close(() => {
+          server2.close(() => {
             emitClose(this);
           });
         }
@@ -33402,17 +33402,17 @@ var require_websocket_server = __commonJS({
       }
     };
     module.exports = WebSocketServer2;
-    function addListeners(server, map3) {
-      for (const event of Object.keys(map3)) server.on(event, map3[event]);
+    function addListeners(server2, map3) {
+      for (const event of Object.keys(map3)) server2.on(event, map3[event]);
       return function removeListeners() {
         for (const event of Object.keys(map3)) {
-          server.removeListener(event, map3[event]);
+          server2.removeListener(event, map3[event]);
         }
       };
     }
-    function emitClose(server) {
-      server._state = CLOSED;
-      server.emit("close");
+    function emitClose(server2) {
+      server2._state = CLOSED;
+      server2.emit("close");
     }
     function socketOnError() {
       this.destroy();
@@ -33431,11 +33431,11 @@ var require_websocket_server = __commonJS({
 ` + Object.keys(headers).map((h) => `${h}: ${headers[h]}`).join("\r\n") + "\r\n\r\n" + message
       );
     }
-    function abortHandshakeOrEmitwsClientError(server, req, socket, code3, message, headers) {
-      if (server.listenerCount("wsClientError")) {
+    function abortHandshakeOrEmitwsClientError(server2, req, socket, code3, message, headers) {
+      if (server2.listenerCount("wsClientError")) {
         const err = new Error(message);
         Error.captureStackTrace(err, abortHandshakeOrEmitwsClientError);
-        server.emit("wsClientError", err, socket, req);
+        server2.emit("wsClientError", err, socket, req);
       } else {
         abortHandshake(socket, code3, message, headers);
       }
@@ -60682,8 +60682,48 @@ var JefriClient = class _JefriClient {
   // heartbeat: did we get a pong since the last ping?
   hasConnected = false;
   // armed for auto-reconnect only after the hub `registered` us
-  lastPresence = "online";
-  // re-announce this on reconnect
+  /** UNACKNOWLEDGED presence intent, or null. Set by presence(), cleared when
+   *  the hub's own presence_update for this identity confirms the declaration
+   *  landed. Null on reconnect means: send nothing and let the hub's persisted
+   *  answer stand.
+   *
+   *  Acknowledgment is the point, and it is what the first fix missed: a value
+   *  kept after delivery means "ever declared", not "pending" — so a client
+   *  that once declared away kept re-asserting it on every reconnect for the
+   *  life of the process, stomping whatever a newer device had chosen since.
+   *  The same stale-overwrite, one level down. */
+  pendingPresence = null;
+  /** The self statusRev BASELINE captured when the pending declaration was made.
+   *  An ack must be CAUSALLY newer than this — the audit reproduced a delayed
+   *  rev-9 event spending intent declared at a rev-10 baseline, after which the
+   *  server had already moved on. Identity + status matching alone cannot order
+   *  events; the revision can. */
+  pendingBaselineRev = 0;
+  /** Highest revision seen for our own status, from registered and from our own
+   *  presence_update events. */
+  selfStatusRev = 0;
+  /** Would a reconnect re-send a presence frame? True only while a declaration
+   *  is UNACKNOWLEDGED. Exposed for tests: the wire behaviour needs a live hub,
+   *  but the rule is checkable without one. */
+  wouldReassertPresence() {
+    return this.pendingPresence !== null;
+  }
+  /** The acknowledgment that turns "pending" back into nothing: the hub
+   *  broadcasts presence_update to the declaring identity too, so our own
+   *  username carrying our pending status means the declaration LANDED — and
+   *  re-asserting it on a later reconnect would stomp whatever a newer device
+   *  declares afterwards. A METHOD, not inline in the socket handler, so tests
+   *  drive the rule production runs instead of a copy of it — a test-local
+   *  re-implementation of this exact logic passed with the real clearing
+   *  deleted, which is how the previous round's test enshrined the bug. */
+  notePresenceAck(ev) {
+    if (ev?.event !== "presence_update" || ev.username !== this.identity?.username) return;
+    const frontier = this.selfStatusRev;
+    if (typeof ev.rev === "number" && ev.rev > this.selfStatusRev) this.selfStatusRev = ev.rev;
+    if (this.pendingPresence === null || ev.status !== this.pendingPresence) return;
+    if (typeof ev.rev !== "number" || ev.rev <= this.pendingBaselineRev || ev.rev < frontier) return;
+    this.pendingPresence = null;
+  }
   clientInfo;
   // handshake, re-sent on reconnect
   /** Is the hub socket usable RIGHT NOW?
@@ -60697,15 +60737,15 @@ var JefriClient = class _JefriClient {
   get online() {
     return this.hasConnected && !this.closing && this.ws?.readyState === this.ws?.OPEN;
   }
-  constructor(server) {
-    this.server = server.replace(/\/$/, "");
+  constructor(server2) {
+    this.server = server2.replace(/\/$/, "");
   }
   static async connect(opts = {}) {
-    const server = (opts.server ?? "https://jefrichat.com").replace(/\/$/, "");
-    const client = new _JefriClient(server);
+    const server2 = (opts.server ?? "https://jefrichat.com").replace(/\/$/, "");
+    const client = new _JefriClient(server2);
     let token = opts.token;
     if (!token) {
-      const res = await fetch(`${server}/api/agents`, {
+      const res = await fetch(`${server2}/api/agents`, {
         method: "POST",
         headers: { "content-type": "application/json" },
         body: JSON.stringify({
@@ -60778,7 +60818,8 @@ var JefriClient = class _JefriClient {
       this.ws.on("open", () => {
         this.startPing();
         try {
-          this.ws.send(JSON.stringify({ type: "presence", status: this.lastPresence }));
+          if (this.pendingPresence !== null)
+            this.ws.send(JSON.stringify({ type: "presence", status: this.pendingPresence }));
           if (this.clientInfo)
             this.ws.send(JSON.stringify({ type: "client_info", ...this.clientInfo }));
         } catch {
@@ -60807,12 +60848,15 @@ var JefriClient = class _JefriClient {
         }
         if (ev.event === "registered") {
           this.identity = ev.identity;
+          const rev = ev.identity?.statusRev;
+          if (typeof rev === "number" && rev > this.selfStatusRev) this.selfStatusRev = rev;
           this.hasConnected = true;
           this.reconnectAttempts = 0;
         }
         if (ev.event === "error" && /auth/i.test(ev.message ?? "")) {
           this.authFailed = true;
         }
+        this.notePresenceAck(ev);
         this.emit(ev.event, ev);
         this.emit("*", ev);
       });
@@ -60901,7 +60945,8 @@ var JefriClient = class _JefriClient {
   }
   // --- actions -------------------------------------------------------------
   presence(status) {
-    this.lastPresence = status;
+    this.pendingPresence = status;
+    this.pendingBaselineRev = this.selfStatusRev;
     this.send({ type: "presence", status });
   }
   message(to, content3) {
@@ -62005,7 +62050,21 @@ function waitFor(c, event, match, timeoutMs = 4e3) {
     }, timeoutMs);
   });
 }
-var ok3 = (text5) => ({ content: [{ type: "text", text: text5 }] });
+var upgradeNotice = null;
+var upgradeShownAt = 0;
+var UPGRADE_REPEAT_MS = 24 * 60 * 60 * 1e3;
+function takeUpgradeNotice(now = Date.now()) {
+  if (!upgradeNotice) return null;
+  if (upgradeShownAt && now - upgradeShownAt < UPGRADE_REPEAT_MS) return null;
+  upgradeShownAt = now;
+  return upgradeNotice;
+}
+var ok3 = (text5, now = Date.now()) => {
+  const notice = takeUpgradeNotice(now);
+  return { content: [{ type: "text", text: notice ? `${text5}
+
+${notice}` : text5 }] };
+};
 var fail = (text5) => ({ content: [{ type: "text", text: text5 }], isError: true });
 var WATERMARK_FILE = np3.join(os4.homedir(), ".jefri", "inbox.json");
 var inboxWatermark = new Map(
@@ -62024,9 +62083,9 @@ function saveWatermark() {
   } catch {
   }
 }
-function registerAcpTools(server, ctx) {
+function registerAcpTools(server2, ctx) {
   const ENABLE_E2E = process.env.JEFRI_ENABLE_E2E === "true";
-  const e2eServer = ENABLE_E2E ? server : { registerTool: () => void 0 };
+  const e2eServer = ENABLE_E2E ? server2 : { registerTool: () => void 0 };
   const withClient = async (fn) => {
     try {
       const c = await ctx.ensureClient();
@@ -62036,7 +62095,7 @@ function registerAcpTools(server, ctx) {
 ${e?.message ?? e}`);
     }
   };
-  server.registerTool(
+  server2.registerTool(
     "jefri_whoami",
     {
       title: "Who am I on Jefri Chat",
@@ -62047,7 +62106,7 @@ ${e?.message ?? e}`);
       async (c) => ok3(`You are "${c.identity.displayName}" (@${c.identity.username}) on Jefri Chat at ${ctx.serverUrl}, status: online.`)
     )
   );
-  server.registerTool(
+  server2.registerTool(
     "jefri_agents",
     {
       title: "List your connections",
@@ -62083,7 +62142,7 @@ ${e?.message ?? e}`);
     }
     return { status: res.status, body };
   };
-  server.registerTool(
+  server2.registerTool(
     "jefri_agent_apps",
     {
       title: "See where your agents are running",
@@ -62107,7 +62166,7 @@ ${lines.join("\n")}
 Use jefri_agent_apps with agent=<name> to see its live app + active state.`);
     })
   );
-  server.registerTool(
+  server2.registerTool(
     "jefri_deactivate",
     {
       title: "Deactivate an agent",
@@ -62120,7 +62179,7 @@ Use jefri_agent_apps with agent=<name> to see its live app + active state.`);
       return ok3(`\u{1F6D1} Deactivated @${agent}. It's disconnected and can't reconnect from any app until you reactivate it.`);
     })
   );
-  server.registerTool(
+  server2.registerTool(
     "jefri_activate",
     {
       title: "Reactivate an agent",
@@ -62133,7 +62192,7 @@ Use jefri_agent_apps with agent=<name> to see its live app + active state.`);
       return ok3(`\u2705 Reactivated @${agent}. It can connect again now.`);
     })
   );
-  server.registerTool(
+  server2.registerTool(
     "jefri_send",
     {
       title: "Send a message",
@@ -62286,7 +62345,7 @@ ${fp}`);
       return ok3(`Sent private E2E group file.`);
     })
   );
-  server.registerTool(
+  server2.registerTool(
     "jefri_send_file",
     {
       title: "Send a file, PDF, or image",
@@ -62370,7 +62429,7 @@ ${psCmd}
       return ok3(`Sent \u{1F4CE} ${name} to @${to}${caption ? ` \u2014 "${caption}"` : ""}`);
     })
   );
-  server.registerTool(
+  server2.registerTool(
     "jefri_send_code",
     {
       title: "Send code / text as a file",
@@ -62405,7 +62464,7 @@ ${psCmd}
       return ok3(`Sent \u{1F4C4} ${fileName} (${content3.length} chars) to @${to}${caption ? ` \u2014 "${caption}"` : ""}`);
     })
   );
-  server.registerTool(
+  server2.registerTool(
     "jefri_send_folder",
     {
       title: "Send a whole folder / project (zipped)",
@@ -62503,7 +62562,7 @@ ${psCmd}
       );
     })
   );
-  server.registerTool(
+  server2.registerTool(
     "jefri_download_file",
     {
       title: "Download / save a file someone sent you",
@@ -62550,7 +62609,7 @@ It downloads the file to your machine (current folder unless you set a path). Fi
       );
     })
   );
-  server.registerTool(
+  server2.registerTool(
     "jefri_connect",
     {
       title: "Request a connection",
@@ -62566,7 +62625,7 @@ It downloads the file to your machine (current folder unless you set a path). Fi
     })
   );
   const hubBase = () => ctx.serverUrl.replace(/\/$/, "");
-  server.registerTool(
+  server2.registerTool(
     "jefri_departments",
     {
       title: "List your departments",
@@ -62580,7 +62639,7 @@ It downloads the file to your machine (current folder unless you set a path). Fi
       return ok3(d.map((x) => `\u2022 ${x.name} (${x.org}) \u2014 access: ${x.myLevel}  [id: ${x.id}]`).join("\n"));
     })
   );
-  server.registerTool(
+  server2.registerTool(
     "jefri_dept_files",
     {
       title: "List a department's files",
@@ -62595,7 +62654,7 @@ It downloads the file to your machine (current folder unless you set a path). Fi
       return ok3(files.map((f) => `\u2022 ${f.name} [${f.kind}] \u2014 by ${f.createdBy}, ${new Date(f.updatedAt).toLocaleDateString()}  (id: ${f.id})`).join("\n"));
     })
   );
-  server.registerTool(
+  server2.registerTool(
     "jefri_dept_read",
     {
       title: "Download a department file",
@@ -62625,7 +62684,7 @@ ${cmd}
 (Set your token first: export JEFRI_TOKEN=\u2026 from the app's Connect dialog \u2014 it isn't printed here on purpose.)`);
     })
   );
-  server.registerTool(
+  server2.registerTool(
     "jefri_dept_add_file",
     {
       title: "Add a file to a department",
@@ -62648,7 +62707,7 @@ ${cmd}
 (With 'write' access it's added directly; with 'propose' access it's submitted for an admin to approve; read-only is rejected.)`);
     })
   );
-  server.registerTool(
+  server2.registerTool(
     "jefri_my_docs",
     {
       title: "List my documents (memory)",
@@ -62667,7 +62726,7 @@ ${cmd}
       );
     })
   );
-  server.registerTool(
+  server2.registerTool(
     "jefri_search_docs",
     {
       title: "Search my document memory",
@@ -62690,7 +62749,7 @@ ${h.text}`).join("\n\n---\n\n")
       );
     })
   );
-  server.registerTool(
+  server2.registerTool(
     "jefri_read_doc",
     {
       title: "Read/get one of my documents",
@@ -62715,7 +62774,7 @@ ${cmd}
 (Set your token first: export JEFRI_TOKEN=\u2026 from the app's Connect dialog \u2014 it isn't printed here on purpose.)`);
     })
   );
-  server.registerTool(
+  server2.registerTool(
     "jefri_add_doc",
     {
       title: "Add a document to my memory",
@@ -62735,7 +62794,7 @@ Or just upload ${fname} from the agent's page in the web app.`
       );
     })
   );
-  server.registerTool(
+  server2.registerTool(
     "jefri_my_tasks",
     {
       title: "My department tasks",
@@ -62752,7 +62811,7 @@ Or just upload ${fname} from the agent's page in the web app.`
       );
     })
   );
-  server.registerTool(
+  server2.registerTool(
     "jefri_task_status",
     {
       title: "Update a task's status",
@@ -62774,7 +62833,7 @@ Or just upload ${fname} from the agent's page in the web app.`
       return ok3(`Task marked ${status === "done" ? "\u2705 done" : status}.`);
     })
   );
-  server.registerTool(
+  server2.registerTool(
     "jefri_inbox",
     {
       title: "Read unread messages",
@@ -62830,7 +62889,7 @@ Or just upload ${fname} from the agent's page in the web app.`
 ` + lines.join("\n"));
     })
   );
-  server.registerTool(
+  server2.registerTool(
     "jefri_groups",
     {
       title: "List your groups",
@@ -62846,7 +62905,7 @@ Or just upload ${fname} from the agent's page in the web app.`
       );
     })
   );
-  server.registerTool(
+  server2.registerTool(
     "jefri_send_group",
     {
       title: "Send a group message",
@@ -62864,7 +62923,7 @@ Or just upload ${fname} from the agent's page in the web app.`
       return ok3(`Posted to the group.`);
     })
   );
-  server.registerTool(
+  server2.registerTool(
     "jefri_send_group_file",
     {
       title: "Send a file to a group",
@@ -62938,7 +62997,7 @@ Or just upload ${fname} from the agent's page in the web app.`
       return ok3(`Sent \u{1F4CE} ${name} to the group.`);
     })
   );
-  server.registerTool(
+  server2.registerTool(
     "jefri_history",
     {
       title: "Read conversation history",
@@ -62978,7 +63037,7 @@ Or just upload ${fname} from the agent's page in the web app.`
       return ok3(lines.join("\n"));
     })
   );
-  server.registerTool(
+  server2.registerTool(
     "jefri_search",
     {
       title: "Discover agents",
@@ -62996,7 +63055,7 @@ Or just upload ${fname} from the agent's page in the web app.`
       );
     })
   );
-  server.registerTool(
+  server2.registerTool(
     "jefri_set_status",
     {
       title: "Set presence",
@@ -63011,7 +63070,7 @@ Or just upload ${fname} from the agent's page in the web app.`
     })
   );
   if (ctx.local) {
-    server.registerTool(
+    server2.registerTool(
       "jefri_notifications",
       {
         title: "Notification settings",
@@ -63090,7 +63149,7 @@ Or just upload ${fname} from the agent's page in the web app.`
         return ok3(summary);
       })
     );
-    server.registerTool(
+    server2.registerTool(
       "jefri_autonomous",
       {
         title: "Autonomous mode",
@@ -63167,6 +63226,34 @@ function attachInbox(c, inbox, self, onIncoming) {
   c.on("file_received", capture);
 }
 
+// src/drain.ts
+function durationEnv(name, fallback, env = process.env) {
+  const raw = env[name];
+  if (raw === void 0 || raw === "") return fallback;
+  const n = Number(raw);
+  if (!Number.isFinite(n) || n <= 0) {
+    console.error(`[mcp] ignoring ${name}="${raw}" \u2014 expected a positive number; using ${fallback}ms`);
+    return fallback;
+  }
+  return n;
+}
+function sweepIdleSessions(map3) {
+  let closed = 0;
+  let busy = 0;
+  for (const s of map3) {
+    if (s.inflight > 0) {
+      busy++;
+      continue;
+    }
+    try {
+      s.transport.close?.();
+      closed++;
+    } catch {
+    }
+  }
+  return { closed, busy };
+}
+
 // src/http.ts
 var HUB = process.env.JEFRI_SERVER ?? "http://localhost:4000";
 var PORT = Number(process.env.MCP_HTTP_PORT ?? 4001);
@@ -63310,7 +63397,14 @@ app.use((req, res, next) => {
   next();
 });
 app.use(import_express.default.json({ limit: process.env.MCP_MAX_BODY ?? "4mb" }));
-var health = (_req, res) => res.json({ ok: true, service: "jefrichat-mcp-http", hub: HUB, sessions: sessions.size });
+var draining = false;
+var health = (_req, res) => res.status(draining ? 503 : 200).json({
+  ok: !draining,
+  draining,
+  service: "jefrichat-mcp-http",
+  hub: HUB,
+  sessions: sessions.size
+});
 app.get("/health", health);
 app.get("/mcp/health", health);
 app.post("/mcp", async (req, res) => {
@@ -63348,6 +63442,14 @@ app.post("/mcp", async (req, res) => {
     }
     return;
   }
+  if (draining && !sessionId && isInitializeRequest(req.body)) {
+    res.setHeader("retry-after", "1");
+    return res.status(503).json({
+      jsonrpc: "2.0",
+      error: { code: -32e3, message: "server is shutting down \u2014 retry; another instance will accept this session" },
+      id: null
+    });
+  }
   if (!sessionId && isInitializeRequest(req.body)) {
     if (initRateLimited(req)) {
       res.status(429).json({
@@ -63488,13 +63590,52 @@ var bySession = async (req, res) => {
 };
 app.get("/mcp", bySession);
 app.delete("/mcp", bySession);
-http.createServer(app).listen(PORT, () => {
+var server = http.createServer(app).listen(PORT, () => {
   console.error(`
   \u{1F310} Jefri Chat remote MCP (HTTP) on http://localhost:${PORT}/mcp`);
   console.error(`     hub: ${HUB}`);
   console.error(`     auth: Authorization: Bearer <jefri_token>
 `);
 });
+var DRAIN_MS = durationEnv("MCP_DRAIN_MS", 15e3);
+var UNHEALTHY_MS = durationEnv("MCP_UNHEALTHY_MS", 5e3);
+var shuttingDown = false;
+function drain2(signal) {
+  if (shuttingDown) return;
+  shuttingDown = true;
+  draining = true;
+  const deadline = Date.now() + UNHEALTHY_MS + DRAIN_MS;
+  console.error(
+    `[mcp] ${signal} \u2014 unhealthy for ${UNHEALTHY_MS}ms, then draining ${sessions.size} session(s) for up to ${DRAIN_MS}ms`
+  );
+  const closeAndFinish = () => {
+    server.close(() => {
+      console.error("[mcp] drained cleanly");
+      process.exit(0);
+    });
+    const sweep = setInterval(() => {
+      const { busy } = sweepIdleSessions(sessions.values());
+      if (busy === 0) {
+        clearInterval(sweep);
+        console.error("[mcp] all sessions idle \u2014 closing");
+        return;
+      }
+      if (Date.now() >= deadline) {
+        clearInterval(sweep);
+        console.error(`[mcp] drain deadline reached with ${busy} session(s) still busy \u2014 exiting`);
+        process.exit(0);
+      }
+    }, 250);
+    sweep.unref();
+  };
+  setTimeout(closeAndFinish, UNHEALTHY_MS).unref();
+  setTimeout(() => {
+    console.error("[mcp] drain deadline reached \u2014 exiting");
+    process.exit(0);
+  }, UNHEALTHY_MS + DRAIN_MS + 500).unref();
+}
+process.on("SIGTERM", () => drain2("SIGTERM"));
+process.on("SIGINT", () => drain2("SIGINT"));
 /*! Bundled license information:
 
 depd/index.js:

package/dist/index.js

@@ -38648,8 +38648,48 @@ var JefriClient = class _JefriClient {
   // heartbeat: did we get a pong since the last ping?
   hasConnected = false;
   // armed for auto-reconnect only after the hub `registered` us
-  lastPresence = "online";
-  // re-announce this on reconnect
+  /** UNACKNOWLEDGED presence intent, or null. Set by presence(), cleared when
+   *  the hub's own presence_update for this identity confirms the declaration
+   *  landed. Null on reconnect means: send nothing and let the hub's persisted
+   *  answer stand.
+   *
+   *  Acknowledgment is the point, and it is what the first fix missed: a value
+   *  kept after delivery means "ever declared", not "pending" — so a client
+   *  that once declared away kept re-asserting it on every reconnect for the
+   *  life of the process, stomping whatever a newer device had chosen since.
+   *  The same stale-overwrite, one level down. */
+  pendingPresence = null;
+  /** The self statusRev BASELINE captured when the pending declaration was made.
+   *  An ack must be CAUSALLY newer than this — the audit reproduced a delayed
+   *  rev-9 event spending intent declared at a rev-10 baseline, after which the
+   *  server had already moved on. Identity + status matching alone cannot order
+   *  events; the revision can. */
+  pendingBaselineRev = 0;
+  /** Highest revision seen for our own status, from registered and from our own
+   *  presence_update events. */
+  selfStatusRev = 0;
+  /** Would a reconnect re-send a presence frame? True only while a declaration
+   *  is UNACKNOWLEDGED. Exposed for tests: the wire behaviour needs a live hub,
+   *  but the rule is checkable without one. */
+  wouldReassertPresence() {
+    return this.pendingPresence !== null;
+  }
+  /** The acknowledgment that turns "pending" back into nothing: the hub
+   *  broadcasts presence_update to the declaring identity too, so our own
+   *  username carrying our pending status means the declaration LANDED — and
+   *  re-asserting it on a later reconnect would stomp whatever a newer device
+   *  declares afterwards. A METHOD, not inline in the socket handler, so tests
+   *  drive the rule production runs instead of a copy of it — a test-local
+   *  re-implementation of this exact logic passed with the real clearing
+   *  deleted, which is how the previous round's test enshrined the bug. */
+  notePresenceAck(ev) {
+    if (ev?.event !== "presence_update" || ev.username !== this.identity?.username) return;
+    const frontier = this.selfStatusRev;
+    if (typeof ev.rev === "number" && ev.rev > this.selfStatusRev) this.selfStatusRev = ev.rev;
+    if (this.pendingPresence === null || ev.status !== this.pendingPresence) return;
+    if (typeof ev.rev !== "number" || ev.rev <= this.pendingBaselineRev || ev.rev < frontier) return;
+    this.pendingPresence = null;
+  }
   clientInfo;
   // handshake, re-sent on reconnect
   /** Is the hub socket usable RIGHT NOW?
@@ -38744,7 +38784,8 @@ var JefriClient = class _JefriClient {
       this.ws.on("open", () => {
         this.startPing();
         try {
-          this.ws.send(JSON.stringify({ type: "presence", status: this.lastPresence }));
+          if (this.pendingPresence !== null)
+            this.ws.send(JSON.stringify({ type: "presence", status: this.pendingPresence }));
           if (this.clientInfo)
             this.ws.send(JSON.stringify({ type: "client_info", ...this.clientInfo }));
         } catch {
@@ -38773,12 +38814,15 @@ var JefriClient = class _JefriClient {
         }
         if (ev.event === "registered") {
           this.identity = ev.identity;
+          const rev = ev.identity?.statusRev;
+          if (typeof rev === "number" && rev > this.selfStatusRev) this.selfStatusRev = rev;
           this.hasConnected = true;
           this.reconnectAttempts = 0;
         }
         if (ev.event === "error" && /auth/i.test(ev.message ?? "")) {
           this.authFailed = true;
         }
+        this.notePresenceAck(ev);
         this.emit(ev.event, ev);
         this.emit("*", ev);
       });
@@ -38867,7 +38911,8 @@ var JefriClient = class _JefriClient {
   }
   // --- actions -------------------------------------------------------------
   presence(status) {
-    this.lastPresence = status;
+    this.pendingPresence = status;
+    this.pendingBaselineRev = this.selfStatusRev;
     this.send({ type: "presence", status });
   }
   message(to, content3) {
@@ -40788,7 +40833,24 @@ function waitFor(c2, event, match, timeoutMs = 4e3) {
     }, timeoutMs);
   });
 }
-var ok3 = (text5) => ({ content: [{ type: "text", text: text5 }] });
+var upgradeNotice = null;
+var upgradeShownAt = 0;
+var UPGRADE_REPEAT_MS = 24 * 60 * 60 * 1e3;
+function setUpgradeNotice(text5) {
+  upgradeNotice = text5;
+}
+function takeUpgradeNotice(now = Date.now()) {
+  if (!upgradeNotice) return null;
+  if (upgradeShownAt && now - upgradeShownAt < UPGRADE_REPEAT_MS) return null;
+  upgradeShownAt = now;
+  return upgradeNotice;
+}
+var ok3 = (text5, now = Date.now()) => {
+  const notice = takeUpgradeNotice(now);
+  return { content: [{ type: "text", text: notice ? `${text5}
+
+${notice}` : text5 }] };
+};
 var fail = (text5) => ({ content: [{ type: "text", text: text5 }], isError: true });
 var WATERMARK_FILE = np4.join(os4.homedir(), ".jefri", "inbox.json");
 var inboxWatermark = new Map(
@@ -42936,10 +42998,14 @@ async function main() {
     log("unhandled rejection:", reason?.stack ?? reason);
   });
   void checkForUpdate().then((u) => {
-    if (u?.outdated)
+    if (u?.outdated) {
+      setUpgradeNotice(
+        `\u26A0\uFE0F Jefri Chat connector ${u.current} is out of date (latest ${u.latest}). Restart this agent to upgrade \u2014 a running connector keeps the build it started with. If it was started with npx, that is enough; if installed globally, run: npm update -g jefrichat-mcp`
+      );
       note(
         `\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(() => {
   });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jefrichat-mcp",
-  "version": "0.48.7",
+  "version": "0.48.9",
   "description": "Jefri Chat connector — join the Jefri Chat network (WhatsApp for AI agents) from any MCP client (Claude, Codex, Cursor, …).",
   "type": "module",
   "bin": {