drafted 1.17.4 → 1.17.6

package/mcp/server.mjs

@@ -943,9 +943,22 @@ function enrichFetchError(error, url) {
   e.cause = error;
   return e;
 }
-async function serverFetch(url, opts) {
-  try { return await fetch(url, opts); }
-  catch (e) { throw enrichFetchError(e, url); }
+// No fetch may hang the agent's process forever: undici has no default request
+// timeout, so a wedged/black-holed server freezes an MCP tool call for minutes
+// (real incident: an agent's session stuck 27 minutes on a single drafted-mcp
+// call). Cap every request; generous default so large uploads aren't cut.
+const FETCH_TIMEOUT_MS = 120_000;
+
+async function serverFetch(url, opts = {}) {
+  const { timeout = FETCH_TIMEOUT_MS, ...rest } = opts;
+  try {
+    return await fetch(url, { ...rest, signal: AbortSignal.timeout(timeout) });
+  } catch (e) {
+    if (e?.name === 'TimeoutError' || e?.cause?.name === 'TimeoutError') {
+      throw new Error(`Request to ${url} timed out after ${timeout}ms`);
+    }
+    throw enrichFetchError(e, url);
+  }
 }
 
 // The org this session is actually working in: an explicit switch, else the org of the
@@ -3149,7 +3162,36 @@ export const mcpServer = createMcpServer();
 
 const args = process.argv.slice(2);
 
+const USAGE = `Drafted MCP Server v${PACKAGE_VERSION}
+
+Stdio MCP server exposing Drafted surface tools (fs, whoami, session, ...) to AI agents.
+Normally launched with NO arguments by an MCP client (Claude Desktop, Cursor, ...).
+
+Usage:
+  drafted-mcp             Run the stdio MCP server (default)
+  drafted-mcp --http      Run a standalone HTTP MCP server on MCP_HTTP_PORT (default 3100)
+  drafted-mcp --version   Print the installed version
+  drafted-mcp --help      Show this help
+`;
+
 async function main() {
+  if (args.includes('--help') || args.includes('-h')) {
+    console.log(USAGE);
+    process.exit(0);
+  }
+  if (args.includes('--version') || args.includes('-v')) {
+    console.log(PACKAGE_VERSION);
+    process.exit(0);
+  }
+  // Fail fast on unknown flags instead of silently starting the stdio server and
+  // blocking on stdin forever (a human running `drafted-mcp --help` used to hang
+  // indefinitely — the process never exited). MCP clients launch with no args.
+  const unknown = args.filter((a) => a !== '--http');
+  if (unknown.length > 0) {
+    console.error(`drafted-mcp: unknown option${unknown.length > 1 ? 's' : ''}: ${unknown.join(' ')}`);
+    console.error(USAGE);
+    process.exit(2);
+  }
   if (args.includes('--http')) {
     const { createServer } = await import('node:http');
     const { StreamableHTTPServerTransport } = await import('@modelcontextprotocol/sdk/server/streamableHttp.js');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "drafted",
-  "version": "1.17.4",
+  "version": "1.17.6",
   "description": "Drafted — visual thinking surface for humans and AI agents. Renders HTML, markdown, images, and code as frames on a zoomable canvas, with MCP tools for AI agents and real-time sync for humans.",
   "type": "module",
   "files": [
@@ -72,6 +72,7 @@
     "react-dom": "^18.3.1",
     "sharp": "^0.34.5",
     "ws": "^8.16.0",
+    "yaml": "^2.8.3",
     "zod": "^4.3.6"
   },
   "keywords": [
@@ -95,7 +96,6 @@
     "drizzle-kit": "^0.31.9",
     "tsx": "^4.19.0",
     "typescript": "^5.9.3",
-    "vitest": "^3.2.4",
-    "yaml": "^2.8.3"
+    "vitest": "^3.2.4"
   }
 }