@rexvane/piweb 0.3.24 → 0.3.26

package/src/components/side-chat/SideChatPanel.tsx

@@ -1,189 +0,0 @@
-"use client";
-
-import { useCallback, useEffect, useRef, useState, useSyncExternalStore } from "react";
-import dynamic from "next/dynamic";
-import { IconChevronDown14, IconCloseOutline14, IconNewChatOutline16, IconSendArrowUp14, IconStopFill16 } from "@/components/icons";
-import { ContextMeter } from "@/components/ContextMeter";
-import { ModelSelector, type ModelChoice } from "@/components/ModelSelector";
-import { useI18n } from "@/i18n";
-import { EMPTY_SIDE_CHAT, sideChatStore, type SideChatStore } from "./store";
-import styles from "./SideChatPanel.module.css";
-
-const Markdown = dynamic(() => import("@/components/MarkdownBlock").then((module) => module.MarkdownBlock));
-const StreamingMarkdown = dynamic(() => import("@/components/MarkdownBlock").then((module) => module.StreamingMarkdownBlock));
-
-export function SideChatPanel({ sessionId, ready = true, mainModel, models = [], providerNames = {}, authByProvider = {}, onClose, store = sideChatStore }: {
-	sessionId: string | null;
-	ready?: boolean;
-	mainModel?: { provider: string; id: string; name: string };
-	models?: ModelChoice[];
-	providerNames?: Record<string, string>;
-	authByProvider?: Record<string, boolean>;
-	onClose: () => void;
-	store?: SideChatStore;
-}) {
-	const { t } = useI18n();
-	const subscribe = useCallback((listener: () => void) => store.subscribe(sessionId, listener), [sessionId, store]);
-	const getSnapshot = useCallback(() => store.get(sessionId), [sessionId, store]);
-	const state = useSyncExternalStore(subscribe, getSnapshot, () => EMPTY_SIDE_CHAT);
-	const thread = state.threads.find((item) => item.id === state.currentThreadId);
-	const scrollRef = useRef<HTMLDivElement>(null);
-	const textareaRef = useRef<HTMLTextAreaElement>(null);
-	const pinned = useRef(true);
-	const lastTop = useRef(0);
-	const busy = Boolean(thread?.request);
-	const threadId = thread?.id;
-	/** 历史记录菜单是否展开 */
-	const [historyOpen, setHistoryOpen] = useState(false);
-	const historyRef = useRef<HTMLDivElement>(null);
-	const selectedModel = thread?.model
-		? models.find((model) => model.provider === thread.model!.provider && model.id === thread.model!.id) ?? { ...thread.model, name: thread.model.id }
-		: mainModel;
-	const canSend = Boolean(sessionId && ready && selectedModel);
-
-	useEffect(() => {
-		pinned.current = true;
-		lastTop.current = 0;
-		if (scrollRef.current) scrollRef.current.scrollTop = scrollRef.current.scrollHeight;
-	}, [sessionId, threadId]);
-	useEffect(() => {
-		const node = scrollRef.current;
-		if (!node) return;
-		const pin = () => { if (pinned.current) node.scrollTop = node.scrollHeight; };
-		const observer = new ResizeObserver(pin);
-		if (node.firstElementChild) observer.observe(node.firstElementChild);
-		pin();
-		return () => observer.disconnect();
-	}, [thread?.messages]);
-	useEffect(() => {
-		const textarea = textareaRef.current;
-		if (!textarea) return;
-		textarea.style.height = "auto";
-		textarea.style.height = `${Math.min(180, Math.max(64, textarea.scrollHeight))}px`;
-	}, [thread?.draft, threadId]);
-
-	// 历史记录菜单：点外部或 Esc 关掉（与圆环弹窗同一套做法）
-	useEffect(() => {
-		if (!historyOpen) return;
-		const onDown = (event: MouseEvent) => {
-			if (!historyRef.current?.contains(event.target as Node)) setHistoryOpen(false);
-		};
-		const onKey = (event: KeyboardEvent) => {
-			if (event.key === "Escape") setHistoryOpen(false);
-		};
-		document.addEventListener("mousedown", onDown);
-		document.addEventListener("keydown", onKey);
-		return () => {
-			document.removeEventListener("mousedown", onDown);
-			document.removeEventListener("keydown", onKey);
-		};
-	}, [historyOpen]);
-
-	// 上下文：这次问出去的真实 prompt（input + 缓存读写）对上该模型的窗口。
-	// 没有真实用量就一律 null —— 圆环显示「用量未知」，不编数字。
-	const usage = thread?.usage;
-	const contextTokens = usage ? usage.input + usage.cacheRead + usage.cacheWrite : null;
-	const contextWindow = thread?.contextWindow ?? null;
-	const contextPercent = contextTokens !== null && contextWindow ? (contextTokens / contextWindow) * 100 : null;
-
-	const send = () => {
-		if (!sessionId || !canSend || busy || !thread?.draft.trim()) return;
-		pinned.current = true;
-		store.send(sessionId);
-		textareaRef.current?.focus({ preventScroll: true });
-	};
-
-	return (
-		<section className={styles.panel} aria-label={t.sideChat} data-testid="side-chat-panel">
-			<header className={styles.header}>
-				<span className={styles.title}>{t.sideChat}</span>
-				<button type="button" className="icon-btn" aria-label={t.sideChatNew} title={t.sideChatNew} disabled={!sessionId} onClick={() => sessionId && store.createThread(sessionId)}>
-					<IconNewChatOutline16 size={16} />
-				</button>
-				<button type="button" className="icon-btn" aria-label={t.close} title={t.close} onClick={onClose}><IconCloseOutline14 size={14} /></button>
-			</header>
-			{state.threads.length > 1 && (
-				// 原生 select 在深色界面里是系统白底菜单（又丑又不跟主题），改用与模型选择器一致的浮层菜单
-				<div className={styles.history} ref={historyRef}>
-					<button type="button" className={styles.historyButton} aria-label={t.sideChatHistory} aria-haspopup="menu" aria-expanded={historyOpen} onClick={() => setHistoryOpen((open) => !open)}>
-						<span className="truncate">{thread ? `${thread.title || t.sideChatNew}${thread.request ? " · …" : ""}` : t.sideChatHistory}</span>
-						<IconChevronDown14 size={12} style={{ flex: "none", color: "var(--dsw-label-caption)" }} />
-					</button>
-					{historyOpen && (
-						<div className={styles.historyMenu} role="menu" aria-label={t.sideChatHistory}>
-							{[...state.threads].reverse().map((item) => (
-								<button key={item.id} type="button" role="menuitemradio" aria-checked={item.id === threadId} className={styles.historyItem}
-									onClick={() => { if (sessionId) store.selectThread(sessionId, item.id); setHistoryOpen(false); }}>
-									<span className="truncate">{item.title || t.sideChatNew}</span>
-									{item.request ? <span className={styles.historyMeta}>…</span> : null}
-								</button>
-							))}
-						</div>
-					)}
-				</div>
-			)}
-			<div className={styles.messages} ref={scrollRef} role="log" aria-label={t.sideChatMessages} aria-live="polite" aria-relevant="additions" onScroll={(event) => {
-				const node = event.currentTarget;
-				const distance = node.scrollHeight - node.scrollTop - node.clientHeight;
-				const movedUp = node.scrollTop < lastTop.current - 1 && distance > 2;
-				pinned.current = !movedUp && distance < 48;
-				lastTop.current = node.scrollTop;
-			}}>
-				<div className={styles.messageContent}>
-					{!thread?.messages.length ? (
-						<div className={styles.empty}>
-							<p>{sessionId ? t.sideChatEmpty : t.sideChatPickSession}</p>
-							{sessionId && <span>{t.sideChatHint}</span>}
-						</div>
-					) : thread.messages.map((message) => (
-						<div key={message.id} className={message.role === "user" ? styles.question : styles.answer} data-role={message.role}>
-							{message.role === "user" ? message.text : <>
-								{message.contextTruncated && <p className={styles.notice}>{t.sideChatContextTruncated}</p>}
-								{message.text && (message.status === "pending" ? <StreamingMarkdown text={message.text} /> : <Markdown text={message.text} />)}
-								{message.status === "pending" && !message.text && <span className={styles.waiting} role="status">{thread.connectionLost ? t.reconnecting : t.sideChatAnswering}</span>}
-								{message.error && <div className={styles.error} role="alert">{message.error}{message.status === "error" && message === thread.messages.at(-1) && <button type="button" disabled={busy} onClick={() => sessionId && store.send(sessionId, true)}>{t.retry}</button>}</div>}
-								{message.status === "aborted" && <p className={styles.notice}>{t.turnAborted}</p>}
-								{message.lengthLimited && <p className={styles.notice}>{t.sideChatLengthLimited}</p>}
-							</>}
-						</div>
-					))}
-				</div>
-			</div>
-			{state.storageFailed && <p className={styles.storageError} role="alert">{t.sideChatStorageFailed}</p>}
-			<form className={styles.composer} onSubmit={(event) => { event.preventDefault(); send(); }}>
-				<textarea ref={textareaRef} aria-label={t.sideChatQuestion} placeholder={sessionId ? t.sideChatPlaceholder : t.sideChatPickSession} value={thread?.draft ?? ""} disabled={!canSend}
-					onChange={(event) => sessionId && store.setDraft(sessionId, event.target.value)}
-					onKeyDown={(event) => {
-						if (event.key === "Enter" && !event.shiftKey && !event.nativeEvent.isComposing && event.nativeEvent.keyCode !== 229) { event.preventDefault(); send(); }
-					}} />
-				<div className={styles.actions}>
-					<div className={styles.model} role="group" aria-label={t.sideChatModel}>
-						<ModelSelector model={selectedModel} models={models} providerNames={providerNames} authByProvider={authByProvider}
-							modelOnly disabled={!sessionId} thinkingLevels={[]} onSelectLevel={() => {}}
-							defaultOption={{ label: t.sideChatFollowMain, selected: !thread?.model, onSelect: () => sessionId && store.setModel(sessionId) }}
-							onSelectModel={(provider, id) => sessionId && store.setModel(sessionId, { provider, id })} />
-					</div>
-					<div className={styles.meter}>
-						<ContextMeter
-							percent={contextPercent}
-							tokens={contextTokens}
-							contextWindow={contextWindow}
-							label={t.contextMeasured}
-							source={thread?.characters ? {
-								systemChars: 0,
-								messages: thread.messages.map((message) => ({ role: message.role, content: [{ type: "text", text: message.text }] })),
-								breakdown: {
-									characters: { systemPrompt: thread.characters.systemPrompt, background: thread.characters.background, systemTools: 0, customTools: 0, memory: 0, skills: 0, compacted: 0 },
-									systemPrompt: 0, systemTools: 0, customTools: 0, memory: 0, skills: 0, compacted: 0, autoCompactBuffer: 0,
-								},
-							} : undefined}
-							model={selectedModel ? { provider: selectedModel.provider, id: selectedModel.id } : null}
-						/>
-					</div>
-					{busy ? <button type="button" className={styles.send} title={t.stop} aria-label={t.stop} onClick={() => sessionId && store.stop(sessionId)}><IconStopFill16 size={15} /></button>
-						: <button type="submit" className={styles.send} title={t.send} aria-label={t.send} disabled={!canSend || !thread?.draft.trim()}><IconSendArrowUp14 size={16} /></button>}
-				</div>
-			</form>
-		</section>
-	);
-}

package/src/components/side-chat/icons.tsx

@@ -1,8 +0,0 @@
-import type { SVGProps } from "react";
-
-export function SideChatIcon({ size = 16, ...props }: SVGProps<SVGSVGElement> & { size?: number }) {
-	return <svg width={size} height={size} viewBox="0 0 20 20" fill="none" stroke="currentColor" strokeWidth="1.4" strokeLinecap="round" strokeLinejoin="round" aria-hidden="true" {...props}>
-		<path d="M12.5 11.5H6l-3.5 2V4.5A2 2 0 0 1 4.5 2.5h8a2 2 0 0 1 2 2v5a2 2 0 0 1-2 2Z" />
-		<path d="M7.5 14.5h6.5l3.5 2V7.5a2 2 0 0 0-1-1.73" />
-	</svg>;
-}

package/src/components/side-chat/request-history.ts

@@ -1,29 +0,0 @@
-import { SIDE_CHAT_BODY_LIMIT, SIDE_CHAT_HISTORY_LIMIT, SIDE_CHAT_TEXT_LIMIT, type SideChatHistoryMessage } from "@/lib/side-chat/types";
-
-/** Bound only the transmitted context; the browser retains the original transcript. */
-export function requestHistory(messages: SideChatHistoryMessage[]): { history: SideChatHistoryMessage[]; truncated: boolean } {
- const encoder = new TextEncoder();
- const history: SideChatHistoryMessage[] = [];
- // Reserve the other half for the question (including JSON escapes), model and envelope.
- let remaining = Math.floor(SIDE_CHAT_BODY_LIMIT / 2) - 2;
- let truncated = false;
- for (let i = messages.length - 1; i >= 0; i--) {
-  if (history.length === SIDE_CHAT_HISTORY_LIMIT) { truncated = true; break; }
-  const message = messages[i];
-  let text = message.text;
-  if (text.length > SIDE_CHAT_TEXT_LIMIT) {
-   text = text.slice(-SIDE_CHAT_TEXT_LIMIT);
-   if (/^[\uDC00-\uDFFF]/.test(text)) text = text.slice(1);
-   truncated = true;
-  }
-  const entry = { role: message.role, text };
-  const size = encoder.encode(JSON.stringify(entry)).byteLength + 1;
-  if (size > remaining) { truncated = true; break; }
-  remaining -= size;
-  history.push(entry);
- }
- history.reverse();
- // A retained transcript must begin with a question, not an orphaned answer.
- while (history[0]?.role === "assistant") { history.shift(); truncated = true; }
- return { history, truncated };
-}

package/src/components/side-chat/store.ts

@@ -1,248 +0,0 @@
-"use client";
-
-import { isSideChatId, isSideChatModel, type SideChatModel, type SideChatHistoryMessage, type SideChatProgress, type SideChatRequest, type SideChatUsage } from "@/lib/side-chat/types";
-
-import { requestHistory } from "./request-history";
-
-export interface SideChatMessage {
-	id: string;
-	role: "user" | "assistant";
-	text: string;
-	status?: "pending" | "done" | "error" | "aborted";
-	error?: string;
-	contextTruncated?: boolean;
-	lengthLimited?: boolean;
-}
-export interface SideChatThread {
-	id: string;
-	title: string;
-	messages: SideChatMessage[];
-	draft: string;
-	model?: SideChatModel;
-	request?: { id: string; revision: number };
-	/** 最近一次回答的真实用量与窗口：面板右下角的上下文环用它 */
-	usage?: SideChatUsage;
-	contextWindow?: number;
-	/** 这次上下文的真实字符分项（系统提示词 / 引用的主会话背景） */
-	characters?: { systemPrompt: number; background: number };
-	connectionLost?: boolean;
-}
-export interface SideChatState {
-	currentThreadId: string;
-	threads: SideChatThread[];
-	storageFailed: boolean;
-}
-export const EMPTY_SIDE_CHAT: SideChatState = { currentThreadId: "", threads: [], storageFailed: false };
-const PREFIX = "piweb.sidechat.v1.";
-
-class ApiError extends Error {
-	constructor(message: string, readonly status: number) { super(message); }
-}
-
-function pause(ms: number, signal: AbortSignal): Promise<void> {
-	return new Promise((resolve) => {
-		const finish = () => { clearTimeout(timer); signal.removeEventListener("abort", finish); resolve(); };
-		const timer = setTimeout(finish, ms);
-		signal.addEventListener("abort", finish, { once: true });
-		if (signal.aborted) finish();
-	});
-}
-
-/** Browser-owned threads outlive panel unmounts. Only their own subscribers render on an answer update. */
-export class SideChatStore {
-	private states = new Map<string, SideChatState>();
-	private listeners = new Map<string, Set<() => void>>();
-	private requests = new Map<string, AbortController>();
-	private saves = new Map<string, ReturnType<typeof setTimeout>>();
-	constructor(private options: { fetch: typeof fetch; storage: () => Storage; id: () => string } = {
-		fetch: (...args) => fetch(...args), storage: () => localStorage, id: () => crypto.randomUUID(),
-	}) {}
-
-	get = (sessionId: string | null): SideChatState => {
-		if (!sessionId) return EMPTY_SIDE_CHAT;
-		let state = this.states.get(sessionId);
-		if (state) return state;
-		try {
-			const raw = this.options.storage().getItem(PREFIX + sessionId);
-			if (raw) {
-				const saved = JSON.parse(raw) as SideChatState;
-				if (isSideChatId(saved.currentThreadId) && Array.isArray(saved.threads) && saved.threads.length && saved.threads.every((thread) =>
-					isSideChatId(thread.id) && typeof thread.title === "string" && typeof thread.draft === "string" && Array.isArray(thread.messages) && thread.messages.every((message) =>
-						isSideChatId(message.id) && (message.role === "user" || message.role === "assistant") && typeof message.text === "string") &&
-					(!thread.request || (isSideChatId(thread.request.id) && Number.isSafeInteger(thread.request.revision)))) && saved.threads.some((thread) => thread.id === saved.currentThreadId)) {
-					state = { ...saved, storageFailed: false, threads: saved.threads.map((thread) => ({ ...thread, model: isSideChatModel(thread.model) ? thread.model : undefined })) };
-				}
-			}
-		} catch { /* A unavailable or full browser store must not disable questions. */ }
-		if (!state) {
-			const thread = this.newThread();
-			state = { currentThreadId: thread.id, threads: [thread], storageFailed: false };
-		}
-		this.states.set(sessionId, state);
-		return state;
-	};
-
-	flush = (): void => { for (const sessionId of this.states.keys()) this.save(sessionId); };
-
-	subscribe = (sessionId: string | null, listener: () => void): (() => void) => {
-		if (!sessionId) return () => {};
-		const listeners = this.listeners.get(sessionId) ?? new Set();
-		listeners.add(listener);
-		this.listeners.set(sessionId, listeners);
-		queueMicrotask(() => {
-			for (const thread of this.get(sessionId).threads) {
-				if (thread.request && !this.requests.has(thread.request.id)) void this.run(sessionId, thread.id, thread.request.id);
-			}
-		});
-		return () => { listeners.delete(listener); };
-	};
-
-	private newThread(model?: SideChatModel): SideChatThread { return { id: this.options.id(), title: "", messages: [], draft: "", ...(model ? { model: { ...model } } : {}) }; }
-	private notify(sessionId: string): void { for (const listener of this.listeners.get(sessionId) ?? []) listener(); }
-	private save(sessionId: string): void {
-		const timer = this.saves.get(sessionId);
-		if (timer) clearTimeout(timer);
-		this.saves.delete(sessionId);
-		const state = this.get(sessionId);
-		let failed = false;
-		try { this.options.storage().setItem(PREFIX + sessionId, JSON.stringify(state)); }
-		catch { failed = true; }
-		if (state.storageFailed !== failed) {
-			this.states.set(sessionId, { ...state, storageFailed: failed });
-			this.notify(sessionId);
-		}
-	}
-	private update(sessionId: string, state: SideChatState, immediately = false): void {
-		this.states.set(sessionId, state);
-		this.notify(sessionId);
-		if (immediately) this.save(sessionId);
-		else if (!this.saves.has(sessionId)) this.saves.set(sessionId, setTimeout(() => this.save(sessionId), 300));
-	}
-	private updateThread(sessionId: string, threadId: string, change: (thread: SideChatThread) => SideChatThread, immediately = false): void {
-		const state = this.get(sessionId);
-		this.update(sessionId, { ...state, threads: state.threads.map((thread) => thread.id === threadId ? change(thread) : thread) }, immediately);
-	}
-
-	setDraft(sessionId: string, text: string): void {
-		this.updateThread(sessionId, this.get(sessionId).currentThreadId, (thread) => ({ ...thread, draft: text }));
-	}
-	setModel(sessionId: string, model?: SideChatModel): void {
-		this.updateThread(sessionId, this.get(sessionId).currentThreadId, (thread) => ({ ...thread, model: model ? { ...model } : undefined }), true);
-	}
-	createThread(sessionId: string): void {
-		const state = this.get(sessionId);
-		const current = state.threads.find((thread) => thread.id === state.currentThreadId);
-		if (current && !current.messages.length && !current.draft) return;
-		const thread = this.newThread(current?.model);
-		this.update(sessionId, { ...state, currentThreadId: thread.id, threads: [...state.threads, thread] }, true);
-	}
-	selectThread(sessionId: string, threadId: string): void {
-		const state = this.get(sessionId);
-		if (state.threads.some((thread) => thread.id === threadId)) this.update(sessionId, { ...state, currentThreadId: threadId }, true);
-	}
-
-	send(sessionId: string, retry = false): void {
-		const state = this.get(sessionId);
-		const thread = state.threads.find((item) => item.id === state.currentThreadId);
-		if (!thread || thread.request) return;
-		const previous = thread.messages.at(-1);
-		const retrying = retry && previous?.role === "assistant" && previous.status === "error" && thread.messages.at(-2)?.role === "user";
-		const text = (retrying ? thread.messages.at(-2)!.text : thread.draft).trim();
-		if (!text) return;
-		const requestId = this.options.id();
-		const historyMessages = retrying ? thread.messages.slice(0, -2) : thread.messages;
-		const availableHistory: SideChatHistoryMessage[] = historyMessages.filter((message) => message.text && (message.role === "user" || message.status === "done" || message.status === "aborted"))
-			.map(({ role, text }) => ({ role, text }));
-		const { history, truncated } = requestHistory(availableHistory);
-		const messages: SideChatMessage[] = retrying
-			? [...thread.messages.slice(0, -1), { id: previous!.id, role: "assistant", text: "", status: "pending", contextTruncated: truncated }]
-			: [...thread.messages, { id: this.options.id(), role: "user", text }, { id: this.options.id(), role: "assistant", text: "", status: "pending", contextTruncated: truncated }];
-		this.updateThread(sessionId, thread.id, (item) => ({ ...item, title: item.title || text.slice(0, 80), messages, draft: retrying ? item.draft : "", request: { id: requestId, revision: -1 }, connectionLost: false }), true);
-		void this.run(sessionId, thread.id, requestId, { requestId, threadId: thread.id, text, history, ...(thread.model ? { model: { ...thread.model } } : {}) });
-	}
-
-	private apply(sessionId: string, threadId: string, requestId: string, progress: SideChatProgress): void {
-		this.updateThread(sessionId, threadId, (thread) => {
-			if (thread.request?.id !== requestId) return thread;
-			const previousText = thread.messages.at(-1)?.text ?? "";
-			if (progress.textOffset !== undefined && progress.textOffset > previousText.length) throw new Error("side-chat answer cursor is out of sync");
-			const text = progress.textOffset === undefined ? progress.text : previousText.slice(0, progress.textOffset) + progress.text;
-			const status = !progress.done ? "pending" : progress.error ? "error" : progress.aborted ? "aborted" : "done";
-			return {
-				...thread, connectionLost: false, request: progress.done ? undefined : { id: requestId, revision: progress.revision },
-				// 只在这次响应真的报了就更新；没报就保持上一次的值（不回落成 0）
-				...(progress.usage ? { usage: progress.usage } : {}),
-				...(progress.contextWindow ? { contextWindow: progress.contextWindow } : {}),
-				...(progress.characters ? { characters: progress.characters } : {}),
-				messages: thread.messages.map((message, index) => index === thread.messages.length - 1 ? {
-					...message, text, status, error: progress.error, contextTruncated: message.contextTruncated || progress.contextTruncated, lengthLimited: progress.lengthLimited,
-				} : message),
-			};
-		}, progress.done);
-	}
-	private fail(sessionId: string, threadId: string, requestId: string, error: string): void {
-		const thread = this.get(sessionId).threads.find((item) => item.id === threadId);
-		this.apply(sessionId, threadId, requestId, { requestId, revision: 0, text: thread?.messages.at(-1)?.text ?? "", done: true, aborted: false, error });
-	}
-	private async response(response: Response): Promise<SideChatProgress> {
-		const json = await response.json();
-		if (!response.ok || !json.success) throw new ApiError(json.error || `side-chat request failed (${response.status})`, response.status);
-		const data = json.data as SideChatProgress;
-		if (!data || !isSideChatId(data.requestId) || !Number.isSafeInteger(data.revision) || typeof data.text !== "string" || typeof data.done !== "boolean" || (data.textOffset !== undefined && (!Number.isSafeInteger(data.textOffset) || data.textOffset < 0))) throw new Error("invalid side-chat response");
-		return data;
-	}
-	private async run(sessionId: string, threadId: string, requestId: string, initial?: SideChatRequest): Promise<void> {
-		if (this.requests.has(requestId)) return;
-		const controller = new AbortController();
-		this.requests.set(requestId, controller);
-		const url = `/api/agent/${sessionId}/side-chat`;
-		let revision = this.get(sessionId).threads.find((thread) => thread.id === threadId)?.request?.revision ?? -1;
-		try {
-			if (initial) {
-				const progress = await this.response(await this.options.fetch(url, { method: "POST", headers: { "Content-Type": "application/json" }, body: JSON.stringify(initial), signal: controller.signal }));
-				if (progress.requestId !== requestId) throw new Error("side-chat response belongs to a different request");
-				if (controller.signal.aborted) return;
-				this.apply(sessionId, threadId, requestId, progress);
-				if (progress.done) return;
-				revision = progress.revision;
-			}
-			let failures = 0;
-			while (!controller.signal.aborted) {
-				let progress: SideChatProgress;
-				try {
-					progress = await this.response(await this.options.fetch(`${url}?requestId=${encodeURIComponent(requestId)}&after=${revision}`, { cache: "no-store", signal: controller.signal }));
-					if (progress.requestId !== requestId) throw new Error("side-chat response belongs to a different request");
-				} catch (error) {
-					if (controller.signal.aborted) return;
-					if (error instanceof ApiError || ++failures >= 6) throw error;
-					this.updateThread(sessionId, threadId, (thread) => ({ ...thread, connectionLost: true }));
-					await pause(Math.min(500 * 2 ** (failures - 1), 5000), controller.signal);
-					continue;
-				}
-				if (controller.signal.aborted) return;
-				failures = 0;
-				this.apply(sessionId, threadId, requestId, progress);
-				if (progress.done) return;
-				revision = progress.revision;
-			}
-		} catch (error) {
-			if (!controller.signal.aborted) this.fail(sessionId, threadId, requestId, error instanceof Error ? error.message : "side-chat request failed");
-		} finally {
-			if (this.requests.get(requestId) === controller) this.requests.delete(requestId);
-		}
-	}
-
-	stop(sessionId: string): void {
-		const thread = this.get(sessionId).threads.find((item) => item.id === this.get(sessionId).currentThreadId);
-		const requestId = thread?.request?.id;
-		if (!thread || !requestId) return;
-		this.requests.get(requestId)?.abort();
-		this.apply(sessionId, thread.id, requestId, { requestId, revision: 0, text: thread.messages.at(-1)?.text ?? "", done: true, aborted: true });
-		void this.options.fetch(`/api/agent/${sessionId}/side-chat?requestId=${encodeURIComponent(requestId)}`, { method: "DELETE" })
-			.then(async (response) => { if (!response.ok) throw new Error((await response.json()).error || "failed to stop side-chat answer"); })
-			.catch((error) => this.updateThread(sessionId, thread.id, (current) => ({ ...current, messages: current.messages.map((message) => message.id === thread.messages.at(-1)?.id ? { ...message, error: error instanceof Error ? error.message : "failed to stop side-chat answer" } : message) }), true));
-	}
-}
-
-export const sideChatStore = new SideChatStore();
-if (typeof window !== "undefined") window.addEventListener("pagehide", sideChatStore.flush);

package/src/lib/chat/stream-settings.ts

@@ -1,192 +0,0 @@
-/**
- * 流式文字输出偏好：显示样式 / 推进速度 / 打字光标。
- *
- * 存 localStorage（piweb.streamStyle / piweb.streamSpeed / piweb.streamCaret），
- * 模块级订阅：设置面板一改，正在流的那条回答在下一帧就换样式，不必重开会话；
- * 跨标签页由 storage 事件同步。
- *
- * 推进量是纯函数 nextRevealEnd(target, shownLength, settings)：给定目标文本、已显示长度和偏好，
- * 算出这一帧该显示到哪。不变量是「显示内容始终是目标前缀、单调增长、最终追平」——
- * 见 tests/stream-settings.test.ts。
- */
-
-export type StreamStyle = "smooth" | "instant" | "typewriter" | "fade";
-
-export interface StreamSettings {
-	/** 文字出现的方式 */
-	style: StreamStyle;
-	/** 推进速度档位 1..5（3 = 标准） */
-	speed: number;
-	/** 打字光标：流式期间在文字末尾闪烁 */
-	caret: boolean;
-}
-
-/** 设置面板里的展示顺序（即时排在最后：它是「不要平滑」的退路） */
-export const STREAM_STYLES: readonly StreamStyle[] = ["smooth", "typewriter", "fade", "instant"];
-export const STREAM_SPEED_MIN = 1;
-export const STREAM_SPEED_MAX = 5;
-export const DEFAULT_STREAM_SETTINGS: StreamSettings = { style: "smooth", speed: 3, caret: false };
-
-const KEY = {
-	style: "piweb.streamStyle",
-	speed: "piweb.streamSpeed",
-	caret: "piweb.streamCaret",
-} as const;
-
-/** 每帧间隔（约 60fps 起步）：档位越高越密 */
-const STEP_MS = [24, 20, 16, 12, 8];
-/** 平滑 / 渐显：每帧推进「积压 / 该值」，值越大追赶越缓、手感越匀（突发不再狂奔） */
-const SMOOTH_DIVISOR = [14, 10, 7, 5, 3];
-/** 平滑 / 渐显：每帧至少推进的字符数，保证收尾时也能走完 */
-const SMOOTH_MIN_CHARS = [1, 1, 1, 2, 3];
-/** 平滑 / 渐显：每帧至多推进的字符数——大块突发被摊到更多帧里缓缓出现，不会一口吞掉 */
-const SMOOTH_MAX_CHARS = [140, 110, 90, 70, 50];
-/** 打字机：每帧固定敲出的字符数 */
-const TYPEWRITER_CHARS = [1, 2, 3, 5, 8];
-/** 打字机也要有底线：积压超过约 1.5 秒的量就跟着加速，不出现「回答完了字还在爬」 */
-const TYPEWRITER_CATCHUP_DIVISOR = 90;
-
-export function isStreamStyle(value: string | null | undefined): value is StreamStyle {
-	return value === "smooth" || value === "instant" || value === "typewriter" || value === "fade";
-}
-
-export function clampStreamSpeed(value: number): number {
-	if (!Number.isFinite(value)) return DEFAULT_STREAM_SETTINGS.speed;
-	return Math.max(STREAM_SPEED_MIN, Math.min(STREAM_SPEED_MAX, Math.round(value)));
-}
-
-/** 这一档速度下每帧的间隔（毫秒） */
-export function streamStepMs(speed: number): number {
-	return STEP_MS[clampStreamSpeed(speed) - 1];
-}
-
-function readStored(): StreamSettings {
-	try {
-		const style = localStorage.getItem(KEY.style);
-		const speed = Number.parseInt(localStorage.getItem(KEY.speed) ?? "", 10);
-		const caret = localStorage.getItem(KEY.caret);
-		return {
-			style: isStreamStyle(style) ? style : DEFAULT_STREAM_SETTINGS.style,
-			speed: Number.isFinite(speed) ? clampStreamSpeed(speed) : DEFAULT_STREAM_SETTINGS.speed,
-			caret: caret === null ? DEFAULT_STREAM_SETTINGS.caret : caret === "1" || caret === "true",
-		};
-	} catch {
-		// 隐私模式 / localStorage 不可用：这一份内存偏好照样生效
-		return DEFAULT_STREAM_SETTINGS;
-	}
-}
-
-export function loadStreamSettings(): StreamSettings {
-	if (typeof window === "undefined") return DEFAULT_STREAM_SETTINGS;
-	return readStored();
-}
-
-function persist(settings: StreamSettings): void {
-	if (typeof window === "undefined") return;
-	try {
-		localStorage.setItem(KEY.style, settings.style);
-		localStorage.setItem(KEY.speed, String(settings.speed));
-		localStorage.setItem(KEY.caret, settings.caret ? "1" : "0");
-	} catch {
-		/* 配额满 / 被禁用：内存里已经生效 */
-	}
-}
-
-let cached: StreamSettings | null = null;
-const listeners = new Set<() => void>();
-let storageBound = false;
-
-/** useSyncExternalStore 的 getSnapshot：同一份引用，只有真改了才换（否则会无限重渲染） */
-export function getStreamSettings(): StreamSettings {
-	if (!cached) cached = loadStreamSettings();
-	return cached;
-}
-
-/** 服务端 / 水合首帧没有 localStorage，给默认值 */
-export function getServerStreamSettings(): StreamSettings {
-	return DEFAULT_STREAM_SETTINGS;
-}
-
-function bindStorage(): void {
-	if (storageBound || typeof window === "undefined") return;
-	storageBound = true;
-	window.addEventListener("storage", (event) => {
-		if (event.key !== null && event.key !== KEY.style && event.key !== KEY.speed && event.key !== KEY.caret) return;
-		cached = loadStreamSettings();
-		for (const listener of listeners) listener();
-	});
-}
-
-export function subscribeStreamSettings(listener: () => void): () => void {
-	listeners.add(listener);
-	bindStorage();
-	return () => {
-		listeners.delete(listener);
-	};
-}
-
-/** 改一项并持久化，返回合并后的完整偏好；正在流的回答下帧就用新值 */
-export function setStreamSettings(patch: Partial<StreamSettings>): StreamSettings {
-	const current = getStreamSettings();
-	const next: StreamSettings = {
-		style: isStreamStyle(patch.style) ? patch.style : current.style,
-		speed: patch.speed === undefined ? current.speed : clampStreamSpeed(patch.speed),
-		caret: patch.caret === undefined ? current.caret : patch.caret === true,
-	};
-	cached = next;
-	persist(next);
-	for (const listener of listeners) listener();
-	return next;
-}
-
-/**
- * 不在 UTF-16 代理对中间切：切在中间会渲染成一个替换字符（半个 emoji）。
- * 端点越界时按文本长度收口。
- */
-export function safeSliceEnd(text: string, end: number): number {
-	if (end <= 0) return 0;
-	if (end >= text.length) return text.length;
-	const high = text.charCodeAt(end - 1);
-	const low = text.charCodeAt(end);
-	if (high >= 0xd800 && high <= 0xdbff && low >= 0xdc00 && low <= 0xdfff) return Math.min(end + 1, text.length);
-	return end;
-}
-
-/**
- * 渐显：只在整词处停 —— 从 end 往回找到最近的分隔符，切在它后面；
- * 这一段里没有分隔符（正在敲的词）就照常长，否则会停在原地走不完。
- */
-function snapToWordEnd(target: string, from: number, end: number): number {
-	if (end >= target.length) return target.length;
-	for (let i = end - 1; i >= from; i -= 1) {
-		if (/\s/.test(target[i])) return i + 1;
-	}
-	return end;
-}
-
-/**
- * 这一帧显示到哪个下标（返回值 = 目标文本前缀长度）。
- * - instant：不排队，直接追平；
- * - smooth：自适应 —— 积压越多推得越快，但每帧有上限：大块突发被摊到多帧缓缓出现；
- * - typewriter：固定节奏逐字，但积压过大时跟着加速（上限约 1.5 秒的落后量）；
- * - fade：在 smooth 的基础上按整词推进。
- */
-export function nextRevealEnd(target: string, shownLength: number, settings: StreamSettings): number {
-	const total = target.length;
-	if (settings.style === "instant") return total;
-	const backlog = total - shownLength;
-	if (backlog <= 0) return total;
-	const level = clampStreamSpeed(settings.speed) - 1;
-	let end: number;
-	if (settings.style === "typewriter") {
-		end = shownLength + Math.max(TYPEWRITER_CHARS[level], Math.ceil(backlog / TYPEWRITER_CATCHUP_DIVISOR));
-	} else {
-		end = shownLength + Math.min(
-			SMOOTH_MAX_CHARS[level],
-			Math.max(SMOOTH_MIN_CHARS[level], Math.ceil(backlog / SMOOTH_DIVISOR[level])),
-		);
-	}
-	if (end > total) end = total;
-	if (settings.style === "fade") end = snapToWordEnd(target, shownLength, end);
-	return safeSliceEnd(target, end);
-}