@drop2run/mcp 0.5.0 → 0.6.0

package/README.md

@@ -1,7 +1,8 @@
 # @drop2run/mcp
 
-An MCP server that lets Claude — or any MCP client — publish a static site to
-[Drop2Run](https://dropto.run). Give it a folder or an HTML document; it returns a live HTTPS URL.
+An MCP server that lets Claude — or any MCP client — publish what it made to
+[Drop2Run](https://dropto.run): an HTML page, a markdown note, a folder of documents or a built site. It
+returns a live HTTPS URL.
 
 Full documentation at [dropto.run/docs/mcp](https://dropto.run/docs/mcp).
 
@@ -89,8 +90,9 @@ it as `subdomain`; say nothing and the name is generated, which is the right def
 nobody is going to link to.
 
 **A site can be documents instead of a built site.** A publish needs an `index.html` at the top level,
-or at least one `.md`, `.markdown` or `.pdf` file — those are served through the reader. So a single
-note is a whole site, and Claude does not have to wrap it in HTML to publish it.
+or at least one document — `.md`, `.markdown`, `.pdf`, `.docx`, `.xlsx` or `.epub` — and those are
+served through the reader. So a single note is a whole site, and Claude does not have to wrap it in HTML
+to publish it.
 
 **`publish_files` is text.** A PDF or an image has to come off a disk with `publish_dir`, because these
 files arrive as JSON strings.

package/dist/index.js

@@ -374,6 +374,485 @@ async function problemToError(response) {
   const message = typeof problem.detail === "string" ? problem.detail : typeof problem.title === "string" ? problem.title : `The server responded with ${response.status}.`;
   return new DeployError(code, message, problem);
 }
+const FILE_TYPES = [
+  // Documents. The three extensions that make a folder a documents site.
+  {
+    ext: ".md",
+    mime: "text/markdown; charset=utf-8",
+    kind: "markdown",
+    document: true,
+    reader: true,
+    editable: true
+  },
+  {
+    ext: ".markdown",
+    mime: "text/markdown; charset=utf-8",
+    kind: "markdown",
+    document: true,
+    reader: true,
+    editable: true
+  },
+  {
+    ext: ".pdf",
+    mime: "application/pdf",
+    kind: "pdf",
+    document: true,
+    reader: true,
+    editable: false
+  },
+  // Office documents and ebooks. Each has its own kind because each needs its own renderer, loaded
+  // only when one is opened — `.docx` through mammoth, `.xlsx` through read-excel-file, `.epub`
+  // through foliate-js.
+  {
+    ext: ".docx",
+    mime: "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
+    kind: "docx",
+    document: true,
+    reader: true,
+    editable: false
+  },
+  {
+    ext: ".xlsx",
+    mime: "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
+    kind: "xlsx",
+    document: true,
+    reader: true,
+    editable: false
+  },
+  {
+    ext: ".epub",
+    mime: "application/epub+zip",
+    kind: "epub",
+    document: true,
+    reader: true,
+    editable: false
+  },
+  // Prose the reader shows preformatted.
+  {
+    ext: ".txt",
+    mime: "text/plain; charset=utf-8",
+    kind: "text",
+    document: false,
+    reader: true,
+    editable: true
+  },
+  {
+    ext: ".log",
+    mime: "text/plain; charset=utf-8",
+    kind: "text",
+    document: false,
+    reader: true,
+    editable: false
+  },
+  {
+    ext: ".csv",
+    mime: "text/csv; charset=utf-8",
+    kind: "text",
+    document: false,
+    reader: true,
+    editable: true
+  },
+  // Structured text. Read through the reader inside a folder of notes, which is why these carry
+  // `reader: true` while the source formats below do not.
+  {
+    ext: ".json",
+    mime: "application/json",
+    kind: "code",
+    document: false,
+    reader: true,
+    editable: true
+  },
+  {
+    ext: ".yaml",
+    mime: "text/yaml; charset=utf-8",
+    kind: "code",
+    document: false,
+    reader: true,
+    editable: true
+  },
+  {
+    ext: ".yml",
+    mime: "text/yaml; charset=utf-8",
+    kind: "code",
+    document: false,
+    reader: true,
+    editable: true
+  },
+  {
+    // No registered media type, so it takes text/plain rather than an invented one. The point is
+    // only that a browser shows it instead of downloading it.
+    ext: ".toml",
+    mime: "text/plain; charset=utf-8",
+    kind: "code",
+    document: false,
+    reader: true,
+    editable: true
+  },
+  // Source the viewer highlights. A link straight to one of these hands over the file.
+  {
+    ext: ".css",
+    mime: "text/css; charset=utf-8",
+    kind: "code",
+    document: false,
+    reader: false,
+    editable: true
+  },
+  {
+    ext: ".js",
+    mime: "text/javascript; charset=utf-8",
+    kind: "code",
+    document: false,
+    reader: false,
+    editable: true
+  },
+  {
+    ext: ".ts",
+    mime: null,
+    kind: "code",
+    document: false,
+    reader: false,
+    editable: false
+  },
+  {
+    ext: ".tsx",
+    mime: null,
+    kind: "code",
+    document: false,
+    reader: false,
+    editable: false
+  },
+  {
+    ext: ".jsx",
+    mime: null,
+    kind: "code",
+    document: false,
+    reader: false,
+    editable: false
+  },
+  {
+    ext: ".sh",
+    mime: null,
+    kind: "code",
+    document: false,
+    reader: false,
+    editable: false
+  },
+  // The languages an assistant writes most, beyond the web's own. Same row as `.ts`: shown as source
+  // when somebody opens one in the reader or publishes it on its own, handed over as a file when a
+  // link names it directly, and no media type — adding one changes what a browser does with a
+  // published file, which I10 makes a decision of its own rather than a side effect of this list.
+  {
+    ext: ".py",
+    mime: null,
+    kind: "code",
+    document: false,
+    reader: false,
+    editable: false
+  },
+  {
+    ext: ".sql",
+    mime: null,
+    kind: "code",
+    document: false,
+    reader: false,
+    editable: false
+  },
+  {
+    ext: ".go",
+    mime: null,
+    kind: "code",
+    document: false,
+    reader: false,
+    editable: false
+  },
+  {
+    ext: ".rs",
+    mime: null,
+    kind: "code",
+    document: false,
+    reader: false,
+    editable: false
+  },
+  {
+    ext: ".java",
+    mime: null,
+    kind: "code",
+    document: false,
+    reader: false,
+    editable: false
+  },
+  {
+    ext: ".kt",
+    mime: null,
+    kind: "code",
+    document: false,
+    reader: false,
+    editable: false
+  },
+  {
+    ext: ".swift",
+    mime: null,
+    kind: "code",
+    document: false,
+    reader: false,
+    editable: false
+  },
+  {
+    ext: ".rb",
+    mime: null,
+    kind: "code",
+    document: false,
+    reader: false,
+    editable: false
+  },
+  {
+    ext: ".php",
+    mime: null,
+    kind: "code",
+    document: false,
+    reader: false,
+    editable: false
+  },
+  {
+    ext: ".c",
+    mime: null,
+    kind: "code",
+    document: false,
+    reader: false,
+    editable: false
+  },
+  {
+    ext: ".h",
+    mime: null,
+    kind: "code",
+    document: false,
+    reader: false,
+    editable: false
+  },
+  {
+    ext: ".cpp",
+    mime: null,
+    kind: "code",
+    document: false,
+    reader: false,
+    editable: false
+  },
+  {
+    ext: ".cs",
+    mime: null,
+    kind: "code",
+    document: false,
+    reader: false,
+    editable: false
+  },
+  {
+    ext: ".r",
+    mime: null,
+    kind: "code",
+    document: false,
+    reader: false,
+    editable: false
+  },
+  {
+    ext: ".xml",
+    mime: "application/xml",
+    kind: "code",
+    document: false,
+    reader: false,
+    editable: true
+  },
+  // Pictures, shown with an img element.
+  {
+    ext: ".png",
+    mime: "image/png",
+    kind: "image",
+    document: false,
+    reader: false,
+    editable: false
+  },
+  {
+    ext: ".jpg",
+    mime: "image/jpeg",
+    kind: "image",
+    document: false,
+    reader: false,
+    editable: false
+  },
+  {
+    ext: ".jpeg",
+    mime: "image/jpeg",
+    kind: "image",
+    document: false,
+    reader: false,
+    editable: false
+  },
+  {
+    ext: ".gif",
+    mime: "image/gif",
+    kind: "image",
+    document: false,
+    reader: false,
+    editable: false
+  },
+  {
+    ext: ".webp",
+    mime: "image/webp",
+    kind: "image",
+    document: false,
+    reader: false,
+    editable: false
+  },
+  {
+    ext: ".avif",
+    mime: "image/avif",
+    kind: "image",
+    document: false,
+    reader: false,
+    editable: false
+  },
+  {
+    // Text, hand-edited in practice, and script-carrying. Editable anyway: the Worker derives the
+    // type at serve time (I10) and already serves whatever was uploaded, so withholding the edit
+    // would withhold nothing else.
+    ext: ".svg",
+    mime: "image/svg+xml",
+    kind: "image",
+    document: false,
+    reader: false,
+    editable: true
+  },
+  {
+    ext: ".ico",
+    mime: "image/x-icon",
+    kind: "image",
+    document: false,
+    reader: false,
+    editable: false
+  },
+  // A customer's own pages. Never rendered inside the reader.
+  {
+    ext: ".html",
+    mime: "text/html; charset=utf-8",
+    kind: "html",
+    document: false,
+    reader: false,
+    editable: true
+  },
+  {
+    // ⚠️ No media type, and that is the state of the code rather than a decision: `TYPES` in
+    // `headers.ts` has never held `htm`, so a published `.htm` is served as octet-stream and
+    // downloads instead of rendering. Recorded here rather than fixed, because this table was
+    // introduced as a refactor and a refactor that changes what a URL answers is not one.
+    ext: ".htm",
+    mime: null,
+    kind: "html",
+    document: false,
+    reader: false,
+    editable: true
+  },
+  // Everything below renders as nothing — the viewer offers a download — but still needs a media
+  // type, because these are the files a static site is built out of.
+  {
+    ext: ".mjs",
+    mime: "text/javascript; charset=utf-8",
+    kind: "binary",
+    document: false,
+    reader: false,
+    editable: true
+  },
+  {
+    ext: ".cjs",
+    mime: null,
+    kind: "binary",
+    document: false,
+    reader: false,
+    editable: true
+  },
+  {
+    ext: ".map",
+    mime: "application/json",
+    kind: "binary",
+    document: false,
+    reader: false,
+    editable: false
+  },
+  {
+    ext: ".wasm",
+    mime: "application/wasm",
+    kind: "binary",
+    document: false,
+    reader: false,
+    editable: false
+  },
+  {
+    ext: ".woff2",
+    mime: "font/woff2",
+    kind: "binary",
+    document: false,
+    reader: false,
+    editable: false
+  },
+  {
+    ext: ".woff",
+    mime: "font/woff",
+    kind: "binary",
+    document: false,
+    reader: false,
+    editable: false
+  },
+  {
+    ext: ".ttf",
+    mime: "font/ttf",
+    kind: "binary",
+    document: false,
+    reader: false,
+    editable: false
+  },
+  {
+    ext: ".mp4",
+    mime: "video/mp4",
+    kind: "binary",
+    document: false,
+    reader: false,
+    editable: false
+  },
+  {
+    ext: ".webm",
+    mime: "video/webm",
+    kind: "binary",
+    document: false,
+    reader: false,
+    editable: false
+  }
+];
+function extensionsWhere(include) {
+  return FILE_TYPES.filter(include).map((type) => type.ext);
+}
+const DOCUMENT_EXTENSIONS$1 = extensionsWhere((type) => type.document);
+const VIEWABLE_EXTENSIONS$1 = extensionsWhere(
+  (type) => type.kind !== "binary"
+);
+extensionsWhere((type) => type.reader);
+extensionsWhere((type) => type.editable);
+const WEB_ASSET_EXTENSIONS = [
+  ".html",
+  ".htm",
+  ".js",
+  ".mjs",
+  ".cjs",
+  ".css"
+];
+const GALLERY_EXTENSIONS = extensionsWhere(
+  (type) => type.kind === "image"
+);
+Object.fromEntries(
+  FILE_TYPES.filter((type) => type.mime !== null).map((type) => [type.ext, type.mime])
+);
+function extensionOf(path) {
+  const name = path.slice(path.lastIndexOf("/") + 1);
+  const dot = name.lastIndexOf(".");
+  return dot <= 0 ? "" : name.slice(dot).toLowerCase();
+}
 async function sha256Hex(bytes) {
   const digest = await crypto.subtle.digest("SHA-256", bytes.slice().buffer);
   return [...new Uint8Array(digest)].map((byte) => byte.toString(16).padStart(2, "0")).join("");
@@ -405,52 +884,29 @@ function shouldIgnore(path) {
   return segments.some((segment) => IGNORED_DIRECTORIES.includes(segment));
 }
 const REQUIRED_INDEX = "index.html";
-const DOCUMENT_EXTENSIONS = [".md", ".markdown", ".pdf"];
+const DOCUMENT_EXTENSIONS = DOCUMENT_EXTENSIONS$1;
 function isDocumentPath(path) {
   const lower = path.toLowerCase();
   return DOCUMENT_EXTENSIONS.some((extension) => lower.endsWith(extension));
 }
-const VIEWABLE_EXTENSIONS = [
-  // Documents — these also count at any depth, via DOCUMENT_EXTENSIONS.
-  ".md",
-  ".markdown",
-  ".pdf",
-  // Prose the reader shows preformatted.
-  ".txt",
-  ".log",
-  ".csv",
-  // Source the reader shows with highlighting.
-  ".json",
-  ".yaml",
-  ".yml",
-  ".toml",
-  ".css",
-  ".js",
-  ".ts",
-  ".tsx",
-  ".jsx",
-  ".sh",
-  ".xml",
-  // Pictures the reader shows with an img element.
-  ".png",
-  ".jpg",
-  ".jpeg",
-  ".gif",
-  ".webp",
-  ".avif",
-  ".svg",
-  ".ico",
-  // See the note above: a floor for a caller that did not rename it.
-  ".html",
-  ".htm"
-];
+const VIEWABLE_EXTENSIONS = VIEWABLE_EXTENSIONS$1;
 function isViewablePath(path) {
   const lower = path.toLowerCase();
   return VIEWABLE_EXTENSIONS.some((extension) => lower.endsWith(extension));
 }
+function isImageFolder(paths) {
+  let pictures = false;
+  for (const path of paths) {
+    const ext = extensionOf(path);
+    if (WEB_ASSET_EXTENSIONS.includes(ext)) return false;
+    if (GALLERY_EXTENSIONS.includes(ext)) pictures = true;
+  }
+  return pictures;
+}
 function canPublish(paths) {
   if (paths.some((path) => path === REQUIRED_INDEX)) return true;
   if (paths.some(isDocumentPath)) return true;
+  if (isImageFolder(paths)) return true;
   return paths.length === 1 && paths[0] !== void 0 && isViewablePath(paths[0]);
 }
 function renameOfLoneHtmlPage(paths) {
@@ -479,37 +935,42 @@ function checkLimits(files, limits) {
       `A site needs an ${REQUIRED_INDEX} at its top level, or at least one .md or .pdf file to publish as a documents site — or be a single file that can be displayed on its own, such as a note, a PDF, a page or an image. Drop the folder that contains it, not the folder above.`
     );
   }
-  if (!limits) return;
+  const refusal = sizeRefusal(
+    files.map((file) => ({ path: file.path, size: file.bytes.length })),
+    limits
+  );
+  if (refusal) throw refusal;
+}
+function sizeRefusal(files, limits) {
+  if (!limits) return null;
   if (files.length > limits.maxFiles) {
-    throw new DeployError(
+    return new DeployError(
       ClientErrorCode.TooManyFiles,
       `That is ${files.length} files, and this plan allows ${limits.maxFiles}.`,
       { limit: limits.maxFiles, actual: files.length }
     );
   }
-  const oversized = files.find((file) => file.bytes.length > limits.maxFileBytes);
+  const oversized = files.find((file) => file.size > limits.maxFileBytes);
   if (oversized) {
-    throw new DeployError(
+    return new DeployError(
       ClientErrorCode.FileTooLarge,
-      `${oversized.path} is ${formatBytes(oversized.bytes.length)}, and this plan allows ${formatBytes(limits.maxFileBytes)} per file.`,
+      `${oversized.path} is ${formatBytes(oversized.size)}, and this plan allows ${formatBytes(limits.maxFileBytes)} per file.`,
       {
         path: oversized.path,
         limit: limits.maxFileBytes,
-        actual: oversized.bytes.length
+        actual: oversized.size
       }
     );
   }
-  const total = totalBytes(files);
+  const total = files.reduce((sum, file) => sum + file.size, 0);
   if (limits.maxSiteBytes !== null && total > limits.maxSiteBytes) {
-    throw new DeployError(
+    return new DeployError(
       ClientErrorCode.TooLarge,
       `That drop is ${formatBytes(total)}, and this plan allows ${formatBytes(limits.maxSiteBytes)}.`,
       { limit: limits.maxSiteBytes, actual: total }
     );
   }
-}
-function totalBytes(files) {
-  return files.reduce((sum, file) => sum + file.bytes.length, 0);
+  return null;
 }
 const MAX_NAME_LENGTH = 60;
 const HEAD_BYTES = 64 * 1024;
@@ -860,8 +1321,11 @@ async function publish(credentials, source, site, onProgress, subdomain) {
   });
   return { url, siteId: target.siteId, subdomain: target.subdomain, files, unchanged };
 }
-function publishDirectory(credentials, directory, site, onProgress, subdomain) {
-  return publish(credentials, directorySource(directory), site, onProgress, subdomain);
+async function publishDirectory(credentials, directory, site, onProgress, subdomain) {
+  const found = await stat(directory).catch(() => null);
+  if (found === null) throw new Error(`There is no folder at ${directory}.`);
+  if (!found.isDirectory()) throw new Error(`${directory} is a file, not a folder to publish.`);
+  return await publish(credentials, directorySource(directory), site, onProgress, subdomain);
 }
 function cleanPath(path) {
   const cleaned = path.trim().replaceAll("\\", "/").replace(/^\.?\//, "");
@@ -1064,7 +1528,7 @@ async function signInWithCode(waitSeconds, replace = false) {
     "Call this tool again to keep waiting. Nothing has been changed yet."
   ].join("\n");
 }
-const SERVER_VERSION = "0.5.0";
+const SERVER_VERSION = "0.6.0";
 const CREDENTIAL_WRITE = {
   readOnlyHint: false,
   destructiveHint: false,
@@ -1136,7 +1600,7 @@ function createServer() {
     { name: "drop2run", version: SERVER_VERSION },
     {
       instructions: [
-        "Publishes static sites to Drop2Run.",
+        "Publishes pages, documents and static sites to Drop2Run, and returns a URL.",
         "",
         "Use publish_files for anything you wrote here — a page, a markdown note, several files",
         "together — and publish_dir for a folder that already exists on disk. Leave `site` unset to",
@@ -1149,9 +1613,10 @@ function createServer() {
         "be deleted by hand. `site` and `subdomain` are opposites: one publishes over a site that",
         "exists, the other creates one that does not. Never pass both.",
         "",
-        "A site needs an index.html at its top level, or at least one .md, .markdown or .pdf file,",
-        "which publishes as a documents site and is read through a viewer. So one page goes at",
-        "index.html, and a single note is a whole publish that needs no wrapping in HTML.",
+        "A site needs an index.html at its top level, or at least one document (.md, .markdown,",
+        ".pdf, .docx, .xlsx or .epub), which publishes as a documents site and is read through a",
+        "viewer. So one page goes at index.html, and a single note is a whole publish that needs",
+        "no wrapping in HTML.",
         "",
         "Publishing needs an access token. If there is none, call login — it opens a browser and",
         "stores one, and no command line or manual token is involved. Where no browser can be",
@@ -1223,7 +1688,7 @@ function createServer() {
     "publish_dir",
     {
       title: "Publish a folder",
-      description: "Publishes a folder of static files and returns its URL. The folder needs an index.html at its root, or .md and .pdf files, which are served through the reader.",
+      description: "Publishes a folder from disk and returns its URL. The folder needs an index.html at its root, or documents (.md, .pdf, .docx, .xlsx, .epub), which are served through the reader.",
       inputSchema: {
         path: z.string().min(1).describe("Absolute path of the folder to publish."),
         site: z.string().optional().describe("Subdomain or site id to publish over. Omit to create a new site."),

package/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "@drop2run/mcp",
-	"version": "0.5.0",
-	"description": "MCP server that publishes a folder or an HTML page to Drop2Run and returns a live URL.",
+	"version": "0.6.0",
+	"description": "MCP server that publishes what an AI made — a page, a document or a whole site — to Drop2Run and returns a live URL.",
 	"mcpName": "run.dropto/drop2run",
 	"license": "MIT",
 	"type": "module",