yungle-mcp 0.3.0 → 0.3.2

package/README.md

@@ -61,7 +61,7 @@ Or by hand:
 | `get_account`, `list_transfers`, `get_transfer`, `get_transfer_downloads`, `list_collections`, `get_collection`, `list_collection_files`, `list_folders`, `list_guests`, `list_contacts`, `list_upload_requests`, `get_upload_request` | read | Answer questions about your transfers, collections, contacts and upload requests |
 | `get_download_links` | read | Signed, resumable download URLs for a link someone shared (`/t/…`, `/c/…`) or your own transfer or collection |
 | `get_import_status` | write | How far the files Yungle is fetching from URLs have got |
-| `create_transfer` | read | Prepare a draft and get one keyless `npx yungle-cli put …` command per file, for an assistant with a shell |
+| `create_transfer` | write | Prepare a draft and get one keyless `npx yungle-cli put …` command per file, for an assistant with a shell |
 | `finalize_transfer` | write | Make a prepared draft a link. Emails nobody |
 | `share_from_urls` | write | Share files that are already online (a presigned S3 link, a CDN URL) — Yungle fetches them, so any size works, hosted too. Emails nobody |
 | `create_share_link` | write | Turn content the assistant has (up to 25 MB) into a link. Emails nobody |
@@ -91,7 +91,7 @@ can put that in the message of a transfer they send you. So:
 ## Not reachable
 
 Your vault and end-to-end encrypted transfers: their keys are derived in the browser and never
-sent to Yungle. See <https://yungle.co/developers/unsupported>.
+sent to Yungle. See <https://docs.yungle.co/unsupported>.
 
-Docs: <https://yungle.co/developers/mcp?ref=npm> · Source:
+Docs: <https://docs.yungle.co/mcp-server?ref=npm> · Source:
 <https://github.com/heindewilde/yungle-clients> · MIT

package/dist/index.mjs

@@ -121,7 +121,7 @@ async function fetchTo(url, dest, size, doFetch) {
 }
 
 // src/server.ts
-var MCP_VERSION = true ? "0.3.0" : "dev";
+var MCP_VERSION = true ? "0.3.2" : "dev";
 function createServer(client, opts = { canWrite: false, canEmail: false, local: false }) {
   const server = new McpServer(
     { name: "yungle", version: MCP_VERSION },
@@ -359,60 +359,62 @@ function createServer(client, opts = { canWrite: false, canEmail: false, local:
       }
     );
   }
-  server.registerTool(
-    "create_transfer",
-    {
-      title: "Prepare a transfer",
-      description: [
-        "Prepare a draft transfer for files that live on a machine with a shell, and return one",
-        "upload command per file. Each command (`npx -y yungle-cli put \u2026`) needs no Yungle key: it",
-        "carries a token that can write only that file, for two hours, and it resumes if interrupted.",
-        "Nothing is shared and nobody is emailed until the transfer is finalized."
-      ].join("\n"),
-      inputSchema: {
-        files: z.array(
-          z.object({
-            name: z.string(),
-            size: z.number().int().nonnegative().describe("Exact byte size."),
-            path: z.string().optional().describe("Folder within the upload."),
-            localPath: z.string().optional().describe("Where the file is on the machine that will run the command.")
-          })
-        ).min(1).max(500),
-        title: z.string().optional().describe("Label for the dashboard; never shown to recipients."),
-        expiresInDays: z.number().int().positive().optional()
+  if (opts.canWrite) {
+    server.registerTool(
+      "create_transfer",
+      {
+        title: "Prepare a transfer",
+        description: [
+          "Prepare a draft transfer for files that live on a machine with a shell, and return one",
+          "upload command per file. Each command (`npx -y yungle-cli put \u2026`) needs no Yungle key: it",
+          "carries a token that can write only that file, for two hours, and it resumes if interrupted.",
+          "Nothing is shared and nobody is emailed until the transfer is finalized."
+        ].join("\n"),
+        inputSchema: {
+          files: z.array(
+            z.object({
+              name: z.string(),
+              size: z.number().int().nonnegative().describe("Exact byte size."),
+              path: z.string().optional().describe("Folder within the upload."),
+              localPath: z.string().optional().describe("Where the file is on the machine that will run the command.")
+            })
+          ).min(1).max(500),
+          title: z.string().optional().describe("Label for the dashboard; never shown to recipients."),
+          expiresInDays: z.number().int().positive().optional()
+        },
+        annotations: { title: "Prepare a transfer", readOnlyHint: false, destructiveHint: false, idempotentHint: false }
       },
-      annotations: { title: "Prepare a transfer", readOnlyHint: false, destructiveHint: false, idempotentHint: false }
-    },
-    async ({ files, title, expiresInDays }) => {
-      try {
-        const created = await client.createTransfer({
-          files: files.map(({ localPath: _local, ...f }) => f),
-          title,
-          expiresInDays
-        });
-        return ok({
-          transferId: created.transfer.id,
-          // Said in the payload, not only the description: the payload is what a
-          // model summarises back to the user.
-          status: "draft \u2014 nothing uploaded yet, nobody emailed",
-          uploadCommands: created.files.map((t, i) => ({
-            name: t.name,
-            command: `npx -y yungle-cli@latest put ${shellQuote(files[i].localPath ?? `./${t.name}`)} --target ${packTarget({
-              e: created.tusEndpoint,
-              i: t.id,
-              t: t.uploadToken,
-              n: t.name,
-              s: t.size
-            })}`
-          })),
-          next: "Run each command where the file is. When they have finished, finalize the transfer to get its link \u2014 or upload in the Yungle dashboard instead.",
-          expiresAt: created.transfer.expiresAt
-        });
-      } catch (err) {
-        return fail(errorText(err));
+      async ({ files, title, expiresInDays }) => {
+        try {
+          const created = await client.createTransfer({
+            files: files.map(({ localPath: _local, ...f }) => f),
+            title,
+            expiresInDays
+          });
+          return ok({
+            transferId: created.transfer.id,
+            // Said in the payload, not only the description: the payload is what a
+            // model summarises back to the user.
+            status: "draft \u2014 nothing uploaded yet, nobody emailed",
+            uploadCommands: created.files.map((t, i) => ({
+              name: t.name,
+              command: `npx -y yungle-cli@latest put ${shellQuote(files[i].localPath ?? `./${t.name}`)} --target ${packTarget({
+                e: created.tusEndpoint,
+                i: t.id,
+                t: t.uploadToken,
+                n: t.name,
+                s: t.size
+              })}`
+            })),
+            next: "Run each command where the file is. When they have finished, finalize the transfer to get its link \u2014 or upload in the Yungle dashboard instead.",
+            expiresAt: created.transfer.expiresAt
+          });
+        } catch (err) {
+          return fail(errorText(err));
+        }
       }
-    }
-  );
+    );
+  }
   if (opts.canWrite) {
     server.registerTool(
       "finalize_transfer",

package/dist/server.mjs

@@ -222,7 +222,7 @@ function pageQuery(page, extra = {}) {
   const q = params.toString();
   return q ? `?${q}` : "";
 }
-var CLIENT_VERSION = true ? "0.3.0" : "dev";
+var CLIENT_VERSION = true ? "0.3.2" : "dev";
 var YungleClient = class {
   baseUrl;
   apiKey;
@@ -262,6 +262,10 @@ var YungleClient = class {
   me() {
     return this.request("GET", "/me");
   }
+  /** Your invite code and link, and the free months it has earned. */
+  getReferral() {
+    return this.request("GET", "/me/referral");
+  }
   // ── Transfers ─────────────────────────────────────────────────────────────
   /**
    * One page of transfers, newest first — 100 by default, up to 500. Pass the
@@ -506,22 +510,31 @@ var YungleClient = class {
     const safe = method === "GET" || method === "DELETE" || idempotencyKey !== void 0 || opts?.idempotent === true;
     let attempt = 0;
     for (; ; ) {
-      const res = await this.doFetch(`${this.baseUrl}${path}`, {
-        method,
-        headers: {
-          Authorization: `Bearer ${this.apiKey}`,
-          Accept: "application/json",
-          "User-Agent": this.userAgent,
-          ...idempotencyKey ? { "Idempotency-Key": idempotencyKey } : {},
-          ...body === void 0 ? {} : { "Content-Type": "application/json" }
-        },
-        ...body === void 0 ? {} : { body: JSON.stringify(body) }
-      });
+      let res;
+      try {
+        res = await this.doFetch(`${this.baseUrl}${path}`, {
+          method,
+          headers: {
+            Authorization: `Bearer ${this.apiKey}`,
+            Accept: "application/json",
+            "User-Agent": this.userAgent,
+            ...idempotencyKey ? { "Idempotency-Key": idempotencyKey } : {},
+            ...body === void 0 ? {} : { "Content-Type": "application/json" }
+          },
+          ...body === void 0 ? {} : { body: JSON.stringify(body) }
+        });
+      } catch (err) {
+        const aborted = err instanceof Error && (err.name === "AbortError" || err.name === "TimeoutError");
+        if (aborted || !safe || attempt >= this.maxRetries) throw err;
+        await sleep(backoffMs(attempt, null));
+        attempt++;
+        continue;
+      }
       if (res.ok) return await res.json();
       const error = await toError(res);
       const mayRetry = error.status === 429 || safe && error.retryable;
       if (!mayRetry || attempt >= this.maxRetries) throw error;
-      await sleep(backoffMs(attempt, error));
+      await sleep(backoffMs(attempt, error.retryAfterSeconds));
       attempt++;
     }
   }
@@ -557,8 +570,7 @@ function parseRetryAfter(value, now = Date.now()) {
   const seconds = Math.ceil((at - now) / 1e3);
   return seconds >= 0 ? seconds : null;
 }
-function backoffMs(attempt, error) {
-  const stated = error.retryAfterSeconds;
+function backoffMs(attempt, stated) {
   if (stated !== null) return stated * 1e3;
   return Math.min(2 ** attempt * 500, 8e3) + Math.floor(Math.random() * 250);
 }
@@ -686,7 +698,7 @@ async function fetchTo(url, dest, size, doFetch) {
 }
 
 // src/server.ts
-var MCP_VERSION = true ? "0.3.0" : "dev";
+var MCP_VERSION = true ? "0.3.2" : "dev";
 function createServer(client, opts = { canWrite: false, canEmail: false, local: false }) {
   const server = new McpServer(
     { name: "yungle", version: MCP_VERSION },
@@ -924,60 +936,62 @@ function createServer(client, opts = { canWrite: false, canEmail: false, local:
       }
     );
   }
-  server.registerTool(
-    "create_transfer",
-    {
-      title: "Prepare a transfer",
-      description: [
-        "Prepare a draft transfer for files that live on a machine with a shell, and return one",
-        "upload command per file. Each command (`npx -y yungle-cli put \u2026`) needs no Yungle key: it",
-        "carries a token that can write only that file, for two hours, and it resumes if interrupted.",
-        "Nothing is shared and nobody is emailed until the transfer is finalized."
-      ].join("\n"),
-      inputSchema: {
-        files: z.array(
-          z.object({
-            name: z.string(),
-            size: z.number().int().nonnegative().describe("Exact byte size."),
-            path: z.string().optional().describe("Folder within the upload."),
-            localPath: z.string().optional().describe("Where the file is on the machine that will run the command.")
-          })
-        ).min(1).max(500),
-        title: z.string().optional().describe("Label for the dashboard; never shown to recipients."),
-        expiresInDays: z.number().int().positive().optional()
+  if (opts.canWrite) {
+    server.registerTool(
+      "create_transfer",
+      {
+        title: "Prepare a transfer",
+        description: [
+          "Prepare a draft transfer for files that live on a machine with a shell, and return one",
+          "upload command per file. Each command (`npx -y yungle-cli put \u2026`) needs no Yungle key: it",
+          "carries a token that can write only that file, for two hours, and it resumes if interrupted.",
+          "Nothing is shared and nobody is emailed until the transfer is finalized."
+        ].join("\n"),
+        inputSchema: {
+          files: z.array(
+            z.object({
+              name: z.string(),
+              size: z.number().int().nonnegative().describe("Exact byte size."),
+              path: z.string().optional().describe("Folder within the upload."),
+              localPath: z.string().optional().describe("Where the file is on the machine that will run the command.")
+            })
+          ).min(1).max(500),
+          title: z.string().optional().describe("Label for the dashboard; never shown to recipients."),
+          expiresInDays: z.number().int().positive().optional()
+        },
+        annotations: { title: "Prepare a transfer", readOnlyHint: false, destructiveHint: false, idempotentHint: false }
       },
-      annotations: { title: "Prepare a transfer", readOnlyHint: false, destructiveHint: false, idempotentHint: false }
-    },
-    async ({ files, title, expiresInDays }) => {
-      try {
-        const created = await client.createTransfer({
-          files: files.map(({ localPath: _local, ...f }) => f),
-          title,
-          expiresInDays
-        });
-        return ok({
-          transferId: created.transfer.id,
-          // Said in the payload, not only the description: the payload is what a
-          // model summarises back to the user.
-          status: "draft \u2014 nothing uploaded yet, nobody emailed",
-          uploadCommands: created.files.map((t, i) => ({
-            name: t.name,
-            command: `npx -y yungle-cli@latest put ${shellQuote(files[i].localPath ?? `./${t.name}`)} --target ${packTarget({
-              e: created.tusEndpoint,
-              i: t.id,
-              t: t.uploadToken,
-              n: t.name,
-              s: t.size
-            })}`
-          })),
-          next: "Run each command where the file is. When they have finished, finalize the transfer to get its link \u2014 or upload in the Yungle dashboard instead.",
-          expiresAt: created.transfer.expiresAt
-        });
-      } catch (err) {
-        return fail(errorText(err));
+      async ({ files, title, expiresInDays }) => {
+        try {
+          const created = await client.createTransfer({
+            files: files.map(({ localPath: _local, ...f }) => f),
+            title,
+            expiresInDays
+          });
+          return ok({
+            transferId: created.transfer.id,
+            // Said in the payload, not only the description: the payload is what a
+            // model summarises back to the user.
+            status: "draft \u2014 nothing uploaded yet, nobody emailed",
+            uploadCommands: created.files.map((t, i) => ({
+              name: t.name,
+              command: `npx -y yungle-cli@latest put ${shellQuote(files[i].localPath ?? `./${t.name}`)} --target ${packTarget({
+                e: created.tusEndpoint,
+                i: t.id,
+                t: t.uploadToken,
+                n: t.name,
+                s: t.size
+              })}`
+            })),
+            next: "Run each command where the file is. When they have finished, finalize the transfer to get its link \u2014 or upload in the Yungle dashboard instead.",
+            expiresAt: created.transfer.expiresAt
+          });
+        } catch (err) {
+          return fail(errorText(err));
+        }
       }
-    }
-  );
+    );
+  }
   if (opts.canWrite) {
     server.registerTool(
       "finalize_transfer",

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "yungle-mcp",
   "mcpName": "co.yungle/yungle",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "type": "module",
   "description": "MCP server for Yungle: let Claude, Cursor or any MCP client read your file transfers, share files and send them, with your approval.",
   "bin": {
@@ -15,7 +15,7 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.0.0",
     "zod": "^3.24.1",
-    "yungle-client": "^0.3.0"
+    "yungle-client": "^0.3.2"
   },
   "devDependencies": {
     "@types/node": "^22.10.5",
@@ -43,7 +43,7 @@
     "type": "git",
     "url": "git+https://github.com/heindewilde/yungle-clients.git"
   },
-  "homepage": "https://yungle.co/developers/mcp?ref=npm",
+  "homepage": "https://docs.yungle.co/mcp-server?ref=npm",
   "bugs": {
     "url": "https://github.com/heindewilde/yungle-clients/issues"
   },