@tanzerfe/page-use 0.0.12 → 0.0.14

package/dist/{tool-CvEvIsN9.mjs → tool-DBeaEt3g.mjs}

@@ -355,6 +355,8 @@ function normalizeOptions(options) {
 			model: (llm.model || "").trim() || "deepseek-chat",
 			maxSteps: llm.maxSteps && llm.maxSteps > 0 ? llm.maxSteps : 20,
 			disableNamedToolChoice: Boolean(llm.disableNamedToolChoice),
+			stream: llm.stream === true,
+			streamOptions: typeof llm.streamOptions?.includeUsage === "boolean" ? { includeUsage: llm.streamOptions.includeUsage } : {},
 			extraBody: llm.extraBody && typeof llm.extraBody === "object" ? llm.extraBody : {},
 			sessionHeader: resolveSessionHeader(llm.sessionHeader)
 		},
@@ -366,6 +368,7 @@ function normalizeOptions(options) {
 		routeHints: options.routeHints ?? {},
 		layoutHint: options.layoutHint,
 		beforeTask: options.beforeTask,
+		onUserSubmit: options.onUserSubmit,
 		beforeTaskLabel: options.beforeTaskLabel || "任务开始前执行宿主预处理",
 		storageKeyPrefix: options.storageKeyPrefix || "tz-page-use",
 		pageAgentOptions: options.pageAgentOptions ?? {},
@@ -605,19 +608,17 @@ const PRESENT_PAGE_TOOL_NAME = "present_page";
 //#endregion
 //#region src/voice/preview.ts
 /**
-* 音色试听：用当前引擎、音色与语速播报一句固定文本，供设置页选择音色时对比。
+* 音色试听：用当前引擎、音色与语速播报业务应用名，供设置页选择音色时对比。
 * 不经 speaker 队列：试听是单次、可中止的调用，不参与待播与抢占，也不受本次任务静音影响。
 * 与任务播报互斥：launcher 在任务执行中禁用试听，narration 在任务开始时调用 stopPreview()。
 */
-/** 试听文本 */
-const PREVIEW_TEXT = "您好，我是页面智能体。";
 const store$3 = createStore({ playing: false });
 /** 试听状态（playing：是否正在试听），供设置页切换「试听 / 停止」按钮 */
 const previewStore = store$3;
 /** 当前试听的中止控制；空闲时为 null */
 let controller = null;
 /** 开始试听：先中止上一次试听；引擎 speak 结束（播完、失败或被中止）后复位状态 */
-function startPreview(engine, options) {
+function startPreview(engine, options, appName) {
 	stopPreview();
 	if (!engine.isAvailable()) return;
 	const current = new AbortController();
@@ -625,7 +626,7 @@ function startPreview(engine, options) {
 	store$3.set({ playing: true });
 	let speaking;
 	try {
-		speaking = engine.speak(PREVIEW_TEXT, {
+		speaking = engine.speak(`您好，我是${appName}。`, {
 			...options,
 			signal: current.signal
 		});
@@ -913,7 +914,7 @@ const SILENT_DWELL_MS = 2500;
 /** 讲解词的播报字数上限：高于讲解工具的讲解词上限，正常不截断 */
 const TOUR_SPEECH_MAX_CHARS$1 = 400;
 /** 当前运行的播报（startNarration 期间有效），供页面讲解逐段播报 */
-let active$1 = null;
+let active$2 = null;
 /**
 * 调试面板名称（PageUseLauncherConfig.title），用于截断提示语「详细内容请查看「名称」」。
 * 由 launcher 挂载时登记、卸载时撤销；未挂载面板时为 null，提示语回退为「详细内容请查看面板」。
@@ -946,7 +947,7 @@ function startNarration({ subscribe, engines, speaker: injected }) {
 		speaker,
 		enabled
 	};
-	active$1 = current;
+	active$2 = current;
 	const offEvents = subscribe((event) => {
 		if (event.silent) return;
 		switch (event.type) {
@@ -975,7 +976,7 @@ function startNarration({ subscribe, engines, speaker: injected }) {
 		if (muted) speaker.clear();
 	});
 	return () => {
-		if (active$1 === current) active$1 = null;
+		if (active$2 === current) active$2 = null;
 		offEvents();
 		offSettings();
 		offMute();
@@ -1006,7 +1007,7 @@ function dwell(ms, signal) {
 async function narrate(text, signal) {
 	if (signal?.aborted) return;
 	const startedAt = Date.now();
-	const narration = active$1;
+	const narration = active$2;
 	if (narration?.enabled()) {
 		const sentences = toSpeechText(text, { maxChars: TOUR_SPEECH_MAX_CHARS$1 });
 		await narration.speaker.speakAndWait(sentences, signal);
@@ -1874,6 +1875,281 @@ function buildPageInstruction(options, outlineText = "", openedUrls = []) {
 	return parts.length ? parts.join("\n") : null;
 }
 
+//#endregion
+//#region src/core/llmTransport.ts
+const MAX_STREAM_BYTES = 8388608;
+const MAX_STREAM_ITEMS = 32;
+function record(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function invalid(message) {
+	return /* @__PURE__ */ new Error(`[PageUse SSE] ${message}`);
+}
+/** 正式流式配置最后写入，extraBody/宿主变换不能单独开启无解析器的 SSE。 */
+function completionRequestBody(body, llm) {
+	const { stream: _stream, stream_options: _options, ...rest } = body;
+	return {
+		...rest,
+		stream: llm.stream,
+		...llm.stream && typeof llm.streamOptions.includeUsage === "boolean" ? { stream_options: { include_usage: llm.streamOptions.includeUsage } } : {}
+	};
+}
+function index(value) {
+	if (!Number.isSafeInteger(value) || value < 0 || value >= MAX_STREAM_ITEMS) throw invalid("无效的 choice/tool_calls index");
+	return value;
+}
+function appendFunction(target, delta) {
+	if (!record(delta)) throw invalid("无效的工具 function");
+	for (const field of ["name", "arguments"]) {
+		const part = delta[field];
+		if (part !== void 0) {
+			if (typeof part !== "string") throw invalid(`工具 ${field} 不是字符串`);
+			target[field] += part;
+		}
+	}
+}
+function validateFunction(call) {
+	if (!call.name || !call.arguments) throw invalid("工具名称或参数不完整");
+	try {
+		JSON.parse(call.arguments);
+	} catch {
+		throw invalid("工具参数不是完整 JSON");
+	}
+}
+/** 只有 [DONE] 与各 choice 的正常 finish_reason 均已收到，才交付完整响应。 */
+async function readEventStream(response, signal) {
+	signal?.throwIfAborted();
+	if (!response.body) throw invalid("响应没有可读流");
+	const reader = response.body.getReader();
+	const decoder = new TextDecoder("utf-8", { fatal: true });
+	const choices = /* @__PURE__ */ new Map();
+	const metadata = { object: "chat.completion" };
+	let usage;
+	let buffer = "";
+	let data = [];
+	let eventName = "";
+	let ended = false;
+	let bytes = 0;
+	const cancel = () => {
+		reader.cancel().catch(() => {});
+	};
+	signal?.addEventListener("abort", cancel, { once: true });
+	function acceptChunk(chunk) {
+		if (!record(chunk)) throw invalid("事件不是 JSON 对象");
+		if (chunk.error) throw invalid(record(chunk.error) && typeof chunk.error.message === "string" ? chunk.error.message.slice(0, 500) : "网关返回错误事件");
+		for (const key of [
+			"id",
+			"model",
+			"created",
+			"system_fingerprint",
+			"service_tier"
+		]) if (chunk[key] !== void 0) metadata[key] = chunk[key];
+		if (chunk.usage != null) {
+			if (!record(chunk.usage)) throw invalid("无效的 usage");
+			usage = chunk.usage;
+		}
+		if (!Array.isArray(chunk.choices)) throw invalid("事件缺少 choices");
+		for (const item of chunk.choices) {
+			if (!record(item)) throw invalid("无效的 choice");
+			const id = index(item.index);
+			let pending = choices.get(id);
+			if (!pending) {
+				pending = {
+					choice: {
+						index: id,
+						message: {
+							role: "assistant",
+							content: null
+						},
+						finish_reason: null
+					},
+					tools: /* @__PURE__ */ new Map()
+				};
+				choices.set(id, pending);
+			}
+			if (pending.choice.finish_reason !== null) throw invalid("choice 结束后仍收到增量");
+			const delta = item.delta;
+			if (!record(delta)) throw invalid("choice 缺少 delta");
+			const message = pending.choice.message;
+			if (delta.role != null && delta.role !== "assistant") throw invalid("无效的响应 role");
+			if (delta.content != null) {
+				if (typeof delta.content !== "string") throw invalid("content 不是字符串");
+				message.content = (message.content ?? "") + delta.content;
+			}
+			if (delta.refusal) throw invalid("模型拒绝了请求");
+			if (delta.function_call != null) {
+				message.function_call ??= {
+					name: "",
+					arguments: ""
+				};
+				appendFunction(message.function_call, delta.function_call);
+			}
+			if (delta.tool_calls != null) {
+				if (!Array.isArray(delta.tool_calls)) throw invalid("无效的 tool_calls");
+				for (const tool of delta.tool_calls) {
+					if (!record(tool)) throw invalid("无效的工具增量");
+					const toolIndex = index(tool.index);
+					let call = pending.tools.get(toolIndex);
+					if (!call) {
+						call = { function: {
+							name: "",
+							arguments: ""
+						} };
+						pending.tools.set(toolIndex, call);
+					}
+					for (const field of ["id", "type"]) if (tool[field] !== void 0) {
+						if (typeof tool[field] !== "string" || call[field] !== void 0 && call[field] !== tool[field]) throw invalid(`工具 ${field} 不一致`);
+						call[field] = tool[field];
+					}
+					if (tool.function !== void 0) appendFunction(call.function, tool.function);
+				}
+			}
+			if (item.finish_reason != null) {
+				if (![
+					"stop",
+					"tool_calls",
+					"function_call",
+					"length",
+					"content_filter"
+				].includes(String(item.finish_reason))) throw invalid(`异常结束：${item.finish_reason}`);
+				pending.choice.finish_reason = String(item.finish_reason);
+			}
+		}
+	}
+	function line(text) {
+		if (text === "") {
+			if (eventName === "error") throw invalid("网关返回 error 事件");
+			if (data.length) {
+				const payload = data.join("\n");
+				if (payload.trim() === "[DONE]") ended = true;
+				else {
+					let chunk;
+					try {
+						chunk = JSON.parse(payload);
+					} catch {
+						throw invalid("事件不是完整 JSON");
+					}
+					acceptChunk(chunk);
+				}
+			}
+			data = [];
+			eventName = "";
+			return;
+		}
+		if (text.startsWith(":")) return;
+		const colon = text.indexOf(":");
+		const field = colon < 0 ? text : text.slice(0, colon);
+		const value = colon < 0 ? "" : text.slice(colon + 1).replace(/^ /, "");
+		if (field === "data") data.push(value);
+		if (field === "event") eventName = value;
+	}
+	function consume(text, final = false) {
+		buffer += text;
+		while (!ended) {
+			const end = buffer.search(/[\r\n]/);
+			if (end < 0 || !final && buffer[end] === "\r" && end === buffer.length - 1) break;
+			const size = buffer[end] === "\r" && buffer[end + 1] === "\n" ? 2 : 1;
+			const current = buffer.slice(0, end);
+			buffer = buffer.slice(end + size);
+			line(current);
+		}
+	}
+	try {
+		while (!ended) {
+			signal?.throwIfAborted();
+			const next = await reader.read();
+			signal?.throwIfAborted();
+			if (next.done) {
+				consume(decoder.decode(), true);
+				break;
+			}
+			bytes += next.value.byteLength;
+			if (bytes > MAX_STREAM_BYTES) throw invalid("响应超过 8 MiB 限制");
+			consume(decoder.decode(next.value, { stream: true }));
+		}
+		signal?.throwIfAborted();
+		if (!ended || !choices.size || !choices.has(0)) throw invalid("流在完整结束标记前中断");
+		const result = [];
+		for (const [id, pending] of [...choices].sort(([a], [b]) => a - b)) {
+			if (id !== result.length || !pending.choice.finish_reason) throw invalid("choice 不完整");
+			const failed = ["length", "content_filter"].includes(pending.choice.finish_reason);
+			if (pending.tools.size) pending.choice.message.tool_calls = [...pending.tools].sort(([a], [b]) => a - b).map(([id, call], position) => {
+				if (id !== position || !call.id || call.type !== "function") throw invalid("工具调用不完整");
+				if (!failed) validateFunction(call.function);
+				return call;
+			});
+			if (!failed && pending.choice.message.function_call) validateFunction(pending.choice.message.function_call);
+			result.push(pending.choice);
+		}
+		return {
+			...metadata,
+			choices: result,
+			...usage ? { usage } : {}
+		};
+	} finally {
+		signal?.removeEventListener("abort", cancel);
+		cancel();
+		reader.releaseLock();
+	}
+}
+/** JSON 回退保持兼容；SSE 必须完整读取，取消后绝不返回聚合结果。 */
+async function readCompletionResponse(response, signal, forAgent = false) {
+	if (signal?.aborted) {
+		response.body?.cancel().catch(() => {});
+		signal.throwIfAborted();
+	}
+	const result = response.headers?.get("content-type")?.split(";")[0].trim().toLowerCase() === "text/event-stream" ? await readEventStream(response, signal) : await response.json();
+	signal?.throwIfAborted();
+	if (record(result) && Array.isArray(result.choices)) {
+		for (const choice of result.choices) if (!forAgent && record(choice) && choice.finish_reason != null && ![
+			"stop",
+			"tool_calls",
+			"function_call"
+		].includes(String(choice.finish_reason))) throw invalid(`异常结束：${choice.finish_reason}`);
+	}
+	return result;
+}
+/** 仅包装当前 agent 的 Response；不修改全局 fetch，也不改上游依赖。 */
+function agentCompletionResponse(response, signal) {
+	if (!response.ok) return response;
+	const headers = new Headers(response.headers);
+	headers.set("content-type", "application/json");
+	headers.delete("content-length");
+	headers.delete("content-encoding");
+	const aggregation = new AbortController();
+	const abort = () => aggregation.abort(signal?.reason);
+	signal?.addEventListener("abort", abort, { once: true });
+	if (signal?.aborted) abort();
+	const body = new ReadableStream({
+		async start(controller) {
+			try {
+				const completion = await readCompletionResponse(response, aggregation.signal, true);
+				const message = completion.choices[0]?.message;
+				if (completion.choices.length !== 1 || (message?.tool_calls?.length ?? 0) > 1 || message?.function_call && message.tool_calls?.length) throw invalid("agent 每轮只允许一个 choice 和一个工具调用");
+				if (!["length", "content_filter"].includes(completion.choices[0]?.finish_reason ?? "")) {
+					for (const call of message?.tool_calls ?? []) validateFunction(call.function);
+					if (message?.function_call) validateFunction(message.function_call);
+				}
+				aggregation.signal.throwIfAborted();
+				controller.enqueue(new TextEncoder().encode(JSON.stringify(completion)));
+				controller.close();
+			} catch (error) {
+				controller.error(error);
+			} finally {
+				signal?.removeEventListener("abort", abort);
+			}
+		},
+		cancel() {
+			aggregation.abort(new DOMException("响应读取已取消", "AbortError"));
+		}
+	});
+	return new Response(body, {
+		status: response.status,
+		statusText: response.statusText,
+		headers
+	});
+}
+
 //#endregion
 //#region src/core/createPageUseAgent.ts
 /**
@@ -1914,21 +2190,19 @@ function createPageUseAgent({ options, enableMask, narration = false, shouldRunB
 	const { llm } = options;
 	if (!llm.baseURL) throw new Error("[PageUse] 未配置 llm.baseURL");
 	let sessionId = newSessionId();
-	/**
-	* 注入会话头（OpenCode Go 缺少 x-opencode-session 会返回 400）。
-	* User-Agent 属浏览器禁止修改的头，需要时由代理补充。
-	*/
-	const customFetch = llm.sessionHeader ? (input, init) => {
+	const extraBody = llm.extraBody;
+	const hostBeforeTask = options.beforeTask;
+	const hostPageAgent = options.pageAgentOptions;
+	/** 注入任务会话头；浏览器禁止修改 User-Agent，需要时仍由代理补充。 */
+	const customFetch = async (input, init) => {
 		const headers = new Headers(init?.headers);
-		headers.set(llm.sessionHeader, sessionId);
-		return fetch(input, {
+		if (llm.sessionHeader) headers.set(llm.sessionHeader, sessionId);
+		const response = await (hostPageAgent.customFetch ?? fetch)(input, {
 			...init,
 			headers
 		});
-	} : void 0;
-	const extraBody = llm.extraBody;
-	const hostBeforeTask = options.beforeTask;
-	const hostPageAgent = options.pageAgentOptions;
+		return llm.stream ? agentCompletionResponse(response, init?.signal) : response;
+	};
 	const tour = options.pageTour.enabled ? createPageTour({
 		getContentRoot: options.getContentRoot,
 		maxTabSwitches: options.pageTour.maxTabSwitches,
@@ -1944,11 +2218,6 @@ function createPageUseAgent({ options, enableMask, narration = false, shouldRunB
 		language: "zh-CN",
 		maxSteps: llm.maxSteps,
 		disableNamedToolChoice: llm.disableNamedToolChoice,
-		customFetch,
-		transformRequestBody: Object.keys(extraBody).length ? (body) => ({
-			...body,
-			...extraBody
-		}) : void 0,
 		stepDelay: STEP_DELAY_SECONDS,
 		promptForNextTask: false,
 		enableMask,
@@ -1962,6 +2231,15 @@ function createPageUseAgent({ options, enableMask, narration = false, shouldRunB
 			return `${content.slice(0, PAGE_CONTENT_MAX_CHARS)}\n...（页面内容过长已截断，可滚动后再观察）`;
 		},
 		...hostPageAgent,
+		customFetch,
+		transformRequestBody: (body) => {
+			const merged = {
+				...body,
+				...extraBody
+			};
+			const transformed = hostPageAgent.transformRequestBody?.(merged) ?? merged;
+			return completionRequestBody(transformed, llm);
+		},
 		customTools: {
 			[CLICK_TOOL_NAME]: createClickTool(newWindows),
 			...tour ? { [PRESENT_PAGE_TOOL_NAME]: tour.tool } : {},
@@ -2273,6 +2551,64 @@ function describeActivity(activity) {
 	}
 }
 
+//#endregion
+//#region src/core/userSubmit.ts
+/** 用户输入接管；程序化 run 和 ask_user 回答不经过这里。 */
+const state = createStore({ pending: false });
+const pageUseSubmitStore = {
+	get: state.get,
+	subscribe: state.subscribe
+};
+let active$1;
+function cancelPageUseSubmit() {
+	const previous = active$1;
+	active$1 = void 0;
+	state.set({ pending: false });
+	previous?.abort();
+}
+async function decidePageUseSubmit(text, handler) {
+	if (active$1) return { action: "busy" };
+	if (!handler) return { action: "continue" };
+	const controller = new AbortController();
+	active$1 = controller;
+	state.set({ pending: true });
+	let onAbort = () => {};
+	try {
+		const cancelled = new Promise((resolve) => {
+			onAbort = () => resolve({ action: "cancelled" });
+			controller.signal.addEventListener("abort", onAbort, { once: true });
+		});
+		const decision = Promise.resolve().then(async () => controller.signal.aborted ? { action: "cancelled" } : handler({
+			text,
+			requestId: crypto.randomUUID(),
+			signal: controller.signal
+		}));
+		const result = await Promise.race([decision, cancelled]);
+		if (controller.signal.aborted || active$1 !== controller) return { action: "cancelled" };
+		if (!result || ![
+			"continue",
+			"handled",
+			"reject"
+		].includes(result.action)) return {
+			action: "reject",
+			message: "输入处理返回无效结果，请重试"
+		};
+		return result;
+	} catch (error) {
+		if (controller.signal.aborted) return { action: "cancelled" };
+		return {
+			action: "reject",
+			message: error instanceof Error ? error.message : "输入处理失败，请重试"
+		};
+	} finally {
+		controller.signal.removeEventListener("abort", onAbort);
+		if (active$1 === controller) {
+			active$1 = void 0;
+			state.set({ pending: false });
+		}
+	}
+}
+
 //#endregion
 //#region src/core/service.ts
 /** 无人可答时回给模型的固定答复，引导其基于已有信息决策或以未达成结束 */
@@ -2322,6 +2658,8 @@ let stopNarration = null;
 let questionUiCount = 0;
 /** 当前任务的调用方选项（提问回调、进度回调） */
 let activeOptions = null;
+let activeCancellation = null;
+let cancelQuestion = null;
 /** 整场流程持有执行权，包括暂停与人工等待；内部动作通过 owner 进入。 */
 let executionLease = null;
 let flowMaskOwner;
@@ -2389,28 +2727,54 @@ function bindAgentEvents(target) {
 	});
 }
 /** 模型提问的分发：调用方回调 → 调试面板 → 固定答复 */
-function handleAskUser(question, signal) {
-	emit({
-		type: "question",
-		taskId: store.get().currentTaskId,
-		question
-	});
+async function handleAskUser(question, signal) {
+	const taskId = store.get().currentTaskId;
 	const callerHandler = activeOptions?.onAskUser;
-	if (callerHandler) return callerHandler(question);
-	if (questionUiCount <= 0) return Promise.resolve(NO_ANSWER_REPLY);
-	return new Promise((resolve, reject) => {
-		store.set({ pendingQuestion: {
-			question,
-			resolve: (answer) => {
-				store.set({ pendingQuestion: null });
-				resolve(answer);
-			}
-		} });
-		signal?.addEventListener("abort", () => {
-			store.set({ pendingQuestion: null });
-			reject(signal.reason);
-		}, { once: true });
-	});
+	cancelQuestion?.();
+	const controller = new AbortController();
+	const cancel = () => controller.abort(new DOMException("任务已取消", "AbortError"));
+	const signals = [signal, activeCancellation?.signal].filter((value) => Boolean(value));
+	for (const upstream of signals) {
+		upstream.addEventListener("abort", cancel, { once: true });
+		if (upstream.aborted) cancel();
+	}
+	cancelQuestion = cancel;
+	let questionUi;
+	let onAbort = () => {};
+	try {
+		if (controller.signal.aborted) throw controller.signal.reason;
+		const cancelled = new Promise((_, reject) => {
+			onAbort = () => reject(controller.signal.reason);
+			controller.signal.addEventListener("abort", onAbort, { once: true });
+		});
+		const answer = Promise.resolve().then(() => {
+			if (controller.signal.aborted) throw controller.signal.reason;
+			emit({
+				type: "question",
+				taskId,
+				question
+			});
+			if (controller.signal.aborted) throw controller.signal.reason;
+			if (callerHandler) return callerHandler(question, {
+				taskId,
+				signal: controller.signal
+			});
+			if (questionUiCount <= 0) return NO_ANSWER_REPLY;
+			return new Promise((resolve) => {
+				questionUi = {
+					question,
+					resolve
+				};
+				store.set({ pendingQuestion: questionUi });
+			});
+		});
+		return await Promise.race([answer, cancelled]);
+	} finally {
+		for (const upstream of signals) upstream.removeEventListener("abort", cancel);
+		controller.signal.removeEventListener("abort", onAbort);
+		if (questionUi && store.get().pendingQuestion === questionUi) store.set({ pendingQuestion: null });
+		if (cancelQuestion === cancel) cancelQuestion = null;
+	}
 }
 /**
 * 懒创建单例；蒙层或播报设置变化时重建（enableMask 属构造期选项，系统提示在构造时生成）。
@@ -2529,6 +2893,8 @@ async function runTaskInternal(task, options, owner) {
 	const taskId = newTaskId();
 	const selectedConfig = config;
 	const startedAt = Date.now();
+	const cancellation = new AbortController();
+	activeCancellation = cancellation;
 	activeOptions = options;
 	store.set({
 		errorMessage: "",
@@ -2554,9 +2920,10 @@ async function runTaskInternal(task, options, owner) {
 	options.signal?.addEventListener("abort", onAbort, { once: true });
 	let result;
 	try {
+		if (cancellation.signal.aborted) throw cancellation.signal.reason;
 		const execution = await ensureAgent(config).execute(normalized);
 		if (config !== selectedConfig || activeOptions !== options) return rejectedResult(normalized, source, "宿主配置或执行会话已变化", void 0, "stopped");
-		const final = resolveFinalStatus(execution.success);
+		const final = cancellation.signal.aborted ? "stopped" : resolveFinalStatus(execution.success);
 		const { steps, totalTokens } = store.get();
 		result = {
 			taskId,
@@ -2573,24 +2940,26 @@ async function runTaskInternal(task, options, owner) {
 		if (config !== selectedConfig || activeOptions !== options) return rejectedResult(normalized, source, "宿主配置或执行会话已变化", void 0, "stopped");
 		const message = err instanceof Error ? err.message : String(err);
 		const { steps, totalTokens } = store.get();
+		const stopped = cancellation.signal.aborted;
 		store.set({
-			errorMessage: message,
-			status: "error"
+			errorMessage: stopped ? "" : message,
+			status: stopped ? "stopped" : "error"
 		});
 		result = {
 			taskId,
 			task: normalized,
 			source,
-			status: "error",
+			status: stopped ? "stopped" : "error",
 			success: false,
-			summary: message,
-			errorCode: "AGENT_ERROR",
+			summary: stopped ? "任务已取消" : message,
+			errorCode: stopped ? void 0 : "AGENT_ERROR",
 			steps,
 			tokens: totalTokens,
 			durationMs: Date.now() - startedAt
 		};
 	} finally {
 		options.signal?.removeEventListener("abort", onAbort);
+		if (activeCancellation === cancellation) activeCancellation = null;
 		if (config === selectedConfig && activeOptions === options) {
 			store.set({ finishedAt: Date.now() });
 			if (!executionLease) stopTick();
@@ -2615,11 +2984,18 @@ async function runTaskInternal(task, options, owner) {
 }
 /** 终止当前任务（无任务时忽略）；等待 agent 完全停下后 resolve */
 async function stopTask() {
+	cancelPageUseSubmit();
+	activeCancellation?.abort();
+	cancelQuestion?.();
 	if (executionLease) return executionLease.stop();
 	await agent?.stop();
 }
 async function stopTaskForFlow(owner) {
-	if (executionLease?.owner === owner) await agent?.stop();
+	if (executionLease?.owner === owner) {
+		activeCancellation?.abort();
+		cancelQuestion?.();
+		await agent?.stop();
+	}
 }
 function acquireFlowExecution(owner, stop) {
 	if (isRunning() || activeOptions) throw new FlowError("BUSY", "已有任务正在操作页面");
@@ -2720,6 +3096,9 @@ function clearPageUseLog() {
 }
 /** 释放 agent（清掉高亮与蒙层）；宿主销毁（如登出）时调用 */
 function disposeAgent() {
+	cancelPageUseSubmit();
+	activeCancellation?.abort();
+	cancelQuestion?.();
 	const lease = executionLease;
 	executionLease = null;
 	if (lease) lease.stop().catch((error) => console.warn("[PageUse] 取消流程失败", error));
@@ -4933,10 +5312,9 @@ function createRegionSelector(llm) {
 			method: "POST",
 			headers,
 			signal,
-			body: JSON.stringify({
+			body: JSON.stringify(completionRequestBody({
 				...extra,
 				model: llm.model,
-				stream: false,
 				temperature: 0,
 				messages: [{
 					role: "system",
@@ -4950,10 +5328,10 @@ function createRegionSelector(llm) {
 				}],
 				tools: [],
 				tool_choice: "none"
-			})
+			}, llm))
 		});
 		if (!response.ok) throw new FlowError("REGION_SELECTION_INVALID", `区域模型请求失败（HTTP ${response.status}）`);
-		const message = (await response.json()).choices?.[0]?.message;
+		const message = (await readCompletionResponse(response, signal)).choices?.[0]?.message;
 		if (message?.tool_calls?.length || message?.function_call) throw new FlowError("REGION_SELECTION_INVALID", "区域模型返回了工具调用");
 		try {
 			const value = JSON.parse(message?.content ?? "");
@@ -5017,10 +5395,9 @@ function createCompletionEvaluator(llm) {
 			method: "POST",
 			headers,
 			signal,
-			body: JSON.stringify({
+			body: JSON.stringify(completionRequestBody({
 				...extra,
 				model: llm.model,
-				stream: false,
 				temperature: 0,
 				tools: [],
 				tool_choice: "none",
@@ -5036,10 +5413,10 @@ function createCompletionEvaluator(llm) {
 						record: request.record
 					})
 				}]
-			})
+			}, llm))
 		});
 		if (!response.ok) throw new FlowError("CHECK_UNCERTAIN", `完成检查模型请求失败（HTTP ${response.status}）`);
-		const message = (await response.json()).choices?.[0]?.message;
+		const message = (await readCompletionResponse(response, signal)).choices?.[0]?.message;
 		if (message?.tool_calls?.length || message?.function_call) throw new FlowError("CHECK_UNCERTAIN", "完成检查模型返回了工具调用");
 		try {
 			const value = JSON.parse(message?.content ?? "");
@@ -8393,4 +8770,4 @@ async function runPageUseFlowTool(flow, args, options = {}) {
 }
 
 //#endregion
-export { showFlowMask as $, parseFlowBundle as A, browserTtsEngine as At, acquireFlowExecution as B, createIndexedDbFlowRepository as C, readLauncherQuery as Ct, flowSceneDraftSchema as D, PAGE_USE_MASK_COLORS as Dt, flowBundleSchema as E, resolveTtsEngine as Et, sceneKey as F, cancelRegionPicker as Ft, getPageUseSnapshot as G, configurePageUse as H, scopeKey as I, hasRegionPicker as It, isRunning as J, hideFlowMask as K, validateFlowInputs as L, FLOW_BUNDLE_VERSION as Lt, parseFlowRegion as M, DEFAULT_TOUR_STYLES as Mt, parseFlowScene as N, TOUR_STYLE_TRAINER as Nt, flowSceneSchema as O, SIMULATOR_MASK_ID as Ot, parseFlowSceneDraft as P, TOUR_STYLE_USER as Pt, runTaskForFlow as Q, validateRegionPreviewInputs as R, FLOW_SCHEMA_VERSION as Rt, previewFlowImport as S, normalizeOptions as St, cloneJson as T, listTtsEngines as Tt, getElapsedSeconds as U, clearPageUseLog as V, getPageUseConfig as W, registerQuestionUi as X, pageUseStore as Y, runTask as Z, createFlowApiAdapter as _, DEFAULT_MAX_STEPS as _t, mountPageUseManager as a, pageUseHistory as at, exportFlowBundle as b, DEFAULT_STORAGE_KEY_PREFIX as bt, createFlowRegionPicker as c, narrate as ct, evaluateFlowCompletion as d, previewStore as dt, stopTask as et, composedParent as f, startPreview as ft, validateRegionPages as g, createStore as gt, regionAbortable as h, pageUseSettings as ht, definePageUseManagerElement as i, pageUsePresets as it, parseFlowKnowledge as j, isSpeechSupported as jt, newRevision as k, BROWSER_ENGINE_ID as kt, createFlowRunner as l, narrationMute as lt, locateFlowRegion as m, DEFAULT_PAGE_USE_SETTINGS as mt, getPageUseFlowCatalog as n, subscribePageUse as nt, PAGE_USE_MANAGER_TAG as o, hideTourHighlight as ot, createRegionSelector as p, stopPreview as pt, isPageUseConfigured as q, runPageUseFlowTool as r, updateFlowExecution as rt, PageUseManagerElement as s, showTourHighlight as st, PAGE_USE_FLOW_TOOL as t, stopTaskForFlow as tt, createCompletionEvaluator as u, registerNarrationPanelName as ut, validateFlowApiOptions as v, DEFAULT_MODEL as vt, FLOW_SEGMENT_MAX_CHARS as w, readLauncherSwitch as wt, importFlowBundle as x, DEFAULT_TOUR_MAX_TAB_SWITCHES as xt, createFlowCloud as y, DEFAULT_SESSION_HEADER as yt, validateSceneBindings as z, FlowError as zt };
+export { showFlowMask as $, parseFlowBundle as A, listTtsEngines as At, acquireFlowExecution as B, cancelRegionPicker as Bt, createIndexedDbFlowRepository as C, DEFAULT_MODEL as Ct, flowSceneDraftSchema as D, normalizeOptions as Dt, flowBundleSchema as E, DEFAULT_TOUR_MAX_TAB_SWITCHES as Et, sceneKey as F, browserTtsEngine as Ft, getPageUseSnapshot as G, configurePageUse as H, FLOW_BUNDLE_VERSION as Ht, scopeKey as I, isSpeechSupported as It, isRunning as J, hideFlowMask as K, validateFlowInputs as L, DEFAULT_TOUR_STYLES as Lt, parseFlowRegion as M, PAGE_USE_MASK_COLORS as Mt, parseFlowScene as N, SIMULATOR_MASK_ID as Nt, flowSceneSchema as O, readLauncherQuery as Ot, parseFlowSceneDraft as P, BROWSER_ENGINE_ID as Pt, runTaskForFlow as Q, validateRegionPreviewInputs as R, TOUR_STYLE_TRAINER as Rt, previewFlowImport as S, DEFAULT_MAX_STEPS as St, cloneJson as T, DEFAULT_STORAGE_KEY_PREFIX as Tt, getElapsedSeconds as U, FLOW_SCHEMA_VERSION as Ut, clearPageUseLog as V, hasRegionPicker as Vt, getPageUseConfig as W, FlowError as Wt, registerQuestionUi as X, pageUseStore as Y, runTask as Z, createFlowApiAdapter as _, startPreview as _t, mountPageUseManager as a, decidePageUseSubmit as at, exportFlowBundle as b, pageUseSettings as bt, createFlowRegionPicker as c, pageUseHistory as ct, evaluateFlowCompletion as d, hideTourHighlight as dt, stopTask as et, composedParent as f, showTourHighlight as ft, validateRegionPages as g, previewStore as gt, regionAbortable as h, registerNarrationPanelName as ht, definePageUseManagerElement as i, cancelPageUseSubmit as it, parseFlowKnowledge as j, resolveTtsEngine as jt, newRevision as k, readLauncherSwitch as kt, createFlowRunner as l, completionRequestBody as lt, locateFlowRegion as m, narrationMute as mt, getPageUseFlowCatalog as n, subscribePageUse as nt, PAGE_USE_MANAGER_TAG as o, pageUseSubmitStore as ot, createRegionSelector as p, narrate as pt, isPageUseConfigured as q, runPageUseFlowTool as r, updateFlowExecution as rt, PageUseManagerElement as s, pageUsePresets as st, PAGE_USE_FLOW_TOOL as t, stopTaskForFlow as tt, createCompletionEvaluator as u, readCompletionResponse as ut, validateFlowApiOptions as v, stopPreview as vt, FLOW_SEGMENT_MAX_CHARS as w, DEFAULT_SESSION_HEADER as wt, importFlowBundle as x, createStore as xt, createFlowCloud as y, DEFAULT_PAGE_USE_SETTINGS as yt, validateSceneBindings as z, TOUR_STYLE_USER as zt };