dsh-rewind-plugin 0.18.1 → 0.19.0

package/README.en.md

@@ -159,14 +159,6 @@ This plugin deliberately stays lightweight and focused on one thing — "convers
 > This project and DeepSeek Harness are both in developer preview. Pin exact
 > versions in reproducible environments and review the behavior notes above.
 
-## Client contract
-
-Third-party DOM plugins that need to know which transcript rows a rewind
-withdrew should consume the stable, locale-independent helpers exported from
-`dsh-rewind-plugin/client` — never parse
-`outcome.text`. The `data-dsh-rewind-hidden` attribute marks withdrawn rows
-(observational only). Details: [docs/contract/client-contract.md](docs/contract/client-contract.md).
-
 ## Known issues
 
 1. **Exported logs are complete** — a rewind only removes messages from the model context and the view; the exported session log (`/export`) still contains **withdrawn messages**. This plugin cannot alter exports.

package/README.md

@@ -143,11 +143,6 @@ rm <dsh home>/snapshot-cleanup-last-sweep.json
 > 本项目与 DeepSeek Harness 均处于开发者预览阶段。可复现环境请 pin 精确版本，
 > 并阅读上述行为说明。
 
-## 客户端契约
-
-需要获知哪些转录行被回退撤回的第三方 DOM 插件，应使用 `dsh-rewind-plugin/client` 导出的稳定、与本地化无关的纯函数，切勿解析 `outcome.text`。`data-dsh-rewind-hidden` 属性标记被撤回的行（仅观测性）。
-详见：[docs/contract/client-contract.zh.md](docs/contract/client-contract.zh.md)。
-
 ## 已知问题
 
 1. **导出的日志是完整内容**——回退只是把消息从模型上下文和视图中移除，`/export` 导出的会话日志包含**已撤回的消息**。本插件无法改动导出。

package/lib/client.js

@@ -9,6 +9,7 @@ var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
 var __export = (target, all) => {
   for (var name2 in all)
     __defProp(target, name2, { get: all[name2], enumerable: true });
@@ -22,22 +23,72 @@ var __copyProps = (to, from, except, desc) => {
   return to;
 };
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
 
 // src/client/index.ts
 var index_exports = {};
 __export(index_exports, {
   apply: () => apply,
-  hiddenSeqsOf: () => hiddenSeqsOf,
   inject: () => inject,
-  name: () => name,
-  targetSeqOfArgs: () => targetSeqOfArgs
+  name: () => name
 });
 module.exports = __toCommonJS(index_exports);
 
+// src/client/candidates.ts
+var PREVIEW_CHARS = 80;
+var DEFAULT_CANDIDATE_LIMIT = 100;
+function messagePreviewOf(message) {
+  const text = message.content.map((block) => block.type === "text" && typeof block.text === "string" ? block.text : "").join("").replace(/\s+/g, " ").trim();
+  return text.length <= PREVIEW_CHARS ? text : `${text.slice(0, PREVIEW_CHARS - 1)}\u2026`;
+}
+function formatCandidateTime(time) {
+  const d = new Date(time);
+  const hh = String(d.getHours()).padStart(2, "0");
+  const mm = String(d.getMinutes()).padStart(2, "0");
+  return `${hh}:${mm}`;
+}
+function rewindCandidatesOf(snap, limit = DEFAULT_CANDIDATE_LIMIT) {
+  const candidates = [];
+  for (let i = snap.order.length - 1; i >= 0 && candidates.length < limit; i--) {
+    const key = snap.order[i];
+    if (key === void 0) continue;
+    const node = snap.nodes.get(key);
+    if (node === void 0 || node.kind !== "user" && node.kind !== "steering") continue;
+    candidates.push({
+      seq: node.data.seq,
+      time: node.data.time,
+      preview: messagePreviewOf(node.data)
+    });
+  }
+  return candidates;
+}
+function rewindCandidatesOfChat(snap) {
+  return rewindCandidatesOf(snap);
+}
+function rewindOptionsFromCandidates(candidates, t) {
+  return candidates.map((candidate) => ({
+    id: String(candidate.seq),
+    label: candidate.preview || t("popover.noText"),
+    detail: formatCandidateTime(candidate.time)
+  }));
+}
+
 // src/client/hidden.ts
 var ENGINE_COMMAND = "rewind-plugin";
 var LEGACY_ENGINE_COMMAND = "rewind";
 var ENGINE_COMMANDS = /* @__PURE__ */ new Set([ENGINE_COMMAND, LEGACY_ENGINE_COMMAND]);
+function chatNodesOf(chat) {
+  if (chat === void 0) return EMPTY_NODES;
+  const values = chat.nodes.values;
+  if (typeof values === "function") return [...values.call(chat.nodes)];
+  const nodes = [];
+  for (const key of chat.order) {
+    const node = chat.nodes.get(key);
+    if (node !== void 0) nodes.push(node);
+  }
+  return nodes;
+}
+var EMPTY_NODES = [];
 function resolveChatWatch(resolveView, sessionId, cb) {
   const view = resolveView(sessionId);
   return view?.subscribe?.(cb) ?? (() => {
@@ -48,9 +99,8 @@ function chatSnapshotOf(chatView) {
 }
 function messageTextAt(chat, seq) {
   if (chat === void 0) return void 0;
-  for (const key of chat.order) {
-    const node = chat.nodes.get(key);
-    if (node === void 0 || node.kind !== "user" && node.kind !== "steering") continue;
+  for (const node of chatNodesOf(chat)) {
+    if (node.kind !== "user" && node.kind !== "steering") continue;
     const data = node.data;
     if (data.seq === seq) {
       return data.content?.map((block) => block.type === "text" && typeof block.text === "string" ? block.text : "").join("");
@@ -60,9 +110,8 @@ function messageTextAt(chat, seq) {
 }
 function messageAttachmentsAt(chat, seq) {
   if (chat === void 0) return void 0;
-  for (const key of chat.order) {
-    const node = chat.nodes.get(key);
-    if (node === void 0 || node.kind !== "user" && node.kind !== "steering") continue;
+  for (const node of chatNodesOf(chat)) {
+    if (node.kind !== "user" && node.kind !== "steering") continue;
     const data = node.data;
     if (data.seq !== seq) continue;
     const images = [];
@@ -100,141 +149,21 @@ function isPreviewCommand(command) {
 function isCandidateCommand(command) {
   return (command.args ?? "").includes("__candidates");
 }
-function coalesceCuts(spans) {
-  if (spans.length < 2) return spans;
-  const sorted = [...spans].sort((left, right) => left.start - right.start || left.end - right.end);
-  const merged = [];
-  for (const span of sorted) {
-    const last = merged[merged.length - 1];
-    if (last !== void 0 && span.start <= last.end) {
-      if (span.end > last.end) last.end = span.end;
-      continue;
-    }
-    merged.push({ start: span.start, end: span.end });
-  }
-  return merged;
-}
-function cutsContain(cuts, seq) {
-  let low = 0;
-  let high = cuts.length - 1;
-  while (low <= high) {
-    const middle = low + high >> 1;
-    const cut = cuts[middle];
-    if (seq < cut.start) high = middle - 1;
-    else if (seq > cut.end) low = middle + 1;
-    else return true;
-  }
-  return false;
-}
-function liveAnchorKeys(snap, cuts) {
-  const live = /* @__PURE__ */ new Map();
-  for (const key of snap.order) {
-    const node = snap.nodes.get(key);
-    if (node === void 0 || cutsContain(cuts, node.anchorSeq)) continue;
-    const keys = live.get(node.anchorSeq);
-    if (keys === void 0) live.set(node.anchorSeq, [key]);
-    else keys.push(key);
-  }
-  return live;
-}
-var EMPTY_KEYS = [];
-function addWithdrawnTurnChrome(snap, cuts, hidden) {
-  const locations = snap.locations;
-  if (locations === void 0 || cuts.length === 0) return;
-  let live;
-  for (const key of snap.order) {
-    const chrome = snap.nodes.get(key);
-    if (chrome === void 0 || chrome.kind !== "turn-process") continue;
-    const located = chrome.location?.turn;
-    if (located?.start === void 0) continue;
-    const turn = located.turn;
-    if (typeof turn !== "number") continue;
-    const keys = locations.getTurn(turn);
-    if (keys.length === 0) continue;
-    const rows = keys.map((member) => snap.nodes.get(member)).filter((member) => member !== void 0);
-    if (rows.length !== keys.length) continue;
-    if (!rows.every((member) => member.key === chrome.key || cutsContain(cuts, member.anchorSeq))) continue;
-    live ?? (live = liveAnchorKeys(snap, cuts));
-    if ((live.get(chrome.anchorSeq) ?? EMPTY_KEYS).some((holder) => holder !== chrome.key)) continue;
-    hidden.add(chrome.anchorSeq);
-  }
-}
-var hiddenSeqsMemo = /* @__PURE__ */ new WeakMap();
-function hiddenSeqsOf(snap) {
-  const memo = hiddenSeqsMemo.get(snap);
-  if (memo !== void 0) return new Set(memo);
-  const hidden = /* @__PURE__ */ new Set();
-  const spans = [];
-  for (const key of snap.order) {
-    const node = snap.nodes.get(key);
-    if (node === void 0 || node.kind !== "command") continue;
+function rewindCutsOf(nodes) {
+  const cuts = [];
+  for (const node of nodes) {
+    if (node.kind !== "command") continue;
     const command = node.data;
     if (command.name === null || !ENGINE_COMMANDS.has(command.name)) continue;
-    if (isPreviewCommand(command) || isCandidateCommand(command)) {
-      hidden.add(command.seq);
-      continue;
-    }
+    if (isPreviewCommand(command) || isCandidateCommand(command)) continue;
     if (command.outcome?.kind !== "success") continue;
     const marker = command.outcome.sourceEventSeq;
     if (marker === void 0) continue;
-    hidden.add(command.seq);
     const target = targetSeqOfArgs(command.args);
-    if (target !== void 0) {
-      spans.push({ start: target, end: marker });
-    }
-  }
-  const cuts = coalesceCuts(spans);
-  for (const key of snap.order) {
-    const node = snap.nodes.get(key);
-    if (node === void 0) continue;
-    if (cutsContain(cuts, node.anchorSeq)) hidden.add(node.anchorSeq);
-  }
-  try {
-    addWithdrawnTurnChrome(snap, cuts, hidden);
-  } catch {
+    if (target === void 0 || target > marker) continue;
+    cuts.push({ target, marker });
   }
-  hiddenSeqsMemo.set(snap, new Set(hidden));
-  return hidden;
-}
-
-// src/client/candidates.ts
-var PREVIEW_CHARS = 80;
-var DEFAULT_CANDIDATE_LIMIT = 100;
-function messagePreviewOf(message) {
-  const text = message.content.map((block) => block.type === "text" && typeof block.text === "string" ? block.text : "").join("").replace(/\s+/g, " ").trim();
-  return text.length <= PREVIEW_CHARS ? text : `${text.slice(0, PREVIEW_CHARS - 1)}\u2026`;
-}
-function formatCandidateTime(time) {
-  const d = new Date(time);
-  const hh = String(d.getHours()).padStart(2, "0");
-  const mm = String(d.getMinutes()).padStart(2, "0");
-  return `${hh}:${mm}`;
-}
-function rewindCandidatesOf(snap, hidden, limit = DEFAULT_CANDIDATE_LIMIT) {
-  const candidates = [];
-  for (let i = snap.order.length - 1; i >= 0 && candidates.length < limit; i--) {
-    const key = snap.order[i];
-    if (key === void 0) continue;
-    const node = snap.nodes.get(key);
-    if (node === void 0 || node.kind !== "user" && node.kind !== "steering") continue;
-    if (hidden.has(node.anchorSeq ?? node.data.seq)) continue;
-    candidates.push({
-      seq: node.data.seq,
-      time: node.data.time,
-      preview: messagePreviewOf(node.data)
-    });
-  }
-  return candidates;
-}
-function rewindCandidatesOfChat(snap) {
-  return rewindCandidatesOf(snap, hiddenSeqsOf(snap));
-}
-function rewindOptionsFromCandidates(candidates, t) {
-  return candidates.map((candidate) => ({
-    id: String(candidate.seq),
-    label: candidate.preview || t("popover.noText"),
-    detail: formatCandidateTime(candidate.time)
-  }));
+  return cuts;
 }
 
 // src/client/styles.ts
@@ -503,12 +432,11 @@ function closePopover() {
 function findCommand(chat, match) {
   if (chat === void 0) return void 0;
   let found;
-  for (const key of chat.order) {
-    const node = chat.nodes.get(key);
-    if (node !== void 0 && node.kind === "command") {
-      const command = node.data;
-      if (match(command)) found = command;
-    }
+  for (const node of chatNodesOf(chat)) {
+    if (node.kind !== "command") continue;
+    const command = node.data;
+    if (!match(command)) continue;
+    if (found === void 0 || command.seq >= found.seq) found = command;
   }
   return found;
 }
@@ -516,12 +444,10 @@ function knownCommandSeqs(session, chatOf, match) {
   const known = /* @__PURE__ */ new Set();
   const chat = chatOf(session);
   if (chat === void 0) return known;
-  for (const key of chat.order) {
-    const node = chat.nodes.get(key);
-    if (node !== void 0 && node.kind === "command") {
-      const command = node.data;
-      if (match(command)) known.add(command.seq);
-    }
+  for (const node of chatNodesOf(chat)) {
+    if (node.kind !== "command") continue;
+    const command = node.data;
+    if (match(command)) known.add(command.seq);
   }
   return known;
 }
@@ -850,6 +776,293 @@ function openPopover(opts) {
   });
 }
 
+// src/client/log.ts
+var NS = "dsh-rewind";
+var DEBUG_KEY = "dsh-rewind.debug";
+var ALWAYS_ON = /* @__PURE__ */ new Set(["error", "warn"]);
+function switchValue() {
+  try {
+    return window.localStorage.getItem(DEBUG_KEY) ?? "";
+  } catch {
+    return "";
+  }
+}
+function matches(value, ns) {
+  for (const entry of value.split(",")) {
+    const part = entry.trim();
+    if (part === "") continue;
+    if (part === "*" || part === `${NS}*`) return true;
+    if (part.endsWith("*")) {
+      if (ns.startsWith(part.slice(0, -1))) return true;
+    } else if (ns === part) {
+      return true;
+    }
+  }
+  return false;
+}
+function tag(scope) {
+  return `[${NS}:${scope}]`;
+}
+function log(level, scope, message, data) {
+  if (ALWAYS_ON.has(level)) {
+    console[level](tag(scope), message, data);
+    return;
+  }
+  if (!matches(switchValue(), `${NS}:${scope}`)) return;
+  console.info(tag(scope), message, data);
+}
+var rewindLog = {
+  error: (scope, message, data) => log("error", scope, message, data),
+  warn: (scope, message, data) => log("warn", scope, message, data),
+  info: (scope, message, data) => log("info", scope, message, data),
+  debug: (scope, message, data) => log("debug", scope, message, data)
+};
+
+// src/client/visibility.ts
+var patches = /* @__PURE__ */ new Map();
+var currentCleanup;
+function installChatViewVisibility(ctx) {
+  let stopped = false;
+  const start = () => {
+    const scope = ctx.inject?.(["uiConversation"], (child) => {
+      if (!stopped) installOn(child.get("uiConversation"), ctx.sessions);
+    });
+    if (ctx.inject === void 0) {
+      installOn(ctx.get("uiConversation"), ctx.sessions);
+    }
+    return () => {
+      stopped = true;
+      currentCleanup?.();
+      currentCleanup = void 0;
+      if (typeof scope === "function") scope();
+    };
+  };
+  if (ctx.effect === void 0) {
+    start();
+    return;
+  }
+  ctx.effect(start, "dsh-rewind chat visibility");
+}
+function installOn(ui, sessions) {
+  currentCleanup?.();
+  currentCleanup = void 0;
+  if (ui?.views === void 0) return;
+  const views = ui.views;
+  const ensure = () => {
+    try {
+      const definition = views.entries().find((candidate) => candidate.target === "chat");
+      if (definition === void 0 || typeof definition.create !== "function") return;
+      const current = patches.get(definition);
+      const create = definition.create;
+      if (current !== void 0 && create === current.wrapper) return;
+      const wrapper = function wrappedChatBuilder() {
+        return new RewindVisibilityBuilder(create.call(definition));
+      };
+      const mutable = definition;
+      mutable.create = wrapper;
+      patches.set(definition, { original: create, wrapper });
+      rewindLog.info("visibility", "installed Chat snapshot visibility wrapper");
+      rebuildOpenSessions(ui, sessions);
+    } catch (error) {
+      rewindLog.error("visibility", "Chat visibility install probe failed", error);
+    }
+  };
+  let unsubscribe;
+  try {
+    unsubscribe = views.subscribe?.(ensure);
+  } catch (error) {
+    rewindLog.warn("visibility", "Chat view subscription failed", error);
+  }
+  ensure();
+  currentCleanup = () => {
+    unsubscribe?.();
+    restorePatches();
+    rebuildOpenSessions(ui, sessions);
+  };
+}
+function restorePatches() {
+  for (const [definition, record] of patches) {
+    const mutable = definition;
+    if (mutable.create === record.wrapper) mutable.create = record.original;
+  }
+  patches = /* @__PURE__ */ new Map();
+}
+function rebuildOpenSessions(ui, sessions) {
+  const state = sessions?.list?.getSnapshot();
+  if (state === void 0) return;
+  const ids = /* @__PURE__ */ new Set([...state.ids ?? [], ...Object.keys(state.byId ?? {})]);
+  for (const id of ids) {
+    const row = state.byId?.[id];
+    const retained = row?.retainedBy;
+    if (retained === void 0 || !Object.values(retained).some((count) => (count ?? 0) > 0)) continue;
+    try {
+      ui.binding?.(id)?.rebuild?.();
+    } catch (error) {
+      rewindLog.warn("visibility", `chat rebuild failed for ${id}`, error);
+    }
+  }
+}
+var RewindVisibilityBuilder = class {
+  /** @param inner - the real Chat builder. */
+  constructor(inner) {
+    __publicField(this, "inner", inner);
+    __publicField(this, "originals", /* @__PURE__ */ new Map());
+    __publicField(this, "commands", /* @__PURE__ */ new Map());
+    __publicField(this, "byTurn", /* @__PURE__ */ new Map());
+    __publicField(this, "turnProcess", /* @__PURE__ */ new Map());
+    __publicField(this, "derived", /* @__PURE__ */ new Map());
+    __publicField(this, "cuts", []);
+    __publicField(this, "cutSignature", "[]");
+    __publicField(this, "lastSignature", "[]");
+  }
+  get empty() {
+    return this.inner.empty;
+  }
+  replace(input) {
+    this.setAll(input.nodes);
+    this.lastSignature = this.cutSignature;
+    return this.inner.replace({ nodes: this.deriveAll(), timeline: input.timeline, ...changed(input) });
+  }
+  apply(input) {
+    const affected = /* @__PURE__ */ new Set();
+    let commandsChanged = false;
+    for (const node of input.upserts) {
+      const previous = this.originals.get(node.key);
+      const previousTurn = previous === void 0 ? void 0 : turnOf(previous);
+      const nextTurn = turnOf(node);
+      if (previousTurn !== void 0) affected.add(previousTurn);
+      if (nextTurn !== void 0) affected.add(nextTurn);
+      if (previous?.kind === "command" || node.kind === "command") commandsChanged = true;
+      this.setOriginal(node);
+    }
+    if (commandsChanged) this.refreshCuts();
+    if (this.cutSignature !== this.lastSignature) {
+      this.lastSignature = this.cutSignature;
+      return this.inner.replace({ nodes: this.deriveAll(), timeline: input.timeline, ...changed(input) });
+    }
+    const cuts = this.cuts;
+    const upserts = /* @__PURE__ */ new Map();
+    for (const node of input.upserts) upserts.set(node.key, this.deriveOne(node, cuts));
+    for (const turn of affected) {
+      const processKey = this.turnProcess.get(turn);
+      const base = processKey === void 0 ? void 0 : this.originals.get(processKey);
+      if (base === void 0) continue;
+      const next = this.deriveTurnProcess(base, cuts, turn, this.deriveOne(base, cuts));
+      if (this.derived.get(processKey) !== next) upserts.set(processKey, next);
+    }
+    const list = [...upserts.values()];
+    for (const node of list) this.derived.set(node.key, node);
+    return this.inner.apply({ upserts: list, timeline: input.timeline, ...changed(input) });
+  }
+  groupInput() {
+    return this.inner.groupInput?.();
+  }
+  publish() {
+    this.inner.publish?.();
+  }
+  setAll(nodes) {
+    this.originals.clear();
+    this.commands.clear();
+    this.byTurn.clear();
+    this.turnProcess.clear();
+    this.derived.clear();
+    for (const node of nodes) this.setOriginal(node);
+    this.refreshCuts();
+  }
+  setOriginal(node) {
+    const previous = this.originals.get(node.key);
+    if (previous !== void 0) this.unindex(previous);
+    this.originals.set(node.key, node);
+    if (node.kind === "command") this.commands.set(node.key, node);
+    const turn = turnOf(node);
+    if (turn === void 0) return;
+    const members = this.byTurn.get(turn) ?? /* @__PURE__ */ new Map();
+    members.set(node.key, node);
+    this.byTurn.set(turn, members);
+    if (node.kind === "turn-process") this.turnProcess.set(turn, node.key);
+  }
+  unindex(node) {
+    if (node.kind === "command") this.commands.delete(node.key);
+    const turn = turnOf(node);
+    if (turn === void 0) return;
+    const members = this.byTurn.get(turn);
+    if (members === void 0) return;
+    members.delete(node.key);
+    if (members.size === 0) this.byTurn.delete(turn);
+    if (node.kind === "turn-process" && this.turnProcess.get(turn) === node.key) {
+      this.turnProcess.delete(turn);
+      for (const member of members.values()) {
+        if (member.kind === "turn-process") {
+          this.turnProcess.set(turn, member.key);
+          break;
+        }
+      }
+    }
+  }
+  refreshCuts() {
+    this.cuts = rewindCutsOf(this.commands.values());
+    this.cutSignature = JSON.stringify(
+      this.cuts.map((cut) => `${cut.target}:${cut.marker}`).sort()
+    );
+  }
+  deriveAll() {
+    const cuts = this.cuts;
+    const derived = /* @__PURE__ */ new Map();
+    for (const node of this.originals.values()) derived.set(node.key, this.deriveOne(node, cuts));
+    for (const [turn, key] of this.turnProcess) {
+      const base = this.originals.get(key);
+      if (base === void 0) continue;
+      const current = derived.get(key) ?? this.deriveOne(base, cuts);
+      derived.set(key, this.deriveTurnProcess(base, cuts, turn, current));
+    }
+    const result = [...derived.values()];
+    this.derived = derived;
+    return result;
+  }
+  deriveOne(node, cuts) {
+    const base = this.originals.get(node.key) ?? node;
+    if (base.kind === "command") {
+      const command = base.data;
+      if (command.name !== void 0 && command.name !== null && ENGINE_COMMANDS.has(command.name)) {
+        const args = command.args ?? "";
+        const probe = args.includes("preview") || args.includes("__candidates");
+        const executed = command.outcome?.kind === "success" && command.outcome.sourceEventSeq !== void 0;
+        if (probe || executed) return hidden(base);
+      }
+      return base;
+    }
+    const contained = cuts.some((cut) => cut.target <= base.anchorSeq && base.anchorSeq <= cut.marker);
+    return contained ? hidden(base) : base;
+  }
+  deriveTurnProcess(base, cuts, turn = turnOf(base), current = this.deriveOne(base, cuts)) {
+    if (turn === void 0 || current.visibility === "hidden") return current;
+    const members = this.byTurn.get(turn);
+    if (members === void 0) return current;
+    let count = 0;
+    let allHidden = true;
+    for (const member of members.values()) {
+      if (member.key === base.key) continue;
+      count += 1;
+      if (this.deriveOne(member, cuts).visibility !== "hidden") {
+        allHidden = false;
+        break;
+      }
+    }
+    if (count === 0) return current;
+    return allHidden ? hidden(base) : current;
+  }
+};
+function hidden(node) {
+  return node.visibility === "hidden" ? node : { ...node, visibility: "hidden" };
+}
+function turnOf(node) {
+  const turn = node.location?.turn?.turn;
+  return typeof turn === "number" ? turn : void 0;
+}
+function changed(input) {
+  return input.changedTurns === void 0 ? {} : { changedTurns: input.changedTurns };
+}
+
 // src/client/portals.tsx
 var import_react = require("react");
 var import_react_dom = require("react-dom");
@@ -885,11 +1098,11 @@ function matchPendingRows(rows, steering) {
   for (let i = 0; i < rows.length; i++) {
     const row = rows[i];
     const item = steering[i];
-    matched.push(item !== void 0 && matches(item, row) ? item.id : null);
+    matched.push(item !== void 0 && matches2(item, row) ? item.id : null);
   }
   return matched;
 }
-function matches(item, row) {
+function matches2(item, row) {
   if (item.attachments > 0) return row.attachments === item.attachments;
   return row.text === (item.text ?? "");
 }
@@ -899,48 +1112,6 @@ function retractSpan(steering, targetId) {
   return steering.slice(index).map((item) => item.id);
 }
 
-// src/client/log.ts
-var NS = "dsh-rewind";
-var DEBUG_KEY = "dsh-rewind.debug";
-var ALWAYS_ON = /* @__PURE__ */ new Set(["error", "warn"]);
-function switchValue() {
-  try {
-    return window.localStorage.getItem(DEBUG_KEY) ?? "";
-  } catch {
-    return "";
-  }
-}
-function matches2(value, ns) {
-  for (const entry of value.split(",")) {
-    const part = entry.trim();
-    if (part === "") continue;
-    if (part === "*" || part === `${NS}*`) return true;
-    if (part.endsWith("*")) {
-      if (ns.startsWith(part.slice(0, -1))) return true;
-    } else if (ns === part) {
-      return true;
-    }
-  }
-  return false;
-}
-function tag(scope) {
-  return `[${NS}:${scope}]`;
-}
-function log(level, scope, message, data) {
-  if (ALWAYS_ON.has(level)) {
-    console[level](tag(scope), message, data);
-    return;
-  }
-  if (!matches2(switchValue(), `${NS}:${scope}`)) return;
-  console.info(tag(scope), message, data);
-}
-var rewindLog = {
-  error: (scope, message, data) => log("error", scope, message, data),
-  warn: (scope, message, data) => log("warn", scope, message, data),
-  info: (scope, message, data) => log("info", scope, message, data),
-  debug: (scope, message, data) => log("debug", scope, message, data)
-};
-
 // src/client/portals.tsx
 var import_jsx_runtime = require("react/jsx-runtime");
 function fillComposerEditable(text) {
@@ -1072,7 +1243,6 @@ function showHint(text) {
 }
 var COMPOSER_EDITABLE_SELECTOR = "[data-composer-input]";
 var USER_SEAT_SELECTOR = '[data-chat-flow-kind="user"][data-chat-anchor-key], [data-chat-flow-kind="steering"][data-chat-anchor-key]';
-var CHAT_SEAT_SELECTOR = "[data-chat-anchor-key]";
 var IGNORED_PORTAL_SCOPE = [
   "[data-composer-seat]",
   "[data-composer-input]",
@@ -1080,14 +1250,6 @@ var IGNORED_PORTAL_SCOPE = [
   "[data-sidebar-chat]",
   "[data-plugin-panel]"
 ].join(", ");
-var GROUP_SHELL_SELECTOR = '[data-chat-anchor-key^="group:"]';
-function resolveSeatAnchorSeq(element, chat) {
-  if (chat === void 0) return void 0;
-  const flowKey = element.dataset.chatAnchorKey;
-  const nodeKey = element.dataset.chatNodeKey;
-  const node = (flowKey !== void 0 ? chat.nodes.get(flowKey) : void 0) ?? (nodeKey !== void 0 ? chat.nodes.get(nodeKey) : void 0);
-  return node?.anchorSeq;
-}
 var PENDING_SEAT_SELECTOR = "[data-pending-steering]";
 var MESSAGE_ATTACHMENT_SELECTOR = "[data-message-attachments]";
 function actionsContainerOf(row) {
@@ -1097,47 +1259,7 @@ function actionsContainerOf(row) {
   if (structural instanceof HTMLElement && structural.querySelector("button") !== null) return structural;
   return void 0;
 }
-function hideWithdrawnSeats(chat, seats, hiddenSeqs, hidden) {
-  if (chat === void 0) return;
-  const shells = /* @__PURE__ */ new Map();
-  for (const seat of seats) {
-    if (seat.matches(GROUP_SHELL_SELECTOR)) continue;
-    const anchor = resolveSeatAnchorSeq(seat, chat);
-    const withdrawn = anchor !== void 0 && hiddenSeqs.has(anchor);
-    if (withdrawn) {
-      seat.style.display = "none";
-      seat.dataset.dshRewindHidden = "true";
-      hidden.add(seat);
-    } else if (hidden.has(seat)) {
-      seat.style.display = "";
-      delete seat.dataset.dshRewindHidden;
-      hidden.delete(seat);
-    }
-    if (seat.dataset.chatNodeKey === void 0) continue;
-    const shell = seat.parentElement?.closest(GROUP_SHELL_SELECTOR);
-    if (shell === null || shell === void 0) continue;
-    shells.set(shell, (shells.get(shell) ?? true) && withdrawn);
-  }
-  for (const [shell, allWithdrawn] of shells) {
-    if (allWithdrawn) {
-      shell.style.display = "none";
-      shell.dataset.dshRewindHidden = "true";
-      hidden.add(shell);
-    } else if (hidden.has(shell)) {
-      shell.style.display = "";
-      delete shell.dataset.dshRewindHidden;
-      hidden.delete(shell);
-    }
-  }
-}
-function showHiddenSeats(hidden) {
-  for (const element of hidden) {
-    element.style.display = "";
-    delete element.dataset.dshRewindHidden;
-  }
-  hidden.clear();
-}
-function collectTargets(chat, hiddenSeqs) {
+function collectTargets(chat) {
   const rows = /* @__PURE__ */ new Map();
   for (const element of document.querySelectorAll(USER_SEAT_SELECTOR)) {
     const key = element.dataset.chatAnchorKey;
@@ -1148,7 +1270,6 @@ function collectTargets(chat, hiddenSeqs) {
     const node = chat.nodes.get(key);
     if (node === void 0 || node.kind !== "user" && node.kind !== "steering") continue;
     const user = node.data;
-    if (hiddenSeqs.has(node.anchorSeq ?? user.seq)) continue;
     const row = rows.get(key);
     const actions = actionsContainerOf(row);
     if (actions === void 0) continue;
@@ -1159,9 +1280,9 @@ function collectTargets(chat, hiddenSeqs) {
 function isRewindInertSession(snapshot) {
   return snapshot.subagent !== null && snapshot.subagent !== void 0;
 }
-function collectDurableTargets(snapshot, chat, hiddenSeqs) {
+function collectDurableTargets(snapshot, chat) {
   if (chat === void 0 || isRewindInertSession(snapshot)) return [];
-  return collectTargets(chat, hiddenSeqs);
+  return collectTargets(chat);
 }
 function inboxOf(session) {
   return session.projections.faceOf(INBOX_PROJECTION).getSnapshot();
@@ -1210,7 +1331,6 @@ function sameTargets(left, right) {
 }
 function RewindPortals({ sessionId, sessionOf, chatOf, isMainViewSession, watchChat, t, subscribeLocale, setComposerText, restoreImages }) {
   const [targets, setTargets] = (0, import_react.useState)([]);
-  const hidden = (0, import_react.useRef)(/* @__PURE__ */ new Set());
   const [, forceRender] = (0, import_react.useReducer)((count) => count + 1, 0);
   (0, import_react.useEffect)(() => subscribeLocale(() => {
     forceRender();
@@ -1230,17 +1350,7 @@ function RewindPortals({ sessionId, sessionOf, chatOf, isMainViewSession, watchC
       }
       const snapshot = session.getSnapshot();
       const chat = chatOf(session);
-      const hiddenSeqs = chat === void 0 ? /* @__PURE__ */ new Set() : hiddenSeqsOf(chat);
-      for (const element of hidden.current) if (!element.isConnected) hidden.current.delete(element);
-      if (hiddenSeqs.size > 0 || hidden.current.size > 0) {
-        hideWithdrawnSeats(
-          chat,
-          chat === void 0 ? [] : document.querySelectorAll(CHAT_SEAT_SELECTOR),
-          hiddenSeqs,
-          hidden.current
-        );
-      }
-      const durable = collectDurableTargets(snapshot, chat, hiddenSeqs);
+      const durable = collectDurableTargets(snapshot, chat);
       const next = [...durable, ...collectPendingTargets(snapshot, steeringItemsOf(inboxOf(session)?.["next-step"]))];
       setTargets((current) => sameTargets(current, next) ? current : next);
     };
@@ -1268,26 +1378,17 @@ function RewindPortals({ sessionId, sessionOf, chatOf, isMainViewSession, watchC
     const unsubscribeChat = watchChat(sessionId, queueRefresh);
     const observer = new MutationObserver((records) => {
       for (const record of records) {
-        if (record.type === "attributes") {
-          const target = record.target;
-          if (target instanceof HTMLElement && hidden.current.has(target) && target.style.display !== "none") {
-            queueRefresh();
-            return;
-          }
-          continue;
-        }
         const node = record.target instanceof Element ? record.target : record.target.parentElement;
         if (node !== null && node.closest(IGNORED_PORTAL_SCOPE) !== null) continue;
         queueRefresh();
         return;
       }
     });
-    observer.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ["style"] });
+    observer.observe(document.body, { childList: true, subtree: true });
     return () => {
       active = false;
       observer.disconnect();
       unsubscribeChat();
-      showHiddenSeats(hidden.current);
       unsubscribeInbox?.();
       unsubscribeInbox = void 0;
       inboxOwner = void 0;
@@ -1475,9 +1576,9 @@ async function candidatesOverRpc(connection, sessionId) {
 }
 
 // src/client/build-info.ts
-var PLUGIN_VERSION = true ? "0.18.1" : "dev";
+var PLUGIN_VERSION = true ? "0.19.0" : "dev";
 var PLUGIN_PACKAGE = "dsh-rewind-plugin";
-var BUILD_HASH = true ? "8a3779b4" : "dev";
+var BUILD_HASH = true ? "bccc8c9b" : "dev";
 
 // src/client/locales.ts
 var zh = {
@@ -1707,6 +1808,7 @@ function apply(ctx) {
     style.dataset.plugin = PLUGIN_PACKAGE;
     style.textContent = STYLE;
     document.head.appendChild(style);
+    installChatViewVisibility(ctx);
     const sessionOf = (sessionId) => ctx.sessions.binding(sessionId)?.session;
     const isMainViewSession = (sessionId) => (ctx.sessions.list.getSnapshot().byId[sessionId]?.retainedBy.mainView ?? 0) > 0;
     const subscribeLocale = (cb) => ctx.locale.subscribe(cb);

package/lib/types/client/candidates.d.ts

@@ -43,7 +43,6 @@ export interface CandidateChat {
 /** A user/steering row subset; only fields the listing reads are real. */
 export interface CandidateUserNode {
     readonly kind: string;
-    readonly anchorSeq?: number;
     readonly data: {
         readonly seq: number;
         readonly time: number;
@@ -64,15 +63,14 @@ export declare function messagePreviewOf(message: {
 export declare function formatCandidateTime(time: number): string;
 /**
  * List the selectable rewind candidates of a session chat snapshot: user and
- * steering rows still on the surface (not hidden by a previous rewind), the
- * newest `limit` kept, newest first — the top row is the default highlight,
+ * steering rows still on the surface (withdrawn rows are absent from `order`),
+ * the newest `limit` kept, newest first — the top row is the default highlight,
  * i.e. the most recent message and the most common rewind target.
  * @param snap - the session chat snapshot.
- * @param hidden - anchor seqs withdrawn by rewinds (from `hiddenSeqsOf`).
  * @param limit - maximum number of candidates to return.
  */
-export declare function rewindCandidatesOf(snap: CandidateChat, hidden: ReadonlySet<number>, limit?: number): RewindCandidate[];
-/** The candidates of a live chat snapshot, withdrawn rows already excluded. */
+export declare function rewindCandidatesOf(snap: CandidateChat, limit?: number): RewindCandidate[];
+/** The candidates of a live chat snapshot; withdrawn rows are already excluded from `order`. */
 export declare function rewindCandidatesOfChat(snap: CandidateChat): RewindCandidate[];
 /**
  * Map typed candidates to popupSelect rows. The list comes from the host over

package/lib/types/client/hidden.d.ts

@@ -1,7 +1,5 @@
 /**
- * Pure computation of the chat rows a rewind hides from the rendered
- * transcript. Extracted from the client plugin (`src/client/index.ts`) so the
- * multi-rewind cut logic stays unit-testable without a DOM.
+ * Pure Chat-snapshot readers and executed-rewind cut derivation.
  *
  * @module dsh-rewind/client/hidden
  */
@@ -15,35 +13,39 @@ export declare const ENGINE_COMMAND = "rewind-plugin";
 export declare const LEGACY_ENGINE_COMMAND = "rewind";
 /** Engine command names the client recognizes. */
 export declare const ENGINE_COMMANDS: ReadonlySet<string>;
-/** A chat-snapshot view node as the hiding / composer-refill logic reads it.
- * The harness's view node shape plus the `anchorSeq` the chat snapshot carries
- * (the plugin reads `anchorSeq` off each node; it is not declared on the
- * harness's `ConversationViewNode`). */
+/** A Chat-snapshot view node as the client readers see it. */
 export interface ChatConversationViewNode {
     readonly key: string;
     readonly kind?: string;
     readonly data?: unknown;
     readonly anchorSeq: number;
-    /** Owning Turn as the chat snapshot carries it; its `turn` and `start` are read
-     * (see `addWithdrawnTurnChrome`). */
+    /** Owning Turn, when the node has one (used by the visibility summary pass). */
     readonly location?: {
         readonly turn?: {
             readonly turn?: unknown;
             readonly start?: unknown;
         };
     };
+    /** Chat-only row visibility; absent on older test doubles. */
+    readonly visibility?: 'visible' | 'hidden';
 }
-/** Minimal chat snapshot reader the hiding logic needs. */
+/** Minimal Chat-snapshot reader the client helpers need. */
 export interface HiddenChat {
     readonly order: readonly string[];
     readonly nodes: {
         get(key: string): ChatConversationViewNode | undefined;
-    };
-    /** Turn-keyed node index; absent on older snapshots, which the chrome pass tolerates. */
-    readonly locations?: {
-        getTurn(turn: number): readonly string[];
+        /** Every materialized node, including hidden ones. Absent on older snapshots. */
+        values?(): readonly ChatConversationViewNode[];
     };
 }
+/**
+ * Every materialized Chat node, preferring the store's own values (which also
+ * includes rows the visibility layer hid) and falling back to the visible
+ * order for older snapshots / test doubles.
+ * @param chat - the live chat snapshot, when available.
+ * @returns all nodes in store insertion order.
+ */
+export declare function chatNodesOf(chat: HiddenChat | undefined): readonly ChatConversationViewNode[];
 /**
  * Reader for one session's live chat snapshot: the chat is served by the
  * `uiConversation` service's named "chat" view (contributed by
@@ -71,7 +73,7 @@ export declare function resolveChatWatch(resolveView: (sessionId: string) => {
 /**
  * Resolve the chat snapshot from the `uiConversation` "chat" view. The view's
  * `getSnapshot()` returns undefined until the named view is registered, which
- * degrades to `undefined` (no targets, no hiding — never a crash).
+ * degrades to `undefined` (no targets — never a crash).
  */
 export declare function chatSnapshotOf(chatView: {
     getSnapshot(): unknown;
@@ -131,26 +133,18 @@ export declare function targetSeqOfArgs(args: string | null | undefined): number
  * never trigger a fill.
  */
 export declare function isExecutedRewindCommand(node: CommandNode, seq: number): boolean;
+/** One executed rewind's cut: the target seq through the marker's seq, inclusive. */
+export interface RewindCut {
+    /** First withdrawn anchor seq. */
+    readonly target: number;
+    /** Marker log seq, the last withdrawn anchor seq. */
+    readonly marker: number;
+}
 /**
- * True when an engine command node is a legacy candidate-list probe
- * (`__candidates`). New candidate lists travel over RPC; this only keeps
- * probe rows in historical sessions hidden.
- */
-export declare function isCandidateCommand(command: CommandNode): boolean;
-/**
- * Anchor seqs that must be hidden from the rendered transcript so the user sees
- * the conversation as the agent sees it: every legacy probe flow node (it only
- * exists to feed the popover) and every SUCCESSFUL executed `/rewind` command
- * row, plus every message a rewind withdrew — the target, everything after it,
- * and the (unrendered) marker.
- *
- * Each executed rewind cuts ONE span `[target, marker]`, and callers must keep
- * the spans SEPARATE: collapsing them to `[min target, max marker]` would hide a
- * still-on-surface gap of new traffic between an earlier marker and a later
- * target. Endpoints come from the command nodes (`sourceEventSeq` is the
- * marker's log seq; the outcome text carries the target seq).
- *
- * A Turn whose rows were ALL withdrawn also contributes its Turn-process summary
- * row, whose own anchor can precede the target (see `addWithdrawnTurnChrome`).
+ * Read every executed rewind cut from a node set. Internal probes never
+ * contribute; a success without a marker rewound nothing; a command whose
+ * args carry no `@<seq>` target has no recoverable span.
+ * @param nodes - every materialized Chat node.
+ * @returns one cut per marker-carrying successful engine command, in input order.
  */
-export declare function hiddenSeqsOf(snap: HiddenChat): Set<number>;
+export declare function rewindCutsOf(nodes: Iterable<ChatConversationViewNode>): RewindCut[];

package/lib/types/client/index.d.ts

@@ -9,8 +9,7 @@
  * The command decoration (`ctx.commandUi.decorate`) makes a bare `/rewind` (or
  * its alias `/undo`) open the harness's own popupSelect instead of executing;
  * the parameterized `@<seq>` form stays the execution channel, while the
- * popover's impact and candidate reads go over the host RPC channel. The
- * exported contract is specified in `docs/contract/client-contract.md`.
+ * popover's impact and candidate reads go over the host RPC channel.
  *
  * @module dsh-rewind/client
  */
@@ -46,8 +45,3 @@ export interface ClientContext {
  * @param ctx - client root context carrying `slots`, `sessions`, `locale` and `commandUi`.
  */
 export declare function apply(ctx: ClientContext): void;
-/**
- * Public contract — rewind visibility. Stable, semver-protected; the rest of
- * this module is internal. See `docs/contract/client-contract.md`.
- */
-export { hiddenSeqsOf, targetSeqOfArgs, type HiddenChat } from './hidden.ts';

package/lib/types/client/portals.d.ts

@@ -170,22 +170,6 @@ export declare function writeComposer(text: string, facade: ComposerDraftWriter
  * after switching sessions or restarting dsh.
  */
 export declare function runRewindAndFill(session: SessionFace, seq: number, mode: 'chat' | 'both', isMainViewSession: (sessionId: string) => boolean, chatOf: ChatOf, watchChat: ChatWatch, setComposerText: (sessionId: string, text: string) => boolean, restoreImages?: (sessionId: string, images: readonly MessageImageRef[]) => Promise<void>): Promise<void>;
-/**
- * The snapshot seq a rendered seat stands for.
- *
- * A seat carries two keys: `data-chat-anchor-key` (the FLOW key, which for a
- * step/process part is the composite `["<nodeKey>", "<part>"]`) and
- * `data-chat-node-key` (always the plain node key). Resolving only the flow key
- * made every grouped process row — the "正在分析/已完成分析" step rows, tool
- * groups — unresolvable, so a withdrawn one could never be hidden and stayed on
- * screen after a rewind. This mirrors the official viewport's own identity read
- * (`anchorKey === key || nodeKey === key`).
- *
- * @param element - one rendered seat.
- * @param chat - the live chat snapshot the seat belongs to.
- * @returns the node's `anchorSeq`, or undefined when the seat has no resolvable node.
- */
-export declare function resolveSeatAnchorSeq(element: HTMLElement, chat: HiddenChat | undefined): number | undefined;
 /**
  * Locate the actions container of a user/steering seat row — the element the
  * ↶ button portals into (the copy/branch IconActions row).
@@ -203,57 +187,12 @@ export declare function resolveSeatAnchorSeq(element: HTMLElement, chat: HiddenC
  * both durable and pending row shapes without a full React portal render.
  */
 export declare function actionsContainerOf(row: HTMLElement | undefined): HTMLElement | undefined;
-/**
- * Hide every rendered seat a rewind withdrew, plus the step/process GROUP shells
- * those seats empty.
- *
- * A seat's seq comes from `resolveSeatAnchorSeq`: `data-chat-anchor-key` (the
- * FLOW key, composite for a step/process part) with `data-chat-node-key` (always
- * the plain node key) as the fallback. A group shell is different: it carries
- * the composite `group:<json>` anchor, which resolves to no chat node — the
- * group is a view construct, not a message. It is therefore judged by its
- * members, which THIS batch already holds: a shell whose every member seat is
- * withdrawn has no live content left, so it is hidden too. That is what stops a
- * fully withdrawn "analysis completed" / "command executed" group from staying
- * on screen as an expandable empty row. A shell keeps one live member only if
- * that member is genuinely on the surface, in which case the shell stays; a
- * shell the batch carries no member of is left alone.
- *
- * A MEMBER is a real chat node seat — `ChatNodeSeat` is the one shape that
- * writes `data-chat-node-key` beside the anchor key. An anchor-only descendant
- * (the tool call tree's own `call:<callId>` row, or a third-party anchor) is
- * nested decoration: it resolves to no chat node, so it does NOT vote on the
- * shell's emptiness. Counting such a row as "still live" is what left a fully
- * withdrawn "command executed" tool group on screen as an empty expandable row
- * after every member below it had been hidden.
- *
- * Every hidden element carries `data-dsh-rewind-hidden` (see
- * `docs/contract/client-contract.md`).
- *
- * @param chat - the live chat snapshot the seats belong to.
- * @param seats - this refresh's seat batch (every `[data-chat-anchor-key]`).
- * @param hiddenSeqs - anchor seqs withdrawn by the executed rewinds.
- * @param hidden - elements this pass has hidden, so a re-created row is re-judged.
- */
-export declare function hideWithdrawnSeats(chat: HiddenChat | undefined, seats: Iterable<HTMLElement>, hiddenSeqs: ReadonlySet<number>, hidden: Set<HTMLElement>): void;
-/**
- * Undo every hide the given set recorded, so a live disable (or a session-slot
- * collapse) cannot leave the transcript truncated.
- *
- * The hide is the plugin's OWN mutation of host rows ({@link hideWithdrawnSeats}),
- * and nothing else would ever revert it: a disposed bridge runs no further
- * refresh, so rows it hid would stay hidden with no affordance to bring them
- * back.
- *
- * @param hidden - the elements this bridge currently hides; emptied.
- */
-export declare function showHiddenSeats(hidden: Set<HTMLElement>): void;
 /**
  * Collect the portal targets of one session: user rows × snapshot nodes.
  * Exported as a test seam — the DOM→targets pairing that drives the ↶ button
  * is otherwise only reachable through a full React portal render.
  */
-export declare function collectTargets(chat: HiddenChat, hiddenSeqs: ReadonlySet<number>): readonly PortalTarget[];
+export declare function collectTargets(chat: HiddenChat): readonly PortalTarget[];
 /**
  * The session-kind slice the durable-target gate reads — the session
  * snapshot's `subagent` cell, the Harness's own runtime signal for a
@@ -285,9 +224,8 @@ export declare function isRewindInertSession(snapshot: SessionKindLike): boolean
  * pure, directly testable decision.
  * @param snapshot - the session snapshot carrying the `subagent` cell.
  * @param chat - the session's chat snapshot, or undefined while unavailable.
- * @param hiddenSeqs - anchor seqs withdrawn by previous rewinds.
  */
-export declare function collectDurableTargets(snapshot: SessionKindLike, chat: HiddenChat | undefined, hiddenSeqs: ReadonlySet<number>): readonly PortalTarget[];
+export declare function collectDurableTargets(snapshot: SessionKindLike, chat: HiddenChat | undefined): readonly PortalTarget[];
 /**
  * The pending bubble row's compared text and its message-attachment block
  * count, read from a CLONE (the live row is never touched).
@@ -320,7 +258,7 @@ interface RewindPortalsProps extends RewindBridgeDeps {
  * synchronous full-transcript scan inside a commit microtask.
  *
  * The refresh is driven by the three inputs its targets are made of: the chat
- * snapshot (`hiddenSeqsOf`), the session's `inbox` projection (the pending
+ * snapshot's visible order, the session's `inbox` projection (the pending
  * occurrences — see `syncInboxSubscription`), and the DOM (row/actions mounts,
  * via the scoped observer).
  */

package/lib/types/client/visibility.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Snapshot-level rewind visibility.
+ *
+ * DSH's Chat builder already supports hidden rows: a node stays in the node
+ * store (so the composer can read its text/images) but leaves `order`,
+ * `locations`, Turn navigation, and grouping whenever its `visibility` is
+ * `'hidden'`. This module wraps the registered `chat` view builder and marks
+ * the nodes inside an executed rewind's `[target, marker]` span hidden before
+ * the builder sees them.
+ *
+ * The seam is private: `uiConversation.views` is a first-party registry and
+ * `definition.create()` is not an extension point. Its shape is checked and it
+ * is restored on unload.
+ *
+ * @module dsh-rewind/client/visibility
+ */
+import { type ChatConversationViewNode } from './hidden.ts';
+interface BuilderLike {
+    readonly empty: unknown;
+    replace(input: BuilderInput): unknown;
+    apply(input: BuilderApplyInput): unknown;
+    groupInput?(): unknown;
+    publish?(): void;
+}
+interface BuilderInput {
+    readonly nodes: readonly ChatConversationViewNode[];
+    readonly timeline: unknown;
+    readonly changedTurns?: readonly number[];
+}
+interface BuilderApplyInput {
+    readonly upserts: readonly ChatConversationViewNode[];
+    readonly timeline: unknown;
+    readonly changedTurns?: readonly number[];
+}
+interface SessionsLike {
+    readonly list?: {
+        getSnapshot(): {
+            readonly ids?: readonly string[];
+            readonly byId?: Readonly<Record<string, {
+                readonly retainedBy?: Readonly<Record<string, number>>;
+            }>>;
+        };
+    };
+}
+/** Context subset the installer needs; structurally satisfied by the client root. */
+export interface VisibilityContext {
+    get(name: string): unknown;
+    effect?(execute: () => (() => void) | void, label?: string): unknown;
+    inject?(names: readonly string[], callback: (scope: VisibilityContext) => void): unknown;
+    readonly sessions?: SessionsLike;
+}
+/**
+ * Wrap the registered `chat` view builder so rewind spans enter the builder as
+ * `visibility: 'hidden'`. Idempotent across registry changes and HMR.
+ * @param ctx - client root context.
+ */
+export declare function installChatViewVisibility(ctx: VisibilityContext): void;
+/**
+ * Structural wrapper over the registered Chat builder. It forwards every
+ * builder method, keeps the original node objects, and only changes
+ * `visibility`. A full replacement is used whenever the cut set changes;
+ * otherwise it stays on the builder's incremental `apply` path.
+ */
+export declare class RewindVisibilityBuilder implements BuilderLike {
+    private readonly inner;
+    private originals;
+    private commands;
+    private byTurn;
+    private turnProcess;
+    private derived;
+    private cuts;
+    private cutSignature;
+    private lastSignature;
+    /** @param inner - the real Chat builder. */
+    constructor(inner: BuilderLike);
+    get empty(): unknown;
+    replace(input: BuilderInput): unknown;
+    apply(input: BuilderApplyInput): unknown;
+    groupInput(): unknown;
+    publish(): void;
+    private setAll;
+    private setOriginal;
+    private unindex;
+    private refreshCuts;
+    private deriveAll;
+    private deriveOne;
+    private deriveTurnProcess;
+}
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-rewind-plugin",
-  "version": "0.18.1",
+  "version": "0.19.0",
   "description": "In-window conversation rewind with workspace file restore · 同窗口内对话回退并可还原工作区文件",
   "icon": "./assets/icon.svg",
   "keywords": [