bothouse-dsh 0.1.44 → 0.1.46

package/collab/desk.mjs

@@ -0,0 +1,177 @@
+// #876 团队工作台：任务板事件流 → hub 事件、回放接口、桌面页挂载。
+//
+// 事件契约见 Issue #876：`board-events.jsonl` 与 board.jsonl 同目录（BOARD_DIR），
+// 一行一个 JSON，只追加；这里只读不改，写入归 gate 的 board.py。
+import { closeSync, openSync, readFileSync, readSync, statSync } from 'node:fs';
+import { join } from 'node:path';
+import { CollabError, publicMessage } from './store.mjs';
+// #876 P: 回放消息的 @ 由这里解析，规则与 hub 路由同一套（mentions.mjs），页面不再自己猜文本。
+import { mentions as mentionsOf } from './mentions.mjs';
+
+export const BOARD_EVENTS_FILE = 'board-events.jsonl';
+// 验收要求派活后「几秒内」光柱出现；每秒 stat 一次这个只追加的小文件足够便宜。
+export const TAIL_INTERVAL_MS = 1000;
+// 一次回放给一页历史，条数上限沿用消息分页的 200 条（store.mjs clampLimit）。
+export const REPLAY_MAX = 200;
+
+/** 读一行事件；空行跳过，坏行留一条 warn（写入方可能正写到一半）。 */
+export function parseBoardEvent(line, logger) {
+  const text = line.trim();
+  if (text === '') return undefined;
+  let entry;
+  try { entry = JSON.parse(text); } catch { logger?.warn?.('conest-collab: bad board event line %s', text.slice(0, 200)); return undefined; }
+  if (entry === null || typeof entry !== 'object' || Array.isArray(entry)) {
+    logger?.warn?.('conest-collab: board event is not an object: %s', text.slice(0, 200));
+    return undefined;
+  }
+  return entry;
+}
+
+/** 板目录里的全部事件（回放用）；文件不存在就是没有事件，不是错误。 */
+export function readBoardEvents(boardDir) {
+  if (!boardDir) return [];
+  let raw;
+  try { raw = readFileSync(join(boardDir, BOARD_EVENTS_FILE), 'utf8'); } catch { return []; }
+  const out = [];
+  for (const line of raw.split('\n')) {
+    const entry = parseBoardEvent(line);
+    if (entry !== undefined) out.push(entry);
+  }
+  return out;
+}
+
+/**
+ * 尾随 board-events.jsonl，把新增行作为 `{type:"task", …}` 推进 hub 事件流。
+ * 启动时从文件末尾开始：启动前的事件属于回放素材，不该在启动瞬间补一屏光柱。
+ */
+export class DeskEvents {
+  constructor(hub, { boardDir, logger, intervalMs = TAIL_INTERVAL_MS } = {}) {
+    this.hub = hub;
+    this.logger = logger;
+    this.intervalMs = intervalMs;
+    this.path = boardDir ? join(boardDir, BOARD_EVENTS_FILE) : undefined;
+    this.offset = 0;
+    this.timer = undefined;
+  }
+
+  start() {
+    if (this.path === undefined || this.timer !== undefined) return;
+    this.offset = this.size();
+    this.timer = setInterval(() => this.poll(), this.intervalMs);
+    this.timer.unref?.();
+  }
+
+  stop() {
+    if (this.timer !== undefined) clearInterval(this.timer);
+    this.timer = undefined;
+  }
+
+  size() {
+    try { return statSync(this.path).size; } catch { return 0; }
+  }
+
+  /** 读 offset 之后新增的完整行；半行留到下次；文件被截断则从头再读。 */
+  poll() {
+    let size;
+    try { size = statSync(this.path).size; } catch { return; }
+    if (size < this.offset) this.offset = 0;
+    if (size === this.offset) return;
+    const length = size - this.offset;
+    const buf = Buffer.allocUnsafe(length);
+    let read = 0;
+    const fd = openSync(this.path, 'r');
+    try { read = readSync(fd, buf, 0, length, this.offset); } finally { closeSync(fd); }
+    if (read <= 0) return;
+    const chunk = buf.subarray(0, read);
+    const end = chunk.lastIndexOf(0x0a);
+    if (end < 0) return;
+    this.offset += end + 1;
+    for (const line of chunk.subarray(0, end).toString('utf8').split('\n')) {
+      const entry = parseBoardEvent(line, this.logger);
+      if (entry === undefined) continue;
+      try { this.hub.emit({ ...entry, type: 'task' }); } catch (error) { this.logger?.warn?.('conest-collab: task event emit failed: %s', error?.message ?? error); }
+    }
+  }
+}
+
+/**
+ * 把该时段的板事件与房间消息按时间合并。
+ * 消息的 created_at 是秒（store.append 默认 Date.now()/1000），板事件是 ISO 时间。
+ * members 是 hub 的成员（{id,name,mentionId?}）：消息里的 @ 用 mentions.mjs 解析成
+ * 成员 id 放进 `message.mentions`，页面直接照着画，不再从文本猜（#876 P）。
+ */
+export function deskReplay({ store, boardDir, from, to, members = [] }) {
+  const fromMs = Date.parse(String(from ?? ''));
+  const toMs = Date.parse(String(to ?? ''));
+  if (!Number.isFinite(fromMs) || !Number.isFinite(toMs)) throw new CollabError('invalid', 'from/to must be ISO timestamps');
+  if (toMs < fromMs) throw new CollabError('invalid', 'to must not be earlier than from');
+
+  const merged = [];
+  for (const entry of readBoardEvents(boardDir)) {
+    const ts = Date.parse(entry.ts ?? '');
+    if (!Number.isFinite(ts) || ts < fromMs || ts > toMs) continue;
+    merged.push({ ts, event: { ...entry, type: 'task' } });
+  }
+  const rows = store.db.prepare('SELECT * FROM messages WHERE deleted = 0 AND created_at >= ? AND created_at <= ? ORDER BY created_at DESC, id DESC LIMIT ?')
+    .all(fromMs / 1000, toMs / 1000, REPLAY_MAX);
+  for (const row of rows.reverse()) {
+    const message = publicMessage(row, store);
+    const mentioned = members.length ? [...mentionsOf(String(message.text ?? ''), members)] : [];
+    if (mentioned.length) message.mentions = mentioned;
+    merged.push({ ts: row.created_at * 1000, event: { type: 'message', message } });
+  }
+  merged.sort((a, b) => a.ts - b.ts);
+  const kept = merged.length > REPLAY_MAX ? merged.slice(-REPLAY_MAX) : merged;
+  return { from: new Date(fromMs).toISOString(), to: new Date(toMs).toISOString(), events: kept.map(m => m.event) };
+}
+
+/** 桌面页：C 路提供的 dsh/collab/desk/index.html；还没落地时给一个能看事件流的占位页。 */
+export function deskPage() {
+  try { return readFileSync(new URL('./desk/index.html', import.meta.url), 'utf8'); } catch { return PLACEHOLDER_PAGE; }
+}
+
+/** /collab/desk 与 /collab/api/desk/replay；返回 true 表示已处理，未匹配返回 undefined。 */
+export function deskRoute(req, res, url, { store, boardDir, members = [] }) {
+  if (url.pathname.replace(/\/+$/, '') !== '/collab/desk' && url.pathname.replace(/\/+$/, '') !== '/collab/api/desk/replay') return undefined;
+  if (req.method !== 'GET') return undefined;
+  if (url.pathname.replace(/\/+$/, '') === '/collab/desk') {
+    res.writeHead(200, { 'content-type': 'text/html; charset=utf-8', 'cache-control': 'no-store' });
+    res.end(deskPage());
+    return true;
+  }
+  try {
+    const body = deskReplay({ store, boardDir, members, from: url.searchParams.get('from'), to: url.searchParams.get('to') });
+    res.writeHead(200, { 'content-type': 'application/json; charset=utf-8', 'cache-control': 'no-store' });
+    res.end(JSON.stringify(body));
+  } catch (error) {
+    const status = error instanceof CollabError ? 400 : 500;
+    res.writeHead(status, { 'content-type': 'application/json; charset=utf-8', 'cache-control': 'no-store' });
+    res.end(JSON.stringify(error instanceof CollabError ? { error: error.message, code: error.code } : { error: 'replay failed' }));
+  }
+  return true;
+}
+
+const PLACEHOLDER_PAGE = `<!doctype html>
+<html lang="zh-CN">
+<head><meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1">
+<title>团队工作台</title>
+<style>body{font:14px/1.6 system-ui,sans-serif;margin:0;padding:24px;background:#0f1115;color:#e6e8eb}
+h1{font-size:18px;margin:0 0 8px}p{color:#8b949e;margin:0 0 16px}
+ol{padding-left:20px;font-family:ui-monospace,monospace;font-size:12px}</style></head>
+<body>
+<h1>团队工作台</h1>
+<p>办公室地图页由前端路补充；这里是占位页，只接真实事件流，不造假光柱。</p>
+<ol id="events"></ol>
+<script>
+const list = document.getElementById('events');
+const add = text => { const li = document.createElement('li'); li.textContent = text; list.prepend(li); };
+const source = new EventSource('/collab/api/events');
+source.onmessage = message => {
+  let event;
+  try { event = JSON.parse(message.data); } catch { return; }
+  if (event.type === 'task') add([event.ts, event.kind, event.from, '→', event.to, event.title].filter(Boolean).join(' '));
+};
+</script>
+</body>
+</html>
+`;

package/collab/gate-context.mjs

@@ -16,19 +16,25 @@ export class GateContext {
     this.timeoutMs = timeoutMs;
     this.fetch = fetchFn;
     this.logger = logger;
-    /** `${member}\0${room}` -> { session, paths: Set } : pages already in that conversation's context. */
+    /** `${member}\0${room}` -> { session, epoch }: the name of that conversation's context for the gate. */
     this.sent = new Map();
   }
 
   /**
-   * The block of pages this (member, room) conversation has not been given yet, and a commit()
-   * that records them as given (call it once the prompt is handed to the agent). The bridge keeps
-   * one list per session (core/gate.go UpdateTurnCtx); here a new `session` starts the list over.
+   * The block of pages this (member, room) conversation has not been given yet. The gate keeps what
+   * it pushed per (key, bot, epoch) and returns only new entries (ctxsvc.only_new, 11-03); here we only
+   * name the context: a new `session`, reset, forget or resetRoom gives a new epoch (as core/gate.go turnEpoch).
    * @returns {Promise<{ block: string, commit: () => void }>} block is '' when there is nothing new.
    */
   async turn({ member, room, session, text }) {
     const none = { block: '', commit: () => {} };
     if (!this.port || typeof this.fetch !== 'function') return none;
+    const key = `${member}\u0000${room}`;
+    let entry = this.sent.get(key);
+    if (entry === undefined || entry.session !== session) {
+      entry = { session, epoch: `${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 10)}` };
+      this.sent.set(key, entry);
+    }
     let out;
     try {
       const res = await this.fetch(`http://127.0.0.1:${this.port}/context`, {
@@ -36,7 +42,7 @@ export class GateContext {
         headers: { 'Content-Type': 'application/json' },
         // bot = dsh:<member id>: the gate finds the kind "dsh" team entry with that id (lead.member),
         // apart from the bridge bots' keys, which may be the same word.
-        body: JSON.stringify({ key: `dsh:${member}:${room}`, text: text ?? '', bot: `dsh:${member}` }),
+        body: JSON.stringify({ key: `dsh:${member}:${room}`, text: text ?? '', bot: `dsh:${member}`, epoch: entry.epoch }),
         signal: AbortSignal.timeout(this.timeoutMs),
       });
       if (!res.ok) throw new Error(`status ${res.status}`);
@@ -45,22 +51,10 @@ export class GateContext {
       this.logger?.debug?.('collab: gate context fetch failed: %s', error?.message ?? error);
       return none;
     }
-    const key = `${member}\u0000${room}`;
-    let entry = this.sent.get(key);
-    if (entry !== undefined && entry.session !== session) entry = undefined;
-    const known = entry?.paths ?? new Set();
-    const fresh = (Array.isArray(out?.wiki) ? out.wiki : [])
-      .filter(w => w && typeof w.path === 'string' && !known.has(w.path));
+    const fresh = (Array.isArray(out?.wiki) ? out.wiki : []).filter(w => w && typeof w.path === 'string');
     if (fresh.length === 0) return none;
     const block = '（可能相关的 wiki 页，需要时去读）' + fresh.map(w => `\n- ${w.path} — ${w.desc ?? ''}`).join('');
-    return {
-      block,
-      commit: () => {
-        let cur = this.sent.get(key);
-        if (cur === undefined || cur.session !== session) { cur = { session, paths: new Set() }; this.sent.set(key, cur); }
-        for (const w of fresh) cur.paths.add(w.path);
-      },
-    };
+    return { block, commit: () => {} };
   }
 
   /** /new for a (member, room) whose session key does not change (a local CLI member): start it over. */

package/collab/handoff-rules.json

@@ -0,0 +1,175 @@
+{
+ "_doc": [
+  "交接校验规则，只此一份：ws-handoff（_handoff_rules.py）和 DSH collab（handoff-rules.mjs：建工作区交接、/tasks 派活）都读它。",
+  "标题行 = 去掉前导空白后以 # 开头的行；一节 = 从标题（或 inline 时以节名开头的行）到下一个标题。lead 是行首可去掉的字符。",
+  "正则只写 ASCII 字符类（JS 的 \\w、\\d 只认 ASCII，Python 认 Unicode），按 search 用，要锚定就写 ^。",
+  "checks 按顺序跑，报第一条不合格的。dispatch 列出只带字段的派活（/tasks：title、ref、base）要跑的检查：字段拼成一份交接再查。",
+  "改规则后跑 contrib/lead/test_handoff_rules.py（Python 与 Node 跑同一组 fixture 比对）。",
+  "art_ref：出图类活（总目标/范围提到画、出图、小人、角色图、封面、立绘、Q版等，且范围的「改」行没写代码文件）要有「参考图」节（或「参考图：」行），列至少 min 张参考图路径或链接；写「原创：无现成图」的创意活照样要 min 张风格/构图参考，另写先出小样给用户挑。交回 [report] 要带对照图（team-exit-rules.json 的 art）。起因：用户 11-01「每次都给我画一坨屎出来」，规矩写在文字里没人执行，改成检查。",
+  "reuse：参照实现写「无（新建）」时必须有「复用盘点：」行。起因：用户 10-30 两次、11-02 一次骂「又自己写一套、不复用记忆论坛」，同类错第 3 次改成检查。"
+ ],
+ "lead": "#-*> \t",
+ "checks": [
+  {
+   "id": "sections",
+   "type": "headings",
+   "names": [
+    "用户原话",
+    "总目标",
+    "范围",
+    "已查过什么",
+    "进度",
+    "相关改动",
+    "规矩"
+   ],
+   "msg": "交接文件缺小节：{missing}",
+   "sep": "、"
+  },
+  {
+   "id": "ref",
+   "type": "ref",
+   "section": "参照实现",
+   "inline": true,
+   "none_re": "无\\s*[（(]\\s*新建\\s*[)）]",
+   "ref_re": "[~A-Za-z0-9_./-]*[A-Za-z_][~A-Za-z0-9_./-]*:[0-9]+",
+   "path_re": "[/.]",
+   "msg": "缺参照实现：写 文件:行，非代码活写「无（新建）」。示例：\n## 参照实现\n- bridge/contrib/lead/ws-up:120（和它的差异：…）",
+   "dispatch_msg": "缺参照实现：写 文件:行，非代码活写「无（新建）」。示例：ref: \"dsh/collab/tasks.mjs:226\"，或 ref: \"无（新建）\""
+  },
+  {
+   "id": "reuse",
+   "type": "needs_if",
+   "trigger_re": "无\\s*[（(]\\s*新建\\s*[)）]",
+   "need_re": "复用盘点\\s*[:：]\\s*\\S.{5,}",
+   "msg": "参照实现写了「无（新建）」，就要加一行「复用盘点：」，写清查过哪些现成能力（记忆论坛推送/打分、夜间反思、dream 手册、ws-handoff 续做、已有脚本或 skill 等，带 文件:行 或名字）、为什么都不能用。起因：用户 10-30、11-02 三次骂「又自己写一套」。示例：\n复用盘点：查过 ~/.bothouse/gate-exp/ctxsvc.py:355 推送、~/wiki/bin/manuals.py 夜里手册，都管不到 X，所以新建"
+  },
+  {
+   "id": "checked",
+   "type": "ref",
+   "section": "已查过什么",
+   "none_re": "无\\s*[（(]\\s*没查过",
+   "ref_re": "[~A-Za-z0-9_./-]*[A-Za-z_][~A-Za-z0-9_./-]*(:[0-9]+|\\.[A-Za-z]+)",
+   "path_re": "[/.]",
+   "msg": "「已查过什么」节要写已查过的 文件:行 或文档路径，下一棒不用重查；什么都没查过写「无（没查过）」。示例：\n## 已查过什么\n- dsh/collab/tasks.mjs:467 assign 只校验 ref/base\n- ~/work/codemaps/bothouse-bridge.md「编译与测试」节"
+  },
+  {
+   "id": "scope",
+   "type": "kinds",
+   "section": "范围",
+   "line_re": "^(不?改)\\s*[:：]\\s*\\S",
+   "need": [
+    "改",
+    "不改"
+   ],
+   "max": {
+    "kind": "改",
+    "n": 3,
+    "msg": "「范围」里「改」有 {n} 项，超过 3 项：拆成几件分别交，每件只管 1-3 项。"
+   },
+   "item": "{}：…",
+   "sep": "」「",
+   "msg": "「范围」节缺「{missing}」行：用户原话里的名词逐个写改或不改，没有不改的写「不改：无」。示例：\n## 范围\n- 改：任务卡（只在工作区显示）\n- 不改：进度表、聊天频道的每轮回复"
+  },
+  {
+   "id": "conflict",
+   "type": "values",
+   "section": "相关改动",
+   "line_re": "^冲突\\s*[:：]\\s*(.*)",
+   "ok_re": "^无\\s*([（(].*[）)])?\\s*[。.；;]?$",
+   "or_re": "已问用户\\s*[:：]\\s*\\S",
+   "msg": "「相关改动」节缺一行「冲突：无」或「冲突：…（已问用户：<答复>）」。示例：\n## 相关改动\n- #612 已合，改了 core/handoff.go，和这件不重叠\n冲突：无",
+   "bad_msg": "相关改动里写了冲突、没写已问用户：先在聊天频道问用户，把答复写进相关改动（「冲突：…（已问用户：<答复>）」）"
+  },
+  {
+   "id": "base",
+   "type": "heading_needs_field",
+   "headings": [
+    "共改文件",
+    "多人改"
+   ],
+   "field": "底分支",
+   "msg": "交接文件写了多人改同组文件（「共改文件」/「多人改」节），缺「底分支：<分支名>」一行。示例：\n底分支：feat/approvals-card",
+   "dispatch_msg": "多人改同组文件要写底分支：base 填分支名，示例：base: \"feat/approvals-card\""
+  },
+  {
+   "id": "art_ref",
+   "type": "art_ref",
+   "trigger_sections": [
+    "总目标",
+    "范围"
+   ],
+   "trigger_re": "出图|生图|小人|角色图|立绘|[Qq] ?版|插画|海报|宣传图|配图|封面图|做封面|画(一|个|张|幅|出)?[张个幅]?(角色|人物|头像|封面|画像|插图)",
+   "code_section": "范围",
+   "code_line_re": "^改\\s*[:：].*([A-Za-z0-9_-][.](py|go|mjs|js|ts|tsx|json|sh|yml|yaml|toml|html|css)([^A-Za-z0-9]|$)|[A-Za-z0-9_.-]+/[A-Za-z0-9_.-]+)",
+   "section": "参考图",
+   "inline": true,
+   "image_re": "https?://[^ \t<>()（）「」\"'`，,、；;]+|[^ \t<>()（）「」\"'`，,、；;：:]+[.](png|jpg|jpeg|webp|gif|avif|PNG|JPG|JPEG|WEBP)",
+   "min": 2,
+   "original_re": "原创\\s*[:：]\\s*无现成图",
+   "sample_re": "小样",
+   "msg": "这是出图类活，缺参考图：先找官方图或现成高分图当参考，写一节「参考图」列至少 {min} 张图的路径或链接（现在 {n} 张）。真是原创没有现成图，写「原创：无现成图」，照样列 {min} 张风格/构图参考（同类作品、画风、配色都行），并写明先出 3 张小样给用户挑，挑定再出正稿。示例：\n## 参考图\n- ~/art/ref/官方立绘.png\n- https://example.com/高分同人.jpg",
+   "original_msg": "写了「原创：无现成图」，还要写明先出 3 张小样给用户挑、挑定再出正稿（正文里要有「小样」）。"
+  },
+  {
+   "id": "exemplar",
+   "type": "section_needs_table",
+   "trigger_section": "用户原话",
+   "trigger_re": "「(?!\\[replying)[^」]*(照着|照抄|抄|学习|学一下|参考|对标|模仿|仿照)",
+   "object_re": "https?://|《[^》]+》",
+   "section": "照抄对象",
+   "row_re": "^\\S.*(→|->)\\s*\\S",
+   "rows": 3,
+   "need_res": [
+    "https?://|《[^》]+》",
+    "并排截图"
+   ],
+   "msg": "用户原话给了范本（链接或《…》+ 照着/抄/学习/参考/对标），交接要有「照抄对象」节：范本链接、「范本第 N 部分 → 我们第 N 部分」对照至少 3 行、验收写「并排截图」。示例：\n## 照抄对象\n- 范本：https://github.com/BotHarness/DeepSeekBot 的 README\n- 范本第 1 部分 顶部插画横幅 → 我们第 1 部分 顶部横幅\n- 范本第 2 部分 明暗两版截图 → 我们第 2 部分 功能截图\n- 范本第 3 部分 三行安装 → 我们第 3 部分 安装\n- 验收：并排截图（范本和我们同一部分左右放）"
+  },
+  {
+   "id": "hq_kinds",
+   "type": "kinds",
+   "section": "总部判断",
+   "line_re": "^(要的效果|好的样子|教训和定案)\\s*[:：]\\s*\\S.{9,}",
+   "need": [
+    "要的效果",
+    "好的样子",
+    "教训和定案"
+   ],
+   "item": "{}：…",
+   "sep": "」「",
+   "msg": "交接缺「总部判断」或写得太空：要有「{missing}」行，每行写满一句（10 字以上），写清要的效果、好的样子、教训和定案。"
+  },
+  {
+   "id": "hq_ref",
+   "type": "ref",
+   "section": "总部判断",
+   "none_re": "(?!)",
+   "ref_re": "[~A-Za-z0-9_./-]*[A-Za-z_][~A-Za-z0-9_./-]*:[0-9]+|[0-9]{1,2}-[0-9]{2}",
+   "path_re": "[/.]|^[0-9]{1,2}-[0-9]{2}$",
+   "msg": "「总部判断」没写出处：至少带一处文档 文件:行，或原话的日期（如 11-01）。"
+  },
+  {
+   "id": "no_tmp",
+   "type": "forbid",
+   "re": "(^|[\\s`'\"(（「:=])/(private/)?tmp/",
+   "msg": "交接里引用了 /tmp 下的文件：下一棒（换了会话、重启过）常找不到。脚本和状态文件挪到角色目录（如 notes/、~/work/），交接里写完整路径。示例：\n- 上一棒的脚本：~/work/tools/render_cover.py（不写 /tmp/render.py）"
+  },
+  {
+   "id": "browser_tab",
+   "type": "needs_if",
+   "trigger_re": "(开|用|在|进|上)个?浏览器|浏览器(里|上|中|配置)|[Cc]hrome ?(里|上)|登录态下(操作|下单|点)",
+   "need_re": "(标签页|tab)\\s*(id|ID|Id)?\\s*[:：=]\\s*([A-Za-z0-9_-]+|无)",
+   "msg": "浏览器活要写用哪个标签页：一行「标签页 id：<id>」，下一棒直接接着用，不用重新找页面、重新登录；还没开过页面写「标签页 id：无」。"
+  }
+ ],
+ "dispatch": {
+  "checks": [
+   "ref",
+   "base"
+  ],
+  "fields": {
+   "ref": "ref",
+   "base": "base"
+  }
+ }
+}

package/collab/hub.mjs

@@ -17,6 +17,8 @@ export class Hub {
     this.members = new Map();
     /** roomId -> Set<memberId> currently working */
     this.thinking = new Map();
+    /** id -> optional busy fields published by the team-status reader (#876). */
+    this.presence = new Map();
     this.listeners = [];
     this.planners = [];
     this.subscribers = new Set();
@@ -62,6 +64,7 @@ export class Hub {
 
   removeMember(id) {
     if (!this.members.delete(id)) return;
+    this.presence.delete(id);
     for (const room of this.thinking.keys()) this.setThinking(room, id, false);
     this.emit({ type: 'members', members: this.memberView() });
   }
@@ -70,7 +73,27 @@ export class Hub {
     const m = this.members.get(id);
     if (m === undefined || m.online === online) return;
     m.online = online;
-    if (!online) for (const room of this.thinking.keys()) this.setThinking(room, id, false);
+    if (!online) {
+      this.presence.delete(id);
+      for (const room of this.thinking.keys()) this.setThinking(room, id, false);
+    }
+    this.emit({ type: 'members', members: this.memberView() });
+  }
+
+  /**
+   * Publish optional busy fields on one member (#876). undefined clears them;
+   * unchanged values do not emit, so a 2s poll never floods the SSE stream.
+   */
+  setPresence(id, presence) {
+    if (!this.members.has(id)) return;
+    const prev = this.presence.get(id);
+    if (presence === undefined) {
+      if (prev === undefined) return;
+      this.presence.delete(id);
+    } else {
+      if (JSON.stringify(prev) === JSON.stringify(presence)) return;
+      this.presence.set(id, presence);
+    }
     this.emit({ type: 'members', members: this.memberView() });
   }
 
@@ -78,6 +101,7 @@ export class Hub {
     const member = this.members.get(id);
     if (member === undefined) return;
     member.error = error;
+    if (error !== undefined) this.presence.delete(id);
     this.emit({ type: 'members', members: this.memberView() });
   }
 
@@ -94,6 +118,7 @@ export class Hub {
     return this.memberList().map(({ id, name, kind, online, model, cli, permissionPreset, persona, nameCustomized, avatar, avatarVersion, source, error, rooms }) => ({
       id, name, kind, ...(rooms ? { rooms } : {}), online: online !== false && !error, ...(error ? { error } : {}), ...(avatar ? { avatar, ...(avatarVersion ? { avatarVersion } : {}) } : {}),
       ...(kind === 'dsh' ? { model: model ?? null, ...(cli ? { cli, ...(permissionPreset ? { permissionPreset } : {}) } : {}), ...(nameCustomized === undefined ? {} : { nameCustomized }), persona: persona ?? '', editable: source === 'ui' } : {}),
+      ...(this.presence.get(id) ?? {}),
     }));
   }