dsh-retrace 0.4.2 → 0.4.5

package/lib/client.bundle.js

@@ -63,6 +63,8 @@ var zh = {
   "marker.regenerate": "\u5DF2\u91CD\u65B0\u751F\u6210\u56DE\u590D",
   "marker.originalLabel": "\u539F\u8F93\u5165",
   "marker.referenceHint": "\u70B9\u51FB\u5C55\u5F00\u67E5\u770B\u539F\u63D0\u95EE\uFF08\u4EC5\u4F5C\u5BF9\u7167\uFF0C\u4E0D\u4F1A\u8FDB\u5165\u6A21\u578B\u4E0A\u4E0B\u6587\uFF09",
+  "marker.degradedHint": "\u6B64\u64CD\u4F5C\u6D89\u53CA\u5927\u8303\u56F4\u5BF9\u8BDD\uFF0C\u4E3A\u4FDD\u62A4\u5386\u53F2\u672A\u9690\u85CF\u5185\u5BB9\uFF08\u65E5\u5FD7\u5B8C\u597D\uFF09\u3002",
+  "marker.unionHint": "\u5DF2\u7D2F\u79EF\u9690\u85CF\u7EA6 {count}% \u7684\u5386\u53F2\u6D88\u606F\uFF1B\u53EF\u5728 \u8BBE\u7F6E\u2192\u901A\u7528 \u5173\u95ED\u300C\u6309\u6807\u8BB0\u9690\u85CF\u300D\u67E5\u770B\u5B8C\u6574\u5386\u53F2\u3002",
   "options.title": "\u6D88\u606F\u7F16\u8F91\u63D2\u4EF6",
   "options.showOriginalInput": "\u7F16\u8F91\u540E\u663E\u793A\u539F\u63D0\u95EE\u5BF9\u7167",
   "options.editFromScratch": "\u7F16\u8F91\u540E\u4ECE\u65B0\u5BF9\u8BDD\u5F00\u59CB\uFF08\u9690\u85CF\u6B64\u524D\u7684\u6D88\u606F\uFF0C\u9ED8\u8BA4\u5173\uFF09",
@@ -120,7 +122,17 @@ var zh = {
   "timeline.gitInitDesc": "\u5728\u5DE5\u4F5C\u533A\u6267\u884C git init\uFF08\u4EC5\u6DFB\u52A0 .gitignore \u4E0E\u4E00\u4E2A\u57FA\u7EBF\u63D0\u4EA4\uFF09\uFF0C\u7248\u672C\u56DE\u9000\u5C06\u4F18\u5148\u4F7F\u7528 git\u3002",
   "timeline.gitInitConfirm": "\u786E\u5B9A\u8981\u521D\u59CB\u5316 git \u5417\uFF1F",
   "error.generic": "\u64CD\u4F5C\u5931\u8D25\uFF0C\u8BF7\u91CD\u8BD5",
-  "error.busy": "\u8BF7\u5148\u505C\u6B62\u5F53\u524D\u56DE\u590D\u518D\u64CD\u4F5C"
+  "error.busy": "\u8BF7\u5148\u505C\u6B62\u5F53\u524D\u56DE\u590D\u518D\u64CD\u4F5C",
+  "view.fork": "\u5206\u53C9",
+  "fork.title": "\u5206\u53C9\u56FE",
+  "fork.empty": "\u8FD8\u6CA1\u6709\u5206\u53C9\u3002\u64A4\u56DE / \u7F16\u8F91 / \u91CD\u65B0\u751F\u6210 / \u6062\u590D\u4F1A\u5728\u6B64\u4EA7\u751F\u5206\u53C9\u3002",
+  "fork.refresh": "\u5237\u65B0",
+  "fork.spine": "\u5F53\u524D\u8DEF\u5F84",
+  "fork.shadowed": "\u88AB\u906E\u853D {count} \u4E2A\u8282\u70B9",
+  "fork.node.user": "\u7528\u6237\u6D88\u606F",
+  "fork.node.assistant": "\u52A9\u624B\u56DE\u590D",
+  "fork.node.tool": "\u5DE5\u5177\u7ED3\u679C",
+  "fork.histTitle": "\u5386\u53F2\u5206\u53C9\u70B9"
 };
 var en = {
   "action.edit": "Edit",
@@ -138,6 +150,8 @@ var en = {
   "marker.regenerate": "Reply regenerated",
   "marker.originalLabel": "Original input",
   "marker.referenceHint": "Click to expand the original input (reference only, never sent to the model)",
+  "marker.degradedHint": "This operation spans a large part of the conversation; content stays visible to protect your history (the log is intact).",
+  "marker.unionHint": 'About {count}% of the history is hidden in total; disable "Hide shadowed messages" in Settings \u2192 General to review the full history.',
   "options.title": "Message editor plugin",
   "options.showOriginalInput": "Show the original input after editing",
   "options.editFromScratch": "Start a fresh conversation after editing (hide earlier messages, default off)",
@@ -195,7 +209,17 @@ var en = {
   "timeline.gitInitDesc": "Runs git init in the workspace (adds a minimal .gitignore and a baseline commit); rollback will prefer git.",
   "timeline.gitInitConfirm": "Initialize git in this workspace?",
   "error.generic": "Operation failed; please try again",
-  "error.busy": "Stop the current reply before recalling or editing"
+  "error.busy": "Stop the current reply before recalling or editing",
+  "view.fork": "Fork",
+  "fork.title": "Fork map",
+  "fork.empty": "No forks yet. Recall / edit / regenerate / restore fork the path here.",
+  "fork.refresh": "Refresh",
+  "fork.spine": "Current path",
+  "fork.shadowed": "{count} shadowed nodes",
+  "fork.node.user": "User message",
+  "fork.node.assistant": "Assistant reply",
+  "fork.node.tool": "Tool result",
+  "fork.histTitle": "Historical fork points"
 };
 var SURFACE_TYPES = /* @__PURE__ */ new Set(["user/message", "assistant/message", "tool/result"]);
 function isReplacementSurfaceEvent(event) {
@@ -351,23 +375,32 @@ var recallMarkerDefinition = {
   kind: "recall-marker",
   target: "chat",
   match: (event) => {
-    if (event.type !== "assistant/message" || !isReplacementSurfaceEvent(event)) return null;
-    const id = event.data?.message?.id;
-    if (!isMarkerId(id)) return null;
-    return { id: `marker:${id}`, role: "start" };
+    if (!isReplacementSurfaceEvent(event)) return null;
+    if (event.type === "assistant/message") {
+      const id = event.data?.message?.id;
+      if (!isMarkerId(id)) return null;
+      return { id: `marker:${id}`, role: "start" };
+    }
+    if (event.type === "user/message" && isCompactCheckpoint(event.data?.source)) {
+      return { id: `marker:compact:${event.seq}`, role: "start" };
+    }
+    return null;
   },
   start: (_context, match) => {
     const event = match.event;
-    const id = String(event.data.message.id);
-    const legacy = isLegacyMarkerId(id);
+    const compact = event.type === "user/message" && isCompactCheckpoint(event.data?.source);
+    const id = compact ? "" : String(event.data.message.id);
+    const legacy = !compact && isLegacyMarkerId(id);
     return {
       seq: event.seq,
       time: event.time,
-      op: markerOpFromId(id),
+      op: compact ? "compaction" : markerOpFromId(id),
       legacy,
-      // Legacy markers never hide: treat their shadowed range as empty so the
-      // notice/reference render but no row is hidden and no action row is
-      // suppressed via useShadowed.
+      compact,
+      // Legacy/compact markers never hide: their shadowed range is kept for
+      // the action-row suppression check (useShadowed) but empty for legacy
+      // so no row is hidden and no action row is suppressed for legacy
+      // markers (rename must never make visible content disappear).
       shadowedSeqs: legacy ? [] : Array.isArray(event.sourceEventSeqs) ? event.sourceEventSeqs.slice() : [],
       targetSeq: event.data?.editor?.targetSeq,
       text: event.data?.editor?.text
@@ -379,6 +412,9 @@ var recallMarkerDefinition = {
     return chatNodeLike(context, "recall-marker", context.state.seq, context.state);
   }
 };
+function isCompactCheckpoint(source) {
+  return Boolean(source) && source.kind === "plugin" && source.plugin === "compact";
+}
 function textOf(content) {
   if (!Array.isArray(content)) return "";
   return content.filter((block) => block && block.type === "text" && typeof block.text === "string").map((block) => block.text).join("\n");
@@ -393,41 +429,111 @@ function useMessageSeq(useSession, messageId) {
     return void 0;
   });
 }
-function useShadowed(useSession, seq) {
+var SHADOW_SAFETY_RATIO = 0.4;
+function hiddenKeysFor(shadowedSeqs, nodes) {
+  if (!Array.isArray(shadowedSeqs) || shadowedSeqs.length === 0) return null;
+  const hidden = new Set(shadowedSeqs);
+  const keys = [];
+  for (const node of nodes.values()) {
+    if (node.kind === "recall-marker") continue;
+    if (node.kind === "turn-tail") {
+      const closingSeq = node.data?.closing?.finalNode?.seq;
+      if (typeof closingSeq === "number" && hidden.has(closingSeq)) keys.push(node.key);
+      continue;
+    }
+    if (node.kind === "tool-call") {
+      const resultSeq = node.data?.root?.seq;
+      if (typeof resultSeq === "number" && hidden.has(resultSeq)) keys.push(node.key);
+      continue;
+    }
+    if (typeof node.anchorSeq === "number") {
+      const anchored = node.anchorSeq % 1 === 0 ? node.anchorSeq : Math.ceil(node.anchorSeq);
+      if (hidden.has(anchored)) keys.push(node.key);
+    }
+  }
+  return keys.length === 0 ? null : keys;
+}
+var EMPTY_HIDE_PLAN = Object.freeze({
+  hiddenFor: () => null,
+  planFor: () => null,
+  unionRatio: 0,
+  firstMarkerKey: null
+});
+var PLUGIN_PSEUDO_KINDS = /* @__PURE__ */ new Set(["user-actions", "retrace-reference", "recall-marker"]);
+function realRowCount(nodes) {
+  let count = 0;
+  for (const node of nodes.values()) {
+    if (typeof node.anchorSeq === "number" && !PLUGIN_PSEUDO_KINDS.has(node.kind)) count += 1;
+  }
+  return count;
+}
+var hidePlanCacheSnapshot = null;
+var hidePlanCacheValue = null;
+function useMarkerHidePlan(useSession) {
+  return useSession((snapshot) => {
+    if (hidePlanCacheSnapshot === snapshot) return hidePlanCacheValue;
+    const nodes = snapshot.chat.nodes;
+    const rowCount = realRowCount(nodes);
+    const markers = [];
+    for (const node of nodes.values()) {
+      if (node.kind === "recall-marker" && !node.data?.compact) markers.push(node);
+    }
+    if (markers.length === 0) {
+      hidePlanCacheSnapshot = snapshot;
+      hidePlanCacheValue = EMPTY_HIDE_PLAN;
+      return hidePlanCacheValue;
+    }
+    const plans = /* @__PURE__ */ new Map();
+    const union = /* @__PURE__ */ new Set();
+    for (const marker of markers) {
+      const keys = hiddenKeysFor(marker.data?.shadowedSeqs, nodes);
+      const degraded = keys !== null && rowCount > 0 && keys.length / rowCount > SHADOW_SAFETY_RATIO;
+      plans.set(marker.key, { keys: degraded ? null : keys, degraded });
+      if (keys !== null) for (const key of keys) union.add(key);
+    }
+    hidePlanCacheSnapshot = snapshot;
+    hidePlanCacheValue = {
+      planFor: (key) => plans.get(key) ?? null,
+      hiddenFor: (key) => plans.get(key)?.keys ?? null,
+      unionRatio: rowCount > 0 ? union.size / rowCount : 0,
+      firstMarkerKey: markers[0].key
+    };
+    return hidePlanCacheValue;
+  });
+}
+function rowHiddenByKey(snapshot, rowKey) {
+  if (rowKey === void 0 || rowKey === null) return false;
+  const nodes = snapshot.chat.nodes;
+  const rowCount = realRowCount(nodes);
+  for (const node of nodes.values()) {
+    if (node.kind !== "recall-marker" || node.data?.compact) continue;
+    const keys = hiddenKeysFor(node.data?.shadowedSeqs, nodes);
+    if (keys === null) continue;
+    if (rowCount > 0 && keys.length / rowCount > SHADOW_SAFETY_RATIO) continue;
+    if (keys.includes(rowKey)) return true;
+  }
+  return false;
+}
+function useSeqHidden(useSession, seq) {
   return useSession((snapshot) => {
     if (seq === void 0 || seq === null) return false;
     for (const node of snapshot.chat.nodes.values()) {
-      if (node.kind === "recall-marker" && Array.isArray(node.data?.shadowedSeqs) && node.data.shadowedSeqs.includes(seq)) {
-        return true;
+      if (node.kind !== "recall-marker" && typeof node.anchorSeq === "number" && node.anchorSeq === seq) {
+        return rowHiddenByKey(snapshot, node.key);
       }
     }
     return false;
   });
 }
-var SHADOW_SAFETY_RATIO = 0.4;
-function useHiddenKeys(useSession, shadowedSeqs) {
+function useShadowed(useSession, seq) {
   return useSession((snapshot) => {
-    if (!Array.isArray(shadowedSeqs) || shadowedSeqs.length === 0) return null;
-    const hidden = new Set(shadowedSeqs);
-    const keys = [];
-    let rowCount = 0;
+    if (seq === void 0 || seq === null) return false;
     for (const node of snapshot.chat.nodes.values()) {
-      if (typeof node.anchorSeq === "number") rowCount += 1;
-      if (node.kind === "recall-marker") continue;
-      if (node.kind === "turn-tail") {
-        const closingSeq = node.data?.closing?.finalNode?.seq;
-        if (typeof closingSeq === "number" && hidden.has(closingSeq)) keys.push(node.key);
-        continue;
-      }
-      if (node.kind === "tool-call") {
-        const resultSeq = node.data?.root?.seq;
-        if (typeof resultSeq === "number" && hidden.has(resultSeq)) keys.push(node.key);
-        continue;
+      if (node.kind === "recall-marker" && Array.isArray(node.data?.shadowedSeqs) && node.data.shadowedSeqs.includes(seq)) {
+        return true;
       }
-      if (typeof node.anchorSeq === "number" && hidden.has(node.anchorSeq)) keys.push(node.key);
     }
-    if (keys.length > 0 && rowCount > 0 && keys.length / rowCount > SHADOW_SAFETY_RATIO) return null;
-    return keys.length === 0 ? null : keys;
+    return false;
   });
 }
 function useMarkerDismissed(useSession, markerSeq, op) {
@@ -464,10 +570,11 @@ function useEditReference(useSession, mySeq) {
 }
 function AssistantActions({ messageId, sessionId, useSession, t }) {
   const seq = useMessageSeq(useSession, messageId);
+  const hidden = useSeqHidden(useSession, seq);
   const shadowed = useShadowed(useSession, seq);
   const [busy, setBusy] = (0, import_react.useState)(false);
   const [failure, setFailure] = (0, import_react.useState)(null);
-  if (shadowed || seq === void 0) return null;
+  if (hidden || shadowed || seq === void 0) return null;
   const run = (op) => {
     setBusy(true);
     setFailure(null);
@@ -510,11 +617,11 @@ function AssistantActions({ messageId, sessionId, useSession, t }) {
 }
 function ReferenceRow({ node, useSession, t }) {
   const { seq, messageId } = node.data;
-  const shadowed = useShadowed(useSession, seq);
+  const hidden = useSeqHidden(useSession, seq);
   const markerRef = useEditReference(useSession, seq);
   const referenceText = editReferences.get(messageId) ?? markerRef;
   const config = useConfig();
-  if (shadowed) return null;
+  if (hidden) return null;
   if (referenceText === null || !config.showOriginalInput) return null;
   return (0, import_react.createElement)("div", { className: "dsh-rt-user-row" }, [
     (0, import_react.createElement)("details", { className: "dsh-rt-reference" }, [
@@ -529,12 +636,13 @@ function ReferenceRow({ node, useSession, t }) {
 }
 function UserActionsRow({ node, sessionId, useSession, inputActions, t }) {
   const { seq, messageId, content } = node.data;
+  const hidden = useSeqHidden(useSession, seq);
   const shadowed = useShadowed(useSession, seq);
   const [editing, setEditing] = (0, import_react.useState)(false);
   const [draft, setDraft] = (0, import_react.useState)("");
   const [busy, setBusy] = (0, import_react.useState)(false);
   const [failure, setFailure] = (0, import_react.useState)(null);
-  if (shadowed) return null;
+  if (hidden || shadowed) return null;
   const openEditor = () => {
     setDraft(textOf(content));
     setFailure(null);
@@ -627,15 +735,26 @@ function UserActionsRow({ node, sessionId, useSession, inputActions, t }) {
   ]);
 }
 function RecallMarkerRow({ node, useSession, t }) {
-  const { seq, op, shadowedSeqs, legacy } = node.data;
+  const { seq, op, shadowedSeqs, legacy, compact } = node.data;
+  if (compact) return null;
   const dismissed = useMarkerDismissed(useSession, seq, op);
-  const hiddenKeys = legacy || !getConfig().hideShadowed ? null : useHiddenKeys(useSession, shadowedSeqs);
+  const hidePlan = useMarkerHidePlan(useSession);
+  const plan = hidePlan.planFor(node.key);
+  const hiddenKeys = legacy || !getConfig().hideShadowed ? null : plan?.keys ?? null;
   const css = hiddenKeys === null ? null : hiddenKeys.map((key) => `[data-chat-anchor-key=${JSON.stringify(key)}]{display:none!important}`).join("");
   const count = Array.isArray(shadowedSeqs) ? shadowedSeqs.length : 0;
   const label = op === "recall" ? count > 1 ? t("marker.recallMany", { count }) : t("marker.recallOne") : op === "regenerate" ? t("marker.regenerate") : t("marker.edit");
+  const degradedHint = !legacy && plan?.degraded === true ? (0, import_react.createElement)("div", { key: "degraded", className: "dsh-rt-marker-hint" }, t("marker.degradedHint")) : null;
+  const unionHint = !legacy && hidePlan.firstMarkerKey === node.key && hidePlan.unionRatio > SHADOW_SAFETY_RATIO ? (0, import_react.createElement)(
+    "div",
+    { key: "union", className: "dsh-rt-marker-hint" },
+    t("marker.unionHint", { count: Math.round(hidePlan.unionRatio * 100) })
+  ) : null;
   return (0, import_react.createElement)("div", { className: "dsh-rt-marker-block", "data-dismissed": dismissed || void 0 }, [
     css !== null && (0, import_react.createElement)("style", { key: "hide", dangerouslySetInnerHTML: { __html: css } }),
-    !dismissed && (0, import_react.createElement)("div", { key: "label", className: "dsh-rt-marker", role: "status" }, label)
+    !dismissed && (0, import_react.createElement)("div", { key: "label", className: "dsh-rt-marker", role: "status" }, label),
+    !dismissed && degradedHint,
+    !dismissed && unionHint
   ]);
 }
 function OptionsRow({ t }) {
@@ -712,6 +831,7 @@ var CSS = `
 .dsh-rt-error{color:var(--dsw-alias-state-error-primary);font-size:12px;line-height:18px;max-width:min(525px,82%)}
 .dsh-rt-marker-block{display:flex;flex-direction:column;align-items:center;gap:4px;width:100%;max-width:var(--dsh-chat-content-width);box-sizing:border-box;margin:0 auto;padding:2px 0}
 .dsh-rt-marker{text-align:center;color:var(--dsw-alias-label-tertiary);font-size:12px;line-height:20px}
+.dsh-rt-marker-hint{text-align:center;color:var(--dsw-alias-state-warning-primary);font-size:11px;line-height:16px;margin-top:2px}
 .dsh-rt-reference{width:min(525px,82%);box-sizing:border-box;border:1px dashed var(--dsw-alias-border-l2);background:var(--dsw-alias-bg-elevated);border-radius:10px;padding:2px 12px}
 .dsh-rt-reference summary{color:var(--dsw-alias-label-caption);cursor:pointer;user-select:none;font-size:12px;line-height:22px;list-style:none;display:inline-flex;align-items:center;gap:6px;max-width:100%;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}
 .dsh-rt-reference summary::-webkit-details-marker{display:none}
@@ -730,7 +850,8 @@ var CSS = `
 .dsh-rt-retention-input:focus{box-shadow:0 0 0 2px var(--dsw-alias-state-business-primary)}
 .dsh-rt-option input{accent-color:var(--dsw-alias-state-business-primary)}
 /* ---- P1 timeline (conversation view tab) ---- */
-.dsh-rt-view{box-sizing:border-box;display:flex;flex-direction:column;gap:6px;height:100%;min-height:0;padding:12px 16px 0}
+
+.dsh-rt-view{box-sizing:border-box;display:flex;flex-direction:column;gap:6px;flex:1 1 0%;min-height:0;overflow:hidden;padding:12px 16px 0}
 .dsh-rt-timeline-head{display:flex;align-items:center;gap:8px;flex:none}
 .dsh-rt-timeline-title{color:var(--dsw-alias-label-primary);font-size:13px;font-weight:600;line-height:20px;flex:1}
 .dsh-rt-timeline-git{display:flex;align-items:center;gap:6px;flex:none;border:1px dashed var(--dsw-alias-border-l2);border-radius:8px;padding:4px 8px}
@@ -767,7 +888,126 @@ var CSS = `
 .dsh-rt-modal-buttons{display:flex;justify-content:flex-end;gap:8px;flex:none}
 .dsh-rt-confirm{background:var(--dsw-alias-state-error-primary)}
 .dsh-rt-modal-json{margin:0;overflow:auto;color:var(--dsw-alias-label-secondary);background:var(--dsw-alias-bg-elevated);border:1px solid var(--dsw-alias-border-l2);border-radius:8px;padding:8px;font-family:var(--dsw-font-mono);font-size:11px;line-height:15px;white-space:pre-wrap;word-break:break-all}
+.dsh-rt-fork-list{overflow-y:auto;flex:1;min-height:0;position:relative}
+.dsh-rt-fork-spine-label{color:var(--dsw-alias-label-caption);font-size:11px;line-height:16px;flex:none}
+.dsh-rt-fork-row{position:absolute;left:0;right:0;box-sizing:border-box;display:flex;align-items:flex-start;gap:8px;padding:6px 8px;border-radius:8px}
+.dsh-rt-fork-row:hover{background:var(--dsw-alias-interactive-bg-hover)}
+.dsh-rt-fork-icon{flex:none;width:22px;height:22px;display:inline-flex;justify-content:center;align-items:center;font-size:13px;color:var(--dsw-alias-label-secondary)}
+.dsh-rt-fork-boundary .dsh-rt-fork-icon{color:var(--dsw-alias-state-warning-primary)}
+.dsh-rt-fork-body{flex:1;min-width:0;display:flex;flex-direction:column;gap:2px}
+.dsh-rt-fork-line{display:flex;align-items:baseline;gap:8px;min-width:0}
+.dsh-rt-fork-label{font-size:12px;font-weight:500;line-height:18px;color:var(--dsw-alias-label-primary);white-space:nowrap}
+.dsh-rt-fork-seq{font-family:var(--dsw-font-mono);font-size:11px;line-height:18px;color:var(--dsw-alias-label-caption);flex:none}
+.dsh-rt-fork-shadowed{font-size:11px;line-height:18px;color:var(--dsw-alias-state-warning-primary);flex:none}
+.dsh-rt-fork-text{font-size:11px;line-height:16px;color:var(--dsw-alias-label-secondary);min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
+.dsh-rt-fork-boundary{border:1px solid var(--dsw-alias-border-l2);background:var(--dsw-alias-bg-elevated)}
+.dsh-rt-fork-hist{display:flex;flex-direction:column;gap:4px;border-top:1px solid var(--dsw-alias-border-l2);padding-top:8px;overflow-y:auto;flex:none}
+.dsh-rt-fork-hist-row{display:flex;align-items:flex-start;gap:8px;padding:4px 8px;border-radius:8px}
+.dsh-rt-fork-hist-row:hover{background:var(--dsw-alias-interactive-bg-hover)}
 `;
+var JUMP_PAGE_BUDGET = 24;
+function switchToViewTab(viewId) {
+  const ORDER = { chat: 0, trajectory: 1, retrace: 2, "retrace-fork": 3 };
+  const index = ORDER[viewId];
+  if (index === void 0) {
+    console.warn(`[dsh-retrace] no tab order registered for "${viewId}"`);
+    return;
+  }
+  const buttons = [...document.querySelectorAll('[role="tablist"]')].filter((tablist) => tablist.getBoundingClientRect().width > 0).flatMap((tablist) => [...tablist.querySelectorAll('[role="tab"]')]);
+  const button = buttons[index];
+  if (!button) {
+    console.warn(`[dsh-retrace] tab "${viewId}" (index ${index}) not found in the conversation tab bar`);
+    return;
+  }
+  button.click();
+}
+function nodeCountOf(nodes) {
+  if (!nodes) return 0;
+  if (typeof nodes.size === "number") return nodes.size;
+  return [...nodes.values()].length;
+}
+function waitForElement(selector, frames) {
+  return new Promise((resolve) => {
+    let remaining = frames;
+    const probe = () => {
+      const el = document.querySelector(selector);
+      if (el !== null) return resolve(el);
+      if (remaining-- <= 0) return resolve(null);
+      requestAnimationFrame(probe);
+    };
+    requestAnimationFrame(probe);
+  });
+}
+function flashKey(key) {
+  const id = `dsh-rt-jump-${key.replace(/[^a-z0-9]/gi, "-")}`;
+  if (document.querySelector(`style[data-plugin-css="${id}"]`)) return;
+  const tag = document.createElement("style");
+  tag.dataset.pluginCss = id;
+  tag.textContent = `[data-chat-anchor-key=${JSON.stringify(key)}]{animation:dsh-rt-flash 1.6s ease-out 2}@keyframes dsh-rt-flash{0%,100%{background:transparent}30%,70%{background:var(--dsw-alias-state-business-primary)}55%{background:color-mix(in srgb,var(--dsw-alias-state-business-primary) 30%,transparent)}}`;
+  document.head.appendChild(tag);
+  setTimeout(() => tag.remove(), 3400);
+}
+async function jumpToAnchor(store, anchorSeq) {
+  switchToViewTab("chat");
+  if (!store || typeof store.loadOlder !== "function" || typeof store.getSnapshot !== "function") return;
+  const keyOfSeq = (seq) => {
+    const nodes = store.getSnapshot()?.chat?.nodes;
+    if (!nodes) return null;
+    for (const node of nodes.values()) {
+      if (typeof node.anchorSeq === "number" && node.anchorSeq === seq) return node.key;
+    }
+    return null;
+  };
+  let key = keyOfSeq(anchorSeq);
+  let pages = 0;
+  while (key === null && pages < JUMP_PAGE_BUDGET && store.hasMore) {
+    const before = nodeCountOf(store.getSnapshot()?.chat?.nodes);
+    await store.loadOlder();
+    const after = nodeCountOf(store.getSnapshot()?.chat?.nodes);
+    pages += 1;
+    if (after === before) break;
+    key = keyOfSeq(anchorSeq);
+  }
+  if (key === null) {
+    await new Promise((resolve) => setTimeout(resolve, 60));
+    key = keyOfSeq(anchorSeq);
+  }
+  if (key === null) {
+    console.warn(`[dsh-retrace] jump target seq ${anchorSeq} not reached within ${JUMP_PAGE_BUDGET} pages`);
+    return;
+  }
+  const el = await waitForElement(`[data-chat-anchor-key=${JSON.stringify(key)}]`, 90);
+  if (el === null) return;
+  el.scrollIntoView({ behavior: "smooth", block: "center" });
+  flashKey(key);
+}
+var NODE_ICONS = { "user/message": "\u{1F464}", "assistant/message": "\u{1F916}", "tool/result": "\u{1F527}" };
+function nodeTypeLabel(type, t) {
+  if (type === "user/message") return t("fork.node.user");
+  if (type === "assistant/message") return t("fork.node.assistant");
+  if (type === "tool/result") return t("fork.node.tool");
+  return type;
+}
+function bindListHeight(listEl) {
+  if (!listEl) return () => {
+  };
+  const measure = () => {
+    const top = listEl.getBoundingClientRect().top;
+    const height = Math.max(120, window.innerHeight - top - 16);
+    if (Math.abs(listEl.clientHeight - height) > 4) {
+      listEl.style.flex = "none";
+      listEl.style.height = `${height}px`;
+    }
+  };
+  measure();
+  const ro = typeof ResizeObserver === "function" ? new ResizeObserver(measure) : null;
+  ro?.observe(document.body);
+  window.addEventListener("resize", measure);
+  return () => {
+    ro?.disconnect();
+    window.removeEventListener("resize", measure);
+  };
+}
 function ensureStyle() {
   if (typeof document === "undefined") return () => {
   };
@@ -835,63 +1075,7 @@ function RetraceView({ sessionId, useProjection, t, actions, store }) {
     if (projected === void 0) refresh();
     refreshGit();
   }, []);
-  const JUMP_PAGE_BUDGET = 24;
-  const jump = async (boundarySeq) => {
-    actions?.setView?.("chat");
-    const target = store;
-    if (!target || typeof target.loadOlder !== "function" || typeof target.getSnapshot !== "function") return;
-    const keyOfSeq = (seq) => {
-      const nodes = target.getSnapshot()?.chat?.nodes;
-      if (!nodes) return null;
-      for (const node of nodes.values()) {
-        if (typeof node.anchorSeq === "number" && node.anchorSeq === seq) return node.key;
-      }
-      return null;
-    };
-    let key = keyOfSeq(boundarySeq);
-    let pages = 0;
-    while (key === null && pages < JUMP_PAGE_BUDGET && target.hasMore) {
-      const before = target.getSnapshot()?.chat?.nodes?.size ?? 0;
-      await target.loadOlder();
-      const after = target.getSnapshot()?.chat?.nodes?.size ?? 0;
-      pages += 1;
-      if (after === before) break;
-      key = keyOfSeq(boundarySeq);
-    }
-    if (key === null) {
-      await new Promise((resolve) => setTimeout(resolve, 60));
-      key = keyOfSeq(boundarySeq);
-    }
-    if (key === null) {
-      console.warn(`[dsh-retrace] jump target seq ${boundarySeq} not reached within ${JUMP_PAGE_BUDGET} pages`);
-      return;
-    }
-    const el = await waitForElement(`[data-chat-anchor-key=${JSON.stringify(key)}]`, 90);
-    if (el === null) return;
-    el.scrollIntoView({ behavior: "smooth", block: "center" });
-    flashKey(key);
-  };
-  function waitForElement(selector, frames) {
-    return new Promise((resolve) => {
-      let remaining = frames;
-      const probe = () => {
-        const el = document.querySelector(selector);
-        if (el !== null) return resolve(el);
-        if (remaining-- <= 0) return resolve(null);
-        requestAnimationFrame(probe);
-      };
-      requestAnimationFrame(probe);
-    });
-  }
-  function flashKey(key) {
-    const id = `dsh-rt-jump-${key.replace(/[^a-z0-9]/gi, "-")}`;
-    if (document.querySelector(`style[data-plugin-css="${id}"]`)) return;
-    const tag = document.createElement("style");
-    tag.dataset.pluginCss = id;
-    tag.textContent = `[data-chat-anchor-key=${JSON.stringify(key)}]{animation:dsh-rt-flash 1.6s ease-out 2}@keyframes dsh-rt-flash{0%,100%{background:transparent}30%,70%{background:var(--dsw-alias-state-business-primary)}55%{background:color-mix(in srgb,var(--dsw-alias-state-business-primary) 30%,transparent)}}`;
-    document.head.appendChild(tag);
-    setTimeout(() => tag.remove(), 3400);
-  }
+  const jump = (boundarySeq) => jumpToAnchor(store, boundarySeq);
   const requestPreview = (record) => {
     setPreviewScope("both");
     setPreview({ versionId: record.versionId, kind: record.kind, boundarySeq: record.boundarySeq, data: null, error: null });
@@ -924,6 +1108,10 @@ function RetraceView({ sessionId, useProjection, t, actions, store }) {
   const ROW_H = 64;
   const list = versions ?? [];
   const visible = list.slice(Math.max(0, Math.floor(scrollTop / ROW_H) - 2), Math.min(list.length, Math.ceil(scrollTop / ROW_H) + Math.ceil(640 / ROW_H) + 2));
+  (0, import_react.useEffect)(() => {
+    if (list.length === 0) return void 0;
+    return bindListHeight(document.querySelector(".dsh-rt-view .dsh-rt-timeline-list"));
+  }, [list.length]);
   return (0, import_react.createElement)("div", { className: "dsh-rt-view" }, [
     (0, import_react.createElement)("div", { key: "head", className: "dsh-rt-timeline-head" }, [
       (0, import_react.createElement)("span", { key: "title", className: "dsh-rt-timeline-title" }, t("timeline.title")),
@@ -961,7 +1149,7 @@ function RetraceView({ sessionId, useProjection, t, actions, store }) {
           t,
           top: list.indexOf(record) * ROW_H,
           onPreview: () => requestPreview(record),
-          onTrajectory: () => actions?.setView?.("trajectory"),
+          onTrajectory: () => switchToViewTab("trajectory"),
           onJump: () => jump(record.boundarySeq)
         }))
       ])
@@ -1044,6 +1232,135 @@ function PreviewBox({ preview, scope, setScope, busy, t, onConfirm, onCancel })
     ])
   ]);
 }
+function ForkView({ sessionId, useProjection, t, actions, store }) {
+  const [fork, setFork] = (0, import_react.useState)(null);
+  const [loading, setLoading] = (0, import_react.useState)(false);
+  const [error, setError] = (0, import_react.useState)(null);
+  const [scrollTop, setScrollTop] = (0, import_react.useState)(0);
+  const projected = typeof useProjection === "function" ? useProjection("retrace/forkmap") : void 0;
+  const versions = typeof useProjection === "function" ? useProjection("retrace/versions") : void 0;
+  const markerBySeq = new Map((versions?.versions ?? []).map((v) => [v.boundarySeq, v.markerText]));
+  (0, import_react.useEffect)(() => {
+    if (projected && Array.isArray(projected.nodes) && Array.isArray(projected.boundaries)) setFork(projected);
+  }, [projected]);
+  const refresh = () => {
+    setLoading(true);
+    setError(null);
+    timelineGet(`/forkmap?sessionId=${encodeURIComponent(sessionId)}`).then((result) => {
+      if (!result || result.ok !== true) throw new Error(result?.error?.message ?? "forkmap failed");
+      setFork(result.value?.nodes ? result.value : null);
+    }).catch((cause) => setError(cause?.message ?? "forkmap error")).finally(() => setLoading(false));
+  };
+  (0, import_react.useEffect)(() => {
+    if (projected === void 0) refresh();
+  }, []);
+  const nodes = fork?.nodes ?? [];
+  const boundaries = fork?.boundaries ?? [];
+  const boundaryBySeq = new Map(boundaries.map((b) => [b.seq, b]));
+  const spineSeqSet = new Set(nodes.map((n) => n.seq));
+  const offSpine = boundaries.filter((b) => !spineSeqSet.has(b.seq));
+  (0, import_react.useEffect)(() => {
+    if (nodes.length === 0) return void 0;
+    return bindListHeight(document.querySelector(".dsh-rt-view .dsh-rt-fork-list"));
+  }, [nodes.length]);
+  const ROW_H = 56;
+  const visible = nodes.slice(
+    Math.max(0, Math.floor(scrollTop / ROW_H) - 2),
+    Math.min(nodes.length, Math.ceil(scrollTop / ROW_H) + Math.ceil(640 / ROW_H) + 2)
+  );
+  return (0, import_react.createElement)("div", { className: "dsh-rt-view" }, [
+    (0, import_react.createElement)("div", { key: "head", className: "dsh-rt-timeline-head" }, [
+      (0, import_react.createElement)("span", { key: "title", className: "dsh-rt-timeline-title" }, t("fork.title")),
+      (0, import_react.createElement)("button", {
+        key: "refresh",
+        type: "button",
+        className: "dsh-rt-chip",
+        onClick: refresh
+      }, t("fork.refresh"))
+    ]),
+    error !== null && (0, import_react.createElement)("div", { key: "error", className: "dsh-rt-error" }, error),
+    loading && (0, import_react.createElement)("div", { key: "loading", className: "dsh-rt-timeline-empty" }, t("timeline.loading")),
+    !loading && nodes.length === 0 && (0, import_react.createElement)("div", { key: "empty", className: "dsh-rt-timeline-empty" }, t("fork.empty")),
+    nodes.length > 0 && (0, import_react.createElement)("div", { key: "spine", className: "dsh-rt-fork-spine-label" }, t("fork.spine")),
+    nodes.length > 0 && (0, import_react.createElement)("div", {
+      key: "list",
+      className: "dsh-rt-fork-list",
+      onScroll: (event) => setScrollTop(event.target.scrollTop)
+    }, [
+      (0, import_react.createElement)("div", { key: "spacer", style: { height: `${nodes.length * ROW_H}px`, position: "relative" } }, [
+        visible.map((node) => (0, import_react.createElement)(ForkRow, {
+          key: node.seq,
+          node,
+          boundary: boundaryBySeq.get(node.seq),
+          markerText: markerBySeq.get(node.seq),
+          t,
+          top: nodes.indexOf(node) * ROW_H,
+          onJump: () => jumpToAnchor(store, node.seq)
+        }))
+      ])
+    ]),
+    offSpine.length > 0 && (0, import_react.createElement)("div", { key: "hist", className: "dsh-rt-fork-hist" }, [
+      (0, import_react.createElement)("div", { key: "title", className: "dsh-rt-fork-spine-label" }, t("fork.histTitle")),
+      offSpine.map((boundary) => (0, import_react.createElement)(ForkHistRow, {
+        key: boundary.seq,
+        boundary,
+        markerText: markerBySeq.get(boundary.seq),
+        t,
+        onJump: () => jumpToAnchor(store, boundary.seq)
+      }))
+    ])
+  ]);
+}
+function ForkRow({ node, boundary, markerText, t, top, onJump }) {
+  const isBoundary = boundary !== void 0;
+  const icon = isBoundary ? KIND_ICONS[boundary.kind] ?? "\u2022" : NODE_ICONS[node.type] ?? "\u2022";
+  const label = isBoundary ? kindLabel(boundary.kind, t) : nodeTypeLabel(node.type, t);
+  return (0, import_react.createElement)("div", {
+    className: `dsh-rt-fork-row${isBoundary ? " dsh-rt-fork-boundary" : ""}`,
+    style: { top: `${top}px` }
+  }, [
+    (0, import_react.createElement)("span", { key: "icon", className: "dsh-rt-fork-icon" }, icon),
+    (0, import_react.createElement)("div", { key: "body", className: "dsh-rt-fork-body" }, [
+      (0, import_react.createElement)("div", { key: "line", className: "dsh-rt-fork-line" }, [
+        (0, import_react.createElement)("span", { key: "label", className: "dsh-rt-fork-label" }, label),
+        (0, import_react.createElement)("span", { key: "seq", className: "dsh-rt-fork-seq" }, `#${node.seq}`),
+        isBoundary && boundary.replacedSeqs.length > 0 && (0, import_react.createElement)(
+          "span",
+          { key: "shadowed", className: "dsh-rt-fork-shadowed" },
+          t("fork.shadowed", { count: boundary.replacedSeqs.length })
+        )
+      ]),
+      isBoundary && markerText && (0, import_react.createElement)(
+        "div",
+        { key: "text", className: "dsh-rt-fork-text" },
+        markerText.length > 140 ? `${markerText.slice(0, 140)}\u2026` : markerText
+      )
+    ]),
+    (0, import_react.createElement)("button", { key: "jump", type: "button", className: "dsh-rt-chip", onClick: onJump }, t("timeline.jump"))
+  ]);
+}
+function ForkHistRow({ boundary, markerText, t, onJump }) {
+  return (0, import_react.createElement)("div", { className: "dsh-rt-fork-hist-row" }, [
+    (0, import_react.createElement)("span", { key: "icon", className: "dsh-rt-fork-icon" }, KIND_ICONS[boundary.kind] ?? "\u2022"),
+    (0, import_react.createElement)("div", { key: "body", className: "dsh-rt-fork-body" }, [
+      (0, import_react.createElement)("div", { key: "line", className: "dsh-rt-fork-line" }, [
+        (0, import_react.createElement)("span", { key: "label", className: "dsh-rt-fork-label" }, kindLabel(boundary.kind, t)),
+        (0, import_react.createElement)("span", { key: "seq", className: "dsh-rt-fork-seq" }, `#${boundary.seq}`),
+        boundary.replacedSeqs.length > 0 && (0, import_react.createElement)(
+          "span",
+          { key: "shadowed", className: "dsh-rt-fork-shadowed" },
+          t("fork.shadowed", { count: boundary.replacedSeqs.length })
+        )
+      ]),
+      markerText && (0, import_react.createElement)(
+        "div",
+        { key: "text", className: "dsh-rt-fork-text" },
+        markerText.length > 140 ? `${markerText.slice(0, 140)}\u2026` : markerText
+      )
+    ]),
+    (0, import_react.createElement)("button", { key: "jump", type: "button", className: "dsh-rt-chip", onClick: onJump }, t("timeline.jump"))
+  ]);
+}
 function apply(ctx) {
   const disposeStyle = ensureStyle();
   ctx.effect(() => () => disposeStyle(), "dsh-retrace: styles");
@@ -1051,9 +1368,12 @@ function apply(ctx) {
   const t = ctx.locale.bind(NS);
   const conversationEvents = ctx.get("conversationEvents");
   if (conversationEvents) {
-    conversationEvents.register(userActionsDefinition);
-    conversationEvents.register(userReferenceDefinition);
-    conversationEvents.register(recallMarkerDefinition);
+    const disposeDefinitions = [
+      conversationEvents.register(userActionsDefinition),
+      conversationEvents.register(userReferenceDefinition),
+      conversationEvents.register(recallMarkerDefinition)
+    ];
+    ctx.effect(() => () => disposeDefinitions.forEach((dispose) => dispose()), "dsh-retrace: conversation definitions");
   }
   ctx.slots.inject("conversation.chat.assistant-actions", () => ctx.slots.register({
     name: "conversation.chat.assistant-actions",
@@ -1087,6 +1407,17 @@ function apply(ctx) {
       store: ctx.get?.("sessions")?.binding?.(sessionId)?.session
     })
   }, RetraceView));
+  ctx.slots.inject("conversation.view", () => ctx.slots.register({
+    name: "conversation.view",
+    id: "retrace-fork",
+    order: 30,
+    locale: NS,
+    label: () => t("view.fork"),
+    inject: (sessionId, actions) => ({
+      actions,
+      store: ctx.get?.("sessions")?.binding?.(sessionId)?.session
+    })
+  }, ForkView));
   ctx.slots.inject("settings.general.item", () => ctx.slots.register({
     name: "settings.general.item",
     id: "retrace",