tandem-editor 0.3.0 → 0.3.2

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, TANDEM_MODE_DEFAULT, SELECTION_DWELL_DEFAULT_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_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";
@@ -22,6 +22,8 @@ var init_constants = __esm({
     SESSION_MAX_AGE = 30 * 24 * 60 * 60 * 1e3;
     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;
@@ -30,6 +32,7 @@ var init_constants = __esm({
     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";
@@ -41,504 +44,146 @@ 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}`);
-        return;
-      }
-      if (documents.has(documentName)) {
-        onDocUnloaded?.(documentName);
-        documents.delete(documentName);
-        console.error(`[Hocuspocus] Unloaded document from map: ${documentName}`);
-      }
+// src/shared/sanitize.ts
+function sanitizeAnnotation(input) {
+  const ann = input;
+  const base = {
+    id: ann.id,
+    author: ann.author,
+    range: ann.range,
+    content: ann.content,
+    status: ann.status,
+    timestamp: ann.timestamp,
+    ...ann.relRange !== void 0 ? { relRange: ann.relRange } : {},
+    ...ann.textSnapshot !== void 0 ? { textSnapshot: ann.textSnapshot } : {},
+    ...ann.editedAt !== void 0 ? { editedAt: ann.editedAt } : {}
+  };
+  if (ann.type === "suggestion") {
+    let suggestedText;
+    let content;
+    try {
+      const parsed = JSON.parse(ann.content);
+      suggestedText = parsed.newText;
+      content = parsed.reason ?? "";
+    } catch {
+      console.warn(
+        `[sanitizeAnnotation] Malformed JSON in legacy suggestion ${ann.id}, treating as plain comment`
+      );
+      content = ann.content;
     }
-  });
-  await hocuspocusInstance.listen();
-  const internal = hocuspocusInstance.server?.httpServer;
-  if (internal) {
-    internal.on("error", (err) => {
-      console.error(`[Tandem] Hocuspocus httpServer error: ${err.message}`);
-    });
+    return { ...base, type: "comment", content, suggestedText };
   }
-  return hocuspocusInstance;
+  if (ann.type === "question") {
+    return { ...base, type: "comment", directedAt: "claude" };
+  }
+  if (ann.type === "highlight") {
+    return {
+      ...base,
+      type: "highlight",
+      color: ann.color
+    };
+  }
+  if (ann.type === "flag") {
+    return { ...base, type: "flag" };
+  }
+  if (ann.type === "comment") {
+    return {
+      ...base,
+      type: "comment",
+      ...ann.suggestedText !== void 0 ? { suggestedText: ann.suggestedText } : {},
+      ...ann.directedAt !== void 0 ? { directedAt: ann.directedAt } : {}
+    };
+  }
+  console.warn(
+    `[sanitizeAnnotation] Unknown type "${ann.type}" for ${ann.id}, coercing to "comment"`
+  );
+  return { ...base, type: "comment" };
 }
-var hocuspocusInstance, documents, shouldKeepDocument, onDocSwapped, onDocUnloaded;
-var init_provider = __esm({
-  "src/server/yjs/provider.ts"() {
+var init_sanitize = __esm({
+  "src/shared/sanitize.ts"() {
     "use strict";
-    hocuspocusInstance = null;
-    documents = /* @__PURE__ */ new Map();
-    shouldKeepDocument = null;
-    onDocSwapped = null;
-    onDocUnloaded = null;
   }
 });
 
-// src/server/platform.ts
-import { execSync } from "child_process";
-import net from "net";
-import path from "path";
-import envPaths from "env-paths";
-function freePort(port) {
-  try {
-    if (process.platform === "win32") {
-      freePortWindows(port);
-    } else {
-      freePortUnix(port);
-    }
-  } catch (err) {
-    console.error(`[Tandem] freePort(${port}): ${err instanceof Error ? err.message : err}`);
+// src/shared/positions/types.ts
+var toFlatOffset, toSerializedRelPos;
+var init_types = __esm({
+  "src/shared/positions/types.ts"() {
+    "use strict";
+    toFlatOffset = (n) => n;
+    toSerializedRelPos = (json) => json;
   }
-}
-async function waitForPort(port, timeoutMs = 5e3) {
-  const start = Date.now();
-  while (Date.now() - start < timeoutMs) {
-    if (await tryBind(port)) return;
-    await new Promise((r) => setTimeout(r, 200));
+});
+
+// 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", "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"
+    ]);
   }
-  throw new Error(`Port ${port} still not available after ${timeoutMs}ms`);
-}
-function tryBind(port) {
-  return new Promise((resolve, reject) => {
-    const srv = net.createServer();
-    srv.once("error", (err) => {
-      srv.close(() => {
-        if (err.code === "EADDRINUSE") {
-          resolve(false);
-        } else {
-          reject(err);
-        }
-      });
-    });
-    srv.listen(port, "127.0.0.1", () => {
-      srv.close(() => resolve(true));
-    });
-  });
+});
+
+// src/shared/utils.ts
+function generateId(prefix) {
+  return `${prefix}_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`;
 }
-function parseLsofPids(output) {
-  return output.trim().split("\n").map((line) => parseInt(line.trim(), 10)).filter((pid) => Number.isFinite(pid) && pid > 0);
+function generateAnnotationId() {
+  return generateId("ann");
 }
-function parseSsPid(output) {
-  const match = output.match(/pid=(\d+)/);
-  return match ? parseInt(match[1], 10) : null;
+function generateMessageId() {
+  return generateId("msg");
 }
-function freePortWindows(port) {
-  const out = execSync(`netstat -ano | findstr ":${port}.*LISTENING"`, {
-    encoding: "utf-8",
-    stdio: ["pipe", "pipe", "ignore"]
-  });
-  const pid = out.trim().split(/\s+/).at(-1);
-  if (pid && /^\d+$/.test(pid)) {
-    execSync(`taskkill /PID ${pid} /F`, { stdio: "ignore" });
-    console.error(`[Tandem] Killed stale PID ${pid} holding port ${port}`);
-  }
+function generateEventId() {
+  return generateId("evt");
 }
-function freePortUnix(port) {
-  let pids = [];
-  try {
-    const out = execSync(`lsof -ti TCP:${port} -sTCP:LISTEN`, {
-      encoding: "utf-8",
-      stdio: ["pipe", "pipe", "ignore"]
-    });
-    pids = parseLsofPids(out);
-  } catch {
-    try {
-      const out = execSync(`ss -tlnp sport = :${port}`, {
-        encoding: "utf-8",
-        stdio: ["pipe", "pipe", "ignore"]
-      });
-      const pid = parseSsPid(out);
-      if (pid) pids = [pid];
-    } catch {
-    }
-  }
-  for (const pid of pids) {
-    try {
-      process.kill(pid, "SIGKILL");
-      console.error(`[Tandem] Killed stale PID ${pid} holding port ${port}`);
-    } catch {
-    }
-  }
+function generateNotificationId() {
+  return generateId("ntf");
 }
-var paths, SESSION_DIR, LAST_SEEN_VERSION_FILE;
-var init_platform = __esm({
-  "src/server/platform.ts"() {
+var init_utils = __esm({
+  "src/shared/utils.ts"() {
     "use strict";
-    paths = envPaths("tandem", { suffix: "" });
-    SESSION_DIR = path.join(paths.data, "sessions");
-    LAST_SEEN_VERSION_FILE = path.join(paths.data, "last-seen-version");
   }
 });
 
-// src/server/session/manager.ts
-import fs from "fs/promises";
-import path2 from "path";
-import * as Y2 from "yjs";
-async function atomicWrite(sessionPath, content) {
-  const tmpPath = `${sessionPath}.tmp`;
-  await fs.writeFile(tmpPath, content, "utf-8");
-  for (let attempt = 0; attempt < RENAME_MAX_RETRIES; attempt++) {
-    try {
-      await fs.rename(tmpPath, sessionPath);
-      return;
-    } catch (err) {
-      const code = err.code;
-      if ((code === "EPERM" || code === "EACCES") && attempt < RENAME_MAX_RETRIES - 1) {
-        await new Promise((r) => setTimeout(r, RENAME_RETRY_BASE_MS * 2 ** attempt));
-        continue;
-      }
-      await fs.unlink(tmpPath).catch(() => {
-      });
-      throw err;
-    }
-  }
+// src/shared/offsets.ts
+function headingPrefixLength(level) {
+  if (!level) return 0;
+  return level + 1;
 }
-function sessionKey(filePath) {
-  return encodeURIComponent(filePath.replace(/\\/g, "/"));
+function headingPrefix(level) {
+  return "#".repeat(level) + " ";
 }
-async function saveSession(filePath, format, doc) {
-  const key = sessionKey(filePath);
-  let sourceFileMtime = 0;
-  if (!filePath.startsWith("upload://")) {
-    try {
-      const stat = await fs.stat(filePath);
-      sourceFileMtime = stat.mtimeMs;
-    } catch {
-    }
-  }
-  const state = Y2.encodeStateAsUpdate(doc);
-  const ydocState = Buffer.from(state).toString("base64");
-  const data = {
-    filePath,
-    format,
-    ydocState,
-    sourceFileMtime,
-    lastAccessed: Date.now()
-  };
-  if (!sessionDirReady) {
-    await fs.mkdir(SESSION_DIR, { recursive: true });
-    sessionDirReady = true;
-  }
-  const sessionPath = path2.join(SESSION_DIR, `${key}.json`);
-  await atomicWrite(sessionPath, JSON.stringify(data));
-}
-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");
-    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) => {
-        console.error(`[Tandem] Failed to remove corrupted session ${sessionPath}:`, unlinkErr);
-      });
-      return null;
-    }
-    console.error(`[Tandem] Failed to read session ${sessionPath}:`, err);
-    return null;
-  }
-}
-function restoreYDoc(doc, session) {
-  const state = Buffer.from(session.ydocState, "base64");
-  Y2.applyUpdate(doc, new Uint8Array(state));
-}
-async function sourceFileChanged(session) {
-  if (session.filePath.startsWith("upload://")) return false;
-  try {
-    const stat = await fs.stat(session.filePath);
-    return stat.mtimeMs !== session.sourceFileMtime;
-  } catch {
-    return true;
-  }
-}
-async function deleteSession(filePath) {
-  const key = sessionKey(filePath);
-  const sessionPath = path2.join(SESSION_DIR, `${key}.json`);
-  try {
-    await fs.unlink(sessionPath);
-  } catch (err) {
-    const code = err.code;
-    if (code !== "ENOENT") {
-      console.error(`[Tandem] deleteSession: failed to delete ${sessionPath}:`, err);
-    }
-  }
-}
-async function saveCtrlSession(doc) {
-  if (!sessionDirReady) {
-    await fs.mkdir(SESSION_DIR, { recursive: true });
-    sessionDirReady = true;
-  }
-  const chatMap = doc.getMap(Y_MAP_CHAT);
-  const entries = [];
-  chatMap.forEach((value, key) => {
-    const msg = value;
-    entries.push({ id: key, timestamp: msg.timestamp });
-  });
-  if (entries.length > 200) {
-    entries.sort((a, b) => a.timestamp - b.timestamp);
-    const toDelete = entries.slice(0, entries.length - 200);
-    doc.transact(() => {
-      for (const entry of toDelete) {
-        chatMap.delete(entry.id);
-      }
-    }, MCP_ORIGIN);
-  }
-  const state = Y2.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`);
-  await atomicWrite(sessionPath, JSON.stringify(data));
-}
-async function loadCtrlSession() {
-  const sessionPath = path2.join(SESSION_DIR, `${CTRL_SESSION_KEY}.json`);
-  try {
-    const content = await fs.readFile(sessionPath, "utf-8");
-    const data = JSON.parse(content);
-    return data.ydocState ?? null;
-  } catch (err) {
-    const code = err.code;
-    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) => {
-        console.error(
-          `[Tandem] Failed to remove corrupted ctrl session ${sessionPath}:`,
-          unlinkErr
-        );
-      });
-      return null;
-    }
-    console.error(`[Tandem] Failed to read ctrl session:`, err);
-    return null;
-  }
-}
-function restoreCtrlDoc(doc, base64State) {
-  const state = Buffer.from(base64State, "base64");
-  Y2.applyUpdate(doc, new Uint8Array(state));
-}
-async function listSessionFilePaths() {
-  try {
-    await fs.mkdir(SESSION_DIR, { recursive: true });
-    const files = await fs.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 data = JSON.parse(raw);
-        if (!data.filePath || data.filePath.startsWith("upload://")) continue;
-        results.push({ filePath: data.filePath, lastAccessed: data.lastAccessed ?? 0 });
-      } catch (err) {
-        console.error(`[Tandem] Skipping unreadable session file ${file}:`, err);
-      }
-    }
-    results.sort((a, b) => b.lastAccessed - a.lastAccessed);
-    return results;
-  } catch (err) {
-    console.error("[Tandem] Failed to read session directory:", err);
-    return [];
-  }
-}
-async function cleanupSessions() {
-  let cleaned = 0;
-  let files;
-  try {
-    files = await fs.readdir(SESSION_DIR);
-  } catch (err) {
-    if (err.code === "ENOENT") return 0;
-    console.error("[Tandem] Failed to read session directory:", err);
-    return 0;
-  }
-  const now = Date.now();
-  for (const file of files) {
-    try {
-      const filePath = path2.join(SESSION_DIR, file);
-      const stat = await fs.stat(filePath);
-      if (now - stat.mtimeMs > SESSION_MAX_AGE) {
-        await fs.unlink(filePath);
-        cleaned++;
-      }
-    } catch (err) {
-      console.error(`[Tandem] cleanupSessions: failed to process ${file}:`, err);
-    }
-  }
-  return cleaned;
-}
-function isAutoSaveRunning() {
-  return autoSaveTimer !== null;
-}
-function startAutoSave(callback) {
-  stopAutoSave();
-  autoSaveCallback = callback;
-  autoSaveTimer = setInterval(async () => {
-    try {
-      await autoSaveCallback?.();
-    } catch (err) {
-      console.error("[Tandem] Auto-save failed:", err);
-    }
-  }, AUTO_SAVE_INTERVAL);
-}
-function stopAutoSave() {
-  if (autoSaveTimer) {
-    clearInterval(autoSaveTimer);
-    autoSaveTimer = null;
-  }
-  autoSaveCallback = null;
-}
-var AUTO_SAVE_INTERVAL, RENAME_MAX_RETRIES, RENAME_RETRY_BASE_MS, sessionDirReady, CTRL_SESSION_KEY, autoSaveTimer, autoSaveCallback;
-var init_manager = __esm({
-  "src/server/session/manager.ts"() {
-    "use strict";
-    init_platform();
-    init_constants();
-    init_queue();
-    AUTO_SAVE_INTERVAL = 60 * 1e3;
-    RENAME_MAX_RETRIES = 3;
-    RENAME_RETRY_BASE_MS = 50;
-    sessionDirReady = false;
-    CTRL_SESSION_KEY = CTRL_ROOM;
-    autoSaveTimer = null;
-    autoSaveCallback = null;
-  }
-});
-
-// 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;
-        return;
-      }
-      if (entry.timer !== null) {
-        clearTimeout(entry.timer);
-      }
-      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;
-  }
-  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}`);
-}
-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"() {
+var FLAT_SEPARATOR;
+var init_offsets = __esm({
+  "src/shared/offsets.ts"() {
     "use strict";
-    watched = /* @__PURE__ */ new Map();
+    FLAT_SEPARATOR = "\n";
   }
 });
 
 // src/server/file-io/mdast-ydoc.ts
-import * as Y3 from "yjs";
+import * as Y from "yjs";
 function mdastToYDoc(doc, tree) {
   const fragment = doc.getXmlFragment("default");
   if (fragment.length > 0) {
@@ -563,22 +208,22 @@ function mdastToYDoc(doc, tree) {
 function blockToYxml(node, deferred) {
   switch (node.type) {
     case "heading": {
-      const el = new Y3.XmlElement("heading");
+      const el = new Y.XmlElement("heading");
       el.setAttribute("level", node.depth);
-      const text = new Y3.XmlText();
+      const text = new Y.XmlText();
       el.insert(0, [text]);
       deferred.push({ xmlText: text, nodes: node.children });
       return [el];
     }
     case "paragraph": {
-      const el = new Y3.XmlElement("paragraph");
-      const text = new Y3.XmlText();
+      const el = new Y.XmlElement("paragraph");
+      const text = new Y.XmlText();
       el.insert(0, [text]);
       deferred.push({ xmlText: text, nodes: node.children });
       return [el];
     }
     case "blockquote": {
-      const el = new Y3.XmlElement("blockquote");
+      const el = new Y.XmlElement("blockquote");
       for (const child of node.children) {
         const childEls = blockToYxml(child, deferred);
         for (const c of childEls) {
@@ -589,12 +234,12 @@ function blockToYxml(node, deferred) {
     }
     case "list": {
       const nodeName = node.ordered ? "orderedList" : "bulletList";
-      const el = new Y3.XmlElement(nodeName);
+      const el = new Y.XmlElement(nodeName);
       if (node.ordered && node.start != null && node.start !== 1) {
         el.setAttribute("start", node.start);
       }
       for (const item of node.children) {
-        const listItem = new Y3.XmlElement("listItem");
+        const listItem = new Y.XmlElement("listItem");
         for (const child of item.children) {
           const childEls = blockToYxml(child, deferred);
           for (const c of childEls) {
@@ -606,20 +251,20 @@ function blockToYxml(node, deferred) {
       return [el];
     }
     case "code": {
-      const el = new Y3.XmlElement("codeBlock");
+      const el = new Y.XmlElement("codeBlock");
       if (node.lang) {
         el.setAttribute("language", node.lang);
       }
-      const text = new Y3.XmlText();
+      const text = new Y.XmlText();
       el.insert(0, [text]);
       deferred.push({ xmlText: text, plainText: node.value });
       return [el];
     }
     case "thematicBreak": {
-      return [new Y3.XmlElement("horizontalRule")];
+      return [new Y.XmlElement("horizontalRule")];
     }
     case "image": {
-      const el = new Y3.XmlElement("image");
+      const el = new Y.XmlElement("image");
       el.setAttribute("src", node.url);
       if (node.alt) el.setAttribute("alt", node.alt);
       if (node.title) el.setAttribute("title", node.title);
@@ -628,8 +273,8 @@ function blockToYxml(node, deferred) {
     // html blocks, definitions, etc. — wrap as paragraphs to avoid data loss
     default: {
       if ("value" in node && typeof node.value === "string") {
-        const el = new Y3.XmlElement("paragraph");
-        const text = new Y3.XmlText();
+        const el = new Y.XmlElement("paragraph");
+        const text = new Y.XmlText();
         el.insert(0, [text]);
         deferred.push({ xmlText: text, plainText: node.value });
         return [el];
@@ -672,7 +317,7 @@ function processInline(xmlText, nodes, marks) {
         });
         break;
       case "break": {
-        const embed = new Y3.XmlElement("hardBreak");
+        const embed = new Y.XmlElement("hardBreak");
         xmlText.insertEmbed(xmlText.length, embed);
         break;
       }
@@ -694,7 +339,7 @@ function yDocToMdast(doc) {
   const children = [];
   for (let i = 0; i < fragment.length; i++) {
     const node = fragment.get(i);
-    if (node instanceof Y3.XmlElement) {
+    if (node instanceof Y.XmlElement) {
       const mdastNode = yxmlToMdast(node);
       if (mdastNode) children.push(mdastNode);
     }
@@ -713,7 +358,7 @@ function yxmlToMdast(el) {
       const children = [];
       for (let i = 0; i < el.length; i++) {
         const child = el.get(i);
-        if (child instanceof Y3.XmlElement) {
+        if (child instanceof Y.XmlElement) {
           const m = yxmlToMdast(child);
           if (m) children.push(m);
         }
@@ -727,11 +372,11 @@ function yxmlToMdast(el) {
       const listItems = [];
       for (let i = 0; i < el.length; i++) {
         const child = el.get(i);
-        if (child instanceof Y3.XmlElement && child.nodeName === "listItem") {
+        if (child instanceof Y.XmlElement && child.nodeName === "listItem") {
           const itemChildren = [];
           for (let j = 0; j < child.length; j++) {
             const grandchild = child.get(j);
-            if (grandchild instanceof Y3.XmlElement) {
+            if (grandchild instanceof Y.XmlElement) {
               const m = yxmlToMdast(grandchild);
               if (m) itemChildren.push(m);
             }
@@ -752,7 +397,7 @@ function yxmlToMdast(el) {
       let value = "";
       for (let i = 0; i < el.length; i++) {
         const child = el.get(i);
-        if (child instanceof Y3.XmlText) {
+        if (child instanceof Y.XmlText) {
           value += child.toString();
         }
       }
@@ -786,11 +431,11 @@ function deltaToPhrasingContent(el) {
   const result = [];
   for (let i = 0; i < el.length; i++) {
     const child = el.get(i);
-    if (child instanceof Y3.XmlText) {
+    if (child instanceof Y.XmlText) {
       const delta = child.toDelta();
       for (const op of delta) {
         if (typeof op.insert !== "string") {
-          if (op.insert instanceof Y3.XmlElement && op.insert.nodeName === "hardBreak") {
+          if (op.insert instanceof Y.XmlElement && op.insert.nodeName === "hardBreak") {
             result.push({ type: "break" });
           }
           continue;
@@ -838,7 +483,7 @@ function deltaToPhrasingContent(el) {
         }
         result.push(node);
       }
-    } else if (child instanceof Y3.XmlElement) {
+    } else if (child instanceof Y.XmlElement) {
       if (child.nodeName === "hardBreak") {
         result.push({ type: "break" });
       }
@@ -855,10 +500,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);
@@ -883,27 +528,11 @@ 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";
+import path from "path";
+import * as Y2 from "yjs";
 function detectFormat(filePath) {
-  const ext = path3.extname(filePath).toLowerCase();
+  const ext = path.extname(filePath).toLowerCase();
   switch (ext) {
     case ".md":
       return "md";
@@ -924,7 +553,7 @@ function docIdFromPath(filePath) {
   for (let i = 0; i < normalized.length; i++) {
     hash = (hash << 5) - hash + normalized.charCodeAt(i) | 0;
   }
-  const name = path3.basename(normalized, path3.extname(normalized)).replace(/[^a-zA-Z0-9]/g, "-").replace(/-+/g, "-").slice(0, 16);
+  const name = path.basename(normalized, path.extname(normalized)).replace(/[^a-zA-Z0-9]/g, "-").replace(/-+/g, "-").slice(0, 16);
   return `${name}-${Math.abs(hash).toString(36).slice(0, 6)}`;
 }
 function populateYDoc(doc, text) {
@@ -936,27 +565,27 @@ function populateYDoc(doc, text) {
   const lines = text.split("\n");
   for (const line of lines) {
     if (line === "") {
-      const empty = new Y4.XmlElement("paragraph");
-      empty.insert(0, [new Y4.XmlText("")]);
+      const empty = new Y2.XmlElement("paragraph");
+      empty.insert(0, [new Y2.XmlText("")]);
       fragment.insert(fragment.length, [empty]);
       continue;
     }
     let element;
     if (line.startsWith("### ")) {
-      element = new Y4.XmlElement("heading");
+      element = new Y2.XmlElement("heading");
       element.setAttribute("level", 3);
-      element.insert(0, [new Y4.XmlText(line.slice(4))]);
+      element.insert(0, [new Y2.XmlText(line.slice(4))]);
     } else if (line.startsWith("## ")) {
-      element = new Y4.XmlElement("heading");
+      element = new Y2.XmlElement("heading");
       element.setAttribute("level", 2);
-      element.insert(0, [new Y4.XmlText(line.slice(3))]);
+      element.insert(0, [new Y2.XmlText(line.slice(3))]);
     } else if (line.startsWith("# ")) {
-      element = new Y4.XmlElement("heading");
+      element = new Y2.XmlElement("heading");
       element.setAttribute("level", 1);
-      element.insert(0, [new Y4.XmlText(line.slice(2))]);
+      element.insert(0, [new Y2.XmlText(line.slice(2))]);
     } else {
-      element = new Y4.XmlElement("paragraph");
-      element.insert(0, [new Y4.XmlText(line)]);
+      element = new Y2.XmlElement("paragraph");
+      element.insert(0, [new Y2.XmlText(line)]);
     }
     fragment.insert(fragment.length, [element]);
   }
@@ -965,9 +594,9 @@ function getElementText(element) {
   const parts = [];
   for (let i = 0; i < element.length; i++) {
     const child = element.get(i);
-    if (child instanceof Y4.XmlText) {
+    if (child instanceof Y2.XmlText) {
       parts.push(child.toString());
-    } else if (child instanceof Y4.XmlElement) {
+    } else if (child instanceof Y2.XmlElement) {
       parts.push(getElementText(child));
     }
   }
@@ -978,7 +607,7 @@ function extractText(doc) {
   const lines = [];
   for (let i = 0; i < fragment.length; i++) {
     const node = fragment.get(i);
-    if (node instanceof Y4.XmlElement) {
+    if (node instanceof Y2.XmlElement) {
       const text = getElementText(node);
       if (node.nodeName === "heading") {
         const level = Number(node.getAttribute("level") ?? 1);
@@ -1003,7 +632,7 @@ function getHeadingPrefixLength(node) {
 function findXmlText(element) {
   for (let i = 0; i < element.length; i++) {
     const child = element.get(i);
-    if (child instanceof Y4.XmlText) {
+    if (child instanceof Y2.XmlText) {
       return child;
     }
   }
@@ -1011,7 +640,7 @@ function findXmlText(element) {
 }
 function getOrCreateXmlText(element) {
   return findXmlText(element) ?? (() => {
-    const textNode = new Y4.XmlText("");
+    const textNode = new Y2.XmlText("");
     element.insert(0, [textNode]);
     return textNode;
   })();
@@ -1026,7 +655,7 @@ var init_document_model = __esm({
 
 // src/server/file-io/docx-html.ts
 import * as htmlparser2 from "htmlparser2";
-import * as Y5 from "yjs";
+import * as Y3 from "yjs";
 function buildAttrs2(marks) {
   const attrs = {};
   for (const name of ALL_MARKS2) {
@@ -1063,8 +692,8 @@ function domNodeToYxml(node, deferred) {
   if (isText(node)) {
     const text = node.data;
     if (!text.trim()) return [];
-    const el = new Y5.XmlElement("paragraph");
-    const xmlText = new Y5.XmlText();
+    const el = new Y3.XmlElement("paragraph");
+    const xmlText = new Y3.XmlText();
     el.insert(0, [xmlText]);
     deferred.push({ xmlText, children: [node], marks: {} });
     return [el];
@@ -1073,23 +702,23 @@ function domNodeToYxml(node, deferred) {
   const tag = node.tagName.toLowerCase();
   const headingMatch = tag.match(/^h([1-6])$/);
   if (headingMatch) {
-    const el = new Y5.XmlElement("heading");
+    const el = new Y3.XmlElement("heading");
     el.setAttribute("level", parseInt(headingMatch[1]));
-    const xmlText = new Y5.XmlText();
+    const xmlText = new Y3.XmlText();
     el.insert(0, [xmlText]);
     deferred.push({ xmlText, children: node.children, marks: {} });
     return [el];
   }
   switch (tag) {
     case "p": {
-      const el = new Y5.XmlElement("paragraph");
-      const xmlText = new Y5.XmlText();
+      const el = new Y3.XmlElement("paragraph");
+      const xmlText = new Y3.XmlText();
       el.insert(0, [xmlText]);
       deferred.push({ xmlText, children: node.children, marks: {} });
       return [el];
     }
     case "blockquote": {
-      const el = new Y5.XmlElement("blockquote");
+      const el = new Y3.XmlElement("blockquote");
       const blockChildren = collectBlockChildren(node.children, deferred);
       for (const child of blockChildren) {
         el.insert(el.length, [child]);
@@ -1097,7 +726,7 @@ function domNodeToYxml(node, deferred) {
       return [el];
     }
     case "ul": {
-      const el = new Y5.XmlElement("bulletList");
+      const el = new Y3.XmlElement("bulletList");
       for (const child of node.children) {
         if (isElement(child) && child.tagName.toLowerCase() === "li") {
           el.insert(el.length, [buildListItem(child, deferred)]);
@@ -1106,7 +735,7 @@ function domNodeToYxml(node, deferred) {
       return [el];
     }
     case "ol": {
-      const el = new Y5.XmlElement("orderedList");
+      const el = new Y3.XmlElement("orderedList");
       const start = parseInt(node.attribs.start || "1");
       if (start !== 1) {
         el.setAttribute("start", start);
@@ -1119,7 +748,7 @@ function domNodeToYxml(node, deferred) {
       return [el];
     }
     case "table": {
-      const el = new Y5.XmlElement("table");
+      const el = new Y3.XmlElement("table");
       const rows = collectTableRows(node);
       for (const row of rows) {
         el.insert(el.length, [buildTableRow(row, deferred)]);
@@ -1127,25 +756,25 @@ function domNodeToYxml(node, deferred) {
       return [el];
     }
     case "pre": {
-      const el = new Y5.XmlElement("codeBlock");
-      const xmlText = new Y5.XmlText();
+      const el = new Y3.XmlElement("codeBlock");
+      const xmlText = new Y3.XmlText();
       el.insert(0, [xmlText]);
       deferred.push({ xmlText, children: node.children, marks: {} });
       return [el];
     }
     case "img": {
-      const el = new Y5.XmlElement("image");
+      const el = new Y3.XmlElement("image");
       el.setAttribute("src", node.attribs.src || "");
       if (node.attribs.alt) el.setAttribute("alt", node.attribs.alt);
       if (node.attribs.title) el.setAttribute("title", node.attribs.title);
       return [el];
     }
     case "hr": {
-      return [new Y5.XmlElement("horizontalRule")];
+      return [new Y3.XmlElement("horizontalRule")];
     }
     case "br": {
-      const el = new Y5.XmlElement("paragraph");
-      el.insert(0, [new Y5.XmlText("")]);
+      const el = new Y3.XmlElement("paragraph");
+      el.insert(0, [new Y3.XmlText("")]);
       return [el];
     }
     case "div": {
@@ -1163,8 +792,8 @@ function domNodeToYxml(node, deferred) {
         }
         return results;
       }
-      const el = new Y5.XmlElement("paragraph");
-      const xmlText = new Y5.XmlText();
+      const el = new Y3.XmlElement("paragraph");
+      const xmlText = new Y3.XmlText();
       el.insert(0, [xmlText]);
       deferred.push({ xmlText, children: node.children, marks: {} });
       return [el];
@@ -1183,8 +812,8 @@ function collectBlockChildren(children, deferred) {
     if (inlineBuffer.length === 0) return;
     const hasContent = inlineBuffer.some((n) => isText(n) ? n.data.trim().length > 0 : true);
     if (hasContent) {
-      const el = new Y5.XmlElement("paragraph");
-      const xmlText = new Y5.XmlText();
+      const el = new Y3.XmlElement("paragraph");
+      const xmlText = new Y3.XmlText();
       el.insert(0, [xmlText]);
       deferred.push({ xmlText, children: inlineBuffer, marks: {} });
       result.push(el);
@@ -1201,14 +830,14 @@ function collectBlockChildren(children, deferred) {
   }
   flushInline();
   if (result.length === 0) {
-    const el = new Y5.XmlElement("paragraph");
-    el.insert(0, [new Y5.XmlText("")]);
+    const el = new Y3.XmlElement("paragraph");
+    el.insert(0, [new Y3.XmlText("")]);
     result.push(el);
   }
   return result;
 }
 function buildListItem(li, deferred) {
-  const listItem = new Y5.XmlElement("listItem");
+  const listItem = new Y3.XmlElement("listItem");
   const blockChildren = collectBlockChildren(li.children, deferred);
   for (const child of blockChildren) {
     listItem.insert(listItem.length, [child]);
@@ -1233,13 +862,13 @@ function collectTableRows(table) {
   return rows;
 }
 function buildTableRow(tr, deferred) {
-  const row = new Y5.XmlElement("tableRow");
+  const row = new Y3.XmlElement("tableRow");
   for (const child of tr.children) {
     if (!isElement(child)) continue;
     const tag = child.tagName.toLowerCase();
     if (tag === "td" || tag === "th") {
       const nodeName = tag === "th" ? "tableHeader" : "tableCell";
-      const cell = new Y5.XmlElement(nodeName);
+      const cell = new Y3.XmlElement(nodeName);
       if (child.attribs.colspan && child.attribs.colspan !== "1") {
         cell.setAttribute("colspan", parseInt(child.attribs.colspan));
       }
@@ -1267,7 +896,7 @@ function processInlineNodes(xmlText, nodes, marks) {
     if (!isElement(node)) continue;
     const tag = node.tagName.toLowerCase();
     if (tag === "br") {
-      const embed = new Y5.XmlElement("hardBreak");
+      const embed = new Y3.XmlElement("hardBreak");
       xmlText.insertEmbed(xmlText.length, embed);
       continue;
     }
@@ -1341,7 +970,7 @@ var init_docx_html = __esm({
 
 // src/server/file-io/docx.ts
 import mammoth from "mammoth";
-import * as Y6 from "yjs";
+import * as Y4 from "yjs";
 async function loadDocx(content) {
   const result = await mammoth.convertToHtml({ buffer: content });
   for (const msg of result.messages) {
@@ -1357,33 +986,35 @@ function exportAnnotations(doc, annotations) {
   const fullText = extractFullText(fragment);
   const groups = {};
   for (const ann of annotations) {
-    const key = ann.type;
+    let key;
+    if (ann.type === "highlight") key = "highlights";
+    else if (ann.suggestedText !== void 0) key = "suggestions";
+    else if (ann.directedAt === "claude") key = "questions";
+    else if (ann.type === "flag") key = "flags";
+    else key = "comments";
     if (!groups[key]) groups[key] = [];
-    groups[key].push(ann);
+    groups[key]?.push(ann);
   }
   const lines = ["# Document Review", ""];
-  const typeLabels = {
-    highlight: "Highlights",
-    comment: "Comments",
-    suggestion: "Suggestions",
-    overlay: "Overlays",
-    question: "Questions",
-    flag: "Flags"
+  const groupLabels = {
+    highlights: "Highlights",
+    comments: "Comments",
+    suggestions: "Suggestions",
+    questions: "Questions for Claude",
+    flags: "Flags"
   };
-  for (const [type, anns] of Object.entries(groups)) {
-    lines.push(`## ${typeLabels[type] || type}`, "");
+  const groupOrder = ["highlights", "comments", "suggestions", "questions", "flags"];
+  for (const key of groupOrder) {
+    const anns = groups[key];
+    if (!anns) continue;
+    lines.push(`## ${groupLabels[key]}`, "");
     for (const ann of anns) {
       const snippet = safeSlice(fullText, ann.range.from, ann.range.to);
       const truncated = snippet.length > 80 ? snippet.slice(0, 77) + "..." : snippet;
       lines.push(`- **"${truncated}"** (${ann.author})`);
-      if (ann.type === "suggestion") {
-        try {
-          const { newText, reason } = JSON.parse(ann.content);
-          lines.push(`  - Replace with: "${newText}"`);
-          if (reason) lines.push(`  - Reason: ${reason}`);
-        } catch {
-          lines.push(`  - ${ann.content}`);
-        }
+      if (ann.suggestedText !== void 0) {
+        lines.push(`  - Replace with: "${ann.suggestedText}"`);
+        if (ann.content) lines.push(`  - Reason: ${ann.content}`);
       } else if (ann.content) {
         lines.push(`  - ${ann.content}`);
       }
@@ -1399,7 +1030,7 @@ function extractFullText(fragment) {
   const parts = [];
   for (let i = 0; i < fragment.length; i++) {
     const node = fragment.get(i);
-    if (node instanceof Y6.XmlElement) {
+    if (node instanceof Y4.XmlElement) {
       parts.push(getElementText(node));
     }
   }
@@ -1418,13 +1049,33 @@ var init_docx = __esm({
   }
 });
 
-// src/shared/positions/types.ts
-var toFlatOffset, toSerializedRelPos;
-var init_types = __esm({
-  "src/shared/positions/types.ts"() {
+// src/server/notifications.ts
+function pushNotification(notification) {
+  buffer.push(notification);
+  while (buffer.length > NOTIFICATION_BUFFER_SIZE) {
+    buffer.shift();
+  }
+  for (const cb of subscribers) {
+    try {
+      cb(notification);
+    } catch (err) {
+      console.error("[Notifications] Subscriber threw during dispatch:", err);
+    }
+  }
+}
+function subscribe(cb) {
+  subscribers.add(cb);
+  return () => {
+    subscribers.delete(cb);
+  };
+}
+var buffer, subscribers;
+var init_notifications = __esm({
+  "src/server/notifications.ts"() {
     "use strict";
-    toFlatOffset = (n) => n;
-    toSerializedRelPos = (json) => json;
+    init_constants();
+    buffer = [];
+    subscribers = /* @__PURE__ */ new Set();
   }
 });
 
@@ -1437,12 +1088,12 @@ var init_positions = __esm({
 });
 
 // src/server/positions.ts
-import * as Y7 from "yjs";
+import * as Y5 from "yjs";
 function resolveToElement(fragment, charOffset) {
   let accumulated = 0;
   for (let i = 0; i < fragment.length; i++) {
     const node = fragment.get(i);
-    if (!(node instanceof Y7.XmlElement)) continue;
+    if (!(node instanceof Y5.XmlElement)) continue;
     const prefixLen = getHeadingPrefixLength(node);
     const text = getElementText(node);
     const fullLen = prefixLen + text.length;
@@ -1462,7 +1113,7 @@ function resolveToElement(fragment, charOffset) {
   }
   if (fragment.length > 0) {
     const lastNode = fragment.get(fragment.length - 1);
-    if (lastNode instanceof Y7.XmlElement) {
+    if (lastNode instanceof Y5.XmlElement) {
       return {
         elementIndex: fragment.length - 1,
         textOffset: getElementText(lastNode).length,
@@ -1477,17 +1128,17 @@ function flatOffsetToRelPos(doc, offset, assoc) {
   const resolved = resolveToElement(fragment, offset);
   if (!resolved || resolved.clampedFromPrefix) return null;
   const node = fragment.get(resolved.elementIndex);
-  if (!(node instanceof Y7.XmlElement)) return null;
+  if (!(node instanceof Y5.XmlElement)) return null;
   const xmlText = findXmlText(node);
   if (!xmlText) return null;
-  const rpos = Y7.createRelativePositionFromTypeIndex(xmlText, resolved.textOffset, assoc);
-  return toSerializedRelPos(Y7.relativePositionToJSON(rpos));
+  const rpos = Y5.createRelativePositionFromTypeIndex(xmlText, resolved.textOffset, assoc);
+  return toSerializedRelPos(Y5.relativePositionToJSON(rpos));
 }
 function relPosToFlatOffset(doc, relPosJson) {
   let absPos;
   try {
-    const rpos = Y7.createRelativePositionFromJSON(relPosJson);
-    absPos = Y7.createAbsolutePositionFromRelativePosition(rpos, doc);
+    const rpos = Y5.createRelativePositionFromJSON(relPosJson);
+    absPos = Y5.createAbsolutePositionFromRelativePosition(rpos, doc);
   } catch (err) {
     if (!(err instanceof TypeError) && !(err instanceof SyntaxError)) {
       console.error("[positions] relPosToFlatOffset: unexpected error resolving relRange:", err);
@@ -1499,7 +1150,7 @@ function relPosToFlatOffset(doc, relPosJson) {
   let accumulated = 0;
   for (let i = 0; i < fragment.length; i++) {
     const node = fragment.get(i);
-    if (!(node instanceof Y7.XmlElement)) continue;
+    if (!(node instanceof Y5.XmlElement)) continue;
     const prefixLen = getHeadingPrefixLength(node);
     const text = getElementText(node);
     const xmlText = findXmlText(node);
@@ -1634,46 +1285,104 @@ 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, HighlightColorSchema, SeveritySchema, TandemModeSchema, AuthorSchema, AnnotationActionSchema, ExportFormatSchema, DocumentFormatSchema, ToolErrorCodeSchema;
-var init_types2 = __esm({
-  "src/shared/types.ts"() {
+// src/server/yjs/provider.ts
+import { Hocuspocus } from "@hocuspocus/server";
+import * as Y6 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 Y6.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 = Y6.encodeStateAsUpdate(existing);
+        Y6.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 (documents.has(documentName)) {
+        onDocUnloaded?.(documentName);
+        documents.delete(documentName);
+        console.error(`[Hocuspocus] Unloaded document from map: ${documentName}`);
+      }
+    }
+  });
+  await hocuspocusInstance.listen();
+  const internal = hocuspocusInstance.server?.httpServer;
+  if (internal) {
+    internal.on("error", (err) => {
+      console.error(`[Tandem] Hocuspocus httpServer error: ${err.message}`);
+    });
+  }
+  return hocuspocusInstance;
+}
+var hocuspocusInstance, documents, shouldKeepDocument, onDocSwapped, onDocUnloaded;
+var init_provider = __esm({
+  "src/server/yjs/provider.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"]);
-    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"
-    ]);
+    hocuspocusInstance = null;
+    documents = /* @__PURE__ */ new Map();
+    shouldKeepDocument = null;
+    onDocSwapped = null;
+    onDocUnloaded = null;
   }
 });
 
@@ -1807,8 +1516,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");
@@ -1898,11 +1607,9 @@ function injectCommentsAsAnnotations(doc, comments) {
         range: { from: result.range.from, to: result.range.to },
         content,
         status: "pending",
-        timestamp: comment.date ? new Date(comment.date).getTime() : Date.now()
+        timestamp: comment.date ? new Date(comment.date).getTime() : Date.now(),
+        ...result.fullyAnchored ? { relRange: result.relRange } : {}
       };
-      if (result.fullyAnchored) {
-        annotation.relRange = result.relRange;
-      }
       map.set(id, annotation);
       injected++;
     }
@@ -1916,9 +1623,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();
   }
 });
@@ -2241,9 +1948,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();
@@ -2774,23 +2481,23 @@ var init_docx_apply = __esm({
 });
 
 // src/server/file-io/index.ts
-import fs3 from "fs/promises";
-import path4 from "path";
+import fs from "fs/promises";
+import path2 from "path";
 function getAdapter(format) {
   return adapters[format] ?? plaintextAdapter;
 }
-async function atomicWrite2(filePath, content) {
-  const tempPath = path4.join(path4.dirname(filePath), `.tandem-tmp-${Date.now()}`);
-  await fs3.writeFile(tempPath, content, "utf-8");
-  await fs3.rename(tempPath, filePath);
+async function atomicWrite(filePath, content) {
+  const tempPath = path2.join(path2.dirname(filePath), `.tandem-tmp-${Date.now()}`);
+  await fs.writeFile(tempPath, content, "utf-8");
+  await fs.rename(tempPath, filePath);
 }
 async function atomicWriteBuffer(filePath, content) {
-  const tempPath = path4.join(path4.dirname(filePath), `.tandem-tmp-${Date.now()}`);
-  await fs3.writeFile(tempPath, content);
+  const tempPath = path2.join(path2.dirname(filePath), `.tandem-tmp-${Date.now()}`);
+  await fs.writeFile(tempPath, content);
   try {
-    await fs3.rename(tempPath, filePath);
+    await fs.rename(tempPath, filePath);
   } catch (err) {
-    await fs3.unlink(tempPath).catch(() => {
+    await fs.unlink(tempPath).catch(() => {
     });
     throw err;
   }
@@ -2799,10 +2506,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,
@@ -2853,111 +2560,460 @@ var init_file_io = __esm({
   }
 });
 
-// src/server/notifications.ts
-function pushNotification(notification) {
-  buffer.push(notification);
-  while (buffer.length > NOTIFICATION_BUFFER_SIZE) {
-    buffer.shift();
-  }
-  for (const cb of subscribers) {
-    try {
-      cb(notification);
-    } catch (err) {
-      console.error("[Notifications] Subscriber threw during dispatch:", err);
-    }
+// 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;
+        return;
+      }
+      if (entry.timer !== null) {
+        clearTimeout(entry.timer);
+      }
+      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;
   }
+  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}`);
 }
-function subscribe(cb) {
-  subscribers.add(cb);
-  return () => {
-    subscribers.delete(cb);
-  };
+function suppressNextChange(filePath) {
+  const entry = watched.get(filePath);
+  if (entry) {
+    entry.suppressed = true;
+  }
 }
-var buffer, subscribers;
-var init_notifications = __esm({
-  "src/server/notifications.ts"() {
+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";
-    init_constants();
-    buffer = [];
-    subscribers = /* @__PURE__ */ new Set();
+    watched = /* @__PURE__ */ new Map();
   }
 });
 
-// src/shared/utils.ts
-function generateId(prefix) {
-  return `${prefix}_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`;
+// src/server/platform.ts
+import { execSync } from "child_process";
+import envPaths from "env-paths";
+import net from "net";
+import path3 from "path";
+function freePort(port) {
+  try {
+    if (process.platform === "win32") {
+      freePortWindows(port);
+    } else {
+      freePortUnix(port);
+    }
+  } catch (err) {
+    console.error(`[Tandem] freePort(${port}): ${err instanceof Error ? err.message : err}`);
+  }
 }
-function generateAnnotationId() {
-  return generateId("ann");
+async function waitForPort(port, timeoutMs = 5e3) {
+  const start = Date.now();
+  while (Date.now() - start < timeoutMs) {
+    if (await tryBind(port)) return;
+    await new Promise((r) => setTimeout(r, 200));
+  }
+  throw new Error(`Port ${port} still not available after ${timeoutMs}ms`);
 }
-function generateMessageId() {
-  return generateId("msg");
+function tryBind(port) {
+  return new Promise((resolve, reject) => {
+    const srv = net.createServer();
+    srv.once("error", (err) => {
+      srv.close(() => {
+        if (err.code === "EADDRINUSE") {
+          resolve(false);
+        } else {
+          reject(err);
+        }
+      });
+    });
+    srv.listen(port, "127.0.0.1", () => {
+      srv.close(() => resolve(true));
+    });
+  });
 }
-function generateEventId() {
-  return generateId("evt");
+function parseLsofPids(output) {
+  return output.trim().split("\n").map((line) => parseInt(line.trim(), 10)).filter((pid) => Number.isFinite(pid) && pid > 0);
 }
-function generateNotificationId() {
-  return generateId("ntf");
+function parseSsPid(output) {
+  const match = output.match(/pid=(\d+)/);
+  return match ? parseInt(match[1], 10) : null;
 }
-var init_utils = __esm({
-  "src/shared/utils.ts"() {
+function freePortWindows(port) {
+  const out = execSync(`netstat -ano | findstr ":${port}.*LISTENING"`, {
+    encoding: "utf-8",
+    stdio: ["pipe", "pipe", "ignore"]
+  });
+  const pid = out.trim().split(/\s+/).at(-1);
+  if (pid && /^\d+$/.test(pid)) {
+    execSync(`taskkill /PID ${pid} /F`, { stdio: "ignore" });
+    console.error(`[Tandem] Killed stale PID ${pid} holding port ${port}`);
+  }
+}
+function freePortUnix(port) {
+  let pids = [];
+  try {
+    const out = execSync(`lsof -ti TCP:${port} -sTCP:LISTEN`, {
+      encoding: "utf-8",
+      stdio: ["pipe", "pipe", "ignore"]
+    });
+    pids = parseLsofPids(out);
+  } catch {
+    try {
+      const out = execSync(`ss -tlnp sport = :${port}`, {
+        encoding: "utf-8",
+        stdio: ["pipe", "pipe", "ignore"]
+      });
+      const pid = parseSsPid(out);
+      if (pid) pids = [pid];
+    } catch {
+    }
+  }
+  for (const pid of pids) {
+    try {
+      process.kill(pid, "SIGKILL");
+      console.error(`[Tandem] Killed stale PID ${pid} holding port ${port}`);
+    } catch {
+    }
+  }
+}
+var paths, SESSION_DIR, LAST_SEEN_VERSION_FILE;
+var init_platform = __esm({
+  "src/server/platform.ts"() {
     "use strict";
+    paths = envPaths("tandem", { suffix: "" });
+    SESSION_DIR = path3.join(paths.data, "sessions");
+    LAST_SEEN_VERSION_FILE = path3.join(paths.data, "last-seen-version");
   }
 });
 
-// src/server/mcp/file-opener.ts
-var file_opener_exports = {};
-__export(file_opener_exports, {
-  SUPPORTED_EXTENSIONS: () => SUPPORTED_EXTENSIONS,
-  openFileByPath: () => openFileByPath,
-  openFileFromContent: () => openFileFromContent
-});
-import fs4 from "fs/promises";
-import fsSync from "fs";
-import path5 from "path";
-import { randomUUID } from "crypto";
-async function openFileByPath(filePath, options) {
-  let resolved = path5.resolve(filePath);
+// src/server/session/manager.ts
+import fs3 from "fs/promises";
+import path4 from "path";
+import * as Y7 from "yjs";
+async function atomicWrite2(sessionPath, content) {
+  const tmpPath = `${sessionPath}.tmp`;
+  await fs3.writeFile(tmpPath, content, "utf-8");
+  for (let attempt = 0; attempt < RENAME_MAX_RETRIES; attempt++) {
+    try {
+      await fs3.rename(tmpPath, sessionPath);
+      return;
+    } catch (err) {
+      const code = err.code;
+      if ((code === "EPERM" || code === "EACCES") && attempt < RENAME_MAX_RETRIES - 1) {
+        await new Promise((r) => setTimeout(r, RENAME_RETRY_BASE_MS * 2 ** attempt));
+        continue;
+      }
+      await fs3.unlink(tmpPath).catch(() => {
+      });
+      throw err;
+    }
+  }
+}
+function sessionKey(filePath) {
+  return encodeURIComponent(filePath.replace(/\\/g, "/"));
+}
+async function saveSession(filePath, format, doc) {
+  const key = sessionKey(filePath);
+  let sourceFileMtime = 0;
+  if (!filePath.startsWith("upload://")) {
+    try {
+      const stat = await fs3.stat(filePath);
+      sourceFileMtime = stat.mtimeMs;
+    } catch {
+    }
+  }
+  const state = Y7.encodeStateAsUpdate(doc);
+  const ydocState = Buffer.from(state).toString("base64");
+  const data = {
+    filePath,
+    format,
+    ydocState,
+    sourceFileMtime,
+    lastAccessed: Date.now()
+  };
+  if (!sessionDirReady) {
+    await fs3.mkdir(SESSION_DIR, { recursive: true });
+    sessionDirReady = true;
+  }
+  const sessionPath = path4.join(SESSION_DIR, `${key}.json`);
+  await atomicWrite2(sessionPath, JSON.stringify(data));
+}
+async function loadSession(filePath) {
+  const key = sessionKey(filePath);
+  const sessionPath = path4.join(SESSION_DIR, `${key}.json`);
   try {
-    resolved = fsSync.realpathSync(resolved);
+    const content = await fs3.readFile(sessionPath, "utf-8");
+    return JSON.parse(content);
   } catch (err) {
     const code = err.code;
-    if (code !== "ENOENT") {
-      console.error(
-        `[Tandem] realpathSync failed for ${filePath} (${code}), using path.resolve fallback`
-      );
+    if (code === "ENOENT") return null;
+    if (err instanceof SyntaxError) {
+      console.error(`[Tandem] Corrupted session file ${sessionPath}, removing:`, err.message);
+      await fs3.unlink(sessionPath).catch((unlinkErr) => {
+        console.error(`[Tandem] Failed to remove corrupted session ${sessionPath}:`, unlinkErr);
+      });
+      return null;
     }
-    resolved = path5.resolve(filePath);
+    console.error(`[Tandem] Failed to read session ${sessionPath}:`, err);
+    return null;
   }
-  if (process.platform === "win32" && (resolved.startsWith("\\\\") || resolved.startsWith("//"))) {
-    throw Object.assign(new Error("UNC paths are not supported for security reasons."), {
-      code: "INVALID_PATH"
-    });
+}
+function restoreYDoc(doc, session) {
+  const state = Buffer.from(session.ydocState, "base64");
+  Y7.applyUpdate(doc, new Uint8Array(state));
+}
+async function sourceFileChanged(session) {
+  if (session.filePath.startsWith("upload://")) return false;
+  try {
+    const stat = await fs3.stat(session.filePath);
+    return stat.mtimeMs !== session.sourceFileMtime;
+  } catch {
+    return true;
   }
-  const ext = path5.extname(resolved).toLowerCase();
-  if (!SUPPORTED_EXTENSIONS.has(ext)) {
-    throw Object.assign(
-      new Error(
-        `Unsupported file format: ${ext}. Supported: ${[...SUPPORTED_EXTENSIONS].join(", ")}`
-      ),
-      { code: "UNSUPPORTED_FORMAT" }
-    );
+}
+async function deleteSession(filePath) {
+  const key = sessionKey(filePath);
+  const sessionPath = path4.join(SESSION_DIR, `${key}.json`);
+  try {
+    await fs3.unlink(sessionPath);
+  } catch (err) {
+    const code = err.code;
+    if (code !== "ENOENT") {
+      console.error(`[Tandem] deleteSession: failed to delete ${sessionPath}:`, err);
+    }
   }
-  const stat = await fs4.stat(resolved);
-  if (stat.size > MAX_FILE_SIZE) {
-    throw Object.assign(new Error("File exceeds 50MB limit."), { code: "FILE_TOO_LARGE" });
+}
+async function saveCtrlSession(doc) {
+  if (!sessionDirReady) {
+    await fs3.mkdir(SESSION_DIR, { recursive: true });
+    sessionDirReady = true;
   }
-  const format = detectFormat(resolved);
-  const isDocx = format === "docx";
-  const readOnly = isDocx;
-  const id = docIdFromPath(resolved);
-  const openDocs2 = getOpenDocs();
-  const existing = openDocs2.get(id);
-  const forceReload = existing && options?.force === true;
-  if (existing && !forceReload) {
-    setActiveDocId(id);
-    broadcastOpenDocs();
-    const doc2 = getOrCreateDocument(id);
+  const chatMap = doc.getMap(Y_MAP_CHAT);
+  const entries = [];
+  chatMap.forEach((value, key) => {
+    const msg = value;
+    entries.push({ id: key, timestamp: msg.timestamp });
+  });
+  if (entries.length > 200) {
+    entries.sort((a, b) => a.timestamp - b.timestamp);
+    const toDelete = entries.slice(0, entries.length - 200);
+    doc.transact(() => {
+      for (const entry of toDelete) {
+        chatMap.delete(entry.id);
+      }
+    }, MCP_ORIGIN);
+  }
+  const state = Y7.encodeStateAsUpdate(doc);
+  const ydocState = Buffer.from(state).toString("base64");
+  const data = { ydocState, lastAccessed: Date.now() };
+  const sessionPath = path4.join(SESSION_DIR, `${CTRL_SESSION_KEY}.json`);
+  await atomicWrite2(sessionPath, JSON.stringify(data));
+}
+async function loadCtrlSession() {
+  const sessionPath = path4.join(SESSION_DIR, `${CTRL_SESSION_KEY}.json`);
+  try {
+    const content = await fs3.readFile(sessionPath, "utf-8");
+    const data = JSON.parse(content);
+    return data.ydocState ?? null;
+  } catch (err) {
+    const code = err.code;
+    if (code === "ENOENT") return null;
+    if (err instanceof SyntaxError) {
+      console.error(`[Tandem] Corrupted ctrl session ${sessionPath}, removing:`, err.message);
+      await fs3.unlink(sessionPath).catch((unlinkErr) => {
+        console.error(
+          `[Tandem] Failed to remove corrupted ctrl session ${sessionPath}:`,
+          unlinkErr
+        );
+      });
+      return null;
+    }
+    console.error(`[Tandem] Failed to read ctrl session:`, err);
+    return null;
+  }
+}
+function restoreCtrlDoc(doc, base64State) {
+  const state = Buffer.from(base64State, "base64");
+  Y7.applyUpdate(doc, new Uint8Array(state));
+}
+async function listSessionFilePaths() {
+  try {
+    await fs3.mkdir(SESSION_DIR, { recursive: true });
+    const files = await fs3.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 fs3.readFile(path4.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 });
+      } catch (err) {
+        console.error(`[Tandem] Skipping unreadable session file ${file}:`, err);
+      }
+    }
+    results.sort((a, b) => b.lastAccessed - a.lastAccessed);
+    return results;
+  } catch (err) {
+    console.error("[Tandem] Failed to read session directory:", err);
+    return [];
+  }
+}
+async function cleanupSessions() {
+  let cleaned = 0;
+  let files;
+  try {
+    files = await fs3.readdir(SESSION_DIR);
+  } catch (err) {
+    if (err.code === "ENOENT") return 0;
+    console.error("[Tandem] Failed to read session directory:", err);
+    return 0;
+  }
+  const now = Date.now();
+  for (const file of files) {
+    try {
+      const filePath = path4.join(SESSION_DIR, file);
+      const stat = await fs3.stat(filePath);
+      if (now - stat.mtimeMs > SESSION_MAX_AGE) {
+        await fs3.unlink(filePath);
+        cleaned++;
+      }
+    } catch (err) {
+      console.error(`[Tandem] cleanupSessions: failed to process ${file}:`, err);
+    }
+  }
+  return cleaned;
+}
+function isAutoSaveRunning() {
+  return autoSaveTimer !== null;
+}
+function startAutoSave(callback) {
+  stopAutoSave();
+  autoSaveCallback = callback;
+  autoSaveTimer = setInterval(async () => {
+    try {
+      await autoSaveCallback?.();
+    } catch (err) {
+      console.error("[Tandem] Auto-save failed:", err);
+    }
+  }, AUTO_SAVE_INTERVAL);
+}
+function stopAutoSave() {
+  if (autoSaveTimer) {
+    clearInterval(autoSaveTimer);
+    autoSaveTimer = null;
+  }
+  autoSaveCallback = null;
+}
+var AUTO_SAVE_INTERVAL, RENAME_MAX_RETRIES, RENAME_RETRY_BASE_MS, sessionDirReady, CTRL_SESSION_KEY, autoSaveTimer, autoSaveCallback;
+var init_manager = __esm({
+  "src/server/session/manager.ts"() {
+    "use strict";
+    init_constants();
+    init_queue();
+    init_platform();
+    AUTO_SAVE_INTERVAL = 60 * 1e3;
+    RENAME_MAX_RETRIES = 3;
+    RENAME_RETRY_BASE_MS = 50;
+    sessionDirReady = false;
+    CTRL_SESSION_KEY = CTRL_ROOM;
+    autoSaveTimer = null;
+    autoSaveCallback = null;
+  }
+});
+
+// src/server/mcp/file-opener.ts
+var file_opener_exports = {};
+__export(file_opener_exports, {
+  SUPPORTED_EXTENSIONS: () => SUPPORTED_EXTENSIONS,
+  openFileByPath: () => openFileByPath,
+  openFileFromContent: () => openFileFromContent
+});
+import { randomUUID } from "crypto";
+import fsSync from "fs";
+import fs4 from "fs/promises";
+import path5 from "path";
+async function openFileByPath(filePath, options) {
+  let resolved = path5.resolve(filePath);
+  try {
+    resolved = fsSync.realpathSync(resolved);
+  } catch (err) {
+    const code = err.code;
+    if (code !== "ENOENT") {
+      console.error(
+        `[Tandem] realpathSync failed for ${filePath} (${code}), using path.resolve fallback`
+      );
+    }
+    resolved = path5.resolve(filePath);
+  }
+  if (process.platform === "win32" && (resolved.startsWith("\\\\") || resolved.startsWith("//"))) {
+    throw Object.assign(new Error("UNC paths are not supported for security reasons."), {
+      code: "INVALID_PATH"
+    });
+  }
+  const ext = path5.extname(resolved).toLowerCase();
+  if (!SUPPORTED_EXTENSIONS.has(ext)) {
+    throw Object.assign(
+      new Error(
+        `Unsupported file format: ${ext}. Supported: ${[...SUPPORTED_EXTENSIONS].join(", ")}`
+      ),
+      { code: "UNSUPPORTED_FORMAT" }
+    );
+  }
+  const stat = await fs4.stat(resolved);
+  if (stat.size > MAX_FILE_SIZE) {
+    throw Object.assign(new Error("File exceeds 50MB limit."), { code: "FILE_TOO_LARGE" });
+  }
+  const format = detectFormat(resolved);
+  const isDocx = format === "docx";
+  const readOnly = isDocx;
+  const id = docIdFromPath(resolved);
+  const openDocs2 = getOpenDocs();
+  const existing = openDocs2.get(id);
+  const forceReload = existing && options?.force === true;
+  if (existing && !forceReload) {
+    setActiveDocId(id);
+    broadcastOpenDocs();
+    const doc2 = getOrCreateDocument(id);
     return {
       ...buildResult(doc2, {
         documentId: id,
@@ -3190,7 +3246,7 @@ async function reloadFromDisk(id, filePath, format) {
     }, MCP_ORIGIN);
     const annotationMap = doc.getMap(Y_MAP_ANNOTATIONS);
     const annotations = [];
-    annotationMap.forEach((val) => annotations.push(val));
+    annotationMap.forEach((val) => annotations.push(sanitizeAnnotation(val)));
     if (annotations.length > 0) {
       const refreshed = refreshAllRanges(annotations, doc, annotationMap);
       doc.transact(() => {
@@ -3264,19 +3320,20 @@ 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_annotations();
     init_document_model();
     init_document_service();
     reloadInProgress = /* @__PURE__ */ new Set();
@@ -3284,8 +3341,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;
 }
@@ -3445,616 +3502,204 @@ 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;
   }
 });
 
-// src/server/events/types.ts
-var init_types3 = __esm({
-  "src/server/events/types.ts"() {
-    "use strict";
-    init_utils();
-  }
-});
-
-// src/server/events/queue.ts
-function getTrackableId(event) {
-  switch (event.type) {
-    case "annotation:created":
-    case "annotation:accepted":
-    case "annotation:dismissed":
-      return event.payload.annotationId;
-    case "chat:message":
-      return event.payload.messageId;
-    default:
-      return void 0;
-  }
-}
-function trackPayloadId(event) {
-  const id = getTrackableId(event);
-  if (id) emittedPayloadIds.set(id, (emittedPayloadIds.get(id) ?? 0) + 1);
-}
-function untrackPayloadId(event) {
-  const id = getTrackableId(event);
-  if (!id) return;
-  const count = emittedPayloadIds.get(id) ?? 0;
-  if (count <= 1) emittedPayloadIds.delete(id);
-  else emittedPayloadIds.set(id, count - 1);
-}
-function pushEvent(event) {
-  buffer2.push(event);
-  trackPayloadId(event);
-  while (buffer2.length > CHANNEL_EVENT_BUFFER_SIZE) {
-    const evicted = buffer2.shift();
-    if (evicted) untrackPayloadId(evicted);
-  }
-  const now = Date.now();
-  while (buffer2.length > 0 && now - buffer2[0].timestamp > CHANNEL_EVENT_BUFFER_AGE_MS) {
-    const evicted = buffer2.shift();
-    if (evicted) untrackPayloadId(evicted);
-  }
-  for (const cb of subscribers2) {
+// src/server/mcp/convert.ts
+import fs5 from "fs/promises";
+import path7 from "path";
+async function findAvailablePath(basePath) {
+  const dir = path7.dirname(basePath);
+  const ext = path7.extname(basePath);
+  const name = path7.basename(basePath, ext);
+  const MAX_ATTEMPTS = 1e3;
+  let candidate = basePath;
+  let counter = 0;
+  while (counter <= MAX_ATTEMPTS) {
     try {
-      cb(event);
+      await fs5.access(candidate);
+      counter++;
+      candidate = path7.join(dir, `${name}-${counter}${ext}`);
     } catch (err) {
-      console.error("[EventQueue] Subscriber threw during event dispatch:", err);
-    }
+      const code = err.code;
+      if (code === "ENOENT") return candidate;
+      throw err;
+    }
   }
+  throw Object.assign(new Error("Could not find an available filename after 1000 attempts."), {
+    code: "CONFLICT"
+  });
 }
-function subscribe2(cb) {
-  subscribers2.add(cb);
-}
-function unsubscribe(cb) {
-  subscribers2.delete(cb);
-}
-function replaySince(lastEventId) {
-  const idx = buffer2.findIndex((e) => e.id === lastEventId);
-  if (idx === -1) return [...buffer2];
-  return buffer2.slice(idx + 1);
-}
-function attachObservers(docName, doc) {
-  detachObservers(docName);
-  const cleanups = [];
-  const annotationsMap = doc.getMap(Y_MAP_ANNOTATIONS);
-  const annotationsObs = (event, txn) => {
-    if (txn.origin === MCP_ORIGIN) return;
-    for (const [key, change] of event.changes.keys) {
-      const ann = annotationsMap.get(key);
-      if (!ann) continue;
-      if (change.action === "add" && ann.author === "user") {
-        pushEvent({
-          id: generateEventId(),
-          type: "annotation:created",
-          timestamp: Date.now(),
-          documentId: docName,
-          payload: {
-            annotationId: ann.id,
-            annotationType: ann.type,
-            content: ann.content,
-            textSnippet: ann.textSnapshot ?? ""
-          }
-        });
-      } else if (change.action === "update" && ann.author === "claude") {
-        if (ann.status === "accepted") {
-          pushEvent({
-            id: generateEventId(),
-            type: "annotation:accepted",
-            timestamp: Date.now(),
-            documentId: docName,
-            payload: {
-              annotationId: ann.id,
-              textSnippet: ann.textSnapshot ?? ""
-            }
-          });
-        } else if (ann.status === "dismissed") {
-          pushEvent({
-            id: generateEventId(),
-            type: "annotation:dismissed",
-            timestamp: Date.now(),
-            documentId: docName,
-            payload: {
-              annotationId: ann.id,
-              textSnippet: ann.textSnapshot ?? ""
-            }
-          });
-        }
+async function convertToMarkdown(documentId, outputPath) {
+  const docState = getCurrentDoc(documentId);
+  if (!docState) {
+    throw Object.assign(new Error("Document not found."), { code: "FILE_NOT_FOUND" });
+  }
+  if (docState.format !== "docx") {
+    throw Object.assign(new Error("Only .docx documents can be converted to Markdown."), {
+      code: "UNSUPPORTED_FORMAT"
+    });
+  }
+  if (docState.source === "upload") {
+    throw Object.assign(
+      new Error(
+        "Uploaded .docx files cannot be converted \u2014 no disk location to write the .md file."
+      ),
+      { code: "INVALID_PATH" }
+    );
+  }
+  const doc = getOrCreateDocument(docState.id);
+  const markdown = extractMarkdown(doc);
+  if (!markdown.trim()) {
+    throw Object.assign(
+      new Error("Conversion produced empty output \u2014 the .docx may not contain extractable text."),
+      { code: "EMPTY_CONVERSION" }
+    );
+  }
+  const sourceDir = path7.dirname(docState.filePath);
+  let resolvedOutput;
+  if (outputPath) {
+    resolvedOutput = path7.resolve(outputPath);
+    if (resolvedOutput.startsWith("\\\\") || resolvedOutput.startsWith("//")) {
+      throw Object.assign(new Error("UNC paths are not supported for security reasons."), {
+        code: "INVALID_PATH"
+      });
+    }
+    try {
+      const stat = await fs5.stat(resolvedOutput);
+      if (stat.isDirectory()) {
+        const baseName = path7.basename(docState.filePath, path7.extname(docState.filePath));
+        resolvedOutput = path7.join(resolvedOutput, `${baseName}.md`);
       }
+    } catch (err) {
+      const code = err.code;
+      if (code !== "ENOENT") throw err;
     }
+  } else {
+    const baseName = path7.basename(docState.filePath, path7.extname(docState.filePath));
+    resolvedOutput = path7.join(sourceDir, `${baseName}.md`);
+  }
+  resolvedOutput = await findAvailablePath(resolvedOutput);
+  await atomicWrite(resolvedOutput, markdown);
+  try {
+    const openResult = await openFileByPath(resolvedOutput);
+    return {
+      outputPath: resolvedOutput,
+      documentId: openResult.documentId,
+      fileName: openResult.fileName
+    };
+  } catch (err) {
+    throw Object.assign(
+      new Error(
+        `Markdown written to ${resolvedOutput} but failed to open: ${err.message}`
+      ),
+      { code: "OPEN_FAILED" }
+    );
+  }
+}
+var init_convert = __esm({
+  "src/server/mcp/convert.ts"() {
+    "use strict";
+    init_file_io();
+    init_provider();
+    init_document_model();
+    init_document_service();
+    init_file_opener();
+  }
+});
+
+// src/server/mcp/response.ts
+function mcpSuccess(data) {
+  return {
+    content: [{ type: "text", text: JSON.stringify({ error: false, data }) }]
   };
-  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;
+}
+function mcpError(code, message, details) {
+  return {
+    content: [
+      {
+        type: "text",
+        text: JSON.stringify({ error: true, code, message, ...details && { details } })
       }
-      if (!selection || selection.from === selection.to) return;
-      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 ?? ""
-          }
-        });
-      }, SELECTION_DWELL_DEFAULT_MS);
-    }
+    ]
   };
-  userAwareness.observe(awarenessObs);
-  cleanups.push(() => {
-    userAwareness.unobserve(awarenessObs);
-    if (selectionDwellTimer) clearTimeout(selectionDwellTimer);
-  });
-  docObservers.set(docName, cleanups);
-  console.error(`[EventQueue] Attached observers for document: ${docName}`);
 }
-function detachObservers(docName) {
-  const cleanups = docObservers.get(docName);
-  if (cleanups) {
-    for (const cleanup of cleanups) cleanup();
-    docObservers.delete(docName);
-    console.error(`[EventQueue] Detached observers for document: ${docName}`);
-  }
+function noDocumentError() {
+  return mcpError("NO_DOCUMENT", "No document is open. Call tandem_open first.");
 }
-function reattachObservers(docName, newDoc) {
-  attachObservers(docName, newDoc);
+function getErrorMessage(err) {
+  return err instanceof Error ? err.message : String(err);
 }
-function attachCtrlObservers() {
-  for (const cleanup of ctrlCleanups) cleanup();
-  ctrlCleanups = [];
-  const ctrlDoc = getOrCreateDocument(CTRL_ROOM);
-  const chatMap = ctrlDoc.getMap(Y_MAP_CHAT);
-  const chatObs = (event, txn) => {
-    if (txn.origin === MCP_ORIGIN) return;
-    for (const [key, change] of event.changes.keys) {
-      if (change.action !== "add") continue;
-      const msg = chatMap.get(key);
-      if (!msg || msg.author !== "user") continue;
-      pushEvent({
-        id: generateEventId(),
-        type: "chat:message",
-        timestamp: Date.now(),
-        documentId: msg.documentId,
-        payload: {
-          messageId: msg.id,
-          text: msg.text,
-          replyTo: msg.replyTo ?? null,
-          anchor: msg.anchor ?? null
-        }
-      });
+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)}`);
     }
   };
-  chatMap.observe(chatObs);
-  ctrlCleanups.push(() => chatMap.unobserve(chatObs));
-  const metaMap = ctrlDoc.getMap(Y_MAP_DOCUMENT_META);
-  let lastActiveDocId = null;
-  let lastOpenDocIds = /* @__PURE__ */ new Set();
-  const metaObs = (event, txn) => {
-    if (txn.origin === MCP_ORIGIN) return;
-    if (event.keysChanged.has("activeDocumentId")) {
-      const activeId = metaMap.get("activeDocumentId");
-      if (activeId && activeId !== lastActiveDocId) {
-        const openDoc = getOpenDocs().get(activeId);
-        pushEvent({
-          id: generateEventId(),
-          type: "document:switched",
-          timestamp: Date.now(),
-          documentId: activeId,
-          payload: {
-            fileName: openDoc?.filePath?.split(/[/\\]/).pop() ?? activeId
-          }
-        });
-        lastActiveDocId = activeId;
-      }
-    }
-    if (event.keysChanged.has("openDocuments")) {
-      const docList = metaMap.get("openDocuments") ?? [];
-      const currentIds = new Set(docList.map((d) => d.id));
-      for (const doc of docList) {
-        if (!lastOpenDocIds.has(doc.id)) {
-          const openDoc = getOpenDocs().get(doc.id);
-          pushEvent({
-            id: generateEventId(),
-            type: "document:opened",
-            timestamp: Date.now(),
-            documentId: doc.id,
-            payload: {
-              fileName: doc.fileName ?? openDoc?.filePath?.split(/[/\\]/).pop() ?? doc.id,
-              format: openDoc?.format ?? "unknown"
-            }
-          });
-        }
-      }
-      for (const oldId of lastOpenDocIds) {
-        if (!currentIds.has(oldId)) {
-          pushEvent({
-            id: generateEventId(),
-            type: "document:closed",
-            timestamp: Date.now(),
-            documentId: oldId,
-            payload: {
-              fileName: oldId
-            }
-          });
-        }
-      }
-      lastOpenDocIds = currentIds;
-    }
-  };
-  metaMap.observe(metaObs);
-  ctrlCleanups.push(() => metaMap.unobserve(metaObs));
-  console.error("[EventQueue] Attached CTRL_ROOM observers (chat + documentMeta)");
 }
-function reattachCtrlObservers() {
-  attachCtrlObservers();
+function escapeRegex(str) {
+  return str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
-var MCP_ORIGIN, docObservers, emittedPayloadIds, buffer2, subscribers2, ctrlCleanups;
-var init_queue = __esm({
-  "src/server/events/queue.ts"() {
+var init_response = __esm({
+  "src/server/mcp/response.ts"() {
     "use strict";
-    init_constants();
-    init_document_service();
-    init_provider();
-    init_types3();
-    MCP_ORIGIN = "mcp";
-    docObservers = /* @__PURE__ */ new Map();
-    emittedPayloadIds = /* @__PURE__ */ new Map();
-    buffer2 = [];
-    subscribers2 = /* @__PURE__ */ new Set();
-    ctrlCleanups = [];
   }
 });
 
-// src/server/mcp/launcher.ts
-var launcher_exports = {};
-__export(launcher_exports, {
-  killClaude: () => killClaude,
-  launchClaude: () => launchClaude
-});
-import { spawn } from "child_process";
-function launchClaude() {
-  if (claudeProcess && !claudeProcess.killed) {
-    return { status: "already_running", pid: claudeProcess.pid };
-  }
-  const claudeCmd = process.env.TANDEM_CLAUDE_CMD || "claude";
-  const tandemUrl = `http://localhost:${process.env.TANDEM_MCP_PORT || DEFAULT_MCP_PORT}`;
-  const args = [
-    "--dangerously-load-development-channels",
-    "server:tandem-channel",
-    "--append-system-prompt",
-    TANDEM_SYSTEM_PROMPT,
-    "--name",
-    "tandem-reviewer"
-  ];
-  claudeProcess = spawn(claudeCmd, args, {
-    env: { ...process.env, TANDEM_URL: tandemUrl },
-    stdio: "pipe",
-    detached: true
-  });
-  if (claudeProcess.stdin?.writable) {
-    claudeProcess.stdin.write(
-      "A document has been opened in Tandem for review. Call tandem_checkInbox to see what needs attention, then begin reviewing.\n",
-      (err) => {
-        if (err) console.error("[Launcher] Failed to send initial prompt:", err.message);
-      }
-    );
-  } else {
-    console.error("[Launcher] Claude process has no writable stdin \u2014 initial prompt not delivered");
-  }
-  const pid = claudeProcess.pid;
-  claudeProcess.on("error", (err) => {
-    if (err.code === "ENOENT") {
-      console.error(
-        "[Launcher] Claude Code not found. Install with: npm i -g @anthropic-ai/claude-code"
-      );
-    } else {
-      console.error("[Launcher] spawn error:", err);
-    }
-    claudeProcess = null;
-  });
-  claudeProcess.on("exit", (code) => {
-    console.error(`[Launcher] Claude Code exited with code ${code}`);
-    claudeProcess = null;
-  });
-  claudeProcess.stderr?.on("data", (chunk) => {
-    console.error(`[Claude] ${chunk.toString().trimEnd()}`);
-  });
-  claudeProcess.unref();
-  console.error(`[Launcher] Claude Code launched (pid: ${pid})`);
-  return { status: "launched", pid };
-}
-function killClaude() {
-  if (claudeProcess && !claudeProcess.killed) {
-    console.error(`[Launcher] Killing Claude Code (pid: ${claudeProcess.pid})`);
-    try {
-      claudeProcess.kill("SIGTERM");
-    } catch (err) {
-      const code = err.code;
-      if (code !== "ESRCH") {
-        console.error("[Launcher] Failed to kill Claude process:", err);
-      }
+// src/server/mcp/document.ts
+import * as Y8 from "yjs";
+import { z as z2 } from "zod";
+function getOutline(fragment) {
+  const outline = [];
+  for (let i = 0; i < fragment.length; i++) {
+    const node = fragment.get(i);
+    if (node instanceof Y8.XmlElement && node.nodeName === "heading") {
+      const level = Number(node.getAttribute("level") ?? 1);
+      outline.push({ level, text: getElementText(node), index: i });
     }
-    claudeProcess = null;
   }
+  return outline;
 }
-var claudeProcess, TANDEM_SYSTEM_PROMPT;
-var init_launcher = __esm({
-  "src/server/mcp/launcher.ts"() {
-    "use strict";
-    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}`);
+function getSection(fragment, sectionName) {
+  const lines = [];
+  let inSection = false;
+  let sectionLevel = 0;
+  for (let i = 0; i < fragment.length; i++) {
+    const node = fragment.get(i);
+    if (!(node instanceof Y8.XmlElement)) continue;
+    const text = getElementText(node);
+    if (node.nodeName === "heading") {
+      const level = Number(node.getAttribute("level") ?? 1);
+      if (inSection && level <= sectionLevel) break;
+      if (text.trim().toLowerCase() === sectionName.trim().toLowerCase()) {
+        inSection = true;
+        sectionLevel = level;
+        lines.push(headingPrefix(level) + text);
+        continue;
+      }
     }
-  });
-}
-
-// 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 } })
+    if (inSection) {
+      if (node.nodeName === "heading") {
+        const level = Number(node.getAttribute("level") ?? 1);
+        lines.push(headingPrefix(level) + text);
+      } else {
+        lines.push(text);
       }
-    ]
-  };
-}
-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_notifications();
-init_utils();
-init_offsets();
-init_file_io();
-init_file_watcher();
-
-// src/server/mcp/convert.ts
-init_provider();
-init_document_model();
-init_file_io();
-init_file_opener();
-init_document_service();
-import fs5 from "fs/promises";
-import path7 from "path";
-async function findAvailablePath(basePath) {
-  const dir = path7.dirname(basePath);
-  const ext = path7.extname(basePath);
-  const name = path7.basename(basePath, ext);
-  const MAX_ATTEMPTS = 1e3;
-  let candidate = basePath;
-  let counter = 0;
-  while (counter <= MAX_ATTEMPTS) {
-    try {
-      await fs5.access(candidate);
-      counter++;
-      candidate = path7.join(dir, `${name}-${counter}${ext}`);
-    } catch (err) {
-      const code = err.code;
-      if (code === "ENOENT") return candidate;
-      throw err;
-    }
-  }
-  throw Object.assign(new Error("Could not find an available filename after 1000 attempts."), {
-    code: "CONFLICT"
-  });
-}
-async function convertToMarkdown(documentId, outputPath) {
-  const docState = getCurrentDoc(documentId);
-  if (!docState) {
-    throw Object.assign(new Error("Document not found."), { code: "FILE_NOT_FOUND" });
-  }
-  if (docState.format !== "docx") {
-    throw Object.assign(new Error("Only .docx documents can be converted to Markdown."), {
-      code: "UNSUPPORTED_FORMAT"
-    });
-  }
-  if (docState.source === "upload") {
-    throw Object.assign(
-      new Error(
-        "Uploaded .docx files cannot be converted \u2014 no disk location to write the .md file."
-      ),
-      { code: "INVALID_PATH" }
-    );
-  }
-  const doc = getOrCreateDocument(docState.id);
-  const markdown = extractMarkdown(doc);
-  if (!markdown.trim()) {
-    throw Object.assign(
-      new Error("Conversion produced empty output \u2014 the .docx may not contain extractable text."),
-      { code: "EMPTY_CONVERSION" }
-    );
-  }
-  const sourceDir = path7.dirname(docState.filePath);
-  let resolvedOutput;
-  if (outputPath) {
-    resolvedOutput = path7.resolve(outputPath);
-    if (resolvedOutput.startsWith("\\\\") || resolvedOutput.startsWith("//")) {
-      throw Object.assign(new Error("UNC paths are not supported for security reasons."), {
-        code: "INVALID_PATH"
-      });
-    }
-    try {
-      const stat = await fs5.stat(resolvedOutput);
-      if (stat.isDirectory()) {
-        const baseName = path7.basename(docState.filePath, path7.extname(docState.filePath));
-        resolvedOutput = path7.join(resolvedOutput, `${baseName}.md`);
-      }
-    } catch (err) {
-      const code = err.code;
-      if (code !== "ENOENT") throw err;
-    }
-  } else {
-    const baseName = path7.basename(docState.filePath, path7.extname(docState.filePath));
-    resolvedOutput = path7.join(sourceDir, `${baseName}.md`);
-  }
-  resolvedOutput = await findAvailablePath(resolvedOutput);
-  await atomicWrite2(resolvedOutput, markdown);
-  try {
-    const openResult = await openFileByPath(resolvedOutput);
-    return {
-      outputPath: resolvedOutput,
-      documentId: openResult.documentId,
-      fileName: openResult.fileName
-    };
-  } catch (err) {
-    throw Object.assign(
-      new Error(
-        `Markdown written to ${resolvedOutput} but failed to open: ${err.message}`
-      ),
-      { code: "OPEN_FAILED" }
-    );
-  }
-}
-
-// 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_positions2();
-init_document_service();
-init_file_opener();
-function getOutline(fragment) {
-  const outline = [];
-  for (let i = 0; i < fragment.length; i++) {
-    const node = fragment.get(i);
-    if (node instanceof Y8.XmlElement && node.nodeName === "heading") {
-      const level = Number(node.getAttribute("level") ?? 1);
-      outline.push({ level, text: getElementText(node), index: i });
-    }
-  }
-  return outline;
-}
-function getSection(fragment, sectionName) {
-  const lines = [];
-  let inSection = false;
-  let sectionLevel = 0;
-  for (let i = 0; i < fragment.length; i++) {
-    const node = fragment.get(i);
-    if (!(node instanceof Y8.XmlElement)) continue;
-    const text = getElementText(node);
-    if (node.nodeName === "heading") {
-      const level = Number(node.getAttribute("level") ?? 1);
-      if (inSection && level <= sectionLevel) break;
-      if (text.trim().toLowerCase() === sectionName.trim().toLowerCase()) {
-        inSection = true;
-        sectionLevel = level;
-        lines.push(headingPrefix(level) + text);
-        continue;
-      }
-    }
-    if (inSection) {
-      if (node.nodeName === "heading") {
-        const level = Number(node.getAttribute("level") ?? 1);
-        lines.push(headingPrefix(level) + text);
-      } else {
-        lines.push(text);
-      }
-    }
-  }
-  if (!inSection) return { found: false };
-  return { found: true, text: lines.join("\n") };
+  }
+  if (!inSection) return { found: false };
+  return { found: true, text: lines.join("\n") };
 }
 function registerDocumentTools(server) {
   const openDocs2 = getOpenDocs();
@@ -4278,7 +3923,7 @@ function registerDocumentTools(server) {
         }
         const output = adapter.save(r.doc);
         suppressNextChange(r.filePath);
-        await atomicWrite2(r.filePath, output);
+        await atomicWrite(r.filePath, output);
         await saveSession(r.filePath, format, r.doc);
         const meta = r.doc.getMap(Y_MAP_DOCUMENT_META);
         r.doc.transact(() => meta.set(Y_MAP_SAVED_AT_VERSION, Date.now()), MCP_ORIGIN);
@@ -4407,14 +4052,34 @@ function registerDocumentTools(server) {
     })
   );
 }
+var init_document = __esm({
+  "src/server/mcp/document.ts"() {
+    "use strict";
+    init_constants();
+    init_offsets();
+    init_types2();
+    init_utils();
+    init_queue();
+    init_file_io();
+    init_file_watcher();
+    init_notifications();
+    init_positions2();
+    init_manager();
+    init_provider();
+    init_convert();
+    init_document_model();
+    init_document_service();
+    init_file_opener();
+    init_response();
+    init_positions2();
+    init_document_model();
+    init_document_service();
+    init_file_opener();
+  }
+});
 
 // src/server/mcp/annotations.ts
-init_docx();
-init_types2();
-init_positions2();
-init_notifications();
-init_utils();
-init_positions2();
+import { z as z3 } from "zod";
 function getDocAndAnnotations(documentId) {
   const doc = getCurrentDoc(documentId);
   if (!doc) return null;
@@ -4458,7 +4123,6 @@ function notifyRangeFailure(result, toolName, documentId) {
     timestamp: Date.now()
   });
 }
-var SNAPSHOT_CAP = 200;
 function captureSnapshot(ydoc, from, to) {
   const text = extractText(ydoc).slice(from, to);
   return text.length > SNAPSHOT_CAP ? text.slice(0, SNAPSHOT_CAP - 3) + "..." : text;
@@ -4478,12 +4142,14 @@ function createAnnotation(map, ydoc, type, anchored, content, extras) {
   };
   ydoc.transact(() => map.set(id, annotation), MCP_ORIGIN);
   const snippet = annotation.textSnapshot ? `: "${annotation.textSnapshot.slice(0, 60)}${annotation.textSnapshot.length > 60 ? "\u2026" : ""}"` : "";
+  const label = annotation.suggestedText !== void 0 ? "Replacement" : annotation.directedAt === "claude" ? "Question" : type[0].toUpperCase() + type.slice(1);
+  const dedupSuffix = annotation.suggestedText !== void 0 ? "replacement" : annotation.directedAt ?? type;
   pushNotification({
     id: generateNotificationId(),
     type: "review-pending",
     severity: "info",
-    message: `New ${type[0].toUpperCase() + type.slice(1)}${snippet}`,
-    dedupKey: `review-pending:${type}`,
+    message: `New ${label}${snippet}`,
+    dedupKey: `review-pending:${dedupSuffix}`,
     timestamp: Date.now()
   });
   return id;
@@ -4493,7 +4159,7 @@ function collectAnnotations(map) {
   map.forEach((value, key) => {
     const ann = value;
     if (ann && typeof ann === "object" && typeof ann.id === "string" && typeof ann.type === "string" && typeof ann.status === "string" && ann.range && typeof ann.range.from === "number" && typeof ann.range.to === "number") {
-      result.push(ann);
+      result.push(sanitizeAnnotation(ann));
     } else {
       console.warn(`[Tandem] Skipping malformed annotation entry: ${key}`);
     }
@@ -4510,16 +4176,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);
@@ -4532,7 +4195,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 });
@@ -4541,22 +4203,29 @@ function registerAnnotationTools(server) {
   );
   server.tool(
     "tandem_comment",
-    "Add a comment to a text range",
+    "Add a comment to a text range. Optionally include suggestedText for a replacement proposal, or directedAt: 'claude' to ask Claude.",
     {
       from: z3.number().describe("Start position"),
       to: z3.number().describe("End position"),
       text: z3.string().describe("Comment text"),
+      suggestedText: z3.string().optional().describe("Optional replacement text \u2014 turns this into a tracked-change suggestion"),
+      directedAt: z3.enum(["claude"]).optional().describe("Set to 'claude' to direct this comment to Claude for response"),
       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,
+        suggestedText,
+        directedAt,
+        documentId,
+        textSnapshot
+      }) => {
         const da = getDocAndAnnotations(documentId);
         if (!da) return noDocumentError();
         const from = toFlatOffset(rawFrom);
@@ -4568,8 +4237,9 @@ 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
+          textSnapshot: snap,
+          ...suggestedText !== void 0 ? { suggestedText } : {},
+          ...directedAt !== void 0 ? { directedAt } : {}
         });
         return mcpSuccess({ annotationId: id });
       }
@@ -4577,23 +4247,20 @@ function registerAnnotationTools(server) {
   );
   server.tool(
     "tandem_suggest",
-    "Propose a text replacement (tracked change style)",
+    "Propose a text replacement (tracked change style). Legacy shim \u2014 prefer tandem_comment with suggestedText.",
     {
       from: z3.number().describe("Start position"),
       to: z3.number().describe("End position"),
       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);
@@ -4604,14 +4271,10 @@ function registerAnnotationTools(server) {
           return rangeFailureToError(result);
         }
         const snap = captureSnapshot(da.ydoc, result.range.from, result.range.to);
-        const id = createAnnotation(
-          da.map,
-          da.ydoc,
-          "suggestion",
-          result,
-          JSON.stringify({ newText, reason: reason || "" }),
-          { ...priority ? { priority } : {}, textSnapshot: snap }
-        );
+        const id = createAnnotation(da.map, da.ydoc, "comment", result, reason || "", {
+          textSnapshot: snap,
+          suggestedText: newText
+        });
         return mcpSuccess({ annotationId: id });
       }
     )
@@ -4624,16 +4287,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);
@@ -4645,7 +4305,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 });
@@ -4682,8 +4341,9 @@ function registerAnnotationTools(server) {
     withErrorBoundary("tandem_resolveAnnotation", async ({ id, action, documentId }) => {
       const da = getDocAndAnnotations(documentId);
       if (!da) return noDocumentError();
-      const ann = da.map.get(id);
-      if (!ann) return mcpError("INVALID_RANGE", `Annotation ${id} not found`);
+      const raw = da.map.get(id);
+      if (!raw) return mcpError("INVALID_RANGE", `Annotation ${id} not found`);
+      const ann = sanitizeAnnotation(raw);
       const updated = {
         ...ann,
         status: action === "accept" ? "accepted" : "dismissed"
@@ -4709,12 +4369,12 @@ function registerAnnotationTools(server) {
   );
   server.tool(
     "tandem_editAnnotation",
-    "Edit the content of an existing annotation. For suggestions, use newText/reason params; for other types, use content.",
+    "Edit the content of an existing annotation. Use newText to update replacement text, reason/content for the comment body.",
     {
       id: z3.string().describe("Annotation ID"),
-      content: z3.string().optional().describe("New text for non-suggestion annotations"),
-      newText: z3.string().optional().describe("For suggestions: new replacement text"),
-      reason: z3.string().optional().describe("For suggestions: new reason"),
+      content: z3.string().optional().describe("New comment text"),
+      newText: z3.string().optional().describe("New replacement text (sets suggestedText)"),
+      reason: z3.string().optional().describe("Alias for content (legacy compat)"),
       documentId: z3.string().optional().describe("Target document ID (defaults to active document)")
     },
     withErrorBoundary(
@@ -4722,99 +4382,555 @@ function registerAnnotationTools(server) {
       async ({ id, content, newText, reason, documentId }) => {
         const da = getDocAndAnnotations(documentId);
         if (!da) return noDocumentError();
-        const ann = da.map.get(id);
-        if (!ann) return mcpError("INVALID_RANGE", `Annotation ${id} not found`);
+        const raw = da.map.get(id);
+        if (!raw) return mcpError("INVALID_RANGE", `Annotation ${id} not found`);
+        const ann = sanitizeAnnotation(raw);
         if (ann.status !== "pending") {
           return mcpError("INVALID_RANGE", `Cannot edit a ${ann.status} annotation`);
         }
-        let updatedContent;
-        if (ann.type === "suggestion") {
-          if (content !== void 0 && newText === void 0 && reason === void 0) {
-            updatedContent = content;
-          } else if (newText !== void 0 || reason !== void 0) {
-            let existing;
-            try {
-              existing = JSON.parse(ann.content);
-            } catch {
-              console.error(
-                `[tandem_editAnnotation] Malformed existing content for suggestion ${id}`
-              );
-              return mcpError(
-                "INVALID_RANGE",
-                `Suggestion ${id} has malformed content \u2014 cannot merge fields. Use 'content' to replace entirely.`
-              );
-            }
-            updatedContent = JSON.stringify({
-              newText: newText !== void 0 ? newText : existing.newText,
-              reason: reason !== void 0 ? reason : existing.reason
-            });
-          } else {
-            return mcpError(
-              "INVALID_RANGE",
-              "No editable fields provided. Use newText/reason for suggestions, or content."
-            );
-          }
-        } else {
-          if (content === void 0) {
-            return mcpError(
-              "INVALID_RANGE",
-              "No editable fields provided. Use content for non-suggestion annotations."
-            );
-          }
-          updatedContent = content;
+        if (content === void 0 && newText === void 0 && reason === void 0) {
+          return mcpError(
+            "INVALID_RANGE",
+            "No editable fields provided. Use content, newText, or reason."
+          );
+        }
+        if (newText !== void 0 && ann.type !== "comment") {
+          return mcpError(
+            "INVALID_RANGE",
+            `Cannot set replacement text on a ${ann.type} annotation. Only comments support suggestedText.`
+          );
         }
-        const updated = { ...ann, content: updatedContent, editedAt: Date.now() };
+        const updated = {
+          ...ann,
+          ...content !== void 0 ? { content } : {},
+          ...reason !== void 0 && content === void 0 ? { content: reason } : {},
+          ...newText !== void 0 ? { suggestedText: newText } : {},
+          editedAt: Date.now()
+        };
         da.ydoc.transact(() => da.map.set(id, updated), MCP_ORIGIN);
-        return mcpSuccess({ id, content: updatedContent, editedAt: updated.editedAt });
+        return mcpSuccess({
+          id,
+          content: updated.content,
+          suggestedText: updated.suggestedText,
+          editedAt: updated.editedAt
+        });
+      }
+    )
+  );
+  server.tool(
+    "tandem_exportAnnotations",
+    "Export all annotations as a formatted summary. Useful for review reports, especially on read-only .docx files.",
+    {
+      format: ExportFormatSchema.optional().describe("Output format (default: markdown)"),
+      documentId: z3.string().optional().describe("Target document ID (defaults to active document)")
+    },
+    withErrorBoundary("tandem_exportAnnotations", async ({ format, documentId }) => {
+      const da = getDocAndAnnotations(documentId);
+      if (!da) return noDocumentError();
+      const annotations = refreshAllRanges(collectAnnotations(da.map), da.ydoc, da.map);
+      const { ydoc } = da;
+      if (format === "json") {
+        const fullText = extractText(ydoc);
+        const enriched = annotations.map((ann) => ({
+          ...ann,
+          textSnippet: fullText.slice(
+            Math.max(0, ann.range.from),
+            Math.min(fullText.length, ann.range.to)
+          )
+        }));
+        return mcpSuccess({ annotations: enriched, count: enriched.length });
+      }
+      const markdown = exportAnnotations(ydoc, annotations);
+      return mcpSuccess({ markdown, count: annotations.length });
+    })
+  );
+}
+var SNAPSHOT_CAP;
+var init_annotations = __esm({
+  "src/server/mcp/annotations.ts"() {
+    "use strict";
+    init_constants();
+    init_sanitize();
+    init_types2();
+    init_utils();
+    init_queue();
+    init_docx();
+    init_notifications();
+    init_positions2();
+    init_provider();
+    init_document();
+    init_response();
+    init_sanitize();
+    init_positions2();
+    SNAPSHOT_CAP = 200;
+  }
+});
+
+// src/server/events/types.ts
+var init_types3 = __esm({
+  "src/server/events/types.ts"() {
+    "use strict";
+    init_utils();
+  }
+});
+
+// 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":
+    case "annotation:accepted":
+    case "annotation:dismissed":
+      return event.payload.annotationId;
+    case "chat:message":
+      return event.payload.messageId;
+    default:
+      return void 0;
+  }
+}
+function trackPayloadId(event) {
+  const id = getTrackableId(event);
+  if (id) emittedPayloadIds.set(id, (emittedPayloadIds.get(id) ?? 0) + 1);
+}
+function untrackPayloadId(event) {
+  const id = getTrackableId(event);
+  if (!id) return;
+  const count = emittedPayloadIds.get(id) ?? 0;
+  if (count <= 1) emittedPayloadIds.delete(id);
+  else emittedPayloadIds.set(id, count - 1);
+}
+function pushEvent(event) {
+  buffer2.push(event);
+  trackPayloadId(event);
+  while (buffer2.length > CHANNEL_EVENT_BUFFER_SIZE) {
+    const evicted = buffer2.shift();
+    if (evicted) untrackPayloadId(evicted);
+  }
+  const now = Date.now();
+  while (buffer2.length > 0 && now - buffer2[0].timestamp > CHANNEL_EVENT_BUFFER_AGE_MS) {
+    const evicted = buffer2.shift();
+    if (evicted) untrackPayloadId(evicted);
+  }
+  for (const cb of subscribers2) {
+    try {
+      cb(event);
+    } catch (err) {
+      console.error("[EventQueue] Subscriber threw during event dispatch:", err);
+    }
+  }
+}
+function subscribe2(cb) {
+  subscribers2.add(cb);
+}
+function unsubscribe(cb) {
+  subscribers2.delete(cb);
+}
+function replaySince(lastEventId) {
+  const idx = buffer2.findIndex((e) => e.id === lastEventId);
+  if (idx === -1) return [...buffer2];
+  return buffer2.slice(idx + 1);
+}
+function attachObservers(docName, doc) {
+  detachObservers(docName);
+  const cleanups = [];
+  const annotationsMap = doc.getMap(Y_MAP_ANNOTATIONS);
+  const annotationsObs = (event, txn) => {
+    if (txn.origin === MCP_ORIGIN) return;
+    for (const [key, change] of event.changes.keys) {
+      const raw = annotationsMap.get(key);
+      if (!raw) continue;
+      let ann;
+      try {
+        ann = sanitizeAnnotation(raw);
+      } catch (err) {
+        console.warn(`[EventQueue] sanitizeAnnotation failed for key=${key}:`, err);
+        continue;
+      }
+      if (change.action === "add" && ann.author === "user") {
+        pushEvent({
+          id: generateEventId(),
+          type: "annotation:created",
+          timestamp: Date.now(),
+          documentId: docName,
+          payload: {
+            annotationId: ann.id,
+            annotationType: ann.type,
+            content: ann.content,
+            textSnippet: ann.textSnapshot ?? "",
+            ...ann.suggestedText !== void 0 ? { hasSuggestedText: true } : {},
+            ...ann.directedAt ? { directedAt: ann.directedAt } : {}
+          }
+        });
+      } else if (change.action === "update" && ann.author === "claude") {
+        if (ann.status === "accepted") {
+          pushEvent({
+            id: generateEventId(),
+            type: "annotation:accepted",
+            timestamp: Date.now(),
+            documentId: docName,
+            payload: {
+              annotationId: ann.id,
+              textSnippet: ann.textSnapshot ?? ""
+            }
+          });
+        } else if (ann.status === "dismissed") {
+          pushEvent({
+            id: generateEventId(),
+            type: "annotation:dismissed",
+            timestamp: Date.now(),
+            documentId: docName,
+            payload: {
+              annotationId: ann.id,
+              textSnippet: ann.textSnapshot ?? ""
+            }
+          });
+        }
+      }
+    }
+  };
+  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;
+      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);
+    if (selectionDwellTimer) clearTimeout(selectionDwellTimer);
+  });
+  docObservers.set(docName, cleanups);
+  console.error(`[EventQueue] Attached observers for document: ${docName}`);
+}
+function detachObservers(docName) {
+  const cleanups = docObservers.get(docName);
+  if (cleanups) {
+    for (const cleanup of cleanups) cleanup();
+    docObservers.delete(docName);
+    console.error(`[EventQueue] Detached observers for document: ${docName}`);
+  }
+}
+function reattachObservers(docName, newDoc) {
+  attachObservers(docName, newDoc);
+}
+function attachCtrlObservers() {
+  for (const cleanup of ctrlCleanups) cleanup();
+  ctrlCleanups = [];
+  const ctrlDoc = getOrCreateDocument(CTRL_ROOM);
+  const chatMap = ctrlDoc.getMap(Y_MAP_CHAT);
+  const chatObs = (event, txn) => {
+    if (txn.origin === MCP_ORIGIN) return;
+    for (const [key, change] of event.changes.keys) {
+      if (change.action !== "add") continue;
+      const msg = chatMap.get(key);
+      if (!msg || msg.author !== "user") continue;
+      pushEvent({
+        id: generateEventId(),
+        type: "chat:message",
+        timestamp: Date.now(),
+        documentId: msg.documentId,
+        payload: {
+          messageId: msg.id,
+          text: msg.text,
+          replyTo: msg.replyTo ?? null,
+          anchor: msg.anchor ?? null
+        }
+      });
+    }
+  };
+  chatMap.observe(chatObs);
+  ctrlCleanups.push(() => chatMap.unobserve(chatObs));
+  const metaMap = ctrlDoc.getMap(Y_MAP_DOCUMENT_META);
+  let lastActiveDocId = null;
+  let lastOpenDocIds = /* @__PURE__ */ new Set();
+  const metaObs = (event, txn) => {
+    if (txn.origin === MCP_ORIGIN) return;
+    if (event.keysChanged.has("activeDocumentId")) {
+      const activeId = metaMap.get("activeDocumentId");
+      if (activeId && activeId !== lastActiveDocId) {
+        const openDoc = getOpenDocs().get(activeId);
+        pushEvent({
+          id: generateEventId(),
+          type: "document:switched",
+          timestamp: Date.now(),
+          documentId: activeId,
+          payload: {
+            fileName: openDoc?.filePath?.split(/[/\\]/).pop() ?? activeId
+          }
+        });
+        lastActiveDocId = activeId;
+      }
+    }
+    if (event.keysChanged.has("openDocuments")) {
+      const docList = metaMap.get("openDocuments") ?? [];
+      const currentIds = new Set(docList.map((d) => d.id));
+      for (const doc of docList) {
+        if (!lastOpenDocIds.has(doc.id)) {
+          const openDoc = getOpenDocs().get(doc.id);
+          pushEvent({
+            id: generateEventId(),
+            type: "document:opened",
+            timestamp: Date.now(),
+            documentId: doc.id,
+            payload: {
+              fileName: doc.fileName ?? openDoc?.filePath?.split(/[/\\]/).pop() ?? doc.id,
+              format: openDoc?.format ?? "unknown"
+            }
+          });
+        }
+      }
+      for (const oldId of lastOpenDocIds) {
+        if (!currentIds.has(oldId)) {
+          pushEvent({
+            id: generateEventId(),
+            type: "document:closed",
+            timestamp: Date.now(),
+            documentId: oldId,
+            payload: {
+              fileName: oldId
+            }
+          });
+        }
+      }
+      lastOpenDocIds = currentIds;
+    }
+  };
+  metaMap.observe(metaObs);
+  ctrlCleanups.push(() => metaMap.unobserve(metaObs));
+  console.error("[EventQueue] Attached CTRL_ROOM observers (chat + documentMeta)");
+}
+function reattachCtrlObservers() {
+  attachCtrlObservers();
+}
+var MCP_ORIGIN, docObservers, emittedPayloadIds, buffer2, subscribers2, ctrlCleanups;
+var init_queue = __esm({
+  "src/server/events/queue.ts"() {
+    "use strict";
+    init_constants();
+    init_annotations();
+    init_document_service();
+    init_provider();
+    init_types3();
+    MCP_ORIGIN = "mcp";
+    docObservers = /* @__PURE__ */ new Map();
+    emittedPayloadIds = /* @__PURE__ */ new Map();
+    buffer2 = [];
+    subscribers2 = /* @__PURE__ */ new Set();
+    ctrlCleanups = [];
+  }
+});
+
+// src/server/mcp/launcher.ts
+var launcher_exports = {};
+__export(launcher_exports, {
+  killClaude: () => killClaude,
+  launchClaude: () => launchClaude
+});
+import { spawn } from "child_process";
+function launchClaude() {
+  if (claudeProcess && !claudeProcess.killed) {
+    return { status: "already_running", pid: claudeProcess.pid };
+  }
+  const claudeCmd = process.env.TANDEM_CLAUDE_CMD || "claude";
+  const tandemUrl = `http://localhost:${process.env.TANDEM_MCP_PORT || DEFAULT_MCP_PORT}`;
+  const args = [
+    "--dangerously-load-development-channels",
+    "server:tandem-channel",
+    "--append-system-prompt",
+    TANDEM_SYSTEM_PROMPT,
+    "--name",
+    "tandem-reviewer"
+  ];
+  claudeProcess = spawn(claudeCmd, args, {
+    env: { ...process.env, TANDEM_URL: tandemUrl },
+    stdio: "pipe",
+    detached: true
+  });
+  if (claudeProcess.stdin?.writable) {
+    claudeProcess.stdin.write(
+      "A document has been opened in Tandem for review. Call tandem_checkInbox to see what needs attention, then begin reviewing.\n",
+      (err) => {
+        if (err) console.error("[Launcher] Failed to send initial prompt:", err.message);
       }
-    )
-  );
-  server.tool(
-    "tandem_exportAnnotations",
-    "Export all annotations as a formatted summary. Useful for review reports, especially on read-only .docx files.",
-    {
-      format: ExportFormatSchema.optional().describe("Output format (default: markdown)"),
-      documentId: z3.string().optional().describe("Target document ID (defaults to active document)")
-    },
-    withErrorBoundary("tandem_exportAnnotations", async ({ format, documentId }) => {
-      const da = getDocAndAnnotations(documentId);
-      if (!da) return noDocumentError();
-      const annotations = refreshAllRanges(collectAnnotations(da.map), da.ydoc, da.map);
-      const { ydoc } = da;
-      if (format === "json") {
-        const fullText = extractText(ydoc);
-        const enriched = annotations.map((ann) => ({
-          ...ann,
-          textSnippet: fullText.slice(
-            Math.max(0, ann.range.from),
-            Math.min(fullText.length, ann.range.to)
-          )
-        }));
-        return mcpSuccess({ annotations: enriched, count: enriched.length });
+    );
+  } else {
+    console.error("[Launcher] Claude process has no writable stdin \u2014 initial prompt not delivered");
+  }
+  const pid = claudeProcess.pid;
+  claudeProcess.on("error", (err) => {
+    if (err.code === "ENOENT") {
+      console.error(
+        "[Launcher] Claude Code not found. Install with: npm i -g @anthropic-ai/claude-code"
+      );
+    } else {
+      console.error("[Launcher] spawn error:", err);
+    }
+    claudeProcess = null;
+  });
+  claudeProcess.on("exit", (code) => {
+    console.error(`[Launcher] Claude Code exited with code ${code}`);
+    claudeProcess = null;
+  });
+  claudeProcess.stderr?.on("data", (chunk) => {
+    console.error(`[Claude] ${chunk.toString().trimEnd()}`);
+  });
+  claudeProcess.unref();
+  console.error(`[Launcher] Claude Code launched (pid: ${pid})`);
+  return { status: "launched", pid };
+}
+function killClaude() {
+  if (claudeProcess && !claudeProcess.killed) {
+    console.error(`[Launcher] Killing Claude Code (pid: ${claudeProcess.pid})`);
+    try {
+      claudeProcess.kill("SIGTERM");
+    } catch (err) {
+      const code = err.code;
+      if (code !== "ESRCH") {
+        console.error("[Launcher] Failed to kill Claude process:", err);
       }
-      const markdown = exportAnnotations(ydoc, annotations);
-      return mcpSuccess({ markdown, count: annotations.length });
-    })
-  );
+    }
+    claudeProcess = null;
+  }
+}
+var claudeProcess, TANDEM_SYSTEM_PROMPT;
+var init_launcher = __esm({
+  "src/server/mcp/launcher.ts"() {
+    "use strict";
+    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
+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;
+    }
+  }
+  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();
+init_document();
+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/server.ts
+init_annotations();
+
 // src/server/mcp/api-routes.ts
 init_constants();
 init_types2();
+init_notifications();
+init_provider();
+init_convert();
 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_annotations();
 init_document_model();
-init_file_io();
-import { z as z4 } from "zod";
+init_document_service();
+init_response();
 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" });
@@ -4844,8 +4960,8 @@ async function applyChangesCore(documentId, author, backupPath) {
   const suggestions = [];
   let pendingCount = 0;
   for (const [, raw] of map) {
-    const ann = raw;
-    if (ann.type !== "suggestion") continue;
+    const ann = sanitizeAnnotation(raw);
+    if (ann.suggestedText === void 0) continue;
     if (ann.status === "pending") {
       pendingCount++;
       continue;
@@ -4867,13 +4983,7 @@ async function applyChangesCore(documentId, author, backupPath) {
         to = resolvedTo;
       }
     }
-    let newText = "";
-    try {
-      const parsed = JSON.parse(ann.content);
-      newText = parsed.newText;
-    } catch {
-      newText = ann.content;
-    }
+    const newText = ann.suggestedText ?? "";
     let importCommentId;
     if (ann.id.startsWith("import-")) {
       const withoutPrefix = ann.id.slice("import-".length);
@@ -4988,7 +5098,7 @@ function registerApplyTools(server) {
 }
 
 // src/server/mcp/api-routes.ts
-init_provider();
+init_file_opener();
 function isHostAllowed(host) {
   const reqHost = (host ?? "").split(":")[0];
   return reqHost === "localhost" || reqHost === "127.0.0.1";
@@ -5225,12 +5335,15 @@ function registerApiRoutes(app, largeBody) {
 }
 
 // src/server/mcp/awareness.ts
-init_provider();
-import { z as z5 } from "zod";
+init_constants();
 init_types2();
 init_utils();
-init_constants();
 init_queue();
+init_provider();
+init_annotations();
+init_document();
+init_response();
+import { z as z5 } from "zod";
 var surfacedIds = /* @__PURE__ */ new Set();
 function registerAwarenessTools(server) {
   server.tool(
@@ -5584,11 +5697,16 @@ function registerChannelRoutes(app, apiMiddleware2) {
   });
 }
 
+// src/server/mcp/server.ts
+init_document();
+
 // src/server/mcp/navigation.ts
 init_constants();
 init_types();
 init_queue();
 init_provider();
+init_document();
+init_response();
 import { z as z6 } from "zod";
 function getFullText(docName) {
   const doc = getOrCreateDocument(docName);
@@ -5904,60 +6022,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 = [
   {
@@ -5975,12 +6044,10 @@ var TUTORIAL_ANNOTATIONS = [
   },
   {
     id: `${TUTORIAL_ANNOTATION_PREFIX}suggest-1`,
-    type: "suggestion",
+    type: "comment",
     targetText: "simplify onboarding",
-    content: JSON.stringify({
-      newText: "streamline onboarding",
-      reason: "More precise verb choice"
-    })
+    content: "More precise verb choice",
+    suggestedText: "streamline onboarding"
   }
 ];
 function injectTutorialAnnotations(doc) {
@@ -6020,8 +6087,9 @@ function injectTutorialAnnotations(doc) {
         content: def.content,
         status: "pending",
         timestamp: Date.now(),
-        color: def.color,
-        textSnapshot: def.targetText
+        textSnapshot: def.targetText,
+        ...def.color !== void 0 ? { color: def.color } : {},
+        ...def.suggestedText !== void 0 ? { suggestedText: def.suggestedText } : {}
       };
       map.set(def.id, annotation);
       injected++;
@@ -6033,6 +6101,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);