ryugi-artifacts 1.60.0 → 1.61.0

package/dist/server.cjs

@@ -8794,12 +8794,12 @@ var require_websocket_server = __commonJS({
 // src/server/main.ts
 var import_node_child_process5 = require("node:child_process");
 var import_node_crypto13 = __toESM(require("node:crypto"), 1);
-var import_node_fs41 = __toESM(require("node:fs"), 1);
+var import_node_fs42 = __toESM(require("node:fs"), 1);
 var import_node_os2 = __toESM(require("node:os"), 1);
-var import_node_path36 = __toESM(require("node:path"), 1);
+var import_node_path37 = __toESM(require("node:path"), 1);
 
 // package.json
-var version = "1.60.0";
+var version = "1.61.0";
 
 // src/server/browser-focus.ts
 var import_node_child_process = require("node:child_process");
@@ -9491,9 +9491,9 @@ function clearCredentials(file) {
 }
 
 // src/server/hub.ts
-var import_node_fs38 = __toESM(require("node:fs"), 1);
+var import_node_fs39 = __toESM(require("node:fs"), 1);
 var import_node_http2 = __toESM(require("node:http"), 1);
-var import_node_path34 = __toESM(require("node:path"), 1);
+var import_node_path35 = __toESM(require("node:path"), 1);
 
 // src/server/access.ts
 var LOOPBACK = /* @__PURE__ */ new Set(["localhost", "::1", "[::1]"]);
@@ -9520,9 +9520,9 @@ var originAllowed = (policy, origin, { cloud = false } = {}) => origin === void
 var navigationAllowed = (secFetchSite) => secFetchSite === void 0 || secFetchSite === "none" || secFetchSite === "same-origin";
 
 // src/server/app.ts
-var import_node_fs35 = __toESM(require("node:fs"), 1);
+var import_node_fs36 = __toESM(require("node:fs"), 1);
 var import_node_http = __toESM(require("node:http"), 1);
-var import_node_path31 = __toESM(require("node:path"), 1);
+var import_node_path32 = __toESM(require("node:path"), 1);
 
 // src/shared/cloud.ts
 var MAX_ARTIFACT_BYTES = 20 * 1024 * 1024;
@@ -9868,6 +9868,8 @@ function watchArtifacts(ctx) {
       }
       for (const [key2, { ref, files: changed }] of byArtifact) {
         const dir = resolveArtifactDir(root, ref.type, ref.id);
+        if (ref.type === "artboard" && (changed.some((file) => file !== "comments.json") || changed.length === 0))
+          documents.artboardChanged(ref.id);
         if (!dir) {
           signatures.delete(key2);
           ctx.autoPublisher?.removed(key2);
@@ -9912,9 +9914,9 @@ function watchArtifacts(ctx) {
 var PAGE_CSP = "sandbox allow-scripts allow-modals allow-forms allow-popups allow-downloads";
 var DOCUMENT_ASSET_CSP = "sandbox; default-src 'none'";
 var ISOLATED_BOARD_CSP = "worker-src 'none'";
-function contentCsp(type, path37, ownOrigin) {
+function contentCsp(type, path38, ownOrigin) {
   if (type === "html") return PAGE_CSP;
-  if (type === "document") return path37.endsWith(".html") ? PAGE_CSP : DOCUMENT_ASSET_CSP;
+  if (type === "document") return path38.endsWith(".html") ? PAGE_CSP : DOCUMENT_ASSET_CSP;
   return ownOrigin ? ISOLATED_BOARD_CSP : "sandbox allow-scripts";
 }
 
@@ -9942,8 +9944,8 @@ function routeBoardRequest(req, pathname) {
 }
 
 // src/server/context.ts
-var import_node_fs31 = __toESM(require("node:fs"), 1);
-var import_node_path27 = __toESM(require("node:path"), 1);
+var import_node_fs32 = __toESM(require("node:fs"), 1);
+var import_node_path28 = __toESM(require("node:path"), 1);
 
 // src/server/agent-review.ts
 var import_node_crypto5 = __toESM(require("node:crypto"), 1);
@@ -10477,6 +10479,15 @@ var requiredReviewFields = {
   groups: ["id", "kind", "verdict", "choice"],
   rounds: ["id", "state"]
 };
+var reviewSectionsFor = (artifact) => artifact.startsWith("document/") ? ["threads", "asks"] : ["threads", "groups", "rounds"];
+function validateReviewBundle(input, artifact) {
+  if (input.section) return "Choose section or sections, not both.";
+  if (!input.sections.length || new Set(input.sections).size !== input.sections.length || input.sections.some((section) => !reviewSectionsFor(artifact).includes(section)))
+    return "Choose distinct review sections supported by this artifact.";
+  if (input.fields || input.cursor || input.snapshot || input.thread || input.filters && Object.values(input.filters).some((value) => value !== void 0))
+    return "Fields, filters, thread, cursor and snapshot require a single --section. Follow each collection continuation separately.";
+  return null;
+}
 function validateReviewQuery(input) {
   const { section, filters: filters2 } = input;
   if (!section && (input.detail || input.cursor || input.fields || filters2 && Object.values(filters2).some(Boolean)))
@@ -10805,9 +10816,133 @@ function createAgentReview(stateDir, options2 = {}) {
   };
 }
 
+// src/server/agent-status.ts
+var import_node_fs9 = __toESM(require("node:fs"), 1);
+var import_node_path8 = __toESM(require("node:path"), 1);
+
+// src/shared/agent-status.ts
+var AGENT_HOST_NAMES = {
+  claude: "Claude Code",
+  codex: "Codex"
+};
+
+// src/server/agent-status.ts
+var ACTIVE_TTL_MS = 30 * 6e4;
+var IDLE_TTL_MS = 8 * 60 * 6e4;
+var ARTIFACT_TYPES2 = /* @__PURE__ */ new Set(["artboard", "document", "html"]);
+var ARTIFACT_ID = /^[a-z0-9][a-z0-9-]*$/;
+var USER_WAIT_TOOLS = /* @__PURE__ */ new Set(["AskUserQuestion", "ExitPlanMode"]);
+var TRANSITIONS = {
+  UserPromptSubmit: { state: "thinking", clearArtifacts: true, endTurn: true },
+  PreToolUse: { state: "running" },
+  PostToolUse: { state: "thinking", clearArtifacts: true },
+  PostToolUseFailure: { state: "thinking", clearArtifacts: true },
+  PermissionRequest: { state: "needs-approval" },
+  PermissionDenied: { state: "thinking", clearArtifacts: true },
+  Stop: { state: "your-turn", clearArtifacts: true, endTurn: true },
+  Interrupt: { state: "your-turn", clearArtifacts: true, endTurn: true },
+  SessionEnd: "end"
+};
+var HUB_TEMP_FILE = /\.\d+\.tmp$/;
+var HUB_WRITTEN = /* @__PURE__ */ new Set(["doc.xml", "comments.json"]);
+var agentWrittenFiles = (files) => files.filter((file) => !HUB_WRITTEN.has(file.replace(HUB_TEMP_FILE, "")));
+function realpathOr(dir) {
+  try {
+    return import_node_fs9.default.realpathSync(dir);
+  } catch {
+    return import_node_path8.default.resolve(dir);
+  }
+}
+function realpathOfNew(file) {
+  let dir = import_node_path8.default.resolve(file);
+  const rest = [];
+  while (dir !== import_node_path8.default.dirname(dir)) {
+    try {
+      return import_node_path8.default.join(import_node_fs9.default.realpathSync(dir), ...rest);
+    } catch {
+      rest.unshift(import_node_path8.default.basename(dir));
+      dir = import_node_path8.default.dirname(dir);
+    }
+  }
+  return import_node_path8.default.resolve(file);
+}
+function createAgentStatus(root) {
+  const bases = [.../* @__PURE__ */ new Set([import_node_path8.default.resolve(root), realpathOr(root)])];
+  const entries2 = /* @__PURE__ */ new Map();
+  const keyOf = (file) => {
+    if (!import_node_path8.default.isAbsolute(file)) return null;
+    const candidates = [.../* @__PURE__ */ new Set([import_node_path8.default.resolve(file), realpathOfNew(file)])];
+    for (const base of bases)
+      for (const candidate of candidates) {
+        const parts = import_node_path8.default.relative(base, candidate).split(import_node_path8.default.sep);
+        if (parts.length < 3 || parts[0] === "..") continue;
+        const [type, id2] = parts;
+        if (ARTIFACT_TYPES2.has(type) && ARTIFACT_ID.test(id2)) return `${type}/${id2}`;
+      }
+    return null;
+  };
+  const add2 = (list2, keys2) => [.../* @__PURE__ */ new Set([...list2, ...keys2])];
+  return {
+    apply(event) {
+      const transition = TRANSITIONS[event.event];
+      if (!transition) return false;
+      const id2 = `${event.host}:${event.session}`;
+      const entry = entries2.get(id2);
+      if (entry && event.at < entry.lastAt) return false;
+      if (transition === "end") return entries2.delete(id2);
+      if (event.event === "PreToolUse" && entry?.session.state === "needs-approval") {
+        entry.lastAt = event.at;
+        return false;
+      }
+      const keys2 = (event.paths ?? []).flatMap((file) => keyOf(file) ?? []);
+      const previous = entry?.session;
+      const turnArtifacts = transition.endTurn ? [] : previous?.turnArtifacts ?? [];
+      const artifacts = transition.clearArtifacts ? [] : previous?.artifacts ?? [];
+      const waitsOnUser = event.event === "PreToolUse" && USER_WAIT_TOOLS.has(event.tool ?? "");
+      const session = {
+        id: event.session,
+        host: event.host,
+        agent: AGENT_HOST_NAMES[event.host],
+        state: waitsOnUser ? "needs-approval" : transition.state,
+        since: previous?.state === transition.state && !waitsOnUser ? previous.since : event.at,
+        artifacts: add2(artifacts, keys2),
+        turnArtifacts: add2(turnArtifacts, keys2)
+      };
+      entries2.set(id2, { session, lastAt: event.at });
+      return true;
+    },
+    touched(key2) {
+      let changed = false;
+      for (const entry of entries2.values()) {
+        const { session } = entry;
+        if (session.state !== "running" || session.artifacts.includes(key2)) continue;
+        entry.session = {
+          ...session,
+          artifacts: add2(session.artifacts, [key2]),
+          turnArtifacts: add2(session.turnArtifacts, [key2])
+        };
+        changed = true;
+      }
+      return changed;
+    },
+    expire(now) {
+      let changed = false;
+      for (const [id2, entry] of entries2) {
+        const waiting = entry.session.state === "your-turn" || entry.session.state === "needs-approval";
+        const ttl = waiting ? IDLE_TTL_MS : ACTIVE_TTL_MS;
+        if (now - entry.lastAt >= ttl) changed = entries2.delete(id2) || changed;
+      }
+      return changed;
+    },
+    sessions() {
+      return [...entries2.values()].map((entry) => entry.session);
+    }
+  };
+}
+
 // src/server/auto-publish.ts
 var import_node_crypto6 = __toESM(require("node:crypto"), 1);
-var import_node_fs9 = __toESM(require("node:fs"), 1);
+var import_node_fs10 = __toESM(require("node:fs"), 1);
 var IDLE_MS = 5 * 60 * 1e3;
 var MAX_WAIT_MS = 15 * 60 * 1e3;
 var SIGNED_OUT_MESSAGE = "auto-publish paused: the Ryugi Cloud sign-in expired";
@@ -10820,7 +10955,7 @@ function isNotice(value) {
 function readAutoPublishState(file) {
   let raw = {};
   try {
-    const parsed = JSON.parse(import_node_fs9.default.readFileSync(file, "utf8"));
+    const parsed = JSON.parse(import_node_fs10.default.readFileSync(file, "utf8"));
     if (typeof parsed === "object" && parsed !== null) raw = parsed;
   } catch {
   }
@@ -11025,8 +11160,8 @@ function unreferencedChoiceWarnings(slug, backlinks, canvas, hasDocuments) {
 
 // src/server/board-comments.ts
 var import_node_crypto9 = __toESM(require("node:crypto"), 1);
-var import_node_fs14 = __toESM(require("node:fs"), 1);
-var import_node_path11 = __toESM(require("node:path"), 1);
+var import_node_fs15 = __toESM(require("node:fs"), 1);
+var import_node_path12 = __toESM(require("node:path"), 1);
 
 // src/shared/board-comments.ts
 var isChoiceRecord = (thread) => thread.anchor.choice !== void 0 || thread.anchor.submit !== void 0;
@@ -11209,8 +11344,8 @@ function groupVerdict(threads2, group, stale) {
 }
 
 // src/server/board-choices.ts
-var import_node_fs10 = __toESM(require("node:fs"), 1);
-var import_node_path8 = __toESM(require("node:path"), 1);
+var import_node_fs11 = __toESM(require("node:fs"), 1);
+var import_node_path9 = __toESM(require("node:path"), 1);
 
 // src/shared/rounds.ts
 function pageTitles(canvas, layout, page) {
@@ -11257,7 +11392,7 @@ var roundOfGroup = (rounds, group) => rounds.find((round) => round.groups.includ
 // src/server/board-choices.ts
 function choiceContext(dir) {
   try {
-    const canvas = JSON.parse(import_node_fs10.default.readFileSync(import_node_path8.default.join(dir, "canvas.json"), "utf8"));
+    const canvas = JSON.parse(import_node_fs11.default.readFileSync(import_node_path9.default.join(dir, "canvas.json"), "utf8"));
     if (!Array.isArray(canvas.pages) || typeof canvas.boards !== "object" || !canvas.boards)
       return { canvas: null, rounds: [] };
     return { canvas, rounds: choiceRounds(canvas, computeLayout(canvas)) };
@@ -11355,12 +11490,12 @@ function agentSubmitAnchor(context2, id2, submit) {
 }
 
 // src/server/comment-cursors.ts
-var import_node_fs11 = __toESM(require("node:fs"), 1);
-var import_node_path9 = __toESM(require("node:path"), 1);
-var cursorsFile = (stateDir, id2, type = "document") => import_node_path9.default.join(stateDir, type, id2, "comment-cursors.json");
+var import_node_fs12 = __toESM(require("node:fs"), 1);
+var import_node_path10 = __toESM(require("node:path"), 1);
+var cursorsFile = (stateDir, id2, type = "document") => import_node_path10.default.join(stateDir, type, id2, "comment-cursors.json");
 function read(file) {
   try {
-    const value = JSON.parse(import_node_fs11.default.readFileSync(file, "utf8"));
+    const value = JSON.parse(import_node_fs12.default.readFileSync(file, "utf8"));
     if (typeof value !== "object" || value === null || Array.isArray(value)) return {};
     return Object.fromEntries(
       Object.entries(value).filter(
@@ -11384,7 +11519,7 @@ function createCommentCursors(stateDir, type = "document") {
 }
 
 // src/server/document-comments.ts
-var import_node_fs12 = __toESM(require("node:fs"), 1);
+var import_node_fs13 = __toESM(require("node:fs"), 1);
 
 // ../../node_modules/.pnpm/nanoid@5.1.16/node_modules/nanoid/index.js
 var import_node_crypto8 = require("node:crypto");
@@ -11493,12 +11628,12 @@ function createStore(file, rules, names = noNames, now = () => (/* @__PURE__ */
   let loaded = false;
   const write = () => {
     writeJsonAtomic(file, current);
-    lastSeen = import_node_fs12.default.readFileSync(file, "utf8");
+    lastSeen = import_node_fs13.default.readFileSync(file, "utf8");
   };
   const sync = () => {
     let text4;
     try {
-      text4 = import_node_fs12.default.readFileSync(file, "utf8");
+      text4 = import_node_fs13.default.readFileSync(file, "utf8");
     } catch {
       return false;
     }
@@ -11542,13 +11677,13 @@ function createStore(file, rules, names = noNames, now = () => (/* @__PURE__ */
 }
 
 // src/server/listening.ts
-var import_node_fs13 = __toESM(require("node:fs"), 1);
-var import_node_path10 = __toESM(require("node:path"), 1);
+var import_node_fs14 = __toESM(require("node:fs"), 1);
+var import_node_path11 = __toESM(require("node:path"), 1);
 var HOSTS = ["claude", "codex"];
 var FRESH_MS = 1e4;
 function readSubscription(file) {
   try {
-    const value = JSON.parse(import_node_fs13.default.readFileSync(file, "utf8"));
+    const value = JSON.parse(import_node_fs14.default.readFileSync(file, "utf8"));
     return Array.isArray(value.artifacts) ? value.artifacts.filter((a5) => typeof a5 === "string") : [];
   } catch {
     return [];
@@ -11556,7 +11691,7 @@ function readSubscription(file) {
 }
 function beatAt(file) {
   try {
-    const stamp3 = Number(import_node_fs13.default.readFileSync(file, "utf8"));
+    const stamp3 = Number(import_node_fs14.default.readFileSync(file, "utf8"));
     return Number.isFinite(stamp3) ? stamp3 : null;
   } catch {
     return null;
@@ -11564,18 +11699,18 @@ function beatAt(file) {
 }
 function listeningOn(stateDir, artifact, now = Date.now()) {
   for (const host of HOSTS) {
-    const dir = import_node_path10.default.join(stateDir, `${host}-comment-watch`);
+    const dir = import_node_path11.default.join(stateDir, `${host}-comment-watch`);
     let names;
     try {
-      names = import_node_fs13.default.readdirSync(dir);
+      names = import_node_fs14.default.readdirSync(dir);
     } catch {
       continue;
     }
     for (const name of names) {
       if (!name.endsWith(".json")) continue;
-      const artifacts = readSubscription(import_node_path10.default.join(dir, name));
+      const artifacts = readSubscription(import_node_path11.default.join(dir, name));
       if (!artifacts.includes("*") && !artifacts.includes(artifact)) continue;
-      const beat = beatAt(import_node_path10.default.join(dir, name.replace(/\.json$/, ".alive")));
+      const beat = beatAt(import_node_path11.default.join(dir, name.replace(/\.json$/, ".alive")));
       if (beat !== null && now - beat < FRESH_MS) return true;
     }
   }
@@ -11624,7 +11759,7 @@ function asBoardAgentOp(value) {
 }
 function readCanvasJson(dir) {
   try {
-    return JSON.parse(import_node_fs14.default.readFileSync(import_node_path11.default.join(dir, "canvas.json"), "utf8"));
+    return JSON.parse(import_node_fs15.default.readFileSync(import_node_path12.default.join(dir, "canvas.json"), "utf8"));
   } catch {
     return {};
   }
@@ -11683,11 +11818,11 @@ function fileHash(dir, relative) {
   const file = resolveBoardFile(dir, relative);
   if (!file) return null;
   try {
-    const stat = import_node_fs14.default.statSync(file);
+    const stat = import_node_fs15.default.statSync(file);
     const stamp3 = `${stat.size}:${stat.mtimeMs}`;
     const cached = hashCache.get(file);
     if (cached?.stamp === stamp3) return cached.hash;
-    const hash2 = import_node_crypto9.default.createHash("sha1").update(import_node_fs14.default.readFileSync(file)).digest("hex").slice(0, 12);
+    const hash2 = import_node_crypto9.default.createHash("sha1").update(import_node_fs15.default.readFileSync(file)).digest("hex").slice(0, 12);
     hashCache.set(file, { stamp: stamp3, hash: hash2 });
     return hash2;
   } catch {
@@ -11730,11 +11865,11 @@ function createBoardCommentRegistry(options2) {
   const lastListening = /* @__PURE__ */ new Map();
   const listening = (id2) => listeningOn(options2.stateDir, `artboard/${id2}`);
   const cursors = createCommentCursors(options2.stateDir, "artboard");
-  const dirOf = (id2) => import_node_path11.default.join(options2.root, "artboard", id2);
+  const dirOf = (id2) => import_node_path12.default.join(options2.root, "artboard", id2);
   const store = (id2) => {
     let found = stores.get(id2);
     if (!found) {
-      found = createStore(import_node_path11.default.join(dirOf(id2), "comments.json"), boardRules, options2.names);
+      found = createStore(import_node_path12.default.join(dirOf(id2), "comments.json"), boardRules, options2.names);
       stores.set(id2, found);
     }
     return found;
@@ -11777,12 +11912,12 @@ function createBoardCommentRegistry(options2) {
     hashes.delete(id2);
     return currentHashes(id2);
   };
-  const roundsFile = (id2) => import_node_path11.default.join(options2.stateDir, "artboard", id2, "rounds.json");
+  const roundsFile = (id2) => import_node_path12.default.join(options2.stateDir, "artboard", id2, "rounds.json");
   const writeRounds = (id2) => {
     const context2 = choiceContext(dirOf(id2));
     if (!context2.canvas) return;
     const rounds = roundViews(context2, store(id2).current().threads);
-    if (rounds.length === 0 && !import_node_fs14.default.existsSync(roundsFile(id2))) return;
+    if (rounds.length === 0 && !import_node_fs15.default.existsSync(roundsFile(id2))) return;
     writeJsonAtomic(roundsFile(id2), { rounds });
   };
   const forAgent2 = (id2, staleIds) => {
@@ -11920,7 +12055,7 @@ function createBoardCommentRegistry(options2) {
     boardsChanged: (id2) => {
       fresh(id2);
       writeRounds(id2);
-      if (!stores.has(id2) && !import_node_fs14.default.existsSync(import_node_path11.default.join(dirOf(id2), "comments.json"))) return;
+      if (!stores.has(id2) && !import_node_fs15.default.existsSync(import_node_path12.default.join(dirOf(id2), "comments.json"))) return;
       if (JSON.stringify(stale(id2)) !== (lastStale.get(id2) ?? "[]")) push2(id2);
     }
   };
@@ -12256,8 +12391,8 @@ function callbackPage(result, locale = "en") {
 }
 
 // src/server/config.ts
-var import_node_fs15 = __toESM(require("node:fs"), 1);
-var import_node_path12 = __toESM(require("node:path"), 1);
+var import_node_fs16 = __toESM(require("node:fs"), 1);
+var import_node_path13 = __toESM(require("node:path"), 1);
 var defaults = () => ({ version: 1, artifacts: {} });
 function isCloudRecord(value) {
   if (typeof value !== "object" || value === null) return false;
@@ -12298,7 +12433,7 @@ function normalize(raw) {
 function readConfig(file) {
   let text4;
   try {
-    text4 = import_node_fs15.default.readFileSync(file, "utf8");
+    text4 = import_node_fs16.default.readFileSync(file, "utf8");
   } catch {
     return { config: defaults() };
   }
@@ -12313,22 +12448,22 @@ function readConfig(file) {
 }
 var IGNORED = ["config.json", "artifacts/*", "!artifacts/document/", "artifacts/document/*/.artifact-id"];
 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_fs15.default.readFileSync(file, "utf8");
+    current = import_node_fs16.default.readFileSync(file, "utf8");
   } catch {
   }
   const present = new Set(current.split(/\r?\n/).map((line) => line.trim()));
   const missing = IGNORED.filter((line) => !present.has(line));
   if (missing.length === 0) return;
-  import_node_fs15.default.writeFileSync(file, `${current}${current === "" || current.endsWith("\n") ? "" : "\n"}${missing.join("\n")}
+  import_node_fs16.default.writeFileSync(file, `${current}${current === "" || current.endsWith("\n") ? "" : "\n"}${missing.join("\n")}
 `);
 }
 function ensureConfig(file) {
-  import_node_fs15.default.mkdirSync(import_node_path12.default.dirname(file), { recursive: true });
-  ensureGitignore(import_node_path12.default.dirname(file));
-  if (!import_node_fs15.default.existsSync(file)) writeJsonAtomic(file, defaults());
+  import_node_fs16.default.mkdirSync(import_node_path13.default.dirname(file), { recursive: true });
+  ensureGitignore(import_node_path13.default.dirname(file));
+  if (!import_node_fs16.default.existsSync(file)) writeJsonAtomic(file, defaults());
 }
 function updateArtifactConfig(file, key2, patch) {
   const { config, warning } = readConfig(file);
@@ -12348,27 +12483,27 @@ function setProjectAutoPublish(file, value) {
   if (warning) throw new Error(warning);
   if (value === null) delete config.autoPublish;
   else config.autoPublish = value;
-  import_node_fs15.default.mkdirSync(import_node_path12.default.dirname(file), { recursive: true });
+  import_node_fs16.default.mkdirSync(import_node_path13.default.dirname(file), { recursive: true });
   writeJsonAtomic(file, config);
 }
 
 // src/server/host-id.ts
-var import_node_fs16 = __toESM(require("node:fs"), 1);
-var import_node_path13 = __toESM(require("node:path"), 1);
+var import_node_fs17 = __toESM(require("node:fs"), 1);
+var import_node_path14 = __toESM(require("node:path"), 1);
 function hostIdFor(credentialsFile2) {
-  const file = import_node_path13.default.join(import_node_path13.default.dirname(credentialsFile2), "host-id");
+  const file = import_node_path14.default.join(import_node_path14.default.dirname(credentialsFile2), "host-id");
   const saved = readPersisted(file);
   if (/^[\w-]{16,64}$/.test(saved)) return saved;
   const id2 = randomToken();
-  import_node_fs16.default.mkdirSync(import_node_path13.default.dirname(file), { recursive: true, mode: 448 });
-  import_node_fs16.default.writeFileSync(file, `${id2}
+  import_node_fs17.default.mkdirSync(import_node_path14.default.dirname(file), { recursive: true, mode: 448 });
+  import_node_fs17.default.writeFileSync(file, `${id2}
 `, { mode: 384 });
   return id2;
 }
 
 // src/server/pack.ts
-var import_node_fs17 = __toESM(require("node:fs"), 1);
-var import_node_path14 = __toESM(require("node:path"), 1);
+var import_node_fs18 = __toESM(require("node:fs"), 1);
+var import_node_path15 = __toESM(require("node:path"), 1);
 var ArtifactTooLarge = class extends Error {
 };
 var excluded = (type, relative) => (type === "document" || type === "artboard") && relative === "comments.json";
@@ -12376,22 +12511,22 @@ function packArtifact(dir, type, {
   maxBytes = MAX_ARTIFACT_BYTES,
   overrides
 } = {}) {
-  const rootReal = import_node_fs17.default.realpathSync(dir);
+  const rootReal = import_node_fs18.default.realpathSync(dir);
   const found = [];
   const visited = /* @__PURE__ */ new Set([rootReal]);
   let total = 0;
   const walk = (current) => {
-    for (const entry of import_node_fs17.default.readdirSync(current, { withFileTypes: true })) {
+    for (const entry of import_node_fs18.default.readdirSync(current, { withFileTypes: true })) {
       if (entry.name.startsWith(".")) continue;
-      const full = import_node_path14.default.join(current, entry.name);
+      const full = import_node_path15.default.join(current, entry.name);
       let real;
       try {
-        real = import_node_fs17.default.realpathSync(full);
+        real = import_node_fs18.default.realpathSync(full);
       } catch {
         continue;
       }
-      if (!real.startsWith(rootReal + import_node_path14.default.sep)) continue;
-      const stat = import_node_fs17.default.statSync(real);
+      if (!real.startsWith(rootReal + import_node_path15.default.sep)) continue;
+      const stat = import_node_fs18.default.statSync(real);
       if (stat.isDirectory()) {
         if (visited.has(real)) continue;
         visited.add(real);
@@ -12399,7 +12534,7 @@ function packArtifact(dir, type, {
         continue;
       }
       if (!stat.isFile()) continue;
-      const relative = import_node_path14.default.relative(dir, full).split(import_node_path14.default.sep).join("/");
+      const relative = import_node_path15.default.relative(dir, full).split(import_node_path15.default.sep).join("/");
       if (excluded(type, relative)) continue;
       if (!overrides?.has(relative)) total += stat.size;
       found.push({ path: relative, real });
@@ -12413,14 +12548,14 @@ function packArtifact(dir, type, {
     );
   }
   return [
-    ...found.filter((file) => !overrides?.has(file.path)).map((file) => ({ path: file.path, data: import_node_fs17.default.readFileSync(file.real) })),
+    ...found.filter((file) => !overrides?.has(file.path)).map((file) => ({ path: file.path, data: import_node_fs18.default.readFileSync(file.real) })),
     ...[...overrides ?? []].flatMap(([file, data]) => data ? [{ path: file, data }] : [])
   ];
 }
 
 // src/server/publish-payload.ts
-var import_node_fs18 = __toESM(require("node:fs"), 1);
-var import_node_path15 = __toESM(require("node:path"), 1);
+var import_node_fs19 = __toESM(require("node:fs"), 1);
+var import_node_path16 = __toESM(require("node:path"), 1);
 
 // ../../node_modules/.pnpm/nanoid@6.0.2/node_modules/nanoid/url-alphabet/index.js
 var urlAlphabet2 = "57X6y3wQZNzYjJB2L_10pxbackgroundhimselfUTF-8DEMOGRAPHICSVqvt4KW9";
@@ -26238,7 +26373,7 @@ function publishPayload(ref, dir, title, payload, comments = emptyComments()) {
   if (ref.type === "document")
     return {
       title,
-      state: parseDocument2(import_node_fs18.default.readFileSync(import_node_path15.default.join(dir, "doc.xml"), "utf8")),
+      state: parseDocument2(import_node_fs19.default.readFileSync(import_node_path16.default.join(dir, "doc.xml"), "utf8")),
       comments: sharedComments(comments)
     };
   return { title };
@@ -26260,12 +26395,12 @@ function withCloudRuntime(type, files) {
 }
 
 // src/server/settings.ts
-var import_node_fs19 = __toESM(require("node:fs"), 1);
-var import_node_path16 = __toESM(require("node:path"), 1);
-var settingsFileFor = (credentialsFile2) => import_node_path16.default.join(import_node_path16.default.dirname(credentialsFile2), "config.json");
+var import_node_fs20 = __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");
 function readSettings(file) {
   try {
-    const raw = JSON.parse(import_node_fs19.default.readFileSync(file, "utf8"));
+    const raw = JSON.parse(import_node_fs20.default.readFileSync(file, "utf8"));
     return typeof raw === "object" && raw !== null && !Array.isArray(raw) ? raw : {};
   } catch {
     return {};
@@ -26276,7 +26411,7 @@ function readGlobalAutoPublish(file) {
   return typeof value === "boolean" ? value : void 0;
 }
 function writeGlobalAutoPublish(file, value) {
-  import_node_fs19.default.mkdirSync(import_node_path16.default.dirname(file), { recursive: true, mode: 448 });
+  import_node_fs20.default.mkdirSync(import_node_path17.default.dirname(file), { recursive: true, mode: 448 });
   writeJsonAtomic(file, { ...readSettings(file), autoPublish: value });
 }
 function postponeGlobalAutoPublish(file) {
@@ -26285,7 +26420,7 @@ function postponeGlobalAutoPublish(file) {
     writeGlobalAutoPublish(file, false);
     return "off";
   }
-  import_node_fs19.default.mkdirSync(import_node_path16.default.dirname(file), { recursive: true, mode: 448 });
+  import_node_fs20.default.mkdirSync(import_node_path17.default.dirname(file), { recursive: true, mode: 448 });
   writeJsonAtomic(file, { ...settings, autoPublishPostponed: true });
   return "postponed";
 }
@@ -26422,7 +26557,7 @@ function createCloudRoutes(options2) {
     const challenge = import_node_crypto10.default.createHash("sha256").update(verifier).digest("base64url");
     return `${origin}/auth/cli?port=${options2.port()}&state=${state2}&challenge=${challenge}`;
   };
-  const cloudFetch = async (method, path37, body) => {
+  const cloudFetch = async (method, path38, body) => {
     const credentials = readCredentials(credentialsFile2, origin);
     if (!credentials) throw new SignedOut();
     const headers = { Authorization: `Bearer ${credentials.token}` };
@@ -26436,7 +26571,7 @@ function createCloudRoutes(options2) {
     }
     let res;
     try {
-      res = await fetch(`${origin}${path37}`, { method, headers, body: payload });
+      res = await fetch(`${origin}${path38}`, { method, headers, body: payload });
     } catch (err) {
       throw new CloudRefused(502, `could not reach ${origin}: ${err.message}`);
     }
@@ -26572,7 +26707,7 @@ function createCloudRoutes(options2) {
     const content = {
       title: inspected.title,
       payload: inspected.payload,
-      files: hashed.map(({ path: path37, hash: hash2 }) => ({ path: path37, hash: hash2 }))
+      files: hashed.map(({ path: path38, hash: hash2 }) => ({ path: path38, hash: hash2 }))
     };
     const fingerprint = sha(
       JSON.stringify({
@@ -27006,7 +27141,7 @@ function createCloudRoutes(options2) {
 
 // src/server/comment-names.ts
 var import_node_child_process2 = require("node:child_process");
-var import_node_fs20 = __toESM(require("node:fs"), 1);
+var import_node_fs21 = __toESM(require("node:fs"), 1);
 
 // src/server/agent.ts
 var NAMES = {
@@ -27099,7 +27234,7 @@ function commentNames({ agentFile, projectDir, cloud }) {
     agent: () => {
       try {
         return detectAgent(
-          JSON.parse(import_node_fs20.default.readFileSync(agentFile, "utf8"))
+          JSON.parse(import_node_fs21.default.readFileSync(agentFile, "utf8"))
         );
       } catch {
         return void 0;
@@ -27179,28 +27314,28 @@ function createDirectRelay(options2) {
 }
 
 // src/server/document.ts
-var import_node_fs22 = __toESM(require("node:fs"), 1);
-var import_node_path18 = __toESM(require("node:path"), 1);
+var import_node_fs23 = __toESM(require("node:fs"), 1);
+var import_node_path19 = __toESM(require("node:path"), 1);
 
 // src/server/html.ts
-var import_node_fs21 = __toESM(require("node:fs"), 1);
-var import_node_path17 = __toESM(require("node:path"), 1);
+var import_node_fs22 = __toESM(require("node:fs"), 1);
+var import_node_path18 = __toESM(require("node:path"), 1);
 var TITLE = /<title[^>]*>([\s\S]*?)<\/title>/i;
 function latestMtime(dir) {
   let latest2 = 0;
   let entries2;
   try {
-    entries2 = import_node_fs21.default.readdirSync(dir, { withFileTypes: true });
+    entries2 = import_node_fs22.default.readdirSync(dir, { withFileTypes: true });
   } catch {
     return latest2;
   }
   for (const entry of entries2) {
     if (entry.name.startsWith(".")) continue;
-    const full = import_node_path17.default.join(dir, entry.name);
+    const full = import_node_path18.default.join(dir, entry.name);
     try {
       latest2 = Math.max(
         latest2,
-        entry.isDirectory() ? latestMtime(full) : import_node_fs21.default.statSync(full).mtimeMs
+        entry.isDirectory() ? latestMtime(full) : import_node_fs22.default.statSync(full).mtimeMs
       );
     } catch {
       continue;
@@ -27211,7 +27346,7 @@ function latestMtime(dir) {
 function readHtml(dir, id2) {
   let source;
   try {
-    source = import_node_fs21.default.readFileSync(import_node_path17.default.join(dir, ENTRY_FILE.html), "utf8");
+    source = import_node_fs22.default.readFileSync(import_node_path18.default.join(dir, ENTRY_FILE.html), "utf8");
   } catch {
     return { title: id2, warnings: ["index.html not found"], version: latestMtime(dir) };
   }
@@ -27224,7 +27359,7 @@ var FIRST_HEADING = /<h[1-6]\b[^>]*>([\s\S]*?)<\/h[1-6]>/i;
 function readDocument(dir, id2) {
   let source;
   try {
-    source = import_node_fs22.default.readFileSync(import_node_path18.default.join(dir, ENTRY_FILE.document), "utf8");
+    source = import_node_fs23.default.readFileSync(import_node_path19.default.join(dir, ENTRY_FILE.document), "utf8");
   } catch {
     return { title: id2, warnings: ["doc.xml not found"], version: latestMtime(dir) };
   }
@@ -27233,17 +27368,17 @@ function readDocument(dir, id2) {
 }
 
 // src/server/documents.ts
-var import_node_fs25 = __toESM(require("node:fs"), 1);
-var import_node_path22 = __toESM(require("node:path"), 1);
+var import_node_fs26 = __toESM(require("node:fs"), 1);
+var import_node_path23 = __toESM(require("node:path"), 1);
 
 // src/server/change-cursors.ts
-var import_node_fs23 = __toESM(require("node:fs"), 1);
-var import_node_path19 = __toESM(require("node:path"), 1);
-var cursorsFile2 = (stateDir, id2) => import_node_path19.default.join(stateDir, "document", id2, "change-cursors.json");
+var import_node_fs24 = __toESM(require("node:fs"), 1);
+var import_node_path20 = __toESM(require("node:path"), 1);
+var cursorsFile2 = (stateDir, id2) => import_node_path20.default.join(stateDir, "document", id2, "change-cursors.json");
 var isOpId = (value) => typeof value === "object" && value !== null && typeof value.peer === "string" && Number.isInteger(value.counter);
 function read2(file) {
   try {
-    const value = JSON.parse(import_node_fs23.default.readFileSync(file, "utf8"));
+    const value = JSON.parse(import_node_fs24.default.readFileSync(file, "utf8"));
     if (typeof value !== "object" || value === null || Array.isArray(value)) return {};
     return Object.fromEntries(
       Object.entries(value).filter(
@@ -27265,8 +27400,8 @@ function createChangeCursors(stateDir) {
 }
 
 // src/server/document-asks.ts
-var import_node_fs24 = __toESM(require("node:fs"), 1);
-var import_node_path20 = __toESM(require("node:path"), 1);
+var import_node_fs25 = __toESM(require("node:fs"), 1);
+var import_node_path21 = __toESM(require("node:path"), 1);
 var blockOf = (asks, ask) => asks.find((a5) => a5.id === ask)?.blockId ?? "*";
 function humanAskOp(asks, threads2, op) {
   if (op.op !== "create") {
@@ -27311,8 +27446,8 @@ function askListing(asks, threads2) {
   };
 }
 function writeAsksFile(stateDir, id2, asks, threads2) {
-  const file = import_node_path20.default.join(stateDir, "document", id2, "asks.json");
-  if (!asks.length && !import_node_fs24.default.existsSync(file)) return;
+  const file = import_node_path21.default.join(stateDir, "document", id2, "asks.json");
+  if (!asks.length && !import_node_fs25.default.existsSync(file)) return;
   const latest2 = latestSubmission(threads2);
   writeJsonAtomic(file, {
     latest: latest2 ? { id: latest2.id, at: latest2.at, withdrawn: latest2.withdrawn } : null
@@ -27321,7 +27456,7 @@ function writeAsksFile(stateDir, id2, asks, threads2) {
 
 // src/server/document-session.ts
 var import_promises = __toESM(require("node:fs/promises"), 1);
-var import_node_path21 = __toESM(require("node:path"), 1);
+var import_node_path22 = __toESM(require("node:path"), 1);
 
 // ../../node_modules/.pnpm/lexical@0.53.0_typescript@6.0.3/node_modules/lexical/dist/Lexical.dev.js
 var Lexical_dev_exports = {};
@@ -28677,19 +28812,19 @@ var ElementDOMSlot = class _ElementDOMSlot extends DOMSlot {
   }
 };
 function indexPath(root, child) {
-  const path37 = [];
+  const path38 = [];
   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++;
     }
-    path37.push(i6);
+    path38.push(i6);
   }
   if (!(node === root)) {
     formatDevErrorMessage(`indexPath: root is not a parent of child`);
   }
-  return path37.reverse();
+  return path38.reverse();
 }
 var TEXT_MUTATION_VARIANCE = 100;
 var isProcessingMutations = false;
@@ -38049,9 +38184,9 @@ function getActiveElementDeep(root) {
 function getComposedEventTarget(event) {
   const target = event.target;
   if (target !== null && isHTMLElement(target) && target.shadowRoot !== null && typeof event.composedPath === "function") {
-    const path37 = event.composedPath();
-    if (path37.length > 0) {
-      return path37[0];
+    const path38 = event.composedPath();
+    if (path38.length > 0) {
+      return path38[0];
     }
   }
   return target;
@@ -50345,7 +50480,7 @@ var as = null;
 function us(t7) {
   as = t7;
 }
-var fs25 = /* @__PURE__ */ Symbol("INTERNAL_SKIP_AFTER_CLONE_FROM");
+var fs26 = /* @__PURE__ */ Symbol("INTERNAL_SKIP_AFTER_CLONE_FROM");
 var ds = 1;
 function hs() {
   ds = 1;
@@ -50817,7 +50952,7 @@ function Il(t7) {
   return ci(t7) || Fl(t7);
 }
 function Ll(t7, e5 = false) {
-  const n8 = t7.constructor.clone(t7, fs25);
+  const n8 = t7.constructor.clone(t7, fs26);
   return Ds(n8, null), n8.afterCloneFrom(t7), e5 || n8.resetOnCopyNodeFrom(t7), n8;
 }
 function Kl(t7) {
@@ -51062,7 +51197,7 @@ function wc(t7) {
   })(t7), Tc.set(t7, n8)), n8;
 }
 function Ec(t7) {
-  const e5 = t7.constructor.clone(t7, fs25);
+  const e5 = t7.constructor.clone(t7, fs26);
   return e5.afterCloneFrom(t7), e5;
 }
 function Ac(t7) {
@@ -51209,7 +51344,7 @@ function Bc(t7) {
           if (Kc(t9, "clone") || (t9.clone = (e7, n12) => {
             us(e7);
             const o10 = new t9();
-            return n12 !== fs25 && o10.afterCloneFrom(e7), o10;
+            return n12 !== fs26 && o10.afterCloneFrom(e7), o10;
           }), Kc(t9, "importJSON") || (t9.importJSON = o9 && o9.$importJSON || /* @__PURE__ */ (function(t10) {
             return (e7) => {
               const n12 = ga(t10);
@@ -55059,10 +55194,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 fs44 = null;
-    var path37 = null;
+    var fs45 = null;
+    var path38 = null;
     return new Promise((resolve, reject) => {
-      fs44.readFile(path37.resolve(__dirname, filepath), (error, buffer) => {
+      fs45.readFile(path38.resolve(__dirname, filepath), (error, buffer) => {
         if (error != null) {
           reject(error);
         } else {
@@ -56365,10 +56500,10 @@ var LoroDoc = class _LoroDoc {
    * @param {string} path
    * @returns {Value | Container | undefined}
    */
-  getByPath(path37) {
+  getByPath(path38) {
     try {
       const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
-      const ptr0 = passStringToWasm0(path37, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+      const ptr0 = passStringToWasm0(path38, 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);
@@ -63989,16 +64124,16 @@ var Diff = class {
       }
     }
   }
-  addToPath(path37, added, removed, oldPosInc, options2) {
-    const last = path37.lastComponent;
+  addToPath(path38, added, removed, oldPosInc, options2) {
+    const last = path38.lastComponent;
     if (last && !options2.oneChangePerToken && last.added === added && last.removed === removed) {
       return {
-        oldPos: path37.oldPos + oldPosInc,
+        oldPos: path38.oldPos + oldPosInc,
         lastComponent: { count: last.count + 1, added, removed, previousComponent: last.previousComponent }
       };
     } else {
       return {
-        oldPos: path37.oldPos + oldPosInc,
+        oldPos: path38.oldPos + oldPosInc,
         lastComponent: { count: 1, added, removed, previousComponent: last }
       };
     }
@@ -96642,10 +96777,10 @@ function $placeBlocks(runtime, $isTarget) {
   }
   const documentKey = $documentKey();
   for (const [key2, frame] of targets) {
-    const path37 = placeOf(frame);
-    let id2 = derivePositionalId(documentKey, path37);
+    const path38 = placeOf(frame);
+    let id2 = derivePositionalId(documentKey, path38);
     for (let attempt = 1; taken.has(id2); attempt++) {
-      id2 = derivePositionalId(documentKey, `${path37}#${attempt}`);
+      id2 = derivePositionalId(documentKey, `${path38}#${attempt}`);
     }
     taken.add(id2);
     placed.set(key2, id2);
@@ -100955,7 +101090,7 @@ async function readText(file) {
   }
 }
 async function writeAtomic(file, data) {
-  await import_promises.default.mkdir(import_node_path21.default.dirname(file), { recursive: true });
+  await import_promises.default.mkdir(import_node_path22.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);
@@ -100989,7 +101124,7 @@ async function createDocumentSession(options2) {
   let lastGoodText = null;
   let lastAgentText = null;
   let lastFileText = await readText(file) ?? "";
-  const activityFile = import_node_path21.default.join(import_node_path21.default.dirname(snapshotFile), "agent-active");
+  const activityFile = import_node_path22.default.join(import_node_path22.default.dirname(snapshotFile), "agent-active");
   let agentActiveAt = await lastAgentWrite(activityFile, file);
   let activitySaved = Promise.resolve();
   const emitStatus = () => emit({ type: "status", outcome, streaming: streaming > 0, agentActiveAt });
@@ -101059,6 +101194,14 @@ async function createDocumentSession(options2) {
       }
     });
   };
+  const refreshRefs = () => {
+    if (!options2.fillRefs || outcome.kind === "rejected" || streaming > 0) return;
+    const current = editor.getEditorState().toJSON();
+    const filled = options2.fillRefs(current);
+    if (JSON.stringify(filled) === JSON.stringify(current)) return;
+    reconcileWithIds(editor, filled, () => loro.setNextCommitMessage("refs"));
+    scheduleWrite();
+  };
   const saveSnapshot = async () => {
     if (!snapshotDirty) return;
     snapshotDirty = false;
@@ -101152,6 +101295,7 @@ async function createDocumentSession(options2) {
       scheduleWrite();
     },
     onFileText,
+    refreshRefs,
     subscribe: (listener) => {
       listeners.add(listener);
       return () => listeners.delete(listener);
@@ -101260,7 +101404,8 @@ function createDocumentRegistry(options2) {
     return session && !session.streaming() ? refWarnings(refsIn(session.state()), refLookup) : [];
   };
   const warnings = /* @__PURE__ */ new Map();
-  const docFile = (id2) => import_node_path22.default.join(options2.root, "document", id2, "doc.xml");
+  const rechecks = /* @__PURE__ */ new Map();
+  const docFile = (id2) => import_node_path23.default.join(options2.root, "document", id2, "doc.xml");
   const commentStores = /* @__PURE__ */ new Map();
   const cursors = createCommentCursors(options2.stateDir);
   const changeCursors = createChangeCursors(options2.stateDir);
@@ -101268,7 +101413,7 @@ function createDocumentRegistry(options2) {
     let store = commentStores.get(id2);
     if (!store) {
       store = createCommentStore(
-        import_node_path22.default.join(options2.root, "document", id2, "comments.json"),
+        import_node_path23.default.join(options2.root, "document", id2, "comments.json"),
         options2.names
       );
       commentStores.set(id2, store);
@@ -101301,10 +101446,10 @@ function createDocumentRegistry(options2) {
     if (JSON.stringify(store.warnings()) !== before2) options2.onWarningsChange(id2);
   };
   const create3 = async (id2) => {
-    if (!import_node_fs25.default.existsSync(docFile(id2))) return null;
+    if (!import_node_fs26.default.existsSync(docFile(id2))) return null;
     const session = await createDocumentSession({
       file: docFile(id2),
-      snapshotFile: import_node_path22.default.join(options2.stateDir, "document", id2, "doc.loro"),
+      snapshotFile: import_node_path23.default.join(options2.stateDir, "document", id2, "doc.loro"),
       fillRefs: (state2) => fillRefIds(state2, refLookup),
       ...options2.timing,
       log: options2.log
@@ -101323,6 +101468,7 @@ function createDocumentRegistry(options2) {
       return outcome.kind === "rejected" ? outcomeWarnings(outcome) : [...outcomeWarnings(outcome), ...diagramWarnings(session), ...liveRefWarnings(id2)];
     };
     setWarnings(currentWarnings());
+    rechecks.set(id2, () => setWarnings(currentWarnings()));
     session.subscribe((event) => {
       if (event.type === "update") {
         options2.broadcast({
@@ -101346,6 +101492,7 @@ function createDocumentRegistry(options2) {
         if (!event.streaming) refsChanged(id2, session);
       }
     });
+    session.refreshRefs();
     return session;
   };
   const open = (id2) => {
@@ -101364,11 +101511,18 @@ function createDocumentRegistry(options2) {
   };
   return {
     open,
+    artboardChanged: (slug) => {
+      for (const [id2, session] of ready) {
+        if (!refsIn(session.state()).some((ref) => ref.artboard === slug)) continue;
+        session.refreshRefs();
+        rechecks.get(id2)?.();
+      }
+    },
     fileChanged: (id2) => {
       const known = sessions.has(id2);
       void open(id2).then((session) => {
         if (!session || !known) return;
-        import_node_fs25.default.readFile(docFile(id2), "utf8", (err, text4) => {
+        import_node_fs26.default.readFile(docFile(id2), "utf8", (err, text4) => {
           if (!err) session.onFileText(text4);
         });
       });
@@ -101443,13 +101597,14 @@ function createDocumentRegistry(options2) {
       await Promise.all(all.map((session) => session?.close()));
       sessions.clear();
       ready.clear();
+      rechecks.clear();
     }
   };
 }
 
 // src/server/dynamic-blocks.ts
-var import_node_fs26 = __toESM(require("node:fs"), 1);
-var import_node_path23 = __toESM(require("node:path"), 1);
+var import_node_fs27 = __toESM(require("node:fs"), 1);
+var import_node_path24 = __toESM(require("node:path"), 1);
 function dynamicUrls(xml) {
   const urls = /* @__PURE__ */ new Set();
   for (const match of stripOpaque(xml).matchAll(TAG)) {
@@ -101462,7 +101617,7 @@ function dynamicUrls(xml) {
 }
 var mtimeOf = (file) => {
   try {
-    return import_node_fs26.default.statSync(file).mtimeMs;
+    return import_node_fs27.default.statSync(file).mtimeMs;
   } catch {
     return -1;
   }
@@ -101479,7 +101634,7 @@ function createDynamicBlocks(limits) {
   };
   const entry = (id2, dir, file) => {
     const map = files(id2);
-    const mtime = mtimeOf(import_node_path23.default.join(dir, file));
+    const mtime = mtimeOf(import_node_path24.default.join(dir, file));
     let state2 = map.get(file);
     if (!state2 || state2.mtime !== mtime) {
       state2 = { mtime, errors: [], ran: false };
@@ -101504,19 +101659,19 @@ function createDynamicBlocks(limits) {
     state(id2, dir) {
       let xml;
       try {
-        xml = import_node_fs26.default.readFileSync(import_node_path23.default.join(dir, "doc.xml"), "utf8");
+        xml = import_node_fs27.default.readFileSync(import_node_path24.default.join(dir, "doc.xml"), "utf8");
       } catch {
         return { warnings: [], dynamic: {} };
       }
       const urls = dynamicUrls(xml);
       const map = files(id2);
       for (const [file, state2] of map) {
-        if (!urls.includes(file) || state2.mtime !== mtimeOf(import_node_path23.default.join(dir, file))) map.delete(file);
+        if (!urls.includes(file) || state2.mtime !== mtimeOf(import_node_path24.default.join(dir, file))) map.delete(file);
       }
       const warnings = [];
       const dynamic = {};
       for (const url of urls) {
-        if (!import_node_fs26.default.existsSync(import_node_path23.default.join(dir, url))) warnings.push(`${url} not found`);
+        if (!import_node_fs27.default.existsSync(import_node_path24.default.join(dir, url))) warnings.push(`${url} not found`);
         const state2 = map.get(url);
         for (const error of state2?.errors ?? []) warnings.push(`runtime: ${url}: ${error}`);
         dynamic[url] = { ran: state2?.ran ?? false };
@@ -101532,7 +101687,7 @@ var MAX_COMMENT_OP = 64 * 1024;
 var MAX_DOCUMENT_UPDATE = 8 * 1024 * 1024;
 
 // src/server/artifact-file.ts
-var import_node_fs27 = __toESM(require("node:fs"), 1);
+var import_node_fs28 = __toESM(require("node:fs"), 1);
 var RESOLVE = {
   artboard: resolveBoardFile,
   document: resolveDocumentAsset,
@@ -101545,8 +101700,8 @@ function readArtifactFile(dir, type, relative, uiRuntimeUrl, maxBytes = Infinity
   if (!target) return null;
   let data;
   try {
-    if (import_node_fs27.default.statSync(target).size > maxBytes) throw new RangeError("too large");
-    data = import_node_fs27.default.readFileSync(target);
+    if (import_node_fs28.default.statSync(target).size > maxBytes) throw new RangeError("too large");
+    data = import_node_fs28.default.readFileSync(target);
   } catch (err) {
     if (err instanceof RangeError) throw err;
     return null;
@@ -101696,8 +101851,8 @@ async function handleRelay(ctx, key2, body, conn, contentOrigin = "") {
 }
 
 // src/server/selection.ts
-var import_node_fs28 = __toESM(require("node:fs"), 1);
-var import_node_path24 = __toESM(require("node:path"), 1);
+var import_node_fs29 = __toESM(require("node:fs"), 1);
+var import_node_path25 = __toESM(require("node:path"), 1);
 
 // src/shared/selection.ts
 var SELECTION_FULL_NODES = 20;
@@ -101812,7 +101967,7 @@ function readAnySelection(value) {
 function createSelectionStore(stateDir, exists) {
   const tabs = /* @__PURE__ */ new Map();
   let clock = 0;
-  const fileOf2 = (kind, id2) => import_node_path24.default.join(stateDir, kind, id2, "selection.json");
+  const fileOf2 = (kind, id2) => import_node_path25.default.join(stateDir, kind, id2, "selection.json");
   const write = (kind, id2) => {
     let winner;
     for (const tab of tabs.values()) {
@@ -101820,7 +101975,7 @@ function createSelectionStore(stateDir, exists) {
       if (!winner || tab.humanAt > winner.humanAt || tab.humanAt === winner.humanAt && tab.seenAt > winner.seenAt)
         winner = tab;
     }
-    if (!winner?.state) import_node_fs28.default.rmSync(fileOf2(kind, id2), { force: true });
+    if (!winner?.state) import_node_fs29.default.rmSync(fileOf2(kind, id2), { force: true });
     else
       writeJsonAtomic(fileOf2(kind, id2), {
         artifact: `${kind}/${id2}`,
@@ -101862,11 +102017,11 @@ function createSelectionStore(stateDir, exists) {
       for (const kind of ["artboard", "document"]) {
         let ids;
         try {
-          ids = import_node_fs28.default.readdirSync(import_node_path24.default.join(stateDir, kind));
+          ids = import_node_fs29.default.readdirSync(import_node_path25.default.join(stateDir, kind));
         } catch {
           continue;
         }
-        for (const id2 of ids) import_node_fs28.default.rmSync(fileOf2(kind, id2), { force: true });
+        for (const id2 of ids) import_node_fs29.default.rmSync(fileOf2(kind, id2), { force: true });
       }
     }
   };
@@ -101874,13 +102029,13 @@ function createSelectionStore(stateDir, exists) {
 
 // src/server/verify-recordings.ts
 var import_node_crypto11 = __toESM(require("node:crypto"), 1);
-var import_node_fs30 = __toESM(require("node:fs"), 1);
-var import_node_path26 = __toESM(require("node:path"), 1);
+var import_node_fs31 = __toESM(require("node:fs"), 1);
+var import_node_path27 = __toESM(require("node:path"), 1);
 
 // src/server/recording-trim.ts
 var import_node_child_process3 = require("node:child_process");
-var import_node_fs29 = __toESM(require("node:fs"), 1);
-var import_node_path25 = __toESM(require("node:path"), 1);
+var import_node_fs30 = __toESM(require("node:fs"), 1);
+var import_node_path26 = __toESM(require("node:path"), 1);
 function run2(command, args, signal3) {
   return new Promise((resolve, reject) => {
     (0, import_node_child_process3.execFile)(
@@ -101900,7 +102055,7 @@ function run2(command, args, signal3) {
   });
 }
 async function trimRecording(input, output, signal3) {
-  if (input === output || import_node_fs29.default.existsSync(output))
+  if (input === output || import_node_fs30.default.existsSync(output))
     throw new Error("Choose a new output path; existing files are never overwritten.");
   const probe = JSON.parse(
     (await run2(
@@ -101972,9 +102127,9 @@ async function trimRecording(input, output, signal3) {
     if (start > 0 || end < duration) status = "trimmed";
   }
   if (status === "trimmed") {
-    const temporary = import_node_fs29.default.mkdtempSync(import_node_path25.default.join(import_node_path25.default.dirname(output), ".trim-"));
+    const temporary = import_node_fs30.default.mkdtempSync(import_node_path26.default.join(import_node_path26.default.dirname(output), ".trim-"));
     try {
-      const encoded = import_node_path25.default.join(temporary, "clip.mp4");
+      const encoded = import_node_path26.default.join(temporary, "clip.mp4");
       await run2(
         "ffmpeg",
         [
@@ -102010,9 +102165,9 @@ async function trimRecording(input, output, signal3) {
         ],
         signal3
       );
-      import_node_fs29.default.linkSync(encoded, output);
+      import_node_fs30.default.linkSync(encoded, output);
     } finally {
-      import_node_fs29.default.rmSync(temporary, { recursive: true, force: true });
+      import_node_fs30.default.rmSync(temporary, { recursive: true, force: true });
     }
   }
   return { duration, start, end, removed: duration - (end - start), status };
@@ -102023,7 +102178,7 @@ var POLICY = "idle-ends-v2";
 var STABLE_MS = 750;
 var digest2 = (data) => import_node_crypto11.default.createHash("sha256").update(data).digest("hex");
 var stamp2 = (file) => {
-  const stat = import_node_fs30.default.statSync(file);
+  const stat = import_node_fs31.default.statSync(file);
   return `${stat.dev}:${stat.ino}:${stat.size}:${stat.mtimeMs}:${stat.ctimeMs}`;
 };
 function createVerifyRecordings(options2) {
@@ -102037,7 +102192,7 @@ function createVerifyRecordings(options2) {
   const notify = (job) => {
     if (current(job)) options2.onChange(job.artifact);
   };
-  const cacheDir = import_node_path26.default.join(options2.stateDir, "recordings");
+  const cacheDir = import_node_path27.default.join(options2.stateDir, "recordings");
   async function process2(job) {
     let temporary;
     try {
@@ -102046,7 +102201,7 @@ function createVerifyRecordings(options2) {
         options2.onChange(job.artifact);
         return;
       }
-      const bytes = await import_node_fs30.default.promises.readFile(job.file);
+      const bytes = await import_node_fs31.default.promises.readFile(job.file);
       if (!current(job)) return;
       if (stamp2(job.file) !== job.stamp) {
         jobs.delete(job.key);
@@ -102054,22 +102209,22 @@ function createVerifyRecordings(options2) {
         return;
       }
       const key2 = digest2(`${POLICY}:${digest2(bytes)}`);
-      const dir = import_node_path26.default.join(cacheDir, key2);
-      const output = import_node_path26.default.join(dir, "clip.mp4");
-      const metadata = import_node_path26.default.join(dir, "result.json");
+      const dir = import_node_path27.default.join(cacheDir, key2);
+      const output = import_node_path27.default.join(dir, "clip.mp4");
+      const metadata = import_node_path27.default.join(dir, "result.json");
       let cached;
       try {
-        const saved = JSON.parse(import_node_fs30.default.readFileSync(metadata, "utf8"));
-        if (saved.result.status !== "trimmed" || import_node_fs30.default.existsSync(output) && saved.hash === digest2(import_node_fs30.default.readFileSync(output)))
+        const saved = JSON.parse(import_node_fs31.default.readFileSync(metadata, "utf8"));
+        if (saved.result.status !== "trimmed" || import_node_fs31.default.existsSync(output) && saved.hash === digest2(import_node_fs31.default.readFileSync(output)))
           cached = saved;
       } catch {
       }
       if (!cached) {
-        import_node_fs30.default.mkdirSync(cacheDir, { recursive: true });
-        temporary = import_node_fs30.default.mkdtempSync(import_node_path26.default.join(cacheDir, ".prepare-"));
-        const input = import_node_path26.default.join(temporary, "capture");
-        const prepared = import_node_path26.default.join(temporary, "clip.mp4");
-        import_node_fs30.default.writeFileSync(input, bytes);
+        import_node_fs31.default.mkdirSync(cacheDir, { recursive: true });
+        temporary = import_node_fs31.default.mkdtempSync(import_node_path27.default.join(cacheDir, ".prepare-"));
+        const input = import_node_path27.default.join(temporary, "capture");
+        const prepared = import_node_path27.default.join(temporary, "clip.mp4");
+        import_node_fs31.default.writeFileSync(input, bytes);
         const result = await (options2.prepare ?? trimRecording)(
           input,
           prepared,
@@ -102081,9 +102236,9 @@ function createVerifyRecordings(options2) {
           options2.onChange(job.artifact);
           return;
         }
-        import_node_fs30.default.mkdirSync(dir, { recursive: true });
-        const hash2 = result.status === "trimmed" ? digest2(import_node_fs30.default.readFileSync(prepared)) : void 0;
-        if (result.status === "trimmed") import_node_fs30.default.copyFileSync(prepared, output);
+        import_node_fs31.default.mkdirSync(dir, { recursive: true });
+        const hash2 = result.status === "trimmed" ? digest2(import_node_fs31.default.readFileSync(prepared)) : void 0;
+        if (result.status === "trimmed") import_node_fs31.default.copyFileSync(prepared, output);
         cached = { result, ...hash2 ? { hash: hash2 } : {} };
         writeJsonAtomic(metadata, cached);
       }
@@ -102116,7 +102271,7 @@ function createVerifyRecordings(options2) {
       };
       notify(job);
     } finally {
-      if (temporary) import_node_fs30.default.rmSync(temporary, { recursive: true, force: true });
+      if (temporary) import_node_fs31.default.rmSync(temporary, { recursive: true, force: true });
     }
   }
   function pump() {
@@ -102182,7 +102337,7 @@ function createVerifyRecordings(options2) {
         if (job.state.status === "processing") pending.add(boardId);
         if (job.virtual && job.output) {
           canvas.boards[boardId] = { ...board, file: job.virtual, src: job.virtual };
-          versions[job.virtual] = import_node_fs30.default.statSync(job.output).mtimeMs;
+          versions[job.virtual] = import_node_fs31.default.statSync(job.output).mtimeMs;
         }
       }
       for (const job of jobs.values()) if (job.artifact === id2 && !active.has(job.key)) stop(job);
@@ -102211,7 +102366,7 @@ function createVerifyRecordings(options2) {
           continue;
         const original = job.key.slice(id2.length + 1);
         if (!referenced.has(original)) overrides.set(original, null);
-        overrides.set(job.virtual, import_node_fs30.default.readFileSync(job.output));
+        overrides.set(job.virtual, import_node_fs31.default.readFileSync(job.output));
       }
       if (overrides.size) overrides.set("canvas.json", Buffer.from(JSON.stringify(payload.canvas)));
       return overrides;
@@ -102251,18 +102406,18 @@ function titleOf(payload) {
   return "Untitled artifact";
 }
 function createServerContext(options2) {
-  const root = import_node_path27.default.resolve(options2.root);
-  const viewerDir = import_node_path27.default.resolve(options2.viewerDir);
-  const runtimeDir = options2.runtimeDir ? import_node_path27.default.resolve(options2.runtimeDir) : null;
-  const stateDir = import_node_path27.default.join(root, ".state");
-  import_node_fs31.default.mkdirSync(stateDir, { recursive: true, mode: 448 });
-  import_node_fs31.default.writeFileSync(import_node_path27.default.join(stateDir, ".gitignore"), "*\n");
+  const root = import_node_path28.default.resolve(options2.root);
+  const viewerDir = import_node_path28.default.resolve(options2.viewerDir);
+  const runtimeDir = options2.runtimeDir ? import_node_path28.default.resolve(options2.runtimeDir) : null;
+  const stateDir = import_node_path28.default.join(root, ".state");
+  import_node_fs32.default.mkdirSync(stateDir, { recursive: true, mode: 448 });
+  import_node_fs32.default.writeFileSync(import_node_path28.default.join(stateDir, ".gitignore"), "*\n");
   if (options2.configFile) ensureConfig(options2.configFile);
-  const portFile = import_node_path27.default.join(stateDir, ".last-port");
-  const tokenFile = import_node_path27.default.join(stateDir, ".last-token");
+  const portFile = import_node_path28.default.join(stateDir, ".last-port");
+  const tokenFile = import_node_path28.default.join(stateDir, ".last-token");
   const mount = options2.mount;
   const token = mount?.token ?? (readPersisted(tokenFile) || randomToken());
-  if (!mount) import_node_fs31.default.writeFileSync(tokenFile, `${token}
+  if (!mount) import_node_fs32.default.writeFileSync(tokenFile, `${token}
 `, { mode: 384 });
   const contentToken = randomToken();
   const loopback = isLoopbackHost(options2.host);
@@ -102296,6 +102451,22 @@ function createServerContext(options2) {
   );
   selections.clearAll();
   const changeListeners = [];
+  const agentStatus = createAgentStatus(root);
+  const agentStatusFrame = () => textFrame(
+    JSON.stringify({
+      type: "agent-status",
+      artifact: "*",
+      sessions: agentStatus.sessions()
+    })
+  );
+  const publishAgentStatus = () => {
+    const frame = agentStatusFrame();
+    for (const socket of clients) socket.write(frame);
+  };
+  changeListeners.push((ref, _payload, files) => {
+    if (agentWrittenFiles(files).length > 0 && agentStatus.touched(`${ref.type}/${ref.id}`))
+      publishAgentStatus();
+  });
   const activityListeners = [];
   const startedAt = Date.now();
   const touch = () => {
@@ -102318,8 +102489,8 @@ function createServerContext(options2) {
   };
   const avatars = createAvatars(options2.fetch);
   const names = commentNames({
-    agentFile: import_node_path27.default.join(stateDir, "agent"),
-    projectDir: import_node_path27.default.resolve(root, "../.."),
+    agentFile: import_node_path28.default.join(stateDir, "agent"),
+    projectDir: import_node_path28.default.resolve(root, "../.."),
     cloud: options2.cloud
   });
   const recordings = createVerifyRecordings({
@@ -102373,6 +102544,7 @@ function createServerContext(options2) {
   const listeningTimer = setInterval(() => {
     boardComments.refreshListening();
     documents.refreshListening();
+    if (agentStatus.expire(Date.now())) publishAgentStatus();
   }, 3e3);
   listeningTimer.unref();
   const inspect = async (ref) => {
@@ -102414,13 +102586,13 @@ function createServerContext(options2) {
   const cloud = options2.cloud && options2.configFile ? createCloudRoutes({
     ...options2.cloud,
     configFile: options2.configFile,
-    project: import_node_path27.default.basename(import_node_path27.default.resolve(root, "../..")),
+    project: import_node_path28.default.basename(import_node_path28.default.resolve(root, "../..")),
     address: (ref) => artifactPath(root, ref.type, ref.id).split("/").pop(),
     references: (ref) => {
       if (ref.type !== "document") return [];
       const dir = resolveArtifactDir(root, "document", ref.id);
-      const file = dir ? import_node_path27.default.join(dir, "doc.xml") : null;
-      const xml = file && import_node_fs31.default.existsSync(file) ? import_node_fs31.default.readFileSync(file, "utf8") : "";
+      const file = dir ? import_node_path28.default.join(dir, "doc.xml") : null;
+      const xml = file && import_node_fs32.default.existsSync(file) ? import_node_fs32.default.readFileSync(file, "utf8") : "";
       return [...xml.matchAll(REF_ARTBOARD)].map((match) => match[1]).filter((slug) => resolveArtifactDir(root, "artboard", slug) !== null);
     },
     port: () => ctx.port,
@@ -102430,7 +102602,7 @@ function createServerContext(options2) {
     }
   }) : null;
   const autoPublisher = cloud ? createAutoPublisher({
-    stateFile: import_node_path27.default.join(stateDir, "auto-publish.json"),
+    stateFile: import_node_path28.default.join(stateDir, "auto-publish.json"),
     enabled: cloud.autoPublishEnabled,
     token: cloud.token,
     publish: async (key2) => {
@@ -102492,7 +102664,7 @@ function createServerContext(options2) {
       );
       if (ref.type === "artboard")
         writeJsonAtomic(
-          import_node_path27.default.join(stateDir, "artboard", ref.id, "backlinks.json"),
+          import_node_path28.default.join(stateDir, "artboard", ref.id, "backlinks.json"),
           backlinksOf(ref.id)
         );
     } catch (err) {
@@ -102558,6 +102730,9 @@ function createServerContext(options2) {
     clients,
     selections,
     changeListeners,
+    agentStatus,
+    agentStatusFrame,
+    publishAgentStatus,
     activityListeners,
     relayListeners,
     direct,
@@ -102582,7 +102757,7 @@ function createServerContext(options2) {
   };
   return ctx;
 }
-var projectName = (ctx) => import_node_path27.default.basename(import_node_path27.default.dirname(import_node_path27.default.dirname(ctx.root)));
+var projectName = (ctx) => import_node_path28.default.basename(import_node_path28.default.dirname(import_node_path28.default.dirname(ctx.root)));
 
 // ../../node_modules/.pnpm/ws@8.18.3/node_modules/ws/wrapper.mjs
 var import_stream = __toESM(require_stream(), 1);
@@ -102730,8 +102905,8 @@ function createRelayClient(options2) {
 }
 
 // src/server/routes/content.ts
-var import_node_fs32 = __toESM(require("node:fs"), 1);
-var import_node_path28 = __toESM(require("node:path"), 1);
+var import_node_fs33 = __toESM(require("node:fs"), 1);
+var import_node_path29 = __toESM(require("node:path"), 1);
 function serveContent(ctx, res, rest, range, mode = "main") {
   const { root, runtimeDir, recordings, options: options2 } = ctx;
   if (rest.startsWith("runtime/")) {
@@ -102782,7 +102957,7 @@ function serveContent(ctx, res, rest, range, mode = "main") {
     sendFile(res, target, headers, range);
     return;
   }
-  import_node_fs32.default.readFile(target, "utf8", (err, source) => {
+  import_node_fs33.default.readFile(target, "utf8", (err, source) => {
     if (err) send(res, 404, "Not found");
     else {
       const uiRuntimeUrl = runtimeDir ? `${mode === "board" ? "/c/" : ctx.contentPrefix}runtime/ryugi-ui.js` : void 0;
@@ -102818,7 +102993,7 @@ var robotsRoute = {
   path: "/robots.txt",
   auth: "public",
   handle: (_req, res, ctx) => {
-    sendFile(res, import_node_path28.default.join(ctx.viewerDir, "robots.txt"));
+    sendFile(res, import_node_path29.default.join(ctx.viewerDir, "robots.txt"));
   }
 };
 var contentRoute = {
@@ -102865,8 +103040,8 @@ var createBoardRequestHandler = (ctx) => (req, res) => {
 };
 
 // src/server/routes/agent.ts
-var import_node_fs33 = __toESM(require("node:fs"), 1);
-var import_node_path29 = __toESM(require("node:path"), 1);
+var import_node_fs34 = __toESM(require("node:fs"), 1);
+var import_node_path30 = __toESM(require("node:path"), 1);
 
 // src/server/routes/comments.ts
 var API_BOARD_COMMENTS_ROUTE = /^\/api\/artboard\/([^/]+)\/comments$/;
@@ -102921,7 +103096,7 @@ var CHECK_MERGE_WAIT_MS = 6e4;
 var agentName = (fields) => typeof fields.agent === "string" && fields.agent.length > 0 && fields.agent.length <= 100 ? fields.agent : void 0;
 var blockIdsOf = async (ctx, id2, dir) => {
   await (await ctx.documents.open(id2))?.flush();
-  const state2 = parseDocument2(import_node_fs33.default.readFileSync(import_node_path29.default.join(dir, "doc.xml"), "utf8"));
+  const state2 = parseDocument2(import_node_fs34.default.readFileSync(import_node_path30.default.join(dir, "doc.xml"), "utf8"));
   return new Set(
     state2.root.children.flatMap(
       (block) => block.$?.blockId ? [block.$.blockId] : []
@@ -103003,8 +103178,10 @@ function agentAskRequest(fields) {
 }
 function agentVerdictOf(fields) {
   const verdict = fields.verdict;
-  if (verdict !== "pass" && verdict !== "reject") throw new Error('verdict needs {verdict: "pass" | "reject"}');
-  if (fields.all !== true && !isId(fields.group)) throw new Error("verdict needs {group} or {all: true}");
+  if (verdict !== "pass" && verdict !== "reject")
+    throw new Error('verdict needs {verdict: "pass" | "reject"}');
+  if (fields.all !== true && !isId(fields.group))
+    throw new Error("verdict needs {group} or {all: true}");
   const text4 = typeof fields.text === "string" ? fields.text.trim() : "";
   if (verdict === "reject" && !text4) throw new Error("a reject needs a reason: pass {text}");
   return {
@@ -103096,7 +103273,7 @@ async function serveAgentCheck(res, ctx, type, id2) {
   let merging = false;
   if (ref.type === "document") {
     const session = await documents.open(ref.id);
-    const text4 = await import_node_fs33.default.promises.readFile(import_node_path29.default.join(dir, "doc.xml"), "utf8").catch(() => null);
+    const text4 = await import_node_fs34.default.promises.readFile(import_node_path30.default.join(dir, "doc.xml"), "utf8").catch(() => null);
     if (session && text4 !== null) {
       session.onFileText(text4);
       const timeout = new Promise(
@@ -103106,14 +103283,20 @@ async function serveAgentCheck(res, ctx, type, id2) {
     }
   }
   const payload = ctx.writeState(ref, dir);
-  const state2 = JSON.parse(await import_node_fs33.default.promises.readFile(import_node_path29.default.join(stateDir, ref.type, ref.id, "warnings.json"), "utf8"));
+  const state2 = JSON.parse(
+    await import_node_fs34.default.promises.readFile(import_node_path30.default.join(stateDir, ref.type, ref.id, "warnings.json"), "utf8")
+  );
   const dynamic = Object.values(state2.dynamic ?? {});
   const required = ref.type === "html" || dynamic.length > 0 || ref.type === "artboard" && "canvas" in payload && Object.values(payload.canvas?.boards ?? {}).some((board) => !isMediaBoard(board));
   const observed = ref.type === "html" ? state2.ran : dynamic.length ? dynamic.every((block) => block.ran === true) : required ? void 0 : true;
   sendJson(res, 200, {
     ...state2,
     ...merging ? { merging: true } : {},
-    evidence: { required, observed, fresh: !merging && signatures.get(key2) === artifactSignature(dir, ref.type) }
+    evidence: {
+      required,
+      observed,
+      fresh: !merging && signatures.get(key2) === artifactSignature(dir, ref.type)
+    }
   });
 }
 async function serveAgentChanges(req, res, ctx, id2) {
@@ -103123,7 +103306,11 @@ async function serveAgentChanges(req, res, ctx, id2) {
   }
   const body = await readCommentBody(req);
   const fields = typeof body === "object" && body !== null ? body : {};
-  const changes = await ctx.documents.changes(id2, agentName(fields) ?? "Agent", fields.all === true);
+  const changes = await ctx.documents.changes(
+    id2,
+    agentName(fields) ?? "Agent",
+    fields.all === true
+  );
   if (!changes) {
     sendJson(res, 404, { error: `document/${id2} not found` });
     return;
@@ -103154,6 +103341,28 @@ var agentCheckRoute = {
   auth: "agent",
   handle: (_req, res, ctx, { match }) => serveAgentCheck(res, ctx, match[1], match[2])
 };
+var isAgentEvent = (value) => {
+  if (typeof value !== "object" || value === null) return false;
+  const event = value;
+  const text4 = (field, max) => typeof field === "string" && field.length > 0 && field.length <= max;
+  return (event.host === "claude" || event.host === "codex") && text4(event.session, 200) && text4(event.event, 64) && typeof event.at === "number" && Number.isFinite(event.at) && (event.tool === void 0 || text4(event.tool, 64)) && (event.paths === void 0 || Array.isArray(event.paths) && event.paths.length <= 64 && event.paths.every((file) => text4(file, 4096)));
+};
+var agentEventRoute = {
+  path: "/api/agent/event",
+  methods: ["POST"],
+  auth: "agent",
+  handle: async (req, res, ctx) => {
+    const body = await readCommentBody(req);
+    if (!isAgentEvent(body)) {
+      sendJson(res, 400, {
+        error: "not an agent event: need host, session, event, at and optional paths"
+      });
+      return;
+    }
+    if (ctx.agentStatus.apply(body)) ctx.publishAgentStatus();
+    send(res, 204, "");
+  }
+};
 
 // src/server/routes/agent-review.ts
 var schema = "ryugi.review/v1";
@@ -103178,7 +103387,9 @@ function options(body, artifact) {
 }
 async function threads(ctx, type, id2, input) {
   if (type === "document") {
-    const views2 = new Map(ctx.documents.listComments(id2, input.agent, true).map((thread) => [thread.id, thread]));
+    const views2 = new Map(
+      ctx.documents.listComments(id2, input.agent, true).map((thread) => [thread.id, thread])
+    );
     const file2 = ctx.documents.comments(id2);
     return ctx.agentReview.threads({
       ...input,
@@ -103189,7 +103400,9 @@ async function threads(ctx, type, id2, input) {
       }))
     });
   }
-  const views = new Map(ctx.boardComments.list(id2, input.agent, true).map((thread) => [thread.id, thread]));
+  const views = new Map(
+    ctx.boardComments.list(id2, input.agent, true).map((thread) => [thread.id, thread])
+  );
   const file = ctx.boardComments.comments(id2);
   return ctx.agentReview.threads({
     ...input,
@@ -103202,7 +103415,8 @@ async function threads(ctx, type, id2, input) {
 }
 async function state(ctx, type, id2, input, section) {
   let items = [];
-  if (section === "asks" && type === "document") items = (await ctx.documents.asks(id2)).asks.map((ask) => ({ ...ask }));
+  if (section === "asks" && type === "document")
+    items = (await ctx.documents.asks(id2)).asks.map((ask) => ({ ...ask }));
   else if (section === "groups" && type === "artboard")
     items = ctx.boardComments.groups(id2).map((group) => ({ ...group }));
   else if (section === "rounds" && type === "artboard")
@@ -103238,9 +103452,13 @@ async function serve(req, res, ctx, type, id2, operation) {
       return;
     }
     if (operation === "changes") {
-      if (type !== "document") throw new ReviewError("E_ARGUMENT_INVALID", "Changes apply to documents only.");
+      if (type !== "document")
+        throw new ReviewError("E_ARGUMENT_INVALID", "Changes apply to documents only.");
       if (input.detail && (input.limit !== void 0 || input.cursor || input.fields))
-        throw new ReviewError("E_ARGUMENT_INVALID", "A complete diff cannot use pagination or fields.");
+        throw new ReviewError(
+          "E_ARGUMENT_INVALID",
+          "A complete diff cannot use pagination or fields."
+        );
       const session = await ctx.documents.open(id2);
       if (!session) throw new ReviewError("E_ARTIFACT_NOT_FOUND", "Document not found.", 404);
       const value = await ctx.agentReview.changes({
@@ -103253,7 +103471,26 @@ async function serve(req, res, ctx, type, id2, operation) {
     const section = body.op === "read" ? "threads" : text2(body.section);
     if (body.op !== "list" && body.op !== "read")
       throw new ReviewError("E_ARGUMENT_INVALID", "Expected list, read or ack.");
-    if (body.op === "read" && !input.thread) throw new ReviewError("E_ARGUMENT_INVALID", "A thread ID is required.");
+    if (body.op === "read" && !input.thread)
+      throw new ReviewError("E_ARGUMENT_INVALID", "A thread ID is required.");
+    if (body.sections !== void 0) {
+      if (body.op !== "list" || !Array.isArray(body.sections) || !body.sections.every((item2) => typeof item2 === "string"))
+        throw new ReviewError(
+          "E_ARGUMENT_INVALID",
+          "sections requires a list of collection names and op=list."
+        );
+      const error = validateReviewBundle(
+        { ...input, section, sections: body.sections },
+        input.artifact
+      );
+      if (error) throw new ReviewError("E_ARGUMENT_INVALID", error);
+      const sections = {};
+      for (const name of body.sections) {
+        sections[name] = name === "threads" ? await threads(ctx, type, id2, input) : await state(ctx, type, id2, input, name);
+      }
+      sendJson(res, 200, { schema, artifact: input.artifact, sections });
+      return;
+    }
     validateSection(input, section);
     if (section === "threads")
       sendJson(res, 200, {
@@ -103787,6 +104024,7 @@ var clientSocketRoute = {
   handle: (_req, socket, ctx, { clientKey }) => {
     completeHandshake(socket, clientKey);
     ctx.clients.add(socket);
+    socket.write(ctx.agentStatusFrame());
     handleClientFrames(socket, (text4) => onClientText(ctx, socket, text4));
     const forget = () => {
       ctx.clients.delete(socket);
@@ -103803,8 +104041,8 @@ var clientSocketRoute = {
 };
 
 // src/server/routes/viewer.ts
-var import_node_fs34 = __toESM(require("node:fs"), 1);
-var import_node_path30 = __toESM(require("node:path"), 1);
+var import_node_fs35 = __toESM(require("node:fs"), 1);
+var import_node_path31 = __toESM(require("node:path"), 1);
 
 // src/shared/type-icons.ts
 var TYPE_GLYPHS = {
@@ -103924,8 +104162,8 @@ function serveShell(req, res, ctx, { pathname, key: key2 }, embedded) {
   if (ref) headers["Referrer-Policy"] = "same-origin";
   if (key2 !== null && !loopback)
     headers["Set-Cookie"] = `${ctx.cookieName}=${ctx.token}; HttpOnly; SameSite=Strict; Path=/`;
-  const entry = preview2 && import_node_fs34.default.existsSync(import_node_path30.default.join(viewerDir, "preview.html")) ? "preview.html" : "index.html";
-  void import_node_fs34.default.promises.readFile(import_node_path30.default.join(viewerDir, entry), "utf8").then((template) => {
+  const entry = preview2 && import_node_fs35.default.existsSync(import_node_path31.default.join(viewerDir, "preview.html")) ? "preview.html" : "index.html";
+  void import_node_fs35.default.promises.readFile(import_node_path31.default.join(viewerDir, entry), "utf8").then((template) => {
     const html = viewerPage(template, {
       title,
       description,
@@ -103994,6 +104232,7 @@ var HTTP_ROUTES = [
   agentChangesRoute,
   agentBoardCommentsRoute,
   agentCheckRoute,
+  agentEventRoute,
   boardCommentsRoute,
   documentStateRoute,
   documentWriteRoute,
@@ -104141,7 +104380,7 @@ async function startArtifactsServer(options2) {
     } catch {
       ctx.port = await listen(server, options2.host, 0);
     }
-    import_node_fs35.default.writeFileSync(ctx.portFile, `${ctx.port}
+    import_node_fs36.default.writeFileSync(ctx.portFile, `${ctx.port}
 `, { mode: 384 });
   }
   const port = ctx.port;
@@ -104150,7 +104389,7 @@ async function startArtifactsServer(options2) {
   const boardServer = import_node_http.default.createServer(handleBoardRequest);
   if (mount) ctx.boardPort = mount.boardPort;
   else if (loopback) {
-    const boardPortFile = import_node_path31.default.join(stateDir, BOARD_PORT_FILE);
+    const boardPortFile = import_node_path32.default.join(stateDir, BOARD_PORT_FILE);
     const previousBoardPort = Number(readPersisted(boardPortFile));
     try {
       ctx.boardPort = await listen(
@@ -104161,7 +104400,7 @@ async function startArtifactsServer(options2) {
     } catch {
       ctx.boardPort = await listen(boardServer, options2.host, 0);
     }
-    import_node_fs35.default.writeFileSync(boardPortFile, `${ctx.boardPort}
+    import_node_fs36.default.writeFileSync(boardPortFile, `${ctx.boardPort}
 `, { mode: 384 });
   }
   const boardPort = ctx.boardPort;
@@ -104180,7 +104419,7 @@ async function startArtifactsServer(options2) {
     initialChanges.push({ ref: entry, payload, files: [] });
     if (entry.type === "document") void ctx.documents.open(entry.id);
   }
-  writeJsonAtomic(import_node_path31.default.join(stateDir, "server-info"), {
+  writeJsonAtomic(import_node_path32.default.join(stateDir, "server-info"), {
     type: "server-started",
     url,
     port,
@@ -104263,66 +104502,66 @@ async function startArtifactsServer(options2) {
         server.closeAllConnections();
       });
       await ctx.documents.close().catch(() => void 0);
-      if (mount) import_node_fs35.default.rmSync(import_node_path31.default.join(stateDir, "server-info"), { force: true });
+      if (mount) import_node_fs36.default.rmSync(import_node_path32.default.join(stateDir, "server-info"), { force: true });
     }
   };
 }
 var mountArtifactsProject = (options2) => startArtifactsServer(options2);
 
 // src/server/artifact-index.ts
-var import_node_fs37 = __toESM(require("node:fs"), 1);
-var import_node_path33 = __toESM(require("node:path"), 1);
+var import_node_fs38 = __toESM(require("node:fs"), 1);
+var import_node_path34 = __toESM(require("node:path"), 1);
 
 // src/server/machine.ts
-var import_node_fs36 = __toESM(require("node:fs"), 1);
+var import_node_fs37 = __toESM(require("node:fs"), 1);
 var import_node_os = __toESM(require("node:os"), 1);
-var import_node_path32 = __toESM(require("node:path"), 1);
+var import_node_path33 = __toESM(require("node:path"), 1);
 var DORMANT_AFTER_MS = 7 * 24 * 60 * 60 * 1e3;
 function machinePaths(env = process.env, homedir = import_node_os.default.homedir()) {
-  const home = env.RYUGI_SERVER_HOME || import_node_path32.default.join(homedir, ".ryugi", "server");
+  const home = env.RYUGI_SERVER_HOME || import_node_path33.default.join(homedir, ".ryugi", "server");
   return {
     home,
-    pid: import_node_path32.default.join(home, "server.pid"),
-    serverId: import_node_path32.default.join(home, "server-instance-id"),
-    info: import_node_path32.default.join(home, "server-info"),
-    log: import_node_path32.default.join(home, "server.log"),
-    version: import_node_path32.default.join(home, "server-version"),
-    lock: import_node_path32.default.join(home, "start.lock"),
-    key: import_node_path32.default.join(home, "key"),
-    projects: import_node_path32.default.join(home, "projects.json"),
-    settings: import_node_path32.default.join(home, "settings.json"),
-    stopped: import_node_path32.default.join(home, "server-stopped")
+    pid: import_node_path33.default.join(home, "server.pid"),
+    serverId: import_node_path33.default.join(home, "server-instance-id"),
+    info: import_node_path33.default.join(home, "server-info"),
+    log: import_node_path33.default.join(home, "server.log"),
+    version: import_node_path33.default.join(home, "server-version"),
+    lock: import_node_path33.default.join(home, "start.lock"),
+    key: import_node_path33.default.join(home, "key"),
+    projects: import_node_path33.default.join(home, "projects.json"),
+    settings: import_node_path33.default.join(home, "settings.json"),
+    stopped: import_node_path33.default.join(home, "server-stopped")
   };
 }
 function ensureHome(home) {
-  import_node_fs36.default.mkdirSync(home, { recursive: true, mode: 448 });
-  import_node_fs36.default.chmodSync(home, 448);
+  import_node_fs37.default.mkdirSync(home, { recursive: true, mode: 448 });
+  import_node_fs37.default.chmodSync(home, 448);
 }
 var realDir = (dir) => {
   try {
-    return import_node_fs36.default.realpathSync(import_node_path32.default.resolve(dir));
+    return import_node_fs37.default.realpathSync(import_node_path33.default.resolve(dir));
   } catch {
-    return import_node_path32.default.resolve(dir);
+    return import_node_path33.default.resolve(dir);
   }
 };
 var validEntry = (value) => {
   const entry = value;
-  return !!entry && typeof entry.dir === "string" && import_node_path32.default.isAbsolute(entry.dir) && Number.isFinite(entry.registeredAt) && Number.isFinite(entry.lastUsedAt);
+  return !!entry && typeof entry.dir === "string" && import_node_path33.default.isAbsolute(entry.dir) && Number.isFinite(entry.registeredAt) && Number.isFinite(entry.lastUsedAt);
 };
 function readProjects(file) {
   try {
-    const value = JSON.parse(import_node_fs36.default.readFileSync(file, "utf8"));
+    const value = JSON.parse(import_node_fs37.default.readFileSync(file, "utf8"));
     return Array.isArray(value.projects) ? value.projects.filter(validEntry) : [];
   } catch {
     return [];
   }
 }
 function writeProjects(file, projects) {
-  ensureHome(import_node_path32.default.dirname(file));
+  ensureHome(import_node_path33.default.dirname(file));
   const tmp = `${file}.${process.pid}.tmp`;
-  import_node_fs36.default.writeFileSync(tmp, `${JSON.stringify({ projects }, null, 2)}
+  import_node_fs37.default.writeFileSync(tmp, `${JSON.stringify({ projects }, null, 2)}
 `, { mode: 384 });
-  import_node_fs36.default.renameSync(tmp, file);
+  import_node_fs37.default.renameSync(tmp, file);
 }
 function registerProject(file, projectDir, now = Date.now()) {
   const dir = realDir(projectDir);
@@ -104339,10 +104578,10 @@ function removeProject(file, projectDir) {
   const kept = projects.filter((entry) => entry.dir !== dir);
   if (kept.length !== projects.length) writeProjects(file, kept);
 }
-var artifactsRootOf = (projectDir) => import_node_path32.default.join(projectDir, ".ryugi", "artifacts");
+var artifactsRootOf = (projectDir) => import_node_path33.default.join(projectDir, ".ryugi", "artifacts");
 function pruneProjects(file) {
   const projects = readProjects(file);
-  const kept = projects.filter((entry) => import_node_fs36.default.existsSync(artifactsRootOf(entry.dir)));
+  const kept = projects.filter((entry) => import_node_fs37.default.existsSync(artifactsRootOf(entry.dir)));
   if (kept.length !== projects.length) writeProjects(file, kept);
   return kept;
 }
@@ -104351,7 +104590,7 @@ var isDormant = (entry, now = Date.now()) => now - entry.lastUsedAt > DORMANT_AF
 // src/server/artifact-index.ts
 var readAddress = (dir) => {
   try {
-    const value = import_node_fs37.default.readFileSync(import_node_path33.default.join(dir, ".artifact-id"), "utf8").trim();
+    const value = import_node_fs38.default.readFileSync(import_node_path34.default.join(dir, ".artifact-id"), "utf8").trim();
     return isArtifactAddress(value) ? value : null;
   } catch {
     return null;
@@ -104359,7 +104598,7 @@ var readAddress = (dir) => {
 };
 var mtimeOf2 = (dir) => {
   try {
-    return import_node_fs37.default.statSync(dir).mtimeMs;
+    return import_node_fs38.default.statSync(dir).mtimeMs;
   } catch {
     return 0;
   }
@@ -104458,7 +104697,7 @@ var ARTIFACT_KEY = /^(?:artboard|document|html)\/[a-z0-9][a-z0-9-]*$/;
 var SEP = "\n";
 var realDir2 = (dir) => {
   try {
-    return import_node_fs38.default.realpathSync(import_node_path34.default.resolve(dir));
+    return import_node_fs39.default.realpathSync(import_node_path35.default.resolve(dir));
   } catch {
     return null;
   }
@@ -104516,7 +104755,7 @@ async function startHub(options2) {
         runtimeDir: options2.runtimeDir,
         host: options2.host,
         urlHost: options2.urlHost,
-        configFile: import_node_path34.default.join(project, ".ryugi", "config.json"),
+        configFile: import_node_path35.default.join(project, ".ryugi", "config.json"),
         cloud: options2.cloud,
         fetch: options2.fetch,
         debounceMs: options2.debounceMs,
@@ -104531,7 +104770,7 @@ async function startHub(options2) {
     }
     return pending;
   };
-  const configFileOf = (project) => import_node_path34.default.join(project, ".ryugi", "config.json");
+  const configFileOf = (project) => import_node_path35.default.join(project, ".ryugi", "config.json");
   const servedBy = (project) => {
     const mounted = ready.get(project);
     if (mounted) return mounted.served();
@@ -104578,10 +104817,10 @@ async function startHub(options2) {
   }) : null;
   const origin = `http://${urlHostForHttp(options2.urlHost)}:${port}`;
   const url = loopback ? `${origin}/` : `${origin}/?key=${options2.token}`;
-  const infoFileOf = (project) => import_node_path34.default.join(artifactsRootOf(project), ".state", "server-info");
+  const infoFileOf = (project) => import_node_path35.default.join(artifactsRootOf(project), ".state", "server-info");
   const writeCompatInfo = (project) => {
     try {
-      import_node_fs38.default.mkdirSync(import_node_path34.default.dirname(infoFileOf(project)), { recursive: true, mode: 448 });
+      import_node_fs39.default.mkdirSync(import_node_path35.default.dirname(infoFileOf(project)), { recursive: true, mode: 448 });
       writeJsonAtomic(infoFileOf(project), {
         type: "server-started",
         url,
@@ -104600,7 +104839,7 @@ async function startHub(options2) {
       counts.set(entry.project, (counts.get(entry.project) ?? 0) + 1);
     return ordered2().map((entry) => ({
       dir: entry.dir,
-      name: import_node_path34.default.basename(entry.dir),
+      name: import_node_path35.default.basename(entry.dir),
       lastUsedAt: entry.lastUsedAt,
       dormant: isDormant(entry),
       artifacts: counts.get(entry.dir) ?? 0
@@ -104613,7 +104852,7 @@ async function startHub(options2) {
       const root = artifactsRootOf(entry.dir);
       const listed = listArtifacts(root);
       for (const warning of listed.warnings)
-        warnings.push(`${import_node_path34.default.basename(entry.dir)}: ${warning}`);
+        warnings.push(`${import_node_path35.default.basename(entry.dir)}: ${warning}`);
       for (const artifact of listed.artifacts) {
         try {
           artifacts.push({
@@ -104664,7 +104903,7 @@ async function startHub(options2) {
   };
   const publishedIn = (project, cloudId) => {
     try {
-      const { artifacts } = readConfig(import_node_path34.default.join(project, ".ryugi", "config.json")).config;
+      const { artifacts } = readConfig(import_node_path35.default.join(project, ".ryugi", "config.json")).config;
       return Object.values(artifacts).some((entry) => entry.cloud?.id === cloudId);
     } catch {
       return false;
@@ -104727,7 +104966,7 @@ async function startHub(options2) {
   const register = async (dir, open) => {
     const real = realDir2(dir);
     if (!real) throw new Error(`Project directory not found: ${dir}`);
-    import_node_fs38.default.mkdirSync(artifactsRootOf(real), { recursive: true });
+    import_node_fs39.default.mkdirSync(artifactsRootOf(real), { recursive: true });
     const entry = registerProject(projectsFile, real);
     index.rescan();
     writeCompatInfo(real);
@@ -104737,10 +104976,10 @@ async function startHub(options2) {
     return entry;
   };
   const remove2 = async (dir) => {
-    const real = realDir2(dir) ?? import_node_path34.default.resolve(dir);
+    const real = realDir2(dir) ?? import_node_path35.default.resolve(dir);
     removeProject(projectsFile, real);
     index.rescan();
-    import_node_fs38.default.rmSync(infoFileOf(real), { force: true });
+    import_node_fs39.default.rmSync(infoFileOf(real), { force: true });
     const pending = mounts.get(real);
     mounts.delete(real);
     ready.delete(real);
@@ -104748,17 +104987,17 @@ async function startHub(options2) {
   };
   const logTail = (project) => {
     try {
-      const fd2 = import_node_fs38.default.openSync(options2.paths.log, "r");
+      const fd2 = import_node_fs39.default.openSync(options2.paths.log, "r");
       try {
-        const size = import_node_fs38.default.fstatSync(fd2).size;
+        const size = import_node_fs39.default.fstatSync(fd2).size;
         const length = Math.min(size, LOG_TAIL_BYTES);
         const buffer = Buffer.alloc(length);
-        import_node_fs38.default.readSync(fd2, buffer, 0, length, size - length);
+        import_node_fs39.default.readSync(fd2, buffer, 0, length, size - length);
         const lines = buffer.toString("utf8").split("\n").filter(Boolean);
         if (length < size) lines.shift();
         return lines.filter((line) => !project || line.includes(project)).slice(-LOG_TAIL_LINES);
       } finally {
-        import_node_fs38.default.closeSync(fd2);
+        import_node_fs39.default.closeSync(fd2);
       }
     } catch {
       return [];
@@ -104895,7 +105134,7 @@ async function startHub(options2) {
       mounts.clear();
       ready.clear();
       await Promise.all(all.map(async (pending) => (await pending.catch(() => null))?.close()));
-      for (const entry of ordered2()) import_node_fs38.default.rmSync(infoFileOf(entry.dir), { force: true });
+      for (const entry of ordered2()) import_node_fs39.default.rmSync(infoFileOf(entry.dir), { force: true });
       for (const server of [front, board]) server.closeAllConnections();
       await Promise.all(stopped);
     }
@@ -104904,8 +105143,8 @@ async function startHub(options2) {
 
 // src/server/relaunch.ts
 var import_node_child_process4 = require("node:child_process");
-var import_node_fs39 = __toESM(require("node:fs"), 1);
-var import_node_path35 = __toESM(require("node:path"), 1);
+var import_node_fs40 = __toESM(require("node:fs"), 1);
+var import_node_path36 = __toESM(require("node:path"), 1);
 var LAUNCHER_COMMAND = /^node "(.+)"$/;
 var WAIT_THEN_RUN = `
 const [pid, file, ...args] = process.argv.slice(1);
@@ -104919,20 +105158,20 @@ tick();
 function relaunchCommand(env, serverDir) {
   const launcher = LAUNCHER_COMMAND.exec(env.RYUGI_ARTIFACTS_LAUNCHER ?? "")?.[1];
   if (launcher) return [process.execPath, launcher];
-  const cli = import_node_path35.default.join(serverDir, "cli.cjs");
-  return import_node_fs39.default.existsSync(cli) ? [process.execPath, cli] : null;
+  const cli = import_node_path36.default.join(serverDir, "cli.cjs");
+  return import_node_fs40.default.existsSync(cli) ? [process.execPath, cli] : null;
 }
 function pinLauncherRelease(env, homedir, version2, now = Date.now()) {
-  const releases = import_node_path35.default.join(
-    env.XDG_CACHE_HOME || import_node_path35.default.join(homedir, ".cache"),
+  const releases = import_node_path36.default.join(
+    env.XDG_CACHE_HOME || import_node_path36.default.join(homedir, ".cache"),
     "ryugi",
     "artifacts"
   );
-  import_node_fs39.default.mkdirSync(releases, { recursive: true });
-  const file = import_node_path35.default.join(releases, "latest.json");
+  import_node_fs40.default.mkdirSync(releases, { recursive: true });
+  const file = import_node_path36.default.join(releases, "latest.json");
   const tmp = `${file}.${process.pid}`;
-  import_node_fs39.default.writeFileSync(tmp, JSON.stringify({ version: version2, checkedAt: now }));
-  import_node_fs39.default.renameSync(tmp, file);
+  import_node_fs40.default.writeFileSync(tmp, JSON.stringify({ version: version2, checkedAt: now }));
+  import_node_fs40.default.renameSync(tmp, file);
 }
 function spawnAfterExit(pid, argv, env = process.env) {
   const [file, ...args] = argv;
@@ -104946,7 +105185,7 @@ function spawnAfterExit(pid, argv, env = process.env) {
 }
 
 // src/server/update-check.ts
-var import_node_fs40 = __toESM(require("node:fs"), 1);
+var import_node_fs41 = __toESM(require("node:fs"), 1);
 var REGISTRY_URL = "https://registry.npmjs.org/ryugi-artifacts/latest";
 var DAY_MS = 24 * 60 * 60 * 1e3;
 var TIMEOUT_MS2 = 5e3;
@@ -104961,7 +105200,7 @@ function newerVersion(candidate, current) {
 }
 function readCache(file) {
   try {
-    const value = JSON.parse(import_node_fs40.default.readFileSync(file, "utf8"));
+    const value = JSON.parse(import_node_fs41.default.readFileSync(file, "utf8"));
     return typeof value.version === "string" && Number.isFinite(value.checkedAt) ? value : null;
   } catch {
     return null;
@@ -104985,7 +105224,7 @@ function createUpdateCheck(options2) {
         const { version: version2 } = await res.json();
         if (typeof version2 !== "string") return;
         cached = { version: version2, checkedAt: now() };
-        import_node_fs40.default.writeFileSync(options2.cacheFile, `${JSON.stringify(cached)}
+        import_node_fs41.default.writeFileSync(options2.cacheFile, `${JSON.stringify(cached)}
 `, { mode: 384 });
       } catch {
       }
@@ -104997,12 +105236,12 @@ function createUpdateCheck(options2) {
 var UPDATE_POLL_MS = 60 * 60 * 1e3;
 function machineKey(file) {
   try {
-    const key3 = import_node_fs41.default.readFileSync(file, "utf8").trim();
+    const key3 = import_node_fs42.default.readFileSync(file, "utf8").trim();
     if (/^[a-f0-9]{48}$/.test(key3)) return key3;
   } catch {
   }
   const key2 = import_node_crypto13.default.randomBytes(24).toString("hex");
-  import_node_fs41.default.writeFileSync(file, `${key2}
+  import_node_fs42.default.writeFileSync(file, `${key2}
 `, { mode: 384 });
   return key2;
 }
@@ -105011,14 +105250,14 @@ async function main() {
   const paths = machinePaths();
   ensureHome(paths.home);
   const updates = createUpdateCheck({
-    cacheFile: import_node_path36.default.join(paths.home, "latest.json"),
+    cacheFile: import_node_path37.default.join(paths.home, "latest.json"),
     current: version
   });
   const hub = await startHub({
     host: config.host,
     urlHost: config.urlHost,
-    viewerDir: import_node_path36.default.join(__dirname, "viewer"),
-    runtimeDir: import_node_path36.default.join(__dirname, "runtime"),
+    viewerDir: import_node_path37.default.join(__dirname, "viewer"),
+    runtimeDir: import_node_path37.default.join(__dirname, "runtime"),
     ports: config.ports,
     boardPorts: config.boardPorts,
     paths,
@@ -105055,14 +105294,14 @@ async function main() {
     if (stopping) return;
     stopping = true;
     console.info(JSON.stringify({ type: "server-stopped", reason, at: (/* @__PURE__ */ new Date()).toISOString() }));
-    import_node_fs41.default.rmSync(paths.info, { force: true });
+    import_node_fs42.default.rmSync(paths.info, { force: true });
     if (intended) writeJsonAtomic(paths.stopped, { reason, timestamp: Date.now() });
     await hub.close();
     process.exit(0);
   }
   function readRunningVersion() {
     try {
-      return import_node_fs41.default.readFileSync(paths.version, "utf8").trim() || version;
+      return import_node_fs42.default.readFileSync(paths.version, "utf8").trim() || version;
     } catch {
       return version;
     }
@@ -105105,7 +105344,7 @@ async function main() {
   process.on("SIGTERM", () => void shutdown("SIGTERM"));
   process.on("SIGINT", () => void shutdown("SIGINT"));
   process.on("SIGHUP", () => void shutdown("SIGHUP"));
-  import_node_fs41.default.rmSync(paths.stopped, { force: true });
+  import_node_fs42.default.rmSync(paths.stopped, { force: true });
   const started = {
     type: "server-started",
     url: hub.url,