openclacky 1.5.13 → 1.5.14

data/lib/clacky/web/features/workspace/view.js

@@ -16,7 +16,7 @@
 "use strict";
 
 const WorkspaceView = (() => {
-  const t = (key) => (typeof I18n !== "undefined" ? I18n.t(key) : key);
+  const t = (key, vars) => (typeof I18n !== "undefined" ? I18n.t(key, vars) : key);
 
   const ICON_FOLDER = '<svg xmlns="http://www.w3.org/2000/svg" width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M22 19a2 2 0 0 1-2 2H4a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2h5l2 3h9a2 2 0 0 1 2 2z"/></svg>';
   const ICON_FOLDER_OPEN = '<svg xmlns="http://www.w3.org/2000/svg" width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="m6 14 1.5-2.9A2 2 0 0 1 9.24 10H20a2 2 0 0 1 1.94 2.5l-1.54 6a2 2 0 0 1-1.95 1.5H4a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2h3.9a2 2 0 0 1 1.69.9l.81 1.2a2 2 0 0 0 1.67.9H18a2 2 0 0 1 2 2v2"/></svg>';
@@ -27,6 +27,11 @@ const WorkspaceView = (() => {
   const ICON_SAVE    = '<svg viewBox="0 0 24 24" width="14" height="14" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M19 21H5a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2h11l5 5v11a2 2 0 0 1-2 2z"/><polyline points="17 21 17 13 7 13 7 21"/><polyline points="7 3 7 8 15 8"/></svg>';
   const ICON_EYE     = '<svg viewBox="0 0 24 24" width="14" height="14" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M1 12s4-8 11-8 11 8 11 8-4 8-11 8-11-8-11-8z"/><circle cx="12" cy="12" r="3"/></svg>';
   const ICON_CLOSE   = '<svg viewBox="0 0 24 24" width="12" height="12" fill="none" stroke="currentColor" stroke-width="2.5" stroke-linecap="round"><path d="M18 6L6 18M6 6l12 12"/></svg>';
+  const ICON_CHEVRON_DOWN = '<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" width="14" height="14" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><polyline points="6 9 12 15 18 9"/></svg>';
+  const ICON_EXTERNAL = '<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" width="12" height="12" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M18 13v6a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V8a2 2 0 0 1 2-2h6"/><polyline points="15 3 21 3 21 9"/><line x1="10" y1="14" x2="21" y2="3"/></svg>';
+  const ICON_PANEL_LEFT = '<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" width="14" height="14" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><rect x="3" y="3" width="18" height="18" rx="2"/><line x1="9" y1="3" x2="9" y2="21"/></svg>';
+  const ICON_ARROW_LEFT = '<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" width="14" height="14" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M19 12H5"/><path d="m12 19-7-7 7-7"/></svg>';
+  const ICON_COLUMNS = '<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" width="14" height="14" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><rect x="3" y="3" width="18" height="18" rx="2"/><line x1="12" y1="3" x2="12" y2="21"/></svg>';
 
   function el(tag, cls) {
     const d = document.createElement(tag);
@@ -357,6 +362,94 @@ const WorkspaceView = (() => {
     if (existing) existing.remove();
   }
 
+  function showOpenWithMenu(anchorBtn, entry) {
+    closeOpenWithMenu();
+
+    const menu = el("div", "wt-context-menu session-context-menu wv-open-menu");
+    const appendAction = (iconSvg, label, onClick) => {
+      const item = el("div", "session-actions-menu-item");
+      const iconEl = el("span", "session-actions-menu-icon");
+      iconEl.innerHTML = iconSvg;
+      const labelEl = el("span", "session-actions-menu-label");
+      labelEl.textContent = label;
+      item.appendChild(iconEl);
+      item.appendChild(labelEl);
+      item.addEventListener("click", () => {
+        closeOpenWithMenu();
+        onClick();
+      });
+      menu.appendChild(item);
+    };
+    appendAction(ICON_FOLDER, t("workspace.revealInFinder"), () => revealFile(entry));
+    appendAction(ICON_DOWNLOAD, t("workspace.download"), () => downloadFile(entry));
+
+    document.body.appendChild(menu);
+    menu.addEventListener("contextmenu", (ev) => ev.preventDefault());
+    menu.style.position = "fixed";
+    const fitMenu = () => {
+      const r = anchorBtn.getBoundingClientRect();
+      const mr = menu.getBoundingClientRect();
+      if (mr.right > window.innerWidth - 8) {
+        menu.style.left = "auto";
+        menu.style.right = "8px";
+      }
+      if (mr.bottom > window.innerHeight - 8) {
+        menu.style.top = (Math.max(8, r.top - mr.height - 4)) + "px";
+      }
+    };
+    const r = anchorBtn.getBoundingClientRect();
+    menu.style.top = (r.bottom + 4) + "px";
+    menu.style.left = r.left + "px";
+    requestAnimationFrame(fitMenu);
+
+    setTimeout(() => {
+      document.addEventListener("click", closeOpenWithMenu, { once: true });
+    }, 0);
+
+    Promise.all([
+      Workspace.fetchOpenWithApps(entry),
+      Workspace.fetchDefaultApp(entry)
+    ]).then(([apps, defaultApp]) => {
+      if (!document.body.contains(menu)) return;
+      if (apps.length) {
+        const frag = document.createDocumentFragment();
+        apps.forEach((app) => {
+          const isDefault = defaultApp && defaultApp.path === app.path;
+          const item = el("div", "session-actions-menu-item" + (isDefault ? " wv-open-menu-item--default" : ""));
+          if (isDefault) item.title = t("workspace.openDefault");
+          const iconEl = el("span", "session-actions-menu-icon wv-open-app-icon");
+          const img = document.createElement("img");
+          img.alt = "";
+          img.src = "/api/app-icon?path=" + encodeURIComponent(app.path);
+          img.addEventListener("error", () => { img.remove(); });
+          iconEl.appendChild(img);
+          const labelEl = el("span", "session-actions-menu-label");
+          labelEl.textContent = app.name;
+          item.appendChild(iconEl);
+          item.appendChild(labelEl);
+          item.addEventListener("click", async () => {
+            closeOpenWithMenu();
+            try {
+              await Workspace.openWithApp(entry, app.path);
+            } catch (err) {
+              console.error("open_with failed:", err);
+              Modal.toast(t("workspace.openWithFailed") + ": " + err.message, "error");
+            }
+          });
+          frag.appendChild(item);
+        });
+        frag.appendChild(el("div", "wv-open-menu-separator"));
+        menu.insertBefore(frag, menu.firstChild);
+        fitMenu();
+      }
+    }).catch(() => { /* not macOS or scan failed — reveal/download still work */ });
+  }
+
+  function closeOpenWithMenu() {
+    const existing = document.querySelector(".wv-open-menu");
+    if (existing) existing.remove();
+  }
+
   async function copyPath(entry) {
     const fallback = Workspace.state.workingDir.replace(/\/+$/, "") + "/" + entry.path.replace(/^\/+/, "");
     let target = fallback;
@@ -443,27 +536,36 @@ const WorkspaceView = (() => {
 
   // ── Inline tabbed viewer ────────────────────────────────────────────────
 
-  // The tree + viewer split needs horizontal room; widen the aside once when
-  // the first file is opened (still user-resizable afterwards).
-  function ensureAsideWidth() {
-    const aside = document.getElementById("session-aside");
-    if (!aside) return;
-    let w = 0;
-    try {
-      w = parseFloat(getComputedStyle(aside).getPropertyValue("--session-aside-width")) || 0;
-    } catch (_e) { w = 0; }
-    const target = 620;
-    if (w < target) {
-      aside.style.setProperty("--session-aside-width", target + "px");
-      try { localStorage.setItem("clacky.aside.width", String(target)); } catch (_e) { /* non-fatal */ }
-    }
-  }
+  const VIEWER_ASIDE_WIDTH = 700;
 
-  function createViewer(onTabsChanged) {
+  // Active viewer instance (one per mounted Files tab). Kept at module level
+  // so openFile() — called from chat file:// link clicks — can reach the
+  // viewer without waiting for a DOM query or a custom event round-trip.
+  let _activeViewer = null;
+  // Unsubscriber for the active mount's refresh listeners. The aside can
+  // re-mount the Files tab without running the previous teardown (new-session
+  // page / same-session re-render), so the next mount releases these first to
+  // avoid stacking duplicate reloads.
+  let _activeOff = null;
+
+  function createViewer(onTabsChanged, onToggleTree, onShowMobileTree) {
     const tabs = [];
     let activeId = null;
+    let releaseAsideWidth = null;
     const notify = () => { if (onTabsChanged) onTabsChanged({ count: tabs.length, activeId }); };
 
+    function ensureAsideWidth() {
+      if (releaseAsideWidth || !window.Clacky || !Clacky.Aside || !Clacky.Aside.requestWidth) return;
+      releaseAsideWidth = Clacky.Aside.requestWidth(VIEWER_ASIDE_WIDTH);
+    }
+
+    function restoreAsideWidth() {
+      if (!releaseAsideWidth) return;
+      const release = releaseAsideWidth;
+      releaseAsideWidth = null;
+      release();
+    }
+
     const root = el("div", "wv-viewer");
 
     const tabbar = el("div", "wv-tabbar");
@@ -477,19 +579,68 @@ const WorkspaceView = (() => {
       const btn = el("button", "wv-action" + (cls ? " " + cls : ""));
       btn.type = "button";
       btn.title = title;
+      btn.setAttribute("aria-label", title);
       btn.innerHTML = icon;
       return btn;
     }
 
+    const toggleTreeBtn = actionBtn(ICON_PANEL_LEFT, t("workspace.toggleTree"));
+    toggleTreeBtn.classList.add("wv-toggle-tree", "active");
+    toggleTreeBtn.addEventListener("click", () => {
+      const hidden = onToggleTree ? onToggleTree() : false;
+      toggleTreeBtn.classList.toggle("active", !hidden);
+    });
+
+    const mobileBackBtn = actionBtn(ICON_ARROW_LEFT, t("workspace.backToFiles"), "wv-mobile-back");
+    mobileBackBtn.addEventListener("click", () => {
+      if (onShowMobileTree) onShowMobileTree();
+    });
+
     const previewBtn  = actionBtn(ICON_EYE, t("workspace.preview"));
+    const splitBtn    = actionBtn(ICON_COLUMNS, t("workspace.splitPreview"));
     const copyBtn     = actionBtn(ICON_COPY, t("workspace.copyContent"));
-    const downloadBtn = actionBtn(ICON_DOWNLOAD, t("workspace.download"));
     const saveBtn     = actionBtn(ICON_SAVE, t("modal.save"));
+
+    // Split button shown for binary (non-previewable) tabs: text part opens
+    // with the OS default app, the chevron opens the "open with" dropdown.
+    const openGroup = el("div", "wv-action-group");
+    const openMainBtn = el("button", "wv-action wv-action--open");
+    openMainBtn.type = "button";
+    openMainBtn.title = t("workspace.openDefault");
+    const openIconEl = el("span", "wv-main-app-icon");
+    openIconEl.innerHTML = ICON_EXTERNAL;
+    const openLabel = el("span");
+    openLabel.textContent = t("workspace.open");
+    openMainBtn.appendChild(openIconEl);
+    openMainBtn.appendChild(openLabel);
+    openMainBtn.addEventListener("click", async () => {
+      const tab = activeTab();
+      if (!tab) return;
+      try {
+        await Workspace.openWithDefault(tab.entry);
+      } catch (err) {
+        console.error("open failed:", err);
+        Modal.toast(t("workspace.openWithFailed") + ": " + err.message, "error");
+      }
+    });
+    const openArrowBtn = actionBtn(ICON_CHEVRON_DOWN, t("workspace.openWith"));
+    openArrowBtn.addEventListener("click", (e) => {
+      e.stopPropagation();
+      const tab = activeTab();
+      if (!tab) return;
+      showOpenWithMenu(openArrowBtn, tab.entry);
+    });
+    openGroup.appendChild(openMainBtn);
+    openGroup.appendChild(openArrowBtn);
+
+    actionsEl.appendChild(toggleTreeBtn);
     actionsEl.appendChild(previewBtn);
+    actionsEl.appendChild(splitBtn);
     actionsEl.appendChild(copyBtn);
-    actionsEl.appendChild(downloadBtn);
+    actionsEl.appendChild(openGroup);
     actionsEl.appendChild(saveBtn);
 
+    tabbar.appendChild(mobileBackBtn);
     tabbar.appendChild(tabsEl);
     tabbar.appendChild(actionsEl);
 
@@ -538,12 +689,39 @@ const WorkspaceView = (() => {
 
     function updateActions() {
       const tab = activeTab();
+      openGroup.style.display     = tab ? "" : "none";
       previewBtn.style.display  = tab && tab.kind === "text" && tab.isMd ? "" : "none";
+      splitBtn.style.display    = tab && tab.kind === "text" && tab.isMd ? "" : "none";
       copyBtn.style.display     = tab && tab.kind === "text" ? "" : "none";
       saveBtn.style.display     = tab && tab.kind === "text" ? "" : "none";
-      downloadBtn.style.display = tab ? "" : "none";
       previewBtn.classList.toggle("active", !!(tab && tab.previewMode));
+      splitBtn.classList.toggle("active", !!(tab && tab.splitMode));
       saveBtn.classList.toggle("dirty", !!(tab && tab.dirty));
+      refreshOpenIcon();
+    }
+
+    // Swap the main "Open" button icon to the default app's logo (asynchronous;
+    // falls back to the generic external-link icon). Guarded by tab id so a
+    // slow response never clobbers a newer tab.
+    let _openIconTabId = null;
+    function refreshOpenIcon() {
+      const tab = activeTab();
+      if (tab && tab.id === _openIconTabId) return;
+      _openIconTabId = tab ? tab.id : null;
+      openIconEl.innerHTML = ICON_EXTERNAL;
+      openMainBtn.title = t("workspace.openDefault");
+      if (!tab) return;
+      Workspace.fetchDefaultApp(tab.entry).then((app) => {
+        if (!app || _openIconTabId !== tab.id) return;
+        const img = document.createElement("img");
+        img.alt = "";
+        img.src = "/api/app-icon?path=" + encodeURIComponent(app.path);
+        img.addEventListener("error", () => {
+          if (_openIconTabId === tab.id) openIconEl.innerHTML = ICON_EXTERNAL;
+        });
+        openIconEl.replaceChildren(img);
+        openMainBtn.title = t("workspace.openWith", { app: app.name });
+      }).catch(() => { /* keep generic icon */ });
     }
 
     function activate(id) {
@@ -579,6 +757,7 @@ const WorkspaceView = (() => {
       } else {
         rebuildTabbar();
       }
+      if (tabs.length === 0) restoreAsideWidth();
       notify();
     }
 
@@ -600,12 +779,24 @@ const WorkspaceView = (() => {
       }
     }
 
-    function togglePreview(tab) {
-      tab.previewMode = !tab.previewMode;
-      tab.el.dataset.mode = tab.previewMode ? "preview" : "edit";
-      if (tab.previewMode && tab.editor) {
+    function applyMode(tab) {
+      tab.el.dataset.mode = tab.splitMode ? "split" : (tab.previewMode ? "preview" : "edit");
+      if ((tab.previewMode || tab.splitMode) && tab.editor) {
         tab.previewEl.innerHTML = CodeEditor.renderMarkdown(tab.editor.getContent());
       }
+    }
+
+    function togglePreview(tab) {
+      tab.previewMode = !tab.previewMode;
+      tab.splitMode = false;
+      applyMode(tab);
+      updateActions();
+    }
+
+    function toggleSplit(tab) {
+      tab.splitMode = !tab.splitMode;
+      tab.previewMode = false;
+      applyMode(tab);
       updateActions();
     }
 
@@ -627,6 +818,7 @@ const WorkspaceView = (() => {
         dirty: false,
         isMd,
         previewMode: false,
+        splitMode: false,
         previewEl: null,
         editor: null,
         imageUrl: null,
@@ -646,6 +838,9 @@ const WorkspaceView = (() => {
             tab.dirty = true;
             syncDirty(tab);
           }
+          if (tab.splitMode && tab.previewEl) {
+            tab.previewEl.innerHTML = CodeEditor.renderMarkdown(tab.editor.getContent());
+          }
         },
         onSave: () => doSave(tab),
       });
@@ -673,32 +868,118 @@ const WorkspaceView = (() => {
       };
     }
 
+    function buildPdfTab(entry, url) {
+      const pane = el("div", "wv-pane wv-pane--pdf");
+      const frame = document.createElement("iframe");
+      frame.title = entry.name;
+      frame.src = url;
+      pane.appendChild(frame);
+      return {
+        id: entry.path,
+        entry,
+        kind: "pdf",
+        el: pane,
+        dirty: false,
+        isMd: false,
+        previewMode: false,
+        previewEl: null,
+        editor: null,
+        imageUrl: null,
+      };
+    }
+
+    async function buildFallbackTab(entry) {
+      const pane = el("div", "wv-pane wv-pane--fallback");
+
+      const icon = el("div", "wv-fallback-icon");
+      icon.innerHTML = fileIconSvg(entry.name);
+
+      const name = el("div", "wv-fallback-name");
+      name.textContent = entry.name;
+
+      const hint = el("div", "wv-fallback-hint");
+      hint.textContent = t("workspace.fallbackHint");
+
+      const subhint = el("div", "wv-fallback-subhint");
+      subhint.textContent = t("workspace.fallbackSubHint");
+
+      pane.appendChild(icon);
+      pane.appendChild(name);
+      pane.appendChild(hint);
+      pane.appendChild(subhint);
+
+      return {
+        id: entry.path,
+        entry,
+        kind: "binary",
+        el: pane,
+        dirty: false,
+        isMd: false,
+        previewMode: false,
+        previewEl: null,
+        editor: null,
+        imageUrl: null,
+      };
+    }
+
+    function buildTableTab(entry, text) {
+      const pane = el("div", "wv-pane wv-pane--table");
+      const scroller = el("div", "wv-table-scroll");
+
+      const result = CodeEditor.renderTable(text, entry.name);
+      scroller.appendChild(result.table);
+      pane.appendChild(scroller);
+
+      if (result.truncated) {
+        const note = el("div", "wv-table-note");
+        note.textContent = t("workspace.tableTruncated").replace("%{rows}", result.rows);
+        pane.appendChild(note);
+      }
+
+      return {
+        id: entry.path,
+        entry,
+        kind: "table",
+        el: pane,
+        dirty: false,
+        isMd: false,
+        previewMode: false,
+        splitMode: false,
+        previewEl: null,
+        editor: null,
+        imageUrl: null,
+      };
+    }
+
     async function openTab(entry) {
-      ensureAsideWidth();
       const existing = tabs.find((x) => x.id === entry.path);
       if (existing) {
         activate(existing.id);
         return;
       }
       const kind = CodeEditor.fileKind(entry.name);
-      if (kind === "binary") {
-        Modal.toast(t("workspace.previewUnsupported"), "info");
-        return;
-      }
       let tab = null;
       try {
         if (kind === "image") {
           const blob = await Workspace.fetchFileBlob(entry);
           tab = buildImageTab(entry, URL.createObjectURL(blob));
+        } else if (kind === "pdf") {
+          tab = buildPdfTab(entry, "/api/local-image?path=" + encodeURIComponent(Workspace.absPath(entry.path)));
+        } else if (kind === "binary") {
+          tab = await buildFallbackTab(entry);
+        } else if (kind === "table") {
+          const text = await Workspace.fetchFileText(entry);
+          tab = CodeEditor.looksBinary(text) ? await buildFallbackTab(entry) : buildTableTab(entry, text);
         } else {
           const text = await Workspace.fetchFileText(entry);
-          tab = buildTextTab(entry, text);
+          tab = CodeEditor.looksBinary(text) ? await buildFallbackTab(entry) : buildTextTab(entry, text);
         }
       } catch (err) {
         console.error("preview failed:", err);
-        Modal.toast(t("workspace.previewFailed"), "error");
+        Modal.toast(t("workspace.previewFailed") + ": " + err.message, "error");
         return;
       }
+      if (tabs.length === 0) ensureAsideWidth();
       tabs.push(tab);
       content.appendChild(tab.el);
       activate(tab.id);
@@ -709,6 +990,10 @@ const WorkspaceView = (() => {
       const tab = activeTab();
       if (tab && tab.isMd) togglePreview(tab);
     });
+    splitBtn.addEventListener("click", () => {
+      const tab = activeTab();
+      if (tab && tab.isMd) toggleSplit(tab);
+    });
     copyBtn.addEventListener("click", async () => {
       const tab = activeTab();
       if (!tab || !tab.editor) return;
@@ -719,16 +1004,13 @@ const WorkspaceView = (() => {
         Modal.toast(t("workspace.copyFailed"), "error");
       }
     });
-    downloadBtn.addEventListener("click", () => {
-      const tab = activeTab();
-      if (tab) downloadFile(tab.entry);
-    });
     saveBtn.addEventListener("click", () => {
       const tab = activeTab();
       if (tab) doSave(tab);
     });
 
     function destroy() {
+      restoreAsideWidth();
       tabs.forEach((tab) => {
         if (tab.editor) tab.editor.destroy();
         if (tab.imageUrl) URL.revokeObjectURL(tab.imageUrl);
@@ -767,6 +1049,7 @@ const WorkspaceView = (() => {
     const onUp = () => {
       if (!dragging) return;
       dragging = false;
+      handle.classList.remove("active");
       document.body.style.cursor = "";
       document.body.style.userSelect = "";
       document.removeEventListener("mousemove", onMove);
@@ -780,6 +1063,7 @@ const WorkspaceView = (() => {
       dragging = true;
       startX = e.clientX;
       startW = treePane.getBoundingClientRect().width;
+      handle.classList.add("active");
       document.body.style.cursor = "col-resize";
       document.body.style.userSelect = "none";
       document.addEventListener("mousemove", onMove);
@@ -833,10 +1117,22 @@ const WorkspaceView = (() => {
     });
     tree.addEventListener("mouseleave", () => updateIndentGuides(null));
 
-    const viewer = createViewer(({ count, activeId }) => {
-      root.classList.toggle("has-open-files", count > 0);
-      setActiveFilePath(activeId);
-    });
+    const viewer = createViewer(
+      ({ count, activeId }) => {
+        root.classList.toggle("has-open-files", count > 0);
+        if (activeId) root.classList.remove("mobile-tree-visible");
+        if (!count) root.classList.remove("mobile-tree-visible");
+        setActiveFilePath(activeId);
+      },
+      () => {
+        const hidden = root.classList.toggle("tree-hidden");
+        return hidden;
+      },
+      () => {
+        root.classList.add("mobile-tree-visible");
+      }
+    );
+    _activeViewer = viewer;
 
     // ── File search ─────────────────────────────────────────────────────
 
@@ -970,21 +1266,77 @@ const WorkspaceView = (() => {
     container.appendChild(root);
 
     loadRoot(tree, viewer.openTab);
+
+    // The tree is otherwise loaded only once per mount. Reload it when the
+    // working directory changes (status-bar dir switch) and when the agent
+    // finishes a task (it may have created/edited files under the dir).
+    if (_activeOff) _activeOff();
+    const offSessionChanged = Workspace.on("workspace:sessionChanged", () => {
+      treeState.indexPromise = null;
+      loadRoot(tree, viewer.openTab);
+    });
+    const offTaskComplete = Workspace.on("workspace:taskCompleted", (payload) => {
+      if (payload && payload.sessionId === Workspace.state.sessionId) {
+        treeState.indexPromise = null;
+        loadRoot(tree, viewer.openTab);
+      }
+    });
+    const offAll = () => { offSessionChanged(); offTaskComplete(); };
+    _activeOff = offAll;
+
     return {
       destroy() {
+        if (_activeOff === offAll) {
+          offAll();
+          _activeOff = null;
+        }
         clearTimeout(searchTimer);
         treeState.treeEl = null;
         treeState.activePath = null;
         treeState.indexPromise = null;
         lastGuidedRow = null;
+        if (_activeViewer === viewer) _activeViewer = null;
         viewer.destroy();
       },
     };
   }
 
-  return { mount };
+  // Convert an absolute path (from a file:// link in chat) into a tree-style
+  // entry. Paths inside the working directory become relative so tab
+  // de-duplication matches tabs opened from the tree; paths outside stay
+  // absolute (the store treats absolute paths as-is).
+  function toEntry(absPath) {
+    const wd = (Workspace.state.workingDir || "").replace(/\/+$/, "");
+    const name = absPath.split("/").pop() || absPath;
+    if (wd && absPath.startsWith(wd + "/")) {
+      return { name, path: absPath.slice(wd.length + 1), type: "file", size: 0 };
+    }
+    return { name, path: absPath, type: "file", size: 0 };
+  }
+
+  // Open a file:// link target in the Files tab of the session aside.
+  // Returns true when the viewer handled it; false lets the caller fall back
+  // to the system open action. HTML files open in the preview panel instead
+  // (rendered as a page, not shown as source).
+  function openFile(absPath) {
+    if (!absPath || !Workspace.state.hasSession()) return false;
+    const entry = toEntry(absPath);
+    if (/\.html?$/i.test(entry.name) && window.Clacky && Clacky.Preview) {
+      return Clacky.Preview.open(entry.path);
+    }
+    if (window.Clacky && Clacky.Aside) Clacky.Aside.open();
+    const tabBtn = document.querySelector('.aside-tab[data-tab="files"]');
+    if (tabBtn) tabBtn.click();
+    if (!_activeViewer) return false;
+    _activeViewer.openTab(entry);
+    return true;
+  }
+
+  return { mount, openFile };
 })();
 
+if (window.Clacky) Clacky.WorkspaceView = WorkspaceView;
+
 // Files is a built-in tab: visible for every session, after ext-studio
 // publish (20) and before git (30) / time-machine (40).
 if (window.Clacky && Clacky.ext) {