ryugi-artifacts 1.15.1 → 1.16.0

package/dist/server.cjs

@@ -5171,14 +5171,14 @@ var require_websocket_server = __commonJS({
 
 // src/server/main.ts
 var import_node_child_process2 = require("node:child_process");
-var import_node_fs24 = __toESM(require("node:fs"), 1);
+var import_node_fs25 = __toESM(require("node:fs"), 1);
 var import_node_os = __toESM(require("node:os"), 1);
-var import_node_path20 = __toESM(require("node:path"), 1);
+var import_node_path21 = __toESM(require("node:path"), 1);
 
 // src/server/app.ts
-var import_node_fs22 = __toESM(require("node:fs"), 1);
+var import_node_fs23 = __toESM(require("node:fs"), 1);
 var import_node_http = __toESM(require("node:http"), 1);
-var import_node_path19 = __toESM(require("node:path"), 1);
+var import_node_path20 = __toESM(require("node:path"), 1);
 
 // src/shared/types.ts
 var ARTIFACT_TYPES = ["artboard", "document", "html"];
@@ -5230,7 +5230,7 @@ function artifactKeyOf(relative) {
   if (!type || !id2 || !isArtifactType(type) || !isArtifactId(id2)) return null;
   return { type, id: id2 };
 }
-function artifactSignature(dir) {
+function artifactSignature(dir, type) {
   let count = 0;
   let size = 0;
   let latest = 0;
@@ -5243,6 +5243,7 @@ function artifactSignature(dir) {
     }
     for (const entry of entries2) {
       if (entry.name.startsWith(".")) continue;
+      if (type === "artboard" && current === dir && entry.name === "comments.json") continue;
       const full = import_node_path.default.join(current, entry.name);
       try {
         const stat = import_node_fs.default.statSync(full);
@@ -17727,12 +17728,19 @@ function stampBlockIds(state) {
   return { ...state, root: { ...state.root, children } };
 }
 
-// src/server/document-comments.ts
-var import_node_fs6 = __toESM(require("node:fs"), 1);
+// src/server/board-comments.ts
+var import_node_crypto2 = __toESM(require("node:crypto"), 1);
+var import_node_fs8 = __toESM(require("node:fs"), 1);
+var import_node_path7 = __toESM(require("node:path"), 1);
 
 // src/shared/comments.ts
 var emptyComments = () => ({ version: 1, threads: [] });
 var isObject = (value) => typeof value === "object" && value !== null;
+var documentAnchors = {
+  read: (value) => isObject(value) && typeof value.blockId === "string" && value.blockId ? { blockId: value.blockId, quote: typeof value.quote === "string" ? value.quote : "" } : null,
+  same: (a5, b6) => a5.blockId === b6.blockId && a5.quote === b6.quote,
+  missing: "a new thread needs anchor.blockId; dropped it"
+};
 function parseComments(text2) {
   const raw = JSON.parse(text2);
   if (!isObject(raw)) throw new Error("comments.json must be an object");
@@ -17745,13 +17753,14 @@ function parseComments(text2) {
   return raw;
 }
 var isSavedMessage = (m11) => !!m11.id && (m11.author === "human" || m11.author === "agent") && typeof m11.text === "string" && typeof m11.at === "string";
-function savedComments(incoming) {
+function savedComments(incoming, spec = documentAnchors) {
   const threads = [];
   for (const t7 of incoming.threads) {
-    if (!t7.id || !t7.anchor?.blockId || !t7.statusAt || t7.status !== "open" && t7.status !== "resolved") continue;
+    const anchor = spec.read(t7.anchor);
+    if (!t7.id || !anchor || !t7.statusAt || t7.status !== "open" && t7.status !== "resolved") continue;
     const messages = (t7.messages ?? []).filter(isSavedMessage);
     const statusBy = t7.statusBy === "human" || t7.statusBy === "agent" ? { statusBy: t7.statusBy } : {};
-    threads.push({ id: t7.id, anchor: { blockId: t7.anchor.blockId, quote: t7.anchor.quote ?? "" }, status: t7.status, statusAt: t7.statusAt, ...statusBy, messages });
+    threads.push({ id: t7.id, anchor, status: t7.status, statusAt: t7.statusAt, ...statusBy, messages });
   }
   return { version: 1, threads };
 }
@@ -17791,32 +17800,36 @@ function mergeThread(base, incoming, origin, now, newId, warnings, name) {
   messages.sort((a5, b6) => a5.at < b6.at ? -1 : a5.at > b6.at ? 1 : 0);
   let { status, statusAt, statusBy } = base;
   if (incoming.status && incoming.status !== base.status) {
-    const stamp = incoming.statusAt && incoming.statusAt !== base.statusAt ? incoming.statusAt : now;
-    if (stamp >= base.statusAt) {
+    const stamp2 = incoming.statusAt && incoming.statusAt !== base.statusAt ? incoming.statusAt : now;
+    if (stamp2 >= base.statusAt) {
       status = incoming.status;
-      statusAt = stamp;
+      statusAt = stamp2;
       statusBy = origin;
     }
   }
   return { ...base, status, statusAt, ...statusBy ? { statusBy } : {}, messages };
 }
-var sameUnsavedThread = (existing, incoming) => existing.anchor.blockId === incoming.anchor?.blockId && existing.anchor.quote === (incoming.anchor?.quote ?? "") && existing.messages[0]?.text === incoming.messages?.[0]?.text;
-function mergeComments(base, incoming, origin, now, newId, name) {
+function sameUnsavedThread(existing, incoming, spec) {
+  const anchor = spec.read(incoming.anchor);
+  return !!anchor && spec.same(existing.anchor, anchor) && existing.messages[0]?.text === incoming.messages?.[0]?.text;
+}
+function mergeComments(base, incoming, origin, now, newId, name, spec = documentAnchors) {
   const warnings = [];
   const threads = [...base.threads];
   for (const thread of incoming.threads) {
-    const index = thread.id ? threads.findIndex((t7) => t7.id === thread.id) : threads.findIndex((t7) => sameUnsavedThread(t7, thread));
+    const index = thread.id ? threads.findIndex((t7) => t7.id === thread.id) : threads.findIndex((t7) => sameUnsavedThread(t7, thread, spec));
     if (index >= 0) {
       threads[index] = mergeThread(threads[index], thread, origin, now, newId, warnings, name);
       continue;
     }
-    if (!thread.anchor?.blockId) {
-      warnings.push("a new thread needs anchor.blockId; dropped it");
+    const anchor = spec.read(thread.anchor);
+    if (!anchor) {
+      warnings.push(spec.missing);
       continue;
     }
     const fresh = {
       id: thread.id ?? newId(),
-      anchor: { blockId: thread.anchor.blockId, quote: thread.anchor.quote ?? "" },
+      anchor,
       status: "open",
       statusAt: now,
       statusBy: origin,
@@ -17834,23 +17847,15 @@ var updateHumanMessage = (thread, messageId, update2) => ({
   ...thread,
   messages: thread.messages.map((m11) => m11.id === messageId && m11.author === "human" && !m11.deleted ? update2(m11) : m11)
 });
+function openThread(anchor, author, text2, now, newId, who) {
+  return { id: newId(), anchor, status: "open", statusAt: now, statusBy: author, messages: [{ id: newId(), author, ...personOf(who), text: text2, at: now }] };
+}
 function applyHumanOp(file, op, now, newId, who) {
+  if (op.op === "create") return { ...file, threads: [...file.threads, openThread({ blockId: op.blockId, quote: op.quote }, "human", op.text, now, newId, who)] };
+  return applyThreadOp(file, op, now, newId, who);
+}
+function applyThreadOp(file, op, now, newId, who) {
   switch (op.op) {
-    case "create":
-      return {
-        ...file,
-        threads: [
-          ...file.threads,
-          {
-            id: newId(),
-            anchor: { blockId: op.blockId, quote: op.quote },
-            status: "open",
-            statusAt: now,
-            statusBy: "human",
-            messages: [{ id: newId(), author: "human", ...personOf(who), text: op.text, at: now }]
-          }
-        ]
-      };
     case "reply":
       return updateThread(file, op.threadId, (t7) => ({ ...t7, messages: [...t7.messages, { id: newId(), author: "human", ...personOf(who), text: op.text, at: now }] }));
     case "edit":
@@ -17905,7 +17910,7 @@ function unreadThreads(file, cursor) {
   const threads = [];
   let newest = cursor;
   for (const thread of file.threads) {
-    for (const stamp of humanStamps(thread)) if (!newest || stamp > newest) newest = stamp;
+    for (const stamp2 of humanStamps(thread)) if (!newest || stamp2 > newest) newest = stamp2;
     const unread = cursor === null ? waitingOn(thread) === "agent" ? waitingSince(thread) : null : changesSince(thread, cursor);
     if (unread && unread.changes.length > 0) threads.push({ ...thread, ...unread });
   }
@@ -17913,16 +17918,12 @@ function unreadThreads(file, cursor) {
 }
 function applyAgentOp(file, op, now, newId, name) {
   if (op.op === "add") {
-    const thread = {
-      id: newId(),
-      anchor: { blockId: op.blockId, quote: op.quote },
-      status: "open",
-      statusAt: now,
-      statusBy: "agent",
-      messages: [{ id: newId(), author: "agent", ...personOf({ name }), text: op.text, at: now }]
-    };
+    const thread = openThread({ blockId: op.blockId, quote: op.quote }, "agent", op.text, now, newId, { name });
     return { file: { ...file, threads: [...file.threads, thread] }, threadId: thread.id, messageId: thread.messages[0].id };
   }
+  return applyAgentThreadOp(file, op, now, newId, name);
+}
+function applyAgentThreadOp(file, op, now, newId, name) {
   if (!file.threads.some((t7) => t7.id === op.threadId)) throw new Error(`no thread ${op.threadId}`);
   if (op.op === "resolve") {
     return { file: updateThread(file, op.threadId, (t7) => ({ ...t7, status: "resolved", statusAt: now, statusBy: "agent" })), threadId: op.threadId };
@@ -17931,6 +17932,76 @@ function applyAgentOp(file, op, now, newId, name) {
   return { file: updateThread(file, op.threadId, (t7) => ({ ...t7, messages: [...t7.messages, message] })), threadId: op.threadId, messageId: message.id };
 }
 
+// src/shared/board-comments.ts
+var MAX_ID = 100;
+var MAX_PATH = 2e3;
+var MAX_NODES = 50;
+var isName = (value, max = MAX_ID) => typeof value === "string" && value.length > 0 && value.length <= max;
+var isFiniteNumber = (value) => typeof value === "number" && Number.isFinite(value);
+var isFraction = (value) => isFiniteNumber(value) && value >= 0 && value <= 1;
+function readNodes(value) {
+  if (!Array.isArray(value) || value.length === 0 || value.length > MAX_NODES) return null;
+  const nodes = [];
+  for (const node of value) {
+    if (!isObject(node) || !isName(node.board) || !isName(node.path, MAX_PATH)) return null;
+    nodes.push({ board: node.board, path: node.path });
+  }
+  return nodes;
+}
+function readHashes(value) {
+  if (!isObject(value) || Array.isArray(value)) return null;
+  const entries2 = Object.entries(value);
+  if (entries2.length > MAX_NODES || !entries2.every(([board, hash]) => isName(board) && isName(hash))) return null;
+  return Object.fromEntries(entries2);
+}
+function readBoardAnchor(value) {
+  if (!isObject(value) || !isName(value.page) || !isFiniteNumber(value.x) || !isFiniteNumber(value.y)) return null;
+  const anchor = { page: value.page, x: value.x, y: value.y };
+  if (value.board !== void 0) {
+    if (!isName(value.board)) return null;
+    anchor.board = value.board;
+  }
+  if (value.nodes !== void 0) {
+    const nodes = readNodes(value.nodes);
+    if (!nodes) return null;
+    anchor.nodes = nodes;
+  }
+  if (value.offset !== void 0) {
+    const offset = value.offset;
+    if (!anchor.nodes || !isObject(offset) || !isFraction(offset.x) || !isFraction(offset.y)) return null;
+    anchor.offset = { x: offset.x, y: offset.y };
+  }
+  if (value.hashes !== void 0) {
+    const hashes = readHashes(value.hashes);
+    if (!hashes) return null;
+    anchor.hashes = hashes;
+  }
+  return anchor;
+}
+var boardAnchors = {
+  read: readBoardAnchor,
+  same: (a5, b6) => a5.page === b6.page && a5.board === b6.board && a5.x === b6.x && a5.y === b6.y,
+  missing: "a new thread needs a board anchor (page, x, y); dropped it"
+};
+var emptyBoardComments = () => ({ version: 1, threads: [] });
+var savedBoardComments = (incoming) => savedComments(incoming, boardAnchors);
+var mergeBoardComments = (base, incoming, origin, now, newId, name) => mergeComments(base, incoming, origin, now, newId, name, boardAnchors);
+function applyBoardHumanOp(file, op, now, newId, who) {
+  if (op.op === "create") return { ...file, threads: [...file.threads, openThread(op.anchor, "human", op.text, now, newId, who)] };
+  return applyThreadOp(file, op, now, newId, who);
+}
+function applyBoardAgentOp(file, op, now, newId, name) {
+  if (op.op === "add") {
+    const thread = openThread(op.anchor, "agent", op.text, now, newId, { name });
+    return { file: { ...file, threads: [...file.threads, thread] }, threadId: thread.id, messageId: thread.messages[0].id };
+  }
+  return applyAgentThreadOp(file, op, now, newId, name);
+}
+
+// src/server/comment-cursors.ts
+var import_node_fs6 = __toESM(require("node:fs"), 1);
+var import_node_path6 = __toESM(require("node:path"), 1);
+
 // src/server/state.ts
 var import_node_fs5 = __toESM(require("node:fs"), 1);
 var import_node_path5 = __toESM(require("node:path"), 1);
@@ -18282,7 +18353,31 @@ function writeArtifactState(stateDir, ref, payload, extra = {}) {
   });
 }
 
+// src/server/comment-cursors.ts
+var cursorsFile = (stateDir, id2, type = "document") => import_node_path6.default.join(stateDir, type, id2, "comment-cursors.json");
+function read(file) {
+  try {
+    const value = JSON.parse(import_node_fs6.default.readFileSync(file, "utf8"));
+    if (typeof value !== "object" || value === null || Array.isArray(value)) return {};
+    return Object.fromEntries(Object.entries(value).filter((entry) => typeof entry[1] === "string"));
+  } catch {
+    return {};
+  }
+}
+function createCommentCursors(stateDir, type = "document") {
+  return {
+    get: (id2, agent) => read(cursorsFile(stateDir, id2, type))[agent] ?? null,
+    set: (id2, agent, stamp2) => {
+      const file = cursorsFile(stateDir, id2, type);
+      const all = read(file);
+      if (all[agent] === stamp2) return;
+      writeJsonAtomic(file, { ...all, [agent]: stamp2 });
+    }
+  };
+}
+
 // src/server/document-comments.ts
+var import_node_fs7 = __toESM(require("node:fs"), 1);
 var MAX_TEXT = 2e4;
 var isText3 = (value, max = MAX_TEXT) => typeof value === "string" && value.length <= max;
 var isId = (value) => isText3(value, 100) && value.length > 0;
@@ -18319,20 +18414,30 @@ function asAgentOp(value) {
       return null;
   }
 }
+var documentRules = {
+  empty: emptyComments,
+  saved: savedComments,
+  merge: mergeComments,
+  human: applyHumanOp,
+  agent: applyAgentOp
+};
 var noNames = { human: () => void 0, agent: () => void 0 };
 function createCommentStore(file, names = noNames, now = () => (/* @__PURE__ */ new Date()).toISOString(), newId = () => nanoid2(10)) {
-  let current = emptyComments();
+  return createStore(file, documentRules, names, now, newId);
+}
+function createStore(file, rules, names = noNames, now = () => (/* @__PURE__ */ new Date()).toISOString(), newId = () => nanoid2(10)) {
+  let current = rules.empty();
   let lastSeen = null;
   let warnings = [];
   let loaded = false;
   const write = () => {
     writeJsonAtomic(file, current);
-    lastSeen = import_node_fs6.default.readFileSync(file, "utf8");
+    lastSeen = import_node_fs7.default.readFileSync(file, "utf8");
   };
   const sync = () => {
     let text2;
     try {
-      text2 = import_node_fs6.default.readFileSync(file, "utf8");
+      text2 = import_node_fs7.default.readFileSync(file, "utf8");
     } catch {
       return false;
     }
@@ -18340,8 +18445,8 @@ function createCommentStore(file, names = noNames, now = () => (/* @__PURE__ */
     lastSeen = text2;
     try {
       const incoming = parseComments(text2);
-      const base = loaded ? current : savedComments(incoming);
-      const merged = mergeComments(base, incoming, "agent", now(), newId, names.agent());
+      const base = loaded ? current : rules.saved(incoming);
+      const merged = rules.merge(base, incoming, "agent", now(), newId, names.agent());
       current = merged.file;
       warnings = merged.warnings;
       if (`${JSON.stringify(current, null, 2)}
@@ -18359,13 +18464,13 @@ function createCommentStore(file, names = noNames, now = () => (/* @__PURE__ */
     sync,
     apply: (op) => {
       sync();
-      current = applyHumanOp(current, op, now(), newId, names.human());
+      current = rules.human(current, op, now(), newId, names.human());
       write();
       return current;
     },
     applyAgent: (op, name) => {
       sync();
-      const result = applyAgentOp(current, op, now(), newId, name ?? names.agent());
+      const result = rules.agent(current, op, now(), newId, name ?? names.agent());
       current = result.file;
       write();
       return result;
@@ -18373,38 +18478,166 @@ function createCommentStore(file, names = noNames, now = () => (/* @__PURE__ */
   };
 }
 
-// src/server/documents.ts
-var import_node_fs8 = __toESM(require("node:fs"), 1);
-var import_node_path8 = __toESM(require("node:path"), 1);
-
-// src/server/comment-cursors.ts
-var import_node_fs7 = __toESM(require("node:fs"), 1);
-var import_node_path6 = __toESM(require("node:path"), 1);
-var cursorsFile = (stateDir, id2) => import_node_path6.default.join(stateDir, "document", id2, "comment-cursors.json");
-function read(file) {
+// src/server/board-comments.ts
+var boardRules = {
+  empty: emptyBoardComments,
+  saved: savedBoardComments,
+  merge: mergeBoardComments,
+  human: (file, op, now, newId, who) => applyBoardHumanOp(file, op, now, newId, who),
+  agent: applyBoardAgentOp
+};
+var withoutHashes = ({ hashes: _hashes, ...anchor }) => anchor;
+function asBoardHumanOp(value) {
+  if (typeof value !== "object" || value === null) return null;
+  const v6 = value;
+  if (v6.op !== "create") {
+    const op = asHumanOp(value);
+    return op && op.op !== "create" ? op : null;
+  }
+  const anchor = readBoardAnchor(v6.anchor);
+  return anchor && isText3(v6.text) && v6.text.length > 0 ? { op: "create", anchor: withoutHashes(anchor), text: v6.text } : null;
+}
+function asBoardAgentOp(value) {
+  if (typeof value !== "object" || value === null) return null;
+  const v6 = value;
+  if (v6.op === "add") {
+    const anchor = readBoardAnchor(v6.anchor);
+    return anchor && isText3(v6.text) && v6.text.length > 0 ? { op: "add", anchor: withoutHashes(anchor), text: v6.text } : null;
+  }
+  if (v6.op === "reply") return isId(v6.threadId) && isText3(v6.text) && v6.text.length > 0 ? { op: "reply", threadId: v6.threadId, text: v6.text } : null;
+  if (v6.op === "resolve") return isId(v6.threadId) ? { op: "resolve", threadId: v6.threadId } : null;
+  return null;
+}
+function boardSpecs(dir) {
   try {
-    const value = JSON.parse(import_node_fs7.default.readFileSync(file, "utf8"));
-    if (typeof value !== "object" || value === null || Array.isArray(value)) return {};
-    return Object.fromEntries(Object.entries(value).filter((entry) => typeof entry[1] === "string"));
+    const canvas = JSON.parse(import_node_fs8.default.readFileSync(import_node_path7.default.join(dir, "canvas.json"), "utf8"));
+    return Object.fromEntries(Object.entries(canvas.boards ?? {}).flatMap(
+      ([id2, board]) => typeof board?.file === "string" ? [[id2, { file: board.file, page: typeof board.page === "string" ? board.page : "", w: typeof board.w === "number" ? board.w : 0 }]] : []
+    ));
   } catch {
     return {};
   }
 }
-function createCommentCursors(stateDir) {
+var boardFiles = (dir) => Object.fromEntries(Object.entries(boardSpecs(dir)).map(([id2, spec]) => [id2, spec.file]));
+function agentAddOnBoard(value, specs) {
+  if (typeof value !== "object" || value === null) return null;
+  const v6 = value;
+  if (v6.op !== "add" || typeof v6.board !== "string" || v6.anchor !== void 0) return null;
+  const spec = specs[v6.board];
+  if (!spec) return { error: `no board ${v6.board}` };
+  return asBoardAgentOp({ op: "add", anchor: { page: spec.page, board: v6.board, x: v6.x ?? spec.w, y: v6.y ?? 0 }, text: v6.text });
+}
+function fileHash(dir, relative) {
+  const file = resolveBoardFile(dir, relative);
+  if (!file) return null;
+  try {
+    return import_node_crypto2.default.createHash("sha1").update(import_node_fs8.default.readFileSync(file)).digest("hex").slice(0, 12);
+  } catch {
+    return null;
+  }
+}
+function boardHashes(dir) {
+  return Object.fromEntries(Object.entries(boardFiles(dir)).flatMap(([id2, file]) => {
+    const hash = fileHash(dir, file);
+    return hash ? [[id2, hash]] : [];
+  }));
+}
+var boardsOf = (anchor) => [.../* @__PURE__ */ new Set([...anchor.board ? [anchor.board] : [], ...(anchor.nodes ?? []).map((node) => node.board)])];
+function stamp(anchor, hashes) {
+  const boards = boardsOf(anchor);
+  if (!boards.length) return withoutHashes(anchor);
+  return { ...withoutHashes(anchor), hashes: Object.fromEntries(boards.map((board) => [board, hashes[board] ?? "missing"])) };
+}
+var isStale = (thread, hashes) => Object.entries(thread.anchor.hashes ?? {}).some(([board, hash]) => hashes[board] !== hash);
+function createBoardCommentRegistry(options) {
+  const stores = /* @__PURE__ */ new Map();
+  const hashes = /* @__PURE__ */ new Map();
+  const lastStale = /* @__PURE__ */ new Map();
+  const cursors = createCommentCursors(options.stateDir, "artboard");
+  const dirOf = (id2) => import_node_path7.default.join(options.root, "artboard", id2);
+  const store = (id2) => {
+    let found = stores.get(id2);
+    if (!found) {
+      found = createStore(import_node_path7.default.join(dirOf(id2), "comments.json"), boardRules, options.names);
+      stores.set(id2, found);
+    }
+    return found;
+  };
+  const currentHashes = (id2) => {
+    let found = hashes.get(id2);
+    if (!found) {
+      found = boardHashes(dirOf(id2));
+      hashes.set(id2, found);
+    }
+    return found;
+  };
+  const stale = (id2) => {
+    const now = currentHashes(id2);
+    return store(id2).current().threads.filter((thread) => isStale(thread, now)).map((thread) => thread.id);
+  };
+  const push2 = (id2) => {
+    const ids = stale(id2);
+    lastStale.set(id2, JSON.stringify(ids));
+    options.broadcast({ type: "board-comments", artifact: `artboard/${id2}`, comments: store(id2).current(), stale: ids });
+  };
+  const fresh = (id2) => {
+    hashes.delete(id2);
+    return currentHashes(id2);
+  };
+  const forAgent2 = (id2, staleIds) => {
+    const files = boardFiles(dirOf(id2));
+    return (thread) => ({
+      ...thread,
+      stale: staleIds.has(thread.id),
+      waitingOn: waitingOn(thread),
+      files: Object.fromEntries(boardsOf(thread.anchor).flatMap((board) => files[board] ? [[board, files[board]]] : [])),
+      messages: thread.messages.map(({ avatar: _avatar, ...message }) => message)
+    });
+  };
   return {
-    get: (id2, agent) => read(cursorsFile(stateDir, id2))[agent] ?? null,
-    set: (id2, agent, stamp) => {
-      const file = cursorsFile(stateDir, id2);
-      const all = read(file);
-      if (all[agent] === stamp) return;
-      writeJsonAtomic(file, { ...all, [agent]: stamp });
+    comments: (id2) => store(id2).current(),
+    stale,
+    warnings: (id2) => store(id2).warnings(),
+    apply: (id2, op) => {
+      const stamped = op.op === "create" ? { ...op, anchor: stamp(op.anchor, fresh(id2)) } : op;
+      store(id2).apply(stamped);
+      push2(id2);
+      return { comments: store(id2).current(), stale: stale(id2) };
+    },
+    applyAgent: (id2, op, agent) => {
+      const stamped = op.op === "add" ? { ...op, anchor: stamp(op.anchor, fresh(id2)) } : op;
+      const { threadId, messageId } = store(id2).applyAgent(stamped, agent);
+      push2(id2);
+      return { threadId, ...messageId ? { messageId } : {} };
+    },
+    list: (id2, agent, all) => {
+      const changed = store(id2).sync();
+      if (changed) push2(id2);
+      const file = store(id2).current();
+      const format = forAgent2(id2, new Set(stale(id2)));
+      if (all) return file.threads.filter((t7) => !t7.messages.every((m11) => m11.deleted)).map(format);
+      const { threads, newest } = unreadThreads(file, cursors.get(id2, agent));
+      if (newest) cursors.set(id2, agent, newest);
+      return threads.map(format);
+    },
+    sync: (id2) => {
+      if (store(id2).sync()) push2(id2);
+    },
+    boardsChanged: (id2) => {
+      fresh(id2);
+      if (!stores.has(id2) && !import_node_fs8.default.existsSync(import_node_path7.default.join(dirOf(id2), "comments.json"))) return;
+      if (JSON.stringify(stale(id2)) !== (lastStale.get(id2) ?? "[]")) push2(id2);
     }
   };
 }
 
+// src/server/documents.ts
+var import_node_fs9 = __toESM(require("node:fs"), 1);
+var import_node_path9 = __toESM(require("node:path"), 1);
+
 // src/server/document-session.ts
 var import_promises = __toESM(require("node:fs/promises"), 1);
-var import_node_path7 = __toESM(require("node:path"), 1);
+var import_node_path8 = __toESM(require("node:path"), 1);
 
 // node_modules/.pnpm/lexical@0.52.0_typescript@5.9.3/node_modules/lexical/dist/Lexical.dev.js
 var Lexical_dev_exports = {};
@@ -19262,19 +19495,19 @@ var ElementDOMSlot = class _ElementDOMSlot extends DOMSlot {
   }
 };
 function indexPath(root, child) {
-  const path21 = [];
+  const path22 = [];
   let node = child;
   for (; node !== root && node !== null; node = node.parentNode) {
     let i6 = 0;
     for (let sibling = node.previousSibling; sibling !== null; sibling = sibling.previousSibling) {
       i6++;
     }
-    path21.push(i6);
+    path22.push(i6);
   }
   if (!(node === root)) {
     formatDevErrorMessage(`indexPath: root is not a parent of child`);
   }
-  return path21.reverse();
+  return path22.reverse();
 }
 // @__NO_SIDE_EFFECTS__
 function readLexicalVersion() {
@@ -34054,9 +34287,9 @@ function getActiveElementDeep(root) {
 function getComposedEventTarget(event) {
   const target = event.target;
   if (target !== null && isHTMLElement(target) && target.shadowRoot !== null && typeof event.composedPath === "function") {
-    const path21 = event.composedPath();
-    if (path21.length > 0) {
-      return path21[0];
+    const path22 = event.composedPath();
+    if (path22.length > 0) {
+      return path22[0];
     }
   }
   return target;
@@ -35967,7 +36200,7 @@ __export(Lexical_prod_exports, {
   $getNodeFromDOMNode: () => Qc,
   $getPreviousSelection: () => ds,
   $getRoot: () => ra,
-  $getSelection: () => fs8,
+  $getSelection: () => fs9,
   $getSelectionSlotFrame: () => Df,
   $getSiblingCaret: () => ad,
   $getSlot: () => Lf,
@@ -36707,9 +36940,9 @@ function Ct(t7, e5, n7) {
   const o8 = performance.now() - _t > 100;
   try {
     al(t7, () => {
-      const r7 = fs8() || (function(t8) {
+      const r7 = fs9() || (function(t8) {
         return t8.read("latest", () => {
-          const t9 = fs8();
+          const t9 = fs9();
           return null !== t9 ? t9.clone() : null;
         });
       })(t7), i6 = /* @__PURE__ */ new Map(), s7 = t7._editorState, l8 = t7._blockCursorElement;
@@ -37989,7 +38222,7 @@ function Yo(t7, n7, o8) {
   al(n7, () => {
     if (!o8) return void sa(null);
     if (!Dc(n7, r7, s7)) return;
-    let a5 = fs8();
+    let a5 = fs9();
     if (c10.postDeleteSelectionToRestore && zi(a5) && a5.isCollapsed()) {
       const t8 = a5.anchor, e5 = c10.postDeleteSelectionToRestore.anchor;
       (t8.key === e5.key && t8.offset === e5.offset + 1 || 1 === t8.offset && e5.getNode().is(t8.getNode().getPreviousSibling())) && (a5 = c10.postDeleteSelectionToRestore.clone(), sa(a5));
@@ -38031,7 +38264,7 @@ function Xo(t7, e5) {
 }
 function Qo(t7, e5) {
   al(e5, () => {
-    const n7 = fs8(), o8 = Qa(Wa(e5)), r7 = ds();
+    const n7 = fs9(), o8 = Qa(Wa(e5)), r7 = ds();
     if (o8) {
       if (zi(n7)) {
         const t8 = n7.anchor, e6 = t8.getNode();
@@ -38080,7 +38313,7 @@ function er(t7) {
   if (null == t7 || t7.length <= 1 || null == e5) return;
   const n7 = 1 === e5.length ? e5 : "Enter" === e5 ? "\n" : "Tab" === e5 ? "	" : null;
   if (!n7) return;
-  const o8 = fs8();
+  const o8 = fs9();
   if (!zi(o8) || !o8.isCollapsed()) return;
   const r7 = o8.anchor.getNode();
   if (!ki(r7)) return;
@@ -38112,7 +38345,7 @@ function rr(t7, e5) {
   return null !== r7 && o8.contains(r7) && Ju(r7, e5);
 }
 function ir(t7) {
-  const n7 = t7.inputType, o8 = tr(t7), r7 = Vs(), i6 = r7._inputState, s7 = fs8();
+  const n7 = t7.inputType, o8 = tr(t7), r7 = Vs(), i6 = r7._inputState, s7 = fs9();
   if ("insertText" === n7 && t7.data && i6.isInsertTextAfterHandledSelectionCommand) {
     if (nr(i6), t7.preventDefault(), zi(s7) && !s7.isCollapsed()) {
       const t8 = s7.isBackward() ? s7.anchor : s7.focus;
@@ -38146,7 +38379,7 @@ function ir(t7) {
         let u9 = m && n8 && !a6 && c11;
         if (u9 && s7.isCollapsed() && (u9 = !Sl(Ea(s7.anchor, true))), !u9) {
           Ma(r7, jn, true);
-          const t8 = fs8();
+          const t8 = fs9();
           m && zi(t8) && t8.isCollapsed() && (i6.postDeleteSelectionToRestore = t8, setTimeout(() => i6.postDeleteSelectionToRestore = null));
         }
       }
@@ -38246,7 +38479,7 @@ function sr(t7, e5) {
   }, { event: t7 }), n7.unprocessedBeforeInputData = null;
 }
 function lr(t7) {
-  const e5 = Vs(), n7 = e5._inputState, o8 = fs8(), r7 = t7.data, i6 = tr(t7);
+  const e5 = Vs(), n7 = e5._inputState, o8 = fs9(), r7 = t7.data, i6 = tr(t7);
   let s7 = false;
   if (null != r7 && zi(o8)) {
     const l8 = Qa(Wa(e5)), c10 = null !== l8 ? cu(l8, e5._rootElement) : null, a5 = "insertCompositionText" === t7.inputType && "ending-firefox" !== n7.compositionPhase && !e5.isComposing();
@@ -38271,13 +38504,13 @@ function cr(t7, e5) {
   Ma(e5, Wn, t7);
 }
 function ar(t7) {
-  const e5 = Vs(), n7 = e5._inputState, o8 = fs8();
+  const e5 = Vs(), n7 = e5._inputState, o8 = fs9();
   if (zi(o8) && !e5.isComposing()) {
     n7.compositionPhase = "composing", n7.hadOrphanedCompositionEvents = false;
     const r7 = o8.anchor, i6 = o8.anchor.getNode();
     if (Yc(r7.key), za(Ur), t7.timeStamp < n7.lastKeyDownTimeStamp + 30 || "element" === r7.type || !o8.isCollapsed() || !m && (i6.getFormat() !== o8.format || ki(i6) && i6.getStyle() !== o8.style) || ki(i6) && (Bc(i6) || 0 === r7.offset && !i6.canInsertTextBefore() || r7.offset === i6.getTextContentSize() && !i6.canInsertTextAfter())) {
       Ma(e5, Jn, F);
-      const t8 = fs8();
+      const t8 = fs9();
       zi(t8) && Yc(t8.anchor.key);
     }
   }
@@ -38291,7 +38524,7 @@ function fr(t7) {
   if (null === t7) return;
   const e5 = Xc(t7);
   if (!ki(e5) || "text" === e5.getType() || Bc(e5) || !e5.isAttached()) return;
-  const n7 = fs8(), o8 = zi(n7) && n7.anchor.key === t7 ? n7.anchor.offset : null, r7 = vi(e5.getTextContent());
+  const n7 = fs9(), o8 = zi(n7) && n7.anchor.key === t7 ? n7.anchor.offset : null, r7 = vi(e5.getTextContent());
   if (r7.setFormat(e5.getFormat()), r7.setStyle(e5.getStyle()), e5.replace(r7), null !== o8) {
     const t8 = Math.min(o8, r7.getTextContentSize());
     r7.select(t8, t8);
@@ -38310,7 +38543,7 @@ function dr(t7, e5) {
       return fr(n7), false;
     }
     if ("\n" === e5[e5.length - 1]) {
-      const e6 = fs8();
+      const e6 = fs9();
       if (zi(e6) || Bi(e6)) {
         if (zi(e6)) {
           const t8 = e6.focus;
@@ -38322,7 +38555,7 @@ function dr(t7, e5) {
     const o8 = Xc(n7);
     if (null !== o8 && ki(o8) && Bc(o8)) {
       o8.markDirty();
-      const t8 = fs8(), r7 = o8.getTextContentSize(), i6 = zi(t8) && t8.anchor.key === n7 ? t8.anchor.offset : r7;
+      const t8 = fs9(), r7 = o8.getTextContentSize(), i6 = zi(t8) && t8.anchor.key === n7 ? t8.anchor.offset : r7;
       return o8.select(i6, i6).insertText(e5), true;
     }
   }
@@ -38449,7 +38682,7 @@ function wr(t7, n7, o8) {
   const r7 = t7.__key, i6 = t7.getParent();
   if (null === i6) return void (null !== Of(t7) && e(367, r7, String(Of(t7))));
   const s7 = (function(t8) {
-    const e5 = fs8();
+    const e5 = fs9();
     if (!zi(e5) || !yl(t8)) return e5;
     const { anchor: n8, focus: o9 } = e5, r8 = n8.getNode(), i7 = o9.getNode();
     return Ba(r8, t8) && n8.set(t8.__key, 0, "element"), Ba(i7, t8) && o9.set(t8.__key, 0, "element"), e5;
@@ -38521,7 +38754,7 @@ var Fr = class {
     return false;
   }
   isSelected(t7) {
-    const e5 = t7 || fs8();
+    const e5 = t7 || fs9();
     if (null == e5) return false;
     const n7 = e5.getNodes().some((t8) => t8.__key === this.__key);
     if (ki(this)) return n7;
@@ -38711,7 +38944,7 @@ var Fr = class {
   }
   replace(t7, n7) {
     Ws();
-    let o8 = fs8();
+    let o8 = fs9();
     null !== o8 && (o8 = o8.clone()), qa(this, t7);
     const r7 = this.getLatest(), i6 = this.__key, s7 = Mf(r7);
     null !== s7 && e(400, i6, r7.getType(), s7.getKey(), s7.getType());
@@ -38731,7 +38964,7 @@ var Fr = class {
     Ws(), qa(this, t7);
     const n7 = this.getWritable(), o8 = t7.getWritable();
     this.getParentOrThrow();
-    const r7 = o8.getParent(), i6 = fs8();
+    const r7 = o8.getParent(), i6 = fs9();
     let s7 = false, l8 = false, c10 = -1;
     if (null !== r7 && e5 && zi(i6) && hs(i6, r7)) {
       const e6 = r7.__key, n8 = i6.anchor, o9 = i6.focus;
@@ -38752,7 +38985,7 @@ var Fr = class {
     Ws(), qa(this, t7);
     const n7 = this.getWritable(), o8 = t7.getWritable();
     this.getParentOrThrow();
-    const r7 = o8.__key, i6 = fs8(), s7 = o8.getParent(), l8 = null !== s7 && e5 && zi(i6) && hs(i6, s7), c10 = l8 ? o8.getIndexWithinParent() : -1;
+    const r7 = o8.__key, i6 = fs9(), s7 = o8.getParent(), l8 = null !== s7 && e5 && zi(i6) && hs(i6, s7), c10 = l8 ? o8.getIndexWithinParent() : -1;
     Jc(o8), l8 && null !== s7 && zi(i6) && gs(i6, s7, c10, -1);
     const a5 = this.getPreviousSibling(), u8 = this.getParentOrThrow().getWritable(), f6 = n7.__prev, d9 = e5 && zi(i6) && hs(i6, u8), h9 = d9 ? this.getIndexWithinParent() : -1;
     return null === a5 ? u8.__first = r7 : a5.getWritable().__next = r7, u8.__size++, n7.__prev = r7, o8.__prev = f6, o8.__next = n7.__key, o8.__parent = n7.__parent, d9 && zi(i6) && gs(i6, u8, h9), t7;
@@ -39150,7 +39383,7 @@ var hi = class extends Fr {
   select(t7, e5) {
     Ws();
     let n7 = t7, o8 = e5;
-    const r7 = fs8(), i6 = this.getTextContent(), s7 = this.__key;
+    const r7 = fs9(), i6 = this.getTextContent(), s7 = this.__key;
     if ("string" == typeof i6) {
       const t8 = i6.length;
       void 0 === n7 && (n7 = t8), void 0 === o8 && (o8 = t8);
@@ -39173,7 +39406,7 @@ var hi = class extends Fr {
     const r7 = this.getWritable(), i6 = r7.__text, s7 = n7.length;
     let l8 = t7;
     l8 < 0 && (l8 = s7 + l8, l8 < 0 && (l8 = 0));
-    const c10 = fs8();
+    const c10 = fs9();
     if (o8 && zi(c10)) {
       const e6 = t7 + s7;
       c10.setTextNodeRange(r7, e6, r7, e6);
@@ -39204,7 +39437,7 @@ var hi = class extends Fr {
     let f6;
     const d9 = e5.getFormat(), h9 = e5.getStyle(), g8 = e5.__detail;
     let _5 = false, p7 = null, y5 = null;
-    const m11 = fs8();
+    const m11 = fs9();
     if (zi(m11)) {
       const [t8, e6] = m11.isBackward() ? [m11.focus, m11.anchor] : [m11.anchor, m11.focus];
       "text" === t8.type && t8.key === o8 && (p7 = t8), "text" === e6.type && e6.key === o8 && (y5 = e6);
@@ -39243,7 +39476,7 @@ var hi = class extends Fr {
     n7 || t7 === this.getNextSibling() || e(50);
     const o8 = this.__key, r7 = t7.__key, i6 = this.__text, s7 = i6.length;
     Gc() === r7 && Yc(o8);
-    const l8 = fs8();
+    const l8 = fs9();
     if (zi(l8)) {
       const e5 = l8.anchor, i7 = l8.focus;
       null !== e5 && e5.key === r7 && ys(e5, n7, o8, t7, s7), null !== i7 && i7.key === r7 && ys(i7, n7, o8, t7, s7);
@@ -39530,7 +39763,7 @@ var Ii = class _Ii {
   }
   deleteNodes() {
     const t7 = this.getNodes().filter((t8) => null === Of(t8));
-    if ((fs8() || ds()) === this && t7[0]) {
+    if ((fs9() || ds()) === this && t7[0]) {
       const e5 = ad(t7[0], "next");
       Kl(vd(e5, e5));
     }
@@ -39540,7 +39773,7 @@ var Ii = class _Ii {
 };
 function Li() {
   const t7 = ra();
-  if (0 === t7.getChildrenSize() && null === Df(fs8())) {
+  if (0 === t7.getChildrenSize() && null === Df(fs9())) {
     const e5 = oc();
     t7.append(e5), e5.select();
   }
@@ -39667,8 +39900,8 @@ var Ki = class _Ki {
         else {
           const t8 = vi(r7.getTextContent());
           t8.setFormat(n7), t8.setStyle(o8);
-          const e6 = fs8() === this;
-          r7.replace(t8), this.setTextNodeRange(t8, i6, t8, i6), e6 && fs8() !== this && sa(this);
+          const e6 = fs9() === this;
+          r7.replace(t8), this.setTextNodeRange(t8, i6, t8, i6), e6 && fs9() !== this && sa(this);
         }
         return void ("" !== t7 && this.insertText(t7));
       }
@@ -39703,14 +39936,14 @@ var Ki = class _Ki {
     r7.spliceText(i6, 0, t7, true), r7.isComposing() && "text" === this.anchor.type && this.anchor.set(this.anchor.key, this.anchor.offset - t7.length, this.anchor.type);
   }
   removeText() {
-    const t7 = fs8() === this, e5 = this.anchor.key;
+    const t7 = fs9() === this, e5 = this.anchor.key;
     Bl(this, Ul(Rl(this))), this.isCollapsed() && (function(t8, e6) {
       const n7 = t8.anchor;
       if (n7.key === e6) return;
       const o8 = n7.getNode();
       let r7 = 0, i6 = "";
       ki(o8) ? (r7 = o8.getFormat(), i6 = o8.getStyle()) : yl(o8) && (r7 = o8.getTextFormat(), i6 = o8.getTextStyle()), t8.format === r7 && t8.style === i6 || (t8.format = r7, t8.style = i6, t8.dirty = true);
-    })(this, e5), t7 && fs8() !== this && sa(this);
+    })(this, e5), t7 && fs9() !== this && sa(this);
   }
   formatText(t7, e5 = null) {
     $i(this, t7, e5);
@@ -39727,7 +39960,7 @@ var Ki = class _Ki {
       }
       if (null !== o9) {
         o9.selectStart();
-        const n8 = fs8();
+        const n8 = fs9();
         return zi(n8) || e(369), n8.insertNodes(t7);
       }
     }
@@ -40321,7 +40554,7 @@ function us(t7, e5, n7, o8) {
   const x9 = new Ki(g8, _5, y5, m11);
   return p7 && (x9.dirty = true), x9;
 }
-function fs8() {
+function fs9() {
   return js()._selection;
 }
 function ds() {
@@ -40491,7 +40724,7 @@ function Ss(t7, e5, n7, o8, r7, i6) {
   }
 }
 function Cs(t7) {
-  let e5 = fs8() || ds();
+  let e5 = fs9() || ds();
   null === e5 && (e5 = ra().selectEnd()), e5.insertNodes(t7);
 }
 function vs(t7, e5) {
@@ -40502,7 +40735,7 @@ function ks(t7) {
   return vs(t7, { linebreak: () => e5.push(Al()), tab: () => e5.push(wi()), text: (t8) => e5.push(vi(t8)) }), e5;
 }
 function bs() {
-  const t7 = fs8();
+  const t7 = fs9();
   return null === t7 ? "" : t7.getTextContent();
 }
 function Ts(t7) {
@@ -40513,7 +40746,7 @@ function Ts(t7) {
 function Ns(t7, n7 = false) {
   let o8 = t7;
   t7.isCollapsed() || o8.removeText();
-  const r7 = fs8();
+  const r7 = fs9();
   zi(r7) && (o8 = r7), zi(o8) || e(161);
   const i6 = o8.anchor;
   let s7 = i6.getNode(), l8 = i6.offset;
@@ -41196,7 +41429,7 @@ var pl = class extends Fr {
   }
   select(t7, e5) {
     Ws();
-    const n7 = fs8();
+    const n7 = fs9();
     let o8 = t7, r7 = e5;
     const i6 = this.getChildrenSize();
     if (!this.canBeEmpty()) {
@@ -41293,7 +41526,7 @@ var pl = class extends Fr {
       } else t8.__prev = null;
     }
     if (i6.__size = f6, c10.length) {
-      const t8 = fs8();
+      const t8 = fs9();
       if (zi(t8)) {
         const e5 = new Set(c10), n8 = new Set(l8), { anchor: o9, focus: r8 } = t8;
         ml(o9, e5, n8) && ps(o9, o9.getNode(), this, u8, a5), ml(r8, e5, n8) && ps(r8, r8.getNode(), this, u8, a5), 0 !== f6 || this.canBeEmpty() || Va(this) || this.remove();
@@ -41576,7 +41809,7 @@ function zl(t7, n7) {
   nd(n7) ? t7.set(o8.getKey(), n7.offset, "text") : rd(n7) ? ki(o8) ? t7.set(o8.getKey(), fd(o8, r7), "text") : t7.set(o8.getParentOrThrow().getKey(), o8.getIndexWithinParent() + (i6 ? 1 : 0), "element") : (id(n7) && yl(o8) || e(268), t7.set(o8.getKey(), i6 ? 0 : o8.getChildrenSize(), "element"));
 }
 function Kl(t7) {
-  const e5 = fs8(), n7 = zi(e5) ? e5 : ls();
+  const e5 = fs9(), n7 = zi(e5) ? e5 : ls();
   return Bl(n7, t7), sa(n7), n7;
 }
 function Bl(t7, e5) {
@@ -42196,7 +42429,7 @@ var vc = class {
   focus(t7, e5 = {}) {
     const n7 = this._rootElement;
     null !== n7 && (n7.setAttribute("autocapitalize", "off"), al(this, () => {
-      const o8 = fs8(), r7 = ra();
+      const o8 = fs9(), r7 = ra();
       null !== o8 ? o8.dirty || sa(o8.clone()) : 0 !== r7.getChildrenSize() && ("rootStart" === e5.defaultSelection ? r7.selectStart() : r7.selectEnd()), za("focus"), Ka(() => {
         n7.removeAttribute("autocapitalize"), t7 && t7();
       });
@@ -42458,7 +42691,7 @@ function ga(t7, e5, n7, o8, r7) {
     }
     const c10 = i6.getTextContent();
     if (r7 || l8 !== c10) {
-      const e6 = fs8();
+      const e6 = fs9();
       if ("" === l8) {
         if (Yc(null), p || g || x) i6.remove();
         else {
@@ -44152,10 +44385,10 @@ function _loadWasmModule(sync, filepath, src, imports2) {
   var buf = null;
   var isNode2 = typeof process !== "undefined" && process.versions != null && process.versions.node != null;
   if (filepath && isNode2) {
-    var fs27 = null;
-    var path21 = null;
+    var fs28 = null;
+    var path22 = null;
     return new Promise((resolve, reject) => {
-      fs27.readFile(path21.resolve(__dirname, filepath), (error, buffer) => {
+      fs28.readFile(path22.resolve(__dirname, filepath), (error, buffer) => {
         if (error != null) {
           reject(error);
         } else {
@@ -45458,10 +45691,10 @@ var LoroDoc = class _LoroDoc {
    * @param {string} path
    * @returns {Value | Container | undefined}
    */
-  getByPath(path21) {
+  getByPath(path22) {
     try {
       const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
-      const ptr0 = passStringToWasm0(path21, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+      const ptr0 = passStringToWasm0(path22, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
       const len0 = WASM_VECTOR_LEN;
       wasm.lorodoc_getByPath(retptr, this.__wbg_ptr, ptr0, len0);
       var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
@@ -87436,7 +87669,7 @@ async function readText(file) {
   }
 }
 async function writeAtomic(file, data) {
-  await import_promises.default.mkdir(import_node_path7.default.dirname(file), { recursive: true });
+  await import_promises.default.mkdir(import_node_path8.default.dirname(file), { recursive: true });
   const tmp = `${file}.${process.pid}.tmp`;
   await import_promises.default.writeFile(tmp, data);
   await import_promises.default.rename(tmp, file);
@@ -87645,13 +87878,13 @@ function outcomeWarnings(outcome, streaming) {
 function createDocumentRegistry(options) {
   const sessions = /* @__PURE__ */ new Map();
   const warnings = /* @__PURE__ */ new Map();
-  const docFile = (id2) => import_node_path8.default.join(options.root, "document", id2, "doc.xml");
+  const docFile = (id2) => import_node_path9.default.join(options.root, "document", id2, "doc.xml");
   const commentStores = /* @__PURE__ */ new Map();
   const cursors = createCommentCursors(options.stateDir);
   const commentStore = (id2) => {
     let store = commentStores.get(id2);
     if (!store) {
-      store = createCommentStore(import_node_path8.default.join(options.root, "document", id2, "comments.json"), options.names);
+      store = createCommentStore(import_node_path9.default.join(options.root, "document", id2, "comments.json"), options.names);
       commentStores.set(id2, store);
     }
     return store;
@@ -87665,10 +87898,10 @@ function createDocumentRegistry(options) {
     if (JSON.stringify(store.warnings()) !== before2) options.onWarningsChange(id2);
   };
   const create3 = async (id2) => {
-    if (!import_node_fs8.default.existsSync(docFile(id2))) return null;
+    if (!import_node_fs9.default.existsSync(docFile(id2))) return null;
     const session = await createDocumentSession({
       file: docFile(id2),
-      snapshotFile: import_node_path8.default.join(options.stateDir, "document", id2, "doc.loro"),
+      snapshotFile: import_node_path9.default.join(options.stateDir, "document", id2, "doc.loro"),
       ...options.timing,
       log: options.log
     });
@@ -87711,7 +87944,7 @@ function createDocumentRegistry(options) {
       const known = sessions.has(id2);
       void open(id2).then((session) => {
         if (!session || !known) return;
-        import_node_fs8.default.readFile(docFile(id2), "utf8", (err, text2) => {
+        import_node_fs9.default.readFile(docFile(id2), "utf8", (err, text2) => {
           if (!err) session.onFileText(text2);
         });
       });
@@ -87746,7 +87979,7 @@ function createDocumentRegistry(options) {
 }
 
 // src/inspector/runtime.ts
-function installInspector(win, properties) {
+function installInspector(win, properties, commentCursor = "crosshair") {
   const doc = win.document;
   const session = `${Date.now().toString(36)}-${Math.random().toString(36).slice(2)}`;
   const ids = /* @__PURE__ */ new WeakMap();
@@ -87755,6 +87988,7 @@ function installInspector(win, properties) {
   const ignored2 = /* @__PURE__ */ new Set(["SCRIPT", "STYLE", "META", "LINK", "NOSCRIPT", "HEAD"]);
   let nextId = 0;
   let enabled = false;
+  let mode = "select";
   let connection = "";
   let selected = null;
   let treeTimer = 0;
@@ -87926,6 +88160,7 @@ function installInspector(win, properties) {
       suppressClick = false;
       return;
     }
+    if (mode === "comment") return;
     selected = event.target.closest("svg") || event.target;
     selection("user", event.shiftKey || event.metaKey || event.ctrlKey);
   };
@@ -87985,7 +88220,7 @@ function installInspector(win, properties) {
   };
   const key2 = (event) => {
     if (!enabled || event.composedPath().some((target) => target instanceof win.Element && target.matches("input,textarea,select,[contenteditable]"))) return;
-    if (!["Space", "KeyH", "KeyV", "Escape", "Equal", "Minus", "Digit0", "Digit1"].includes(event.code)) return;
+    if (!["Space", "KeyH", "KeyV", "KeyC", "Escape", "Equal", "Minus", "Digit0", "Digit1"].includes(event.code)) return;
     event.preventDefault();
     event.stopImmediatePropagation();
     post("key", { key: event.key, code: event.code, down: event.type === "keydown", ctrlKey: event.ctrlKey, metaKey: event.metaKey, shiftKey: event.shiftKey, altKey: event.altKey });
@@ -88028,6 +88263,11 @@ function installInspector(win, properties) {
       disable();
       return;
     }
+    if (data.action === "mode" && (data.mode === "select" || data.mode === "comment")) {
+      mode = data.mode;
+      cursor.textContent = `*{cursor:${mode === "comment" ? commentCursor : "default"}!important}`;
+      return;
+    }
     if (!enabled && data.action !== "reset") return;
     if (data.session !== session) return;
     if (data.action === "cancel-drag") {
@@ -88156,6 +88396,8 @@ var INSPECTOR_PROPERTIES = [
   "color",
   "box-shadow"
 ];
+var COMMENT_CURSOR_SVG = "<svg xmlns='http://www.w3.org/2000/svg' width='26' height='26' viewBox='0 0 26 26'><path d='M2 24V13a11 11 0 1 1 11 11z' fill='white' stroke='black' stroke-width='1.5' stroke-linejoin='round'/><path d='M13 8.5v9M8.5 13h9' stroke='black' stroke-width='1.8' stroke-linecap='round'/></svg>";
+var COMMENT_CURSOR = `url("data:image/svg+xml,${encodeURIComponent(COMMENT_CURSOR_SVG)}") 2 24, crosshair`;
 
 // src/server/inject.ts
 var RUNTIME = `(() => {
@@ -88266,7 +88508,7 @@ var EMBEDDED_STYLE = "<style>:root{color-scheme:light dark;background:transparen
 var UI_MARKER = /<ryugi-[a-z0-9-]+(?:\s|>)/i;
 var UI_META = /<meta[^>]+name=["']ryugi-ui["'][^>]*>/i;
 function injectRuntime(html, options = {}) {
-  const inspect = options.inspector ? `;(${installInspector.toString().replace(/\n/g, " ")})(window,${JSON.stringify(INSPECTOR_PROPERTIES)});` : "";
+  const inspect = options.inspector ? `;(${installInspector.toString().replace(/\n/g, " ")})(window,${JSON.stringify(INSPECTOR_PROPERTIES)},${JSON.stringify(COMMENT_CURSOR)});` : "";
   const tag = `${options.embedded ? EMBEDDED_STYLE : ""}<script>${inspect || RUNTIME_LINE}</script>`;
   const ui2 = options.uiRuntimeUrl && !options.inspector && (UI_MARKER.test(html) || UI_META.test(html)) ? `<script defer src="${options.uiRuntimeUrl.replace(/"/g, "&quot;")}"></script>` : "";
   const head = HEAD.exec(html);
@@ -88275,9 +88517,9 @@ function injectRuntime(html, options = {}) {
 }
 
 // src/server/http.ts
-var import_node_crypto2 = __toESM(require("node:crypto"), 1);
-var import_node_fs9 = __toESM(require("node:fs"), 1);
-var import_node_path9 = __toESM(require("node:path"), 1);
+var import_node_crypto3 = __toESM(require("node:crypto"), 1);
+var import_node_fs10 = __toESM(require("node:fs"), 1);
+var import_node_path10 = __toESM(require("node:path"), 1);
 var MIME2 = {
   ".html": "text/html; charset=utf-8",
   ".js": "text/javascript; charset=utf-8",
@@ -88300,12 +88542,12 @@ var MIME2 = {
   ".mp4": "video/mp4",
   ".webm": "video/webm"
 };
-var mimeOf = (file) => MIME2[import_node_path9.default.extname(file).toLowerCase()] ?? "application/octet-stream";
-var randomToken = () => import_node_crypto2.default.randomBytes(24).toString("base64url");
+var mimeOf = (file) => MIME2[import_node_path10.default.extname(file).toLowerCase()] ?? "application/octet-stream";
+var randomToken = () => import_node_crypto3.default.randomBytes(24).toString("base64url");
 function safeEqual(a5, b6) {
   const ab = Buffer.from(a5);
   const bb = Buffer.from(b6);
-  return ab.length === bb.length && import_node_crypto2.default.timingSafeEqual(ab, bb);
+  return ab.length === bb.length && import_node_crypto3.default.timingSafeEqual(ab, bb);
 }
 function parseCookies(header) {
   const cookies = {};
@@ -88317,7 +88559,7 @@ function parseCookies(header) {
 }
 function readPersisted(file) {
   try {
-    return import_node_fs9.default.readFileSync(file, "utf8").trim();
+    return import_node_fs10.default.readFileSync(file, "utf8").trim();
   } catch {
     return "";
   }
@@ -88346,15 +88588,15 @@ function sendJson(res, status, value) {
   send(res, status, JSON.stringify(value), { "Content-Type": MIME2[".json"] });
 }
 function sendFile(res, file, headers = {}) {
-  import_node_fs9.default.readFile(file, (err, data) => {
+  import_node_fs10.default.readFile(file, (err, data) => {
     if (err) send(res, 404, "Not found");
     else send(res, 200, data, { "Content-Type": mimeOf(file), ...headers });
   });
 }
 
 // src/server/dynamic-blocks.ts
-var import_node_fs10 = __toESM(require("node:fs"), 1);
-var import_node_path10 = __toESM(require("node:path"), 1);
+var import_node_fs11 = __toESM(require("node:fs"), 1);
+var import_node_path11 = __toESM(require("node:path"), 1);
 function dynamicUrls(xml) {
   const urls = /* @__PURE__ */ new Set();
   for (const match of stripOpaque(xml).matchAll(TAG)) {
@@ -88367,7 +88609,7 @@ function dynamicUrls(xml) {
 }
 var mtimeOf = (file) => {
   try {
-    return import_node_fs10.default.statSync(file).mtimeMs;
+    return import_node_fs11.default.statSync(file).mtimeMs;
   } catch {
     return -1;
   }
@@ -88384,7 +88626,7 @@ function createDynamicBlocks(limits) {
   };
   const entry = (id2, dir, file) => {
     const map = files(id2);
-    const mtime = mtimeOf(import_node_path10.default.join(dir, file));
+    const mtime = mtimeOf(import_node_path11.default.join(dir, file));
     let state = map.get(file);
     if (!state || state.mtime !== mtime) {
       state = { mtime, errors: [], ran: false };
@@ -88409,19 +88651,19 @@ function createDynamicBlocks(limits) {
     state(id2, dir) {
       let xml = "";
       try {
-        xml = import_node_fs10.default.readFileSync(import_node_path10.default.join(dir, "doc.xml"), "utf8");
+        xml = import_node_fs11.default.readFileSync(import_node_path11.default.join(dir, "doc.xml"), "utf8");
       } catch {
         return { warnings: [], dynamic: {} };
       }
       const urls = dynamicUrls(xml);
       const map = files(id2);
       for (const [file, state] of map) {
-        if (!urls.includes(file) || state.mtime !== mtimeOf(import_node_path10.default.join(dir, file))) map.delete(file);
+        if (!urls.includes(file) || state.mtime !== mtimeOf(import_node_path11.default.join(dir, file))) map.delete(file);
       }
       const warnings = [];
       const dynamic = {};
       for (const url of urls) {
-        if (!import_node_fs10.default.existsSync(import_node_path10.default.join(dir, url))) warnings.push(`${url} not found`);
+        if (!import_node_fs11.default.existsSync(import_node_path11.default.join(dir, url))) warnings.push(`${url} not found`);
         const state = map.get(url);
         for (const error of state?.errors ?? []) warnings.push(`runtime: ${url}: ${error}`);
         dynamic[url] = { ran: state?.ran ?? false };
@@ -88432,8 +88674,8 @@ function createDynamicBlocks(limits) {
 }
 
 // src/server/selection.ts
-var import_node_fs11 = __toESM(require("node:fs"), 1);
-var import_node_path11 = __toESM(require("node:path"), 1);
+var import_node_fs12 = __toESM(require("node:fs"), 1);
+var import_node_path12 = __toESM(require("node:path"), 1);
 
 // src/shared/selection.ts
 var SELECTION_FULL_NODES = 20;
@@ -88508,14 +88750,14 @@ function readAnySelection(value) {
 function createSelectionStore(stateDir, exists) {
   const tabs = /* @__PURE__ */ new Map();
   let clock = 0;
-  const fileOf = (kind, id2) => import_node_path11.default.join(stateDir, kind, id2, "selection.json");
+  const fileOf = (kind, id2) => import_node_path12.default.join(stateDir, kind, id2, "selection.json");
   const write = (kind, id2) => {
     let winner;
     for (const tab of tabs.values()) {
       if (tab.kind !== kind || tab.id !== id2) continue;
       if (!winner || tab.humanAt > winner.humanAt || tab.humanAt === winner.humanAt && tab.seenAt > winner.seenAt) winner = tab;
     }
-    if (!winner?.state) import_node_fs11.default.rmSync(fileOf(kind, id2), { force: true });
+    if (!winner?.state) import_node_fs12.default.rmSync(fileOf(kind, id2), { force: true });
     else writeJsonAtomic(fileOf(kind, id2), { artifact: `${kind}/${id2}`, updatedAt: (/* @__PURE__ */ new Date()).toISOString(), ...winner.state });
   };
   return {
@@ -88546,19 +88788,19 @@ function createSelectionStore(stateDir, exists) {
       for (const kind of ["artboard", "document"]) {
         let ids = [];
         try {
-          ids = import_node_fs11.default.readdirSync(import_node_path11.default.join(stateDir, kind));
+          ids = import_node_fs12.default.readdirSync(import_node_path12.default.join(stateDir, kind));
         } catch {
           continue;
         }
-        for (const id2 of ids) import_node_fs11.default.rmSync(fileOf(kind, id2), { force: true });
+        for (const id2 of ids) import_node_fs12.default.rmSync(fileOf(kind, id2), { force: true });
       }
     }
   };
 }
 
 // src/server/config.ts
-var import_node_fs12 = __toESM(require("node:fs"), 1);
-var import_node_path12 = __toESM(require("node:path"), 1);
+var import_node_fs13 = __toESM(require("node:fs"), 1);
+var import_node_path13 = __toESM(require("node:path"), 1);
 
 // src/shared/cloud.ts
 var ownLink = (url, hostId) => hostId ? `${url}#ryugi-host=${hostId}` : url;
@@ -88593,7 +88835,7 @@ function normalize(raw) {
 function readConfig(file) {
   let text2;
   try {
-    text2 = import_node_fs12.default.readFileSync(file, "utf8");
+    text2 = import_node_fs13.default.readFileSync(file, "utf8");
   } catch {
     return { config: defaults() };
   }
@@ -88604,22 +88846,22 @@ function readConfig(file) {
   }
 }
 function ensureGitignore(dir) {
-  const file = import_node_path12.default.join(dir, ".gitignore");
+  const file = import_node_path13.default.join(dir, ".gitignore");
   let current = "";
   try {
-    current = import_node_fs12.default.readFileSync(file, "utf8");
+    current = import_node_fs13.default.readFileSync(file, "utf8");
   } catch {
-    import_node_fs12.default.writeFileSync(file, "config.json\n");
+    import_node_fs13.default.writeFileSync(file, "config.json\n");
     return;
   }
   if (current.split(/\r?\n/).some((line) => line.trim() === "config.json")) return;
-  import_node_fs12.default.writeFileSync(file, `${current}${current === "" || current.endsWith("\n") ? "" : "\n"}config.json
+  import_node_fs13.default.writeFileSync(file, `${current}${current === "" || current.endsWith("\n") ? "" : "\n"}config.json
 `);
 }
 function ensureConfig(file) {
-  import_node_fs12.default.mkdirSync(import_node_path12.default.dirname(file), { recursive: true });
-  ensureGitignore(import_node_path12.default.dirname(file));
-  if (!import_node_fs12.default.existsSync(file)) writeJsonAtomic(file, defaults());
+  import_node_fs13.default.mkdirSync(import_node_path13.default.dirname(file), { recursive: true });
+  ensureGitignore(import_node_path13.default.dirname(file));
+  if (!import_node_fs13.default.existsSync(file)) writeJsonAtomic(file, defaults());
 }
 function updateArtifactConfig(file, key2, patch) {
   const { config, warning } = readConfig(file);
@@ -88639,21 +88881,21 @@ function setProjectAutoPublish(file, value) {
   if (warning) throw new Error(warning);
   if (value === null) delete config.autoPublish;
   else config.autoPublish = value;
-  import_node_fs12.default.mkdirSync(import_node_path12.default.dirname(file), { recursive: true });
+  import_node_fs13.default.mkdirSync(import_node_path13.default.dirname(file), { recursive: true });
   writeJsonAtomic(file, config);
 }
 
 // src/server/credentials.ts
-var import_node_fs13 = __toESM(require("node:fs"), 1);
-var import_node_path13 = __toESM(require("node:path"), 1);
+var import_node_fs14 = __toESM(require("node:fs"), 1);
+var import_node_path14 = __toESM(require("node:path"), 1);
 function credentialsFile(env, platform, home) {
-  if (platform === "win32" && env.APPDATA) return import_node_path13.default.join(env.APPDATA, "ryugi", "credentials.json");
-  return import_node_path13.default.join(env.XDG_CONFIG_HOME || import_node_path13.default.join(home, ".config"), "ryugi", "credentials.json");
+  if (platform === "win32" && env.APPDATA) return import_node_path14.default.join(env.APPDATA, "ryugi", "credentials.json");
+  return import_node_path14.default.join(env.XDG_CONFIG_HOME || import_node_path14.default.join(home, ".config"), "ryugi", "credentials.json");
 }
 function readCredentials(file, origin) {
   let raw;
   try {
-    raw = JSON.parse(import_node_fs13.default.readFileSync(file, "utf8"));
+    raw = JSON.parse(import_node_fs14.default.readFileSync(file, "utf8"));
   } catch {
     return null;
   }
@@ -88664,11 +88906,11 @@ function readCredentials(file, origin) {
   return { origin: savedOrigin, token, login };
 }
 function writeCredentials(file, credentials) {
-  import_node_fs13.default.mkdirSync(import_node_path13.default.dirname(file), { recursive: true, mode: 448 });
+  import_node_fs14.default.mkdirSync(import_node_path14.default.dirname(file), { recursive: true, mode: 448 });
   writeJsonAtomic(file, credentials);
 }
 function clearCredentials(file) {
-  import_node_fs13.default.rmSync(file, { force: true });
+  import_node_fs14.default.rmSync(file, { force: true });
 }
 
 // node_modules/.pnpm/ws@8.18.3/node_modules/ws/wrapper.mjs
@@ -88796,7 +89038,7 @@ function createRelayClient(options) {
 }
 
 // src/server/ws.ts
-var import_node_crypto3 = __toESM(require("node:crypto"), 1);
+var import_node_crypto4 = __toESM(require("node:crypto"), 1);
 var WS_MAGIC = "258EAFA5-E914-47DA-95CA-C5AB0DC85B11";
 var OPCODE_TEXT = 1;
 var OPCODE_CLOSE = 8;
@@ -88804,7 +89046,7 @@ var OPCODE_PING = 9;
 var OPCODE_PONG = 10;
 var MAX_CLIENT_FRAME = 8 * 1024 * 1024;
 function acceptKey(clientKey) {
-  return import_node_crypto3.default.createHash("sha1").update(clientKey + WS_MAGIC).digest("base64");
+  return import_node_crypto4.default.createHash("sha1").update(clientKey + WS_MAGIC).digest("base64");
 }
 function encodeFrame(opcode, payload) {
   const len = payload.length;
@@ -88929,21 +89171,21 @@ function createDirectRelay(options) {
 }
 
 // src/server/host-id.ts
-var import_node_fs14 = __toESM(require("node:fs"), 1);
-var import_node_path14 = __toESM(require("node:path"), 1);
+var import_node_fs15 = __toESM(require("node:fs"), 1);
+var import_node_path15 = __toESM(require("node:path"), 1);
 function hostIdFor(credentialsFile2) {
-  const file = import_node_path14.default.join(import_node_path14.default.dirname(credentialsFile2), "host-id");
+  const file = import_node_path15.default.join(import_node_path15.default.dirname(credentialsFile2), "host-id");
   const saved = readPersisted(file);
   if (/^[A-Za-z0-9_-]{16,64}$/.test(saved)) return saved;
   const id2 = randomToken();
-  import_node_fs14.default.mkdirSync(import_node_path14.default.dirname(file), { recursive: true, mode: 448 });
-  import_node_fs14.default.writeFileSync(file, `${id2}
+  import_node_fs15.default.mkdirSync(import_node_path15.default.dirname(file), { recursive: true, mode: 448 });
+  import_node_fs15.default.writeFileSync(file, `${id2}
 `, { mode: 384 });
   return id2;
 }
 
 // src/server/avatars.ts
-var import_node_crypto4 = require("node:crypto");
+var import_node_crypto5 = require("node:crypto");
 var AVATAR_ROUTE = /^\/api\/avatar\/([a-z]+)\/([^/]+)$/;
 var MAX_BYTES = 512 * 1024;
 var TIMEOUT_MS = 5e3;
@@ -88952,7 +89194,7 @@ var SOURCES = {
   gravatar: { valid: /^[0-9a-f]{64}$/, url: (id2) => `https://gravatar.com/avatar/${id2}?s=64&d=404` }
 };
 var githubAvatar = (login) => `/api/avatar/github/${login}`;
-var gravatarAvatar = (email) => `/api/avatar/gravatar/${(0, import_node_crypto4.createHash)("sha256").update(email.trim().toLowerCase()).digest("hex")}`;
+var gravatarAvatar = (email) => `/api/avatar/gravatar/${(0, import_node_crypto5.createHash)("sha256").update(email.trim().toLowerCase()).digest("hex")}`;
 function createAvatars(fetchImpl = fetch) {
   const cache = /* @__PURE__ */ new Map();
   const fetchAvatar = async (url) => {
@@ -88984,7 +89226,7 @@ function createAvatars(fetchImpl = fetch) {
 }
 
 // src/server/cloud.ts
-var import_node_crypto5 = __toESM(require("node:crypto"), 1);
+var import_node_crypto6 = __toESM(require("node:crypto"), 1);
 
 // src/shared/brand.ts
 var RYUGI_MARK_VIEWBOX = "0 0 512 512";
@@ -89094,32 +89336,32 @@ function callbackPage(result) {
 }
 
 // src/server/pack.ts
-var import_node_fs15 = __toESM(require("node:fs"), 1);
-var import_node_path15 = __toESM(require("node:path"), 1);
+var import_node_fs16 = __toESM(require("node:fs"), 1);
+var import_node_path16 = __toESM(require("node:path"), 1);
 var MAX_ARTIFACT_BYTES = 20 * 1024 * 1024;
 function formatBytes(bytes) {
   if (bytes < 1024) return `${bytes} B`;
   if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)} KB`;
   return `${(bytes / 1024 / 1024).toFixed(1)} MB`;
 }
-var excluded = (type, relative) => type === "document" && relative === "comments.json";
+var excluded = (type, relative) => (type === "document" || type === "artboard") && relative === "comments.json";
 function packArtifact(dir, type, { maxBytes = MAX_ARTIFACT_BYTES } = {}) {
-  const rootReal = import_node_fs15.default.realpathSync(dir);
+  const rootReal = import_node_fs16.default.realpathSync(dir);
   const found = [];
   const visited = /* @__PURE__ */ new Set([rootReal]);
   let total = 0;
   const walk = (current) => {
-    for (const entry of import_node_fs15.default.readdirSync(current, { withFileTypes: true })) {
+    for (const entry of import_node_fs16.default.readdirSync(current, { withFileTypes: true })) {
       if (entry.name.startsWith(".")) continue;
-      const full = import_node_path15.default.join(current, entry.name);
+      const full = import_node_path16.default.join(current, entry.name);
       let real;
       try {
-        real = import_node_fs15.default.realpathSync(full);
+        real = import_node_fs16.default.realpathSync(full);
       } catch {
         continue;
       }
-      if (!real.startsWith(rootReal + import_node_path15.default.sep)) continue;
-      const stat = import_node_fs15.default.statSync(real);
+      if (!real.startsWith(rootReal + import_node_path16.default.sep)) continue;
+      const stat = import_node_fs16.default.statSync(real);
       if (stat.isDirectory()) {
         if (visited.has(real)) continue;
         visited.add(real);
@@ -89127,7 +89369,7 @@ function packArtifact(dir, type, { maxBytes = MAX_ARTIFACT_BYTES } = {}) {
         continue;
       }
       if (!stat.isFile()) continue;
-      const relative = import_node_path15.default.relative(dir, full).split(import_node_path15.default.sep).join("/");
+      const relative = import_node_path16.default.relative(dir, full).split(import_node_path16.default.sep).join("/");
       if (excluded(type, relative)) continue;
       total += stat.size;
       found.push({ path: relative, real });
@@ -89137,12 +89379,12 @@ function packArtifact(dir, type, { maxBytes = MAX_ARTIFACT_BYTES } = {}) {
   if (total > maxBytes) {
     throw new Error(`artifact is ${formatBytes(total)}; the limit is ${formatBytes(maxBytes)}`);
   }
-  return found.map((file) => ({ path: file.path, data: import_node_fs15.default.readFileSync(file.real) }));
+  return found.map((file) => ({ path: file.path, data: import_node_fs16.default.readFileSync(file.real) }));
 }
 
 // src/server/publish-payload.ts
-var import_node_fs16 = __toESM(require("node:fs"), 1);
-var import_node_path16 = __toESM(require("node:path"), 1);
+var import_node_fs17 = __toESM(require("node:fs"), 1);
+var import_node_path17 = __toESM(require("node:path"), 1);
 var CLOUD_RUNTIME_URL = "/_ryugi/runtime/ryugi-ui.js";
 function sharedComments(file) {
   return {
@@ -89155,7 +89397,7 @@ function publishPayload(ref, dir, title, payload, comments = emptyComments()) {
     const { canvas, layout, versions } = payload;
     return { canvas, layout, versions };
   }
-  if (ref.type === "document") return { title, state: parseDocument2(import_node_fs16.default.readFileSync(import_node_path16.default.join(dir, "doc.xml"), "utf8")), comments: sharedComments(comments) };
+  if (ref.type === "document") return { title, state: parseDocument2(import_node_fs17.default.readFileSync(import_node_path17.default.join(dir, "doc.xml"), "utf8")), comments: sharedComments(comments) };
   return { title };
 }
 var isPage = (type, file) => type === "html" ? file === "index.html" : (type === "document" || type === "artboard") && file.endsWith(".html");
@@ -89166,12 +89408,12 @@ function withCloudRuntime(type, files) {
 }
 
 // src/server/settings.ts
-var import_node_fs17 = __toESM(require("node:fs"), 1);
-var import_node_path17 = __toESM(require("node:path"), 1);
-var settingsFileFor = (credentialsFile2) => import_node_path17.default.join(import_node_path17.default.dirname(credentialsFile2), "config.json");
+var import_node_fs18 = __toESM(require("node:fs"), 1);
+var import_node_path18 = __toESM(require("node:path"), 1);
+var settingsFileFor = (credentialsFile2) => import_node_path18.default.join(import_node_path18.default.dirname(credentialsFile2), "config.json");
 function readSettings(file) {
   try {
-    const raw = JSON.parse(import_node_fs17.default.readFileSync(file, "utf8"));
+    const raw = JSON.parse(import_node_fs18.default.readFileSync(file, "utf8"));
     return typeof raw === "object" && raw !== null && !Array.isArray(raw) ? raw : {};
   } catch {
     return {};
@@ -89182,7 +89424,7 @@ function readGlobalAutoPublish(file) {
   return typeof value === "boolean" ? value : void 0;
 }
 function writeGlobalAutoPublish(file, value) {
-  import_node_fs17.default.mkdirSync(import_node_path17.default.dirname(file), { recursive: true, mode: 448 });
+  import_node_fs18.default.mkdirSync(import_node_path18.default.dirname(file), { recursive: true, mode: 448 });
   writeJsonAtomic(file, { ...readSettings(file), autoPublish: value });
 }
 function defaultGlobalAutoPublish(file) {
@@ -89254,10 +89496,10 @@ function createCloudRoutes(options) {
     const state = randomToken();
     const verifier = randomToken();
     pendingStates.set(state, { expires: now + LOGIN_STATE_TTL_MS, verifier });
-    const challenge = import_node_crypto5.default.createHash("sha256").update(verifier).digest("base64url");
+    const challenge = import_node_crypto6.default.createHash("sha256").update(verifier).digest("base64url");
     return `${origin}/auth/cli?port=${options.port()}&state=${state}&challenge=${challenge}`;
   };
-  const cloudFetch = async (method, path21, body) => {
+  const cloudFetch = async (method, path22, body) => {
     const credentials = readCredentials(credentialsFile2, origin);
     if (!credentials) throw new SignedOut();
     const headers = { Authorization: `Bearer ${credentials.token}` };
@@ -89271,7 +89513,7 @@ function createCloudRoutes(options) {
     }
     let res;
     try {
-      res = await fetch(`${origin}${path21}`, { method, headers, body: payload });
+      res = await fetch(`${origin}${path22}`, { method, headers, body: payload });
     } catch (err) {
       throw new CloudRefused(502, `could not reach ${origin}: ${err.message}`);
     }
@@ -89328,9 +89570,9 @@ function createCloudRoutes(options) {
     }
     const key2 = `${ref.type}/${ref.id}`;
     const entry = artifactEntry(key2);
-    const hashed = files.map((file) => ({ ...file, hash: import_node_crypto5.default.createHash("sha256").update(file.data).digest("hex") }));
+    const hashed = files.map((file) => ({ ...file, hash: import_node_crypto6.default.createHash("sha256").update(file.data).digest("hex") }));
     const byHash = new Map(hashed.map((file) => [file.hash, file.data]));
-    const manifest = hashed.map(({ path: path21, hash }) => ({ path: path21, hash }));
+    const manifest = hashed.map(({ path: path22, hash }) => ({ path: path22, hash }));
     const version2 = (visibility) => ({ title: inspected.title, payload: inspected.payload, files: manifest, project, ...visibility ? { visibility } : {} });
     const create3 = () => createRecord2(ref, requested ?? entry.visibility ?? "private");
     const upload = async (id2, hashes) => {
@@ -89553,7 +89795,7 @@ function createCloudRoutes(options) {
 
 // src/server/comment-names.ts
 var import_node_child_process = require("node:child_process");
-var import_node_fs18 = __toESM(require("node:fs"), 1);
+var import_node_fs19 = __toESM(require("node:fs"), 1);
 
 // src/server/agent.ts
 var NAMES = {
@@ -89634,7 +89876,7 @@ function commentNames({ agentFile, projectDir, cloud }) {
     },
     agent: () => {
       try {
-        return detectAgent(JSON.parse(import_node_fs18.default.readFileSync(agentFile, "utf8")));
+        return detectAgent(JSON.parse(import_node_fs19.default.readFileSync(agentFile, "utf8")));
       } catch {
         return void 0;
       }
@@ -89662,8 +89904,8 @@ function viewerPage(template, page) {
 }
 
 // src/server/auto-publish.ts
-var import_node_crypto6 = __toESM(require("node:crypto"), 1);
-var import_node_fs19 = __toESM(require("node:fs"), 1);
+var import_node_crypto7 = __toESM(require("node:crypto"), 1);
+var import_node_fs20 = __toESM(require("node:fs"), 1);
 var SIGNED_OUT_MESSAGE = "auto-publish paused: the Ryugi Cloud sign-in expired";
 function isNotice(value) {
   if (typeof value !== "object" || value === null) return false;
@@ -89673,7 +89915,7 @@ function isNotice(value) {
 function readAutoPublishState(file) {
   let raw = {};
   try {
-    const parsed = JSON.parse(import_node_fs19.default.readFileSync(file, "utf8"));
+    const parsed = JSON.parse(import_node_fs20.default.readFileSync(file, "utf8"));
     if (typeof parsed === "object" && parsed !== null) raw = parsed;
   } catch {
   }
@@ -89693,7 +89935,7 @@ function createAutoPublisher(options) {
   const remarked = /* @__PURE__ */ new Set();
   const save = () => writeJsonAtomic(options.stateFile, { dirty: [...dirty], notice, paused });
   const raise = (kind, message) => {
-    if (notice?.kind !== kind) notice = { id: import_node_crypto6.default.randomUUID(), kind, message };
+    if (notice?.kind !== kind) notice = { id: import_node_crypto7.default.randomUUID(), kind, message };
   };
   const run2 = async () => {
     if (!options.enabled() || dirty.size === 0) return;
@@ -89753,7 +89995,7 @@ function createAutoPublisher(options) {
 }
 
 // src/server/artifact-file.ts
-var import_node_fs20 = __toESM(require("node:fs"), 1);
+var import_node_fs21 = __toESM(require("node:fs"), 1);
 var RESOLVE = { artboard: resolveBoardFile, document: resolveDocumentAsset, html: resolveHtmlFile };
 var isArtifactPage = (type, relative) => type === "html" ? relative === "index.html" : relative.endsWith(".html");
 function readArtifactFile(dir, type, relative, uiRuntimeUrl) {
@@ -89762,7 +90004,7 @@ function readArtifactFile(dir, type, relative, uiRuntimeUrl) {
   if (!target) return null;
   let data;
   try {
-    data = import_node_fs20.default.readFileSync(target);
+    data = import_node_fs21.default.readFileSync(target);
   } catch {
     return null;
   }
@@ -89772,25 +90014,25 @@ function readArtifactFile(dir, type, relative, uiRuntimeUrl) {
 }
 
 // src/server/watch.ts
-var import_node_fs21 = __toESM(require("node:fs"), 1);
-var import_node_path18 = __toESM(require("node:path"), 1);
-var toPosix = (file) => file.split(import_node_path18.default.sep).join("/");
+var import_node_fs22 = __toESM(require("node:fs"), 1);
+var import_node_path19 = __toESM(require("node:path"), 1);
+var toPosix = (file) => file.split(import_node_path19.default.sep).join("/");
 var ignored = (file) => file === ".state" || file.startsWith(".state/");
 function snapshot(root, dir = root, out = /* @__PURE__ */ new Map()) {
   let entries2;
   try {
-    entries2 = import_node_fs21.default.readdirSync(dir, { withFileTypes: true });
+    entries2 = import_node_fs22.default.readdirSync(dir, { withFileTypes: true });
   } catch {
     return out;
   }
   for (const entry of entries2) {
-    const full = import_node_path18.default.join(dir, entry.name);
-    const rel = toPosix(import_node_path18.default.relative(root, full));
+    const full = import_node_path19.default.join(dir, entry.name);
+    const rel = toPosix(import_node_path19.default.relative(root, full));
     if (ignored(rel)) continue;
     if (entry.isDirectory()) snapshot(root, full, out);
     else {
       try {
-        out.set(rel, import_node_fs21.default.statSync(full).mtimeMs);
+        out.set(rel, import_node_fs22.default.statSync(full).mtimeMs);
       } catch {
       }
     }
@@ -89823,7 +90065,7 @@ function watchTree(root, onChange, debounceMs = 120, backupPollMs = 1e3) {
     }, debounceMs);
   };
   try {
-    const watcher = import_node_fs21.default.watch(root, { recursive: true }, (_event, filename) => {
+    const watcher = import_node_fs22.default.watch(root, { recursive: true }, (_event, filename) => {
       if (filename) queue([toPosix(filename.toString())]);
     });
     watcher.on("error", () => {
@@ -89873,6 +90115,8 @@ var API_PREVIEW_ROUTE = /^\/api\/preview\/([^/]+)\/([^/]+)$/;
 var API_DOCUMENT_ROUTE = /^\/api\/document\/([^/]+)\/(state|update|comments)$/;
 var MAX_COMMENT_OP = 64 * 1024;
 var API_AGENT_COMMENTS_ROUTE = /^\/api\/agent\/document\/([^/]+)\/comments$/;
+var API_BOARD_COMMENTS_ROUTE = /^\/api\/artboard\/([^/]+)\/comments$/;
+var API_AGENT_BOARD_COMMENTS_ROUTE = /^\/api\/agent\/artboard\/([^/]+)\/comments$/;
 var MAX_DOCUMENT_UPDATE = 8 * 1024 * 1024;
 var MAX_RELAY_FILE = 8 * 1024 * 1024;
 var MAX_RUNTIME_MESSAGE = 2048;
@@ -89891,17 +90135,17 @@ function titleOf(payload, ref) {
   return payload.canvas?.title || ref.id;
 }
 async function startArtifactsServer(options) {
-  const root = import_node_path19.default.resolve(options.root);
-  const viewerDir = import_node_path19.default.resolve(options.viewerDir);
-  const runtimeDir = options.runtimeDir ? import_node_path19.default.resolve(options.runtimeDir) : null;
-  const stateDir = import_node_path19.default.join(root, ".state");
-  import_node_fs22.default.mkdirSync(stateDir, { recursive: true, mode: 448 });
-  import_node_fs22.default.writeFileSync(import_node_path19.default.join(stateDir, ".gitignore"), "*\n");
+  const root = import_node_path20.default.resolve(options.root);
+  const viewerDir = import_node_path20.default.resolve(options.viewerDir);
+  const runtimeDir = options.runtimeDir ? import_node_path20.default.resolve(options.runtimeDir) : null;
+  const stateDir = import_node_path20.default.join(root, ".state");
+  import_node_fs23.default.mkdirSync(stateDir, { recursive: true, mode: 448 });
+  import_node_fs23.default.writeFileSync(import_node_path20.default.join(stateDir, ".gitignore"), "*\n");
   if (options.configFile) ensureConfig(options.configFile);
-  const portFile = import_node_path19.default.join(stateDir, ".last-port");
-  const tokenFile = import_node_path19.default.join(stateDir, ".last-token");
+  const portFile = import_node_path20.default.join(stateDir, ".last-port");
+  const tokenFile = import_node_path20.default.join(stateDir, ".last-token");
   const token = readPersisted(tokenFile) || randomToken();
-  import_node_fs22.default.writeFileSync(tokenFile, `${token}
+  import_node_fs23.default.writeFileSync(tokenFile, `${token}
 `, { mode: 384 });
   const contentToken = randomToken();
   const runtimeWarnings = /* @__PURE__ */ new Map();
@@ -89931,7 +90175,8 @@ async function startArtifactsServer(options) {
     direct.emit(message.artifact, message);
   };
   const avatars = createAvatars(options.fetch);
-  const names = commentNames({ agentFile: import_node_path19.default.join(stateDir, "agent"), projectDir: import_node_path19.default.resolve(root, "../.."), cloud: options.cloud });
+  const names = commentNames({ agentFile: import_node_path20.default.join(stateDir, "agent"), projectDir: import_node_path20.default.resolve(root, "../.."), cloud: options.cloud });
+  const boardComments = createBoardCommentRegistry({ root, stateDir, broadcast, names });
   const documents = createDocumentRegistry({
     root,
     stateDir,
@@ -89969,8 +90214,8 @@ async function startArtifactsServer(options) {
     }
     return { dir, title, reasons, payload: published };
   };
-  const cloud = options.cloud && options.configFile ? createCloudRoutes({ ...options.cloud, configFile: options.configFile, project: import_node_path19.default.basename(import_node_path19.default.resolve(root, "../..")), port: () => port, inspect }) : null;
-  const autoPublisher = cloud ? createAutoPublisher({ stateFile: import_node_path19.default.join(stateDir, "auto-publish.json"), enabled: cloud.autoPublishEnabled, token: cloud.token, publish: cloud.autoPublish }) : null;
+  const cloud = options.cloud && options.configFile ? createCloudRoutes({ ...options.cloud, configFile: options.configFile, project: import_node_path20.default.basename(import_node_path20.default.resolve(root, "../..")), port: () => port, inspect }) : null;
+  const autoPublisher = cloud ? createAutoPublisher({ stateFile: import_node_path20.default.join(stateDir, "auto-publish.json"), enabled: cloud.autoPublishEnabled, token: cloud.token, publish: cloud.autoPublish }) : null;
   const sameOrigin = (req) => {
     const origin2 = req.headers.origin;
     const host = req.headers.host ?? "";
@@ -90049,7 +90294,7 @@ async function startArtifactsServer(options) {
   };
   const blockIdsOf = async (id2, dir) => {
     await (await documents.open(id2))?.flush();
-    const state = parseDocument2(import_node_fs22.default.readFileSync(import_node_path19.default.join(dir, "doc.xml"), "utf8"));
+    const state = parseDocument2(import_node_fs23.default.readFileSync(import_node_path20.default.join(dir, "doc.xml"), "utf8"));
     return new Set(state.root.children.flatMap((block) => block.$?.blockId ? [block.$.blockId] : []));
   };
   const serveAgentComments = async (req, res, id2) => {
@@ -90089,6 +90334,55 @@ async function startArtifactsServer(options) {
       sendJson(res, 400, { error: err.message });
     }
   };
+  const serveBoardComments = async (req, res, id2) => {
+    if (req.method !== "POST" || !sameOrigin(req)) {
+      send(res, 403, "Forbidden");
+      return;
+    }
+    if (!resolveArtifactDir(root, "artboard", id2)) {
+      sendJson(res, 404, { error: `artboard/${id2} not found` });
+      return;
+    }
+    const op = asBoardHumanOp(await readCommentBody(req));
+    if (!op) {
+      sendJson(res, 400, { error: "not a comment op" });
+      return;
+    }
+    sendJson(res, 200, boardComments.apply(id2, op));
+  };
+  const serveAgentBoardComments = async (req, res, id2) => {
+    const dir = resolveArtifactDir(root, "artboard", id2);
+    if (!dir) {
+      sendJson(res, 404, { error: `artboard/${id2} not found` });
+      return;
+    }
+    const body = await readCommentBody(req);
+    const fields = typeof body === "object" && body !== null ? body : {};
+    const agent = typeof fields.agent === "string" && fields.agent.length > 0 && fields.agent.length <= 100 ? fields.agent : void 0;
+    if (fields.op === "list") {
+      sendJson(res, 200, { type: "comments", artifact: `artboard/${id2}`, threads: boardComments.list(id2, agent ?? "Agent", fields.all === true) });
+      return;
+    }
+    const shorthand = agentAddOnBoard(body, boardSpecs(dir));
+    if (shorthand && "error" in shorthand) {
+      sendJson(res, 400, { error: `${shorthand.error} in artboard/${id2}` });
+      return;
+    }
+    const op = shorthand ?? asBoardAgentOp(body);
+    if (!op) {
+      sendJson(res, 400, { error: "not an agent comment op: use list, add {anchor: {page, board, x, y}, text}, reply {threadId, text} or resolve {threadId}; text must not be empty" });
+      return;
+    }
+    if (op.op === "add" && op.anchor.board && !(op.anchor.board in boardFiles(dir))) {
+      sendJson(res, 400, { error: `no board ${op.anchor.board} in artboard/${id2}` });
+      return;
+    }
+    try {
+      sendJson(res, 200, boardComments.applyAgent(id2, op, agent));
+    } catch (err) {
+      sendJson(res, 400, { error: err.message });
+    }
+  };
   const isAuthorized = (req, keyFromQuery) => keyFromQuery !== null && safeEqual(keyFromQuery, token) || safeEqual(parseCookies(req.headers.cookie)[cookieName] ?? "", token);
   const serveContent = (res, rest) => {
     if (rest.startsWith("runtime/")) {
@@ -90129,7 +90423,7 @@ async function startArtifactsServer(options) {
       sendFile(res, target, headers);
       return;
     }
-    import_node_fs22.default.readFile(target, "utf8", (err, source) => {
+    import_node_fs23.default.readFile(target, "utf8", (err, source) => {
       if (err) send(res, 404, "Not found");
       else {
         const uiRuntimeUrl = runtimeDir ? `${contentPrefix}runtime/ryugi-ui.js` : void 0;
@@ -90140,6 +90434,7 @@ async function startArtifactsServer(options) {
   const artifactMeta = (ref, dir, contentOrigin = "") => ({
     ...readArtifact(dir, ref, runtimeOf(ref, dir)),
     ...ref.type !== "html" ? { agent: names.agent() } : {},
+    ...ref.type === "artboard" ? { comments: boardComments.comments(ref.id), staleThreads: boardComments.stale(ref.id) } : {},
     contentBase: `${contentOrigin}${contentPrefix}${ref.type}/${ref.id}/`
   });
   const serveArtifactApi = (res, type, id2) => {
@@ -90158,7 +90453,7 @@ async function startArtifactsServer(options) {
       title: titleOf(readArtifact(entry.dir, entry), entry),
       updatedAt: latestMtime(entry.dir)
     }));
-    sendJson(res, 200, { project: import_node_path19.default.basename(import_node_path19.default.dirname(import_node_path19.default.dirname(root))), artifacts: summaries, warnings });
+    sendJson(res, 200, { project: import_node_path20.default.basename(import_node_path20.default.dirname(import_node_path20.default.dirname(root))), artifacts: summaries, warnings });
   };
   function onClientText(socket, text2) {
     let message;
@@ -90220,7 +90515,7 @@ async function startArtifactsServer(options) {
       return;
     }
     if (pathname === "/robots.txt") {
-      sendFile(res, import_node_path19.default.join(viewerDir, "robots.txt"));
+      sendFile(res, import_node_path20.default.join(viewerDir, "robots.txt"));
       return;
     }
     if (pathname.startsWith("/c/")) {
@@ -90302,6 +90597,24 @@ async function startArtifactsServer(options) {
       });
       return;
     }
+    const agentBoardMatch = API_AGENT_BOARD_COMMENTS_ROUTE.exec(pathname);
+    if (agentBoardMatch) {
+      if (req.method !== "POST" || key2 === null || !safeEqual(key2, token)) {
+        send(res, 403, "Forbidden: agent calls need ?key=");
+        return;
+      }
+      void serveAgentBoardComments(req, res, agentBoardMatch[1]).catch((err) => {
+        if (!res.headersSent) send(res, 500, `Artifacts error: ${err.message}`);
+      });
+      return;
+    }
+    const boardCommentsMatch = API_BOARD_COMMENTS_ROUTE.exec(pathname);
+    if (boardCommentsMatch) {
+      void serveBoardComments(req, res, boardCommentsMatch[1]).catch((err) => {
+        if (!res.headersSent) send(res, 500, `Artifacts error: ${err.message}`);
+      });
+      return;
+    }
     const documentMatch = API_DOCUMENT_ROUTE.exec(pathname);
     if (documentMatch) {
       void serveDocumentApi(req, res, documentMatch[1], documentMatch[2]).catch((err) => {
@@ -90317,7 +90630,7 @@ async function startArtifactsServer(options) {
     if (SHELL_ROUTE.test(pathname) || PREVIEW_ROUTE.test(pathname) || pathname === "/index.html") {
       const ref = artifactKeyOf(pathname.replace(/^\/(?:preview\/)?/, "").replace(/\/$/, ""));
       const dir = ref && resolveArtifactDir(root, ref.type, ref.id);
-      const project = import_node_path19.default.basename(import_node_path19.default.dirname(import_node_path19.default.dirname(root)));
+      const project = import_node_path20.default.basename(import_node_path20.default.dirname(import_node_path20.default.dirname(root)));
       const title = ref ? dir ? titleOf(readArtifact(dir, ref), ref) : ref.id : `${project} \xB7 Artifacts`;
       const description = ref ? `\u5728 ${project} \u9879\u76EE\u4E2D\u67E5\u770B ${title}\uFF0C\u8FD9\u662F\u4E00\u4E2A ${ref.type === "artboard" ? "Artboard" : ref.type === "document" ? "Document" : "HTML"} Artifact\u3002` : `\u6D4F\u89C8 ${project} \u9879\u76EE\u7684\u5168\u90E8 Artboard\u3001Document \u548C HTML Artifact\uFF0C\u9884\u89C8\u771F\u5B9E\u5185\u5BB9\uFF0C\u6309\u7C7B\u578B\u3001\u540D\u79F0\u548C\u66F4\u65B0\u65F6\u95F4\u67E5\u627E\u4F5C\u54C1\u3002`;
       const canonical = `http://${urlHostForHttp(options.urlHost)}:${port}/${ref ? `${ref.type}/${ref.id}` : ""}`;
@@ -90326,7 +90639,7 @@ async function startArtifactsServer(options) {
         "Content-Security-Policy": PREVIEW_ROUTE.test(pathname) ? VIEWER_CSP.replace("frame-ancestors 'none'", "frame-ancestors 'self'") : VIEWER_CSP
       };
       if (key2 !== null) headers["Set-Cookie"] = `${cookieName}=${token}; HttpOnly; SameSite=Strict; Path=/`;
-      void import_node_fs22.default.promises.readFile(import_node_path19.default.join(viewerDir, "index.html"), "utf8").then((template) => send(res, 200, viewerPage(template, { title, description, url: canonical }), headers)).catch((err) => send(res, err.code === "ENOENT" ? 404 : 500, "Viewer unavailable"));
+      void import_node_fs23.default.promises.readFile(import_node_path20.default.join(viewerDir, "index.html"), "utf8").then((template) => send(res, 200, viewerPage(template, { title, description, url: canonical }), headers)).catch((err) => send(res, err.code === "ENOENT" ? 404 : 500, "Viewer unavailable"));
       return;
     }
     const target = resolveInside(viewerDir, pathname.slice(1));
@@ -90385,7 +90698,7 @@ async function startArtifactsServer(options) {
     port = await listen(server, options.host, 0);
   }
   cookieName = `ryugi_artifacts_${port}`;
-  import_node_fs22.default.writeFileSync(portFile, `${port}
+  import_node_fs23.default.writeFileSync(portFile, `${port}
 `, { mode: 384 });
   const origin = `http://${urlHostForHttp(options.urlHost)}:${port}`;
   const url = `${origin}/?key=${token}`;
@@ -90402,7 +90715,7 @@ async function startArtifactsServer(options) {
     return payload;
   };
   const refreshState = (ref, dir) => {
-    signatures.set(`${ref.type}/${ref.id}`, artifactSignature(dir));
+    signatures.set(`${ref.type}/${ref.id}`, artifactSignature(dir, ref.type));
     return writeState(ref, dir);
   };
   const initialChanges = [];
@@ -90411,7 +90724,7 @@ async function startArtifactsServer(options) {
     initialChanges.push({ ref: entry, payload, files: [] });
     if (entry.type === "document") void documents.open(entry.id);
   }
-  writeJsonAtomic(import_node_path19.default.join(stateDir, "server-info"), { type: "server-started", url, port, root });
+  writeJsonAtomic(import_node_path20.default.join(stateDir, "server-info"), { type: "server-started", url, port, root });
   const relayViewers = /* @__PURE__ */ new Map();
   const servedArtifacts = () => {
     const served = /* @__PURE__ */ new Map();
@@ -90444,6 +90757,11 @@ async function startArtifactsServer(options) {
       if (typeof request.message === "object" && request.message !== null) acceptReport({ ...request.message, artifact: key2 });
       return null;
     }
+    if (request.op === "comment" && ref.type === "artboard") {
+      const op = JSON.stringify(request.comment ?? null).length <= MAX_COMMENT_OP ? asBoardHumanOp(request.comment) : null;
+      if (!op) throw new Error("not a comment op");
+      return boardComments.apply(ref.id, op);
+    }
     if ((request.op === "state" || request.op === "update" || request.op === "comment") && ref.type !== "document") throw new Error(`${key2} is not a document`);
     if (request.op === "state" || request.op === "update") {
       const session = await documents.open(ref.id);
@@ -90508,7 +90826,9 @@ async function startArtifactsServer(options) {
         }
         if (ref.type === "document" && (changed.includes("doc.xml") || changed.length === 0)) documents.fileChanged(ref.id);
         if (ref.type === "document" && changed.includes("comments.json")) documents.commentsChanged(ref.id);
-        if (signatures.get(key2) === artifactSignature(dir)) continue;
+        if (ref.type === "artboard" && changed.includes("comments.json")) boardComments.sync(ref.id);
+        if (ref.type === "artboard" && (changed.some((file) => file !== "comments.json") || changed.length === 0)) boardComments.boardsChanged(ref.id);
+        if (signatures.get(key2) === artifactSignature(dir, ref.type)) continue;
         autoPublisher?.changed(key2);
         runtimeWarnings.delete(key2);
         const payload = refreshState(ref, dir);
@@ -90552,7 +90872,7 @@ async function startArtifactsServer(options) {
 }
 
 // src/server/lifecycle.ts
-var import_node_fs23 = __toESM(require("node:fs"), 1);
+var import_node_fs24 = __toESM(require("node:fs"), 1);
 var DEFAULT_IDLE_TIMEOUT_MS = 4 * 60 * 60 * 1e3;
 var DEFAULT_LIFECYCLE_CHECK_MS = 60 * 1e3;
 var SERVER_ID_ARG = "--artifacts-server-id=";
@@ -90584,7 +90904,7 @@ function parseEnv(env, argv = []) {
 function readOwners(file) {
   let text2;
   try {
-    text2 = import_node_fs23.default.readFileSync(file, "utf8");
+    text2 = import_node_fs24.default.readFileSync(file, "utf8");
   } catch {
     return [];
   }
@@ -90647,20 +90967,20 @@ function openReady(payload) {
 }
 
 // package.json
-var version = "1.15.1";
+var version = "1.16.0";
 
 // src/server/main.ts
 async function main() {
   const config = parseEnv(process.env, process.argv.slice(2));
-  const root = import_node_path20.default.resolve(config.root);
-  const stateDir = import_node_path20.default.join(root, ".state");
+  const root = import_node_path21.default.resolve(config.root);
+  const stateDir = import_node_path21.default.join(root, ".state");
   const server = await startArtifactsServer({
     root,
-    viewerDir: import_node_path20.default.join(__dirname, "viewer"),
-    runtimeDir: import_node_path20.default.join(__dirname, "runtime"),
+    viewerDir: import_node_path21.default.join(__dirname, "viewer"),
+    runtimeDir: import_node_path21.default.join(__dirname, "runtime"),
     host: config.host,
     urlHost: config.urlHost,
-    configFile: import_node_path20.default.join(import_node_path20.default.dirname(root), "config.json"),
+    configFile: import_node_path21.default.join(import_node_path21.default.dirname(root), "config.json"),
     cloud: { origin: config.cloudOrigin, credentialsFile: credentialsFile(process.env, process.platform, import_node_os.default.homedir()) },
     relay: { url: `${config.cloudOrigin.replace(/^http/, "ws")}/api/relay/host`, version }
   });
@@ -90690,12 +91010,12 @@ async function main() {
     if (stopping) return;
     stopping = true;
     console.log(JSON.stringify({ type: "server-stopped", reason }));
-    import_node_fs24.default.rmSync(import_node_path20.default.join(stateDir, "server-info"), { force: true });
-    writeJsonAtomic(import_node_path20.default.join(stateDir, "server-stopped"), { reason, timestamp: Date.now() });
+    import_node_fs25.default.rmSync(import_node_path21.default.join(stateDir, "server-info"), { force: true });
+    writeJsonAtomic(import_node_path21.default.join(stateDir, "server-stopped"), { reason, timestamp: Date.now() });
     await server.close();
     process.exit(0);
   };
-  const ownersFile = import_node_path20.default.join(stateDir, "owners");
+  const ownersFile = import_node_path21.default.join(stateDir, "owners");
   const timer = setInterval(() => {
     const owners = readOwners(ownersFile);
     const reason = shutdownReason({
@@ -90709,7 +91029,7 @@ async function main() {
   timer.unref();
   process.on("SIGTERM", () => void shutdown("SIGTERM"));
   process.on("SIGINT", () => void shutdown("SIGINT"));
-  import_node_fs24.default.rmSync(import_node_path20.default.join(stateDir, "server-stopped"), { force: true });
+  import_node_fs25.default.rmSync(import_node_path21.default.join(stateDir, "server-stopped"), { force: true });
   console.log(JSON.stringify({ type: "server-started", url: server.url, port: server.port, root }));
 }
 main().catch((err) => {