@spzxg/cli-ui 0.6.5 → 0.6.7

package/src/core/store.ts

@@ -19,6 +19,7 @@ import { formatAnswersText } from "../ui/format";
 import { backgroundBlock, charCount, MAX_MESSAGE_CHARS, serializeBlock } from "./blocks";
 import { cloneBoardView, reportBoardOwner, activateBoardOwner, selectedBoardOwner, mergeBoardHistory, rememberBoardFile } from "../board/context";
 import { cloneWorkspaceChange, subscribeWorkspaceFiles, retryWorkspaceFiles, type WorkspaceWatchOptions } from "../board/fileWatch";
+import { retainFileScope } from "../board/fileScope";
 import type { WorkspaceChangeEvent, WorkspaceWatchStatus } from "./types";
 import { createWorkspace, type BoardView, type CliWorkspace } from "../board/workspace";
 import type { AskAnswers, AskQuestion, CenterJob, CenterTurn, ConversationClosedCallback, ConversationTurnCallback, NewConversationOptions } from "./types";
@@ -52,6 +53,12 @@ export interface CliState {
   viewing: Record<string, { ref: BoardRef; off: boolean }>;
   /** 看板现在的样子（按对话键）：正在看的文件、开着的文件页签、当前页签。没有看板时没有。 */
   boards: Record<string, BoardView>;
+  /** 当前对话是否有展开且可见的外置看板；Chat 内嵌看板不计入。 */
+  externalBoards: Record<string, boolean>;
+  /** 同一工作区中是否有展开且可见的对话列表。 */
+  listVisible: boolean;
+  /** 外置看板的模块和只读限制，内嵌视图沿用同一约束。 */
+  externalBoardOptions: Record<string, { availableTabs: ("files" | "changes" | "browser")[]; readOnly: boolean }>;
   /** 最近看板背景，收起/卸载后保留，供下一条消息被动参考。 */
   boardContext: Record<string, BoardView>;
   /** 业务方补充的项目背景（按对话键；"" = 还没建的新对话），随下一条消息发出（见 appendContext）。 */
@@ -121,6 +128,9 @@ export type CliEvent =
 export function cloneWorkspaceEvent(event:CliEvent):CliEvent {
   if(event.type==='files_changed')return cloneWorkspaceChange(event);
   if(event.type==='files_watch')return {...event};
+  if(event.type==='board_ref')return {...event,refs:event.refs.map(ref=>({...ref}))};
+  if(event.type==='context')return {...event,pending:event.pending.map(item=>({...item})),...(event.sent?{sent:event.sent.map(item=>({...item}))}:{})};
+  if(event.type==='open')return {...event,target:{...event.target}};
   if(event.type==='board_context')return {...event,view:cloneBoardView(event.view)};
   if(event.type==='board_change')return {...event,view:event.view?cloneBoardView(event.view):null};
   return event;
@@ -219,7 +229,7 @@ export function createCliStore(options: CliStoreOptions = {}) {
   // 列表只放宿主给的 jobIds 和本页里新建 / 接续出来的对话：不从 center 发现，也不从本地存储恢复——
   // 不传就不加载，免得把这个产品线令牌下别的业务、别的用户的对话列出来。
 
-  let state: CliState = { selected: null, jobIds: [], jobs: {}, convs: {}, listLoading: false, listError: null, refs: {}, viewing: {}, boards: {}, boardContext: {}, context: {} };
+  let state: CliState = { selected: null, jobIds: [], jobs: {}, convs: {}, listLoading: false, listError: null, refs: {}, viewing: {}, boards: {}, externalBoards: {}, listVisible: false, externalBoardOptions: {}, boardContext: {}, context: {} };
   const listeners = new Set<() => void>();
   const eventListeners = new Set<(event: CliEvent) => void>();
   const settledTurns = new Set<string>();
@@ -384,24 +394,28 @@ export function createCliStore(options: CliStoreOptions = {}) {
   function connect(key: string) {
     const entry = streams.get(key);
     if (!entry || entry.refs <= 0) return;
+    const previous = entry.stop;
+    entry.stop = null;
+    previous?.();
+    if (streams.get(key) !== entry || entry.refs <= 0) return;
     const { jobId, taskId } = parseConvKey(key);
-    patchConv(key, (conv) => ({ ...conv, stream: entry.attempt ? "reconnecting" : "connecting", streamError: null }));
-    let ended = false;
-    entry.stop = client.stream(jobId, {
-      onOpen: () => { entry.attempt = 0; patchConv(key, (conv) => ({ ...conv, stream: "live", streamError: null })); },
-      onSnapshot: (snapshot) => patchConv(key, (conv) => applySnapshot(conv, snapshot)),
-      onChunk: (items) => patchConv(key, (conv) => applyItems(conv, items)),
-      onEnd: (end) => {
-        ended = true;
-        // 接续的新对话：指定了对话的跟到接续它的那个对话（还没有就不跟，再发消息时 center 会开出来）；只有 job_id 的照旧跟新 job。
-        const continuedBy = taskId ? (end.continued_by_job_id && end.continued_by_task_id ? convKey(end.continued_by_job_id, end.continued_by_task_id) : null) : end.continued_by_job_id ?? null;
-        patchConv(key, (conv) => ({ ...conv, stream: "ended", endReason: end.reason, continuedBy, nodeRunning: false }));
-        void refreshJob(jobId, true);
-      },
-      onClose: (error) => {
-        entry.stop = null;
-        const current = streams.get(key);
-        if (!current || current.refs <= 0) return;
+    let ended = false, retired = false, snapshotReceived = false;
+    let cleanup: (() => void) | null = null;
+    const owns = () => streams.get(key) === entry && entry.refs > 0 && entry.stop === retire;
+    const active = () => !retired && owns();
+    const refreshFiles = () => { if (active() && client.board) retryWorkspaceFiles(client.board, key); };
+    const retire = () => {
+      if (retired) return;
+      retired = true;
+      if (entry.stop === retire) entry.stop = null;
+      const dispose = cleanup; cleanup = null;
+      notifyCallback(dispose ?? undefined, undefined);
+    };
+    const close = (error: CenterError | null) => {
+      if (!active()) return;
+      retire();
+      const current = streams.get(key);
+      if (current !== entry || current.refs <= 0 || current.stop) return;
         // 对话结束（end）不再连；中枢停机（server_shutdown）稍后重连。
         if (ended && state.convs[key]?.endReason !== "server_shutdown") return;
         // 404：对话不存在，重连也没用。
@@ -422,8 +436,56 @@ export function createCliStore(options: CliStoreOptions = {}) {
         current.attempt += 1;
         patchConv(key, (conv) => ({ ...conv, stream: "reconnecting", streamError: error?.message ?? null }));
         current.timer = setTimeout(() => { current.timer = null; connect(key); }, jitter(delay));
-      },
-    }, undefined, taskId);
+    };
+    entry.stop = retire;
+    patchConv(key, (conv) => ({ ...conv, stream: entry.attempt ? "reconnecting" : "connecting", streamError: null }));
+    if (!active()) return;
+    try {
+      cleanup = client.stream(jobId, {
+        onOpen: () => { if (!active()) return; entry.attempt = 0; patchConv(key, (conv) => ({ ...conv, stream: "live", streamError: null })); },
+        onSnapshot: (snapshot) => {
+          if (!active()) return;
+          patchConv(key, (conv) => applySnapshot(conv, snapshot));
+          // Each connection catches up once, including rounds completed while disconnected.
+          if (!snapshotReceived) { snapshotReceived = true; refreshFiles(); }
+        },
+        onChunk: (items) => {
+          if (!active()) return;
+          let refresh = false;
+          patchConv(key, (conv) => {
+            let next = conv;
+            for (const item of items) {
+              const previous = next;
+              next = applyItems(next, [item]);
+              // applyItems also rejects events from another batch task's node session.
+              if (next === previous) continue;
+              // Observe every event: end + next user in one chunk can leave running=true.
+              if (item.type === "node" && item.event.type === "turn_end" || item.type === "transcript") refresh = true;
+              if (item.type === "turn" && item.turn.status !== "merged" && TERMINAL_TURN.has(item.turn.status)
+                && !TERMINAL_TURN.has(previous.turns.find((turn) => turn.turn_id === item.turn.turn_id)?.status ?? "")) refresh = true;
+            }
+            return next;
+          });
+          if (refresh) refreshFiles();
+        },
+        onEnd: (end) => {
+          if (!active() || ended) return;
+          ended = true;
+          const continuedBy = taskId ? (end.continued_by_job_id && end.continued_by_task_id ? convKey(end.continued_by_job_id, end.continued_by_task_id) : null) : end.continued_by_job_id ?? null;
+          patchConv(key, (conv) => ({ ...conv, stream: "ended", endReason: end.reason, continuedBy, nodeRunning: false }));
+          refreshFiles();
+          void refreshJob(jobId, true);
+        },
+        onClose: close,
+      }, undefined, taskId);
+      // Some custom transports close synchronously before returning cleanup.
+      if (retired || !owns()) {
+        const dispose = cleanup; cleanup = null;
+        notifyCallback(dispose ?? undefined, undefined);
+      }
+    } catch (error) {
+      close(error instanceof CenterError ? error : new CenterError(String(error), "NETWORK", 0));
+    }
   }
 
   // 网络恢复 / 标签页切回来时，正在退避等待的连接立刻重连，不用等完退避时间。
@@ -472,16 +534,22 @@ export function createCliStore(options: CliStoreOptions = {}) {
       void refreshJob(jobId);
       connect(key);
     }
+    const owned = entry;
+    let active = true;
     return () => {
+      if (!active) return;
+      active = false;
       const current = streams.get(key);
-      if (!current) return;
+      if (current !== owned) return;
       current.refs -= 1;
       if (current.refs > 0) return;
-      current.stop?.();
-      if (current.timer) clearTimeout(current.timer);
+      // Retire the registry before calling host cleanup: it may synchronously
+      // acquire a new lease for the same task.
       streams.delete(key);
+      if (current.timer) { clearTimeout(current.timer); current.timer = null; }
       syncLive();
-      patchConv(key, (conv) => ({ ...conv, stream: conv.stream === "ended" ? "ended" : "idle" }));
+      current.stop?.();
+      if (!streams.has(key)) patchConv(key, (conv) => ({ ...conv, stream: conv.stream === "ended" ? "ended" : "idle" }));
     };
   }
 
@@ -552,6 +620,7 @@ export function createCliStore(options: CliStoreOptions = {}) {
         return target;
       }
       if (!key || !ref) {
+        const selectedBeforeCreate = state.selected;
         let newId: string;
         if (createConversation) {
           newId = await createConversation(text);
@@ -563,7 +632,7 @@ export function createCliStore(options: CliStoreOptions = {}) {
         }
         addJob(newId);
         // 共享选中只由「跟着选中走」的组件改；传了 jobId、自己接管的对话组件新建对话不去动别人的选中。
-        if (overrides.select !== false) set({ selected: newId });
+        if (overrides.select !== false && state.selected === selectedBeforeCreate) set({ selected: newId });
         emit({ type: "job_change", jobId: newId, previousJobId: null, taskId: null, key: newId, previousKey: null });
         void refreshJob(newId, true);
         return newId;
@@ -690,12 +759,33 @@ export function createCliStore(options: CliStoreOptions = {}) {
   }
 
   // 同一个仓库里登记的看板（cli-board）。后登记的优先（例如弹出的看板盖在常驻的上面）。
-  const surfaces: BoardSurface[] = [];
+  const surfaces: { surface: BoardSurface; owner?: string; inline?: boolean; priority?: () => number }[] = [];
+  const visibleLists = new Set<string>();
+  function reportListPresence(owner: string, visible: boolean) {
+    if (visible) visibleLists.add(owner); else visibleLists.delete(owner);
+    const listVisible = visibleLists.size > 0;
+    if (state.listVisible !== listVisible) set({ listVisible });
+  }
+  const externalBoards = new Map<string, Map<string, { visible: boolean; availableTabs?: readonly ("files" | "changes" | "browser")[]; readOnly?: boolean }>>();
+  function reportBoardPresence(key: string, owner: string, visible: boolean | null, options: { availableTabs?: readonly ("files" | "changes" | "browser")[]; readOnly?: boolean } = {}) {
+    const owners = externalBoards.get(key) ?? new Map<string, { visible: boolean; availableTabs?: readonly ("files" | "changes" | "browser")[]; readOnly?: boolean }>();
+    if (visible === null) owners.delete(owner); else owners.set(owner, { visible, ...options });
+    if (owners.size) externalBoards.set(key, owners); else externalBoards.delete(key);
+    const values = [...owners.values()];
+    const shown = values.some(value => value.visible);
+    const limits = owners.size ? { availableTabs: (["files", "changes", "browser"] as const).filter(tab => values.every(value => !value.availableTabs || value.availableTabs.includes(tab))), readOnly: values.some(value => value.readOnly) } : undefined;
+    if (!!state.externalBoards[key] === shown && JSON.stringify(state.externalBoardOptions[key]) === JSON.stringify(limits)) return;
+    const next = { ...state.externalBoards };
+    if (shown) next[key] = true; else delete next[key];
+    const configurations = { ...state.externalBoardOptions };
+    if (limits) configurations[key] = limits; else delete configurations[key];
+    set({ externalBoards: next, externalBoardOptions: configurations });
+  }
   // ── 看板 → 对话的引用 ─────────────────────────────
 
   function setRefs(key: string, refs: BoardRef[]) {
     const next = { ...state.refs };
-    if (refs.length) next[key] = refs; else delete next[key];
+    if (refs.length) next[key] = refs.map(ref => ({ ...ref })); else delete next[key];
     set({ refs: next });
     emit({ type: "board_ref", key, refs });
   }
@@ -784,12 +874,13 @@ export function createCliStore(options: CliStoreOptions = {}) {
   const fileSubscriptions = new Map<string,{listeners:Set<{change?:(event:WorkspaceChangeEvent)=>void;status?:WorkspaceWatchOptions['onStatus']}>;stop:()=>void;status?:WorkspaceWatchStatus}>();
   function watchWorkspace(key:string,listener?:(event:WorkspaceChangeEvent)=>void,options:WorkspaceWatchOptions={}) {
     if(!client.board) throw new Error("当前后端不支持工作区文件订阅");
+    const releaseScope=options.paths?.length||options.dirs?.length?retainFileScope(client.board,key,{paths:[...options.paths??[]],dirs:[...options.dirs??[]]}):()=>{};
     const item={change:listener,status:options.onStatus};let subscription=fileSubscriptions.get(key);
     if(!subscription){
       subscription={listeners:new Set([item]),stop:()=>{}};fileSubscriptions.set(key,subscription);const owned=subscription;
-      owned.stop=subscribeWorkspaceFiles(client.board,key,event=>{emit(event);for(const next of [...owned.listeners])notifyCallback(next.change,cloneWorkspaceChange(event));},{...options,onStatus:status=>{owned.status=status;emit(status);for(const next of [...owned.listeners])notifyCallback(next.status,{...status});}});
+      owned.stop=subscribeWorkspaceFiles(client.board,key,event=>{emit(event);for(const next of [...owned.listeners])notifyCallback(next.change,cloneWorkspaceChange(event));},{intervalMs:options.intervalMs,onStatus:status=>{owned.status=status;emit(status);for(const next of [...owned.listeners])notifyCallback(next.status,{...status});}});
     }else{subscription.listeners.add(item);if(subscription.status)notifyCallback(item.status,{...subscription.status});retryWorkspaceFiles(client.board,key);}
-    const owned=subscription;let active=true;return()=>{if(!active)return;active=false;owned.listeners.delete(item);if(!owned.listeners.size){if(fileSubscriptions.get(key)===owned)fileSubscriptions.delete(key);owned.stop();}};
+    const owned=subscription;let active=true;return()=>{if(!active)return;active=false;owned.listeners.delete(item);if(!owned.listeners.size){if(fileSubscriptions.get(key)===owned)fileSubscriptions.delete(key);owned.stop();}releaseScope();};
   }
 
   // ── 补充背景：业务方随时追加，随下一条消息发给智能体 ────────
@@ -822,7 +913,7 @@ export function createCliStore(options: CliStoreOptions = {}) {
     if (next.length !== list.length) setContext(k, next);
   }
   /** 还没发出的补充背景。 */
-  const pendingContext = (key: string | null): ContextItem[] => [...(state.context[ctxKey(key)] ?? [])];
+  const pendingContext = (key: string | null): ContextItem[] => (state.context[ctxKey(key)] ?? []).map(item => ({ ...item }));
 
   function workspace(key?: string | null): CliWorkspace {
     const k = key ?? state.selected;
@@ -853,9 +944,15 @@ export function createCliStore(options: CliStoreOptions = {}) {
     if (ref && cur && cur.ref.id === ref.id && cur.off) setViewingState(key, { ...cur, off: false });
   }
 
-  function openInBoard(jobId: string, target: OpenTarget): boolean {
+  function openInBoard(jobId: string, target: OpenTarget, preferredInlineOwner?: string): boolean {
     let handled = false;
-    for (let i = surfaces.length - 1; i >= 0 && !handled; i--) handled = surfaces[i](jobId, target);
+    const available = [...surfaces].reverse().filter(item => !preferredInlineOwner || !item.inline || item.owner === preferredInlineOwner)
+      .sort((a, b) => (b.priority?.() ?? 2) - (a.priority?.() ?? 2));
+    for (const { surface } of available) {
+      try { handled = surface(jobId, { ...target }); }
+      catch (error) { console.error("[@spzxg/cli-ui] board surface callback failed", error); }
+      if (handled) break;
+    }
     emit({ type: "open", jobId, target, handled });
     return handled;
   }
@@ -867,9 +964,10 @@ export function createCliStore(options: CliStoreOptions = {}) {
     /** 在看板里打开文件 / 浏览器 / 改动。返回有没有看板接住。 */
     openInBoard,
     /** 看板登记自己；返回注销函数。 */
-    registerBoard(surface: BoardSurface) {
-      surfaces.push(surface);
-      return () => { const i = surfaces.indexOf(surface); if (i >= 0) surfaces.splice(i, 1); };
+    registerBoard(surface: BoardSurface, options: { owner?: string; inline?: boolean; priority?: () => number } = {}) {
+      const entry = { surface, ...options };
+      surfaces.push(entry);
+      return () => { const i = surfaces.indexOf(entry); if (i >= 0) surfaces.splice(i, 1); };
     },
     subscribe(fn: () => void) { listeners.add(fn); return () => { listeners.delete(fn); }; },
     on(fn: (event: CliEvent) => void) { eventListeners.add(fn); return () => { eventListeners.delete(fn); }; },
@@ -882,7 +980,7 @@ export function createCliStore(options: CliStoreOptions = {}) {
     addRef, removeRef, takeRefs, restoreRefs,
     setViewing, dismissViewing, takeViewing, restoreViewing,
     /** 看板报告自己的样子（看板组件用）。 */
-    reportBoard, activateBoard,
+    reportBoard, activateBoard, reportBoardPresence, reportListPresence,
     /** 业务方追加项目背景：随下一条消息发给智能体。 */
     appendContext, removeContext, pendingContext,
     /** 工作区文件接口（不显示看板也能用）：列文件、读文件、下载、打包。不传 = 当前选中的对话。 */

package/src/core/types.ts

@@ -43,7 +43,13 @@ export interface CenterTurn {
   queue_position?: number | null;
 }
 
-export interface CenterTask {
+/** Node-observed human wait state. Missing/null means unavailable, not confirmed idle. */
+export interface AwaitingInputState {
+  awaiting_input?: boolean | null;
+  awaiting_input_observed_at?: string | null;
+}
+
+export interface CenterTask extends AwaitingInputState {
   id: string;
   job_id: string;
   seq?: number;
@@ -63,7 +69,7 @@ export interface CenterTask {
 }
 
 /** 对话任务里的一个对话（一个子任务、一个 Agent 会话）。conversation.conversations 的一项。 */
-export interface ConversationInfo {
+export interface ConversationInfo extends AwaitingInputState {
   task_id: string;
   seq: number;
   title: string;
@@ -79,7 +85,7 @@ export interface ConversationInfo {
   created_at: string | null;
 }
 
-export interface ConversationSummary {
+export interface ConversationSummary extends AwaitingInputState {
   /** 里面的每个对话（按开的先后）。旧版 center 没有这个字段：当作只有一个对话。 */
   conversations?: ConversationInfo[];
   turns: number;
@@ -117,6 +123,12 @@ export interface SendResult {
   turn: CenterTurn;
 }
 
+/** 每次浏览器操作前的随机等待范围；合法范围由任务中心与节点共同校验。 */
+export interface BrowserPacing {
+  min_seconds: number;
+  max_seconds: number;
+}
+
 /** 新建对话时可带的参数（POST /api/jobs，mode=conversation）。 */
 export interface NewConversationOptions {
   title?: string;
@@ -127,6 +139,10 @@ export interface NewConversationOptions {
   agent?: string;
   timeoutSeconds?: number;
   browser?: boolean;
+  /** Ego 操作手册的 YAML 正文（不是文件名或 URL）；必须显式 browser:true。 */
+  browserPlaybook?: string;
+  /** 转发至节点执行器和浏览器脚本；必须显式 browser:true。 */
+  browserPacing?: BrowserPacing;
 }
 
 // ── Operator：节点转录 ─────────────────────────────────────────────
@@ -213,8 +229,8 @@ export type NodeEvent =
   | { type: "tool"; id: string; title: string; detail: string; peek?: ToolPeek; diff?: DiffLine[]; msgId?: string; generation?: number }
   | { type: "tool_result"; id: string; content: string; isError: boolean; peek?: ToolPeek; msgId?: string }
   | { type: "ask"; id: string; questions: AskQuestion[]; msgId?: string; generation?: number }
-  | { type: "ask_answered"; id: string; answers: AskAnswers; msgId?: string }
-  | { type: "input"; input: InputRequest; msgId?: string; generation?: number }
+  | { type: "ask_answered"; id: string; answers: AskAnswers; msgId?: string; awaiting_input?: 0 | 1 }
+  | { type: "input"; input: InputRequest; msgId?: string; generation?: number; awaiting_input?: 0 | 1 }
   | { type: "usage"; usage: TurnUsage }
   | { type: "notice"; content: string; msgId?: string; generation?: number }
   | { type: "error"; content: string; msgId?: string; generation?: number }
@@ -233,7 +249,7 @@ export type StreamItem =
   | { type: "task"; task: StreamTask | BatchStreamTask };
 
 /** 实时流看的那个对话（GET /api/jobs/:id/stream?task=）。 */
-export interface StreamTask { id: string; seq: number; title: string; status: string; closed: boolean; remote_task_id: string | null; continue_from_task_id: string | null }
+export interface StreamTask extends AwaitingInputState { id: string; seq: number; title: string; status: string; closed: boolean; remote_task_id: string | null; continue_from_task_id: string | null }
 
 export interface StreamSnapshot {
   job: { id: string; status: JobStatus; closed_reason: string | null; node_id: string | null; mode: string; title: string; conversation: ConversationSummary };
@@ -246,7 +262,7 @@ export interface StreamSnapshot {
  * 一次性任务（含续派）的子任务，实时流里的样子。cli-chat 只读查看这类任务时用。
  * prompt / opener_prompt：指定了 ?task= 时看的那个子任务才有（opener_prompt = 开出它所在节点对话的那个子任务的原文）。
  */
-export interface BatchStreamTask {
+export interface BatchStreamTask extends AwaitingInputState {
   id: string;
   seq: number;
   task_key: string | null;
@@ -384,7 +400,7 @@ export interface FileEntry {
   changeToken?: string;
 }
 
-export interface DirListing { type: "dir"; path: string; entries: FileEntry[]; truncated: boolean; /** 目录里的条目总数（新版节点给）。 */ total?: number }
+export interface DirListing { type: "dir"; path: string; entries: FileEntry[]; truncated: boolean; /** 目录里的条目总数（新版节点给）。 */ total?: number; nextCursor?: string; revision?: string }
 export interface FileInfo { type: "file"; path: string; name: string; size: number; mtime: number; contentType: string; inline: boolean }
 
 export interface DiffFile {
@@ -426,15 +442,20 @@ export interface BrowserStatus {
 }
 
 /** 浏览器画面流里的一条消息（节点原样转发）。 */
-export type BrowserMessage =
+export interface BrowserTab { id: string; title: string; url: string }
+/** 新节点用页面身份隔离输入；旧节点可以省略这两个字段。 */
+export interface BrowserTarget { targetId?: string; targetEpoch?: number }
+export type BrowserMessage = BrowserTarget & (
   | { type: "frame"; data: string; metadata?: { deviceWidth: number; deviceHeight: number } }
   | { type: "page"; url?: string; title?: string }
+  /** 只包含当前任务内的网页；只有明确声明 canSelect 才显示可切换标签。 */
+  | { type: "tabs"; tabs: BrowserTab[]; activeId: string | null; canSelect?: boolean }
   | { type: "error"; message?: string }
   /** 按了复制 / 剪切：选中的文字（只发给按键的人），写进本机剪贴板。 */
   | { type: "clipboard"; text: string }
   /** 网页弹出了 alert / confirm / prompt（画面里看不到，单独显示）。 */
   | { type: "dialog"; dialogType: "alert" | "confirm" | "prompt" | "beforeunload"; message: string; defaultPrompt?: string }
-  | { type: "dialog_closed" };
+  | { type: "dialog_closed" });
 
 /** 浏览器实时连接（GET /browser/live）的画面连接状况。 */
 export type BrowserFramesState = { state: "idle" | "connecting" | "live" | "retrying"; detail?: string };

package/src/index.ts

@@ -1,4 +1,5 @@
 export { CliMsgList, CliChat, CliBoard, type CliMsgListProps, type CliChatProps, type CliBoardProps } from "./components";
+export type { GroupChatAdapter, GroupChatMessage, GroupChatReference } from "./chat/GroupChat";
 /**
  * @spzxg/cli-ui —— 任务中心（cli-task-center）对话任务的前端积木，数据全部来自 center 服务。
  *
@@ -50,3 +51,5 @@ export { formatBoardContext, appendBoardContext, BOARD_HISTORY_MAX } from "./boa
 export { subscribeWorkspaceFiles, type WorkspaceWatchOptions } from "./board/fileWatch";
 export type { WorkspaceHandlers } from "./core/provider";
 export type { BoardFile } from "./board/workspace";
+
+export { syncFile, clearFileSyncNamespace, FILE_SYNC_MAX, type FileSyncTransport, type FileSyncManifest, type FileSyncProgress } from "./board/fileSync";

package/src/layout/split.ts

@@ -5,12 +5,12 @@
  *   attachSplit(container, { panes: [{ size: 300, min: 220, max: 480 }, { min: 360 }, { size: "42%", min: 320 }], storageKey: "strategy" })
  *
  * 规则：
- *   · 写了 size 的栏是定宽（px 或百分比，百分比按容器宽度换算成 px）；没写 size 的栏占剩下的宽度（只能有一个，没有就是最后一栏）。
+ *   · 写了 size 的栏是定宽（px 或百分比，未手动调整的百分比随容器宽度变化）；没写 size 的栏占剩下的宽度（只能有一个，没有就是最后一栏）。
  *   · 拖动条改它旁边定宽的那一栏；任何一栏都不会小于自己的 min，占剩余宽度的那栏也一样。
  *   · 双击拖动条：那一栏回到初始宽度。键盘：拖动条能聚焦，←/→ 每次 16px（按住 Shift 64px）。
  *   · 子元素根节点带 collapsed 类（cli-board 收起时）：那一栏变成 40px 窄条（--cli-split-collapsed），旁边的拖动条隐藏；展开后回到原来的宽度。
  *   · 写了 storageKey：拖好的宽度记在 localStorage（cli-ui:split:<storageKey>），下次打开还是这个宽度。
- *   · 窗口变窄时定宽栏按比例让出宽度，保证占剩余宽度的那栏不小于它的 min。
+ *   · 窗口变窄时定宽栏按超过 min 的空间比例让出宽度；各栏 min 之和能放下时，保证占剩余宽度的那栏不小于它的 min。
  */
 export type SplitPane = { size?: number | `${number}%`; min?: number; max?: number };
 export type SplitOptions = {
@@ -26,6 +26,8 @@ const STEP = 16;
 
 export function attachSplit(container: HTMLElement, initial: SplitOptions = {}): SplitHandle {
   let options = initial;
+  // Only user overrides are pixels. null keeps the configured responsive default.
+  // Old persisted numeric arrays remain valid user preferences.
   let sizes: (number | null)[] = [];
   let gutters: HTMLElement[] = [];
   let panes: HTMLElement[] = [];
@@ -45,48 +47,79 @@ export function attachSplit(container: HTMLElement, initial: SplitOptions = {}):
   };
 
   const spec = (i: number): SplitPane => options.panes?.[i] ?? {};
-  const flexIndex = () => {
+  const preferredFlexIndex = () => {
     const i = panes.findIndex((_, n) => spec(n).size === undefined);
     return i >= 0 ? i : panes.length - 1;
   };
-  const minOf = (i: number) => spec(i).min ?? DEFAULT_MIN;
+  const minOf = (i: number) => Math.max(0, spec(i).min ?? DEFAULT_MIN);
+  const clamp = (i: number, w: number) => Math.round(Math.min(Math.max(minOf(i), spec(i).max ?? Infinity), Math.max(minOf(i), w)));
+  const contentWidth = () => {
+    const style = getComputedStyle(container);
+    return Math.max(0, container.clientWidth - (parseFloat(style.paddingLeft) || 0) - (parseFloat(style.paddingRight) || 0));
+  };
   const initialSize = (i: number): number | null => {
-    if (i === flexIndex()) return null;
+    if (i === preferredFlexIndex()) return null;
     const s = spec(i).size;
-    if (typeof s === "string") return Math.round((parseFloat(s) / 100) * (container.clientWidth || 1200));
-    return s ?? 320;
+    if (typeof s === "string") return clamp(i, (parseFloat(s) / 100) * (contentWidth() || 1200));
+    return clamp(i, s ?? 320);
   };
   const isCollapsed = (pane: HTMLElement) => !!pane.firstElementChild?.classList.contains("collapsed");
-  const clamp = (i: number, w: number) => Math.round(Math.min(spec(i).max ?? Infinity, Math.max(minOf(i), w)));
+  const isVisible = (pane: HTMLElement) => !pane.hidden && getComputedStyle(pane).display !== "none";
+  const flexIndex = () => {
+    const preferred = preferredFlexIndex();
+    if (panes[preferred] && isVisible(panes[preferred]) && !isCollapsed(panes[preferred])) return preferred;
+    // A host may hide whole panes on mobile. A remaining visible pane fills the
+    // space without turning its default width into a permanent pixel override.
+    for (let i = panes.length - 1; i >= 0; i--) if (isVisible(panes[i]) && !isCollapsed(panes[i])) return i;
+    return -1;
+  };
+  const desiredSizes = () => panes.map((_, i) => i === preferredFlexIndex() ? null : clamp(i, sizes[i] ?? initialSize(i)!));
 
   /** 定宽栏放进容器：总宽超了就按比例收，给占剩余宽度的那栏留出它的 min。 */
-  function fitted(): (number | null)[] {
-    const total = container.clientWidth;
-    const flex = flexIndex();
-    const fixed = sizes.map((s, i) => (i === flex || isCollapsed(panes[i]) ? 0 : s ?? 0));
-    const collapsedW = panes.reduce((sum, p, i) => sum + (i !== flex && isCollapsed(p) ? p.getBoundingClientRect().width : 0), 0);
-    const room = total - minOf(flex) - collapsedW;
-    const sum = fixed.reduce((a, b) => a + b, 0);
-    if (!total || sum <= room) return sizes;
-    const ratio = Math.max(0, room) / sum;
-    return sizes.map((s, i) => (i === flex || s === null ? null : Math.max(minOf(i), Math.floor(s * ratio))));
+  function fitted(flex: number): (number | null)[] {
+    const shown = desiredSizes();
+    const fixed = panes.flatMap((p, i) => i !== flex && isVisible(p) && !isCollapsed(p) ? [i] : []);
+    const collapsedW = panes.reduce((sum, p) => sum + (isVisible(p) && isCollapsed(p) ? p.getBoundingClientRect().width : 0), 0);
+    const gutterW = gutters.reduce((sum, g) => {
+      if (g.hidden) return sum;
+      const style = getComputedStyle(g);
+      const width = g.getBoundingClientRect().width || parseFloat(style.flexBasis) || 0;
+      return sum + Math.max(0, width + (parseFloat(style.marginLeft) || 0) + (parseFloat(style.marginRight) || 0));
+    }, 0);
+    const room = contentWidth() - (flex < 0 ? 0 : minOf(flex)) - collapsedW - gutterW;
+    const sum = fixed.reduce((total, i) => total + shown[i]!, 0);
+    if (!container.clientWidth || sum <= room) return shown;
+    const minimum = fixed.reduce((total, i) => total + minOf(i), 0);
+    // Scaling whole widths can hit one pane's minimum and still overflow the
+    // flexible pane. Allocate only the space above each minimum instead.
+    const ratio = sum > minimum ? Math.max(0, room - minimum) / (sum - minimum) : 0;
+    for (const i of fixed) shown[i] = minOf(i) + Math.floor((shown[i]! - minOf(i)) * ratio);
+    return shown;
   }
 
   function apply() {
     const flex = flexIndex();
-    const shown = fitted();
+    // Set narrow strips before measuring: their previous expanded width must
+    // not be subtracted from the available space on the first collapse frame.
+    for (const pane of panes) {
+      if (!isCollapsed(pane)) continue;
+      pane.style.flex = "0 0 var(--cli-split-collapsed, 40px)";
+      pane.style.width = "";
+      pane.style.minWidth = "";
+    }
+    gutters.forEach((g, i) => { g.hidden = !isVisible(panes[i]) || !isVisible(panes[i + 1]) || isCollapsed(panes[i]) || isCollapsed(panes[i + 1]); });
+    const shown = fitted(flex);
     panes.forEach((pane, i) => {
       pane.classList.add("cli-split-pane");
+      if (isCollapsed(pane)) return;
       if (i === flex) { pane.style.flex = "1 1 0"; pane.style.width = ""; pane.style.minWidth = `${minOf(i)}px`; return; }
-      // 收起的栏（cli-board 的窄条宽度是 100%，没有自身宽度）：固定窄条宽，宿主可用 --cli-split-collapsed 改。
-      if (isCollapsed(pane)) { pane.style.flex = "0 0 var(--cli-split-collapsed, 40px)"; pane.style.width = ""; pane.style.minWidth = ""; return; }
+      // Hidden preferred flex panes keep their flex role for when they return.
+      if (shown[i] === null) { pane.style.flex = "1 1 0"; pane.style.width = ""; pane.style.minWidth = `${minOf(i)}px`; return; }
       pane.style.flex = `0 0 ${shown[i]}px`;
       pane.style.width = `${shown[i]}px`;
       pane.style.minWidth = "0";
     });
     gutters.forEach((g, i) => {
-      const hidden = isCollapsed(panes[i]) || isCollapsed(panes[i + 1]);
-      g.hidden = hidden;
       g.setAttribute("aria-valuenow", String(Math.round(panes[sideOf(i)]?.getBoundingClientRect().width ?? 0)));
     });
   }
@@ -95,18 +128,20 @@ export function attachSplit(container: HTMLElement, initial: SplitOptions = {}):
   const sideOf = (gutter: number) => (gutter === flexIndex() ? gutter + 1 : gutter);
 
   function resize(gutter: number, dx: number) {
+    if (gutters[gutter]?.hidden) return;
     const target = sideOf(gutter);
     const sign = target === gutter ? 1 : -1;
     const flex = flexIndex();
+    if (flex < 0) return;
     const current = panes[target].getBoundingClientRect().width;
     // 占剩余宽度的那栏不能被挤到 min 以下。
     const flexW = panes[flex].getBoundingClientRect().width;
-    const grow = Math.min(sign * dx, flexW - minOf(flex));
+    const grow = Math.min(sign * dx, Math.max(0, flexW - minOf(flex)));
     sizes[target] = clamp(target, current + grow);
     apply();
   }
 
-  function finish() { save(); options.onResize?.([...sizes]); }
+  function finish() { save(); options.onResize?.(desiredSizes()); }
 
   function makeGutter(index: number) {
     const g = document.createElement("div");
@@ -138,7 +173,7 @@ export function attachSplit(container: HTMLElement, initial: SplitOptions = {}):
     });
     g.addEventListener("dblclick", () => {
       const target = sideOf(index);
-      sizes[target] = initialSize(target);
+      sizes[target] = null;
       apply();
       finish();
     });
@@ -153,20 +188,22 @@ export function attachSplit(container: HTMLElement, initial: SplitOptions = {}):
 
   /** 子元素变了（宿主增删栏）：重新找栏、重新插拖动条。 */
   function rebuild() {
+    for (const p of panes) ro?.unobserve?.(p);
     for (const g of gutters) g.remove();
     panes = [...container.children].filter((c): c is HTMLElement => c instanceof HTMLElement && !c.classList.contains("cli-split-gutter"));
     const saved = load();
-    const flex = flexIndex();
+    const flex = preferredFlexIndex();
     sizes = panes.map((_, i) => {
       if (i === flex) return null;
       const keep = sizes[i];
-      if (typeof keep === "number") return keep;
+      if (typeof keep === "number" && Number.isFinite(keep)) return clamp(i, keep);
       const s = saved && saved.length === panes.length ? saved[i] : null;
-      return typeof s === "number" ? clamp(i, s) : initialSize(i);
+      return typeof s === "number" && Number.isFinite(s) ? clamp(i, s) : null;
     });
     gutters = panes.slice(0, -1).map((_, i) => makeGutter(i));
     gutters.forEach((g, i) => panes[i].after(g));
     apply();
+    for (const p of panes) ro?.observe(p);
   }
 
   // 只看栏的增删、栏的根节点换了、根节点的 class 变了（收起 / 展开）；栏里面的内容（流式输出）不看，不然每个字都要重排。
@@ -199,7 +236,7 @@ export function attachSplit(container: HTMLElement, initial: SplitOptions = {}):
       observer.disconnect(); rebuild(); observe();
     },
     reset() {
-      sizes = panes.map((_, i) => initialSize(i));
+      sizes = panes.map(() => null);
       apply();
       finish();
     },