@spzxg/cli-ui 0.6.2 → 0.6.6

package/src/chat/draft.ts

@@ -0,0 +1,41 @@
+import { useSyncExternalStore } from "react";
+import type { TextBlock } from "../core/blocks";
+export type PendingFile = { key: string; name: string; status: "reading" | "error"; error?: string };
+export interface ComposerDraft { text: string; blocks: Array<TextBlock & { key: string }>; pending: PendingFile[]; sending: boolean; error: string | null; revision: number }
+const empty = (): ComposerDraft => ({ text: "", blocks: [], pending: [], sending: false, error: null, revision: 0 });
+const server = empty();
+const entries = new Map<string, { state: ComposerDraft; stamp: string }>();
+const listeners = new Set<() => void>();
+const textKey = (id: string) => `cli-ui:draft:${id}`;
+const dataKey = (id: string) => `${textKey(id)}:data`;
+const stamp = (id: string) => { try { return JSON.stringify([localStorage.getItem(textKey(id)), localStorage.getItem(dataKey(id))]); } catch { return ""; } };
+export function readComposerDraft(id: string): ComposerDraft {
+  const stored = stamp(id), cached = entries.get(id);
+  if (cached?.stamp === stored) return cached.state;
+  let state = empty();
+  try {
+    state.text = localStorage.getItem(textKey(id)) ?? "";
+    const data = JSON.parse(localStorage.getItem(dataKey(id)) ?? "null");
+    if (data?.version === 1) {
+      state.blocks = Array.isArray(data.blocks) ? data.blocks.filter((b: TextBlock & { key: string }) => typeof b?.text === "string" && typeof b?.key === "string") : [];
+      state.pending = Array.isArray(data.pending) ? data.pending.map((p: PendingFile) => ({ ...p, status: "error", error: p.error || "页面重载中断了解析，请移除后重新添加" })) : [];
+    }
+  } catch { /* Old text drafts and restricted storage remain usable. */ }
+  entries.set(id, { state, stamp: stored });
+  return state;
+}
+export function updateComposerDraft(id: string, update: (state: ComposerDraft) => ComposerDraft) {
+  const previous = readComposerDraft(id);
+  const state = { ...update(previous), revision: previous.revision + 1 };
+  try {
+    if (state.text) localStorage.setItem(textKey(id), state.text); else localStorage.removeItem(textKey(id));
+    if (state.blocks.length || state.pending.length) localStorage.setItem(dataKey(id), JSON.stringify({ version: 1, blocks: state.blocks, pending: state.pending })); else localStorage.removeItem(dataKey(id));
+  } catch { /* Keep the in-memory draft even if storage is full. */ }
+  entries.set(id, { state, stamp: stamp(id) });
+  listeners.forEach(listener => listener());
+  return state;
+}
+export function useComposerDraft(id: string) {
+  return useSyncExternalStore(listener => { listeners.add(listener); return () => listeners.delete(listener); }, () => readComposerDraft(id), () => server);
+}
+export function clearComposerDraft(id: string) { updateComposerDraft(id, () => empty()); }

package/src/chat/export.ts

@@ -1,5 +1,5 @@
-import type { CenterTurn, Msg } from "../core/types.js";
-import { toolDataOf } from "../ui/transcriptModel.js";
+import type { CenterTurn, Msg } from "../core/types";
+import { toolDataOf } from "../ui/transcriptModel";
 
 /** 把对话过程导出成 Markdown 下载（对应 Operator 的「导出执行过程」，这里在前端用已加载的转录生成）。 */
 export function buildMarkdown(title: string, jobId: string, messages: Msg[], turns: CenterTurn[]): string {

package/src/components.tsx

@@ -0,0 +1,13 @@
+import type { ComponentProps } from "react";
+import { CliMsgList as CenterMsgList, type CliMsgListProps as CenterMsgListProps } from "./msglist/CliMsgList";
+import { CliChat as CenterChat, type CliChatProps as CenterChatProps } from "./chat/CliChat";
+import { CliBoard as CenterBoard, type CliBoardProps as CenterBoardProps } from "./board/CliBoard";
+import { TasksColumn } from "./operator/node/TasksColumn";
+import { SessionView } from "./operator/node/SessionView";
+import { SessionRail } from "./operator/node/SessionRail";
+export interface CliMsgListProps extends CenterMsgListProps { operator?: ComponentProps<typeof TasksColumn> }
+export interface CliChatProps extends CenterChatProps { operator?: ComponentProps<typeof SessionView> }
+export interface CliBoardProps extends CenterBoardProps { operator?: ComponentProps<typeof SessionRail> }
+export function CliMsgList(props: CliMsgListProps) { return props.operator ? <TasksColumn {...props.operator}/> : <CenterMsgList {...props}/>; }
+export function CliChat(props: CliChatProps) { return props.operator ? <SessionView {...props.operator} board={{...props.operator.board,autoContext:props.operator.board?.autoContext??props.passiveContext,onFilesChange:props.operator.board?.onFilesChange??props.onFilesChange,onFilesWatch:props.operator.board?.onFilesWatch??props.onFilesWatch,onBoardContextChange:props.operator.board?.onBoardContextChange??props.onBoardContextChange}}/> : <CenterChat {...props}/>; }
+export function CliBoard(props: CliBoardProps) { return props.operator ? <SessionRail key={props.operator.task.id} {...props.operator} tabs={props.operator.tabs ?? props.tabs} availableTabs={props.operator.availableTabs ?? props.availableTabs} defaultTab={props.operator.defaultTab ?? props.defaultTab} autoContext={props.operator.autoContext ?? props.autoQuoteOpenFile} watchFiles={props.operator.watchFiles ?? props.watchFiles} fileWatchIntervalMs={props.operator.fileWatchIntervalMs ?? props.fileWatchIntervalMs} onFilesChange={props.operator.onFilesChange ?? props.onFilesChange} onFilesWatch={props.operator.onFilesWatch ?? props.onFilesWatch} onBoardContextChange={props.operator.onBoardContextChange ?? props.onBoardContextChange} onEvent={props.operator.onEvent ?? props.onEvent}/> : <CenterBoard {...props}/>; }

package/src/core/blocks.ts

@@ -12,7 +12,7 @@
  * 对 Agent 来说这也是清楚的分隔：哪段是附件、叫什么、在哪结束。
  */
 
-import { decodeText } from "./textDecode.js";
+import { decodeText } from "./textDecode";
 
 export interface TextBlock {
   /** 显示名：文件名，粘贴的文字为「粘贴的文本」。 */
@@ -48,16 +48,16 @@ export function backgroundBlock(items: Array<{ title?: string; text: string }>):
   return { name: BACKGROUND_NAME, kind: "background", text: `以下是补充的项目背景信息，请在这次及之后的工作中一并参考：\n\n${body}` };
 }
 
-/** 支持的文件：只收文档——Word（.docx）、Excel（.xlsx / .xlsm）、Markdown、TXT、HTML、CSV / TSV。都在浏览器里转成文字。 */
-export const ACCEPTED_EXTENSIONS = [".docx", ".xlsx", ".xlsm", ".md", ".markdown", ".txt", ".html", ".htm", ".csv", ".tsv"] as const;
+/** 支持的文件：只收文档——Word（.docx）、Excel（.xlsx / .xlsm）、Markdown、TXT、YAML、HTML、CSV / TSV。都在浏览器里转成文字。 */
+export const ACCEPTED_EXTENSIONS = [".docx", ".xlsx", ".xlsm", ".md", ".markdown", ".txt", ".yaml", ".yml", ".html", ".htm", ".csv", ".tsv"] as const;
 export const ACCEPT_ATTR = [
   ...ACCEPTED_EXTENSIONS,
-  "text/plain", "text/markdown", "text/html", "text/csv", "text/tab-separated-values",
+  "text/plain", "text/markdown", "text/yaml", "application/yaml", "text/html", "text/csv", "text/tab-separated-values",
   "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
   "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet", "application/vnd.ms-excel.sheet.macroEnabled.12",
 ].join(",");
 /** 不支持时提示里列的格式。 */
-export const ACCEPTED_LABEL = "Word（.docx）、Excel（.xlsx）、Markdown、TXT、HTML、CSV";
+export const ACCEPTED_LABEL = "Word（.docx）、Excel（.xlsx）、Markdown、TXT、YAML（.yaml / .yml）、HTML、CSV";
 /** 一些常见但读不了的文档：给出另存为什么。 */
 const SAVE_AS: Record<string, string> = {
   ".doc": "老版 Word（.doc）请另存为 .docx 后再上传",
@@ -72,6 +72,8 @@ export const PASTE_BLOCK_CHARS = 2_000;
 export const PASTE_BLOCK_LINES = 40;
 /** center 单条消息上限（POST /api/jobs/:id/messages 的 text 最长 200,000 字符）。 */
 export const MAX_MESSAGE_CHARS = 200_000;
+/** Same source-file budget as the full node composer; reject before reading/parsing. */
+export const MAX_DOCUMENT_BYTES = 10 * 1024 * 1024;
 export const PASTE_NAME = "粘贴的文本";
 
 const OPEN = /^----- 附件：(.+?)（[\d,]+ 字）-----$/;
@@ -138,11 +140,18 @@ export class FileReadError extends Error {}
  * 其他文件（图片、PDF、压缩包……）不收；老版 .doc / .xls 浏览器里读不了，提示另存为。
  */
 export async function readFileText(file: File): Promise<string> {
+  if (file.size > MAX_DOCUMENT_BYTES) throw new FileReadError(`“${file.name}”超过 10 MB，请缩小后重试。`);
+  const text = await extractFileText(file);
+  if (text.length > MAX_MESSAGE_CHARS) throw new FileReadError(`“${file.name}”解析后的正文超过 ${MAX_MESSAGE_CHARS.toLocaleString("en-US")} 字符，请拆分后重试。`);
+  return text;
+}
+
+async function extractFileText(file: File): Promise<string> {
   const ext = extensionOf(file.name);
   if (SAVE_AS[ext]) throw new FileReadError(`不支持这种格式：${SAVE_AS[ext]}`);
   if (!(ACCEPTED_EXTENSIONS as readonly string[]).includes(ext)) throw new FileReadError(`「${file.name}」不是支持的文档，只能上传 ${ACCEPTED_LABEL}`);
   if (ext === ".xlsx" || ext === ".xlsm") {
-    const { readXlsx, sheetsToText } = await import("./xlsx.js");
+    const { readXlsx, sheetsToText } = await import("./xlsx");
     try {
       return normalizeText(sheetsToText(await readXlsx(await readAs(file, "buffer"))));
     } catch {
@@ -165,6 +174,8 @@ export async function readFileText(file: File): Promise<string> {
     }
   }
   const { text } = decodeText(new Uint8Array(await readAs(file, "buffer")));
+  // YAML literal scalars depend on blank lines, indentation and the final newline.
+  if (ext === ".yaml" || ext === ".yml") return text;
   if (ext === ".html" || ext === ".htm") return normalizeText(text.replace(INLINE_DATA, (m) => `${m.slice(0, m.indexOf(",") + 1)}…（内嵌数据已省略）`));
   return normalizeText(text);
 }

package/src/core/callbacks.ts

@@ -0,0 +1,8 @@
+/** A host subscriber must not interrupt state updates or another subscriber. */
+export function notifyCallback<T>(callback: ((value: T) => unknown) | undefined, value: T): void {
+  const report = (error: unknown) => console.error("[@spzxg/cli-ui] subscriber callback failed", error);
+  try {
+    const result = callback?.(value);
+    if (result && typeof (result as PromiseLike<unknown>).then === "function") void Promise.resolve(result).catch(report);
+  } catch (error) { report(error); }
+}

package/src/core/client.ts

@@ -1,10 +1,10 @@
-import { createSseParser } from "./sse.js";
-import { NEW_TASK, parseConvKey } from "./conversation.js";
+import { createSseParser } from "./sse";
+import { NEW_TASK, parseConvKey } from "./conversation";
 import type {
   BoardInfo, BrowserMessage, BrowserStatus, CenterJob, CenterTask, CenterTurn, DiffResult, DirListing, FileInfo, Message,
-  BatchStreamSnapshot, BrowserFramesState, NewConversationOptions, SendResult, StreamEnd, StreamItem, StreamSnapshot,
-} from "./types.js";
-import { decodeText } from "./textDecode.js";
+  BatchStreamSnapshot, BrowserFramesState, NewConversationOptions, SendResult, StreamEnd, StreamItem, StreamSnapshot, WorkspaceFileBatch,
+} from "./types";
+import { decodeText } from "./textDecode";
 
 /**
  * center 服务（cli-task-center）对话任务接口的浏览器端客户端。组件的数据全部从这里来。
@@ -78,6 +78,11 @@ const ERROR_TEXT: Record<string, string> = {
   task_already_finished: "当前子任务已经结束，请刷新状态后继续",
   task_not_paused: "当前子任务没有暂停，请刷新状态后重试",
   job_already_paused: "整个任务已暂停，请先恢复整个任务",
+  file_watch_unsupported: "当前服务不支持文件事件",
+  browser_required: "传递浏览器 YAML 手册或操作间隔时，需要同时启用 browser: true",
+  invalid_browser_playbook: "浏览器 YAML 手册校验失败，请检查格式和步骤配置",
+  invalid_browser_pacing: "浏览器操作间隔无效，请检查最小值和最大值",
+  conversation_browser_fields_fixed: "浏览器手册和操作间隔在创建对话时确定，追加消息不能修改",
 };
 
 /**
@@ -141,6 +146,8 @@ export interface BoardBackend {
   /** fileUrl 给出的地址浏览器能直接打开（不需要额外请求头）。false 时看板先 fetch 再显示。 */
   directLinks: boolean;
   info(jobId: string): Promise<BoardInfo>;
+  /** 精准文件事件流；没有时组件明确降级为目录快照比对。 */
+  watchFiles?(jobId: string, handlers: { onEvent: (event: import("./types").WorkspaceFileBatch) => void; onClose: (error: CenterError | null) => void }): () => void;
   /** 目录（缺省根目录）或文件的信息。 */
   stat(jobId: string, path?: string): Promise<DirListing | FileInfo>;
   /** 文件地址（给 <img> / <iframe> / 下载链接用）。相对路径用路径式地址，HTML 里的相对资源能跟着解析。 */
@@ -156,12 +163,12 @@ export interface BoardBackend {
    * tail = 读末尾那一段（超大日志）；节点不支持只读一段时退回开头（返回的 tail 为 false）。
    * 不是 UTF-8 的（GBK 导出的 CSV 之类）按 GB18030 解，encoding 说明按什么解的。
    */
-  readText(jobId: string, path: string, maxBytes?: number, opts?: { tail?: boolean; onBytes?: (bytes: number) => void }): Promise<TextChunk>;
+  readText(jobId: string, path: string, maxBytes?: number, opts?: { tail?: boolean; signal?: AbortSignal; onBytes?: (bytes: number) => void }): Promise<TextChunk>;
   /**
    * 读一段原始字节：从 start 开始（缺省 0）最多 maxBytes；tail = 末尾 maxBytes。返回这段在文件里的起点和文件总大小。
    * 看板用它在文件变长时只取新增的部分（日志、还在写的报告），不整个重读。没有这个方法的后端每次整个重读。
    */
-  readBytes?(jobId: string, path: string, opts: { start?: number; maxBytes: number; tail?: boolean; onBytes?: (bytes: number) => void }): Promise<ByteChunk>;
+  readBytes?(jobId: string, path: string, opts: { start?: number; maxBytes: number; tail?: boolean; signal?: AbortSignal; onBytes?: (bytes: number) => void }): Promise<ByteChunk>;
   /**
    * 读整个文件。signal 取消（打包下载点了取消）；onBytes 报已收到的字节数（大文件显示进度）。
    * 弱网：FILE_HEADER_TIMEOUT_MS 内没回响应头、或传输中 FILE_STALL_MS 没收到数据，按网络错误（NETWORK）失败。
@@ -171,7 +178,7 @@ export interface BoardBackend {
   browserStatus(jobId: string): Promise<BrowserStatus>;
   browserAction(jobId: string, action: "open" | "close" | "takeover" | "handback"): Promise<BrowserStatus>;
   /** 浏览器状态实时流；返回停止函数。onClose 在断开时调用（error 为 null 表示正常结束）。 */
-  browserEvents(jobId: string, handlers: { onStatus: (status: BrowserStatus) => void; onClose?: (error: CenterError | null) => void }): () => void;
+  browserEvents(jobId: string, handlers: { onStatus: (status: BrowserStatus) => void; onClose?: (error: CenterError | null) => void; /** Recoverable transport disruption; subscription remains active. */ onError?: (error: CenterError) => void }): () => void;
   /** 浏览器实时画面；onViewer 给出发输入要用的 viewer id。 */
   browserFrames(jobId: string, handlers: { onViewer: (viewer: string) => void; onMessage: (message: BrowserMessage) => void; onEnd?: (end: { reason: string; detail?: string }) => void; onClose?: (error: CenterError | null) => void }): () => void;
   browserInput(jobId: string, viewer: string, events: Array<Record<string, unknown>>): Promise<void>;
@@ -323,7 +330,9 @@ export function createCenterClient(options: CenterClientOptions = {}): Conversat
           ...(opts.businessId ? { business_id: opts.businessId } : {}),
           ...(opts.agent ? { agent: opts.agent } : {}),
           ...(opts.timeoutSeconds ? { timeout_seconds: opts.timeoutSeconds } : {}),
-          ...(opts.browser ? { browser: true } : {}),
+          ...(opts.browser !== undefined ? { browser: opts.browser } : {}),
+          ...(opts.browserPlaybook !== undefined ? { browser_playbook: opts.browserPlaybook } : {}),
+          ...(opts.browserPacing !== undefined ? { browser_pacing: opts.browserPacing } : {}),
         }],
       });
     },
@@ -463,6 +472,13 @@ function openSse(
     try {
       arm();
       const response = await doFetch(url, { headers: { ...headers, Accept: "text/event-stream" }, signal: ctl.signal });
+      // A host-supplied fetch may resolve after cancellation despite signal.
+      // Retire its body before acquiring a reader or restarting the watchdog.
+      if (ctl.signal.aborted) {
+        void response.body?.cancel().catch(() => undefined);
+        if (silent) onClose?.(new CenterError("连接长时间没有数据，已断开重连", "NETWORK", 0));
+        return;
+      }
       if (!response.ok || !response.body) {
         const body = (await response.json().catch(() => null)) as { error?: string; detail?: string } | null;
         throw new CenterError(body?.detail ?? ERROR_TEXT[body?.error ?? ""] ?? `连接失败（HTTP ${response.status}）`, body?.error ?? `HTTP_${response.status}`, response.status);
@@ -518,6 +534,31 @@ function boardPath(key: string, rest: string, query = "") {
   return `/api/jobs/${job}/${rest}${params ? `?${params}` : ""}`;
 }
 
+/** Reject a malformed manifest as a whole: silently dropping entries could invent deletions. */
+function isWorkspaceFileBatch(value: unknown): value is WorkspaceFileBatch {
+  if (!value || typeof value !== "object") return false;
+  const batch = value as Record<string, unknown>;
+  if (typeof batch.complete !== "boolean" || (batch.revision !== undefined && typeof batch.revision !== "string")) return false;
+  const file = (value: unknown) => {
+    if (!value || typeof value !== "object") return false;
+    const entry = value as Record<string, unknown>;
+    return typeof entry.name === "string" && typeof entry.path === "string" && !!entry.path
+      && (entry.type === "file" || entry.type === "dir")
+      && typeof entry.size === "number" && Number.isFinite(entry.size) && entry.size >= 0
+      && typeof entry.mtime === "number" && Number.isFinite(entry.mtime)
+      && (entry.changeToken === undefined || typeof entry.changeToken === "string");
+  };
+  if (batch.type === "snapshot") return Array.isArray(batch.files) && batch.files.every(file);
+  if (batch.type === "resync") return batch.complete === false && typeof batch.reason === "string";
+  return batch.type === "changes" && Array.isArray(batch.changes) && batch.changes.every(value => {
+    if (!value || typeof value !== "object") return false;
+    const change = value as Record<string, unknown>;
+    return ["created", "modified", "deleted"].includes(String(change.kind)) && typeof change.path === "string" && !!change.path
+      && (change.file === undefined || (file(change.file) && (change.file as { path: string }).path === change.path))
+      && (change.previous === undefined || (file(change.previous) && (change.previous as { path: string }).path === change.path));
+  });
+}
+
 function createBoardClient(
   base: string,
   headers: (extra?: Record<string, string>) => Record<string, string>,
@@ -546,7 +587,11 @@ function createBoardClient(
         if (ctl.signal.aborted) reject(new DOMException("aborted", "AbortError"));
         ctl.signal.addEventListener("abort", () => reject(new DOMException("aborted", "AbortError")), { once: true });
       });
-      response = await Promise.race([doFetch(boardFileUrl(base, jobId, path), { headers: headers(extra), signal: ctl.signal }), stopped]);
+      const fetching = doFetch(boardFileUrl(base, jobId, path), { headers: headers(extra), signal: ctl.signal, cache: "no-store" });
+      // Host fetch adapters can ignore abort. Dispose a response that arrives
+      // after the caller already cancelled or timed out.
+      void fetching.then(late => { if (ctl.signal.aborted) void late.body?.cancel().catch(() => undefined); }, () => undefined);
+      response = await Promise.race([fetching, stopped]);
     } catch (error) {
       release();
       if (signal?.aborted) throw aborted();
@@ -554,21 +599,19 @@ function createBoardClient(
       throw new CenterError(`连不上任务中心：${error instanceof Error ? error.message : String(error)}`, "NETWORK", 0);
     }
     clearTimeout(timer);
-    if (!response.ok && response.status !== 416) {
-      release();
-      const body = (await response.json().catch(() => null)) as { error?: string; detail?: string } | null;
-      const fallback = response.status === 404 ? "文件不存在（可能已被任务删除或改名）" : body?.error ?? `读取失败（HTTP ${response.status}）`;
-      throw new CenterError(body?.detail ?? ERROR_TEXT[body?.error ?? ""] ?? fallback, body?.error ?? `HTTP_${response.status}`, response.status);
-    }
     const stallError = () => new CenterError(`读取「${name}」时 ${FILE_STALL_MS / 1000} 秒没有收到数据，传输已中断，请重试`, "NETWORK", 0);
     /** 读响应体：limit 读够就停；onBytes 报进度；FILE_STALL_MS 没数据当断线。 */
     const body = async (opts: { limit?: number; onBytes?: (bytes: number) => void } = {}): Promise<Uint8Array<ArrayBuffer>> => {
+      if (signal?.aborted) { release(); void response.body?.cancel().catch(() => undefined); throw aborted(); }
       // 空文件要「前 N 字节」：节点回 416，就是空的。
       if (response.status === 416) { release(); return new Uint8Array(0); }
       const reader = response.body?.getReader();
       if (!reader) {
         try { return new Uint8Array(await response.arrayBuffer()); } finally { release(); }
       }
+      const cancelBody = () => { void reader.cancel().catch(() => undefined); };
+      ctl.signal.addEventListener("abort", cancelBody, { once: true });
+      if (ctl.signal.aborted) cancelBody();
       const chunks: Uint8Array[] = [];
       let got = 0;
       let stalled = false;
@@ -596,6 +639,11 @@ function createBoardClient(
         throw new CenterError(`读取「${name}」中断：${error instanceof Error ? error.message : String(error)}`, "NETWORK", 0);
       } finally {
         clearTimeout(stall);
+        ctl.signal.removeEventListener("abort", cancelBody);
+        // Progress callbacks may throw too; no abandoned response should keep
+        // consuming the mobile connection after the read has failed.
+        void reader.cancel().catch(() => undefined);
+        try { reader.releaseLock(); } catch { /* already released */ }
         release();
       }
       if (signal?.aborted) throw aborted();
@@ -610,16 +658,25 @@ function createBoardClient(
       }
       return all;
     };
+    if (!response.ok && response.status !== 416) {
+      // Error bodies need the same abort/stall bounds as file data. A proxy
+      // returning 401 headers and then hanging must not park a read forever.
+      const bytes = await body({ limit: 8192 });
+      let problem: { error?: string; detail?: string } | null = null;
+      try { problem = JSON.parse(new TextDecoder().decode(bytes)); } catch { /* use the HTTP fallback */ }
+      const fallback = response.status === 404 ? "文件不存在（可能已被任务删除或改名）" : problem?.error ?? `读取失败（HTTP ${response.status})`;
+      throw new CenterError(problem?.detail ?? ERROR_TEXT[problem?.error ?? ""] ?? fallback, problem?.error ?? `HTTP_${response.status}`, response.status);
+    }
     return { response, body };
   };
   /**
    * 读一段：开头 / 从 start 起 maxBytes，或者末尾 maxBytes（超大日志）。只向中枢要这一段（Range）；
    * 不支持 Range 的节点回整个文件（200），这里边读边截，大文件不整个拉进浏览器。
    */
-  const readRange = async (jobId: string, path: string, opts: { start?: number; maxBytes: number; tail?: boolean; onBytes?: (bytes: number) => void }) => {
+  const readRange = async (jobId: string, path: string, opts: { start?: number; maxBytes: number; tail?: boolean; signal?: AbortSignal; onBytes?: (bytes: number) => void }) => {
     const from = Math.max(0, opts.start ?? 0);
     const { maxBytes } = opts;
-    const { response, body } = await fileFetch(jobId, path, { Range: opts.tail ? `bytes=-${maxBytes}` : `bytes=${from}-${from + maxBytes - 1}` });
+    const { response, body } = await fileFetch(jobId, path, { Range: opts.tail ? `bytes=-${maxBytes}` : `bytes=${from}-${from + maxBytes - 1}` }, opts.signal);
     const contentType = response.headers.get("content-type") ?? "text/plain";
     const total = /\/(\d+)\s*$/.exec(response.headers.get("content-range") ?? "")?.[1];
     // 416：要的起点不在文件里（空文件，或文件变短了）。
@@ -644,6 +701,33 @@ function createBoardClient(
   return {
     directLinks,
     info: (jobId) => request<BoardInfo>(boardPath(jobId, "board")),
+    watchFiles(jobId, handlers) {
+      let active = true;
+      let stop: () => void = () => {};
+      const close = (error: CenterError | null) => {
+        if (!active) return;
+        active = false; stop(); handlers.onClose(error);
+      };
+      const fetchStream: typeof fetch = async (input, init) => {
+        const response = await doFetch(input, init);
+        if (response.ok && !/^text\/event-stream(?:\s*;|$)/i.test(response.headers.get("content-type") ?? "")) {
+          await response.body?.cancel().catch(() => undefined);
+          throw new CenterError("文件事件接口未返回事件流，请检查服务代理配置", "INVALID_RESPONSE", 502);
+        }
+        return response;
+      };
+      stop = openSse(fetchStream, `${base}${boardPath(jobId, "files/events")}`, headers(), (event, data) => {
+        if (!active) return;
+        if (event === "files" || event === "message") {
+          if (!isWorkspaceFileBatch(data)) { close(new CenterError("文件事件数据不完整，正在重新同步", "INVALID_RESPONSE", 502)); return; }
+          handlers.onEvent(data);
+        } else if (event === "end") {
+          const end = data && typeof data === "object" ? data as Record<string, unknown> : {};
+          close(new CenterError(typeof end.detail === "string" ? end.detail : "文件监听连接中断，正在重连", typeof end.reason === "string" ? end.reason : "NETWORK", typeof end.status === "number" ? end.status : 0));
+        }
+      }, close);
+      return () => { active = false; stop(); };
+    },
     stat: (jobId, path = ".") => request<DirListing | FileInfo>(boardPath(jobId, "files", `path=${encodeURIComponent(path)}`)),
     fileUrl: (jobId, path, opts = {}) => boardFileUrl(base, jobId, path, opts.download),
     async fileLinkBase(jobId) {
@@ -667,7 +751,7 @@ function createBoardClient(
       return work;
     },
     async readText(jobId, path, maxBytes = 512 * 1024, opts = {}) {
-      const { bytes, start, size, contentType } = await readRange(jobId, path, { maxBytes, tail: opts.tail, onBytes: opts.onBytes });
+      const { bytes, start, size, contentType } = await readRange(jobId, path, { maxBytes, tail: opts.tail, signal: opts.signal, onBytes: opts.onBytes });
       if (!size && !bytes.length) return { text: "", truncated: false, size: 0, contentType };
       const { text, encoding } = decodeText(bytes, { fromMiddle: start > 0 });
       return { text, truncated: bytes.length < size, size, contentType, tail: start > 0, encoding };

package/src/core/conversation.ts

@@ -6,9 +6,9 @@
  *   · 节点转录（transcript + node 事件）：Agent 实际的对话过程，规则与 Operator 的 useTaskStream 一致。
  * 界面以节点转录为主；转录还没有（没派发、节点连不上）时用轮次的 input / reply 兜底。
  */
-import { isBatchSnapshot, type AskAnswers, type AskQuestion, type BatchStreamSnapshot, type BatchStreamTask, type CenterTurn, type ConversationClosedCallback, type ConversationTurnCallback, type JobStatus, type Message, type Msg, type NodeEvent, type StreamItem, type StreamSnapshot, type StreamTask, type ToolData, type TurnUsage } from "./types.js";
-import { indexFromEnd, mergeSnapshot, prependOlder, toolDataOf } from "../ui/transcriptModel.js";
-import { formatAnswersText } from "../ui/format.js";
+import { isBatchSnapshot, type AskAnswers, type AskQuestion, type BatchStreamSnapshot, type BatchStreamTask, type CenterTurn, type ConversationClosedCallback, type ConversationTurnCallback, type JobStatus, type Message, type Msg, type NodeEvent, type StreamItem, type StreamSnapshot, type StreamTask, type ToolData, type TurnUsage } from "./types";
+import { indexFromEnd, mergeSnapshot, prependOlder, toolDataOf } from "../ui/transcriptModel";
+import { formatAnswersText } from "../ui/format";
 
 export const TERMINAL_TURN = new Set(["succeeded", "failed", "cancelled", "merged"]);
 export const ACTIVE_TURN = new Set(["queued", "dispatching", "running"]);
@@ -135,6 +135,7 @@ const batchStreamTask = (task: BatchStreamTask): StreamTask => ({
   // 对话式子任务跑完一条不算结束：还能接着聊。
   id: task.id, seq: task.seq, title: task.title, status: task.status, closed: !task.conversation && TERMINAL_TASK.has(task.status),
   remote_task_id: task.remote_task_id, continue_from_task_id: task.continue_from_task_id,
+  awaiting_input: task.awaiting_input, awaiting_input_observed_at: task.awaiting_input_observed_at,
 });
 
 /** 没指定子任务时看哪个：最近一个派发过的，都没派发过就是最后一个。 */

package/src/core/id.ts

@@ -0,0 +1,15 @@
+/** Correlation/draft IDs only: never use this fallback as a credential or token. */
+let sequence = 0;
+export function clientId(): string {
+  try { if (typeof globalThis.crypto?.randomUUID === 'function') return globalThis.crypto.randomUUID(); } catch { /* Fall back in restricted or insecure contexts. */ }
+  try {
+    if (typeof globalThis.crypto?.getRandomValues === 'function') {
+      const bytes = globalThis.crypto.getRandomValues(new Uint8Array(16));
+      bytes[6] = (bytes[6] & 0x0f) | 0x40;
+      bytes[8] = (bytes[8] & 0x3f) | 0x80;
+      const hex = Array.from(bytes, value => value.toString(16).padStart(2, '0')).join('');
+      return `${hex.slice(0,8)}-${hex.slice(8,12)}-${hex.slice(12,16)}-${hex.slice(16,20)}-${hex.slice(20)}`;
+    }
+  } catch { /* Drafts still work when Web Crypto is unavailable. */ }
+  return `${Date.now().toString(36)}-${(++sequence).toString(36)}-${Math.random().toString(36).slice(2,10)}`;
+}

package/src/core/identity.ts

@@ -0,0 +1,33 @@
+import type { CenterClientOptions } from './client';
+import { clientId } from './id';
+// A synchronous SHA-256 fingerprint partitions persistent drafts without putting
+// credentials in localStorage keys. It is never used for authentication.
+const K = [0x428a2f98,0x71374491,0xb5c0fbcf,0xe9b5dba5,0x3956c25b,0x59f111f1,0x923f82a4,0xab1c5ed5,0xd807aa98,0x12835b01,0x243185be,0x550c7dc3,0x72be5d74,0x80deb1fe,0x9bdc06a7,0xc19bf174,0xe49b69c1,0xefbe4786,0x0fc19dc6,0x240ca1cc,0x2de92c6f,0x4a7484aa,0x5cb0a9dc,0x76f988da,0x983e5152,0xa831c66d,0xb00327c8,0xbf597fc7,0xc6e00bf3,0xd5a79147,0x06ca6351,0x14292967,0x27b70a85,0x2e1b2138,0x4d2c6dfc,0x53380d13,0x650a7354,0x766a0abb,0x81c2c92e,0x92722c85,0xa2bfe8a1,0xa81a664b,0xc24b8b70,0xc76c51a3,0xd192e819,0xd6990624,0xf40e3585,0x106aa070,0x19a4c116,0x1e376c08,0x2748774c,0x34b0bcb5,0x391c0cb3,0x4ed8aa4a,0x5b9cca4f,0x682e6ff3,0x748f82ee,0x78a5636f,0x84c87814,0x8cc70208,0x90befffa,0xa4506ceb,0xbef9a3f7,0xc67178f2];
+const rotate = (x:number,n:number)=>(x>>>n)|(x<<(32-n));
+export function connectionFingerprint(text:string):string {
+ const raw=new TextEncoder().encode(text),data=new Uint8Array(Math.ceil((raw.length+9)/64)*64);data.set(raw);data[raw.length]=128;
+ const view=new DataView(data.buffer);view.setUint32(data.length-8,Math.floor(raw.length/0x20000000));view.setUint32(data.length-4,(raw.length*8)>>>0);
+ const hash=[0x6a09e667,0xbb67ae85,0x3c6ef372,0xa54ff53a,0x510e527f,0x9b05688c,0x1f83d9ab,0x5be0cd19],w=new Int32Array(64);
+ for(let offset=0;offset<data.length;offset+=64){
+  for(let i=0;i<16;i++)w[i]=view.getInt32(offset+i*4);
+  for(let i=16;i<64;i++){const x=w[i-15],y=w[i-2];w[i]=(w[i-16]+(rotate(x,7)^rotate(x,18)^(x>>>3))+w[i-7]+(rotate(y,17)^rotate(y,19)^(y>>>10)))|0;}
+  let [a,b,c,d,e,f,g,h]=hash;
+  for(let i=0;i<64;i++){const t1=(h+(rotate(e,6)^rotate(e,11)^rotate(e,25))+((e&f)^(~e&g))+K[i]+w[i])|0,t2=((rotate(a,2)^rotate(a,13)^rotate(a,22))+((a&b)^(a&c)^(b&c)))|0;
+   h=g;g=f;f=e;e=(d+t1)|0;d=c;c=b;b=a;a=(t1+t2)|0;}
+  [a,b,c,d,e,f,g,h].forEach((value,i)=>{hash[i]=(hash[i]+value)|0;});
+ }
+ return hash.map(value=>(value>>>0).toString(16).padStart(8,'0')).join('');
+}
+const customScopes=new WeakMap<object,string>();
+export function connectionDraftScope(options:CenterClientOptions&{namespace?:string|null;client?:object}):string {
+ // Custom transports may hide cookies or credentials. Isolate by object identity
+ // rather than pretending their URL proves the account identity.
+ const headers = options.headers?.() ?? {};
+ const signature=JSON.stringify([options.baseUrl?.replace(/\/+$/,'')??'',options.token??'',options.line??'',options.namespace??'',Object.keys(headers).sort().map(key=>[key,headers[key]])]);
+ const transport=options.client;
+ if(transport){let scope=customScopes.get(transport);if(!scope){scope=clientId();customScopes.set(transport,scope);}return `custom-${scope}:${connectionFingerprint(signature)}`;}
+ // Preserve the historical default same-origin draft keys. Cookie-auth hosts
+ // must supply an account-specific namespace and remount after account changes.
+ if(!options.baseUrl&&!options.token&&!options.line&&!options.namespace&&!Object.keys(headers).length)return '';
+ return connectionFingerprint(signature);
+}

package/src/core/provider.tsx

@@ -1,6 +1,8 @@
-import { createContext, useContext, useEffect, useLayoutEffect, useMemo, useRef, useSyncExternalStore, type ReactNode } from "react";
-import { createCliStore, type CliEvent, type CliState, type CliStore, type CliStoreOptions } from "./store.js";
-import type { ConversationCallback, ConversationEndPayload, TurnEndPayload } from "./types.js";
+import { notifyCallback } from "./callbacks";
+import { Fragment, createContext, useContext, useEffect, useLayoutEffect, useMemo, useRef, useSyncExternalStore, type ReactNode } from "react";
+import { connectionDraftScope } from "./identity";
+import { createCliStore, cloneWorkspaceEvent, type CliEvent, type CliState, type CliStore, type CliStoreOptions } from "./store";
+import type { ConversationCallback, ConversationEndPayload, TurnEndPayload } from "./types";
 
 /**
  * 积木的拼接点。放在同一个 <CliCenterProvider> 里的组件共享一个仓库，切换时一起变：
@@ -36,7 +38,12 @@ export interface CliCenterProviderProps extends CliStoreOptions, ResultHandlers
  * 结果通知：组件从实时流里看到一轮结束 / 对话结束时调用，全在浏览器里发生，**和 center 的 callback.url 无关**——
  * 不配 callback 也照样会调。载荷字段与 center 回调体一致，方便业务后端和前端用同一套代码解析。
  */
-export interface ResultHandlers {
+export interface WorkspaceHandlers {
+  onFilesChange?: (event: import("./types").WorkspaceChangeEvent) => void;
+  onFilesWatch?: (event: import("./types").WorkspaceWatchStatus) => void;
+  onBoardContextChange?: (event: Extract<CliEvent,{type:"board_context"}>) => void;
+}
+export interface ResultHandlers extends WorkspaceHandlers {
   /** 一轮结束（成功 / 失败 / 取消）。 */
   onTurnEnd?: (payload: TurnEndPayload) => void;
   /** 对话结束（关闭 / 取消 / 过期……）。 */
@@ -46,11 +53,14 @@ export interface ResultHandlers {
 }
 
 export function dispatchResult(event: CliEvent, handlers: ResultHandlers) {
-  if (event.type === "conversation_turn") { handlers.onTurnEnd?.(event.payload); handlers.onCallback?.(event.payload); }
-  else if (event.type === "conversation_closed") { handlers.onConversationEnd?.(event.payload); handlers.onCallback?.(event.payload); }
+  if (event.type === "conversation_turn") { notifyCallback(handlers.onTurnEnd, event.payload); notifyCallback(handlers.onCallback, event.payload); }
+  else if (event.type === "conversation_closed") { notifyCallback(handlers.onConversationEnd, event.payload); notifyCallback(handlers.onCallback, event.payload); }
+  else if(event.type === "files_changed") notifyCallback(handlers.onFilesChange,event);
+  else if(event.type === "files_watch") notifyCallback(handlers.onFilesWatch,event);
+  else if(event.type === "board_context") notifyCallback(handlers.onBoardContextChange,event);
 }
 
-export function CliCenterProvider({ store: external, selectedId, onEvent, onTurnEnd, onConversationEnd, onCallback, children, ...options }: CliCenterProviderProps) {
+export function CliCenterProvider({ store: external, selectedId, onEvent, onTurnEnd, onConversationEnd, onCallback, onFilesChange, onFilesWatch, onBoardContextChange, children, ...options }: CliCenterProviderProps) {
   // 连接参数只在建仓库时用一次：中途换 baseUrl / token 请换 key 重建。
   const optionsRef = useRef(options);
   const applied = useRef<string | null | undefined>(undefined);
@@ -60,6 +70,13 @@ export function CliCenterProvider({ store: external, selectedId, onEvent, onTurn
     if (selectedId !== undefined) { created.select(selectedId); applied.current = selectedId; }
     return created;
   }, [external]); // eslint-disable-line react-hooks/exhaustive-deps
+  // Creation defaults can arrive after a file/configuration load. Update only
+  // these defaults on commit; the connection and workspace state stay stable.
+  useLayoutEffect(() => {
+    optionsRef.current.newConversation = options.newConversation;
+    optionsRef.current.createConversation = options.createConversation;
+    optionsRef.current.businessIdFor = options.businessIdFor;
+  }, [options.newConversation, options.createConversation, options.businessIdFor]);
   // 之后宿主改了 selectedId：一起切过去（在绘制前，免得闪一下旧的）。
   useLayoutEffect(() => {
     if (selectedId === undefined || selectedId === applied.current) return;
@@ -69,12 +86,12 @@ export function CliCenterProvider({ store: external, selectedId, onEvent, onTurn
   const onEventRef = useRef(onEvent);
   onEventRef.current = onEvent;
   const resultRef = useRef<ResultHandlers>({});
-  resultRef.current = { onTurnEnd, onConversationEnd, onCallback };
+  resultRef.current = { onTurnEnd, onConversationEnd, onCallback, onFilesChange, onFilesWatch, onBoardContextChange };
   useEffect(() => store.on((event) => {
-    onEventRef.current?.(event);
+    notifyCallback(onEventRef.current, cloneWorkspaceEvent(event));
     dispatchResult(event, resultRef.current);
   }), [store]);
-  return <StoreContext.Provider value={store}>{children}</StoreContext.Provider>;
+  return <StoreContext.Provider value={store}><Fragment key={store.draftScope}>{children}</Fragment></StoreContext.Provider>;
 }
 
 export function useCliStoreContext(): CliStore | null {
@@ -96,11 +113,11 @@ export function useCliState<T>(selector: (state: CliState) => T): T {
 /** 组件外面没有 Provider 时，用组件自己的 props 包一层。 */
 export function withOwnProvider<P extends object>(props: P & CliStoreOptions & ResultHandlers & { onEvent?: (event: CliEvent) => void; store?: CliStore }, inner: ReactNode, hasContext: boolean) {
   if (hasContext) return inner;
-  const { baseUrl, token, line, headers, fetch, client, namespace, newConversation, createConversation, businessIdFor, onEvent, onTurnEnd, onConversationEnd, onCallback, store } = props;
+  const { baseUrl, token, line, headers, fetch, client, namespace, newConversation, createConversation, businessIdFor, onEvent, onTurnEnd, onConversationEnd, onCallback, onFilesChange, onFilesWatch, onBoardContextChange, store } = props;
   // 连接参数变了（换了中枢地址、令牌、产品线、命名空间）就换一个新仓库重连，不沿用旧连接。
-  const connection = [baseUrl ?? "", token ?? "", line ?? "", namespace ?? ""].join("\u0000");
+  const connection = connectionDraftScope({baseUrl,token,line,namespace,headers,fetch,client});
   return (
-    <CliCenterProvider key={store ? "external" : connection} {...{ baseUrl, token, line, headers, fetch, client, namespace, newConversation, createConversation, businessIdFor, onEvent, onTurnEnd, onConversationEnd, onCallback, store }}>
+    <CliCenterProvider key={store ? "external" : connection} {...{ baseUrl, token, line, headers, fetch, client, namespace, newConversation, createConversation, businessIdFor, onEvent, onTurnEnd, onConversationEnd, onCallback, onFilesChange, onFilesWatch, onBoardContextChange, store }}>
       {inner}
     </CliCenterProvider>
   );
@@ -117,7 +134,7 @@ export function useComponentEvents(onEvent: ((event: CliEvent) => void) | undefi
   useEffect(() => {
     if (!enabled || !store) return;
     return store.on((event) => {
-      ref.current.onEvent?.(event);
+      notifyCallback(ref.current.onEvent, cloneWorkspaceEvent(event));
       dispatchResult(event, ref.current.results);
     });
   }, [store, enabled]);