page-agent-sdk 2.36.0 → 2.37.0

package/dist/page-agent-sdk.headless.js

@@ -3926,66 +3926,323 @@ function $a(e) {
 	};
 }
 //#endregion
-//#region src/core/harness/subagent.ts
+//#region src/core/utils/rounds.ts
 function eo(e) {
+	let t = [], n = null, r = 0;
+	for (let i = 0; i < e.length; i++) {
+		let a = e[i];
+		a.role === "user" ? (n && t.push(n), r++, n = {
+			round: r,
+			userMsg: a,
+			assistantMsgs: [],
+			startIdx: i,
+			endIdx: i
+		}) : n && (n.assistantMsgs.push(a), n.endIdx = i);
+	}
+	return n && t.push(n), t;
+}
+function to(e, t) {
+	let n = (e || "").replace(/```[\s\S]*?```/g, "[代码]").replace(/`([^`]+)`/g, "$1").replace(/[#*_>\-]\s?/g, "").replace(/\[(代码)\]/g, "「代码」").replace(/\s+/g, " ").trim();
+	return n.length > t ? n.slice(0, t) + "…" : n;
+}
+function no(e) {
+	let t = [];
+	for (let n of e.assistantMsgs) for (let e of n.steps || []) t.push(e.name);
+	return t;
+}
+var ro = "【更早对话摘要";
+function io(e, t) {
+	return !t || !t.body ? e : {
+		body: `${t.body}\n【续】\n${e.body}`,
+		rounds: (t.rounds ?? 0) + (e.rounds ?? 0),
+		cumulative: !0
+	};
+}
+function ao(e) {
+	return typeof e != "string" || !e.startsWith("【更早对话摘要") ? null : { body: e.replace(/^【[^】]*】\n?/, "") };
+}
+function oo(e) {
+	return `${ro}${e.cumulative ? `(${e.rounds ?? 0} 轮,含累积)` : e.rounds ? `(${e.rounds} 轮)` : ""}】\n${e.body}`;
+}
+function so(e, t, n) {
+	return oo(io({
+		body: n,
+		rounds: e.length
+	}, t ?? void 0));
+}
+function co(e, t) {
+	if (t <= 0) return { trimmed: !1 };
+	let n = eo(e);
+	if (n.length <= t) return { trimmed: !1 };
+	let r = n[n.length - t].startIdx, i = n.slice(0, n.length - t), a = n[0].startIdx, o = null;
+	for (let t = 0; t < a; t++) {
+		let n = e[t];
+		if (n.role === "system" && (o = ao(n.content), o)) break;
+	}
+	return {
+		trimmed: !0,
+		deleteFrom: 0,
+		deleteCount: r,
+		summary: {
+			role: "system",
+			content: oo(io({
+				body: i.map((e) => {
+					let t = to(e.userMsg.content, 60) || "(空)", n = e.assistantMsgs[0] ? to(e.assistantMsgs[0].content, 80) : "(无回复)";
+					return `- 第${e.round}轮:${t} → ${n}`;
+				}).join("\n"),
+				rounds: i.length
+			}, o ?? void 0)),
+			timestamp: i[0].userMsg.timestamp
+		},
+		older: i,
+		prevSeg: o
+	};
+}
+//#endregion
+//#region src/core/composables/contextIndex.ts
+var lo = /* @__PURE__ */ new Set(/* @__PURE__ */ "的.了.是.在.我.你.他.她.它.这.那.和.与.及.或.一个.什么.怎么.如何.为什么.可以.能.请.帮.一下.需要.想要.the.a.an.is.are.of.to.in.on".split("."));
+function uo(e) {
+	return e.toLowerCase().split(/[^a-z0-9一-龥]+/i).map((e) => e.trim()).filter((e) => e.length >= 2 && !lo.has(e));
+}
+function fo(e) {
+	let t = typeof e.content == "string" ? e.content : "";
+	if (e.reasoning && (t += e.reasoning), e.steps) for (let n of e.steps) t += " " + (n.name || ""), n.args != null && (t += " " + (typeof n.args == "string" ? n.args : JSON.stringify(n.args))), n.result && (t += " " + n.result);
+	return X(t);
+}
+function po(e) {
+	let t = fo(e.userMsg);
+	for (let n of e.assistantMsgs) t += fo(n);
+	return t;
+}
+function mo(e, t) {
+	return e.map((e) => {
+		let n = to(e.userMsg.content, 60) || "(空)", r = e.assistantMsgs[0] ? to(e.assistantMsgs[0].content, 80) : "(无回复)", i = e.assistantMsgs.flatMap((e) => (e.steps || []).map((e) => e.name)), a = i.length ? ` [工具: ${i.join(", ")}]` : "", o = "";
+		if (t && t.size) {
+			let n = [];
+			for (let r of e.assistantMsgs) for (let e of r.steps || []) e.name && t.has(e.name) && e.result && n.push(`${e.name}: ${to(e.result, 120)}`);
+			n.length && (o = `\n  字段提示: ${n.join(" | ")}`);
+		}
+		return `- 第${e.round}轮：${n} → ${r}${a}${o}`;
+	}).join("\n");
+}
+function ho(e, t, n) {
+	let r = uo(t);
+	return r.length === 0 ? [] : e.map((e) => {
+		let t = (e.userMsg.content + " " + e.assistantMsgs.map((e) => e.content).join(" ") + " " + e.assistantMsgs.flatMap((e) => (e.steps || []).map((e) => to(e.result || "", 120))).join(" ")).toLowerCase(), n = 0;
+		for (let e of r) t.includes(e) && n++;
+		return {
+			r: e,
+			score: n
+		};
+	}).filter((e) => e.score > 0).sort((e, t) => t.score - e.score).slice(0, n).map((e) => e.r);
+}
+function go(e, t) {
+	return t.contextWindow && t.contextWindow > 0 ? e.reduce((e, t) => e + po(t), 0) > t.contextWindow * (t.summaryThresholdRatio ?? .5) : e.length > (t.summaryThresholdRounds ?? 8);
+}
+//#endregion
+//#region src/core/composables/useContextManager.ts
+var _o = {
+	windowRounds: 6,
+	summaryThresholdRounds: 8,
+	toolResultMaxChars: 800,
+	enableRecall: !0,
+	recallTopK: 3,
+	enableLLMSummary: !1
+};
+function vo(e = {}) {
+	let t = {
+		..._o,
+		...e
+	};
+	async function n(e, n) {
+		let r = eo(e), i = e.length, a = "";
+		if (r.length) {
+			let t = r[0].startIdx;
+			for (let n = 0; n < t; n++) {
+				let t = e[n];
+				if (t.role === "system") {
+					let e = ao(t.content);
+					if (e) {
+						a = e.body;
+						break;
+					}
+				}
+			}
+		}
+		let o = (t) => ({
+			messages: e,
+			stats: {
+				triggered: !1,
+				roundsTotal: r.length,
+				roundsSummarized: 0,
+				roundsRecalled: 0,
+				originalMessages: i,
+				compressedMessages: i,
+				strategy: t
+			}
+		});
+		if (!go(r, t)) return o("none");
+		let s, c, l;
+		if (t.contextWindow && t.contextWindow > 0) {
+			let e = t.contextWindow * (n?.windowRatio ?? t.windowRatio ?? .4), i = 0, a = 0;
+			for (let t = r.length - 1; t >= 0; t--) if (i += po(r[t]), i >= e) {
+				a = t + 1;
+				break;
+			}
+			if (a > r.length - 1 && (a = r.length - 1), a < 0 && (a = 0), s = r.slice(a), c = r.slice(0, a), !c.length) return o("none");
+			l = "token-window+";
+		} else {
+			let e = n?.keepRounds ?? t.windowRounds, i = Math.min(Math.max(1, e), r.length);
+			if (s = r.slice(r.length - i), c = r.slice(0, r.length - i), !c.length) return o("none");
+			l = "window+";
+		}
+		let u = [...e].reverse().find((e) => e.role === "user")?.content || "", d = n?.summarize?.mode ?? (t.enableLLMSummary ? "llm" : "index"), f = /* @__PURE__ */ new Set([...t.preserveLastToolResults ?? [], ...n?.preserveTools ?? []]), p = f.size ? f : void 0, m, h;
+		if (d === "llm" && t.llmInvoke) try {
+			m = await t.llmInvoke(mo(c, p)), h = l + "llm_summary";
+		} catch {
+			m = mo(c, p), h = l + "index_summary(llm_fallback)";
+		}
+		else m = mo(c, p), h = l + "index_summary";
+		let g = n?.recallTopK == null ? t.enableRecall ? t.recallTopK : 0 : n.recallTopK, _ = g > 0 ? ho(c, u, g) : [], v = _.length ? _.map((e) => `- 第${e.round}轮：${to(e.userMsg.content, 60)} → ${e.assistantMsgs[0] ? to(e.assistantMsgs[0].content, 80) : ""}`).join("\n") : "", y = a ? `${m}\n【更早累积摘要】\n${a}` : m, b = [`【对话历史摘要】以下是之前 ${c.length} 轮对话的要点（最新 ${s.length} 轮已完整保留）：`, y];
+		if (n) {
+			let e = t.contextWindow && t.contextWindow > 0 ? `windowRatio=${n.windowRatio ?? t.windowRatio}` : `keepRounds=${n.keepRounds ?? t.windowRounds}`;
+			b.push(`\n(压缩决策:${e} · 摘要=${n.summarize.mode} · 召回=${g}${n.reason ? " · " + n.reason : ""})`);
+		}
+		v && b.push("\n【与当前问题可能相关的早期对话】", v);
+		let x = t.getRegisteredData ?? t.getRegisteredSlots;
+		if (x) try {
+			let e = x();
+			if (e.length) {
+				let t = e.map((e) => `- ${e.path ? e.path + ": " : ""}${e.description}`).join("\n");
+				b.push("\n【当前可操作数据(动态增删后的最新状态,操作前以 describe_data / read 为准)】", t);
+			}
+		} catch {}
+		let S = {
+			role: "system",
+			content: b.join("\n"),
+			timestamp: Date.now()
+		}, C = [];
+		for (let e of s) C.push(e.userMsg), C.push(...e.assistantMsgs);
+		let w = [S, ...C], T = w.reduce((e, t) => e + X(typeof t.content == "string" ? t.content : JSON.stringify(t.content)), 0);
+		return t.contextWindow && T > t.contextWindow && console.warn(`[page-agent-sdk] compress 后仍超窗口:${T} > ${t.contextWindow} tokens(单条消息超窗口,compress 无法压)`), {
+			messages: w,
+			stats: {
+				triggered: !0,
+				roundsTotal: r.length,
+				roundsSummarized: c.length,
+				roundsRecalled: _.length,
+				originalMessages: i,
+				compressedMessages: w.length,
+				strategy: h,
+				decision: n
+			}
+		};
+	}
+	return {
+		compress: n,
+		config: t
+	};
+}
+//#endregion
+//#region src/core/harness/summarization.ts
+function yo(e = {}) {
+	let t = vo(e);
+	return Object.assign({
+		name: "summarization",
+		compressInput: async (n) => {
+			let r;
+			if (e.decideInvoke) {
+				let i = eo(n);
+				if (go(i, t.config)) {
+					let a = t.config.contextWindow && t.config.contextWindow > 0 ? "token" : "rounds", o = a === "token" ? `历史 token 超阈值 ${Math.round((t.config.contextWindow ?? 0) * (t.config.summaryThresholdRatio ?? .5))}` : `轮数 ${i.length} 超阈值 ${t.config.summaryThresholdRounds}`;
+					try {
+						r = await e.decideInvoke({
+							getMessages: () => n,
+							getSnapshot: e.getSnapshot,
+							contextWindow: t.config.contextWindow,
+							thresholdRatio: t.config.summaryThresholdRatio,
+							triggerReason: o,
+							triggerMode: a
+						}) ?? void 0;
+					} catch {
+						r = void 0;
+					}
+				}
+			}
+			let { messages: i, stats: a } = await t.compress(n, r);
+			return {
+				messages: i,
+				stats: a
+			};
+		}
+	}, { setContextWindow(e) {
+		t.config.contextWindow = e;
+	} });
+}
+//#endregion
+//#region src/core/harness/subagent.ts
+function bo(e) {
 	return !!e && typeof e == "object" && typeof e.invoke == "function" && typeof e.stream == "function";
 }
-var to = [
+var xo = [
 	"describe_data",
 	"get_data",
 	"read",
 	"query_data",
 	"search_data",
 	"fetch_document"
-], no = 1, ro = 4, io = 6, ao = ["spawn_agent", "spawn_agents"], oo = [
+], So = 1, Co = 4, wo = 6, To = ["spawn_agent", "spawn_agents"], Eo = [
 	"write",
 	"set_data",
 	"edit_data",
 	"delete_data",
 	"draft_commit"
 ];
-function so(e) {
+function Do(e) {
 	let t = [];
 	if (typeof e.jsonPath == "string" && e.jsonPath && t.push(e.jsonPath), typeof e.path == "string" && e.path && t.push(e.path), e.patch && typeof e.patch.jsonPath == "string" && t.push(e.patch.jsonPath), Array.isArray(e.patches)) for (let n of e.patches) n && typeof n.jsonPath == "string" && t.push(n.jsonPath);
 	return t;
 }
-function co(e, t) {
+function Oo(e, t) {
 	return t.some((t) => e === t || e.startsWith(t + ".") || e.startsWith(t + "["));
 }
-function lo(e, t) {
+function ko(e, t) {
 	let n = e.invoke.bind(e), r = async (e) => {
-		let r = so(e);
+		let r = Do(e);
 		if (!r.length) return `PATH_OUT_OF_SCOPE:子 agent 仅可增量 patch(writablePaths: ${t.join(", ")}),不能整体替换(无 jsonPath)。用 write({patch:{jsonPath,...}}) 增量改。`;
-		for (let e of r) if (!co(e, t)) return `PATH_OUT_OF_SCOPE:子 agent 写 "${e}" 越界(仅可写 ${t.join(", ")})。`;
+		for (let e of r) if (!Oo(e, t)) return `PATH_OUT_OF_SCOPE:子 agent 写 "${e}" 越界(仅可写 ${t.join(", ")})。`;
 		return n(e);
 	};
 	return new Proxy(e, { get(e, t, n) {
 		return t === "invoke" ? r : Reflect.get(e, t, n);
 	} });
 }
-async function uo(e, t, n, r, i) {
-	let a = t.depth ?? 0, o = t.maxDepth ?? no, s = /* @__PURE__ */ new Set([...to, ...t.allowedTools ?? []]), c = () => typeof t.allTools == "function" ? t.allTools() : t.allTools, l = [...c().filter((e) => s.has(e.name) && !ao.includes(e.name)), ...t.extraTools ?? []];
+async function Ao(e, t, n, r, i) {
+	let a = t.depth ?? 0, o = t.maxDepth ?? So, s = /* @__PURE__ */ new Set([...xo, ...t.allowedTools ?? []]), c = () => typeof t.allTools == "function" ? t.allTools() : t.allTools, l = [...c().filter((e) => s.has(e.name) && !To.includes(e.name)), ...t.extraTools ?? []];
 	if (t.writablePaths?.length) {
-		l = l.filter((e) => !oo.includes(e.name));
-		let e = c().filter((e) => oo.includes(e.name) && !ao.includes(e.name)).map((e) => lo(e, t.writablePaths));
+		l = l.filter((e) => !Eo.includes(e.name));
+		let e = c().filter((e) => Eo.includes(e.name) && !To.includes(e.name)).map((e) => ko(e, t.writablePaths));
 		l = [...l, ...e];
 	}
-	let u = a + 1 < o ? [fo({
+	let u = a + 1 < o ? [jo({
 		...t,
 		depth: a + 1
 	})] : [], d = t.getFocuses?.() ?? [], f = d.length ? pa({
 		getSchema: t.getSchema ?? (() => null),
 		initialFocuses: d
 	}) : void 0, p = ni({
-		model: eo(t.llm) ? t.llm.model ?? t.llm.modelName : e.model ?? t.llm.model,
+		model: bo(t.llm) ? t.llm.model ?? t.llm.modelName : e.model ?? t.llm.model,
 		contextWindow: t.llm.contextWindow,
 		maxOutputTokens: t.llm.maxOutputTokens
 	});
 	if (p.contextWindow < 2e5) throw Error(`[page-agent-sdk][subagent] 子 agent 模型上下文窗口 ${p.contextWindow} 小于最小支持 ${ti}(需 ≥200K 窗口模型)`);
-	let m = ji({
+	let m = t.summarization === void 0 ? void 0 : yo(typeof t.summarization == "object" ? {
+		contextWindow: p.contextWindow,
+		...t.summarization
+	} : { contextWindow: p.contextWindow }), h = ji({
 		contextWindow: p.contextWindow,
 		maxOutputTokens: p.maxOutputTokens,
-		...eo(t.llm) ? { llm: t.llm } : {
+		...bo(t.llm) ? { llm: t.llm } : {
 			apiKey: t.llm.apiKey,
 			baseUrl: t.llm.baseUrl,
 			model: e.model ?? t.llm.model,
@@ -3996,14 +4253,16 @@ async function uo(e, t, n, r, i) {
 		tools: l,
 		middleware: [
 			...t.skills?.length ? [Na(t.skills)] : [],
+			...m ? [m] : [],
 			...u,
-			...f ? [f] : []
+			...f ? [f] : [],
+			...t.middleware ?? []
 		],
-		maxToolRounds: t.maxToolRounds ?? io,
+		maxToolRounds: t.maxToolRounds ?? wo,
 		onLog: i,
 		debug: t.debug
 	});
-	return t.debug && console.log(`[subagent] 启动子 agent(depth=${a},工具 ${l.length} 个)`), m.stream([{
+	return t.debug && console.log(`[subagent] 启动子 agent(depth=${a},工具 ${l.length} 个)`), h.stream([{
 		role: "user",
 		content: e.prompt,
 		timestamp: Date.now()
@@ -4011,8 +4270,8 @@ async function uo(e, t, n, r, i) {
 		r && (e.type === "tool_call" || e.type === "tool_result") && r(e);
 	}, n);
 }
-function fo(e) {
-	let n = e.maxParallel ?? ro, i, a, o, s = (e, t) => (n) => {
+function jo(e) {
+	let n = e.maxParallel ?? Co, i, a, o, s = (e, t) => (n) => {
 		a && a({
 			type: "subagent",
 			taskId: e,
@@ -4032,7 +4291,7 @@ function fo(e) {
 				...r?.length ? { allowedTools: r } : {},
 				...a?.length ? { writablePaths: a } : {}
 			} : e, u = `sub-${Math.random().toString(36).slice(2, 8)}`, d = n?.trim() || "子任务";
-			return await uo({
+			return await Ao({
 				prompt: t,
 				role: n,
 				model: c
@@ -4052,7 +4311,7 @@ function fo(e) {
 			})
 		}), r(async ({ tasks: t }) => (await Qr(t, n, async (t, n) => {
 			let r = `sub-${n}-${Math.random().toString(36).slice(2, 6)}`, a = t.role?.trim() || `子任务${n + 1}`;
-			return uo(t, e, i, s(r, a), (e) => o?.({
+			return Ao(t, e, i, s(r, a), (e) => o?.({
 				...e,
 				source: `子:${a}`
 			}));
@@ -4067,8 +4326,8 @@ function fo(e) {
 		wrapToolCall: async (e, t) => (e.signal && (i = e.signal), e.emit && (a = e.emit), e.logSink && (o = e.logSink), t(e))
 	};
 }
-var po = /^[a-zA-Z_][a-zA-Z0-9_]*$/;
-function mo(e, t) {
+var Mo = /^[a-zA-Z_][a-zA-Z0-9_]*$/;
+function No(e, t) {
 	let n = e.tools ?? [];
 	return {
 		llm: e.llm ?? t.llm,
@@ -4081,11 +4340,14 @@ function mo(e, t) {
 		maxToolRounds: e.maxToolRounds,
 		debug: t.debug,
 		...e.writablePaths?.length ? { writablePaths: e.writablePaths } : {},
+		...e.allowedTools?.length ? { allowedTools: e.allowedTools } : {},
+		...e.middleware?.length ? { middleware: e.middleware } : {},
+		...e.summarization === void 0 ? {} : { summarization: e.summarization },
 		...t.getFocuses ? { getFocuses: t.getFocuses } : {},
 		...t.getSchema ? { getSchema: t.getSchema } : {}
 	};
 }
-function ho(e, n) {
+function Po(e, n) {
 	let i, a, o, s = (e, t) => (n) => {
 		a && a({
 			type: "subagent",
@@ -4101,7 +4363,7 @@ function ho(e, n) {
 	function d(e) {
 		let a = /* @__PURE__ */ new Set(), c = [], l = [];
 		for (let u of e) {
-			if (!po.test(u.id)) {
+			if (!Mo.test(u.id)) {
 				console.warn(`[subagents] id "${u.id}" 非合法工具名(须 [a-zA-Z_][a-zA-Z0-9_]*),已跳过`);
 				continue;
 			}
@@ -4111,8 +4373,8 @@ function ho(e, n) {
 				continue;
 			}
 			a.add(e), c.push(u), l.push(r(async ({ task: e }) => {
-				let t = mo(u, n);
-				return uo({ prompt: e }, t, i, s(`use_${u.id}`, u.id), (e) => o?.({
+				let t = No(u, n);
+				return Ao({ prompt: e }, t, i, s(`use_${u.id}`, u.id), (e) => o?.({
 					...e,
 					source: `子:${u.id}`
 				}));
@@ -4156,7 +4418,7 @@ function ho(e, n) {
 		augmentPrompt: () => c.length ? [
 			"## 可用子 agent(预声明,经专属工具委派)",
 			...c.map((e) => `- use_${e.id}: ${e.description}`),
-			"需要某子 agent 时,直接调用对应的 use_<id>({ task }) 委派,任务描述要清晰。"
+			"复杂或专项任务(检索 / 生成 / 调研 / 多步等)优先委派子 agent:过程隔离不占主上下文 + 各子 agent 专项处理更优。需要时直接调 use_<id>({ task }) 委派,任务描述要清晰(含背景 + 用户观点/反馈,转述给子 agent);委派后信任子 agent 自主完成,不微操、不读其代码/中间细节(少占主上下文),只据其结论继续。简单任务(单字段改、直接读)用内置工具更快,不必委派。"
 		].join("\n") : void 0,
 		wrapToolCall: async (e, t) => (e.signal && (i = e.signal), e.emit && (a = e.emit), e.logSink && (o = e.logSink), t(e))
 	};
@@ -4172,7 +4434,7 @@ function ho(e, n) {
 }
 //#endregion
 //#region src/core/harness/verify.ts
-function go(e) {
+function Fo(e) {
 	return {
 		name: "verify",
 		async beforeReturn({ messages: t, state: n, log: r }) {
@@ -4184,10 +4446,10 @@ function go(e) {
 			if (e.adversarial) {
 				r?.("middleware", {
 					stage: "adversarial_start",
-					model: wo(e.adversarial.llm),
+					model: Uo(e.adversarial.llm),
 					tools: (e.adversarial.tools ?? []).length
 				});
-				let n = await Oo(t, e.adversarial.llm, r, e.adversarial.tools);
+				let n = await qo(t, e.adversarial.llm, r, e.adversarial.tools);
 				if (r?.("middleware", {
 					stage: "adversarial_done",
 					clean: n === null,
@@ -4198,18 +4460,18 @@ function go(e) {
 		}
 	};
 }
-var _o = /* @__PURE__ */ new Set([
+var Io = /* @__PURE__ */ new Set([
 	"set_data",
 	"edit_data",
 	"delete_data",
 	"write"
-]), vo = /校验失败|SCHEMA_INVALID|未注册|不存在|仅支持|必须是|NOT_OBJECT|PATH_UNSAFE|VERSION_CONFLICT|WRITE_INTERCEPT/;
-function yo(e) {
+]), Lo = /校验失败|SCHEMA_INVALID|未注册|不存在|仅支持|必须是|NOT_OBJECT|PATH_UNSAFE|VERSION_CONFLICT|WRITE_INTERCEPT/;
+function Ro(e) {
 	let t = /* @__PURE__ */ new Map();
 	for (let n of e) {
 		let e = n?.tool_calls;
 		if (Array.isArray(e)) for (let n of e) {
-			if (!_o.has(n.name)) continue;
+			if (!Io.has(n.name)) continue;
 			let e = n.id, r = n?.args ?? {};
 			if (n.name === "write") if (r.del && r.patch?.jsonPath) t.set(r.patch.jsonPath, {
 				path: r.patch.jsonPath,
@@ -4248,7 +4510,7 @@ function yo(e) {
 	}
 	return [...t.values()];
 }
-function bo(e) {
+function zo(e) {
 	let t = /* @__PURE__ */ new Map();
 	for (let n of e) {
 		let e = n?.tool_call_id, r = n?.content;
@@ -4256,7 +4518,7 @@ function bo(e) {
 	}
 	return t;
 }
-function xo(e, t) {
+function Bo(e, t) {
 	if (t === "") return e;
 	if (e == null) return;
 	let n = e;
@@ -4266,16 +4528,16 @@ function xo(e, t) {
 	}
 	return n;
 }
-function So(e = {}) {
+function Vo(e = {}) {
 	let t = typeof e.root == "function" ? e.root : e.root === void 0 ? () => e.window ?? globalThis.window : () => e.root, n = typeof e.schemas == "function" ? e.schemas : () => e.schemas ?? {};
 	return async ({ messages: e }) => {
-		let r = yo(e);
+		let r = Ro(e);
 		if (!r.length) return { ok: !0 };
-		let i = bo(e), a = n()[""], o = t(), s = [];
+		let i = zo(e), a = n()[""], o = t(), s = [];
 		for (let { path: e, op: t, callId: n } of r) {
 			let r = n ? i.get(n) : void 0;
-			if (r && vo.test(r)) continue;
-			let c = xo(o, e);
+			if (r && Lo.test(r)) continue;
+			let c = Bo(o, e);
 			if (t === "delete_data") c !== void 0 && s.push(`${e} 删除后读回仍有值,疑似未生效`);
 			else if (c == null) s.push(`写入 ${e} 后读回为空,疑似未生效`);
 			else if (a) {
@@ -4289,17 +4551,17 @@ function So(e = {}) {
 		} : { ok: !0 };
 	};
 }
-function Co(e) {
+function Ho(e) {
 	return !!e && typeof e == "object" && typeof e.invoke == "function" && typeof e.stream == "function";
 }
-function wo(e) {
-	return Co(e) ? e.model ?? e.modelName ?? "<实例>" : e.model ?? "<配置>";
+function Uo(e) {
+	return Ho(e) ? e.model ?? e.modelName ?? "<实例>" : e.model ?? "<配置>";
 }
-var To = /无问题|没有问题|未发现问题|没有发现|没问题|未发现/;
-function Eo(e) {
-	return To.test(e);
+var Wo = /无问题|没有问题|未发现问题|没有发现|没问题|未发现/;
+function Go(e) {
+	return Wo.test(e);
 }
-function Do(e) {
+function Ko(e) {
 	let t = "", n = "";
 	for (let r of e) r instanceof a ? t = typeof r.content == "string" ? r.content : "" : r instanceof i && !(r.tool_calls?.length > 0) && (n = typeof r.content == "string" ? r.content : "");
 	return {
@@ -4307,8 +4569,8 @@ function Do(e) {
 		lastReply: n
 	};
 }
-async function Oo(e, t, n, r) {
-	let { lastUser: i, lastReply: a } = Do(e);
+async function qo(e, t, n, r) {
+	let { lastUser: i, lastReply: a } = Ko(e);
 	if (!a) return null;
 	let o = Array.isArray(r) && r.length > 0, s = [
 		"你是严格的对抗式审查者,目标是找出以下 AI 助手回复的错误并证明它有问题(事实错误 / 遗漏 / 逻辑矛盾 / 与需求不符)。",
@@ -4319,7 +4581,7 @@ async function Oo(e, t, n, r) {
 	].join("\n"), c = "你是严格的对抗式审查者,只找问题不赞美。目标是反驳,不是改进。", l = n ? (e) => n(e.type, {
 		...e.data,
 		source: "adversarial"
-	}) : void 0, u = await ji(Co(t) ? {
+	}) : void 0, u = await ji(Ho(t) ? {
 		llm: t,
 		tools: r,
 		maxToolRounds: o ? 4 : 1,
@@ -4344,11 +4606,11 @@ async function Oo(e, t, n, r) {
 		stage: "adversarial_verdict",
 		verdict: u,
 		source: "adversarial"
-	}), Eo(u) ? null : u.trim();
+	}), Go(u) ? null : u.trim();
 }
 //#endregion
 //#region src/core/utils/contextAnalysis.ts
-var ko = [
+var Jo = [
 	{
 		prefix: "## 可操作数据",
 		key: "dataHint"
@@ -4377,7 +4639,7 @@ var ko = [
 		prefix: "【与当前问题可能相关的早期对话】",
 		key: "recall"
 	}
-], Ao = [
+], Yo = [
 	{
 		key: "systemPrompt",
 		label: "系统提示词(身份/规则)"
@@ -4431,9 +4693,9 @@ var ko = [
 		label: "其他"
 	}
 ];
-function jo() {
+function Xo() {
 	let e = {};
-	for (let t of Ao) e[t.key] = {
+	for (let t of Yo) e[t.key] = {
 		key: t.key,
 		label: t.label,
 		tokens: 0,
@@ -4442,16 +4704,16 @@ function jo() {
 	};
 	return e;
 }
-function Mo(e, t) {
+function Zo(e, t) {
 	e.tokens += t, e.msgCount += 1;
 }
-function No(e) {
+function Qo(e) {
 	let t = e.content;
 	return typeof t == "string" ? t : JSON.stringify(t ?? "");
 }
-function Po(e, t) {
+function $o(e, t) {
 	let n = [];
-	for (let t of ko) {
+	for (let t of Jo) {
 		let r = 0;
 		for (;;) {
 			let i = e.indexOf(t.prefix, r);
@@ -4464,35 +4726,35 @@ function Po(e, t) {
 	}
 	if (n.sort((e, t) => e.idx - t.idx), !n.length) {
 		let n = e.trim();
-		n && Mo(t.systemPrompt, X(n));
+		n && Zo(t.systemPrompt, X(n));
 		return;
 	}
 	if (n[0].idx > 0) {
 		let r = e.slice(0, n[0].idx).trim();
-		r && Mo(t.systemPrompt, X(r));
+		r && Zo(t.systemPrompt, X(r));
 	}
 	for (let r = 0; r < n.length; r++) {
 		let i = n[r].idx, a = r + 1 < n.length ? n[r + 1].idx : e.length, o = e.slice(i, a).trim();
-		o && Mo(t[n[r].key], X(o));
+		o && Zo(t[n[r].key], X(o));
 	}
 }
-function Fo(e, t = {}) {
-	let n = jo(), r = -1;
+function es(e, t = {}) {
+	let n = Xo(), r = -1;
 	for (let t = e.length - 1; t >= 0; t--) if (e[t] instanceof a) {
 		r = t;
 		break;
 	}
 	for (let t = 0; t < e.length; t++) {
 		let c = e[t];
-		if (c instanceof o) Po(No(c), n);
-		else if (c instanceof a) Mo(n[t === r ? "current" : "history"], X(No(c)));
+		if (c instanceof o) $o(Qo(c), n);
+		else if (c instanceof a) Zo(n[t === r ? "current" : "history"], X(Qo(c)));
 		else if (c instanceof i) {
 			let e = c.tool_calls ?? [];
 			if (e.length) {
 				let t = e.map((e) => JSON.stringify(e.args ?? {})).join(" ");
-				Mo(n.toolResults, X(t));
-			} else Mo(n.assistant, X(No(c)));
-		} else c instanceof s ? Mo(n.toolResults, X(No(c))) : Mo(n.other, X(No(c)));
+				Zo(n.toolResults, X(t));
+			} else Zo(n.assistant, X(Qo(c)));
+		} else c instanceof s ? Zo(n.toolResults, X(Qo(c))) : Zo(n.other, X(Qo(c)));
 	}
 	let c = Object.values(n).filter((e) => e.tokens > 0);
 	c.sort((e, t) => t.tokens - e.tokens);
@@ -4509,12 +4771,12 @@ function Fo(e, t = {}) {
 }
 //#endregion
 //#region src/core/harness/contextInspector.ts
-function Io(e = {}) {
+function ts(e = {}) {
 	let t, n = e.contextWindow;
 	return {
 		name: "context-inspector",
 		async wrapModelCall(r, i) {
-			return t = Fo(r.messages, {
+			return t = es(r.messages, {
 				contextWindow: n,
 				thresholdRatio: e.thresholdRatio
 			}), i(r);
@@ -4527,13 +4789,13 @@ function Io(e = {}) {
 }
 //#endregion
 //#region src/core/mcp/client.ts
-function Lo(e) {
+function ns(e) {
 	let t = e?.content;
 	if (!Array.isArray(t) || !t.length) return "";
 	let n = t.map((e) => e.type === "text" && e.text ? e.text : e.type === "image" && e.data ? `[image:${String(e.data).slice(0, 32)}…]` : e.type === "audio" && e.data ? "[audio]" : e.type === "resource" && e.resource ? e.resource.text ?? e.resource.blob ?? "" : "").filter(Boolean).join("\n");
 	return e?.isError ? `工具错误:${n}` : n;
 }
-async function Ro(e) {
+async function rs(e) {
 	let t = new URL(e.url), n = e.requestInit;
 	if (e.transport === "http") {
 		let { StreamableHTTPClientTransport: e } = await import("@modelcontextprotocol/sdk/client/streamableHttp.js");
@@ -4546,8 +4808,8 @@ async function Ro(e) {
 	let { WebSocketClientTransport: r } = await import("@modelcontextprotocol/sdk/client/websocket.js");
 	return new r(t);
 }
-function zo(e, t) {
-	return r(async (n) => Lo(await t.callTool({
+function is(e, t) {
+	return r(async (n) => ns(await t.callTool({
 		name: e.name,
 		arguments: n
 	})), {
@@ -4556,273 +4818,19 @@ function zo(e, t) {
 		schema: e.inputSchema
 	});
 }
-async function Bo(e) {
-	let { Client: t } = await import("@modelcontextprotocol/sdk/client"), n = await Ro(e), r = new t({
+async function as(e) {
+	let { Client: t } = await import("@modelcontextprotocol/sdk/client"), n = await rs(e), r = new t({
 		name: "page-agent-sdk",
 		version: "1.0"
 	}, { capabilities: {} });
 	await r.connect(n);
 	let { tools: i } = await r.listTools();
 	return {
-		tools: i.map((e) => zo(e, r)),
+		tools: i.map((e) => is(e, r)),
 		close: () => r.close()
 	};
 }
 //#endregion
-//#region src/core/utils/rounds.ts
-function Vo(e) {
-	let t = [], n = null, r = 0;
-	for (let i = 0; i < e.length; i++) {
-		let a = e[i];
-		a.role === "user" ? (n && t.push(n), r++, n = {
-			round: r,
-			userMsg: a,
-			assistantMsgs: [],
-			startIdx: i,
-			endIdx: i
-		}) : n && (n.assistantMsgs.push(a), n.endIdx = i);
-	}
-	return n && t.push(n), t;
-}
-function Ho(e, t) {
-	let n = (e || "").replace(/```[\s\S]*?```/g, "[代码]").replace(/`([^`]+)`/g, "$1").replace(/[#*_>\-]\s?/g, "").replace(/\[(代码)\]/g, "「代码」").replace(/\s+/g, " ").trim();
-	return n.length > t ? n.slice(0, t) + "…" : n;
-}
-function Uo(e) {
-	let t = [];
-	for (let n of e.assistantMsgs) for (let e of n.steps || []) t.push(e.name);
-	return t;
-}
-var Wo = "【更早对话摘要";
-function Go(e, t) {
-	return !t || !t.body ? e : {
-		body: `${t.body}\n【续】\n${e.body}`,
-		rounds: (t.rounds ?? 0) + (e.rounds ?? 0),
-		cumulative: !0
-	};
-}
-function Ko(e) {
-	return typeof e != "string" || !e.startsWith("【更早对话摘要") ? null : { body: e.replace(/^【[^】]*】\n?/, "") };
-}
-function qo(e) {
-	return `${Wo}${e.cumulative ? `(${e.rounds ?? 0} 轮,含累积)` : e.rounds ? `(${e.rounds} 轮)` : ""}】\n${e.body}`;
-}
-function Jo(e, t, n) {
-	return qo(Go({
-		body: n,
-		rounds: e.length
-	}, t ?? void 0));
-}
-function Yo(e, t) {
-	if (t <= 0) return { trimmed: !1 };
-	let n = Vo(e);
-	if (n.length <= t) return { trimmed: !1 };
-	let r = n[n.length - t].startIdx, i = n.slice(0, n.length - t), a = n[0].startIdx, o = null;
-	for (let t = 0; t < a; t++) {
-		let n = e[t];
-		if (n.role === "system" && (o = Ko(n.content), o)) break;
-	}
-	return {
-		trimmed: !0,
-		deleteFrom: 0,
-		deleteCount: r,
-		summary: {
-			role: "system",
-			content: qo(Go({
-				body: i.map((e) => {
-					let t = Ho(e.userMsg.content, 60) || "(空)", n = e.assistantMsgs[0] ? Ho(e.assistantMsgs[0].content, 80) : "(无回复)";
-					return `- 第${e.round}轮:${t} → ${n}`;
-				}).join("\n"),
-				rounds: i.length
-			}, o ?? void 0)),
-			timestamp: i[0].userMsg.timestamp
-		},
-		older: i,
-		prevSeg: o
-	};
-}
-//#endregion
-//#region src/core/composables/contextIndex.ts
-var Xo = /* @__PURE__ */ new Set(/* @__PURE__ */ "的.了.是.在.我.你.他.她.它.这.那.和.与.及.或.一个.什么.怎么.如何.为什么.可以.能.请.帮.一下.需要.想要.the.a.an.is.are.of.to.in.on".split("."));
-function Zo(e) {
-	return e.toLowerCase().split(/[^a-z0-9一-龥]+/i).map((e) => e.trim()).filter((e) => e.length >= 2 && !Xo.has(e));
-}
-function Qo(e) {
-	let t = typeof e.content == "string" ? e.content : "";
-	if (e.reasoning && (t += e.reasoning), e.steps) for (let n of e.steps) t += " " + (n.name || ""), n.args != null && (t += " " + (typeof n.args == "string" ? n.args : JSON.stringify(n.args))), n.result && (t += " " + n.result);
-	return X(t);
-}
-function $o(e) {
-	let t = Qo(e.userMsg);
-	for (let n of e.assistantMsgs) t += Qo(n);
-	return t;
-}
-function es(e, t) {
-	return e.map((e) => {
-		let n = Ho(e.userMsg.content, 60) || "(空)", r = e.assistantMsgs[0] ? Ho(e.assistantMsgs[0].content, 80) : "(无回复)", i = e.assistantMsgs.flatMap((e) => (e.steps || []).map((e) => e.name)), a = i.length ? ` [工具: ${i.join(", ")}]` : "", o = "";
-		if (t && t.size) {
-			let n = [];
-			for (let r of e.assistantMsgs) for (let e of r.steps || []) e.name && t.has(e.name) && e.result && n.push(`${e.name}: ${Ho(e.result, 120)}`);
-			n.length && (o = `\n  字段提示: ${n.join(" | ")}`);
-		}
-		return `- 第${e.round}轮：${n} → ${r}${a}${o}`;
-	}).join("\n");
-}
-function ts(e, t, n) {
-	let r = Zo(t);
-	return r.length === 0 ? [] : e.map((e) => {
-		let t = (e.userMsg.content + " " + e.assistantMsgs.map((e) => e.content).join(" ") + " " + e.assistantMsgs.flatMap((e) => (e.steps || []).map((e) => Ho(e.result || "", 120))).join(" ")).toLowerCase(), n = 0;
-		for (let e of r) t.includes(e) && n++;
-		return {
-			r: e,
-			score: n
-		};
-	}).filter((e) => e.score > 0).sort((e, t) => t.score - e.score).slice(0, n).map((e) => e.r);
-}
-function ns(e, t) {
-	return t.contextWindow && t.contextWindow > 0 ? e.reduce((e, t) => e + $o(t), 0) > t.contextWindow * (t.summaryThresholdRatio ?? .5) : e.length > (t.summaryThresholdRounds ?? 8);
-}
-//#endregion
-//#region src/core/composables/useContextManager.ts
-var rs = {
-	windowRounds: 6,
-	summaryThresholdRounds: 8,
-	toolResultMaxChars: 800,
-	enableRecall: !0,
-	recallTopK: 3,
-	enableLLMSummary: !1
-};
-function is(e = {}) {
-	let t = {
-		...rs,
-		...e
-	};
-	async function n(e, n) {
-		let r = Vo(e), i = e.length, a = "";
-		if (r.length) {
-			let t = r[0].startIdx;
-			for (let n = 0; n < t; n++) {
-				let t = e[n];
-				if (t.role === "system") {
-					let e = Ko(t.content);
-					if (e) {
-						a = e.body;
-						break;
-					}
-				}
-			}
-		}
-		let o = (t) => ({
-			messages: e,
-			stats: {
-				triggered: !1,
-				roundsTotal: r.length,
-				roundsSummarized: 0,
-				roundsRecalled: 0,
-				originalMessages: i,
-				compressedMessages: i,
-				strategy: t
-			}
-		});
-		if (!ns(r, t)) return o("none");
-		let s, c, l;
-		if (t.contextWindow && t.contextWindow > 0) {
-			let e = t.contextWindow * (n?.windowRatio ?? t.windowRatio ?? .4), i = 0, a = 0;
-			for (let t = r.length - 1; t >= 0; t--) if (i += $o(r[t]), i >= e) {
-				a = t + 1;
-				break;
-			}
-			if (a > r.length - 1 && (a = r.length - 1), a < 0 && (a = 0), s = r.slice(a), c = r.slice(0, a), !c.length) return o("none");
-			l = "token-window+";
-		} else {
-			let e = n?.keepRounds ?? t.windowRounds, i = Math.min(Math.max(1, e), r.length);
-			if (s = r.slice(r.length - i), c = r.slice(0, r.length - i), !c.length) return o("none");
-			l = "window+";
-		}
-		let u = [...e].reverse().find((e) => e.role === "user")?.content || "", d = n?.summarize?.mode ?? (t.enableLLMSummary ? "llm" : "index"), f = /* @__PURE__ */ new Set([...t.preserveLastToolResults ?? [], ...n?.preserveTools ?? []]), p = f.size ? f : void 0, m, h;
-		if (d === "llm" && t.llmInvoke) try {
-			m = await t.llmInvoke(es(c, p)), h = l + "llm_summary";
-		} catch {
-			m = es(c, p), h = l + "index_summary(llm_fallback)";
-		}
-		else m = es(c, p), h = l + "index_summary";
-		let g = n?.recallTopK == null ? t.enableRecall ? t.recallTopK : 0 : n.recallTopK, _ = g > 0 ? ts(c, u, g) : [], v = _.length ? _.map((e) => `- 第${e.round}轮：${Ho(e.userMsg.content, 60)} → ${e.assistantMsgs[0] ? Ho(e.assistantMsgs[0].content, 80) : ""}`).join("\n") : "", y = a ? `${m}\n【更早累积摘要】\n${a}` : m, b = [`【对话历史摘要】以下是之前 ${c.length} 轮对话的要点（最新 ${s.length} 轮已完整保留）：`, y];
-		if (n) {
-			let e = t.contextWindow && t.contextWindow > 0 ? `windowRatio=${n.windowRatio ?? t.windowRatio}` : `keepRounds=${n.keepRounds ?? t.windowRounds}`;
-			b.push(`\n(压缩决策:${e} · 摘要=${n.summarize.mode} · 召回=${g}${n.reason ? " · " + n.reason : ""})`);
-		}
-		v && b.push("\n【与当前问题可能相关的早期对话】", v);
-		let x = t.getRegisteredData ?? t.getRegisteredSlots;
-		if (x) try {
-			let e = x();
-			if (e.length) {
-				let t = e.map((e) => `- ${e.path ? e.path + ": " : ""}${e.description}`).join("\n");
-				b.push("\n【当前可操作数据(动态增删后的最新状态,操作前以 describe_data / read 为准)】", t);
-			}
-		} catch {}
-		let S = {
-			role: "system",
-			content: b.join("\n"),
-			timestamp: Date.now()
-		}, C = [];
-		for (let e of s) C.push(e.userMsg), C.push(...e.assistantMsgs);
-		let w = [S, ...C], T = w.reduce((e, t) => e + X(typeof t.content == "string" ? t.content : JSON.stringify(t.content)), 0);
-		return t.contextWindow && T > t.contextWindow && console.warn(`[page-agent-sdk] compress 后仍超窗口:${T} > ${t.contextWindow} tokens(单条消息超窗口,compress 无法压)`), {
-			messages: w,
-			stats: {
-				triggered: !0,
-				roundsTotal: r.length,
-				roundsSummarized: c.length,
-				roundsRecalled: _.length,
-				originalMessages: i,
-				compressedMessages: w.length,
-				strategy: h,
-				decision: n
-			}
-		};
-	}
-	return {
-		compress: n,
-		config: t
-	};
-}
-//#endregion
-//#region src/core/harness/summarization.ts
-function as(e = {}) {
-	let t = is(e);
-	return Object.assign({
-		name: "summarization",
-		compressInput: async (n) => {
-			let r;
-			if (e.decideInvoke) {
-				let i = Vo(n);
-				if (ns(i, t.config)) {
-					let a = t.config.contextWindow && t.config.contextWindow > 0 ? "token" : "rounds", o = a === "token" ? `历史 token 超阈值 ${Math.round((t.config.contextWindow ?? 0) * (t.config.summaryThresholdRatio ?? .5))}` : `轮数 ${i.length} 超阈值 ${t.config.summaryThresholdRounds}`;
-					try {
-						r = await e.decideInvoke({
-							getMessages: () => n,
-							getSnapshot: e.getSnapshot,
-							contextWindow: t.config.contextWindow,
-							thresholdRatio: t.config.summaryThresholdRatio,
-							triggerReason: o,
-							triggerMode: a
-						}) ?? void 0;
-					} catch {
-						r = void 0;
-					}
-				}
-			}
-			let { messages: i, stats: a } = await t.compress(n, r);
-			return {
-				messages: i,
-				stats: a
-			};
-		}
-	}, { setContextWindow(e) {
-		t.config.contextWindow = e;
-	} });
-}
-//#endregion
 //#region src/core/sdk/promptBuilder.ts
 var os = [
 	"你是一个 JSON 操作助手。集成方声明了一个主数据对象(含 zod schema 校验),你通过专用工具安全地读写它来完成任务。",
@@ -4870,8 +4878,8 @@ function ds(e) {
 		description: "查看当前对话上下文的构成(供压缩决策)。返回:totalTokens(历史轮次 token 总和,与触发判断同口径)、occupancy(窗口占用比)、contextWindow、categories(分类占用)、rounds(每轮 token/工具/首句)。先调用本工具查看构成,再决定压缩策略。",
 		schema: us,
 		handler: (t) => {
-			let n = Vo(e.getMessages()), r = n.length > 50 ? n.slice(n.length - 50) : n, i = (t.limit && r.length > t.limit ? r.slice(r.length - t.limit) : r).map((e) => {
-				let n = $o(e), r = Uo(e), i = t.role === "assistant" ? e.assistantMsgs[0] ?? e.userMsg : e.userMsg, a = Ho(typeof i.content == "string" ? i.content : "", 60);
+			let n = eo(e.getMessages()), r = n.length > 50 ? n.slice(n.length - 50) : n, i = (t.limit && r.length > t.limit ? r.slice(r.length - t.limit) : r).map((e) => {
+				let n = po(e), r = no(e), i = t.role === "assistant" ? e.assistantMsgs[0] ?? e.userMsg : e.userMsg, a = to(typeof i.content == "string" ? i.content : "", 60);
 				return {
 					round: e.round,
 					tokens: n,
@@ -8590,7 +8598,7 @@ function au(e, n) {
 	e.debug && j.agentCompression && !p && console.warn("[page-agent-sdk][agentCompression] agentCompression 开启但 summaryLlm 不可用(或缺 apiKey / 模型不支持工具),压缩决策不启用,回退静态压缩");
 	let Oe = j.memory, ke = j.subagent, Ae = e.verify?.maxAttempts ?? 2, je = j.verify && e.verify?.enabled !== !1 && Ae > 0, Me = j.contextInspector;
 	e.verify?.check && !j.verify && console.warn("[page-agent-sdk][verify] 检测到 verify.check 但 capabilities.verify 未开启,verify 未装载");
-	let Ne = e.subagent, Pe = Ne?.allowedTools ?? [], Fe = !ke || Ne?.enabled === !1 ? void 0 : fo({
+	let Ne = e.subagent, Pe = Ne?.allowedTools ?? [], Fe = !ke || Ne?.enabled === !1 ? void 0 : jo({
 		llm: Ne?.llm ?? e.llm,
 		allTools: () => B,
 		allowedTools: Pe.length ? Pe : void 0,
@@ -8603,7 +8611,7 @@ function au(e, n) {
 		debug: e.debug,
 		getFocuses: () => w.getFocuses(),
 		getSchema: () => F()?.schema ?? null
-	}), Ie = ke && e.subagents !== void 0 ? ho(e.subagents, {
+	}), Ie = ke && e.subagents !== void 0 ? Po(e.subagents, {
 		llm: e.llm,
 		allTools: () => B,
 		debug: e.debug,
@@ -8614,8 +8622,8 @@ function au(e, n) {
 		"describe_data",
 		"read",
 		"fetch_document"
-	], V = B.filter((e) => Re.includes(e.name)), ze = je ? go({
-		check: e.verify.check ?? So({
+	], V = B.filter((e) => Re.includes(e.name)), ze = je ? Fo({
+		check: e.verify.check ?? Vo({
 			schemas: () => F() ? { "": F().schema } : {},
 			root: () => F()?.bind
 		}),
@@ -8623,7 +8631,7 @@ function au(e, n) {
 			llm: e.llm,
 			tools: V
 		} : void 0
-	}) : void 0, Be = Me ? Io({
+	}) : void 0, Be = Me ? ts({
 		contextWindow: m.contextWindow,
 		thresholdRatio: rc(e, m.contextWindow).summaryThresholdRatio
 	}) : void 0, Ve = Ul({
@@ -8681,7 +8689,7 @@ function au(e, n) {
 				W.infoTick.value++;
 			}
 		} catch {}
-	}, Qe = Ee ? as({
+	}, Qe = Ee ? yo({
 		...h,
 		llmInvoke: l,
 		getRegisteredData: () => F() ? [{ description: F().description ?? "主数据对象" }] : [],
@@ -9164,7 +9172,7 @@ function au(e, n) {
 		for (let t of e) delete x.files[t];
 	}
 	function st() {
-		let e = Yo(b, et);
+		let e = co(b, et);
 		if (!e.trimmed) return;
 		let { older: t, summary: n } = e;
 		if (H({
@@ -9182,9 +9190,9 @@ function au(e, n) {
 			let n = e.summary, { prevSeg: r } = e;
 			(async () => {
 				try {
-					let e = await l(es(t, v)), i = b.indexOf(n);
+					let e = await l(mo(t, v)), i = b.indexOf(n);
 					if (i < 0) return;
-					b[i].content = Jo(t, r, e), ut();
+					b[i].content = so(t, r, e), ut();
 				} catch {}
 			})();
 		}
@@ -9216,7 +9224,7 @@ function au(e, n) {
 	}
 	return W.initDone = (async () => {
 		if (await rt(), await it(), e.mcp?.length) {
-			let t = await Promise.allSettled(e.mcp.map((e) => Bo(e)));
+			let t = await Promise.allSettled(e.mcp.map((e) => as(e)));
 			W.mcpClosers = t.flatMap((e) => e.status === "fulfilled" ? [e.value.close] : []), W.mcpServers = [], t.forEach((t, n) => {
 				let r = e.mcp[n], i = r.name ?? r.url;
 				t.status === "fulfilled" ? (W.mcpServers.push({
@@ -9414,6 +9422,13 @@ function ou(e, t) {
 				value: r
 			}), { ok: !0 };
 		},
+		vfsWrite: (e, t) => {
+			let n = typeof t == "string" ? t : JSON.stringify(t);
+			a.vfsStore.files[Oc(e)] = {
+				content: n,
+				updatedAt: Date.now()
+			};
+		},
 		createResource: (e, t) => {
 			let n = a.dataOpsController;
 			if (!n?.createResource) throw Error("[page-agent-sdk] createResource 不可用:需配 data.resources + vfsStore(capabilities.vfs 默认开)");
@@ -9447,8 +9462,114 @@ function ou(e, t) {
 	};
 }
 //#endregion
+//#region src/core/sdk/ragSubagent.ts
+var su = "你是知识检索专家。可用工具:search_docs(语义检索)/ load_doc(按 source 加载)/ vfs_grep+vfs_read(搜预注入文档)/ fetch_document(公网 URL)。\n\n工作方式:\n1. 分析任务,拆出需查证的要点(如:需要哪些组件、各自的 props 约束、UI 规范要求);\n2. 多源检索:先 vfs_grep 搜预注入文档(快、静态)→ 不够用 search_docs 语义检索 → 需特定文档用 load_doc → 公网用 fetch_document;\n3. 检索结果不足时换关键词、扩大 topK、或换源重试;\n4. 综合成结构化、可执行结论(不堆原文,提炼成可直接用于决策/配置的信息);\n5. 标注关键信息来源(文档名/段落),便于溯源;检索不到明确说「未检索到」,不编造。\n\n你是只读检索角色,不要尝试修改任何数据。", cu = "# 知识检索策略(RAG)\n\n## 多源决策树\n- vfs_grep / vfs_read:搜集成方预注入 vfs 的文档(组件文档 / UI 规范)—— 快、静态,先查\n- search_docs:语义检索(retriever 向量库)—— 模糊匹配,关键词不确定 / 语义相似时用\n- load_doc:按 source 精确加载(已知文档 id / URL / key)—— 精确取特定文档\n- fetch_document:公网 URL —— 查公开资料\n\n## 综合规范\n- 多源交叉验证(关键结论优先 ≥2 源印证,或单一权威源)\n- 标注来源(文档名 / URL / 段落),便于溯源\n- 结构化、可执行结论(组件清单 + 各自 props 约束 + 适用场景),不堆原文\n- 未检索到明确说「未检索到」,不编造;建议替代方案(改关键词 / 建议写代码组件等)\n\n## 何时用何源\n- 静态文档(组件库文档 / UI 规范):vfs_grep\n- 语义相似(「瀑布流组件」「倒计时」「拼团」):search_docs\n- 已知文档 id / URL:load_doc\n- 公开 URL(设计规范网站 / 第三方文档):fetch_document", lu = {
+	name: "rag-search",
+	description: "多源知识检索策略:vfs 预注入文档 → 语义检索 → 指定文档加载 → 公网;综合结构化结论 + 溯源",
+	getContent: () => cu
+};
+function uu(e, n, i) {
+	return r(async ({ query: e, topK: t }) => {
+		try {
+			let r = await n(e, { topK: t ?? i });
+			return r?.length ? r.map((e, t) => `【${t + 1}】${e.source ? `来源:${e.source}\n` : ""}${e.content}`).join("\n\n") : `未检索到与「${e}」相关的内容。可换关键词或扩大 topK 重试。`;
+		} catch (e) {
+			return `检索出错:${e.message}。可换关键词重试。`;
+		}
+	}, {
+		name: e,
+		description: "语义检索知识库(组件文档/UI 规范/业务规则等),返回相关片段。需要查阅文档才能回答或配置时用;可多次调用不同关键词。",
+		schema: t.object({
+			query: t.string().describe("检索关键词或自然语言问题"),
+			topK: t.number().int().positive().optional().describe("期望召回数量(默认使用系统配置)")
+		})
+	});
+}
+function du(e, n) {
+	return r(async ({ source: e }) => {
+		try {
+			let t = await n(e), r = Array.isArray(t) ? t : [t];
+			return r.length ? r.map((e, t) => `【${t + 1}】${e.source ? `来源:${e.source}\n` : ""}${e.content}`).join("\n\n") : `未加载到「${e}」。检查 source 是否正确。`;
+		} catch (e) {
+			return `加载出错:${e.message}。`;
+		}
+	}, {
+		name: e,
+		description: "按 source 加载指定文档(文档 id/URL/key);已知要查的具体文档用此工具精确加载。",
+		schema: t.object({ source: t.string().describe("文档标识(id/URL/key)") })
+	});
+}
+function fu(e) {
+	let { retriever: t, loader: n, useVfs: r = !0, id: i = "rag", description: a, topK: o = 5, searchToolName: s = "search_docs", loadToolName: c = "load_doc", maxToolRounds: l = 8, summarization: u, skills: d, extraTools: f } = e;
+	if (!t && !n && r === !1) throw Error("[page-agent-sdk][createRagSubagent] 至少配一种知识源:retriever / loader / useVfs(true)");
+	let p = [];
+	t && p.push(uu(s, t, o)), n && p.push(du(c, n)), f && p.push(...f);
+	let m = r ? [
+		"vfs_grep",
+		"vfs_read",
+		"vfs_json_read"
+	] : void 0;
+	return {
+		id: i,
+		description: a ?? "检索知识库(组件文档/UI 规范/业务规则),返回有依据的结构化结论。需要查阅文档才能回答或决定如何配置时委派",
+		systemPrompt: su,
+		tools: p.length ? p : void 0,
+		allowedTools: m,
+		skills: d ?? [lu],
+		maxToolRounds: l,
+		...u === void 0 ? {} : { summarization: u }
+	};
+}
+//#endregion
+//#region src/core/sdk/htmlSubagent.ts
+function pu(e) {
+	return `你是纯代码组件生成专家。可用工具:vfs_write / vfs_edit / vfs_rm(写/改/删代码到 vfs ${e}) / vfs_grep + vfs_read(读 vfs) / write + set(写 data 引用,writablePaths 限定) / read / write_todos + update_todo(规划)。
+
+代码存储约定(重要):
+- 代码正文写 vfs:${e}<name>.vue(如 ${e}hero.vue)
+- data 存引用:write({ patch:{ op:'set', jsonPath:'components.N', value:{ type:'custom', codeRef:'vfs://${e}<name>.vue', name, props } } })
+- 改代码:先 vfs_edit 改 vfs 文件(data 的 codeRef 引用不变,无需改 data)
+
+工作方式:
+1. 中等任务(多组件 / 大段代码)先 write_todos 拆解:读现有结构 → 规划各组件 → 逐个生成 → read 确认;
+2. 遵循 html-builder skill 规范(SFC 规范 / 安全底线 / 可访问性 / props 定义 / 组件库引用);
+3. 小段代码 vfs_write 整体写;大段用 vfs_edit 增量拼(避免单次输出超限);
+4. 生成后 read(vfs 文件 + data 引用)确认结构正确;只写 writablePaths 内 data + ${e} 下 vfs。`;
+}
+var mu = "# 纯代码组件生成规范\n\n## 代码存储约定(重要)\n- 代码正文写 vfs:html/<name>.vue(如 html/hero.vue)\n- data 存引用:{ type:'custom', codeRef:'vfs://html/<name>.vue', name, props }\n- 改代码:vfs_edit 改 vfs 文件(data 的 codeRef 引用不变)\n\n## 何时写代码组件\n- 组件库无对应类型(高度定制交互 / 一次性特效 / 特殊布局)→ 写 custom 代码组件\n- 组件库已有(按钮 / 卡片 / 列表)→ 用现有组件配置,不重造\n\n## Vue SFC 规范\n- Vue 3 <template> + <script setup>(组合式)\n- props 用 defineProps;事件用 defineEmits\n- 只渲染 UI,不做副作用(不发请求 / 不读写 storage)\n\n## props 定义\n- 代码组件 defineProps 接受外部 data 传入(集成方渲染时按 data 的 props 字段传)\n\n## 组件库引用\n- 代码内可 import 组件库组件(如 <Button>);所用依赖以集成方渲染层已注入为准,不重复造\n\n## 安全底线(必须)\n- 禁 eval / new Function / Function 构造器\n- 禁访问 window 敏感属性(document.cookie / apiKey / token)\n- 不引入外部脚本 / CDN\n\n## 可访问性 + 语义化\n- 语义化标签(button / nav / section);图片 alt;交互可键盘聚焦\n- 颜色对比达标;不只用颜色传达信息", hu = {
+	name: "html-builder",
+	description: "纯代码组件(custom Vue SFC)生成规范:代码存 vfs+data 引用 / SFC 规范 / 安全底线 / props / 组件库引用 / 可访问性",
+	getContent: () => mu
+};
+function gu(e) {
+	let { writablePaths: t, codeVfsPrefix: n = "html/", id: r = "html", description: i, planning: a = !0, summarization: o = !0, maxToolRounds: s = 12, temperature: c = .4, skills: l, extraTools: u } = e;
+	if (!t?.length) throw Error("[page-agent-sdk][createHtmlSubagent] writablePaths 必填(代码组件 data 区,如 [\"components\"])");
+	let d = [];
+	a && d.push(Qi());
+	let f = u ?? [];
+	return {
+		id: r,
+		description: i ?? "生成/修改纯代码组件(custom Vue SFC)。代码写 vfs,data 存引用;能规划(write_todos)+ 执行。需写代码组件或灵活定制时委派",
+		systemPrompt: pu(n),
+		writablePaths: t,
+		allowedTools: [
+			"vfs_write",
+			"vfs_edit",
+			"vfs_rm",
+			"vfs_grep",
+			"vfs_read"
+		],
+		middleware: d.length ? d : void 0,
+		summarization: o === !1 ? void 0 : o,
+		temperature: c,
+		skills: l ?? [hu],
+		maxToolRounds: s,
+		tools: f.length ? f : void 0
+	};
+}
+//#endregion
 //#region src/core/utils/clipboard.ts
-async function su(e) {
+async function _u(e) {
 	try {
 		let t = globalThis.navigator?.clipboard;
 		if (t && typeof t.writeText == "function") return await t.writeText(e), !0;
@@ -9466,7 +9587,7 @@ async function su(e) {
 }
 //#endregion
 //#region src/core/composables/useChat.ts
-function cu(e = {}) {
+function vu(e = {}) {
 	let { fetchResponse: t, fetchStream: n, onPersist: r, onClear: i } = e, a = /* @__PURE__ */ _t({
 		messages: e.messages ?? [],
 		loading: !1,
@@ -9645,9 +9766,9 @@ function cu(e = {}) {
 }
 //#endregion
 //#region src/core/composables/chatContext.ts
-var lu = Symbol("chatContext");
-function uu(e = {}) {
-	let t = cu({
+var yu = Symbol("chatContext");
+function bu(e = {}) {
+	let t = vu({
 		fetchResponse: e.fetchResponse,
 		fetchStream: e.fetchStream,
 		messages: e.messages,
@@ -9666,7 +9787,7 @@ function uu(e = {}) {
 	}, h = /* @__PURE__ */ Ot({}), g = (e) => h.value[e] !== !1, _ = (e) => {
 		h.value[e] = !g(e);
 	}, v = /* @__PURE__ */ Ot(!1), y = (e) => {
-		su(e).then((e) => {
+		_u(e).then((e) => {
 			e && (v.value = !0, setTimeout(() => {
 				v.value = !1;
 			}, 1500));
@@ -9734,15 +9855,15 @@ function uu(e = {}) {
 		}
 	};
 }
-function du() {
-	let e = Fn(lu);
+function xu() {
+	let e = Fn(yu);
 	if (!e) throw Error("useChatContext 必须在 provide(chatContextKey) 的组件子树内调用");
 	return e;
 }
 //#endregion
 //#region src/core/index.headless.ts
-function fu(e) {
+function Su(e) {
 	return ou(e);
 }
 //#endregion
-export { Qs as CAPABILITIES, tc as CONTEXT_PRESETS, fs as CompressDecisionSchema, os as DEFAULT_SYSTEM_PROMPT, Ha as HUMAN_CONFIRM_TOOL_NAME, ti as MIN_CONTEXT_WINDOW, Xo as STOP_WORDS, oc as UNSAFE_KEYS, Il as actionsToInspectInfo, Fl as actionsToTools, Jr as agentError, Fo as analyzeContext, gc as applyPatchToClone, _c as applyPatchToLive, qr as asAgentError, ss as buildDataPrompt, cs as buildSystemPrompt, lu as chatContextKey, hl as commitSetToBind, Bo as connectMcp, f as constructLlmFromConfig, d as constructOpenLlmSync, su as copyText, ji as createAgent, Va as createApprovalMiddleware, uu as createChatContext, fu as createChatSdk, Qa as createCheckpointManager, $a as createCheckpointMiddleware, ws as createConflictManager, Io as createContextInspectorMiddleware, _l as createDataOps, Ga as createHumanConfirmMiddleware, Wa as createHumanConfirmTool, Gs as createMemoryBackend, Pa as createMemoryMiddleware, u as createProxyLlm, ba as createSandboxRunner, ec as createSdkEvents, $l as createSerialRunner, Ys as createSessionStore, Yl as createSkillStore, fo as createSubagentMiddleware, ho as createSubagentsMiddleware, Ul as createUsageHintsMiddleware, go as createVerifyMiddleware, wc as createVfs, qs as createWebStorageBackend, So as createWriteBackCheck, dc as deepClone, zl as defineDataToolset, Sa as defineSkill, ls as defineTool, uc as deleteByPath, ps as deriveTitle, Ui as describeSchemaNode, xi as detectGarbledToolCall, bc as diffObjects, Cl as domToStructure, Tl as domTools, Rl as domToolsStatic, Qo as estimateMessageTokens, $o as estimateRoundTokens, X as estimateTokens, m as extractReasoningDelta, ca as extractSchemaHint, Lo as extractText, p as extractTextDelta, h as extractUsage, yl as fetchDocTools, Ll as fetchTools, ml as filterByToolMode, Wi as formatConstraints, Ur as formatZodIssues, Z as getByPath, wl as getDomTool, Ol as getEnvSummary, Fi as getSchemaAtPath, Mi as getSchemaTopKeys, ai as getTraceMetrics, $ as hashValue, es as indexSummarize, jl as inspectEnvTool, Ml as inspectTools, ms as isChatModel, fi as isContextLengthError, Ni as isPathAllowed, Ls as isQuotaError, sc as isUnsafePath, Uc as jpEval, Gr as jsonParseError, mc as limitDepth, fc as maybeParseValue, ii as offloadPassThroughChars, ri as offloadThresholdChars, ra as presets, Li as projectBySchema, Ii as projectBySchemaDeep, pc as projectFields, ts as recallRounds, Gi as renderSchemaHint, Ki as renderSchemaOverview, Ji as renderSchemaShallow, $s as resolveCapabilities, rc as resolveContextOptions, Zs as resolveDialogConfig, Cs as resolveLlm, ni as resolveModelCaps, Xs as resolveStorage, yc as restoreInPlace, vc as restoreLive, Kr as routeError, xa as runHostScript, qc as runSandboxedScript, cc as safeMerge, Dl as safeSerialize, Q as safeStringify, Gc as searchJson, Bl as selectBuiltinTools, lc as setByPath, ns as shouldTriggerCompression, ia as systemPromptHelpers, Zo as tokenize, Y as toolError, Pi as unwrapSchema, cu as useChat, du as useChatContext, e as z, Wr as zodError };
+export { Qs as CAPABILITIES, tc as CONTEXT_PRESETS, fs as CompressDecisionSchema, os as DEFAULT_SYSTEM_PROMPT, Ha as HUMAN_CONFIRM_TOOL_NAME, ti as MIN_CONTEXT_WINDOW, lo as STOP_WORDS, oc as UNSAFE_KEYS, Il as actionsToInspectInfo, Fl as actionsToTools, Jr as agentError, es as analyzeContext, gc as applyPatchToClone, _c as applyPatchToLive, qr as asAgentError, ss as buildDataPrompt, cs as buildSystemPrompt, yu as chatContextKey, hl as commitSetToBind, as as connectMcp, f as constructLlmFromConfig, d as constructOpenLlmSync, _u as copyText, ji as createAgent, Va as createApprovalMiddleware, bu as createChatContext, Su as createChatSdk, Qa as createCheckpointManager, $a as createCheckpointMiddleware, ws as createConflictManager, ts as createContextInspectorMiddleware, _l as createDataOps, gu as createHtmlSubagent, Ga as createHumanConfirmMiddleware, Wa as createHumanConfirmTool, Gs as createMemoryBackend, Pa as createMemoryMiddleware, u as createProxyLlm, fu as createRagSubagent, ba as createSandboxRunner, ec as createSdkEvents, $l as createSerialRunner, Ys as createSessionStore, Yl as createSkillStore, jo as createSubagentMiddleware, Po as createSubagentsMiddleware, Ul as createUsageHintsMiddleware, Fo as createVerifyMiddleware, wc as createVfs, qs as createWebStorageBackend, Vo as createWriteBackCheck, dc as deepClone, zl as defineDataToolset, Sa as defineSkill, ls as defineTool, uc as deleteByPath, ps as deriveTitle, Ui as describeSchemaNode, xi as detectGarbledToolCall, bc as diffObjects, Cl as domToStructure, Tl as domTools, Rl as domToolsStatic, fo as estimateMessageTokens, po as estimateRoundTokens, X as estimateTokens, m as extractReasoningDelta, ca as extractSchemaHint, ns as extractText, p as extractTextDelta, h as extractUsage, yl as fetchDocTools, Ll as fetchTools, ml as filterByToolMode, Wi as formatConstraints, Ur as formatZodIssues, Z as getByPath, wl as getDomTool, Ol as getEnvSummary, Fi as getSchemaAtPath, Mi as getSchemaTopKeys, ai as getTraceMetrics, $ as hashValue, mo as indexSummarize, jl as inspectEnvTool, Ml as inspectTools, ms as isChatModel, fi as isContextLengthError, Ni as isPathAllowed, Ls as isQuotaError, sc as isUnsafePath, Uc as jpEval, Gr as jsonParseError, mc as limitDepth, fc as maybeParseValue, ii as offloadPassThroughChars, ri as offloadThresholdChars, ra as presets, Li as projectBySchema, Ii as projectBySchemaDeep, pc as projectFields, ho as recallRounds, Gi as renderSchemaHint, Ki as renderSchemaOverview, Ji as renderSchemaShallow, $s as resolveCapabilities, rc as resolveContextOptions, Zs as resolveDialogConfig, Cs as resolveLlm, ni as resolveModelCaps, Xs as resolveStorage, yc as restoreInPlace, vc as restoreLive, Kr as routeError, xa as runHostScript, qc as runSandboxedScript, cc as safeMerge, Dl as safeSerialize, Q as safeStringify, Gc as searchJson, Bl as selectBuiltinTools, lc as setByPath, go as shouldTriggerCompression, ia as systemPromptHelpers, uo as tokenize, Y as toolError, Pi as unwrapSchema, vu as useChat, xu as useChatContext, e as z, Wr as zodError };