jefrichat-mcp 0.4.0 → 0.6.0

package/dist/http.js

@@ -49397,6 +49397,61 @@ var MIME = {
   ".zip": "application/zip"
 };
 var mimeOf = (name) => MIME[np.extname(name).toLowerCase()] ?? "application/octet-stream";
+function screenshotDir() {
+  try {
+    const out = cp.execFileSync("defaults", ["read", "com.apple.screencapture", "location"], { encoding: "utf8", timeout: 2e3 }).trim();
+    if (out) return out.startsWith("~") ? np.join(os2.homedir(), out.slice(1)) : out;
+  } catch {
+  }
+  const desktop = np.join(os2.homedir(), "Desktop");
+  return fs2.existsSync(desktop) ? desktop : null;
+}
+function resolveLocalFile(rawPath) {
+  const expand = (p) => p.startsWith("~") ? np.join(os2.homedir(), p.slice(1)) : p;
+  const exists = (p) => {
+    try {
+      return fs2.existsSync(p) ? p : null;
+    } catch {
+      return null;
+    }
+  };
+  const abs = expand(rawPath);
+  let hit = exists(abs);
+  if (hit) return hit;
+  const UNI = /[    ⁠]/g;
+  for (const v of [abs.replace(/ /g, "\u202F"), abs.replace(UNI, " "), abs.replace(/ (AM|PM)(\.[a-z0-9]+)?$/i, "\u202F$1$2")]) {
+    hit = exists(v);
+    if (hit) return hit;
+  }
+  const base = np.basename(abs);
+  const looksLikeShot = /screencaptureui/i.test(abs) || /^Screenshot[\s  ]/i.test(base);
+  if (looksLikeShot) {
+    const dir = screenshotDir();
+    if (dir) {
+      let files = [];
+      try {
+        files = fs2.readdirSync(dir);
+      } catch {
+      }
+      const norm = (s) => s.replace(/[    ⁠\s]+/g, " ").trim().toLowerCase();
+      const want = norm(base);
+      for (const f of files) if (norm(f) === want) {
+        hit = exists(np.join(dir, f));
+        if (hit) return hit;
+      }
+      const shots = files.filter((f) => /^Screenshot[\s  ].*\.(png|jpe?g)$/i.test(f)).map((f) => {
+        const p = np.join(dir, f);
+        try {
+          return { p, m: fs2.statSync(p).mtimeMs };
+        } catch {
+          return { p, m: 0 };
+        }
+      }).filter((x) => x.m > 0).sort((a, b) => b.m - a.m);
+      if (shots.length && Date.now() - shots[0].m < 5 * 60 * 1e3) return shots[0].p;
+    }
+  }
+  return null;
+}
 var MAX_UPLOAD_BYTES = 100 * 1024 * 1024;
 var MB = (n) => (n / 1024 / 1024).toFixed(1);
 var WS_SAFE_FILE_BYTES = 45 * 1024 * 1024;
@@ -49541,8 +49596,8 @@ ${fp}`);
             `I can't read local files from the cloud connector. Use a local/stdin Jefri Chat connector, or open the web chat and drop the file there.`
           );
         }
-        const abs = path2.startsWith("~") ? np.join(os2.homedir(), path2.slice(1)) : path2;
-        if (!fs2.existsSync(abs)) {
+        const abs = resolveLocalFile(path2);
+        if (!abs) {
           return fail(
             `I can't find a file at ${path2} on this machine.`
           );
@@ -49602,8 +49657,8 @@ ${fp}`);
             `I can't read local files from the cloud connector. Use a local/stdin Jefri Chat connector, or open the web chat and drop the file there.`
           );
         }
-        const abs = path2.startsWith("~") ? np.join(os2.homedir(), path2.slice(1)) : path2;
-        if (!fs2.existsSync(abs)) {
+        const abs = resolveLocalFile(path2);
+        if (!abs) {
           return fail(
             `I can't find a file at ${path2} on this machine.`
           );
@@ -49662,8 +49717,8 @@ ${psCmd}
 (Alternatively the user can drag "${fname}" straight into the chat: ${dropLink})`
           );
         }
-        const abs = path2.startsWith("~") ? np.join(os2.homedir(), path2.slice(1)) : path2;
-        if (!fs2.existsSync(abs)) {
+        const abs = resolveLocalFile(path2);
+        if (!abs) {
           return fail(`I can't find a file at ${path2} on this machine.`);
         }
         const buf = fs2.readFileSync(abs);
@@ -50207,8 +50262,8 @@ ${cmd}`);
 ${cmd}`
           );
         }
-        const abs = path2.startsWith("~") ? np.join(os2.homedir(), path2.slice(1)) : path2;
-        if (!fs2.existsSync(abs)) return fail(`I can't find a file at ${path2} on this machine.`);
+        const abs = resolveLocalFile(path2);
+        if (!abs) return fail(`I can't find a file at ${path2} on this machine.`);
         const buf = fs2.readFileSync(abs);
         name = np.basename(abs);
         mime = mimeOf(name);
@@ -50243,19 +50298,22 @@ ${cmd}`
     "jefri_history",
     {
       title: "Read conversation history",
-      description: "Read the recent message history of your DM thread with a given user.",
+      description: "Read the recent message history of a conversation \u2014 either a DM (pass `with` = a username) or a GROUP (pass `groupId`, from jefri_groups). Shows past messages AND any files/images (with how to download them).",
       inputSchema: {
-        with: external_exports.string().describe("the other person's username"),
+        with: external_exports.string().optional().describe("the other person's username (for a DM)"),
+        groupId: external_exports.string().optional().describe("a group's id (for group history) \u2014 from jefri_groups"),
         limit: external_exports.number().optional().describe("max messages to return (default 20)")
       }
     },
-    async ({ with: other, limit }) => withClient(async (c) => {
-      const convId = dmConversationId(c.identity.username, other);
+    async ({ with: other, groupId, limit }) => withClient(async (c) => {
+      if (!other && !groupId) return fail("Give `with` (a username, for a DM) or `groupId` (for a group).");
+      const convId = groupId ? groupConversationId(groupId) : dmConversationId(c.identity.username, other);
+      const label = groupId ? "this group" : `@${other}`;
       const p = waitFor(c, "history", (e) => e.conversationId === convId);
       c.history(convId);
       const res = await p;
       const msgs = (res?.messages ?? []).slice(-(limit ?? 20));
-      if (!msgs.length) return ok(`No messages yet with @${other}.`);
+      if (!msgs.length) return ok(`No messages yet in ${label}.`);
       const lines = await Promise.all(msgs.map(async (m) => {
         if (m.encryptionMode === "private_e2e" && m.encryptedPayload) {
           try {
@@ -50265,7 +50323,11 @@ ${cmd}`
             return `${m.senderUsername}: \u{1F512} Private message unavailable on this device`;
           }
         }
-        return `${m.senderUsername}: ${m.kind === "file" ? `\u{1F4CE} ${m.fileName}` : m.content}`;
+        if (m.kind === "file") {
+          const dl = groupId ? `jefri_download_file(groupId: "${groupId}", fileName: "${m.fileName}")` : `jefri_download_file(from: "${m.senderUsername}", fileName: "${m.fileName}")`;
+          return `${m.senderUsername}: \u{1F4CE} ${m.fileName} \u2014 to save it call ${dl}`;
+        }
+        return `${m.senderUsername}: ${m.content}`;
       }));
       return ok(lines.join("\n"));
     })
@@ -50332,10 +50394,16 @@ ${cmd}`
     })
   );
 }
-function attachInbox(c, inbox, self) {
+function attachInbox(c, inbox, self, onIncoming) {
   const capture = (e) => {
     const m = e.message;
-    if (m.senderUsername !== self) inbox.push(m);
+    if (m.senderUsername !== self) {
+      inbox.push(m);
+      try {
+        onIncoming?.(m);
+      } catch {
+      }
+    }
   };
   c.on("message_received", capture);
   c.on("file_received", capture);

package/dist/index.js

@@ -25305,6 +25305,61 @@ var MIME = {
   ".zip": "application/zip"
 };
 var mimeOf = (name) => MIME[np.extname(name).toLowerCase()] ?? "application/octet-stream";
+function screenshotDir() {
+  try {
+    const out = cp.execFileSync("defaults", ["read", "com.apple.screencapture", "location"], { encoding: "utf8", timeout: 2e3 }).trim();
+    if (out) return out.startsWith("~") ? np.join(os2.homedir(), out.slice(1)) : out;
+  } catch {
+  }
+  const desktop = np.join(os2.homedir(), "Desktop");
+  return fs2.existsSync(desktop) ? desktop : null;
+}
+function resolveLocalFile(rawPath) {
+  const expand = (p) => p.startsWith("~") ? np.join(os2.homedir(), p.slice(1)) : p;
+  const exists = (p) => {
+    try {
+      return fs2.existsSync(p) ? p : null;
+    } catch {
+      return null;
+    }
+  };
+  const abs = expand(rawPath);
+  let hit = exists(abs);
+  if (hit) return hit;
+  const UNI = /[    ⁠]/g;
+  for (const v of [abs.replace(/ /g, "\u202F"), abs.replace(UNI, " "), abs.replace(/ (AM|PM)(\.[a-z0-9]+)?$/i, "\u202F$1$2")]) {
+    hit = exists(v);
+    if (hit) return hit;
+  }
+  const base = np.basename(abs);
+  const looksLikeShot = /screencaptureui/i.test(abs) || /^Screenshot[\s  ]/i.test(base);
+  if (looksLikeShot) {
+    const dir = screenshotDir();
+    if (dir) {
+      let files = [];
+      try {
+        files = fs2.readdirSync(dir);
+      } catch {
+      }
+      const norm = (s) => s.replace(/[    ⁠\s]+/g, " ").trim().toLowerCase();
+      const want = norm(base);
+      for (const f of files) if (norm(f) === want) {
+        hit = exists(np.join(dir, f));
+        if (hit) return hit;
+      }
+      const shots = files.filter((f) => /^Screenshot[\s  ].*\.(png|jpe?g)$/i.test(f)).map((f) => {
+        const p = np.join(dir, f);
+        try {
+          return { p, m: fs2.statSync(p).mtimeMs };
+        } catch {
+          return { p, m: 0 };
+        }
+      }).filter((x) => x.m > 0).sort((a, b) => b.m - a.m);
+      if (shots.length && Date.now() - shots[0].m < 5 * 60 * 1e3) return shots[0].p;
+    }
+  }
+  return null;
+}
 var MAX_UPLOAD_BYTES = 100 * 1024 * 1024;
 var MB = (n) => (n / 1024 / 1024).toFixed(1);
 var WS_SAFE_FILE_BYTES = 45 * 1024 * 1024;
@@ -25449,8 +25504,8 @@ ${fp}`);
             `I can't read local files from the cloud connector. Use a local/stdin Jefri Chat connector, or open the web chat and drop the file there.`
           );
         }
-        const abs = path3.startsWith("~") ? np.join(os2.homedir(), path3.slice(1)) : path3;
-        if (!fs2.existsSync(abs)) {
+        const abs = resolveLocalFile(path3);
+        if (!abs) {
           return fail(
             `I can't find a file at ${path3} on this machine.`
           );
@@ -25510,8 +25565,8 @@ ${fp}`);
             `I can't read local files from the cloud connector. Use a local/stdin Jefri Chat connector, or open the web chat and drop the file there.`
           );
         }
-        const abs = path3.startsWith("~") ? np.join(os2.homedir(), path3.slice(1)) : path3;
-        if (!fs2.existsSync(abs)) {
+        const abs = resolveLocalFile(path3);
+        if (!abs) {
           return fail(
             `I can't find a file at ${path3} on this machine.`
           );
@@ -25570,8 +25625,8 @@ ${psCmd}
 (Alternatively the user can drag "${fname}" straight into the chat: ${dropLink})`
           );
         }
-        const abs = path3.startsWith("~") ? np.join(os2.homedir(), path3.slice(1)) : path3;
-        if (!fs2.existsSync(abs)) {
+        const abs = resolveLocalFile(path3);
+        if (!abs) {
           return fail(`I can't find a file at ${path3} on this machine.`);
         }
         const buf = fs2.readFileSync(abs);
@@ -26115,8 +26170,8 @@ ${cmd}`);
 ${cmd}`
           );
         }
-        const abs = path3.startsWith("~") ? np.join(os2.homedir(), path3.slice(1)) : path3;
-        if (!fs2.existsSync(abs)) return fail(`I can't find a file at ${path3} on this machine.`);
+        const abs = resolveLocalFile(path3);
+        if (!abs) return fail(`I can't find a file at ${path3} on this machine.`);
         const buf = fs2.readFileSync(abs);
         name = np.basename(abs);
         mime = mimeOf(name);
@@ -26151,19 +26206,22 @@ ${cmd}`
     "jefri_history",
     {
       title: "Read conversation history",
-      description: "Read the recent message history of your DM thread with a given user.",
+      description: "Read the recent message history of a conversation \u2014 either a DM (pass `with` = a username) or a GROUP (pass `groupId`, from jefri_groups). Shows past messages AND any files/images (with how to download them).",
       inputSchema: {
-        with: external_exports.string().describe("the other person's username"),
+        with: external_exports.string().optional().describe("the other person's username (for a DM)"),
+        groupId: external_exports.string().optional().describe("a group's id (for group history) \u2014 from jefri_groups"),
         limit: external_exports.number().optional().describe("max messages to return (default 20)")
       }
     },
-    async ({ with: other, limit }) => withClient(async (c) => {
-      const convId = dmConversationId(c.identity.username, other);
+    async ({ with: other, groupId, limit }) => withClient(async (c) => {
+      if (!other && !groupId) return fail("Give `with` (a username, for a DM) or `groupId` (for a group).");
+      const convId = groupId ? groupConversationId(groupId) : dmConversationId(c.identity.username, other);
+      const label = groupId ? "this group" : `@${other}`;
       const p = waitFor(c, "history", (e) => e.conversationId === convId);
       c.history(convId);
       const res = await p;
       const msgs = (res?.messages ?? []).slice(-(limit ?? 20));
-      if (!msgs.length) return ok(`No messages yet with @${other}.`);
+      if (!msgs.length) return ok(`No messages yet in ${label}.`);
       const lines = await Promise.all(msgs.map(async (m) => {
         if (m.encryptionMode === "private_e2e" && m.encryptedPayload) {
           try {
@@ -26173,7 +26231,11 @@ ${cmd}`
             return `${m.senderUsername}: \u{1F512} Private message unavailable on this device`;
           }
         }
-        return `${m.senderUsername}: ${m.kind === "file" ? `\u{1F4CE} ${m.fileName}` : m.content}`;
+        if (m.kind === "file") {
+          const dl = groupId ? `jefri_download_file(groupId: "${groupId}", fileName: "${m.fileName}")` : `jefri_download_file(from: "${m.senderUsername}", fileName: "${m.fileName}")`;
+          return `${m.senderUsername}: \u{1F4CE} ${m.fileName} \u2014 to save it call ${dl}`;
+        }
+        return `${m.senderUsername}: ${m.content}`;
       }));
       return ok(lines.join("\n"));
     })
@@ -26240,15 +26302,49 @@ ${cmd}`
     })
   );
 }
-function attachInbox(c, inbox2, self) {
+function attachInbox(c, inbox2, self, onIncoming) {
   const capture = (e) => {
     const m = e.message;
-    if (m.senderUsername !== self) inbox2.push(m);
+    if (m.senderUsername !== self) {
+      inbox2.push(m);
+      try {
+        onIncoming?.(m);
+      } catch {
+      }
+    }
   };
   c.on("message_received", capture);
   c.on("file_received", capture);
 }
 
+// src/notify.ts
+import cp2 from "node:child_process";
+var OFF = process.env.JEFRI_NOTIFY === "0" || process.env.JEFRI_NOTIFY === "false";
+var clean = (s) => (s || "").replace(/[\r\n\t]+/g, " ").replace(/[\x00-\x1F]/g, "").slice(0, 140).trim();
+function notifyIncoming(title, body) {
+  if (OFF) return;
+  const t = clean(title) || "Jefri Chat";
+  const b = clean(body);
+  try {
+    process.stderr.write("\x07");
+  } catch {
+  }
+  try {
+    if (process.platform === "darwin") {
+      const esc2 = (x) => x.replace(/\\/g, "\\\\").replace(/"/g, '\\"');
+      const script = `display notification "${esc2(b)}" with title "${esc2(t)}" sound name "Ping"`;
+      cp2.spawn("osascript", ["-e", script], { stdio: "ignore", detached: true }).unref();
+    } else if (process.platform === "win32") {
+      const esc2 = (x) => x.replace(/'/g, "''");
+      const ps = `Add-Type -AssemblyName System.Windows.Forms;$n=New-Object System.Windows.Forms.NotifyIcon;$n.Icon=[System.Drawing.SystemIcons]::Information;$n.BalloonTipTitle='${esc2(t)}';$n.BalloonTipText='${esc2(b)}';$n.Visible=$true;$n.ShowBalloonTip(6000);Start-Sleep -Milliseconds 6500;$n.Dispose()`;
+      cp2.spawn("powershell", ["-NoProfile", "-WindowStyle", "Hidden", "-Command", ps], { stdio: "ignore", detached: true }).unref();
+    } else {
+      cp2.spawn("notify-send", ["-a", "Jefri Chat", t, b], { stdio: "ignore", detached: true }).unref();
+    }
+  } catch {
+  }
+}
+
 // src/index.ts
 var SERVER = process.env.ACP_SERVER ?? "http://localhost:4000";
 var TOKEN = process.env.ACP_TOKEN;
@@ -26302,7 +26398,19 @@ function ensureClient() {
         if (c.identity) cacheToken(c.token);
       }
       const self = c.identity?.username ?? USERNAME;
-      attachInbox(c, inbox, self);
+      const groupNames = /* @__PURE__ */ new Map();
+      const refreshGroups = () => c.groups().then((gs) => {
+        groupNames.clear();
+        for (const g of gs) groupNames.set(g.id, g.name);
+      }).catch(() => {
+      });
+      void refreshGroups();
+      setInterval(refreshGroups, 6e4).unref?.();
+      attachInbox(c, inbox, self, (m) => {
+        const preview = m.kind === "file" ? `\u{1F4CE} ${m.fileName ?? "file"}` : m.content ?? "";
+        const where = m.groupId ? ` \xB7 ${groupNames.get(m.groupId) ?? "group"}` : "";
+        notifyIncoming("Jefri Chat", `${m.senderUsername}${where}: ${preview}`);
+      });
       log(`connected to ${SERVER} as ${self}`);
       return c;
     })().catch((e) => {

package/package.json

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