jefrichat-mcp 0.49.3 → 0.49.4

package/dist/http.js

@@ -62438,6 +62438,37 @@ var psPathArg = (p) => p.startsWith("~/") || p.startsWith("~\\") ? `($HOME + ${p
 var isTextyFile = (mime, name) => /^text\/|json|xml|javascript|typescript|markdown|csv|ya?ml|x-sh|toml/i.test(mime) || /\.(md|txt|json|csv|ya?ml|log|ts|tsx|js|jsx|py|rb|go|rs|java|c|h|cpp|sh|sql|toml|env|cfg|ini)$/i.test(name);
 var DATAURL_INLINE_MAX = 256 * 1024;
 var dataUrlTooBig = (dataUrl) => dataUrl.length > DATAURL_INLINE_MAX * 1.4 ? `That dataUrl is ~${MB(dataUrl.length * 0.75)} MB decoded \u2014 far past the ${Math.round(DATAURL_INLINE_MAX / 1024)}KB inline limit. NEVER read a local file and base64 it through the model. Call this tool again with the file's PATH \u2014 you'll get a single-use upload command that sends it in seconds.` : null;
+var MINT_LINK_DEADLINE_MS = (() => {
+  const n = Number(process.env.MCP_MINT_LINK_DEADLINE_MS);
+  return Number.isInteger(n) && n > 0 ? n : 1e4;
+})();
+async function mintFileLink(hub, token, fileId) {
+  const ac = new AbortController();
+  const killer = setTimeout(() => ac.abort(), MINT_LINK_DEADLINE_MS);
+  try {
+    const lr = await fetch(`${hub}/api/files/${fileId}/link`, {
+      method: "POST",
+      headers: { authorization: `Bearer ${token}` },
+      signal: ac.signal
+    });
+    if (!lr.ok) {
+      try {
+        await lr.body?.cancel();
+      } catch {
+      }
+      return null;
+    }
+    const body = await lr.json();
+    return body?.url ?? null;
+  } catch {
+    return null;
+  } finally {
+    ac.abort();
+    clearTimeout(killer);
+  }
+}
+var forwardTip = (link2, fileName) => `\u2022 To FORWARD this exact file: to a PERSON call jefri_send_file with to:"<username>", fileUrl:${JSON.stringify(link2)}, fileName:${JSON.stringify(fileName)}; to a GROUP call jefri_send_group_file with groupId:"<id>" and the same fileUrl + fileName. The connector fetches and delivers the ORIGINAL bytes (up to 25 MB).
+`;
 async function remoteUploadCommand(c, ctx, target, path3, caption, where) {
   const fname = crossBasename(path3);
   const fmime = mimeOf(fname);
@@ -62574,9 +62605,13 @@ function resolveLocalFile(rawPath) {
   return null;
 }
 var MAX_UPLOAD_BYTES = 100 * 1024 * 1024;
-var MAX_REMOTE_URL_BYTES = Number(process.env.MCP_MAX_REMOTE_URL_BYTES ?? 25 * 1024 * 1024);
-var MAX_CONCURRENT_REMOTE_DOWNLOADS = Number(process.env.MCP_MAX_REMOTE_DL ?? 3);
-var REMOTE_DOWNLOAD_DEADLINE_MS = Number(process.env.MCP_REMOTE_DL_DEADLINE_MS ?? 3e4);
+var posIntEnv = (v, dflt) => {
+  const n = Number(v);
+  return Number.isInteger(n) && n > 0 ? n : dflt;
+};
+var MAX_REMOTE_URL_BYTES = posIntEnv(process.env.MCP_MAX_REMOTE_URL_BYTES, 25 * 1024 * 1024);
+var MAX_CONCURRENT_REMOTE_DOWNLOADS = posIntEnv(process.env.MCP_MAX_REMOTE_DL, 3);
+var REMOTE_DOWNLOAD_DEADLINE_MS = posIntEnv(process.env.MCP_REMOTE_DL_DEADLINE_MS, 3e4);
 var activeRemoteDownloads = 0;
 var MB = (n) => (n / 1024 / 1024).toFixed(1);
 var WS_SAFE_FILE_BYTES = 45 * 1024 * 1024;
@@ -63481,7 +63516,9 @@ ${fp}`);
           return fail(`Couldn't fetch that URL: ${e2?.message ?? e2}`);
         }
       } else {
-        return fail("provide a local file `path`, a `dataUrl` + `fileName`, or a public `fileUrl`");
+        return fail(
+          "provide a local file `path`, a `dataUrl` + `fileName` (\u2264256KB), or a public `fileUrl`. If the file only exists INSIDE this chat (attached or generated here), the connector can't see it \u2014 ask the user to save it to their computer first, then call again with that path."
+        );
       }
       const rawBytes = Buffer.from(url.split(",")[1] ?? "", "base64");
       if (rawBytes.length > MAX_UPLOAD_BYTES)
@@ -63671,7 +63708,7 @@ ${fp}`);
     "jefri_download_file",
     {
       title: "Read or save a file someone sent you",
-      description: "Get a file another agent/user sent you. For a DM give the sender's username `from`; for a GROUP file give `groupId` (from jefri_groups / jefri_inbox). Add `fileName` if there are several. TEXT files (code, markdown, JSON, CSV, logs \u2014 up to 256KB) come back with their FULL CONTENT inline, PDFs come back as EXTRACTED TEXT, and IMAGES (png/jpeg/gif/webp up to 4MB) come back as the ACTUAL PICTURE you can look at \u2014 so you can read, view and discuss all three directly, no terminal needed. Only video, very large images and other binaries return a download link. On the local connector, files are saved straight to disk. Use this when the user says 'read the file sara sent', 'download that file', 'what does the doc say', etc.",
+      description: "Get a file another agent/user sent you. For a DM give the sender's username `from`; for a GROUP file give `groupId` (from jefri_groups / jefri_inbox). Add `fileName` if there are several. TEXT files (code, markdown, JSON, CSV, logs \u2014 up to 256KB) come back with their FULL CONTENT inline, PDFs come back as EXTRACTED TEXT plus a signed link to the ORIGINAL file (use the link with jefri_send_file's fileUrl to forward the real bytes \u2014 never reconstruct a file from text), and IMAGES (png/jpeg/gif/webp up to 4MB) come back as the ACTUAL PICTURE you can look at \u2014 so you can read, view and discuss all three directly, no terminal needed. Only video, very large images and other binaries return a download link. On the local connector, files are saved straight to disk. Use this when the user says 'read the file sara sent', 'download that file', 'what does the doc say', etc.",
       inputSchema: {
         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"),
@@ -63762,12 +63799,24 @@ ${fp}`);
               const r = await fetch(`${hub}/api/files/${match.id}/text`, { headers: { authorization: `Bearer ${c.token}` }, signal: ac.signal });
               if (r.ok) {
                 const body = await r.json();
-                if (body?.text)
+                if (body?.text) {
+                  const pdfLink = await mintFileLink(hub, c.token, match.id);
+                  const webPdf = hub.replace("acp-hub.", "acp-web.").replace(":4000", ":4321");
                   return ok3(
-                    `\u{1F4CE} ${fname2} from ${where} \u2014 extracted text (${body.chars ?? body.text.length} chars):
+                    `\u{1F4CE} ${fname2} from ${where} \u2014 THE ORIGINAL FILE:
+` + (pdfLink ? `\u2022 Direct download (valid ~5 minutes): ${pdfLink}
+` : "") + (pdfLink ? forwardTip(pdfLink, fname2) : "") + `\u2022 Web app (renders in the chat): ${webPdf}
+` + // The closing line must only reference what EXISTS: with
+                    // no minted link, "via the link above" pointed at nothing.
+                    (pdfLink ? `Never reconstruct a file from extracted text \u2014 forward the original via the link above.
+
+` : `Never reconstruct a file from extracted text \u2014 the link service didn't answer just now; call jefri_download_file again for a fresh link, or use the web app above.
+
+`) + `\u2014 Extracted text (${body.chars ?? body.text.length} chars):
 
 ` + body.text
                   );
+                }
               }
             } finally {
               clearTimeout(killer);
@@ -63828,17 +63877,11 @@ ${fp}`);
       const cmd = `curl -s --no-clobber --create-dirs -o ${shPathArg(`${DOWNLOAD_DIR_SH}/${out}`)} -H "Authorization: Bearer $JEFRI_TOKEN" ${shq(`${hub}/api/files/${match.id}`)}`;
       const web2 = hub.replace("acp-hub.", "acp-web.").replace(":4000", ":4321");
       let directLink = "";
-      try {
-        const lr = await fetch(`${hub}/api/files/${match.id}/link`, {
-          method: "POST",
-          headers: { authorization: `Bearer ${c.token}` }
-        });
-        if (lr.ok) {
-          const body = await lr.json();
-          if (body?.url) directLink = `\u2022 Direct download (click it \u2014 valid ~5 minutes): ${body.url}
-`;
-        }
-      } catch {
+      {
+        const linkUrl = await mintFileLink(hub, c.token, match.id);
+        if (linkUrl)
+          directLink = `\u2022 Direct download (click it \u2014 valid ~5 minutes): ${linkUrl}
+` + forwardTip(linkUrl, fname2);
       }
       return ok3(
         `\u{1F4CE} ${match.fileName} (${fmime2}) \u2014 I can't show it inline${imageWhy ? `: ${imageWhy}` : " (not a viewable type)"}.
@@ -64250,7 +64293,9 @@ Or just upload ${fname} from the agent's page in the web app.`
           return fail(`Couldn't fetch that URL: ${e2?.message ?? e2}`);
         }
       } else {
-        return fail("provide a local file `path`, a `dataUrl` + `fileName`, or a public `fileUrl`");
+        return fail(
+          "provide a local file `path`, a `dataUrl` + `fileName` (\u2264256KB), or a public `fileUrl`. If the file only exists INSIDE this chat (attached or generated here), the connector can't see it \u2014 ask the user to save it to their computer first, then call again with that path."
+        );
       }
       const rawBytes = Buffer.from(url.split(",")[1] ?? "", "base64");
       if (rawBytes.length > MAX_UPLOAD_BYTES)

package/dist/index.js

@@ -42158,6 +42158,37 @@ var psPathArg = (p) => p.startsWith("~/") || p.startsWith("~\\") ? `($HOME + ${p
 var isTextyFile = (mime, name) => /^text\/|json|xml|javascript|typescript|markdown|csv|ya?ml|x-sh|toml/i.test(mime) || /\.(md|txt|json|csv|ya?ml|log|ts|tsx|js|jsx|py|rb|go|rs|java|c|h|cpp|sh|sql|toml|env|cfg|ini)$/i.test(name);
 var DATAURL_INLINE_MAX = 256 * 1024;
 var dataUrlTooBig = (dataUrl) => dataUrl.length > DATAURL_INLINE_MAX * 1.4 ? `That dataUrl is ~${MB(dataUrl.length * 0.75)} MB decoded \u2014 far past the ${Math.round(DATAURL_INLINE_MAX / 1024)}KB inline limit. NEVER read a local file and base64 it through the model. Call this tool again with the file's PATH \u2014 you'll get a single-use upload command that sends it in seconds.` : null;
+var MINT_LINK_DEADLINE_MS = (() => {
+  const n = Number(process.env.MCP_MINT_LINK_DEADLINE_MS);
+  return Number.isInteger(n) && n > 0 ? n : 1e4;
+})();
+async function mintFileLink(hub, token, fileId) {
+  const ac = new AbortController();
+  const killer = setTimeout(() => ac.abort(), MINT_LINK_DEADLINE_MS);
+  try {
+    const lr = await fetch(`${hub}/api/files/${fileId}/link`, {
+      method: "POST",
+      headers: { authorization: `Bearer ${token}` },
+      signal: ac.signal
+    });
+    if (!lr.ok) {
+      try {
+        await lr.body?.cancel();
+      } catch {
+      }
+      return null;
+    }
+    const body = await lr.json();
+    return body?.url ?? null;
+  } catch {
+    return null;
+  } finally {
+    ac.abort();
+    clearTimeout(killer);
+  }
+}
+var forwardTip = (link2, fileName) => `\u2022 To FORWARD this exact file: to a PERSON call jefri_send_file with to:"<username>", fileUrl:${JSON.stringify(link2)}, fileName:${JSON.stringify(fileName)}; to a GROUP call jefri_send_group_file with groupId:"<id>" and the same fileUrl + fileName. The connector fetches and delivers the ORIGINAL bytes (up to 25 MB).
+`;
 async function remoteUploadCommand(c2, ctx, target, path5, caption, where) {
   const fname = crossBasename(path5);
   const fmime = mimeOf(fname);
@@ -42294,9 +42325,13 @@ function resolveLocalFile(rawPath) {
   return null;
 }
 var MAX_UPLOAD_BYTES = 100 * 1024 * 1024;
-var MAX_REMOTE_URL_BYTES = Number(process.env.MCP_MAX_REMOTE_URL_BYTES ?? 25 * 1024 * 1024);
-var MAX_CONCURRENT_REMOTE_DOWNLOADS = Number(process.env.MCP_MAX_REMOTE_DL ?? 3);
-var REMOTE_DOWNLOAD_DEADLINE_MS = Number(process.env.MCP_REMOTE_DL_DEADLINE_MS ?? 3e4);
+var posIntEnv = (v, dflt) => {
+  const n = Number(v);
+  return Number.isInteger(n) && n > 0 ? n : dflt;
+};
+var MAX_REMOTE_URL_BYTES = posIntEnv(process.env.MCP_MAX_REMOTE_URL_BYTES, 25 * 1024 * 1024);
+var MAX_CONCURRENT_REMOTE_DOWNLOADS = posIntEnv(process.env.MCP_MAX_REMOTE_DL, 3);
+var REMOTE_DOWNLOAD_DEADLINE_MS = posIntEnv(process.env.MCP_REMOTE_DL_DEADLINE_MS, 3e4);
 var activeRemoteDownloads = 0;
 var MB = (n) => (n / 1024 / 1024).toFixed(1);
 var WS_SAFE_FILE_BYTES = 45 * 1024 * 1024;
@@ -43204,7 +43239,9 @@ ${fp}`);
           return fail(`Couldn't fetch that URL: ${e2?.message ?? e2}`);
         }
       } else {
-        return fail("provide a local file `path`, a `dataUrl` + `fileName`, or a public `fileUrl`");
+        return fail(
+          "provide a local file `path`, a `dataUrl` + `fileName` (\u2264256KB), or a public `fileUrl`. If the file only exists INSIDE this chat (attached or generated here), the connector can't see it \u2014 ask the user to save it to their computer first, then call again with that path."
+        );
       }
       const rawBytes = Buffer.from(url.split(",")[1] ?? "", "base64");
       if (rawBytes.length > MAX_UPLOAD_BYTES)
@@ -43394,7 +43431,7 @@ ${fp}`);
     "jefri_download_file",
     {
       title: "Read or save a file someone sent you",
-      description: "Get a file another agent/user sent you. For a DM give the sender's username `from`; for a GROUP file give `groupId` (from jefri_groups / jefri_inbox). Add `fileName` if there are several. TEXT files (code, markdown, JSON, CSV, logs \u2014 up to 256KB) come back with their FULL CONTENT inline, PDFs come back as EXTRACTED TEXT, and IMAGES (png/jpeg/gif/webp up to 4MB) come back as the ACTUAL PICTURE you can look at \u2014 so you can read, view and discuss all three directly, no terminal needed. Only video, very large images and other binaries return a download link. On the local connector, files are saved straight to disk. Use this when the user says 'read the file sara sent', 'download that file', 'what does the doc say', etc.",
+      description: "Get a file another agent/user sent you. For a DM give the sender's username `from`; for a GROUP file give `groupId` (from jefri_groups / jefri_inbox). Add `fileName` if there are several. TEXT files (code, markdown, JSON, CSV, logs \u2014 up to 256KB) come back with their FULL CONTENT inline, PDFs come back as EXTRACTED TEXT plus a signed link to the ORIGINAL file (use the link with jefri_send_file's fileUrl to forward the real bytes \u2014 never reconstruct a file from text), and IMAGES (png/jpeg/gif/webp up to 4MB) come back as the ACTUAL PICTURE you can look at \u2014 so you can read, view and discuss all three directly, no terminal needed. Only video, very large images and other binaries return a download link. On the local connector, files are saved straight to disk. Use this when the user says 'read the file sara sent', 'download that file', 'what does the doc say', etc.",
       inputSchema: {
         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"),
@@ -43485,12 +43522,24 @@ ${fp}`);
               const r = await fetch(`${hub}/api/files/${match.id}/text`, { headers: { authorization: `Bearer ${c2.token}` }, signal: ac.signal });
               if (r.ok) {
                 const body = await r.json();
-                if (body?.text)
+                if (body?.text) {
+                  const pdfLink = await mintFileLink(hub, c2.token, match.id);
+                  const webPdf = hub.replace("acp-hub.", "acp-web.").replace(":4000", ":4321");
                   return ok3(
-                    `\u{1F4CE} ${fname2} from ${where} \u2014 extracted text (${body.chars ?? body.text.length} chars):
+                    `\u{1F4CE} ${fname2} from ${where} \u2014 THE ORIGINAL FILE:
+` + (pdfLink ? `\u2022 Direct download (valid ~5 minutes): ${pdfLink}
+` : "") + (pdfLink ? forwardTip(pdfLink, fname2) : "") + `\u2022 Web app (renders in the chat): ${webPdf}
+` + // The closing line must only reference what EXISTS: with
+                    // no minted link, "via the link above" pointed at nothing.
+                    (pdfLink ? `Never reconstruct a file from extracted text \u2014 forward the original via the link above.
+
+` : `Never reconstruct a file from extracted text \u2014 the link service didn't answer just now; call jefri_download_file again for a fresh link, or use the web app above.
+
+`) + `\u2014 Extracted text (${body.chars ?? body.text.length} chars):
 
 ` + body.text
                   );
+                }
               }
             } finally {
               clearTimeout(killer);
@@ -43551,17 +43600,11 @@ ${fp}`);
       const cmd = `curl -s --no-clobber --create-dirs -o ${shPathArg(`${DOWNLOAD_DIR_SH}/${out}`)} -H "Authorization: Bearer $JEFRI_TOKEN" ${shq(`${hub}/api/files/${match.id}`)}`;
       const web2 = hub.replace("acp-hub.", "acp-web.").replace(":4000", ":4321");
       let directLink = "";
-      try {
-        const lr = await fetch(`${hub}/api/files/${match.id}/link`, {
-          method: "POST",
-          headers: { authorization: `Bearer ${c2.token}` }
-        });
-        if (lr.ok) {
-          const body = await lr.json();
-          if (body?.url) directLink = `\u2022 Direct download (click it \u2014 valid ~5 minutes): ${body.url}
-`;
-        }
-      } catch {
+      {
+        const linkUrl = await mintFileLink(hub, c2.token, match.id);
+        if (linkUrl)
+          directLink = `\u2022 Direct download (click it \u2014 valid ~5 minutes): ${linkUrl}
+` + forwardTip(linkUrl, fname2);
       }
       return ok3(
         `\u{1F4CE} ${match.fileName} (${fmime2}) \u2014 I can't show it inline${imageWhy ? `: ${imageWhy}` : " (not a viewable type)"}.
@@ -43973,7 +44016,9 @@ Or just upload ${fname} from the agent's page in the web app.`
           return fail(`Couldn't fetch that URL: ${e2?.message ?? e2}`);
         }
       } else {
-        return fail("provide a local file `path`, a `dataUrl` + `fileName`, or a public `fileUrl`");
+        return fail(
+          "provide a local file `path`, a `dataUrl` + `fileName` (\u2264256KB), or a public `fileUrl`. If the file only exists INSIDE this chat (attached or generated here), the connector can't see it \u2014 ask the user to save it to their computer first, then call again with that path."
+        );
       }
       const rawBytes = Buffer.from(url.split(",")[1] ?? "", "base64");
       if (rawBytes.length > MAX_UPLOAD_BYTES)

package/package.json

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