drafted 1.21.1 → 1.21.3

package/install-mcp.sh

@@ -333,6 +333,14 @@ fi
 if [ "$INSTALL_MODE" = "local" ] && [ -f "$SCRIPT_DIR/mcp/server.mjs" ]; then
   DRAFTED_MCP_COMMAND="$(command -v node)"
   DRAFTED_MCP_ARGS_JSON="$(node -e 'console.log(JSON.stringify([process.argv[1]]))' "$SCRIPT_DIR/mcp/server.mjs")"
+elif [ -n "${NPM_ROOT:-}" ] && [ -f "$MCP_SERVER_MODULE" ]; then
+  # Absolute node + server file, NOT the drafted-mcp shebang (#!/usr/bin/env node):
+  # GUI clients build their own PATH, and Claude Desktop put an old nvm Node (v16,
+  # no fetch) first, so every tool call failed as "unreachable" (2026-10-06). This
+  # is the node checked >= 22 above; the auto-updater re-runs this script, so the
+  # registration follows it if it moves.
+  DRAFTED_MCP_COMMAND="$(command -v node)"
+  DRAFTED_MCP_ARGS_JSON="$(node -e 'console.log(JSON.stringify([process.argv[1]]))' "$MCP_SERVER_MODULE")"
 else
   DRAFTED_MCP_COMMAND="$(command -v drafted-mcp)"
   DRAFTED_MCP_ARGS_JSON="[]"

package/mcp/server.mjs

@@ -27,6 +27,14 @@ import { createGateState, markSearched, g1Block, g2Block, g3Block, selectWithinB
 import { loadPersistedProject, savePersistedProject } from './active-project-store.mjs';
 import { probeRepo, resolveAddress, addressNote } from './repo-address.mjs';
 
+// Node 18+ only (global fetch). A GUI client that resolves an old Node (Claude
+// Desktop put nvm v16 first on its PATH, 2026-10-06) otherwise fails every tool call
+// as "unreachable" instead of saying why.
+if (typeof fetch !== 'function') {
+  console.error(`Drafted MCP needs Node.js 18 or newer, but is running on ${process.version}. Re-run the Drafted installer, or point your MCP client at a newer node.`);
+  process.exit(1);
+}
+
 // Frame actions that mutate content — gated by G1 (wiki search before editing).
 // Read-style actions (read, search, versions, get_*/read_*) are exempt.
 const G1_MUTATING_FRAME_ACTIONS = new Set([
@@ -1053,7 +1061,14 @@ async function cloneSession() {
     // id (stable per machine) so they ALSO keep one stable session/name across restarts
     // instead of churning a fresh session every process. (Org is per-request, so a
     // shared child session does NOT cause cross-agent org clobbering.)
-    const agentKey = (process.env.DRAFTED_AGENT_NAME || '').trim() || bootstrapId;
+    //
+    // A Causeway-launched agent keys on its Causeway session: without that, a single-org
+    // user's concurrent anonymous agents dedupe to ONE shared session and one surface, so
+    // a dashboard following one of them shows all of them (embed-follow contract §1.3).
+    const causewaySession = (process.env.CAUSEWAY_SESSION_ID || '').trim();
+    const agentKey = (process.env.DRAFTED_AGENT_NAME || '').trim()
+      || (causewaySession ? `causeway-session:${causewaySession}` : '')
+      || bootstrapId;
     const res = await serverFetch(`${getServerUrl()}/auth/session/clone`, {
       method: 'POST',
       headers: { 'Content-Type': 'application/json', Cookie: `gc_session=${bootstrapId}` },
@@ -1802,7 +1817,10 @@ async function connectAgentWs() {
     // moment it connects — before opening any project. Project work later flips it active.
     // suggestedName (basename of the working directory) lets the server offer it in the
     // name-before-work gate message and as the tab placeholder.
-    try { agentWs.send(JSON.stringify({ type: 'agent-hello', agentLabel: getAgentLabel(), suggestedName: getSuggestedSessionName() })); } catch {}
+    // externalSessionId: the Causeway session this agent runs in, opaque to Drafted, so the
+    // Causeway dashboard can follow this session (GET /api/surfaces?external=).
+    const externalSessionId = (process.env.CAUSEWAY_SESSION_ID || '').trim() || undefined;
+    try { agentWs.send(JSON.stringify({ type: 'agent-hello', agentLabel: getAgentLabel(), suggestedName: getSuggestedSessionName(), externalSessionId })); } catch {}
     // Local capabilities for the Get set up page: only a status word, never the
     // Google account, scopes or client. Same open-race guard as the hello.
     if (!isRemote) detectGwsStatus().then((gws) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "drafted",
-  "version": "1.21.1",
+  "version": "1.21.3",
   "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": [