jefrichat-mcp 0.49.5 → 0.49.6

package/dist/http.js

@@ -63555,11 +63555,91 @@ ${fp}`);
       return ok3(`Sent private E2E group file.`);
     })
   );
+  if (!ctx.local) server2.registerTool(
+    "jefri_upload_link",
+    {
+      title: "Get an upload link (any file up to 100 MB, full quality)",
+      description: "Get a ONE-TAP UPLOAD LINK to send files or images \u2014 up to 5 PER LINK via `fileNames`, up to 100 MB each, FULL quality, no base64, no compression, no path needed. ALWAYS PREFER THIS for images and for files in your sandbox or on the user's device \u2014 the ONE exception: files \u2264256KB (already held OR readable in your sandbox \u2014 PDFs, CSVs, code, small images) go straight through jefri_send_file's dataUrl automatically, no link needed. One cheap call, then hand the user the link \u2014 they open it (phone works), pick the file, and it delivers to the recipient automatically. Give `to` (a username) or `groupId`, plus the `fileName` the delivery should carry. The link is single-use and expires in ~15 minutes; mint a fresh one any time. If the file lives in YOUR sandbox, present it to the user for download first so they can pick it at the link. NEVER stream file bytes through plain output (base64/pixel data) \u2014 that burns the user's tokens. The ONE sanctioned carrier is a \u2264256KB `dataUrl` TOOL ARGUMENT via jefri_send_file (near the cap it may still strain output limits \u2014 then use this link); anything larger only ever travels as this link.",
+      inputSchema: {
+        to: external_exports.string().optional().describe("recipient username (or use groupId)"),
+        groupId: external_exports.string().optional().describe("group id (from jefri_groups) instead of `to`"),
+        fileName: external_exports.string().optional().describe("the name the delivered file should carry, e.g. photo.png (single file)"),
+        fileNames: external_exports.array(external_exports.string()).optional().describe('for a MULTI-file link (2\u20135): the delivery names in order, e.g. ["foto-1.jpg","foto-2.jpg"] \u2014 one link, the user picks them all'),
+        caption: external_exports.string().optional().describe("optional text caption delivered with the file")
+      }
+    },
+    async (args, extra) => withClient(async (c) => {
+      const to = typeof args.to === "string" && args.to.trim() ? args.to.trim() : void 0;
+      const groupId = typeof args.groupId === "string" && args.groupId.trim() ? args.groupId.trim() : void 0;
+      if (!to && !groupId) return fail("give `to` (a username) or `groupId`");
+      if (to && groupId) return fail("give either `to` or `groupId`, not both");
+      const names = Array.isArray(args.fileNames) ? args.fileNames.map((n) => String(n ?? "").trim()).filter(Boolean).slice(0, 5) : [];
+      const fileName = String(args.fileName ?? "").trim();
+      if (!fileName && names.length === 0) return fail("give `fileName` (one file) or `fileNames` (2\u20135 files) \u2014 deliveries carry these names");
+      if (Array.isArray(args.fileNames) && args.fileNames.length > 5)
+        return fail("a link carries at most 5 files \u2014 mint another link for more");
+      const hub = ctx.serverUrl.replace(/\/$/, "");
+      const gc = new AbortController();
+      const onHostAbort = () => gc.abort();
+      const gKiller = setTimeout(() => gc.abort(), MINT_LINK_DEADLINE_MS);
+      const signal = extra?.signal;
+      if (signal) {
+        if (signal.aborted) {
+          clearTimeout(gKiller);
+          return fail("cancelled");
+        }
+        signal.addEventListener("abort", onHostAbort, { once: true });
+      }
+      try {
+        const g = await fetch(`${hub}/api/files/grant`, {
+          method: "POST",
+          headers: { authorization: `Bearer ${c.token}`, "content-type": "application/json" },
+          body: JSON.stringify({ ...to ? { to } : { groupId }, ...names.length ? { fileNames: names } : { fileName }, ...args.caption ? { caption: args.caption } : {} }),
+          signal: gc.signal
+        });
+        if (!g.ok) {
+          try {
+            await g.body?.cancel();
+          } catch {
+          }
+          return fail(`the upload-link service answered ${g.status} \u2014 try again shortly. Real fallbacks while it's down: a public URL \u2192 jefri_send_file with fileUrl; otherwise present/download the file and DRAG it into the Jefri Chat web app.`);
+        }
+        const body = await g.json().catch(() => ({}));
+        const parsedUrl = (() => {
+          const raw = names.length ? body.batchUrl : body.uploadUrl;
+          if (typeof raw !== "string") return null;
+          try {
+            const u = new URL(raw);
+            return (u.protocol === "http:" || u.protocol === "https:") && u.host ? raw : null;
+          } catch {
+            return null;
+          }
+        })();
+        if (!parsedUrl || typeof body.expiresInMs !== "number" || !Number.isFinite(body.expiresInMs) || body.expiresInMs <= 0)
+          return fail("the upload-link service answered malformed data \u2014 try again shortly. Real fallbacks: a public URL \u2192 jefri_send_file with fileUrl; otherwise present/download the file and DRAG it into the Jefri Chat web app.");
+        const mins = Math.round(body.expiresInMs / 6e4);
+        const where = to ? `@${safeHandle(to)}` : "the group";
+        const delivers = names.length ? `${names.length} files: ${names.map((n) => `\u{1F4CE} ${n}`).join(", ")}` : `\u{1F4CE} ${fileName}`;
+        return ok3(
+          `\u{1F517} One-tap upload link for ${where} (delivers ${delivers}; valid ~${mins} min, single-use):
+${parsedUrl}
+
+SAY THIS to the user (adapt their language): "Here's your upload link \u2014 open it and pick the ${names.length ? "files" : "file"}; ${names.length ? "they deliver" : "it delivers"} to ${where} automatically at full quality: ${parsedUrl}" If the file is in YOUR sandbox, present it for download first so they can pick the downloaded copy. Do NOT open the link yourself and do NOT prepare or stream any bytes \u2014 your part is done.`
+        );
+      } catch (e) {
+        return fail(`could not mint the upload link: ${e?.message ?? e} \u2014 try again shortly. Real fallbacks: a public URL \u2192 jefri_send_file with fileUrl; otherwise present/download the file and DRAG it into the Jefri Chat web app.`);
+      } finally {
+        gc.abort();
+        clearTimeout(gKiller);
+        if (signal) signal.removeEventListener("abort", onHostAbort);
+      }
+    })
+  );
   server2.registerTool(
     "jefri_send_file",
     {
       title: "Send a file, PDF, or image",
-      description: "Send a file to another Jefri Chat user/agent \u2014 PDF, image (jpg/png/gif/webp), video (mp4/mov), or any document. PICK THE INPUT BY WHERE THE FILE LIVES: (1) on the USER'S machine \u2192 give `path` (e.g. ~/Downloads/report.pdf); even on the remote/cloud connector this answers ONE ready-to-run terminal command for the user (a single-use upload link) \u2014 never base64 a user-disk file. (2) reachable by public URL \u2192 pass `fileUrl`; the connector fetches the bytes itself (up to 25MB). (3) in YOUR OWN sandbox (you are a cloud-sandboxed assistant with no network egress, e.g. Claude apps/Cowork) and \u2264256KB \u2192 send it as `dataUrl` + `fileName`; over 256KB \u2192 call this tool with the file's sandbox `path`: you get a one-tap upload LINK \u2014 present the file to the user for download and have them open the link and pick it. Optional `caption` in every case.",
+      description: ctx.local ? "Send a file to a Jefri Chat user/agent \u2014 PDF, image, video, any document. On this LOCAL connector, `path` reads the file off disk and sends it DIRECTLY (up to 100 MB) \u2014 always prefer `path`; never read a file into base64 yourself. `dataUrl` + `fileName` is only for small (\u2264256KB) content you generated in-conversation, and `fileUrl` fetches a public URL. Optional `caption` always." : "Send a file to a Jefri Chat user/agent. THE RULE: a file \u2264256KB (check its size first \u2014 PDFs, CSVs, code, small images alike), whether already held as base64 or sitting in your sandbox, \u2192 read it and send NOW via `dataUrl` + `fileName`, automatically, no user step. ANYTHING over 256KB, or that would need TRANSFORMING (compressing, converting, resizing) \u2192 STOP and call jefri_upload_link instead \u2014 never transform. For a file on the USER'S DEVICE, CALL THIS TOOL FIRST with the file's `path` \u2014 even a path this connector cannot read: it answers a one-tap upload LINK the user opens to deliver the file at full quality. NEVER pre-process first: no compressing, no splitting base64 into chunks, no reading/retyping base64 through a viewer \u2014 that wastes many minutes and usually fails; the LINK route needs none of it. Inputs by where the file lives: (1) user's machine \u2192 `path` (also yields a runnable upload command). (2) public URL \u2192 `fileUrl` (connector fetches, \u226425MB). (3) YOUR OWN sandbox (cloud-sandboxed assistant, no egress): up to 100 MB \u2192 `path` for the LINK (present the file for the user to download and pick at the link); \u2264256KB (held OR read from your sandbox) \u2192 `dataUrl` + `fileName`, automatically. Large images: the LINK, full quality \u2014 do not offer to compress. Optional `caption` always.",
       inputSchema: {
         to: external_exports.string().describe("recipient username"),
         path: external_exports.string().optional().describe("local file path, e.g. ~/Downloads/report.pdf"),
@@ -64340,7 +64420,7 @@ Or just upload ${fname} from the agent's page in the web app.`
     "jefri_send_group_file",
     {
       title: "Send a file to a group",
-      description: "Send a file/image to a GROUP by its group id (from jefri_groups / jefri_inbox). Pick the input by where the file lives: user's machine \u2192 `path`; public URL \u2192 `fileUrl`; your OWN sandbox (cloud-sandboxed assistant, no egress) and \u2264256KB \u2192 `dataUrl` + `fileName`, over 256KB \u2192 call with the sandbox `path` for a one-tap upload LINK, present the file for download, and have the user open the link and pick it.",
+      description: ctx.local ? "Send a file/image to a GROUP by its group id (from jefri_groups / jefri_inbox). On this LOCAL connector, `path` sends the file DIRECTLY off disk (up to 100 MB) \u2014 always prefer `path`; `dataUrl` only for small generated content; `fileUrl` for a public URL." : "Send a file/image to a GROUP by its group id (from jefri_groups / jefri_inbox). For a file on the USER'S DEVICE, CALL FIRST with its `path` \u2014 even one this connector cannot read: you get a one-tap upload LINK for the user. NEVER TRANSFORM (no compressing/splitting/retyping base64 through a viewer). user's device \u2192 `path`; public URL \u2192 `fileUrl`; your OWN sandbox: \u2264256KB (any type) \u2192 read it, send via `dataUrl` + `fileName` automatically; larger \u2192 `path` for the LINK (up to 100 MB).",
       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"),

package/dist/index.js

@@ -43278,11 +43278,91 @@ ${fp}`);
       return ok3(`Sent private E2E group file.`);
     })
   );
+  if (!ctx.local) server2.registerTool(
+    "jefri_upload_link",
+    {
+      title: "Get an upload link (any file up to 100 MB, full quality)",
+      description: "Get a ONE-TAP UPLOAD LINK to send files or images \u2014 up to 5 PER LINK via `fileNames`, up to 100 MB each, FULL quality, no base64, no compression, no path needed. ALWAYS PREFER THIS for images and for files in your sandbox or on the user's device \u2014 the ONE exception: files \u2264256KB (already held OR readable in your sandbox \u2014 PDFs, CSVs, code, small images) go straight through jefri_send_file's dataUrl automatically, no link needed. One cheap call, then hand the user the link \u2014 they open it (phone works), pick the file, and it delivers to the recipient automatically. Give `to` (a username) or `groupId`, plus the `fileName` the delivery should carry. The link is single-use and expires in ~15 minutes; mint a fresh one any time. If the file lives in YOUR sandbox, present it to the user for download first so they can pick it at the link. NEVER stream file bytes through plain output (base64/pixel data) \u2014 that burns the user's tokens. The ONE sanctioned carrier is a \u2264256KB `dataUrl` TOOL ARGUMENT via jefri_send_file (near the cap it may still strain output limits \u2014 then use this link); anything larger only ever travels as this link.",
+      inputSchema: {
+        to: external_exports.string().optional().describe("recipient username (or use groupId)"),
+        groupId: external_exports.string().optional().describe("group id (from jefri_groups) instead of `to`"),
+        fileName: external_exports.string().optional().describe("the name the delivered file should carry, e.g. photo.png (single file)"),
+        fileNames: external_exports.array(external_exports.string()).optional().describe('for a MULTI-file link (2\u20135): the delivery names in order, e.g. ["foto-1.jpg","foto-2.jpg"] \u2014 one link, the user picks them all'),
+        caption: external_exports.string().optional().describe("optional text caption delivered with the file")
+      }
+    },
+    async (args, extra) => withClient(async (c2) => {
+      const to = typeof args.to === "string" && args.to.trim() ? args.to.trim() : void 0;
+      const groupId = typeof args.groupId === "string" && args.groupId.trim() ? args.groupId.trim() : void 0;
+      if (!to && !groupId) return fail("give `to` (a username) or `groupId`");
+      if (to && groupId) return fail("give either `to` or `groupId`, not both");
+      const names = Array.isArray(args.fileNames) ? args.fileNames.map((n) => String(n ?? "").trim()).filter(Boolean).slice(0, 5) : [];
+      const fileName = String(args.fileName ?? "").trim();
+      if (!fileName && names.length === 0) return fail("give `fileName` (one file) or `fileNames` (2\u20135 files) \u2014 deliveries carry these names");
+      if (Array.isArray(args.fileNames) && args.fileNames.length > 5)
+        return fail("a link carries at most 5 files \u2014 mint another link for more");
+      const hub = ctx.serverUrl.replace(/\/$/, "");
+      const gc = new AbortController();
+      const onHostAbort = () => gc.abort();
+      const gKiller = setTimeout(() => gc.abort(), MINT_LINK_DEADLINE_MS);
+      const signal = extra?.signal;
+      if (signal) {
+        if (signal.aborted) {
+          clearTimeout(gKiller);
+          return fail("cancelled");
+        }
+        signal.addEventListener("abort", onHostAbort, { once: true });
+      }
+      try {
+        const g = await fetch(`${hub}/api/files/grant`, {
+          method: "POST",
+          headers: { authorization: `Bearer ${c2.token}`, "content-type": "application/json" },
+          body: JSON.stringify({ ...to ? { to } : { groupId }, ...names.length ? { fileNames: names } : { fileName }, ...args.caption ? { caption: args.caption } : {} }),
+          signal: gc.signal
+        });
+        if (!g.ok) {
+          try {
+            await g.body?.cancel();
+          } catch {
+          }
+          return fail(`the upload-link service answered ${g.status} \u2014 try again shortly. Real fallbacks while it's down: a public URL \u2192 jefri_send_file with fileUrl; otherwise present/download the file and DRAG it into the Jefri Chat web app.`);
+        }
+        const body = await g.json().catch(() => ({}));
+        const parsedUrl = (() => {
+          const raw = names.length ? body.batchUrl : body.uploadUrl;
+          if (typeof raw !== "string") return null;
+          try {
+            const u = new URL(raw);
+            return (u.protocol === "http:" || u.protocol === "https:") && u.host ? raw : null;
+          } catch {
+            return null;
+          }
+        })();
+        if (!parsedUrl || typeof body.expiresInMs !== "number" || !Number.isFinite(body.expiresInMs) || body.expiresInMs <= 0)
+          return fail("the upload-link service answered malformed data \u2014 try again shortly. Real fallbacks: a public URL \u2192 jefri_send_file with fileUrl; otherwise present/download the file and DRAG it into the Jefri Chat web app.");
+        const mins = Math.round(body.expiresInMs / 6e4);
+        const where = to ? `@${safeHandle(to)}` : "the group";
+        const delivers = names.length ? `${names.length} files: ${names.map((n) => `\u{1F4CE} ${n}`).join(", ")}` : `\u{1F4CE} ${fileName}`;
+        return ok3(
+          `\u{1F517} One-tap upload link for ${where} (delivers ${delivers}; valid ~${mins} min, single-use):
+${parsedUrl}
+
+SAY THIS to the user (adapt their language): "Here's your upload link \u2014 open it and pick the ${names.length ? "files" : "file"}; ${names.length ? "they deliver" : "it delivers"} to ${where} automatically at full quality: ${parsedUrl}" If the file is in YOUR sandbox, present it for download first so they can pick the downloaded copy. Do NOT open the link yourself and do NOT prepare or stream any bytes \u2014 your part is done.`
+        );
+      } catch (e) {
+        return fail(`could not mint the upload link: ${e?.message ?? e} \u2014 try again shortly. Real fallbacks: a public URL \u2192 jefri_send_file with fileUrl; otherwise present/download the file and DRAG it into the Jefri Chat web app.`);
+      } finally {
+        gc.abort();
+        clearTimeout(gKiller);
+        if (signal) signal.removeEventListener("abort", onHostAbort);
+      }
+    })
+  );
   server2.registerTool(
     "jefri_send_file",
     {
       title: "Send a file, PDF, or image",
-      description: "Send a file to another Jefri Chat user/agent \u2014 PDF, image (jpg/png/gif/webp), video (mp4/mov), or any document. PICK THE INPUT BY WHERE THE FILE LIVES: (1) on the USER'S machine \u2192 give `path` (e.g. ~/Downloads/report.pdf); even on the remote/cloud connector this answers ONE ready-to-run terminal command for the user (a single-use upload link) \u2014 never base64 a user-disk file. (2) reachable by public URL \u2192 pass `fileUrl`; the connector fetches the bytes itself (up to 25MB). (3) in YOUR OWN sandbox (you are a cloud-sandboxed assistant with no network egress, e.g. Claude apps/Cowork) and \u2264256KB \u2192 send it as `dataUrl` + `fileName`; over 256KB \u2192 call this tool with the file's sandbox `path`: you get a one-tap upload LINK \u2014 present the file to the user for download and have them open the link and pick it. Optional `caption` in every case.",
+      description: ctx.local ? "Send a file to a Jefri Chat user/agent \u2014 PDF, image, video, any document. On this LOCAL connector, `path` reads the file off disk and sends it DIRECTLY (up to 100 MB) \u2014 always prefer `path`; never read a file into base64 yourself. `dataUrl` + `fileName` is only for small (\u2264256KB) content you generated in-conversation, and `fileUrl` fetches a public URL. Optional `caption` always." : "Send a file to a Jefri Chat user/agent. THE RULE: a file \u2264256KB (check its size first \u2014 PDFs, CSVs, code, small images alike), whether already held as base64 or sitting in your sandbox, \u2192 read it and send NOW via `dataUrl` + `fileName`, automatically, no user step. ANYTHING over 256KB, or that would need TRANSFORMING (compressing, converting, resizing) \u2192 STOP and call jefri_upload_link instead \u2014 never transform. For a file on the USER'S DEVICE, CALL THIS TOOL FIRST with the file's `path` \u2014 even a path this connector cannot read: it answers a one-tap upload LINK the user opens to deliver the file at full quality. NEVER pre-process first: no compressing, no splitting base64 into chunks, no reading/retyping base64 through a viewer \u2014 that wastes many minutes and usually fails; the LINK route needs none of it. Inputs by where the file lives: (1) user's machine \u2192 `path` (also yields a runnable upload command). (2) public URL \u2192 `fileUrl` (connector fetches, \u226425MB). (3) YOUR OWN sandbox (cloud-sandboxed assistant, no egress): up to 100 MB \u2192 `path` for the LINK (present the file for the user to download and pick at the link); \u2264256KB (held OR read from your sandbox) \u2192 `dataUrl` + `fileName`, automatically. Large images: the LINK, full quality \u2014 do not offer to compress. Optional `caption` always.",
       inputSchema: {
         to: external_exports.string().describe("recipient username"),
         path: external_exports.string().optional().describe("local file path, e.g. ~/Downloads/report.pdf"),
@@ -44063,7 +44143,7 @@ Or just upload ${fname} from the agent's page in the web app.`
     "jefri_send_group_file",
     {
       title: "Send a file to a group",
-      description: "Send a file/image to a GROUP by its group id (from jefri_groups / jefri_inbox). Pick the input by where the file lives: user's machine \u2192 `path`; public URL \u2192 `fileUrl`; your OWN sandbox (cloud-sandboxed assistant, no egress) and \u2264256KB \u2192 `dataUrl` + `fileName`, over 256KB \u2192 call with the sandbox `path` for a one-tap upload LINK, present the file for download, and have the user open the link and pick it.",
+      description: ctx.local ? "Send a file/image to a GROUP by its group id (from jefri_groups / jefri_inbox). On this LOCAL connector, `path` sends the file DIRECTLY off disk (up to 100 MB) \u2014 always prefer `path`; `dataUrl` only for small generated content; `fileUrl` for a public URL." : "Send a file/image to a GROUP by its group id (from jefri_groups / jefri_inbox). For a file on the USER'S DEVICE, CALL FIRST with its `path` \u2014 even one this connector cannot read: you get a one-tap upload LINK for the user. NEVER TRANSFORM (no compressing/splitting/retyping base64 through a viewer). user's device \u2192 `path`; public URL \u2192 `fileUrl`; your OWN sandbox: \u2264256KB (any type) \u2192 read it, send via `dataUrl` + `fileName` automatically; larger \u2192 `path` for the LINK (up to 100 MB).",
       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"),

package/package.json

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