jefrichat-mcp 0.20.0 → 0.21.0

package/README.md

@@ -9,16 +9,20 @@ hub.
 
 Create an agent in your Jefri Chat web app to get a **token**, then:
 
+Name the server `jefri_<username>` (e.g. `jefri_aaron`) — connecting a second
+agent under the same name would overwrite the first, and the per-agent name
+shows at a glance which agent is which.
+
 ### Claude Code (local, via npx)
 ```bash
-claude mcp add jefri -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
 ```
 
 ### Claude Desktop / Codex / Cursor (config)
 ```json
 {
   "mcpServers": {
-    "jefri": {
+    "jefri_aaron": {
       "command": "npx",
       "args": ["-y", "jefrichat-mcp"],
       "env": { "JEFRI_SERVER": "https://jefrichat.com", "JEFRI_TOKEN": "jefri_xxx" }

package/dist/http.js

@@ -5250,9 +5250,9 @@ var require_on_finished = __commonJS({
   }
 });
 
-// ../../node_modules/.pnpm/body-parser@1.20.5/node_modules/body-parser/lib/read.js
+// ../../node_modules/.pnpm/body-parser@1.20.6/node_modules/body-parser/lib/read.js
 var require_read = __commonJS({
-  "../../node_modules/.pnpm/body-parser@1.20.5/node_modules/body-parser/lib/read.js"(exports, module) {
+  "../../node_modules/.pnpm/body-parser@1.20.6/node_modules/body-parser/lib/read.js"(exports, module) {
     "use strict";
     var createError = require_http_errors();
     var destroy = require_destroy();
@@ -14228,9 +14228,9 @@ var require_type_is = __commonJS({
   }
 });
 
-// ../../node_modules/.pnpm/body-parser@1.20.5/node_modules/body-parser/lib/types/json.js
+// ../../node_modules/.pnpm/body-parser@1.20.6/node_modules/body-parser/lib/types/json.js
 var require_json = __commonJS({
-  "../../node_modules/.pnpm/body-parser@1.20.5/node_modules/body-parser/lib/types/json.js"(exports, module) {
+  "../../node_modules/.pnpm/body-parser@1.20.6/node_modules/body-parser/lib/types/json.js"(exports, module) {
     "use strict";
     var bytes = require_bytes();
     var contentType = require_content_type();
@@ -14244,12 +14244,15 @@ var require_json = __commonJS({
     var JSON_SYNTAX_REGEXP = /#+/g;
     function json(options) {
       var opts = options || {};
-      var limit = typeof opts.limit !== "number" ? bytes.parse(opts.limit || "100kb") : opts.limit;
+      var limit = typeof opts.limit === "undefined" || opts.limit === null ? 102400 : bytes.parse(opts.limit);
       var inflate = opts.inflate !== false;
       var reviver = opts.reviver;
       var strict = opts.strict !== false;
       var type = opts.type || "application/json";
       var verify = opts.verify || false;
+      if (limit === null) {
+        throw new TypeError('option limit "' + String(opts.limit) + '" is invalid');
+      }
       if (verify !== false && typeof verify !== "function") {
         throw new TypeError("option verify must be function");
       }
@@ -14359,9 +14362,9 @@ var require_json = __commonJS({
   }
 });
 
-// ../../node_modules/.pnpm/body-parser@1.20.5/node_modules/body-parser/lib/types/raw.js
+// ../../node_modules/.pnpm/body-parser@1.20.6/node_modules/body-parser/lib/types/raw.js
 var require_raw = __commonJS({
-  "../../node_modules/.pnpm/body-parser@1.20.5/node_modules/body-parser/lib/types/raw.js"(exports, module) {
+  "../../node_modules/.pnpm/body-parser@1.20.6/node_modules/body-parser/lib/types/raw.js"(exports, module) {
     "use strict";
     var bytes = require_bytes();
     var debug = require_src()("body-parser:raw");
@@ -14371,9 +14374,12 @@ var require_raw = __commonJS({
     function raw(options) {
       var opts = options || {};
       var inflate = opts.inflate !== false;
-      var limit = typeof opts.limit !== "number" ? bytes.parse(opts.limit || "100kb") : opts.limit;
+      var limit = typeof opts.limit === "undefined" || opts.limit === null ? 102400 : bytes.parse(opts.limit);
       var type = opts.type || "application/octet-stream";
       var verify = opts.verify || false;
+      if (limit === null) {
+        throw new TypeError('option limit "' + String(opts.limit) + '" is invalid');
+      }
       if (verify !== false && typeof verify !== "function") {
         throw new TypeError("option verify must be function");
       }
@@ -14415,9 +14421,9 @@ var require_raw = __commonJS({
   }
 });
 
-// ../../node_modules/.pnpm/body-parser@1.20.5/node_modules/body-parser/lib/types/text.js
+// ../../node_modules/.pnpm/body-parser@1.20.6/node_modules/body-parser/lib/types/text.js
 var require_text = __commonJS({
-  "../../node_modules/.pnpm/body-parser@1.20.5/node_modules/body-parser/lib/types/text.js"(exports, module) {
+  "../../node_modules/.pnpm/body-parser@1.20.6/node_modules/body-parser/lib/types/text.js"(exports, module) {
     "use strict";
     var bytes = require_bytes();
     var contentType = require_content_type();
@@ -14429,9 +14435,12 @@ var require_text = __commonJS({
       var opts = options || {};
       var defaultCharset = opts.defaultCharset || "utf-8";
       var inflate = opts.inflate !== false;
-      var limit = typeof opts.limit !== "number" ? bytes.parse(opts.limit || "100kb") : opts.limit;
+      var limit = typeof opts.limit === "undefined" || opts.limit === null ? 102400 : bytes.parse(opts.limit);
       var type = opts.type || "text/plain";
       var verify = opts.verify || false;
+      if (limit === null) {
+        throw new TypeError('option limit "' + String(opts.limit) + '" is invalid');
+      }
       if (verify !== false && typeof verify !== "function") {
         throw new TypeError("option verify must be function");
       }
@@ -17017,9 +17026,9 @@ var require_lib2 = __commonJS({
   }
 });
 
-// ../../node_modules/.pnpm/body-parser@1.20.5/node_modules/body-parser/lib/types/urlencoded.js
+// ../../node_modules/.pnpm/body-parser@1.20.6/node_modules/body-parser/lib/types/urlencoded.js
 var require_urlencoded = __commonJS({
-  "../../node_modules/.pnpm/body-parser@1.20.5/node_modules/body-parser/lib/types/urlencoded.js"(exports, module) {
+  "../../node_modules/.pnpm/body-parser@1.20.6/node_modules/body-parser/lib/types/urlencoded.js"(exports, module) {
     "use strict";
     var bytes = require_bytes();
     var contentType = require_content_type();
@@ -17037,9 +17046,12 @@ var require_urlencoded = __commonJS({
       }
       var extended = opts.extended !== false;
       var inflate = opts.inflate !== false;
-      var limit = typeof opts.limit !== "number" ? bytes.parse(opts.limit || "100kb") : opts.limit;
+      var limit = typeof opts.limit === "undefined" || opts.limit === null ? 102400 : bytes.parse(opts.limit);
       var type = opts.type || "application/x-www-form-urlencoded";
       var verify = opts.verify || false;
+      if (limit === null) {
+        throw new TypeError('option limit "' + String(opts.limit) + '" is invalid');
+      }
       if (verify !== false && typeof verify !== "function") {
         throw new TypeError("option verify must be function");
       }
@@ -17190,9 +17202,9 @@ var require_urlencoded = __commonJS({
   }
 });
 
-// ../../node_modules/.pnpm/body-parser@1.20.5/node_modules/body-parser/index.js
+// ../../node_modules/.pnpm/body-parser@1.20.6/node_modules/body-parser/index.js
 var require_body_parser = __commonJS({
-  "../../node_modules/.pnpm/body-parser@1.20.5/node_modules/body-parser/index.js"(exports, module) {
+  "../../node_modules/.pnpm/body-parser@1.20.6/node_modules/body-parser/index.js"(exports, module) {
     "use strict";
     var deprecate = require_depd()("body-parser");
     var parsers = /* @__PURE__ */ Object.create(null);
@@ -48953,11 +48965,15 @@ var JefriClient = class _JefriClient {
   // a bad token must NOT trigger a reconnect storm
   isAlive = true;
   // heartbeat: did we get a pong since the last ping?
+  hasConnected = false;
+  // armed for auto-reconnect only after the first open
+  lastPresence = "online";
+  // re-announce this on reconnect
   constructor(server) {
     this.server = server.replace(/\/$/, "");
   }
   static async connect(opts = {}) {
-    const server = (opts.server ?? "http://localhost:4000").replace(/\/$/, "");
+    const server = (opts.server ?? "https://jefrichat.com").replace(/\/$/, "");
     const client = new _JefriClient(server);
     let token = opts.token;
     if (!token) {
@@ -49017,9 +49033,10 @@ var JefriClient = class _JefriClient {
       let settled = false;
       this.ws.on("open", () => {
         this.reconnectAttempts = 0;
+        this.hasConnected = true;
         this.startPing();
         try {
-          this.ws.send(JSON.stringify({ type: "presence", status: "online" }));
+          this.ws.send(JSON.stringify({ type: "presence", status: this.lastPresence }));
         } catch {
         }
         if (!settled) {
@@ -49035,7 +49052,7 @@ var JefriClient = class _JefriClient {
       });
       this.ws.on("close", () => {
         this.stopPing();
-        if (!this.closing && !this.authFailed) this.scheduleReconnect();
+        if (this.hasConnected && !this.closing && !this.authFailed) this.scheduleReconnect();
       });
       this.ws.on("message", (data) => {
         let ev;
@@ -49119,7 +49136,15 @@ var JefriClient = class _JefriClient {
     return this;
   }
   emit(event, payload) {
-    this.handlers.get(event)?.forEach((h) => h(payload));
+    for (const h of this.handlers.get(event) ?? []) {
+      try {
+        const res = h(payload);
+        if (res instanceof Promise)
+          res.catch((e) => console.error(`[jefri-sdk] async event handler failed for "${event}":`, e));
+      } catch (e) {
+        console.error(`[jefri-sdk] event handler failed for "${event}":`, e);
+      }
+    }
   }
   send(ev) {
     if (!this.ws || this.ws.readyState !== this.ws.OPEN)
@@ -49128,6 +49153,7 @@ var JefriClient = class _JefriClient {
   }
   // --- actions -------------------------------------------------------------
   presence(status) {
+    this.lastPresence = status;
     this.send({ type: "presence", status });
   }
   message(to, content) {
@@ -49190,8 +49216,8 @@ var JefriClient = class _JefriClient {
   addToGroup(groupId, members) {
     this.send({ type: "add_to_group", groupId, members });
   }
-  history(conversationId) {
-    this.send({ type: "history", conversationId });
+  history(conversationId, before) {
+    this.send({ type: "history", conversationId, ...before ? { before } : {} });
   }
   close() {
     this.closing = true;
@@ -49202,9 +49228,11 @@ var JefriClient = class _JefriClient {
   }
   // --- REST helpers --------------------------------------------------------
   async identities() {
-    return (await fetch(`${this.server}/api/identities`, {
+    const r = await fetch(`${this.server}/api/identities`, {
       headers: { authorization: `Bearer ${this.token}` }
-    })).json();
+    });
+    if (!r.ok) throw new Error(`could not load identities: ${r.status} ${await r.text()}`);
+    return r.json();
   }
   async groups() {
     const r = await fetch(`${this.server}/api/groups`, {
@@ -49417,6 +49445,7 @@ var JefriClient = class _JefriClient {
     return JSON.parse(dec.decode(plaintext));
   }
 };
+var serveDir = path.join(os.homedir(), ".acp", "serve");
 
 // src/tools.ts
 import fs4 from "node:fs";
@@ -50361,7 +50390,7 @@ ${cmd}`);
     "jefri_add_doc",
     {
       title: "Add a document to my memory",
-      description: "Upload a local file into your own document memory. Returns a command to run (reads the file locally and uploads it).",
+      description: "Upload a local file into your own document memory. Returns a command to run (reads the file locally and uploads it). NOTE: documents follow this agent's visibility \u2014 on a PUBLIC agent the owner's connections can read/download them; on a shared agent only the chosen people; on a private agent only the owner. Warn the owner before uploading anything sensitive to a public agent.",
       inputSchema: { path: external_exports.string().describe("local file path to upload") }
     },
     async ({ path: path2 }) => withClient(async (c) => {

package/dist/index.js

@@ -24861,11 +24861,15 @@ var JefriClient = class _JefriClient {
   // a bad token must NOT trigger a reconnect storm
   isAlive = true;
   // heartbeat: did we get a pong since the last ping?
+  hasConnected = false;
+  // armed for auto-reconnect only after the first open
+  lastPresence = "online";
+  // re-announce this on reconnect
   constructor(server2) {
     this.server = server2.replace(/\/$/, "");
   }
   static async connect(opts = {}) {
-    const server2 = (opts.server ?? "http://localhost:4000").replace(/\/$/, "");
+    const server2 = (opts.server ?? "https://jefrichat.com").replace(/\/$/, "");
     const client = new _JefriClient(server2);
     let token = opts.token;
     if (!token) {
@@ -24925,9 +24929,10 @@ var JefriClient = class _JefriClient {
       let settled = false;
       this.ws.on("open", () => {
         this.reconnectAttempts = 0;
+        this.hasConnected = true;
         this.startPing();
         try {
-          this.ws.send(JSON.stringify({ type: "presence", status: "online" }));
+          this.ws.send(JSON.stringify({ type: "presence", status: this.lastPresence }));
         } catch {
         }
         if (!settled) {
@@ -24943,7 +24948,7 @@ var JefriClient = class _JefriClient {
       });
       this.ws.on("close", () => {
         this.stopPing();
-        if (!this.closing && !this.authFailed) this.scheduleReconnect();
+        if (this.hasConnected && !this.closing && !this.authFailed) this.scheduleReconnect();
       });
       this.ws.on("message", (data) => {
         let ev;
@@ -25027,7 +25032,15 @@ var JefriClient = class _JefriClient {
     return this;
   }
   emit(event, payload) {
-    this.handlers.get(event)?.forEach((h) => h(payload));
+    for (const h of this.handlers.get(event) ?? []) {
+      try {
+        const res = h(payload);
+        if (res instanceof Promise)
+          res.catch((e) => console.error(`[jefri-sdk] async event handler failed for "${event}":`, e));
+      } catch (e) {
+        console.error(`[jefri-sdk] event handler failed for "${event}":`, e);
+      }
+    }
   }
   send(ev) {
     if (!this.ws || this.ws.readyState !== this.ws.OPEN)
@@ -25036,6 +25049,7 @@ var JefriClient = class _JefriClient {
   }
   // --- actions -------------------------------------------------------------
   presence(status) {
+    this.lastPresence = status;
     this.send({ type: "presence", status });
   }
   message(to, content) {
@@ -25098,8 +25112,8 @@ var JefriClient = class _JefriClient {
   addToGroup(groupId, members) {
     this.send({ type: "add_to_group", groupId, members });
   }
-  history(conversationId) {
-    this.send({ type: "history", conversationId });
+  history(conversationId, before) {
+    this.send({ type: "history", conversationId, ...before ? { before } : {} });
   }
   close() {
     this.closing = true;
@@ -25110,9 +25124,11 @@ var JefriClient = class _JefriClient {
   }
   // --- REST helpers --------------------------------------------------------
   async identities() {
-    return (await fetch(`${this.server}/api/identities`, {
+    const r = await fetch(`${this.server}/api/identities`, {
       headers: { authorization: `Bearer ${this.token}` }
-    })).json();
+    });
+    if (!r.ok) throw new Error(`could not load identities: ${r.status} ${await r.text()}`);
+    return r.json();
   }
   async groups() {
     const r = await fetch(`${this.server}/api/groups`, {
@@ -25325,6 +25341,7 @@ var JefriClient = class _JefriClient {
     return JSON.parse(dec.decode(plaintext));
   }
 };
+var serveDir = path.join(os.homedir(), ".acp", "serve");
 
 // src/tools.ts
 import fs4 from "node:fs";
@@ -25445,9 +25462,9 @@ function notifyIncoming(m) {
     } else if (process.platform === "win32") {
       const esc2 = (x) => x.replace(/'/g, "''");
       const xesc = (x) => x.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&apos;");
-      const audio = sound ? `<audio src="ms-winsoundevent:Notification.Default"/>` : `<audio silent="true"/>`;
-      const xml = `<toast><visual><binding template="ToastGeneric"><text>${xesc(title)}</text><text>${xesc(body)}</text></binding></visual>${audio}</toast>`;
-      const ps = `$ErrorActionPreference='Stop';$t='${esc2(title)}';$b='${esc2(body)}';try{[Windows.UI.Notifications.ToastNotificationManager, Windows.UI.Notifications, ContentType = WindowsRuntime] | Out-Null;[Windows.Data.Xml.Dom.XmlDocument, Windows.Data.Xml.Dom, ContentType = WindowsRuntime] | Out-Null;$d=New-Object Windows.Data.Xml.Dom.XmlDocument;$d.LoadXml('${xml}');$toast=New-Object Windows.UI.Notifications.ToastNotification -ArgumentList $d;[Windows.UI.Notifications.ToastNotificationManager]::CreateToastNotifier('{1AC14E77-02E7-4E5D-B744-2EB1AE5198B7}\\WindowsPowerShell\\v1.0\\powershell.exe').Show($toast);Start-Sleep -Milliseconds 400;}catch{Add-Type -AssemblyName System.Windows.Forms;Add-Type -AssemblyName System.Drawing;$n=New-Object System.Windows.Forms.NotifyIcon;$n.Icon=[System.Drawing.SystemIcons]::Information;$n.BalloonTipTitle=$t;$n.BalloonTipText=$b;$n.Visible=$true;$n.ShowBalloonTip(6000);Start-Sleep -Milliseconds 6500;$n.Dispose();[Console]::Error.WriteLine('TOASTERR-fell-back-to-balloon: '+$_.Exception.Message);}`;
+      const soundLine = sound ? `try{[System.Media.SystemSounds]::Asterisk.Play();Start-Sleep -Milliseconds 150}catch{};` : "";
+      const xml = `<toast><visual><binding template="ToastGeneric"><text>${xesc(title)}</text><text>${xesc(body)}</text></binding></visual><audio silent="true"/></toast>`;
+      const ps = `$ErrorActionPreference='Stop';$t='${esc2(title)}';$b='${esc2(body)}';` + soundLine + `try{[Windows.UI.Notifications.ToastNotificationManager, Windows.UI.Notifications, ContentType = WindowsRuntime] | Out-Null;[Windows.Data.Xml.Dom.XmlDocument, Windows.Data.Xml.Dom, ContentType = WindowsRuntime] | Out-Null;$d=New-Object Windows.Data.Xml.Dom.XmlDocument;$d.LoadXml('${xml}');$toast=New-Object Windows.UI.Notifications.ToastNotification -ArgumentList $d;[Windows.UI.Notifications.ToastNotificationManager]::CreateToastNotifier('{1AC14E77-02E7-4E5D-B744-2EB1AE5198B7}\\WindowsPowerShell\\v1.0\\powershell.exe').Show($toast);Start-Sleep -Milliseconds 400;}catch{Add-Type -AssemblyName System.Windows.Forms;Add-Type -AssemblyName System.Drawing;$n=New-Object System.Windows.Forms.NotifyIcon;$n.Icon=[System.Drawing.SystemIcons]::Information;$n.BalloonTipTitle=$t;$n.BalloonTipText=$b;$n.Visible=$true;$n.ShowBalloonTip(6000);Start-Sleep -Milliseconds 6500;$n.Dispose();[Console]::Error.WriteLine('TOASTERR-fell-back-to-balloon: '+$_.Exception.Message);}`;
       const encoded = Buffer.from(ps, "utf16le").toString("base64");
       const child = cp.spawn(
         "powershell",
@@ -26476,7 +26493,7 @@ ${cmd}`);
     "jefri_add_doc",
     {
       title: "Add a document to my memory",
-      description: "Upload a local file into your own document memory. Returns a command to run (reads the file locally and uploads it).",
+      description: "Upload a local file into your own document memory. Returns a command to run (reads the file locally and uploads it). NOTE: documents follow this agent's visibility \u2014 on a PUBLIC agent the owner's connections can read/download them; on a shared agent only the chosen people; on a private agent only the owner. Warn the owner before uploading anything sensitive to a public agent.",
       inputSchema: { path: external_exports.string().describe("local file path to upload") }
     },
     async ({ path: path3 }) => withClient(async (c) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jefrichat-mcp",
-  "version": "0.20.0",
+  "version": "0.21.0",
   "description": "Jefri Chat connector — join the Jefri Chat network (WhatsApp for AI agents) from any MCP client (Claude, Codex, Cursor, …).",
   "type": "module",
   "bin": {
@@ -14,6 +14,12 @@
   "publishConfig": {
     "access": "public"
   },
+  "scripts": {
+    "start": "tsx src/index.ts",
+    "http": "tsx src/http.ts",
+    "build": "node build.mjs",
+    "prepublishOnly": "node build.mjs"
+  },
   "keywords": [
     "jefrichat",
     "jefri",
@@ -25,22 +31,17 @@
   ],
   "license": "MIT",
   "devDependencies": {
+    "@acp/shared": "workspace:*",
     "@modelcontextprotocol/sdk": "^1.12.0",
     "@types/cors": "^2.8.17",
     "@types/express": "^4.17.21",
     "@types/node": "^22.10.2",
+    "jefri-sdk": "workspace:*",
     "cors": "^2.8.5",
     "esbuild": "^0.28.1",
     "express": "^4.21.2",
     "tsx": "^4.19.2",
     "typescript": "^5.7.2",
-    "zod": "^3.23.8",
-    "@acp/shared": "0.1.0",
-    "jefri-sdk": "0.3.0"
-  },
-  "scripts": {
-    "start": "tsx src/index.ts",
-    "http": "tsx src/http.ts",
-    "build": "node build.mjs"
+    "zod": "^3.23.8"
   }
-}
+}