@spzxg/cli-ui 0.6.5 → 0.6.7

package/src/operator/node/SessionRail.tsx

@@ -1,6 +1,9 @@
 "use client";
+import { subscribeWorkspaceFiles } from "../../board/fileWatch";
+import { retainFileScope } from "../../board/fileScope";
 
 import { useContext, useEffect, useLayoutEffect, useMemo, useRef, useState } from "react";
+import { createPortal } from "react-dom";
 import { Icon } from "./icons";
 import TaskChanges, { type ResolveResult } from "./TaskChanges";
 import { BrowserPane } from "./BrowserPane";
@@ -13,17 +16,18 @@ import { clientId } from "../../core/id";
 import { useBoardState, readBoardState, visitBoardFile, reportBoardState, releaseBoardState, activateBoardState } from "./boardState";
 import type { BoardView } from "../../board/workspace";
 import { useBoardPanels } from "../../board/panels";
-import { PanelControls, PanelTab } from "../../board/PanelControls";
+import { PanelControls, PanelTab, type InlineBoardLayout } from "../../board/PanelControls";
 import { FilesPane } from "../../board/FilesPane";
 import { FileViewer } from "../../board/FileViewer";
+import { useBoardUpload } from "../../board/useBoardUpload";
 import { getOperatorBoardBackend } from "./boardBackend";
 import { useOperatorContextEvents, useOperatorFileWatch } from "./boardEvents";
 import { OperatorBoardContext, registerOperatorBoard, OperatorBoardQuoteContext } from "./boardInteraction";
 import type { Quote } from "./composerDraft";
 import type { OperatorBoardOptions, OperatorBoardRequest } from "./boardInteraction";
-type OpenFile = { reloadKey?:number; taskId: string; path: string; version: number; mtime?: number; size?: number };
+type OpenFile = { name?: string; reloadKey?:number; taskId: string; path: string; version: number; mtime?: number; size?: number };
 const fileKey = (file: Pick<OpenFile,"taskId"|"path">) => `file:${file.taskId}:${file.path}`;
-const LABEL:Record<string,string>={files:"文件",changes:"改动",context:"上下文",preview:"预览",browser:"浏览器"};
+const LABEL:Record<string,string>={files:"工作区",changes:"改动",context:"上下文",preview:"预览",browser:"浏览器"};
 type Session = { n: number; summaryBefore: string | null };
 
 // The live URL a project's dev server is reachable at when no registered
@@ -119,15 +123,21 @@ function ContextPane({ task, sessions, running, onClear }: { task: TaskRow; sess
 }
 
 export function SessionRail({ project, task, sessions, running, onResolveWithAI, onMerged, onPrCreated, onClear, onCollapse, onSwitchToChat,
-  tabs, availableTabs, defaultTab, autoContext, watchFiles = true, fileWatchIntervalMs, onFilesChange, onFilesWatch, onBoardContextChange, onEvent, openRequest, onRequestHandled, activity, onQuote }: OperatorBoardOptions & {
+  tabs, availableTabs, defaultTab, autoContext, watchFiles = true, fileWatchIntervalMs, onFilesChange, onFilesWatch, onBoardContextChange, onEvent, openRequest, onRequestHandled, onQuote, inlineLayout, onExpand, visible = true }: OperatorBoardOptions & {
   project: ProjectRow; task: TaskRow; sessions: Session[]; running: boolean;
   onResolveWithAI: (taskId: string) => Promise<ResolveResult>; onMerged?: () => void;
   onPrCreated?: (url: string) => void; onClear: () => void; onCollapse: () => void; onSwitchToChat: () => void;
   openRequest?: OperatorBoardRequest | null; onRequestHandled?: (sequence:number)=>void; activity?: string; onQuote?: (quote:Quote)=>void;
+  inlineLayout?: InlineBoardLayout;
+  onExpand?: () => void;
+  visible?: boolean;
 }) {
   const contextQuote=useContext(OperatorBoardQuoteContext);
   const parentBoard=useContext(OperatorBoardContext);
-  const quote=onQuote??contextQuote;
+  const inlineRef=useRef(inlineLayout);inlineRef.current=inlineLayout;
+  const sendQuote=onQuote??contextQuote;
+  const quote=sendQuote ? (value:Quote)=>{sendQuote(value);inlineLayout?.onChat();} : undefined;
+  const contentVisible=visible&&(!inlineLayout||inlineLayout.active);
   const features=clientFeatures();
   const available=(availableTabs ?? ['files','changes','context','browser','preview']).filter(id=>id in LABEL).filter(id=>id!=='browser'||features.browser).filter(id=>id!=='preview'||features.livePreview);
   const defaults=tabs ?? ['files',...(features.browser?['browser']:[])];
@@ -167,13 +177,37 @@ export function SessionRail({ project, task, sessions, running, onResolveWithAI,
   const fileTabs=available.includes('files')?files.map(fileKey):[];
   const shown=[...panels.open,...fileTabs];
   const active=shown.includes(tab)?tab:shown[0]??'';
+  const [toolbarHost, setToolbarHost] = useState<HTMLSpanElement | null>(null);
   const tabsRef=useRef<HTMLDivElement>(null);
   useLayoutEffect(()=>{
     const reveal=()=>{const box=tabsRef.current,item=box?.querySelector<HTMLElement>('.rail-tab.on');if(!box||!item)return;
       const outer=box.getBoundingClientRect(),inner=item.getBoundingClientRect();if(inner.left<outer.left)box.scrollLeft+=inner.left-outer.left;else if(inner.right>outer.right)box.scrollLeft+=inner.right-outer.right;};
     reveal();if(typeof ResizeObserver==='undefined')return;const observer=new ResizeObserver(reveal);if(tabsRef.current)observer.observe(tabsRef.current);return()=>observer.disconnect();
-  },[active,shown.length]);
+  },[active,shown.length,inlineLayout?.active,inlineLayout?.tabsHost]);
   const file=files.find(f=>fileKey(f)===active);
+  // Every opened tab participates, including a file from a source task. Only
+  // already-read preview ranges are synchronized; closed files are not prefetched.
+  const openedScope = JSON.stringify(available.includes('files') ? files.map(({ taskId, path }) => ({ taskId, path })) : []);
+  const directorySource = active === 'files' ? folderTask : task.id;
+  useEffect(() => {
+    if (!watchFiles || !contentVisible) return;
+    const grouped = new Map<string, string[]>();
+    for (const file of JSON.parse(openedScope) as Array<{ taskId: string; path: string }>) {
+      grouped.set(file.taskId, [...(grouped.get(file.taskId) ?? []), file.path]);
+    }
+    if (!grouped.has(directorySource)) grouped.set(directorySource, []);
+    const stops: Array<() => void> = [];
+    for (const [source, paths] of grouped) {
+      stops.push(retainFileScope(backend, source, { paths, dirs: [] }));
+      if (source !== task.id) stops.push(subscribeWorkspaceFiles(backend, source, event => {
+        setTick(value => value + 1);
+        const changed = new Set(event.changes.map(change => change.path));
+        setFiles(previous => previous.map(file => file.taskId === source && changed.has(file.path)
+          ? { ...file, version: file.version + 1, reloadKey: (file.reloadKey ?? 0) + 1 } : file));
+      }));
+    }
+    return () => stops.forEach(stop => stop());
+  }, [backend, task.id, watchFiles, contentVisible, openedScope, directorySource]);
   const current=useRef(active);current.current=active;
   const openFile=(taskId:string,path:string)=>{
     if(!available.includes('files'))return;
@@ -187,14 +221,17 @@ export function SessionRail({ project, task, sessions, running, onResolveWithAI,
       const next=[...previous,{taskId,path:clean,version:0}];
       if(next.length>8){const index=next.findIndex(f=>fileKey(f)!==current.current&&fileKey(f)!==id);next.splice(index<0?0:index,1);}
       return next;
-    });setTab(id);
+    });setTab(id);inlineRef.current?.onActivate();
   };
+  const canUpload=available.includes('files')&&!!(task.started||task.worktree_path);
+  const uploader=useMemo(()=>canUpload&&backend.uploadFile ? (file:File,options:Parameters<NonNullable<typeof backend.uploadFile>>[2])=>backend.uploadFile!(task.id,file,options) : undefined,[backend,task.id,canUpload]);
+  const upload=useBoardUpload(task.id,uploader,receipt=>{if(receipt.path)openFile(task.id,receipt.path);});
   useEffect(()=>{
     if(parentBoard)return;
     return registerOperatorBoard(target=>{
       if(target.taskId!==task.id)return false;
       if(target.kind==='file'){if(!available.includes('files'))return false;openFile(target.taskId,target.path);return true;}
-      if(!panels.show('browser'))return false;setTab('browser');return true;
+      if(!panels.show('browser'))return false;setTab('browser');inlineRef.current?.onActivate();return true;
     });
   },[task.id,parentBoard,available.join(','),panels.show]);
   const seen=useRef<number|null>(null);
@@ -203,58 +240,60 @@ export function SessionRail({ project, task, sessions, running, onResolveWithAI,
     seen.current=openRequest.sequence;
     const target=openRequest.target;
     if(target.kind==='file')openFile(target.taskId,target.path);
-    else if(target.taskId===task.id&&panels.show('browser'))setTab('browser');
+    else if(target.taskId===task.id&&panels.show('browser')){setTab('browser');inlineLayout?.onActivate();}
     onRequestHandled?.(openRequest.sequence);
   },[openRequest,restored]); // Requests originate in the owning session, including when this panel was collapsed.
-  const lastRefresh=useRef(0);
-  useEffect(()=>{const timer=setTimeout(()=>{lastRefresh.current=Date.now();setTick(n=>n+1);},Math.max(0,700-(Date.now()-lastRefresh.current)));return()=>clearTimeout(timer);},[activity,task.updated_at,running]);
-  useEffect(()=>{if(!running)return;const timer=setInterval(()=>{if(document.visibilityState==='visible')setTick(n=>n+1);},15000);return()=>clearInterval(timer);},[running]);
   useEffect(()=>{
     if(!file)return;let alive=true;
     void backend.stat(file.taskId,file.path).then(stat=>{
       if(!alive||stat.type!=='file')return;
-      setFiles(previous=>previous.map(f=>fileKey(f)===fileKey(file)&&f.mtime!==stat.mtime?{...f,mtime:stat.mtime,size:stat.size,version:f.mtime===undefined?f.version:f.version+1}:f));
+      setFiles(previous=>previous.map(f=>fileKey(f)===fileKey(file)&&(f.mtime!==stat.mtime||f.name!==stat.name)?{...f,name:stat.name,mtime:stat.mtime,size:stat.size,version:f.mtime===undefined?f.version:f.version+1}:f));
     },()=>{if(alive)setFiles(previous=>previous.map(f=>fileKey(f)===fileKey(file)&&f.mtime!==-1?{...f,mtime:-1,version:f.version+1}:f));});
     return()=>{alive=false;};
   },[backend,active,tick]);
   const boardView:BoardView={tab:active,dir,file:file?.path??null,files:files.map(file=>file.path),
     current:file?{path:file.path,sourceId:file.taskId}:null,opened:files.map(file=>({path:file.path,sourceId:file.taskId})),
-    history:boardState?.history??[],browser:active==='browser'?browserPage:null,visible:true,autoContext:autoContext!==false};
+    history:boardState?.history??[],browser:active==='browser'?browserPage:null,visible:contentVisible,autoContext:autoContext!==false};
   const viewSignature=JSON.stringify(boardView);
-  useEffect(()=>{if(restored)reportBoardState(task.id,owner,boardView);},[task.id,owner,restored,viewSignature]); // Metadata changes only; file refresh counters do not claim a new view.
+  useEffect(()=>{if(restored)reportBoardState(task.id,owner,boardView,directorySource);},[task.id,owner,restored,viewSignature,directorySource]); // Metadata changes only; file refresh counters do not claim a new view.
   useEffect(()=>()=>releaseBoardState(task.id,owner),[task.id,owner]);
-  const label=(id:string)=>LABEL[id]??files.find(f=>fileKey(f)===id)?.path.split('/').pop()??id;
+  const label=(id:string)=>LABEL[id]??files.find(f=>fileKey(f)===id)?.name??files.find(f=>fileKey(f)===id)?.path.split('/').pop()??id;
   const close=(id:string)=>{
     if(id.startsWith('file:'))setFiles(previous=>previous.filter(f=>fileKey(f)!==id));else panels.close(id);
-    if(active===id)setTab(shown.find(item=>item!==id)??'');
+    if(active===id){const next=shown.find(item=>item!==id)??'';setTab(next);if(!next)inlineLayout?.onChat();}
   };
-  return <aside className="sess-rail" aria-label="任务看板" onPointerDown={()=>activateBoardState(task.id,owner)} onClickCapture={()=>activateBoardState(task.id,owner)} onFocusCapture={()=>activateBoardState(task.id,owner)}>
-    <div className="rail-tabs">
-      <div className="operator-file-tabs" ref={tabsRef} role="tablist" aria-label="看板模块">
-        {shown.map(id=><PanelTab key={id} id={id} label={label(id)} active={active===id} onSelect={()=>{const opened=files.find(file=>fileKey(file)===id);if(opened)visitBoardFile(task.id,{path:opened.path,sourceId:opened.taskId});setTab(id);}} onClose={()=>close(id)}/>)}
+  const railTabs=<div className="rail-tabs">
+      <div className="operator-file-tabs" ref={tabsRef} role={inlineLayout?undefined:"tablist"} aria-label={inlineLayout?undefined:"看板模块"}>
+        {shown.map(id=><PanelTab key={id} id={id} label={label(id)} title={files.find(file=>fileKey(file)===id)?.path} active={active===id&&(!inlineLayout||inlineLayout.active)} onSelect={()=>{const opened=files.find(file=>fileKey(file)===id);if(opened)visitBoardFile(task.id,{path:opened.path,sourceId:opened.taskId});setTab(id);inlineLayout?.onActivate();}} onClose={()=>close(id)}/>)}
       </div>
-      <PanelControls available={available} open={panels.open} label={label} onShow={id=>{panels.show(id);setTab(id);}} onClose={close}/>
-      <button className="rail-collapse" title="刷新看板" aria-label="刷新看板" onClick={()=>setTick(n=>n+1)}>{Icon.restore()}</button>
-      <button className="rail-collapse" onClick={onCollapse} title="隐藏面板" aria-label="隐藏看板">{Icon.chevRight()}</button>
-    </div>
+      <PanelControls toolbarRef={setToolbarHost} available={available} open={panels.open} label={label} onShow={id=>{panels.show(id);setTab(id);inlineLayout?.onActivate();}} onClose={close}
+        upload={available.includes('files')?{onChoose:upload.choose,disabled:upload.busy||!uploader,hint:canUpload?undefined:'启动会话并创建工作区后可上传文件'}:undefined}/>
+      {inlineLayout ? onExpand&&<button className="rail-collapse" onClick={onExpand} title="展开右侧看板" aria-label="展开看板">{Icon.chevRight()}</button> : <button className="rail-collapse" onClick={onCollapse} title="隐藏面板" aria-label="隐藏看板">{Icon.chevRight()}</button>}
+    </div>;
+  return <aside className={`sess-rail${inlineLayout?' sess-rail-inline':''}`} aria-label="任务看板" hidden={!contentVisible} style={!contentVisible?{display:'none'}:undefined} onPointerDown={()=>activateBoardState(task.id,owner)} onClickCapture={()=>activateBoardState(task.id,owner)} onFocusCapture={()=>activateBoardState(task.id,owner)}>
+    {inlineLayout ? inlineLayout.tabsHost&&createPortal(railTabs,inlineLayout.tabsHost) : railTabs}
+    {upload.input}{upload.progress}
     <div className="rail-scroll">
       {!active&&<div className="cli-board-empty">看板模块已全部关闭。通过右上角“管理看板模块”重新打开。</div>}
       {active==='changes'&&<>
         {task.fork_commit&&<div className="fork-merge-note">基于「{task.fork_source_title}」派生。合并到 {project.branch} 时，也会包含来源分支尚未合并的改动。</div>}
         <TaskChanges taskId={task.id} running={running} prUrl={task.pr_url} onMerged={onMerged} onPrCreated={onPrCreated} onResolveWithAI={async id=>{const result=await onResolveWithAI(id);if(result.ok&&!result.merged)onSwitchToChat();return result;}}/>
       </>}
-      {active==='files'&&<FilesPane backend={backend} jobId={folderTask} dir={dir} onDir={setDir} onOpen={entry=>openFile(folderTask,entry.path)} refreshKey={tick}/>}
-      {file&&<>
+      {contentVisible&&active==='files'&&<>
+        {folderTask!==task.id&&<div className="fork-merge-note cli-source-workspace"><span>正在浏览来源任务的工作区。</span><button className="btn btn-ghost btn-sm" onClick={()=>{setFolderTask(task.id);setDir('');}}>返回当前工作区</button></div>}
+        <FilesPane toolbarHost={toolbarHost} backend={backend} jobId={folderTask} dir={dir} onDir={setDir} onOpen={entry=>openFile(folderTask,entry.path)} refreshKey={tick}/>
+      </>}
+      {contentVisible&&file&&<>
         {file.taskId!==task.id&&<div className="fork-merge-note">正在查看来源任务的文件，不会切换当前执行分支。</div>}
-        <FileViewer key={fileKey(file)} backend={backend} jobId={file.taskId} path={file.path} size={file.size} mtime={file.mtime} version={file.version} reloadKey={file.reloadKey}
+        <FileViewer toolbarHost={toolbarHost} key={fileKey(file)} backend={backend} jobId={file.taskId} path={file.path} displayName={file.name} size={file.size} mtime={file.mtime} version={file.version} reloadKey={file.reloadKey}
           onOpenPath={path=>openFile(file.taskId,path)}
-          actions={quote?[{label:'引用到对话',onClick:()=>quote({id:`file:${file.taskId}:${file.path}`,author:`文件 ${file.path}`,text:`${file.taskId===task.id?'当前工作区':`来源任务 ${file.taskId} 的工作区`}文件 ${file.path}`})}]:[]}
-          onQuoteText={quote?text=>quote({id:`selection:${file.taskId}:${file.path}`,author:`${file.taskId===task.id?"当前工作区":`来源任务 ${file.taskId} 的工作区`}文件 ${file.path}`,text}):undefined}
-          lead={<button className="cli-fv-back" title="返回文件列表" onClick={()=>{setFolderTask(file.taskId);setDir(file.path.includes('/')?file.path.slice(0,file.path.lastIndexOf('/')):'');panels.show('files');setTab('files');}}>‹</button>}/>
+          actions={quote?[{label:'引用到对话',onClick:()=>quote({id:`file:${file.taskId}:${file.path}`,sourceTaskId:file.taskId,author:`文件 ${file.path}`,text:`${file.taskId===task.id?'当前工作区':`来源任务 ${file.taskId} 的工作区`}文件 ${file.path}`})}]:[]}
+          onQuoteText={quote?(text, context)=>quote({id:`selection:${file.taskId}:${file.path}`,sourceTaskId:file.taskId,author:`${file.taskId===task.id?"当前工作区":`来源任务 ${file.taskId} 的工作区`}文件 ${file.path}`,text:context?`文件修订：${context.revision}\n${text}`:text}):undefined}
+          onBack={()=>{setFolderTask(file.taskId);setDir(file.path.includes('/')?file.path.slice(0,file.path.lastIndexOf('/')):'');panels.show('files');setTab('files');}}/>
       </>}
       {active==='preview'&&features.livePreview&&<PreviewPane project={project}/>}
       {active==='context'&&<ContextPane task={task} sessions={sessions} running={running} onClear={onClear}/>}
-      {active==='browser'&&features.browser&&<BrowserPane key={task.id} taskId={task.id} onPage={setBrowserPage} onQuote={quote?page=>quote({id:`browser:${task.id}`,author:"浏览器页面",text:`${page.title?`${page.title} — `:""}${page.url}`}):undefined} onQuoteText={quote?(text,page)=>quote({id:`browser-selection:${task.id}`,author:`网页 ${page.title||page.url}`,text}):undefined}/>}
+      {active==='browser'&&features.browser&&contentVisible&&<BrowserPane key={task.id} taskId={task.id} onPage={setBrowserPage} onQuote={quote?page=>quote({id:`browser:${task.id}`,sourceTaskId:task.id,author:"浏览器页面",text:`${page.title?`${page.title} — `:""}${page.url}`}):undefined} onQuoteText={quote?(text,page)=>quote({id:`browser-selection:${task.id}`,sourceTaskId:task.id,author:`网页 ${page.title||page.url}`,text}):undefined}/>}
     </div>
   </aside>;
 }

package/src/operator/node/SessionView.tsx

@@ -5,7 +5,6 @@ import type { Status, Priority, AskQuestion, AskAnswers } from "./protocol/types
 import { OperatorBoardContext, OperatorBoardQuoteContext, type OperatorBoardOptions, type OperatorBoardRequest, type OperatorBoardTarget } from "./boardInteraction";
 import { readDraft, writeDraft, type Quote } from "./composerDraft";
 import { clientFeatures } from "./protocol/features";
-import { toolDataOf } from "./transcriptModel";
 import { Icon } from "./icons";
 import { type ResolveResult } from "./TaskChanges";
 import { fmtTokens, fmtCost, fmtJobCost, isAwaiting, buildSessions, usageSplit, costDisplay } from "./format";
@@ -27,7 +26,9 @@ import { registerOperatorBoard } from "./boardInteraction";
 import { useConfigurationBusy } from "../../chat/configuration";
 import type { SessionRail as NodeSessionRail } from "./SessionRail";
 const SessionRail=(props:ComponentProps<typeof NodeSessionRail>)=><CliBoard operator={props}/>;
-import { ColResize, ColRail } from "./Layout";
+import { ColResize } from "./Layout";
+import { WorkspaceTabs } from "../../ui/WorkspaceTabs";
+import { WorkspaceDrawer, useWorkspaceDrawer } from "../../ui/WorkspaceDrawer";
 import { jget, downloadExport } from "./api";
 
 // Non-blocking banner shown when a reopened task's worktree is behind its base
@@ -134,21 +135,24 @@ function SessionViewInner({ project, task, tasks, onSelectTask, onFork, agents,
     return () => observer.disconnect();
   }, [railW]);
   const singlePane = mobile || compact;
+  const drawerMode = useWorkspaceDrawer(sessionRef, !!mobile);
+  const tabMode = !drawerMode && (singlePane || railCollapsed);
+  const [tabsHost, setTabsHost] = useState<HTMLDivElement|null>(null);
   const [statusOpen, setStatusOpen] = useState(false);
   const [moreOpen, setMoreOpen] = useState(false);
   const [view, setView] = useState<"chat" | "changes">("chat");
   const [boardRequest,setBoardRequest]=useState<OperatorBoardRequest|null>(null);
   const boardSequence=useRef(0);
   const acknowledgeBoardRequest=useCallback((sequence:number)=>setBoardRequest(previous=>previous?.sequence===sequence?null:previous),[]);
-  const routing=useRef({singlePane,railCollapsed,onRailExpand,task,tasks,board});
-  routing.current={singlePane,railCollapsed,onRailExpand,task,tasks,board};
+  const routing=useRef({tabMode,drawerMode,task,tasks,board});
+  routing.current={tabMode,drawerMode,task,tasks,board};
   const openBoard=useCallback((target:OperatorBoardTarget)=>{
     const context=routing.current;
     if(target.kind==='browser'&&(target.taskId!==context.task.id||!clientFeatures().browser))return false;
     if(target.kind==='file'&&(!target.path||![context.task,...context.tasks].some(t=>t.id===target.taskId&&t.project_id===context.task.project_id)))return false;
     if(context.board?.availableTabs&&!context.board.availableTabs.includes(target.kind==='file'?'files':'browser'))return false;
     setBoardRequest({sequence:++boardSequence.current,target});
-    if(context.singlePane)setView('changes');else if(context.railCollapsed)context.onRailExpand();
+    if(context.tabMode||context.drawerMode)setView('changes');
     return true;
   },[]);
   useEffect(()=>registerOperatorBoard(target=>target.taskId===task.id?openBoard(target):false),[task.id,openBoard]);
@@ -159,10 +163,9 @@ function SessionViewInner({ project, task, tasks, onSelectTask, onFork, agents,
   const quoteFromBoard=useCallback((quote:Quote)=>{
     const context=routing.current;
     writeDraft(context.task.id,{...readDraft(context.task.id),quote});
-    if(context.singlePane)setView('chat');
+    if(context.tabMode||context.drawerMode)setView('chat');
     requestAnimationFrame(()=>sessionRef.current?.querySelector<HTMLTextAreaElement>('.composer textarea')?.focus({preventScroll:true}));
   },[]);
-  const activity=useMemo(()=>{const tool=[...messages].reverse().find(m=>m.role==='tool');return `${messages.length}:${tool?.id??''}:${tool?toolDataOf(tool).result!==undefined:false}`;},[messages]);
   const [clearEstimate, setClearEstimate] = useState<InternalUsageEstimate | null>(null);
   const sessions = useMemo(() => buildSessions(messages), [messages]);
   const hasSession = task.started === 1 || messages.length > 0 || !!task.parent_task_id;
@@ -193,7 +196,7 @@ function SessionViewInner({ project, task, tasks, onSelectTask, onFork, agents,
       <div className={`session${singlePane ? " compact-session" : ""}`} ref={sessionRef}>
         <div className="sess-head">
           {onBack && <button className="mobile-back" onClick={onBack} title="返回任务列表" aria-label="返回任务列表">{Icon.chevRight({ style: { transform: "rotate(180deg)" } })}</button>}
-          <div className="sh-main">
+          {hasSession&&tabMode ? <WorkspaceTabs title={task.title} subtitle={project.name} chatActive={view==='chat'} onChat={()=>setView('chat')} onTabsHost={setTabsHost}/> : <div className="sh-main">
             <div className="crumb">
               <span className="pic" style={{ width: 16, height: 16, borderRadius: 5, background: project.color, display: "grid", placeItems: "center", color: "#fff", fontSize: 9, fontWeight: 700 }}>{project.name[0]}</span>
               <span className="session-project-name" title={project.name}>{project.name}</span>
@@ -203,8 +206,9 @@ function SessionViewInner({ project, task, tasks, onSelectTask, onFork, agents,
               <span className="sht-text" title={task.title}>{task.title}</span>
               <button className="icon-btn sh-edit" title="查看并编辑任务详情" aria-label="查看并编辑任务详情" onClick={onEdit}>{Icon.edit()}</button>
             </div>
-          </div>
+          </div>}
           <div className="sh-tools">
+            {hasSession&&drawerMode&&<button className="icon-btn workspace-open" title="打开工作区" aria-label="打开工作区" aria-haspopup="dialog" aria-expanded={view==='changes'} onClick={()=>setView('changes')}>{Icon.folder()}</button>}
             <div style={{ position: "relative" }}>
               <button className={`status-ctl ${awaiting ? "awaiting" : ""}`} onClick={(e) => { e.stopPropagation(); setStatusOpen((o) => !o); setMoreOpen(false); }}>
                 <StatusDot status={task.status} running={running} awaiting={awaiting} />
@@ -227,6 +231,7 @@ function SessionViewInner({ project, task, tasks, onSelectTask, onFork, agents,
               <button className="icon-btn session-more" aria-label="更多任务操作" aria-expanded={moreOpen} onClick={(e) => { e.stopPropagation(); setMoreOpen(!moreOpen); setStatusOpen(false); }}>{Icon.dots()}</button>
               {moreOpen && <Popover onClose={() => setMoreOpen(false)}>
                 <div className="pop-sec">{agentLabel(agents, task.agent)} · {fmtTokens(usage.fresh)} tokens{cost.show && task.cost_usd > 0 ? ` · ${cost.approx ? "~" : ""}${fmtCost(task.cost_usd)}` : ""}</div>
+                <div className="pop-note session-origin" title={task.work_branch || ""}>{Icon.git()}<span>{task.parent_task_id ? `来自 ${task.fork_source_title || "来源任务"}` : "独立任务分支"}</span></div>
                 <button className="pop-item" onClick={() => { setMoreOpen(false); onEdit(); }}>{Icon.edit()} 编辑任务详情</button>
                 <button className="pop-item" onClick={() => { setMoreOpen(false); downloadExport(`/api/tasks/${task.id}/export`); }}>{Icon.download()} 导出执行过程</button>
                 {task.pr_url && <a className="pop-item" href={task.pr_url} target="_blank" rel="noreferrer">{Icon.github()} 打开 PR{prNum ? ` #${prNum}` : ""}</a>}
@@ -239,14 +244,6 @@ function SessionViewInner({ project, task, tasks, onSelectTask, onFork, agents,
           </div>
         </div>
 
-        {hasSession && <div className="session-viewbar">
-          {singlePane ? <div className="viewseg">
-            <button className={`viewseg-btn ${view === "chat" ? "on" : ""}`} onClick={() => setView("chat")}>对话</button>
-            <button className={`viewseg-btn ${view === "changes" ? "on" : ""}`} onClick={() => setView("changes")}>看板</button>
-          </div> : <span className="session-agent-label">{agentLabel(agents, task.agent)}</span>}
-          <span className="session-branch" title={task.work_branch || ""}>{Icon.git()} {task.parent_task_id ? `来自 ${task.fork_source_title}` : "独立任务分支"}</span>
-        </div>}
-
         {hasSession && (
           <SyncBanner taskId={task.id} running={running} pinned={!!task.fork_commit} onResolveWithAI={onResolveWithAI} onSwitchToChat={() => setView("chat")} />
         )}
@@ -267,19 +264,22 @@ function SessionViewInner({ project, task, tasks, onSelectTask, onFork, agents,
           // Keep the chat at the same React position across all widths. Moving
           // it between different parents remounted the composer during resize
           // and could drop a keystroke, an upload, or an in-flight setting save.
-          <div className={singlePane ? "sess-responsive" : "sess-split"} style={singlePane ? undefined : { gridTemplateColumns: railCollapsed ? "minmax(0,1fr) 30px" : `minmax(0,1fr) 0px ${railW}px` }}>
-            <div className={`sess-main${singlePane ? " compact-chat" : ""}`} hidden={singlePane && view !== "chat"}><Chat project={project} task={task} tasks={tasks} agents={agents} messages={messages}
+          <div className={tabMode||drawerMode ? "sess-responsive" : "sess-split"} style={tabMode||drawerMode ? undefined : { gridTemplateColumns: `minmax(0,1fr) 0px ${railW}px` }}>
+            <div className={`sess-main${tabMode||drawerMode ? " compact-chat" : ""}`} data-chat-layout={tabMode||drawerMode?"centered":"wide"} hidden={tabMode && view !== "chat"}><Chat project={project} task={task} tasks={tasks} agents={agents} messages={messages}
               running={running} blockedBy={blockedBy} transcriptLoading={transcriptLoading} older={older} onLoadOlder={onLoadOlder}
-              controls={controls} configBusy={configBusy} active={!singlePane || view === "chat"}
+              controls={controls} configBusy={configBusy} active={!tabMode&&!drawerMode || view === "chat"}
               onSelectTask={onSelectTask} onFork={onFork} onSend={onSend} onStop={onStop}
               onStart={onStart} onEdit={onEdit} onClear={onClear} onSetSendContext={onSetSendContext}
               onReconnect={onReconnect} onAnswer={onAnswer} onCancelQueued={onCancelQueued} /></div>
-            {!singlePane && !railCollapsed && <ColResize side="right" min={RAIL_W.min} max={RAIL_W.max} onWidth={onRailWidth} onReset={onRailReset} />}
-            {!singlePane && railCollapsed ? <ColRail label="看板" right onExpand={onRailExpand} /> : (!singlePane || view === "changes") && (
-              <SessionRail {...board} openRequest={boardRequest} onRequestHandled={acknowledgeBoardRequest} activity={activity} project={project} task={task} sessions={sessions} running={running}
+            {!tabMode&&!drawerMode && <ColResize side="right" min={RAIL_W.min} max={RAIL_W.max} onWidth={onRailWidth} onReset={onRailReset} />}
+            <WorkspaceDrawer enabled={drawerMode} open={view==='changes'} onClose={()=>setView('chat')}>
+              <SessionRail {...board} openRequest={boardRequest} onRequestHandled={acknowledgeBoardRequest} project={project} task={task} sessions={sessions} running={running}
                 onResolveWithAI={onResolveWithAI} onMerged={onMerged} onPrCreated={onPrCreated} onClear={onClear}
-                onCollapse={singlePane ? () => setView("chat") : onRailCollapse} onSwitchToChat={() => setView("chat")} />
-            )}
+                inlineLayout={tabMode?{tabsHost,active:view==='changes',onActivate:()=>setView('changes'),onChat:()=>setView('chat')}:undefined}
+                visible={!drawerMode||view==='changes'}
+                onExpand={tabMode&&!singlePane?onRailExpand:undefined}
+                onCollapse={tabMode||drawerMode ? () => setView("chat") : onRailCollapse} onSwitchToChat={() => setView("chat")} />
+            </WorkspaceDrawer>
           </div>
         )}
       </div>

package/src/operator/node/Transcript.tsx

@@ -3,7 +3,7 @@ import { useContext } from "react";
 import { OperatorBoardContext } from "./boardInteraction";
 import { FileLinkContext } from "./fileLinks";
 
-import { memo, useState } from "react";
+import { memo, useId, useState } from "react";
 import type { ToolData, ToolPeek, AskQuestion, AskAnswers, InputRequest } from "./protocol/types";
 import { Icon } from "./icons";
 import { Markdown } from "./Markdown";
@@ -18,6 +18,8 @@ import type { Msg } from "./types";
 import { clientFeatures } from "./protocol/features";
 import { Avatar } from "./shared";
 import { toolDataOf } from "./transcriptModel";
+import { ReferenceCard } from "../../ui/ReferenceCard";
+import { splitQuotedMessage } from "../../ui/reference";
 
 // The always-visible "peek" tier — Claude Code's `⎿` line. Counts show no
 // content; diffs/snippets show a capped hunk with a clickable "+N more" that
@@ -64,21 +66,22 @@ function PeekView({ peek, expandable, onExpand }: { peek: ToolPeek; expandable:
 }
 
 function ToolView({ data }: { data: ToolData }) {
-  const [open, setOpen] = useState(false);
+  const [open, setOpen] = useState<boolean | null>(null);
+  const bodyId = useId();
   const hasDiff = !!data.diff?.length;
   const expandable = !!(data.detail || hasDiff || data.result !== undefined);
   // Failures surface their output automatically, like Claude Code.
-  const showBody = open || (!!data.isError && data.result !== undefined);
+  const showBody = open ?? (!!data.isError && data.result !== undefined);
   return (
     <div className="tool">
-      <button className="tool-h" style={{ cursor: expandable ? "pointer" : "default" }} onClick={() => expandable && setOpen((o) => !o)}>
+      <button className="tool-h" title={data.title} aria-expanded={expandable ? showBody : undefined} aria-controls={expandable ? bodyId : undefined} style={{ cursor: expandable ? "pointer" : "default" }} onClick={() => expandable && setOpen(!showBody)}>
         {expandable && <span className={`tchev ${showBody ? "open" : ""}`}>{Icon.chevRight()}</span>}
         <span className="tg">{data.title}</span>
         {data.result !== undefined && <span className={data.isError ? "tx" : "tcheck"}>{data.isError ? Icon.x() : Icon.check()}</span>}
       </button>
       {data.peek && !showBody && <PeekView peek={data.peek} expandable={expandable} onExpand={() => setOpen(true)} />}
       {showBody && (
-        <div className="tool-body">
+        <div className="tool-body" id={bodyId}>
           {data.detail && <pre className="tool-pre">{data.detail}</pre>}
           {hasDiff && (
             <pre className="tool-pre diff">{data.diff!.map((l, i) => <div className={`dl ${diffCls(l.sign)}`} key={i}>{l.sign} {l.text}</div>)}</pre>
@@ -193,8 +196,13 @@ function InputView({ input, agentLabel, onSubmit, onShowBrowser }: { onShowBrows
     if (!complete || busy || !onSubmit) return;
     setBusy(true);
     setErr(null);
-    const e = await onSubmit(input.id, vals.map((v) => v.trim()));
-    if (e) { setErr(e); setBusy(false); }
+    try {
+      const e = await onSubmit(input.id, vals.map((v, i) => input.fields[i].secret ? v : v.trim()));
+      if (e) { setErr(e); setBusy(false); }
+    } catch (error) {
+      setErr(error instanceof Error ? error.message : "提交失败，请重试");
+      setBusy(false);
+    }
   };
   return (
     <div className="ask">
@@ -275,6 +283,7 @@ function HandoffLine({ text, onBrowser, onShowBrowser, readOnly }: { readOnly?:b
 // (click opens full size) and text-file chips (a big paste diverted to a file;
 // click opens it). Both are served from the task's uploads dir.
 function AttachmentStrip({ items }: { items: MsgAttachment[] }) {
+  const open = useContext(OperatorBoardContext), scope = useContext(FileLinkContext);
   if (!items.length) return null;
   return (
     <div className="msg-attachments">
@@ -285,8 +294,11 @@ function AttachmentStrip({ items }: { items: MsgAttachment[] }) {
             <img src={a.url} alt="附件图片" loading="lazy" />
           </a>
         ) : (
-          <a key={i} href={a.url} target="_blank" rel="noreferrer" className="file-chip" title={`打开 ${a.name}`}>
-            {Icon.clip()} <span>附件文件</span>
+          <a key={i} href={a.url} target="_blank" rel="noreferrer" className="file-chip" title={`打开 ${a.name}`} onClick={event => {
+            const taskId = /\/api\/tasks\/([^/]+)\/uploads\//.exec(a.url)?.[1] ?? scope?.taskId;
+            if (taskId && event.button === 0 && !event.metaKey && !event.ctrlKey && !event.shiftKey && !event.altKey && open?.({ kind: "file", taskId: decodeURIComponent(taskId), path: a.path })) event.preventDefault();
+          }}>
+            {Icon.clip()} <span>{a.name}</span>
           </a>
         )
       )}
@@ -305,6 +317,11 @@ function AutomaticBoardBackground({content}:{content:string}) {
  return <details className="cli-auto-background"><summary>自动看板背景</summary>{blocks.map((part,index)=>part.kind==='block'?<pre key={index}>{part.block.text}</pre>:null)}</details>;
 }
 
+function QuotedUserText({ text }: { text: string }) {
+  const quoted = splitQuotedMessage(text);
+  return quoted ? <><ReferenceCard title={quoted.quote.author} text={quoted.quote.text} renderContent={value => <Markdown>{value}</Markdown>} />{quoted.text && <Markdown>{quoted.text}</Markdown>}</> : <Markdown>{text}</Markdown>;
+}
+
 export const MessageView = memo(function MessageView({ m, initial, hideWho, running, agent, agentLabel = "智能体", onAnswer, onInput, onBrowser, onCancelQueued, onClear, onReconnect, onRetry, onQuote, readOnly }: { readOnly?: boolean; onQuote?: (m: Msg, selected?: string) => void; m: Msg; initial: boolean; hideWho: boolean; running?: boolean; agent?: string | null; agentLabel?: string; onAnswer?: (askId: string, questions: AskQuestion[], answers: AskAnswers) => void; onInput?: (inputId: string, values: string[]) => Promise<string | null>; onBrowser?: (action: "handback") => Promise<string | null>; onCancelQueued?: (pendingId: string) => void; onClear?: () => void; onReconnect?: () => void; onRetry?: (msgId: string) => void }) {
   const openBoard=useContext(OperatorBoardContext);
   const fileScope=useContext(FileLinkContext);
@@ -318,7 +335,7 @@ export const MessageView = memo(function MessageView({ m, initial, hideWho, runn
       <div className="msg user queued">
         <div className="who"><Avatar who="user" /> 你<span className="badge queued-badge">排队中</span>{m.ts != null && <span className="msg-time">{clockTime(m.ts)}</span>}</div>
         <div className="msg-body">
-          {text && <Markdown>{text}</Markdown>}
+          {text && <QuotedUserText text={text} />}
           <AutomaticBoardBackground content={m.content}/>
           <AttachmentStrip items={attachments} />
           {onCancelQueued && <button className="queued-x" title="从队列中移除" aria-label="从队列中移除" onClick={() => onCancelQueued(m.id)}>{Icon.x()}</button>}
@@ -435,7 +452,7 @@ export const MessageView = memo(function MessageView({ m, initial, hideWho, runn
       )}
       <div className="msg-body">
         {initial && <div className="initial-tag">{Icon.spark()} 已随项目上下文发送</div>}
-        {text && <Markdown>{text}</Markdown>}
+        {text && (isUser ? <QuotedUserText text={text} /> : <Markdown>{text}</Markdown>)}
         {isUser&&<AutomaticBoardBackground content={m.content}/>}
         <AttachmentStrip items={attachments} />
       </div>

package/src/operator/node/boardBackend.ts

@@ -15,7 +15,7 @@ export function createOperatorBoardBackend(fetcher: typeof fetch = (...args) =>
     suffix=suffix.replace(/^files\/raw/,'files');
     return fetcher(`/api/tasks/${target[1]}/${suffix}${url.search}`, init);
   } });
-  const viewers=new Map<string,WebSocket>();
+  const viewers=new Map<string,{taskId:string;socket:WebSocket}>();
   return { ...client.board!, directLinks: true, browserLive:undefined,
     async info(id) {
       const response=await fetcher(`/api/tasks/${encodeURIComponent(id)}`,{cache:'no-store'});
@@ -24,25 +24,6 @@ export function createOperatorBoardBackend(fetcher: typeof fetch = (...args) =>
     },
     fileUrl(id, path, options) { const url = taskFileApiUrl(id, path); return options?.download ? `${url}${url.includes('?') ? '&' : '?'}download=1` : url; },
     fileLinkBase: async id => `/api/tasks/${encodeURIComponent(id)}/files`,
-    watchFiles(id,handlers) {
-      let stopped=false,ended=false;
-      const disrupted=(reason:string)=>{if(!stopped&&!ended)handlers.onEvent({type:'resync',reason,complete:false});};
-      const subscription=openLive(`/api/tasks/${encodeURIComponent(id)}/files/events`,{
-        onMessage:data=>{
-          if(stopped||ended)return;
-          try{const event=JSON.parse(data);if(['snapshot','changes','resync'].includes(event.type))handlers.onEvent(event);}catch{/* Ignore invalid event. */}
-        },
-        onEnd:code=>{
-          if(stopped||ended)return;
-          if(code===0||code===408||code===429||(code>=500&&code!==501)){disrupted(code===429?'文件监听暂时限流，正在等待恢复':'文件监听连接中断，正在重连');return;}
-          ended=true;
-          const message=code===401?'文件监听登录已过期，请重新登录':code===403?'文件监听被拒绝，请检查任务权限或登录':code===404?'未找到任务或节点不支持文件事件接口':`文件监听请求失败（HTTP ${code}）`;
-          handlers.onClose(new CenterError(message,`HTTP_${code}`,code));
-        },
-        onError:error=>disrupted(error.message),
-      });
-      return()=>{stopped=true;subscription.close();};
-    },
     browserEvents(id,handlers) {
       let stopped=false,ended=false;
       const disrupted=(error:CenterError)=>{if(!stopped&&!ended)handlers.onError?.(error);};
@@ -60,7 +41,7 @@ export function createOperatorBoardBackend(fetcher: typeof fetch = (...args) =>
     browserFrames(id,handlers) {
       const socket=new WebSocket(`${location.protocol==='https:'?'wss:':'ws:'}//${location.host}/browser/${encodeURIComponent(id)}/stream`);
       const viewer=clientId();let stopped=false;
-      viewers.set(viewer,socket);
+      viewers.set(viewer,{taskId:id,socket});
       const timeout=setTimeout(()=>{if(socket.readyState!==WebSocket.OPEN)socket.close();},10000);
       socket.onopen=()=>{clearTimeout(timeout);if(!stopped)handlers.onViewer(viewer);};
       socket.onmessage=event=>{if(stopped)return;try{handlers.onMessage(JSON.parse(String(event.data)) as BrowserMessage);}catch{/* Next frame can recover. */}};
@@ -68,8 +49,10 @@ export function createOperatorBoardBackend(fetcher: typeof fetch = (...args) =>
       socket.onclose=event=>{clearTimeout(timeout);viewers.delete(viewer);if(!stopped)handlers.onClose?.(new CenterError(event.reason||'浏览器画面连接已断开，正在重连','NETWORK',0));};
       return()=>{stopped=true;clearTimeout(timeout);viewers.delete(viewer);socket.close();};
     },
-    async browserInput(_id,viewer,events) {
-      const socket=viewers.get(viewer);
+    async browserInput(id,viewer,events) {
+      const entry=viewers.get(viewer);
+      if(entry&&entry.taskId!==id)throw new CenterError('浏览器连接属于另一个任务，请重新连接','HTTP_409',409);
+      const socket=entry?.socket;
       if(!socket||socket.readyState!==WebSocket.OPEN)throw new CenterError('浏览器画面尚未连接，请稍后重试','NETWORK',0);
       for(const event of events)socket.send(JSON.stringify(event));
     },

package/src/operator/node/boardEvents.ts

@@ -4,16 +4,34 @@ import type { WorkspaceHandlers } from '../../core/provider';
 import type { WorkspaceChangeEvent } from '../../core/types';
 import { cloneBoardView } from '../../board/context';
 import type { CliEvent } from '../../core/store';
-import { cloneWorkspaceChange, subscribeWorkspaceFiles } from '../../board/fileWatch';
+import { cloneWorkspaceChange, subscribeWorkspaceFiles, retryWorkspaceFiles, type WorkspaceRefreshOptions } from '../../board/fileWatch';
 import { getOperatorBoardBackend } from './boardBackend';
-import { readBoardState, subscribeBoardState } from './boardState';
+import { readBoardState, readVisibleBoardSources, subscribeBoardState } from './boardState';
+import { observeLiveMessages } from './liveStream';
+export function refreshOperatorWorkspaceFiles(taskId:string,options?:WorkspaceRefreshOptions):void {
+ const backend=getOperatorBoardBackend(),sources=new Set([taskId,...readVisibleBoardSources(taskId)]);
+ for(const source of sources)options?retryWorkspaceFiles(backend,source,options):retryWorkspaceFiles(backend,source);
+}
+const observedTasks=new Map<string,{refs:number;stop:()=>void}>();
+function observeTaskFiles(taskId:string):()=>void {
+ let entry=observedTasks.get(taskId);
+ if(!entry){
+  entry={refs:0,stop:observeLiveMessages(`/api/tasks/${taskId}/messages`,data=>{
+   try{const event=JSON.parse(data);if(event.type==='turn_end'||event.type==='snapshot')refreshOperatorWorkspaceFiles(taskId);}catch{/* Ignore unrelated/malformed stream payloads. */}
+  })};observedTasks.set(taskId,entry);
+ }
+ const owned=entry;owned.refs++;let active=true;
+ return()=>{if(!active)return;active=false;if(--owned.refs===0){observedTasks.delete(taskId);owned.stop();}};
+}
 export type OperatorBoardHandlers=WorkspaceHandlers&{onEvent?:(event:CliEvent)=>void};
 export function useOperatorFileWatch(taskId:string,enabled:boolean,handlers:OperatorBoardHandlers={},onChange?:(event:WorkspaceChangeEvent)=>void,intervalMs?:number){
  const current=useRef({handlers,onChange});current.current={handlers,onChange};
  useEffect(()=>{
   if(!enabled)return;
-  return subscribeWorkspaceFiles(getOperatorBoardBackend(),taskId,event=>{current.current.onChange?.(event);notifyCallback(current.current.handlers.onFilesChange,cloneWorkspaceChange(event));notifyCallback(current.current.handlers.onEvent,cloneWorkspaceChange(event));},
+  const unobserve=observeTaskFiles(taskId);
+  const unsubscribe=subscribeWorkspaceFiles(getOperatorBoardBackend(),taskId,event=>{current.current.onChange?.(event);notifyCallback(current.current.handlers.onFilesChange,cloneWorkspaceChange(event));notifyCallback(current.current.handlers.onEvent,cloneWorkspaceChange(event));},
    {intervalMs,onStatus:status=>{notifyCallback(current.current.handlers.onFilesWatch,{...status});notifyCallback(current.current.handlers.onEvent,{...status});}});
+  return()=>{unobserve();unsubscribe();};
  },[taskId,enabled,intervalMs]);
 }
 export function useOperatorContextEvents(taskId:string,enabled:boolean,handlers:OperatorBoardHandlers={}){

package/src/operator/node/boardState.ts

@@ -5,6 +5,8 @@ import { notifyCallback } from '../../core/callbacks';
 const cache=new Map<string,{stamp:string;view:BoardView|null}>();
 const listeners=new Map<string,Set<()=>void>>();
 const owners=new Map<string,Map<string,BoardView>>();
+// Mounted directory identity is transient; it must not become retained browsing history.
+const directorySources=new Map<string,Map<string,string>>();
 const key=(id:string)=>`cli-ui:operator-board:${id}`;
 const stamp=(id:string)=>{try{return sessionStorage.getItem(key(id))??'';}catch{return 'blocked';}};
 const validFile=(value:unknown):value is BoardFile=>!!value&&typeof value==='object'&&typeof (value as BoardFile).path==='string'&&!!(value as BoardFile).path&&((value as BoardFile).sourceId===undefined||typeof (value as BoardFile).sourceId==='string');
@@ -20,6 +22,18 @@ export function readBoardState(taskId:string):BoardView|null {
  }catch{/* Broken preferences cannot stop the workspace. */}
  cache.set(taskId,{stamp:saved,view});return view;
 }
+/** Internal: background refresh covers every visible owner, not just the selected board. */
+export function readVisibleBoardSources(taskId:string):string[] {
+ const active=owners.get(taskId);
+ const views=active?.size?[...active]:[['',readBoardState(taskId)] as const];
+ const sources=new Set<string>();
+ for(const [owner,view] of views){
+  if(!view||view.visible===false)continue;
+  for(const file of view.opened??[])sources.add(file.sourceId??taskId);
+  const directory=directorySources.get(taskId)?.get(owner);if(directory)sources.add(directory);
+ }
+ return [...sources];
+}
 export function subscribeBoardState(taskId:string,listener:()=>void):()=>void {
  const set=listeners.get(taskId)??new Set<()=>void>();set.add(listener);listeners.set(taskId,set);return()=>{set.delete(listener);if(!set.size)listeners.delete(taskId);};
 }
@@ -36,8 +50,10 @@ export function visitBoardFile(taskId:string,file:BoardFile):void {
  const current=readBoardState(taskId)??{tab:'files',dir:'',file:null,files:[]};
  publishBoardState(taskId,{...current,history:recent([...(current.history??[]),file])});
 }
-export function reportBoardState(taskId:string,owner:string,view:BoardView):void {
+export function reportBoardState(taskId:string,owner:string,view:BoardView,directorySource?:string):void {
  const sources=owners.get(taskId)??new Map<string,BoardView>();
+ if(directorySource){const directories=directorySources.get(taskId)??new Map<string,string>();directories.set(owner,directorySource);directorySources.set(taskId,directories);}
+ else{const directories=directorySources.get(taskId);directories?.delete(owner);if(!directories?.size)directorySources.delete(taskId);}
  const history=readBoardState(taskId)?.history??view.history??[];
  const selected=reportBoardOwner(sources,owner,{...view,history});owners.set(taskId,sources);
  if(selected)publishBoardState(taskId,{...selected[1],history});
@@ -51,6 +67,7 @@ export function activateBoardState(taskId:string,owner:string):void {
 }
 export function releaseBoardState(taskId:string,owner:string):void {
  const sources=owners.get(taskId);sources?.delete(owner);if(!sources?.size)owners.delete(taskId);
+ const directories=directorySources.get(taskId);directories?.delete(owner);if(!directories?.size)directorySources.delete(taskId);
  const previous=readBoardState(taskId);if(!previous)return;
  const remaining=sources?.size?selectedBoardOwner(sources)?.[1]:null;
  publishBoardState(taskId,remaining?{...remaining,history:previous.history,visible:remaining.visible!==false}:{...previous,visible:false});