tandem-editor 0.2.12 → 0.3.1

package/dist/server/index.js

@@ -9,7 +9,7 @@ var __export = (target, all) => {
 };
 
 // src/shared/constants.ts
-var DEFAULT_WS_PORT, DEFAULT_MCP_PORT, SUPPORTED_EXTENSIONS, MAX_FILE_SIZE, MAX_WS_PAYLOAD, IDLE_TIMEOUT, SESSION_MAX_AGE, INTERRUPTION_MODE_DEFAULT, CHARS_PER_PAGE, LARGE_FILE_PAGE_THRESHOLD, VERY_LARGE_FILE_PAGE_THRESHOLD, CTRL_ROOM, Y_MAP_ANNOTATIONS, Y_MAP_AWARENESS, Y_MAP_USER_AWARENESS, Y_MAP_CHAT, Y_MAP_DOCUMENT_META, Y_MAP_SAVED_AT_VERSION, NOTIFICATION_BUFFER_SIZE, TUTORIAL_ANNOTATION_PREFIX, CHANNEL_EVENT_BUFFER_SIZE, CHANNEL_EVENT_BUFFER_AGE_MS, CHANNEL_SSE_KEEPALIVE_MS;
+var DEFAULT_WS_PORT, DEFAULT_MCP_PORT, SUPPORTED_EXTENSIONS, MAX_FILE_SIZE, MAX_WS_PAYLOAD, IDLE_TIMEOUT, SESSION_MAX_AGE, TANDEM_MODE_DEFAULT, SELECTION_DWELL_DEFAULT_MS, SELECTION_DWELL_MIN_MS, SELECTION_DWELL_MAX_MS, CHARS_PER_PAGE, LARGE_FILE_PAGE_THRESHOLD, VERY_LARGE_FILE_PAGE_THRESHOLD, CTRL_ROOM, Y_MAP_ANNOTATIONS, Y_MAP_AWARENESS, Y_MAP_USER_AWARENESS, Y_MAP_MODE, Y_MAP_DWELL_MS, Y_MAP_CHAT, Y_MAP_DOCUMENT_META, Y_MAP_SAVED_AT_VERSION, NOTIFICATION_BUFFER_SIZE, TUTORIAL_ANNOTATION_PREFIX, CHANNEL_EVENT_BUFFER_SIZE, CHANNEL_EVENT_BUFFER_AGE_MS, CHANNEL_SSE_KEEPALIVE_MS;
 var init_constants = __esm({
   "src/shared/constants.ts"() {
     "use strict";
@@ -20,7 +20,10 @@ var init_constants = __esm({
     MAX_WS_PAYLOAD = 10 * 1024 * 1024;
     IDLE_TIMEOUT = 30 * 60 * 1e3;
     SESSION_MAX_AGE = 30 * 24 * 60 * 60 * 1e3;
-    INTERRUPTION_MODE_DEFAULT = "all";
+    TANDEM_MODE_DEFAULT = "tandem";
+    SELECTION_DWELL_DEFAULT_MS = 1e3;
+    SELECTION_DWELL_MIN_MS = 500;
+    SELECTION_DWELL_MAX_MS = 3e3;
     CHARS_PER_PAGE = 3e3;
     LARGE_FILE_PAGE_THRESHOLD = 50;
     VERY_LARGE_FILE_PAGE_THRESHOLD = 100;
@@ -28,6 +31,8 @@ var init_constants = __esm({
     Y_MAP_ANNOTATIONS = "annotations";
     Y_MAP_AWARENESS = "awareness";
     Y_MAP_USER_AWARENESS = "userAwareness";
+    Y_MAP_MODE = "mode";
+    Y_MAP_DWELL_MS = "selectionDwellMs";
     Y_MAP_CHAT = "chat";
     Y_MAP_DOCUMENT_META = "documentMeta";
     Y_MAP_SAVED_AT_VERSION = "savedAtVersion";
@@ -39,106 +44,79 @@ var init_constants = __esm({
   }
 });
 
-// src/server/yjs/provider.ts
-import { Hocuspocus } from "@hocuspocus/server";
-import * as Y from "yjs";
-function setDocLifecycleCallbacks(swapped, unloaded) {
-  onDocSwapped = swapped;
-  onDocUnloaded = unloaded;
-}
-function setShouldKeepDocument(fn) {
-  shouldKeepDocument = fn;
-}
-function getDocument(name) {
-  return documents.get(name);
-}
-function getOrCreateDocument(name) {
-  let doc = documents.get(name);
-  if (!doc) {
-    doc = new Y.Doc();
-    documents.set(name, doc);
-  }
-  return doc;
-}
-async function startHocuspocus(port) {
-  hocuspocusInstance = new Hocuspocus({
-    port,
-    address: "127.0.0.1",
-    quiet: true,
-    // stdout is the MCP wire — suppress the startup banner
-    async onConnect({ request, documentName }) {
-      const origin = request?.headers?.origin;
-      if (!origin) {
-        console.error("[Hocuspocus] Rejected connection: missing Origin header");
-        throw new Error("Connection rejected: missing origin header");
-      }
-      const url = new URL(origin);
-      if (url.hostname !== "localhost" && url.hostname !== "127.0.0.1") {
-        console.error(`[Hocuspocus] Rejected connection from origin: ${origin}`);
-        throw new Error("Connection rejected: invalid origin");
-      }
-      console.error(`[Hocuspocus] Client connected to: ${documentName}`);
-    },
-    async onDisconnect({ documentName }) {
-      console.error(`[Hocuspocus] Client disconnected from: ${documentName}`);
-    },
-    async onLoadDocument({ document, documentName }) {
-      console.error(`[Hocuspocus] Loading document: ${documentName}`);
-      const existing = documents.get(documentName);
-      if (existing && existing !== document) {
-        const update = Y.encodeStateAsUpdate(existing);
-        Y.applyUpdate(document, update);
-        existing.destroy();
-        console.error(`[Hocuspocus] Merged pre-existing content into document: ${documentName}`);
-      }
-      documents.set(documentName, document);
-      if (onDocSwapped) {
-        onDocSwapped(documentName, document);
-      } else {
-        console.error(
-          `[Tandem] WARN: onDocSwapped callback not registered during doc load for ${documentName}. Server-side observers will NOT be attached. Call setDocLifecycleCallbacks() before starting Hocuspocus.`
-        );
-      }
-      return document;
-    },
-    async afterUnloadDocument({ documentName }) {
-      if (shouldKeepDocument?.(documentName)) {
-        console.error(`[Hocuspocus] Kept document in map (MCP still tracking): ${documentName}`);
+// src/server/file-watcher.ts
+import fs from "fs";
+function watchFile(filePath, onChanged) {
+  if (watched.has(filePath)) return;
+  let watcher;
+  try {
+    watcher = fs.watch(filePath, (eventType) => {
+      if (eventType !== "change") return;
+      const entry = watched.get(filePath);
+      if (!entry) return;
+      if (entry.suppressed) {
+        entry.suppressed = false;
         return;
       }
-      if (documents.has(documentName)) {
-        onDocUnloaded?.(documentName);
-        documents.delete(documentName);
-        console.error(`[Hocuspocus] Unloaded document from map: ${documentName}`);
+      if (entry.timer !== null) {
+        clearTimeout(entry.timer);
       }
-    }
-  });
-  await hocuspocusInstance.listen();
-  const internal = hocuspocusInstance.server?.httpServer;
-  if (internal) {
-    internal.on("error", (err) => {
-      console.error(`[Tandem] Hocuspocus httpServer error: ${err.message}`);
+      entry.timer = setTimeout(() => {
+        entry.timer = null;
+        onChanged(filePath).catch((err) => {
+          console.error(`[FileWatcher] onChanged callback failed for ${filePath}:`, err);
+        });
+      }, 500);
     });
+  } catch (err) {
+    console.error(`[FileWatcher] Failed to watch ${filePath}:`, err);
+    return;
   }
-  return hocuspocusInstance;
+  watcher.on("error", (err) => {
+    console.error(`[FileWatcher] Watcher error for ${filePath}:`, err);
+    unwatchFile(filePath);
+  });
+  watched.set(filePath, { watcher, timer: null, suppressed: false });
+  console.error(`[FileWatcher] Watching ${filePath}`);
 }
-var hocuspocusInstance, documents, shouldKeepDocument, onDocSwapped, onDocUnloaded;
-var init_provider = __esm({
-  "src/server/yjs/provider.ts"() {
+function suppressNextChange(filePath) {
+  const entry = watched.get(filePath);
+  if (entry) {
+    entry.suppressed = true;
+  }
+}
+function unwatchFile(filePath) {
+  const entry = watched.get(filePath);
+  if (!entry) return;
+  if (entry.timer !== null) {
+    clearTimeout(entry.timer);
+  }
+  try {
+    entry.watcher.close();
+  } catch (err) {
+    console.error(`[FileWatcher] watcher.close() failed for ${filePath}:`, err);
+  }
+  watched.delete(filePath);
+  console.error(`[FileWatcher] Unwatched ${filePath}`);
+}
+function unwatchAll() {
+  for (const filePath of [...watched.keys()]) {
+    unwatchFile(filePath);
+  }
+}
+var watched;
+var init_file_watcher = __esm({
+  "src/server/file-watcher.ts"() {
     "use strict";
-    hocuspocusInstance = null;
-    documents = /* @__PURE__ */ new Map();
-    shouldKeepDocument = null;
-    onDocSwapped = null;
-    onDocUnloaded = null;
+    watched = /* @__PURE__ */ new Map();
   }
 });
 
 // src/server/platform.ts
 import { execSync } from "child_process";
+import envPaths from "env-paths";
 import net from "net";
 import path from "path";
-import envPaths from "env-paths";
 function freePort(port) {
   try {
     if (process.platform === "win32") {
@@ -231,15 +209,15 @@ var init_platform = __esm({
 });
 
 // src/server/session/manager.ts
-import fs from "fs/promises";
+import fs2 from "fs/promises";
 import path2 from "path";
-import * as Y2 from "yjs";
+import * as Y from "yjs";
 async function atomicWrite(sessionPath, content) {
   const tmpPath = `${sessionPath}.tmp`;
-  await fs.writeFile(tmpPath, content, "utf-8");
+  await fs2.writeFile(tmpPath, content, "utf-8");
   for (let attempt = 0; attempt < RENAME_MAX_RETRIES; attempt++) {
     try {
-      await fs.rename(tmpPath, sessionPath);
+      await fs2.rename(tmpPath, sessionPath);
       return;
     } catch (err) {
       const code = err.code;
@@ -247,7 +225,7 @@ async function atomicWrite(sessionPath, content) {
         await new Promise((r) => setTimeout(r, RENAME_RETRY_BASE_MS * 2 ** attempt));
         continue;
       }
-      await fs.unlink(tmpPath).catch(() => {
+      await fs2.unlink(tmpPath).catch(() => {
       });
       throw err;
     }
@@ -261,12 +239,12 @@ async function saveSession(filePath, format, doc) {
   let sourceFileMtime = 0;
   if (!filePath.startsWith("upload://")) {
     try {
-      const stat = await fs.stat(filePath);
+      const stat = await fs2.stat(filePath);
       sourceFileMtime = stat.mtimeMs;
     } catch {
     }
   }
-  const state = Y2.encodeStateAsUpdate(doc);
+  const state = Y.encodeStateAsUpdate(doc);
   const ydocState = Buffer.from(state).toString("base64");
   const data = {
     filePath,
@@ -276,7 +254,7 @@ async function saveSession(filePath, format, doc) {
     lastAccessed: Date.now()
   };
   if (!sessionDirReady) {
-    await fs.mkdir(SESSION_DIR, { recursive: true });
+    await fs2.mkdir(SESSION_DIR, { recursive: true });
     sessionDirReady = true;
   }
   const sessionPath = path2.join(SESSION_DIR, `${key}.json`);
@@ -286,14 +264,14 @@ async function loadSession(filePath) {
   const key = sessionKey(filePath);
   const sessionPath = path2.join(SESSION_DIR, `${key}.json`);
   try {
-    const content = await fs.readFile(sessionPath, "utf-8");
+    const content = await fs2.readFile(sessionPath, "utf-8");
     return JSON.parse(content);
   } catch (err) {
     const code = err.code;
     if (code === "ENOENT") return null;
     if (err instanceof SyntaxError) {
       console.error(`[Tandem] Corrupted session file ${sessionPath}, removing:`, err.message);
-      await fs.unlink(sessionPath).catch((unlinkErr) => {
+      await fs2.unlink(sessionPath).catch((unlinkErr) => {
         console.error(`[Tandem] Failed to remove corrupted session ${sessionPath}:`, unlinkErr);
       });
       return null;
@@ -304,12 +282,12 @@ async function loadSession(filePath) {
 }
 function restoreYDoc(doc, session) {
   const state = Buffer.from(session.ydocState, "base64");
-  Y2.applyUpdate(doc, new Uint8Array(state));
+  Y.applyUpdate(doc, new Uint8Array(state));
 }
 async function sourceFileChanged(session) {
   if (session.filePath.startsWith("upload://")) return false;
   try {
-    const stat = await fs.stat(session.filePath);
+    const stat = await fs2.stat(session.filePath);
     return stat.mtimeMs !== session.sourceFileMtime;
   } catch {
     return true;
@@ -319,7 +297,7 @@ async function deleteSession(filePath) {
   const key = sessionKey(filePath);
   const sessionPath = path2.join(SESSION_DIR, `${key}.json`);
   try {
-    await fs.unlink(sessionPath);
+    await fs2.unlink(sessionPath);
   } catch (err) {
     const code = err.code;
     if (code !== "ENOENT") {
@@ -329,7 +307,7 @@ async function deleteSession(filePath) {
 }
 async function saveCtrlSession(doc) {
   if (!sessionDirReady) {
-    await fs.mkdir(SESSION_DIR, { recursive: true });
+    await fs2.mkdir(SESSION_DIR, { recursive: true });
     sessionDirReady = true;
   }
   const chatMap = doc.getMap(Y_MAP_CHAT);
@@ -347,7 +325,7 @@ async function saveCtrlSession(doc) {
       }
     }, MCP_ORIGIN);
   }
-  const state = Y2.encodeStateAsUpdate(doc);
+  const state = Y.encodeStateAsUpdate(doc);
   const ydocState = Buffer.from(state).toString("base64");
   const data = { ydocState, lastAccessed: Date.now() };
   const sessionPath = path2.join(SESSION_DIR, `${CTRL_SESSION_KEY}.json`);
@@ -356,7 +334,7 @@ async function saveCtrlSession(doc) {
 async function loadCtrlSession() {
   const sessionPath = path2.join(SESSION_DIR, `${CTRL_SESSION_KEY}.json`);
   try {
-    const content = await fs.readFile(sessionPath, "utf-8");
+    const content = await fs2.readFile(sessionPath, "utf-8");
     const data = JSON.parse(content);
     return data.ydocState ?? null;
   } catch (err) {
@@ -364,7 +342,7 @@ async function loadCtrlSession() {
     if (code === "ENOENT") return null;
     if (err instanceof SyntaxError) {
       console.error(`[Tandem] Corrupted ctrl session ${sessionPath}, removing:`, err.message);
-      await fs.unlink(sessionPath).catch((unlinkErr) => {
+      await fs2.unlink(sessionPath).catch((unlinkErr) => {
         console.error(
           `[Tandem] Failed to remove corrupted ctrl session ${sessionPath}:`,
           unlinkErr
@@ -378,18 +356,18 @@ async function loadCtrlSession() {
 }
 function restoreCtrlDoc(doc, base64State) {
   const state = Buffer.from(base64State, "base64");
-  Y2.applyUpdate(doc, new Uint8Array(state));
+  Y.applyUpdate(doc, new Uint8Array(state));
 }
 async function listSessionFilePaths() {
   try {
-    await fs.mkdir(SESSION_DIR, { recursive: true });
-    const files = await fs.readdir(SESSION_DIR);
+    await fs2.mkdir(SESSION_DIR, { recursive: true });
+    const files = await fs2.readdir(SESSION_DIR);
     const results = [];
     for (const file of files) {
       if (!file.endsWith(".json")) continue;
       if (file === `${encodeURIComponent(CTRL_ROOM)}.json`) continue;
       try {
-        const raw = await fs.readFile(path2.join(SESSION_DIR, file), "utf-8");
+        const raw = await fs2.readFile(path2.join(SESSION_DIR, file), "utf-8");
         const data = JSON.parse(raw);
         if (!data.filePath || data.filePath.startsWith("upload://")) continue;
         results.push({ filePath: data.filePath, lastAccessed: data.lastAccessed ?? 0 });
@@ -408,7 +386,7 @@ async function cleanupSessions() {
   let cleaned = 0;
   let files;
   try {
-    files = await fs.readdir(SESSION_DIR);
+    files = await fs2.readdir(SESSION_DIR);
   } catch (err) {
     if (err.code === "ENOENT") return 0;
     console.error("[Tandem] Failed to read session directory:", err);
@@ -418,9 +396,9 @@ async function cleanupSessions() {
   for (const file of files) {
     try {
       const filePath = path2.join(SESSION_DIR, file);
-      const stat = await fs.stat(filePath);
+      const stat = await fs2.stat(filePath);
       if (now - stat.mtimeMs > SESSION_MAX_AGE) {
-        await fs.unlink(filePath);
+        await fs2.unlink(filePath);
         cleaned++;
       }
     } catch (err) {
@@ -454,9 +432,9 @@ var AUTO_SAVE_INTERVAL, RENAME_MAX_RETRIES, RENAME_RETRY_BASE_MS, sessionDirRead
 var init_manager = __esm({
   "src/server/session/manager.ts"() {
     "use strict";
-    init_platform();
     init_constants();
     init_queue();
+    init_platform();
     AUTO_SAVE_INTERVAL = 60 * 1e3;
     RENAME_MAX_RETRIES = 3;
     RENAME_RETRY_BASE_MS = 50;
@@ -467,71 +445,136 @@ var init_manager = __esm({
   }
 });
 
-// src/server/file-watcher.ts
-import fs2 from "fs";
-function watchFile(filePath, onChanged) {
-  if (watched.has(filePath)) return;
-  let watcher;
-  try {
-    watcher = fs2.watch(filePath, (eventType) => {
-      if (eventType !== "change") return;
-      const entry = watched.get(filePath);
-      if (!entry) return;
-      if (entry.suppressed) {
-        entry.suppressed = false;
+// src/server/yjs/provider.ts
+import { Hocuspocus } from "@hocuspocus/server";
+import * as Y2 from "yjs";
+function setDocLifecycleCallbacks(swapped, unloaded) {
+  onDocSwapped = swapped;
+  onDocUnloaded = unloaded;
+}
+function setShouldKeepDocument(fn) {
+  shouldKeepDocument = fn;
+}
+function getDocument(name) {
+  return documents.get(name);
+}
+function getOrCreateDocument(name) {
+  let doc = documents.get(name);
+  if (!doc) {
+    doc = new Y2.Doc();
+    documents.set(name, doc);
+  }
+  return doc;
+}
+async function startHocuspocus(port) {
+  hocuspocusInstance = new Hocuspocus({
+    port,
+    address: "127.0.0.1",
+    quiet: true,
+    // stdout is the MCP wire — suppress the startup banner
+    async onConnect({ request, documentName }) {
+      const origin = request?.headers?.origin;
+      if (!origin) {
+        console.error("[Hocuspocus] Rejected connection: missing Origin header");
+        throw new Error("Connection rejected: missing origin header");
+      }
+      const url = new URL(origin);
+      if (url.hostname !== "localhost" && url.hostname !== "127.0.0.1") {
+        console.error(`[Hocuspocus] Rejected connection from origin: ${origin}`);
+        throw new Error("Connection rejected: invalid origin");
+      }
+      console.error(`[Hocuspocus] Client connected to: ${documentName}`);
+    },
+    async onDisconnect({ documentName }) {
+      console.error(`[Hocuspocus] Client disconnected from: ${documentName}`);
+    },
+    async onLoadDocument({ document, documentName }) {
+      console.error(`[Hocuspocus] Loading document: ${documentName}`);
+      const existing = documents.get(documentName);
+      if (existing && existing !== document) {
+        const update = Y2.encodeStateAsUpdate(existing);
+        Y2.applyUpdate(document, update);
+        existing.destroy();
+        console.error(`[Hocuspocus] Merged pre-existing content into document: ${documentName}`);
+      }
+      documents.set(documentName, document);
+      if (onDocSwapped) {
+        onDocSwapped(documentName, document);
+      } else {
+        console.error(
+          `[Tandem] WARN: onDocSwapped callback not registered during doc load for ${documentName}. Server-side observers will NOT be attached. Call setDocLifecycleCallbacks() before starting Hocuspocus.`
+        );
+      }
+      return document;
+    },
+    async afterUnloadDocument({ documentName }) {
+      if (shouldKeepDocument?.(documentName)) {
+        console.error(`[Hocuspocus] Kept document in map (MCP still tracking): ${documentName}`);
         return;
       }
-      if (entry.timer !== null) {
-        clearTimeout(entry.timer);
+      if (documents.has(documentName)) {
+        onDocUnloaded?.(documentName);
+        documents.delete(documentName);
+        console.error(`[Hocuspocus] Unloaded document from map: ${documentName}`);
       }
-      entry.timer = setTimeout(() => {
-        entry.timer = null;
-        onChanged(filePath).catch((err) => {
-          console.error(`[FileWatcher] onChanged callback failed for ${filePath}:`, err);
-        });
-      }, 500);
+    }
+  });
+  await hocuspocusInstance.listen();
+  const internal = hocuspocusInstance.server?.httpServer;
+  if (internal) {
+    internal.on("error", (err) => {
+      console.error(`[Tandem] Hocuspocus httpServer error: ${err.message}`);
     });
-  } catch (err) {
-    console.error(`[FileWatcher] Failed to watch ${filePath}:`, err);
-    return;
   }
-  watcher.on("error", (err) => {
-    console.error(`[FileWatcher] Watcher error for ${filePath}:`, err);
-    unwatchFile(filePath);
-  });
-  watched.set(filePath, { watcher, timer: null, suppressed: false });
-  console.error(`[FileWatcher] Watching ${filePath}`);
+  return hocuspocusInstance;
 }
-function suppressNextChange(filePath) {
-  const entry = watched.get(filePath);
-  if (entry) {
-    entry.suppressed = true;
+var hocuspocusInstance, documents, shouldKeepDocument, onDocSwapped, onDocUnloaded;
+var init_provider = __esm({
+  "src/server/yjs/provider.ts"() {
+    "use strict";
+    hocuspocusInstance = null;
+    documents = /* @__PURE__ */ new Map();
+    shouldKeepDocument = null;
+    onDocSwapped = null;
+    onDocUnloaded = null;
   }
+});
+
+// src/shared/utils.ts
+function generateId(prefix) {
+  return `${prefix}_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`;
 }
-function unwatchFile(filePath) {
-  const entry = watched.get(filePath);
-  if (!entry) return;
-  if (entry.timer !== null) {
-    clearTimeout(entry.timer);
-  }
-  try {
-    entry.watcher.close();
-  } catch (err) {
-    console.error(`[FileWatcher] watcher.close() failed for ${filePath}:`, err);
-  }
-  watched.delete(filePath);
-  console.error(`[FileWatcher] Unwatched ${filePath}`);
+function generateAnnotationId() {
+  return generateId("ann");
 }
-function unwatchAll() {
-  for (const filePath of [...watched.keys()]) {
-    unwatchFile(filePath);
+function generateMessageId() {
+  return generateId("msg");
+}
+function generateEventId() {
+  return generateId("evt");
+}
+function generateNotificationId() {
+  return generateId("ntf");
+}
+var init_utils = __esm({
+  "src/shared/utils.ts"() {
+    "use strict";
   }
+});
+
+// src/shared/offsets.ts
+function headingPrefixLength(level) {
+  if (!level) return 0;
+  return level + 1;
 }
-var watched;
-var init_file_watcher = __esm({
-  "src/server/file-watcher.ts"() {
+function headingPrefix(level) {
+  return "#".repeat(level) + " ";
+}
+var FLAT_SEPARATOR;
+var init_offsets = __esm({
+  "src/shared/offsets.ts"() {
     "use strict";
-    watched = /* @__PURE__ */ new Map();
+    FLAT_SEPARATOR = "\n";
   }
 });
 
@@ -853,10 +896,10 @@ var init_mdast_ydoc = __esm({
 });
 
 // src/server/file-io/markdown.ts
-import { unified } from "unified";
-import remarkParse from "remark-parse";
 import remarkGfm from "remark-gfm";
+import remarkParse from "remark-parse";
 import remarkStringify from "remark-stringify";
+import { unified } from "unified";
 function loadMarkdown(doc, markdown) {
   const tree = parser.parse(markdown);
   mdastToYDoc(doc, tree);
@@ -881,22 +924,6 @@ var init_markdown = __esm({
   }
 });
 
-// src/shared/offsets.ts
-function headingPrefixLength(level) {
-  if (!level) return 0;
-  return level + 1;
-}
-function headingPrefix(level) {
-  return "#".repeat(level) + " ";
-}
-var FLAT_SEPARATOR;
-var init_offsets = __esm({
-  "src/shared/offsets.ts"() {
-    "use strict";
-    FLAT_SEPARATOR = "\n";
-  }
-});
-
 // src/server/mcp/document-model.ts
 import path3 from "path";
 import * as Y4 from "yjs";
@@ -1426,6 +1453,42 @@ var init_types = __esm({
   }
 });
 
+// src/shared/types.ts
+import { z } from "zod";
+var AnnotationTypeSchema, AnnotationStatusSchema, HighlightColorSchema, SeveritySchema, TandemModeSchema, AuthorSchema, AnnotationActionSchema, ExportFormatSchema, DocumentFormatSchema, ToolErrorCodeSchema;
+var init_types2 = __esm({
+  "src/shared/types.ts"() {
+    "use strict";
+    init_types();
+    AnnotationTypeSchema = z.enum([
+      "highlight",
+      "comment",
+      "suggestion",
+      "overlay",
+      "question",
+      "flag"
+    ]);
+    AnnotationStatusSchema = z.enum(["pending", "accepted", "dismissed"]);
+    HighlightColorSchema = z.enum(["yellow", "red", "green", "blue", "purple"]);
+    SeveritySchema = z.enum(["info", "warning", "error", "success"]);
+    TandemModeSchema = z.enum(["solo", "tandem"]);
+    AuthorSchema = z.enum(["user", "claude", "import"]);
+    AnnotationActionSchema = z.enum(["accept", "dismiss"]);
+    ExportFormatSchema = z.enum(["markdown", "json"]);
+    DocumentFormatSchema = z.enum(["md", "txt", "html", "docx"]);
+    ToolErrorCodeSchema = z.enum([
+      "RANGE_GONE",
+      "RANGE_MOVED",
+      "FILE_LOCKED",
+      "FILE_NOT_FOUND",
+      "NO_DOCUMENT",
+      "INVALID_RANGE",
+      "FORMAT_ERROR",
+      "PERMISSION_DENIED"
+    ]);
+  }
+});
+
 // src/shared/positions/index.ts
 var init_positions = __esm({
   "src/shared/positions/index.ts"() {
@@ -1632,49 +1695,12 @@ function refreshAllRanges(annotations, ydoc, map) {
 var init_positions2 = __esm({
   "src/server/positions.ts"() {
     "use strict";
-    init_queue();
     init_positions();
+    init_queue();
     init_document_model();
   }
 });
 
-// src/shared/types.ts
-import { z } from "zod";
-var AnnotationTypeSchema, AnnotationStatusSchema, AnnotationPrioritySchema, InterruptionModeSchema, HighlightColorSchema, SeveritySchema, AuthorSchema, AnnotationActionSchema, ExportFormatSchema, DocumentFormatSchema, ToolErrorCodeSchema;
-var init_types2 = __esm({
-  "src/shared/types.ts"() {
-    "use strict";
-    init_types();
-    AnnotationTypeSchema = z.enum([
-      "highlight",
-      "comment",
-      "suggestion",
-      "overlay",
-      "question",
-      "flag"
-    ]);
-    AnnotationStatusSchema = z.enum(["pending", "accepted", "dismissed"]);
-    AnnotationPrioritySchema = z.enum(["normal", "urgent"]);
-    InterruptionModeSchema = z.enum(["all", "urgent-only", "paused"]);
-    HighlightColorSchema = z.enum(["yellow", "red", "green", "blue", "purple"]);
-    SeveritySchema = z.enum(["info", "warning", "error", "success"]);
-    AuthorSchema = z.enum(["user", "claude", "import"]);
-    AnnotationActionSchema = z.enum(["accept", "dismiss"]);
-    ExportFormatSchema = z.enum(["markdown", "json"]);
-    DocumentFormatSchema = z.enum(["md", "txt", "html", "docx"]);
-    ToolErrorCodeSchema = z.enum([
-      "RANGE_GONE",
-      "RANGE_MOVED",
-      "FILE_LOCKED",
-      "FILE_NOT_FOUND",
-      "NO_DOCUMENT",
-      "INVALID_RANGE",
-      "FORMAT_ERROR",
-      "PERMISSION_DENIED"
-    ]);
-  }
-});
-
 // src/server/file-io/docx-walker.ts
 import { parseDocument as parseDocument2 } from "htmlparser2";
 function isElement2(node) {
@@ -1805,8 +1831,8 @@ var init_docx_walker = __esm({
 });
 
 // src/server/file-io/docx-comments.ts
-import JSZip from "jszip";
 import { parseDocument as parseDocument3 } from "htmlparser2";
+import JSZip from "jszip";
 async function extractDocxComments(buffer3) {
   const zip = await JSZip.loadAsync(buffer3);
   const commentsXml = await zip.file("word/comments.xml")?.async("text");
@@ -1914,9 +1940,9 @@ var init_docx_comments = __esm({
   "src/server/file-io/docx-comments.ts"() {
     "use strict";
     init_constants();
-    init_positions2();
     init_types2();
     init_queue();
+    init_positions2();
     init_docx_walker();
   }
 });
@@ -2239,9 +2265,9 @@ var init_dist2 = __esm({
 });
 
 // src/server/file-io/docx-apply.ts
-import JSZip2 from "jszip";
-import { parseDocument as parseDocument4 } from "htmlparser2";
 import render from "dom-serializer";
+import { parseDocument as parseDocument4 } from "htmlparser2";
+import JSZip2 from "jszip";
 function buildOffsetMap(xml, targetOffsets) {
   const entries = /* @__PURE__ */ new Map();
   const commentParagraphIds = /* @__PURE__ */ new Map();
@@ -2797,10 +2823,10 @@ var markdownAdapter, plaintextAdapter, docxAdapter, adapters;
 var init_file_io = __esm({
   "src/server/file-io/index.ts"() {
     "use strict";
-    init_markdown();
+    init_document_model();
     init_docx();
     init_docx_comments();
-    init_document_model();
+    init_markdown();
     init_docx_apply();
     markdownAdapter = {
       canSave: true,
@@ -2881,28 +2907,6 @@ var init_notifications = __esm({
   }
 });
 
-// src/shared/utils.ts
-function generateId(prefix) {
-  return `${prefix}_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`;
-}
-function generateAnnotationId() {
-  return generateId("ann");
-}
-function generateMessageId() {
-  return generateId("msg");
-}
-function generateEventId() {
-  return generateId("evt");
-}
-function generateNotificationId() {
-  return generateId("ntf");
-}
-var init_utils = __esm({
-  "src/shared/utils.ts"() {
-    "use strict";
-  }
-});
-
 // src/server/mcp/file-opener.ts
 var file_opener_exports = {};
 __export(file_opener_exports, {
@@ -2910,10 +2914,10 @@ __export(file_opener_exports, {
   openFileByPath: () => openFileByPath,
   openFileFromContent: () => openFileFromContent
 });
-import fs4 from "fs/promises";
+import { randomUUID } from "crypto";
 import fsSync from "fs";
+import fs4 from "fs/promises";
 import path5 from "path";
-import { randomUUID } from "crypto";
 async function openFileByPath(filePath, options) {
   let resolved = path5.resolve(filePath);
   try {
@@ -3262,19 +3266,19 @@ var reloadInProgress;
 var init_file_opener = __esm({
   "src/server/mcp/file-opener.ts"() {
     "use strict";
-    init_provider();
     init_constants();
+    init_utils();
     init_queue();
+    init_docx();
+    init_docx_comments();
+    init_docx_html();
     init_file_io();
+    init_markdown();
     init_file_watcher();
-    init_positions2();
     init_notifications();
-    init_utils();
-    init_markdown();
-    init_docx();
-    init_docx_html();
-    init_docx_comments();
+    init_positions2();
     init_manager();
+    init_provider();
     init_document_model();
     init_document_service();
     reloadInProgress = /* @__PURE__ */ new Set();
@@ -3282,8 +3286,8 @@ var init_file_opener = __esm({
 });
 
 // src/server/mcp/document-service.ts
-import path6 from "path";
 import { randomUUID as randomUUID2 } from "crypto";
+import path6 from "path";
 function getOpenDocs() {
   return openDocs;
 }
@@ -3443,11 +3447,11 @@ var openDocs, activeDocId;
 var init_document_service = __esm({
   "src/server/mcp/document-service.ts"() {
     "use strict";
-    init_provider();
-    init_manager();
     init_constants();
     init_queue();
     init_file_watcher();
+    init_manager();
+    init_provider();
     openDocs = /* @__PURE__ */ new Map();
     setShouldKeepDocument((name) => openDocs.has(name) || name === CTRL_ROOM);
     activeDocId = null;
@@ -3463,6 +3467,19 @@ var init_types3 = __esm({
 });
 
 // src/server/events/queue.ts
+function getDwellMs() {
+  const ctrlDoc = getOrCreateDocument(CTRL_ROOM);
+  const awareness = ctrlDoc.getMap(Y_MAP_USER_AWARENESS);
+  const val = awareness.get(Y_MAP_DWELL_MS);
+  if (val === void 0) return SELECTION_DWELL_DEFAULT_MS;
+  if (typeof val === "number" && val >= SELECTION_DWELL_MIN_MS && val <= SELECTION_DWELL_MAX_MS) {
+    return val;
+  }
+  console.warn(
+    `[EventQueue] Invalid dwell time in CTRL_ROOM awareness (type=${typeof val}, value=${String(val)}); using default ${SELECTION_DWELL_DEFAULT_MS}ms`
+  );
+  return SELECTION_DWELL_DEFAULT_MS;
+}
 function getTrackableId(event) {
   switch (event.type) {
     case "annotation:created":
@@ -3569,26 +3586,37 @@ function attachObservers(docName, doc) {
   annotationsMap.observe(annotationsObs);
   cleanups.push(() => annotationsMap.unobserve(annotationsObs));
   const userAwareness = doc.getMap(Y_MAP_USER_AWARENESS);
+  let selectionDwellTimer = null;
   const awarenessObs = (event, txn) => {
     if (txn.origin === MCP_ORIGIN) return;
     if (event.keysChanged.has("selection")) {
       const selection = userAwareness.get("selection");
+      if (selectionDwellTimer) {
+        clearTimeout(selectionDwellTimer);
+        selectionDwellTimer = null;
+      }
       if (!selection || selection.from === selection.to) return;
-      pushEvent({
-        id: generateEventId(),
-        type: "selection:changed",
-        timestamp: Date.now(),
-        documentId: docName,
-        payload: {
-          from: selection.from,
-          to: selection.to,
-          selectedText: selection.selectedText ?? ""
-        }
-      });
+      selectionDwellTimer = setTimeout(() => {
+        selectionDwellTimer = null;
+        pushEvent({
+          id: generateEventId(),
+          type: "selection:changed",
+          timestamp: Date.now(),
+          documentId: docName,
+          payload: {
+            from: selection.from,
+            to: selection.to,
+            selectedText: selection.selectedText ?? ""
+          }
+        });
+      }, getDwellMs());
     }
   };
   userAwareness.observe(awarenessObs);
-  cleanups.push(() => userAwareness.unobserve(awarenessObs));
+  cleanups.push(() => {
+    userAwareness.unobserve(awarenessObs);
+    if (selectionDwellTimer) clearTimeout(selectionDwellTimer);
+  });
   docObservers.set(docName, cleanups);
   console.error(`[EventQueue] Attached observers for document: ${docName}`);
 }
@@ -3788,115 +3816,62 @@ var init_launcher = __esm({
     init_constants();
     claudeProcess = null;
     TANDEM_SYSTEM_PROMPT = [
-      "You are Claude, connected to Tandem \u2014 a collaborative document editor.",
-      "You will receive real-time push notifications via the tandem-channel when users",
-      "create annotations, send chat messages, accept/dismiss your suggestions, or switch documents.",
-      "Use your tandem MCP tools (tandem_getTextContent, tandem_comment, tandem_highlight,",
-      "tandem_suggest, tandem_edit, etc.) to review and annotate documents.",
-      "Start by calling tandem_checkInbox to see what needs attention."
-    ].join(" ");
-  }
-});
-
-// src/server/index.ts
-import path10 from "path";
-import { fileURLToPath as fileURLToPath2 } from "url";
-
-// src/server/mcp/server.ts
-import { createMcpExpressApp } from "@modelcontextprotocol/sdk/server/express.js";
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
-import { isInitializeRequest } from "@modelcontextprotocol/sdk/types.js";
-import { randomUUID as randomUUID3 } from "crypto";
-import { existsSync } from "fs";
-import { dirname, join } from "path";
-import { fileURLToPath } from "url";
-import { createRequire } from "module";
-
-// src/server/open-browser.ts
-import { execFile } from "child_process";
-function openBrowser(url) {
-  let command;
-  let args;
-  if (process.platform === "win32") {
-    command = "cmd";
-    args = ["/c", "start", "", url];
-  } else if (process.platform === "darwin") {
-    command = "open";
-    args = [url];
-  } else {
-    command = "xdg-open";
-    args = [url];
-  }
-  execFile(command, args, (err) => {
-    if (err) {
-      console.error("[Tandem] Could not open browser automatically.");
-      console.error(`[Tandem] Open this URL manually: ${url}`);
-    }
-  });
-}
-
-// src/server/mcp/annotations.ts
-init_constants();
-init_queue();
-init_provider();
-import { z as z3 } from "zod";
-
-// src/server/mcp/document.ts
-init_provider();
-import { z as z2 } from "zod";
-import * as Y8 from "yjs";
-
-// src/server/mcp/response.ts
-function mcpSuccess(data) {
-  return {
-    content: [{ type: "text", text: JSON.stringify({ error: false, data }) }]
-  };
-}
-function mcpError(code, message, details) {
-  return {
-    content: [
-      {
-        type: "text",
-        text: JSON.stringify({ error: true, code, message, ...details && { details } })
-      }
-    ]
-  };
-}
-function noDocumentError() {
-  return mcpError("NO_DOCUMENT", "No document is open. Call tandem_open first.");
-}
-function getErrorMessage(err) {
-  return err instanceof Error ? err.message : String(err);
-}
-function withErrorBoundary(toolName, handler) {
-  return async (args) => {
-    try {
-      return await handler(args);
-    } catch (err) {
-      console.error(`[Tandem] Tool ${toolName} threw:`, err);
-      return mcpError("INTERNAL_ERROR", `${toolName} failed: ${getErrorMessage(err)}`);
+      "You are Claude, connected to Tandem \u2014 a collaborative document editor.",
+      "You will receive real-time push notifications via the tandem-channel when users",
+      "create annotations, send chat messages, accept/dismiss your suggestions, or switch documents.",
+      "Use your tandem MCP tools (tandem_getTextContent, tandem_comment, tandem_highlight,",
+      "tandem_suggest, tandem_edit, etc.) to review and annotate documents.",
+      "Start by calling tandem_checkInbox to see what needs attention."
+    ].join(" ");
+  }
+});
+
+// src/server/index.ts
+init_constants();
+import path10 from "path";
+import { fileURLToPath as fileURLToPath2 } from "url";
+
+// src/server/error-filter.ts
+function isKnownHocuspocusError(err) {
+  if (!(err instanceof Error)) return false;
+  if ("code" in err) {
+    const code = err.code;
+    if (typeof code === "string" && code.startsWith("WS_ERR_")) {
+      return true;
     }
-  };
-}
-function escapeRegex(str) {
-  return str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+  }
+  const msg = err.message;
+  if (msg.startsWith("WebSocket is not open")) return true;
+  if (msg.includes("Unexpected end of array") || msg.includes("Integer out of Range")) return true;
+  if (msg.startsWith("Received a message with an unknown type:")) return true;
+  return false;
 }
 
+// src/server/index.ts
+init_queue();
+init_file_watcher();
+
 // src/server/mcp/document.ts
-init_notifications();
-init_utils();
+init_constants();
 init_offsets();
+init_types2();
+init_utils();
+init_queue();
 init_file_io();
 init_file_watcher();
+init_notifications();
+init_positions2();
+init_manager();
+init_provider();
+import * as Y8 from "yjs";
+import { z as z2 } from "zod";
 
 // src/server/mcp/convert.ts
+init_file_io();
 init_provider();
 init_document_model();
-init_file_io();
-init_file_opener();
 init_document_service();
+init_file_opener();
 import fs5 from "fs/promises";
 import path7 from "path";
 async function findAvailablePath(basePath) {
@@ -3990,16 +3965,49 @@ async function convertToMarkdown(documentId, outputPath) {
 }
 
 // src/server/mcp/document.ts
-init_manager();
-init_file_opener();
-init_constants();
-init_types2();
-init_queue();
 init_document_model();
-init_positions2();
 init_document_service();
-init_document_model();
+init_file_opener();
+
+// src/server/mcp/response.ts
+function mcpSuccess(data) {
+  return {
+    content: [{ type: "text", text: JSON.stringify({ error: false, data }) }]
+  };
+}
+function mcpError(code, message, details) {
+  return {
+    content: [
+      {
+        type: "text",
+        text: JSON.stringify({ error: true, code, message, ...details && { details } })
+      }
+    ]
+  };
+}
+function noDocumentError() {
+  return mcpError("NO_DOCUMENT", "No document is open. Call tandem_open first.");
+}
+function getErrorMessage(err) {
+  return err instanceof Error ? err.message : String(err);
+}
+function withErrorBoundary(toolName, handler) {
+  return async (args) => {
+    try {
+      return await handler(args);
+    } catch (err) {
+      console.error(`[Tandem] Tool ${toolName} threw:`, err);
+      return mcpError("INTERNAL_ERROR", `${toolName} failed: ${getErrorMessage(err)}`);
+    }
+  };
+}
+function escapeRegex(str) {
+  return str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+
+// src/server/mcp/document.ts
 init_positions2();
+init_document_model();
 init_document_service();
 init_file_opener();
 function getOutline(fragment) {
@@ -4298,15 +4306,12 @@ function registerDocumentTools(server) {
     withErrorBoundary("tandem_status", async () => {
       const activeId = getActiveDocId();
       const active = activeId ? openDocs2.get(activeId) : null;
-      let interruptionMode = INTERRUPTION_MODE_DEFAULT;
-      if (activeId) {
-        const doc = getOrCreateDocument(activeId);
-        const awareness = doc.getMap(Y_MAP_USER_AWARENESS);
-        interruptionMode = awareness.get("interruptionMode") ?? INTERRUPTION_MODE_DEFAULT;
-      }
+      const ctrlDoc = getOrCreateDocument(CTRL_ROOM);
+      const ctrlAwareness = ctrlDoc.getMap(Y_MAP_USER_AWARENESS);
+      const mode = TandemModeSchema.catch(TANDEM_MODE_DEFAULT).parse(ctrlAwareness.get(Y_MAP_MODE));
       return mcpSuccess({
         running: true,
-        interruptionMode,
+        mode,
         activeDocument: active ? { documentId: active.id, filePath: active.filePath, format: active.format } : null,
         openDocuments: Array.from(openDocs2.values()).map((d) => ({
           documentId: d.id,
@@ -4398,12 +4403,56 @@ function registerDocumentTools(server) {
   );
 }
 
+// src/server/index.ts
+init_document_model();
+init_document_service();
+init_file_opener();
+
+// src/server/mcp/server.ts
+import { existsSync } from "fs";
+import { dirname, join } from "path";
+import { fileURLToPath } from "url";
+import { createMcpExpressApp } from "@modelcontextprotocol/sdk/server/express.js";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
+import { isInitializeRequest } from "@modelcontextprotocol/sdk/types.js";
+import { randomUUID as randomUUID3 } from "crypto";
+import { createRequire } from "module";
+
+// src/server/open-browser.ts
+import { execFile } from "child_process";
+function openBrowser(url) {
+  let command;
+  let args;
+  if (process.platform === "win32") {
+    command = "cmd";
+    args = ["/c", "start", "", url];
+  } else if (process.platform === "darwin") {
+    command = "open";
+    args = [url];
+  } else {
+    command = "xdg-open";
+    args = [url];
+  }
+  execFile(command, args, (err) => {
+    if (err) {
+      console.error("[Tandem] Could not open browser automatically.");
+      console.error(`[Tandem] Open this URL manually: ${url}`);
+    }
+  });
+}
+
 // src/server/mcp/annotations.ts
-init_docx();
+init_constants();
 init_types2();
-init_positions2();
-init_notifications();
 init_utils();
+init_queue();
+init_docx();
+init_notifications();
+init_positions2();
+init_provider();
+import { z as z3 } from "zod";
 init_positions2();
 function getDocAndAnnotations(documentId) {
   const doc = getCurrentDoc(documentId);
@@ -4467,6 +4516,15 @@ function createAnnotation(map, ydoc, type, anchored, content, extras) {
     ...extras
   };
   ydoc.transact(() => map.set(id, annotation), MCP_ORIGIN);
+  const snippet = annotation.textSnapshot ? `: "${annotation.textSnapshot.slice(0, 60)}${annotation.textSnapshot.length > 60 ? "\u2026" : ""}"` : "";
+  pushNotification({
+    id: generateNotificationId(),
+    type: "review-pending",
+    severity: "info",
+    message: `New ${type[0].toUpperCase() + type.slice(1)}${snippet}`,
+    dedupKey: `review-pending:${type}`,
+    timestamp: Date.now()
+  });
   return id;
 }
 function collectAnnotations(map) {
@@ -4491,16 +4549,13 @@ function registerAnnotationTools(server) {
       color: HighlightColorSchema.describe("Highlight color"),
       note: z3.string().optional().describe("Optional note for the highlight"),
       documentId: z3.string().optional().describe("Target document ID (defaults to active document)"),
-      priority: AnnotationPrioritySchema.optional().describe(
-        "Annotation priority. Set to 'urgent' for critical issues that should be visible even when the user has interruption mode set to urgent-only. Flags and questions are implicitly urgent."
-      ),
       textSnapshot: z3.string().optional().describe(
         "Expected text at [from, to] \u2014 returns RANGE_MOVED with relocated range on mismatch, or RANGE_GONE if text was deleted"
       )
     },
     withErrorBoundary(
       "tandem_highlight",
-      async ({ from: rawFrom, to: rawTo, color, note, documentId, priority, textSnapshot }) => {
+      async ({ from: rawFrom, to: rawTo, color, note, documentId, textSnapshot }) => {
         const da = getDocAndAnnotations(documentId);
         if (!da) return noDocumentError();
         const from = toFlatOffset(rawFrom);
@@ -4513,7 +4568,6 @@ function registerAnnotationTools(server) {
         const snap = captureSnapshot(da.ydoc, result.range.from, result.range.to);
         const id = createAnnotation(da.map, da.ydoc, "highlight", result, note || "", {
           color,
-          ...priority ? { priority } : {},
           textSnapshot: snap
         });
         return mcpSuccess({ annotationId: id });
@@ -4528,16 +4582,13 @@ function registerAnnotationTools(server) {
       to: z3.number().describe("End position"),
       text: z3.string().describe("Comment text"),
       documentId: z3.string().optional().describe("Target document ID (defaults to active document)"),
-      priority: AnnotationPrioritySchema.optional().describe(
-        "Annotation priority. Set to 'urgent' for critical issues that should be visible even when the user has interruption mode set to urgent-only. Flags and questions are implicitly urgent."
-      ),
       textSnapshot: z3.string().optional().describe(
         "Expected text at [from, to] \u2014 returns RANGE_MOVED with relocated range on mismatch, or RANGE_GONE if text was deleted"
       )
     },
     withErrorBoundary(
       "tandem_comment",
-      async ({ from: rawFrom, to: rawTo, text, documentId, priority, textSnapshot }) => {
+      async ({ from: rawFrom, to: rawTo, text, documentId, textSnapshot }) => {
         const da = getDocAndAnnotations(documentId);
         if (!da) return noDocumentError();
         const from = toFlatOffset(rawFrom);
@@ -4549,7 +4600,6 @@ function registerAnnotationTools(server) {
         }
         const snap = captureSnapshot(da.ydoc, result.range.from, result.range.to);
         const id = createAnnotation(da.map, da.ydoc, "comment", result, text, {
-          ...priority ? { priority } : {},
           textSnapshot: snap
         });
         return mcpSuccess({ annotationId: id });
@@ -4565,16 +4615,13 @@ function registerAnnotationTools(server) {
       newText: z3.string().describe("Suggested replacement text"),
       reason: z3.string().optional().describe("Reason for the suggestion"),
       documentId: z3.string().optional().describe("Target document ID (defaults to active document)"),
-      priority: AnnotationPrioritySchema.optional().describe(
-        "Annotation priority. Set to 'urgent' for critical issues that should be visible even when the user has interruption mode set to urgent-only. Flags and questions are implicitly urgent."
-      ),
       textSnapshot: z3.string().optional().describe(
         "Expected text at [from, to] \u2014 returns RANGE_MOVED with relocated range on mismatch, or RANGE_GONE if text was deleted"
       )
     },
     withErrorBoundary(
       "tandem_suggest",
-      async ({ from: rawFrom, to: rawTo, newText, reason, documentId, priority, textSnapshot }) => {
+      async ({ from: rawFrom, to: rawTo, newText, reason, documentId, textSnapshot }) => {
         const da = getDocAndAnnotations(documentId);
         if (!da) return noDocumentError();
         const from = toFlatOffset(rawFrom);
@@ -4591,7 +4638,7 @@ function registerAnnotationTools(server) {
           "suggestion",
           result,
           JSON.stringify({ newText, reason: reason || "" }),
-          { ...priority ? { priority } : {}, textSnapshot: snap }
+          { textSnapshot: snap }
         );
         return mcpSuccess({ annotationId: id });
       }
@@ -4605,16 +4652,13 @@ function registerAnnotationTools(server) {
       to: z3.number().describe("End position"),
       note: z3.string().optional().describe("Reason for flagging"),
       documentId: z3.string().optional().describe("Target document ID (defaults to active document)"),
-      priority: AnnotationPrioritySchema.optional().describe(
-        "Annotation priority. Set to 'urgent' for critical issues that should be visible even when the user has interruption mode set to urgent-only. Flags and questions are implicitly urgent."
-      ),
       textSnapshot: z3.string().optional().describe(
         "Expected text at [from, to] \u2014 returns RANGE_MOVED with relocated range on mismatch, or RANGE_GONE if text was deleted"
       )
     },
     withErrorBoundary(
       "tandem_flag",
-      async ({ from: rawFrom, to: rawTo, note, documentId, priority, textSnapshot }) => {
+      async ({ from: rawFrom, to: rawTo, note, documentId, textSnapshot }) => {
         const da = getDocAndAnnotations(documentId);
         if (!da) return noDocumentError();
         const from = toFlatOffset(rawFrom);
@@ -4626,7 +4670,6 @@ function registerAnnotationTools(server) {
         }
         const snap = captureSnapshot(da.ydoc, result.range.from, result.range.to);
         const id = createAnnotation(da.map, da.ydoc, "flag", result, note || "", {
-          ...priority ? { priority } : {},
           textSnapshot: snap
         });
         return mcpSuccess({ annotationId: id });
@@ -4781,20 +4824,21 @@ function registerAnnotationTools(server) {
 
 // src/server/mcp/api-routes.ts
 init_constants();
+init_types2();
+init_notifications();
+init_provider();
 init_document_model();
-init_file_opener();
 init_document_service();
-init_notifications();
 
 // src/server/mcp/docx-apply.ts
-init_document_service();
 init_constants();
+init_file_io();
 init_positions2();
 init_document_model();
-init_file_io();
-import { z as z4 } from "zod";
+init_document_service();
 import fs6 from "fs/promises";
 import path8 from "path";
+import { z as z4 } from "zod";
 async function applyChangesCore(documentId, author, backupPath) {
   const r = requireDocument(documentId);
   if (!r) throw Object.assign(new Error("No document is open."), { code: "NO_DOCUMENT" });
@@ -4968,6 +5012,7 @@ function registerApplyTools(server) {
 }
 
 // src/server/mcp/api-routes.ts
+init_file_opener();
 function isHostAllowed(host) {
   const reqHost = (host ?? "").split(":")[0];
   return reqHost === "localhost" || reqHost === "127.0.0.1";
@@ -5169,6 +5214,12 @@ function registerApiRoutes(app, largeBody) {
       sendApiError(res, err);
     }
   });
+  app.get("/api/mode", apiMiddleware, (_req, res) => {
+    const ctrlDoc = getOrCreateDocument(CTRL_ROOM);
+    const awareness = ctrlDoc.getMap(Y_MAP_USER_AWARENESS);
+    const mode = TandemModeSchema.catch(TANDEM_MODE_DEFAULT).parse(awareness.get(Y_MAP_MODE));
+    res.json({ mode });
+  });
   app.options("/api/apply-changes", apiMiddleware);
   app.post("/api/apply-changes", apiMiddleware, largeBody, async (req, res) => {
     const { documentId, author, backupPath } = req.body ?? {};
@@ -5198,11 +5249,12 @@ function registerApiRoutes(app, largeBody) {
 }
 
 // src/server/mcp/awareness.ts
-init_provider();
-import { z as z5 } from "zod";
-init_utils();
 init_constants();
+init_types2();
+init_utils();
 init_queue();
+init_provider();
+import { z as z5 } from "zod";
 var surfacedIds = /* @__PURE__ */ new Set();
 function registerAwarenessTools(server) {
   server.tool(
@@ -5307,7 +5359,8 @@ function registerAwarenessTools(server) {
       const userAwareness = doc.getMap(Y_MAP_USER_AWARENESS);
       const selection = userAwareness.get("selection");
       const activity = userAwareness.get("activity");
-      const interruptionMode = userAwareness.get("interruptionMode") ?? INTERRUPTION_MODE_DEFAULT;
+      const ctrlAwareness = ctrlDoc.getMap(Y_MAP_USER_AWARENESS);
+      const mode = TandemModeSchema.catch(TANDEM_MODE_DEFAULT).parse(ctrlAwareness.get(Y_MAP_MODE));
       const hasSelection = selection && selection.from !== selection.to;
       const selectedText = hasSelection ? safeSlice2(fullText, selection.from, selection.to) : null;
       const parts = [];
@@ -5335,7 +5388,7 @@ function registerAwarenessTools(server) {
       return mcpSuccess({
         summary,
         hasNew,
-        interruptionMode,
+        mode,
         userActions,
         userResponses,
         chatMessages,
@@ -5875,60 +5928,11 @@ async function startMcpServerHttp(port, host = "127.0.0.1") {
   });
 }
 
-// src/server/index.ts
-init_provider();
-init_constants();
-init_manager();
-init_platform();
-
-// src/server/version-check.ts
-import fs7 from "fs/promises";
-import path9 from "path";
-async function checkVersionChange(currentVersion, versionFilePath) {
-  let storedVersion = null;
-  try {
-    storedVersion = (await fs7.readFile(versionFilePath, "utf-8")).trim();
-  } catch (err) {
-    if (err.code !== "ENOENT") {
-      console.error("[Tandem] Failed to read last-seen-version:", err);
-    }
-  }
-  const result = storedVersion === null ? "first-install" : storedVersion === currentVersion ? "current" : "upgraded";
-  if (result !== "current") {
-    await fs7.mkdir(path9.dirname(versionFilePath), { recursive: true });
-    await fs7.writeFile(versionFilePath, currentVersion, "utf-8");
-  }
-  return result;
-}
-
-// src/server/error-filter.ts
-function isKnownHocuspocusError(err) {
-  if (!(err instanceof Error)) return false;
-  if ("code" in err) {
-    const code = err.code;
-    if (typeof code === "string" && code.startsWith("WS_ERR_")) {
-      return true;
-    }
-  }
-  const msg = err.message;
-  if (msg.startsWith("WebSocket is not open")) return true;
-  if (msg.includes("Unexpected end of array") || msg.includes("Integer out of Range")) return true;
-  if (msg.startsWith("Received a message with an unknown type:")) return true;
-  return false;
-}
-
-// src/server/index.ts
-init_queue();
-init_document_service();
-init_file_watcher();
-init_file_opener();
-init_document_model();
-
 // src/server/mcp/tutorial-annotations.ts
 init_constants();
+init_types2();
 init_queue();
 init_positions2();
-init_types2();
 init_document_model();
 var TUTORIAL_ANNOTATIONS = [
   {
@@ -6004,6 +6008,31 @@ function injectTutorialAnnotations(doc) {
 }
 
 // src/server/index.ts
+init_platform();
+init_manager();
+
+// src/server/version-check.ts
+import fs7 from "fs/promises";
+import path9 from "path";
+async function checkVersionChange(currentVersion, versionFilePath) {
+  let storedVersion = null;
+  try {
+    storedVersion = (await fs7.readFile(versionFilePath, "utf-8")).trim();
+  } catch (err) {
+    if (err.code !== "ENOENT") {
+      console.error("[Tandem] Failed to read last-seen-version:", err);
+    }
+  }
+  const result = storedVersion === null ? "first-install" : storedVersion === currentVersion ? "current" : "upgraded";
+  if (result !== "current") {
+    await fs7.mkdir(path9.dirname(versionFilePath), { recursive: true });
+    await fs7.writeFile(versionFilePath, currentVersion, "utf-8");
+  }
+  return result;
+}
+
+// src/server/index.ts
+init_provider();
 var isProduction = process.env.TANDEM_OPEN_BROWSER === "1";
 var SUPPRESSED_PATTERNS = [/^\[mammoth\]/, /Invalid access/i, /^\s*add yjs type/i];
 var originalStderrWrite = process.stderr.write.bind(process.stderr);