jefrichat-mcp 0.3.0 → 0.5.0

package/README.md

@@ -1,4 +1,4 @@
-# acp-mcp
+# jefrichat-mcp
 
 The **ACP connector** — join the [Agent Communication Protocol](https://github.com/) network
 from any MCP client (Claude Code, Claude Desktop, Codex, Cursor, …). It gives your
@@ -11,7 +11,7 @@ Create an agent in your ACP web app to get a **token**, then:
 
 ### Claude Code (local, via npx)
 ```bash
-claude mcp add acp -e ACP_SERVER=https://your-hub -e ACP_TOKEN=acp_xxx -- npx -y acp-mcp
+claude mcp add acp -e ACP_SERVER=https://your-hub -e ACP_TOKEN=acp_xxx -- npx -y jefrichat-mcp
 ```
 
 ### Claude Desktop / Codex / Cursor (config)
@@ -20,7 +20,7 @@ claude mcp add acp -e ACP_SERVER=https://your-hub -e ACP_TOKEN=acp_xxx -- npx -y
   "mcpServers": {
     "acp": {
       "command": "npx",
-      "args": ["-y", "acp-mcp"],
+      "args": ["-y", "jefrichat-mcp"],
       "env": { "ACP_SERVER": "https://your-hub", "ACP_TOKEN": "acp_xxx" }
     }
   }
@@ -29,7 +29,7 @@ claude mcp add acp -e ACP_SERVER=https://your-hub -e ACP_TOKEN=acp_xxx -- npx -y
 
 ### Remote / ChatGPT (no install)
 Point your client at the hosted remote MCP URL with `Authorization: Bearer acp_xxx`
-— or run your own with `npx acp-mcp-http`.
+— or run your own with `npx jefrichat-mcp-http`.
 
 ## Env
 | var | meaning |
@@ -40,7 +40,7 @@ Point your client at the hosted remote MCP URL with `Authorization: Bearer acp_x
 | `ACP_NAME`, `ACP_TAGS` | display name / tags when using `ACP_AS` |
 
 ## Tools
-`acp_whoami`, `acp_agents`, `acp_send`, `acp_inbox`, `acp_history`, `acp_search`,
-`acp_create_task`, `acp_assign_task`, `acp_set_status`.
+`jefri_whoami`, `jefri_agents`, `jefri_send`, `jefri_inbox`, `jefri_history`, `jefri_search`,
+`jefri_create_task`, `jefri_assign_task`, `jefri_set_status`.
 
 MIT

package/dist/http.js

@@ -48905,6 +48905,9 @@ import { webcrypto } from "node:crypto";
 function dmConversationId(a, b) {
   return "dm:" + [a, b].sort().join(":");
 }
+function groupConversationId(groupId) {
+  return "group:" + groupId;
+}
 
 // ../sdk/src/index.ts
 var subtle = webcrypto.subtle;
@@ -49035,7 +49038,7 @@ var AcpClient = class _AcpClient {
       });
     });
   }
-  // Keep the hub connection alive through idle-timeout proxies (Azure ingress).
+  // Keep the hub connection alive through idle-timeout proxies.
   startPing() {
     this.stopPing();
     this.pingTimer = setInterval(() => {
@@ -49394,13 +49397,71 @@ 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;
-async function uploadFileHttp(c, serverUrl, to, fileName, mime, bytes, caption) {
+async function uploadFileHttp(c, serverUrl, target, fileName, mime, bytes, caption) {
   const hub = serverUrl.replace(/\/$/, "");
-  const q = `to=${encodeURIComponent(to)}&fileName=${encodeURIComponent(fileName)}` + (caption ? `&caption=${encodeURIComponent(caption)}` : "");
-  const res = await fetch(`${hub}/api/files?${q}`, {
+  const params = new URLSearchParams({ fileName });
+  if (target.to) params.set("to", target.to);
+  if (target.groupId) params.set("groupId", target.groupId);
+  if (caption) params.set("caption", caption);
+  const res = await fetch(`${hub}/api/files?${params.toString()}`, {
     method: "POST",
     headers: { Authorization: `Bearer ${c.token}`, "Content-Type": mime },
     body: Buffer.from(bytes)
@@ -49428,6 +49489,8 @@ var ok = (text) => ({ content: [{ type: "text", text }] });
 var fail = (text) => ({ content: [{ type: "text", text }], isError: true });
 var inboxWatermark = /* @__PURE__ */ new Map();
 function registerAcpTools(server, ctx) {
+  const ENABLE_E2E = process.env.ACP_ENABLE_E2E === "true";
+  const e2eServer = ENABLE_E2E ? server : { registerTool: () => void 0 };
   const withClient = async (fn) => {
     try {
       const c = await ctx.ensureClient();
@@ -49481,7 +49544,7 @@ ${e?.message ?? e}`);
       return ok(`Sent to @${to}: "${text}"`);
     })
   );
-  server.registerTool(
+  e2eServer.registerTool(
     "jefri_send_private",
     {
       title: "Send a private (client-encrypted) message",
@@ -49499,7 +49562,7 @@ ${e?.message ?? e}`);
       return ok(`Sent private E2E message to @${to}.`);
     })
   );
-  server.registerTool(
+  e2eServer.registerTool(
     "jefri_e2e_fingerprint",
     {
       title: "Show E2E key fingerprint",
@@ -49512,7 +49575,7 @@ ${e?.message ?? e}`);
 ${fp}`);
     })
   );
-  server.registerTool(
+  e2eServer.registerTool(
     "jefri_send_private_file",
     {
       title: "Send a private (client-encrypted) file",
@@ -49528,10 +49591,15 @@ ${fp}`);
     async ({ to, path: path2, dataUrl, fileName, caption }) => withClient(async (c) => {
       let name, mime, url;
       if (path2) {
-        const abs = path2.startsWith("~") ? np.join(process.env.HOME ?? "", path2.slice(1)) : path2;
-        if (!fs2.existsSync(abs)) {
+        if (!ctx.local) {
           return fail(
-            `I can't read that local file from this connector. Use a local/stdin Jefri Chat connector or open the web chat and drop the file there.`
+            `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 = resolveLocalFile(path2);
+        if (!abs) {
+          return fail(
+            `I can't find a file at ${path2} on this machine.`
           );
         }
         const buf = fs2.readFileSync(abs);
@@ -49550,7 +49618,7 @@ ${fp}`);
       return ok(`Sent private E2E file to @${to}.`);
     })
   );
-  server.registerTool(
+  e2eServer.registerTool(
     "jefri_send_private_group",
     {
       title: "Send a private (client-encrypted) group message",
@@ -49568,7 +49636,7 @@ ${fp}`);
       return ok(`Sent private E2E group message.`);
     })
   );
-  server.registerTool(
+  e2eServer.registerTool(
     "jefri_send_private_group_file",
     {
       title: "Send a private (client-encrypted) group file",
@@ -49584,10 +49652,15 @@ ${fp}`);
     async ({ groupId, path: path2, dataUrl, fileName, caption }) => withClient(async (c) => {
       let name, mime, url;
       if (path2) {
-        const abs = path2.startsWith("~") ? np.join(process.env.HOME ?? "", path2.slice(1)) : path2;
-        if (!fs2.existsSync(abs)) {
+        if (!ctx.local) {
+          return fail(
+            `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 = resolveLocalFile(path2);
+        if (!abs) {
           return fail(
-            `I can't read that local file from this connector. Use a local/stdin Jefri Chat connector or open the web chat and drop the file there.`
+            `I can't find a file at ${path2} on this machine.`
           );
         }
         const buf = fs2.readFileSync(abs);
@@ -49622,25 +49695,32 @@ ${fp}`);
     async ({ to, path: path2, caption, dataUrl, fileName }) => withClient(async (c) => {
       let name, mime, url;
       if (path2) {
-        const abs = path2.startsWith("~") ? np.join(process.env.HOME ?? "", path2.slice(1)) : path2;
-        if (!fs2.existsSync(abs)) {
-          const fname = np.basename(abs);
+        if (!ctx.local) {
+          const fname = np.basename(path2);
           const fmime = mimeOf(fname);
           const hub = ctx.serverUrl.replace(/\/$/, "");
           const web = hub.replace("acp-hub.", "acp-web.").replace(":4000", ":4321");
           const dropLink = `${web}/?to=${encodeURIComponent(to)}`;
           const q = `to=${encodeURIComponent(to)}&fileName=${encodeURIComponent(fname)}` + (caption ? `&caption=${encodeURIComponent(caption)}` : "");
-          const cmd = `curl -s -X POST ${shq(`${hub}/api/files?${q}`)} -H "Authorization: Bearer ${c.token}" -H "Content-Type: ${fmime}" --data-binary @${shq(path2)}`;
+          const uploadUrl = `${hub}/api/files?${q}`;
+          const cmd = `curl -s -X POST ${shq(uploadUrl)} -H "Authorization: Bearer ${c.token}" -H "Content-Type: ${fmime}" --data-binary @${shq(path2)}`;
+          const psCmd = `Invoke-RestMethod -Uri "${uploadUrl}" -Method Post -Headers @{ Authorization = "Bearer ${c.token}" } -ContentType "${fmime}" -InFile "${path2}"`;
           return fail(
-            `I can't read local files from here (this connector runs in the cloud), and sending your private files to another user's agent is gated for safety \u2014 so this needs to come from you.
+            `ASSISTANT: run the one command below in your shell to send this file \u2014 it reads the file locally and uploads it directly, fast, at any size. Do NOT read the file or base64 it into a tool call (that is slow and breaks on large files); just run this:
 
-\u2705 Easiest \u2014 open the chat and drop "${fname}" in:
-${dropLink}
+\u2022 macOS / Linux:
+${cmd}
 
-Or run this yourself in the terminal (reads + uploads it locally):
-${cmd}`
+\u2022 Windows (PowerShell \u2014 avoids the curl/schannel TLS error):
+${psCmd}
+
+(Alternatively the user can drag "${fname}" straight into the chat: ${dropLink})`
           );
         }
+        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);
@@ -49657,7 +49737,7 @@ ${cmd}`
         if (rawBytes.length > MAX_UPLOAD_BYTES)
           return fail(`${name} is ${MB(rawBytes.length)} MB, over the ${Math.round(MAX_UPLOAD_BYTES / 1024 / 1024)} MB limit.`);
         try {
-          await uploadFileHttp(c, ctx.serverUrl, to, name, mime, rawBytes, caption);
+          await uploadFileHttp(c, ctx.serverUrl, { to }, name, mime, rawBytes, caption);
         } catch (e2) {
           return fail(`Rejected: ${e2?.message ?? e2}`);
         }
@@ -49691,7 +49771,7 @@ ${cmd}`
         if (contentBytes.length > MAX_UPLOAD_BYTES)
           return fail(`That content is ${MB(contentBytes.length)} MB, over the ${Math.round(MAX_UPLOAD_BYTES / 1024 / 1024)} MB limit.`);
         try {
-          await uploadFileHttp(c, ctx.serverUrl, to, fileName, mime, contentBytes, caption);
+          await uploadFileHttp(c, ctx.serverUrl, { to }, fileName, mime, contentBytes, caption);
         } catch (e2) {
           return fail(`Rejected: ${e2?.message ?? e2}`);
         }
@@ -49723,7 +49803,7 @@ ${cmd}`
           `Sending a folder reads files off disk, which this connector can't do \u2014 it runs in the cloud. Run jefri_send_folder from a LOCAL agent (Claude Code with the stdio connector) inside the project.`
         );
       const rawDir = path2 && path2.trim() ? path2 : process.cwd();
-      const dir = rawDir.startsWith("~") ? np.join(process.env.HOME ?? "", rawDir.slice(1)) : rawDir;
+      const dir = rawDir.startsWith("~") ? np.join(os2.homedir(), rawDir.slice(1)) : rawDir;
       if (!fs2.existsSync(dir))
         return fail(
           `I can't see "${rawDir}" from here. Sending a folder reads it off disk, which only works on the LOCAL (stdio) connector \u2014 run this from Claude Code (or another local agent) inside the project.`
@@ -49808,27 +49888,42 @@ ${cmd}`
     "jefri_download_file",
     {
       title: "Download / save a file someone sent you",
-      description: "Save a file (PDF, image, video, any document) that another agent/user sent you, onto this machine. Give the sender's username `from` (and `fileName` if they sent several). Returns a ready-to-run command that downloads the file locally \u2014 run it in the terminal. Use this when the user says things like 'download that file', 'save the pdf antonio sent', etc.",
+      description: "Save a file (PDF, image, video, any document) that another agent/user sent you, onto this machine. For a DM give the sender's username `from`; for a file sent in a GROUP give `groupId` instead (from jefri_groups / jefri_inbox). Add `fileName` if there are several. Returns a ready-to-run command that downloads the file locally \u2014 run it in the terminal. Use this when the user says things like 'download that file', 'save the pdf antonio sent', etc.",
       inputSchema: {
-        from: external_exports.string().describe("who sent you the file (their username)"),
-        fileName: external_exports.string().optional().describe("which file, if there are several from them"),
+        from: external_exports.string().optional().describe("who sent you the file (their username) \u2014 for a DM"),
+        groupId: external_exports.string().optional().describe("the group's id \u2014 for a file sent in a group"),
+        fileName: external_exports.string().optional().describe("which file, if there are several"),
         savePath: external_exports.string().optional().describe("where to save it (default: the file's own name in the current folder)")
       }
     },
-    async ({ from, fileName, savePath }) => withClient(async (c) => {
-      const convId = dmConversationId(c.identity.username, from);
+    async ({ from, groupId, fileName, savePath }) => withClient(async (c) => {
+      if (!from && !groupId) return fail("Give `from` (a username, for a DM) or `groupId` (for a group file).");
+      const convId = groupId ? groupConversationId(groupId) : dmConversationId(c.identity.username, from);
+      const where = groupId ? "this group" : `@${from}`;
       const p = waitFor(c, "history", (e) => e.conversationId === convId, 4e3);
       c.history(convId);
       const res = await p;
       const files = (res?.messages ?? []).filter((m) => m.kind === "file");
-      if (!files.length) return fail(`No files from @${from} yet.`);
+      if (!files.length) return fail(`No files in ${where} yet.`);
       const match = fileName ? [...files].reverse().find((m) => m.fileName === fileName || m.fileName?.includes(fileName)) : files[files.length - 1];
-      if (!match) return fail(`No file named "${fileName}" from @${from}.`);
+      if (!match) return fail(`No file named "${fileName}" in ${where}.`);
       const hub = ctx.serverUrl.replace(/\/$/, "");
       const out = savePath || match.fileName || "downloaded.file";
+      if (ctx.local) {
+        const outPath = out.startsWith("~") ? np.join(os2.homedir(), out.slice(1)) : out;
+        try {
+          const r = await fetch(`${hub}/api/files/${match.id}`, { headers: { authorization: `Bearer ${c.token}` } });
+          if (!r.ok) throw new Error(`download failed (${r.status})`);
+          const buf = Buffer.from(await r.arrayBuffer());
+          fs2.writeFileSync(outPath, buf);
+          return ok(`\u2705 Saved \u{1F4CE} ${match.fileName} from ${where} to ${outPath} (${MB(buf.length)} MB).`);
+        } catch (e) {
+          return fail(`Couldn't save the file: ${e?.message ?? e}`);
+        }
+      }
       const cmd = `curl -s -o ${shq(out)} -H "Authorization: Bearer ${c.token}" ${shq(`${hub}/api/files/${match.id}`)}`;
       return ok(
-        `To save \u{1F4CE} ${match.fileName} from @${from}, run this in the terminal:
+        `To save \u{1F4CE} ${match.fileName} from ${where}, run this in the terminal:
 
 ${cmd}
 
@@ -50076,41 +50171,149 @@ ${cmd}`);
       if (!msgs.length) return ok("\u{1F4ED} No new messages.");
       msgs.sort((a, b) => a.createdAt < b.createdAt ? -1 : 1);
       inboxWatermark.set(me, msgs[msgs.length - 1].createdAt);
+      const groupNames = /* @__PURE__ */ new Map();
+      if (msgs.some((m) => m.groupId)) {
+        try {
+          for (const g of await c.groups()) groupNames.set(g.id, g.name);
+        } catch {
+        }
+      }
+      const where = (m) => {
+        if (!m.groupId) return "";
+        const name = groupNames.get(m.groupId);
+        return name ? ` (in group "${name}" \xB7 reply with jefri_send_group groupId="${m.groupId}")` : ` (in group id ${m.groupId})`;
+      };
       const lines = await Promise.all(msgs.map(async (m) => {
         if (m.encryptionMode === "private_e2e" && m.encryptedPayload) {
           try {
             const plain = await c.decryptPrivatePayload(m.encryptedPayload);
             const body2 = plain.kind === "file" ? `\u{1F512}\u{1F4CE} private file: ${plain.fileName ?? m.fileName}` : `\u{1F512} ${plain.content ?? ""}`;
-            return `@${m.senderUsername}${m.groupId ? " (in group)" : ""}: ${body2}`;
+            return `@${m.senderUsername}${where(m)}: ${body2}`;
           } catch {
-            return `@${m.senderUsername}${m.groupId ? " (in group)" : ""}: \u{1F512} Private message unavailable on this device`;
+            return `@${m.senderUsername}${where(m)}: \u{1F512} Private message unavailable on this device`;
           }
         }
         const body = m.kind === "file" ? `\u{1F4CE} sent a file: ${m.fileName} \u2014 to save it call jefri_download_file(from: "${m.senderUsername}"${m.fileName ? `, fileName: "${m.fileName}"` : ""})` : m.content;
-        const where = m.groupId ? ` (in group)` : "";
-        return `@${m.senderUsername}${where}: ${body}`;
+        return `@${m.senderUsername}${where(m)}: ${body}`;
       }));
       return ok(`\u{1F4E8} ${lines.length} message(s):
 ` + lines.join("\n"));
     })
   );
+  server.registerTool(
+    "jefri_groups",
+    {
+      title: "List your groups",
+      description: "List the groups you're a member of, with each group's id (needed to post to it) and its members. Use this to find a group's id before jefri_send_group.",
+      inputSchema: {}
+    },
+    async () => withClient(async (c) => {
+      const gs = await c.groups();
+      if (!gs.length) return ok("You're not in any groups yet.");
+      return ok(
+        `You're in ${gs.length} group(s):
+` + gs.map((g) => `\u2022 "${g.name}" \u2014 id: ${g.id} \u2014 ${g.memberUsernames.length} members: ${g.memberUsernames.join(", ")}`).join("\n")
+      );
+    })
+  );
+  server.registerTool(
+    "jefri_send_group",
+    {
+      title: "Send a group message",
+      description: "Post a message to a GROUP (everyone in the group sees it), by the group's id. Get the id from jefri_groups, or from jefri_inbox \u2014 it shows the id of the group any incoming group message came from. NOTE: this needs the group's id, not its display name.",
+      inputSchema: {
+        groupId: external_exports.string().describe("the group's id (from jefri_groups or jefri_inbox)"),
+        text: external_exports.string().describe("the message to post to the group")
+      }
+    },
+    async ({ groupId, text }) => withClient(async (c) => {
+      const err = waitFor(c, "error", () => true, 800);
+      c.groupMessage(groupId, text);
+      const e = await err;
+      if (e) return fail(`Couldn't post to the group: ${e.message}`);
+      return ok(`Posted to the group.`);
+    })
+  );
+  server.registerTool(
+    "jefri_send_group_file",
+    {
+      title: "Send a file to a group",
+      description: "Send a file/image to a GROUP by its group id. Give a local file `path` (works on the local/stdio connector) or a `dataUrl` + `fileName`. Get the group id from jefri_groups / jefri_inbox.",
+      inputSchema: {
+        groupId: external_exports.string().describe("the group's id (from jefri_groups or jefri_inbox)"),
+        path: external_exports.string().optional().describe("local file path, e.g. ~/Downloads/report.pdf"),
+        caption: external_exports.string().optional().describe("optional text caption"),
+        dataUrl: external_exports.string().optional().describe("alternatively, a data: URL of the file (small files only)"),
+        fileName: external_exports.string().optional().describe("file name when using dataUrl")
+      }
+    },
+    async ({ groupId, path: path2, caption, dataUrl, fileName }) => withClient(async (c) => {
+      let name, mime, url;
+      if (path2) {
+        if (!ctx.local) {
+          const hub = ctx.serverUrl.replace(/\/$/, "");
+          const fname = np.basename(path2);
+          const fmime = mimeOf(fname);
+          const q = `groupId=${encodeURIComponent(groupId)}&fileName=${encodeURIComponent(fname)}` + (caption ? `&caption=${encodeURIComponent(caption)}` : "");
+          const cmd = `curl -s -X POST ${shq(`${hub}/api/files?${q}`)} -H "Authorization: Bearer ${c.token}" -H "Content-Type: ${fmime}" --data-binary @${shq(path2)}`;
+          return fail(
+            `ASSISTANT: run this one command in your shell to send the file to the group (it reads + uploads locally, fast, any size \u2014 do NOT base64 it into a tool call):
+
+${cmd}`
+          );
+        }
+        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);
+        url = `data:${mime};base64,${buf.toString("base64")}`;
+      } else if (dataUrl && fileName) {
+        name = fileName;
+        mime = dataUrl.match(/^data:([^;]+)/)?.[1] ?? mimeOf(fileName);
+        url = dataUrl;
+      } else {
+        return fail("provide a local file `path` (or `dataUrl` + `fileName`)");
+      }
+      const rawBytes = Buffer.from(url.split(",")[1] ?? "", "base64");
+      if (rawBytes.length > WS_SAFE_FILE_BYTES) {
+        if (rawBytes.length > MAX_UPLOAD_BYTES)
+          return fail(`${name} is ${MB(rawBytes.length)} MB, over the ${Math.round(MAX_UPLOAD_BYTES / 1024 / 1024)} MB limit.`);
+        try {
+          await uploadFileHttp(c, ctx.serverUrl, { groupId }, name, mime, rawBytes, caption);
+        } catch (e2) {
+          return fail(`Rejected: ${e2?.message ?? e2}`);
+        }
+        return ok(`Sent \u{1F4CE} ${name} (${MB(rawBytes.length)} MB) to the group.`);
+      }
+      const err = waitFor(c, "error", () => true, 800);
+      c.sendGroupFile(groupId, name, mime, url);
+      if (caption) c.groupMessage(groupId, caption);
+      const e = await err;
+      if (e) return fail(`Rejected: ${e.message}`);
+      return ok(`Sent \u{1F4CE} ${name} to the group.`);
+    })
+  );
   server.registerTool(
     "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 {
@@ -50120,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"));
     })
@@ -50165,8 +50372,10 @@ ${cmd}`);
       inputSchema: { taskId: external_exports.string(), to: external_exports.string() }
     },
     async ({ taskId, to }) => withClient(async (c) => {
+      const err = waitFor(c, "error", () => true, 800);
       c.assignTask(taskId, to);
-      await new Promise((r) => setTimeout(r, 300));
+      const e = await err;
+      if (e) return fail(`Couldn't assign task ${taskId}: ${e.message}`);
       return ok(`Assigned task ${taskId} to @${to}.`);
     })
   );
@@ -50264,7 +50473,7 @@ app.use((_req, res, next) => {
   next();
 });
 app.use(import_express.default.json({ limit: "25mb" }));
-var health = (_req, res) => res.json({ ok: true, service: "acp-mcp-http", hub: HUB, sessions: sessions.size });
+var health = (_req, res) => res.json({ ok: true, service: "jefrichat-mcp-http", hub: HUB, sessions: sessions.size });
 app.get("/health", health);
 app.get("/mcp/health", health);
 app.post("/mcp", async (req, res) => {

package/dist/index.js

@@ -24813,6 +24813,9 @@ import { webcrypto } from "node:crypto";
 function dmConversationId(a, b) {
   return "dm:" + [a, b].sort().join(":");
 }
+function groupConversationId(groupId) {
+  return "group:" + groupId;
+}
 
 // ../sdk/src/index.ts
 var subtle = webcrypto.subtle;
@@ -24943,7 +24946,7 @@ var AcpClient = class _AcpClient {
       });
     });
   }
-  // Keep the hub connection alive through idle-timeout proxies (Azure ingress).
+  // Keep the hub connection alive through idle-timeout proxies.
   startPing() {
     this.stopPing();
     this.pingTimer = setInterval(() => {
@@ -25302,13 +25305,71 @@ 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;
-async function uploadFileHttp(c, serverUrl, to, fileName, mime, bytes, caption) {
+async function uploadFileHttp(c, serverUrl, target, fileName, mime, bytes, caption) {
   const hub = serverUrl.replace(/\/$/, "");
-  const q = `to=${encodeURIComponent(to)}&fileName=${encodeURIComponent(fileName)}` + (caption ? `&caption=${encodeURIComponent(caption)}` : "");
-  const res = await fetch(`${hub}/api/files?${q}`, {
+  const params = new URLSearchParams({ fileName });
+  if (target.to) params.set("to", target.to);
+  if (target.groupId) params.set("groupId", target.groupId);
+  if (caption) params.set("caption", caption);
+  const res = await fetch(`${hub}/api/files?${params.toString()}`, {
     method: "POST",
     headers: { Authorization: `Bearer ${c.token}`, "Content-Type": mime },
     body: Buffer.from(bytes)
@@ -25336,6 +25397,8 @@ var ok = (text) => ({ content: [{ type: "text", text }] });
 var fail = (text) => ({ content: [{ type: "text", text }], isError: true });
 var inboxWatermark = /* @__PURE__ */ new Map();
 function registerAcpTools(server2, ctx) {
+  const ENABLE_E2E = process.env.ACP_ENABLE_E2E === "true";
+  const e2eServer = ENABLE_E2E ? server2 : { registerTool: () => void 0 };
   const withClient = async (fn) => {
     try {
       const c = await ctx.ensureClient();
@@ -25389,7 +25452,7 @@ ${e?.message ?? e}`);
       return ok(`Sent to @${to}: "${text}"`);
     })
   );
-  server2.registerTool(
+  e2eServer.registerTool(
     "jefri_send_private",
     {
       title: "Send a private (client-encrypted) message",
@@ -25407,7 +25470,7 @@ ${e?.message ?? e}`);
       return ok(`Sent private E2E message to @${to}.`);
     })
   );
-  server2.registerTool(
+  e2eServer.registerTool(
     "jefri_e2e_fingerprint",
     {
       title: "Show E2E key fingerprint",
@@ -25420,7 +25483,7 @@ ${e?.message ?? e}`);
 ${fp}`);
     })
   );
-  server2.registerTool(
+  e2eServer.registerTool(
     "jefri_send_private_file",
     {
       title: "Send a private (client-encrypted) file",
@@ -25436,10 +25499,15 @@ ${fp}`);
     async ({ to, path: path3, dataUrl, fileName, caption }) => withClient(async (c) => {
       let name, mime, url;
       if (path3) {
-        const abs = path3.startsWith("~") ? np.join(process.env.HOME ?? "", path3.slice(1)) : path3;
-        if (!fs2.existsSync(abs)) {
+        if (!ctx.local) {
           return fail(
-            `I can't read that local file from this connector. Use a local/stdin Jefri Chat connector or open the web chat and drop the file there.`
+            `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 = resolveLocalFile(path3);
+        if (!abs) {
+          return fail(
+            `I can't find a file at ${path3} on this machine.`
           );
         }
         const buf = fs2.readFileSync(abs);
@@ -25458,7 +25526,7 @@ ${fp}`);
       return ok(`Sent private E2E file to @${to}.`);
     })
   );
-  server2.registerTool(
+  e2eServer.registerTool(
     "jefri_send_private_group",
     {
       title: "Send a private (client-encrypted) group message",
@@ -25476,7 +25544,7 @@ ${fp}`);
       return ok(`Sent private E2E group message.`);
     })
   );
-  server2.registerTool(
+  e2eServer.registerTool(
     "jefri_send_private_group_file",
     {
       title: "Send a private (client-encrypted) group file",
@@ -25492,10 +25560,15 @@ ${fp}`);
     async ({ groupId, path: path3, dataUrl, fileName, caption }) => withClient(async (c) => {
       let name, mime, url;
       if (path3) {
-        const abs = path3.startsWith("~") ? np.join(process.env.HOME ?? "", path3.slice(1)) : path3;
-        if (!fs2.existsSync(abs)) {
+        if (!ctx.local) {
           return fail(
-            `I can't read that local file from this connector. Use a local/stdin Jefri Chat connector or open the web chat and drop the file there.`
+            `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 = resolveLocalFile(path3);
+        if (!abs) {
+          return fail(
+            `I can't find a file at ${path3} on this machine.`
           );
         }
         const buf = fs2.readFileSync(abs);
@@ -25530,25 +25603,32 @@ ${fp}`);
     async ({ to, path: path3, caption, dataUrl, fileName }) => withClient(async (c) => {
       let name, mime, url;
       if (path3) {
-        const abs = path3.startsWith("~") ? np.join(process.env.HOME ?? "", path3.slice(1)) : path3;
-        if (!fs2.existsSync(abs)) {
-          const fname = np.basename(abs);
+        if (!ctx.local) {
+          const fname = np.basename(path3);
           const fmime = mimeOf(fname);
           const hub = ctx.serverUrl.replace(/\/$/, "");
           const web = hub.replace("acp-hub.", "acp-web.").replace(":4000", ":4321");
           const dropLink = `${web}/?to=${encodeURIComponent(to)}`;
           const q = `to=${encodeURIComponent(to)}&fileName=${encodeURIComponent(fname)}` + (caption ? `&caption=${encodeURIComponent(caption)}` : "");
-          const cmd = `curl -s -X POST ${shq(`${hub}/api/files?${q}`)} -H "Authorization: Bearer ${c.token}" -H "Content-Type: ${fmime}" --data-binary @${shq(path3)}`;
+          const uploadUrl = `${hub}/api/files?${q}`;
+          const cmd = `curl -s -X POST ${shq(uploadUrl)} -H "Authorization: Bearer ${c.token}" -H "Content-Type: ${fmime}" --data-binary @${shq(path3)}`;
+          const psCmd = `Invoke-RestMethod -Uri "${uploadUrl}" -Method Post -Headers @{ Authorization = "Bearer ${c.token}" } -ContentType "${fmime}" -InFile "${path3}"`;
           return fail(
-            `I can't read local files from here (this connector runs in the cloud), and sending your private files to another user's agent is gated for safety \u2014 so this needs to come from you.
+            `ASSISTANT: run the one command below in your shell to send this file \u2014 it reads the file locally and uploads it directly, fast, at any size. Do NOT read the file or base64 it into a tool call (that is slow and breaks on large files); just run this:
 
-\u2705 Easiest \u2014 open the chat and drop "${fname}" in:
-${dropLink}
+\u2022 macOS / Linux:
+${cmd}
 
-Or run this yourself in the terminal (reads + uploads it locally):
-${cmd}`
+\u2022 Windows (PowerShell \u2014 avoids the curl/schannel TLS error):
+${psCmd}
+
+(Alternatively the user can drag "${fname}" straight into the chat: ${dropLink})`
           );
         }
+        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);
@@ -25565,7 +25645,7 @@ ${cmd}`
         if (rawBytes.length > MAX_UPLOAD_BYTES)
           return fail(`${name} is ${MB(rawBytes.length)} MB, over the ${Math.round(MAX_UPLOAD_BYTES / 1024 / 1024)} MB limit.`);
         try {
-          await uploadFileHttp(c, ctx.serverUrl, to, name, mime, rawBytes, caption);
+          await uploadFileHttp(c, ctx.serverUrl, { to }, name, mime, rawBytes, caption);
         } catch (e2) {
           return fail(`Rejected: ${e2?.message ?? e2}`);
         }
@@ -25599,7 +25679,7 @@ ${cmd}`
         if (contentBytes.length > MAX_UPLOAD_BYTES)
           return fail(`That content is ${MB(contentBytes.length)} MB, over the ${Math.round(MAX_UPLOAD_BYTES / 1024 / 1024)} MB limit.`);
         try {
-          await uploadFileHttp(c, ctx.serverUrl, to, fileName, mime, contentBytes, caption);
+          await uploadFileHttp(c, ctx.serverUrl, { to }, fileName, mime, contentBytes, caption);
         } catch (e2) {
           return fail(`Rejected: ${e2?.message ?? e2}`);
         }
@@ -25631,7 +25711,7 @@ ${cmd}`
           `Sending a folder reads files off disk, which this connector can't do \u2014 it runs in the cloud. Run jefri_send_folder from a LOCAL agent (Claude Code with the stdio connector) inside the project.`
         );
       const rawDir = path3 && path3.trim() ? path3 : process.cwd();
-      const dir = rawDir.startsWith("~") ? np.join(process.env.HOME ?? "", rawDir.slice(1)) : rawDir;
+      const dir = rawDir.startsWith("~") ? np.join(os2.homedir(), rawDir.slice(1)) : rawDir;
       if (!fs2.existsSync(dir))
         return fail(
           `I can't see "${rawDir}" from here. Sending a folder reads it off disk, which only works on the LOCAL (stdio) connector \u2014 run this from Claude Code (or another local agent) inside the project.`
@@ -25716,27 +25796,42 @@ ${cmd}`
     "jefri_download_file",
     {
       title: "Download / save a file someone sent you",
-      description: "Save a file (PDF, image, video, any document) that another agent/user sent you, onto this machine. Give the sender's username `from` (and `fileName` if they sent several). Returns a ready-to-run command that downloads the file locally \u2014 run it in the terminal. Use this when the user says things like 'download that file', 'save the pdf antonio sent', etc.",
+      description: "Save a file (PDF, image, video, any document) that another agent/user sent you, onto this machine. For a DM give the sender's username `from`; for a file sent in a GROUP give `groupId` instead (from jefri_groups / jefri_inbox). Add `fileName` if there are several. Returns a ready-to-run command that downloads the file locally \u2014 run it in the terminal. Use this when the user says things like 'download that file', 'save the pdf antonio sent', etc.",
       inputSchema: {
-        from: external_exports.string().describe("who sent you the file (their username)"),
-        fileName: external_exports.string().optional().describe("which file, if there are several from them"),
+        from: external_exports.string().optional().describe("who sent you the file (their username) \u2014 for a DM"),
+        groupId: external_exports.string().optional().describe("the group's id \u2014 for a file sent in a group"),
+        fileName: external_exports.string().optional().describe("which file, if there are several"),
         savePath: external_exports.string().optional().describe("where to save it (default: the file's own name in the current folder)")
       }
     },
-    async ({ from, fileName, savePath }) => withClient(async (c) => {
-      const convId = dmConversationId(c.identity.username, from);
+    async ({ from, groupId, fileName, savePath }) => withClient(async (c) => {
+      if (!from && !groupId) return fail("Give `from` (a username, for a DM) or `groupId` (for a group file).");
+      const convId = groupId ? groupConversationId(groupId) : dmConversationId(c.identity.username, from);
+      const where = groupId ? "this group" : `@${from}`;
       const p = waitFor(c, "history", (e) => e.conversationId === convId, 4e3);
       c.history(convId);
       const res = await p;
       const files = (res?.messages ?? []).filter((m) => m.kind === "file");
-      if (!files.length) return fail(`No files from @${from} yet.`);
+      if (!files.length) return fail(`No files in ${where} yet.`);
       const match = fileName ? [...files].reverse().find((m) => m.fileName === fileName || m.fileName?.includes(fileName)) : files[files.length - 1];
-      if (!match) return fail(`No file named "${fileName}" from @${from}.`);
+      if (!match) return fail(`No file named "${fileName}" in ${where}.`);
       const hub = ctx.serverUrl.replace(/\/$/, "");
       const out = savePath || match.fileName || "downloaded.file";
+      if (ctx.local) {
+        const outPath = out.startsWith("~") ? np.join(os2.homedir(), out.slice(1)) : out;
+        try {
+          const r = await fetch(`${hub}/api/files/${match.id}`, { headers: { authorization: `Bearer ${c.token}` } });
+          if (!r.ok) throw new Error(`download failed (${r.status})`);
+          const buf = Buffer.from(await r.arrayBuffer());
+          fs2.writeFileSync(outPath, buf);
+          return ok(`\u2705 Saved \u{1F4CE} ${match.fileName} from ${where} to ${outPath} (${MB(buf.length)} MB).`);
+        } catch (e) {
+          return fail(`Couldn't save the file: ${e?.message ?? e}`);
+        }
+      }
       const cmd = `curl -s -o ${shq(out)} -H "Authorization: Bearer ${c.token}" ${shq(`${hub}/api/files/${match.id}`)}`;
       return ok(
-        `To save \u{1F4CE} ${match.fileName} from @${from}, run this in the terminal:
+        `To save \u{1F4CE} ${match.fileName} from ${where}, run this in the terminal:
 
 ${cmd}
 
@@ -25984,41 +26079,149 @@ ${cmd}`);
       if (!msgs.length) return ok("\u{1F4ED} No new messages.");
       msgs.sort((a, b) => a.createdAt < b.createdAt ? -1 : 1);
       inboxWatermark.set(me, msgs[msgs.length - 1].createdAt);
+      const groupNames = /* @__PURE__ */ new Map();
+      if (msgs.some((m) => m.groupId)) {
+        try {
+          for (const g of await c.groups()) groupNames.set(g.id, g.name);
+        } catch {
+        }
+      }
+      const where = (m) => {
+        if (!m.groupId) return "";
+        const name = groupNames.get(m.groupId);
+        return name ? ` (in group "${name}" \xB7 reply with jefri_send_group groupId="${m.groupId}")` : ` (in group id ${m.groupId})`;
+      };
       const lines = await Promise.all(msgs.map(async (m) => {
         if (m.encryptionMode === "private_e2e" && m.encryptedPayload) {
           try {
             const plain = await c.decryptPrivatePayload(m.encryptedPayload);
             const body2 = plain.kind === "file" ? `\u{1F512}\u{1F4CE} private file: ${plain.fileName ?? m.fileName}` : `\u{1F512} ${plain.content ?? ""}`;
-            return `@${m.senderUsername}${m.groupId ? " (in group)" : ""}: ${body2}`;
+            return `@${m.senderUsername}${where(m)}: ${body2}`;
           } catch {
-            return `@${m.senderUsername}${m.groupId ? " (in group)" : ""}: \u{1F512} Private message unavailable on this device`;
+            return `@${m.senderUsername}${where(m)}: \u{1F512} Private message unavailable on this device`;
           }
         }
         const body = m.kind === "file" ? `\u{1F4CE} sent a file: ${m.fileName} \u2014 to save it call jefri_download_file(from: "${m.senderUsername}"${m.fileName ? `, fileName: "${m.fileName}"` : ""})` : m.content;
-        const where = m.groupId ? ` (in group)` : "";
-        return `@${m.senderUsername}${where}: ${body}`;
+        return `@${m.senderUsername}${where(m)}: ${body}`;
       }));
       return ok(`\u{1F4E8} ${lines.length} message(s):
 ` + lines.join("\n"));
     })
   );
+  server2.registerTool(
+    "jefri_groups",
+    {
+      title: "List your groups",
+      description: "List the groups you're a member of, with each group's id (needed to post to it) and its members. Use this to find a group's id before jefri_send_group.",
+      inputSchema: {}
+    },
+    async () => withClient(async (c) => {
+      const gs = await c.groups();
+      if (!gs.length) return ok("You're not in any groups yet.");
+      return ok(
+        `You're in ${gs.length} group(s):
+` + gs.map((g) => `\u2022 "${g.name}" \u2014 id: ${g.id} \u2014 ${g.memberUsernames.length} members: ${g.memberUsernames.join(", ")}`).join("\n")
+      );
+    })
+  );
+  server2.registerTool(
+    "jefri_send_group",
+    {
+      title: "Send a group message",
+      description: "Post a message to a GROUP (everyone in the group sees it), by the group's id. Get the id from jefri_groups, or from jefri_inbox \u2014 it shows the id of the group any incoming group message came from. NOTE: this needs the group's id, not its display name.",
+      inputSchema: {
+        groupId: external_exports.string().describe("the group's id (from jefri_groups or jefri_inbox)"),
+        text: external_exports.string().describe("the message to post to the group")
+      }
+    },
+    async ({ groupId, text }) => withClient(async (c) => {
+      const err = waitFor(c, "error", () => true, 800);
+      c.groupMessage(groupId, text);
+      const e = await err;
+      if (e) return fail(`Couldn't post to the group: ${e.message}`);
+      return ok(`Posted to the group.`);
+    })
+  );
+  server2.registerTool(
+    "jefri_send_group_file",
+    {
+      title: "Send a file to a group",
+      description: "Send a file/image to a GROUP by its group id. Give a local file `path` (works on the local/stdio connector) or a `dataUrl` + `fileName`. Get the group id from jefri_groups / jefri_inbox.",
+      inputSchema: {
+        groupId: external_exports.string().describe("the group's id (from jefri_groups or jefri_inbox)"),
+        path: external_exports.string().optional().describe("local file path, e.g. ~/Downloads/report.pdf"),
+        caption: external_exports.string().optional().describe("optional text caption"),
+        dataUrl: external_exports.string().optional().describe("alternatively, a data: URL of the file (small files only)"),
+        fileName: external_exports.string().optional().describe("file name when using dataUrl")
+      }
+    },
+    async ({ groupId, path: path3, caption, dataUrl, fileName }) => withClient(async (c) => {
+      let name, mime, url;
+      if (path3) {
+        if (!ctx.local) {
+          const hub = ctx.serverUrl.replace(/\/$/, "");
+          const fname = np.basename(path3);
+          const fmime = mimeOf(fname);
+          const q = `groupId=${encodeURIComponent(groupId)}&fileName=${encodeURIComponent(fname)}` + (caption ? `&caption=${encodeURIComponent(caption)}` : "");
+          const cmd = `curl -s -X POST ${shq(`${hub}/api/files?${q}`)} -H "Authorization: Bearer ${c.token}" -H "Content-Type: ${fmime}" --data-binary @${shq(path3)}`;
+          return fail(
+            `ASSISTANT: run this one command in your shell to send the file to the group (it reads + uploads locally, fast, any size \u2014 do NOT base64 it into a tool call):
+
+${cmd}`
+          );
+        }
+        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);
+        url = `data:${mime};base64,${buf.toString("base64")}`;
+      } else if (dataUrl && fileName) {
+        name = fileName;
+        mime = dataUrl.match(/^data:([^;]+)/)?.[1] ?? mimeOf(fileName);
+        url = dataUrl;
+      } else {
+        return fail("provide a local file `path` (or `dataUrl` + `fileName`)");
+      }
+      const rawBytes = Buffer.from(url.split(",")[1] ?? "", "base64");
+      if (rawBytes.length > WS_SAFE_FILE_BYTES) {
+        if (rawBytes.length > MAX_UPLOAD_BYTES)
+          return fail(`${name} is ${MB(rawBytes.length)} MB, over the ${Math.round(MAX_UPLOAD_BYTES / 1024 / 1024)} MB limit.`);
+        try {
+          await uploadFileHttp(c, ctx.serverUrl, { groupId }, name, mime, rawBytes, caption);
+        } catch (e2) {
+          return fail(`Rejected: ${e2?.message ?? e2}`);
+        }
+        return ok(`Sent \u{1F4CE} ${name} (${MB(rawBytes.length)} MB) to the group.`);
+      }
+      const err = waitFor(c, "error", () => true, 800);
+      c.sendGroupFile(groupId, name, mime, url);
+      if (caption) c.groupMessage(groupId, caption);
+      const e = await err;
+      if (e) return fail(`Rejected: ${e.message}`);
+      return ok(`Sent \u{1F4CE} ${name} to the group.`);
+    })
+  );
   server2.registerTool(
     "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 {
@@ -26028,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"));
     })
@@ -26073,8 +26280,10 @@ ${cmd}`);
       inputSchema: { taskId: external_exports.string(), to: external_exports.string() }
     },
     async ({ taskId, to }) => withClient(async (c) => {
+      const err = waitFor(c, "error", () => true, 800);
       c.assignTask(taskId, to);
-      await new Promise((r) => setTimeout(r, 300));
+      const e = await err;
+      if (e) return fail(`Couldn't assign task ${taskId}: ${e.message}`);
       return ok(`Assigned task ${taskId} to @${to}.`);
     })
   );

package/package.json

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