page-agent-sdk 4.2.3 → 4.4.0

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

@@ -11110,10 +11110,13 @@ function Kf(e, t, n) {
 	return e.set(t, r.then(() => void 0, () => void 0)), r;
 }
 function qf(e = {}) {
-	return Jf(e);
+	return Yf(e, typeof e.backend == "object" && e.backend ? e.backend : void 0);
 }
-function Jf(e = {}, t) {
-	let n = e.dbName ?? Cf, r = e.backend ?? "indexed", i = e.maxBytes ?? Pf(r), a = e.maxBytesPerSession ?? Ef, o = e.evictionWatermark ?? Df, s = e.debounceMs ?? Of, c = /* @__PURE__ */ new Set();
+function Jf(e, t) {
+	return Yf(e, t);
+}
+function Yf(e = {}, t) {
+	let n = e.dbName ?? Cf, r = typeof e.backend == "string" ? e.backend ?? "indexed" : "indexed", i = e.maxBytes ?? Pf(r), a = e.maxBytesPerSession ?? Ef, o = e.evictionWatermark ?? Df, s = e.debounceMs ?? Of, c = /* @__PURE__ */ new Set();
 	function l(e) {
 		for (let t of c) try {
 			t(e);
@@ -11313,7 +11316,10 @@ function Jf(e = {}, t) {
 				bytes: 0,
 				title: t
 			};
-			return await u.set(If(n, e, i, jf), o), i;
+			try {
+				await u.set(If(n, e, i, jf), o);
+			} catch {}
+			return i;
 		},
 		onEvent(e) {
 			c.add(e);
@@ -11328,15 +11334,15 @@ function Jf(e = {}, t) {
 }
 //#endregion
 //#region src/core/sdk/optionsResolver.ts
-function Yf(e) {
+function Xf(e) {
 	return e === void 0 ? qf({ backend: "memory" }) : e === !1 ? null : typeof e == "string" ? qf({ backend: e }) : e.enabled === !1 ? null : qf(e);
 }
-function Xf(e) {
+function Zf(e) {
 	return e.dialog ?? {};
 }
 //#endregion
 //#region src/core/capabilities.ts
-var Zf = [
+var Qf = [
 	{
 		name: "dataOps",
 		defaultOn: !0
@@ -11412,13 +11418,13 @@ var Zf = [
 		requires: ["summarization"]
 	}
 ];
-function Qf(e) {
+function $f(e) {
 	let t = {};
-	for (let n of Zf) {
+	for (let n of Qf) {
 		let r = e?.[n.name];
 		t[n.name] = n.defaultOn ? r !== !1 : r === !0;
 	}
-	for (let e of Zf) if (e.requires && t[e.name]) {
+	for (let e of Qf) if (e.requires && t[e.name]) {
 		for (let n of e.requires) if (!t[n]) {
 			t[e.name] = !1;
 			break;
@@ -11428,7 +11434,7 @@ function Qf(e) {
 }
 //#endregion
 //#region src/core/sdk/events.ts
-function $f(e) {
+function ep(e) {
 	let t = /* @__PURE__ */ new Set(), n = (n) => {
 		if (n.type !== "approval_request") {
 			if (e) try {
@@ -11454,7 +11460,7 @@ function $f(e) {
 }
 //#endregion
 //#region src/core/sdk/contextPreset.ts
-var ep = {
+var tp = {
 	auto: {
 		summaryThresholdRatio: .5,
 		windowRatio: .4,
@@ -11482,7 +11488,7 @@ var ep = {
 		enableRecall: !0,
 		enableLLMSummary: !0
 	}
-}, tp = {
+}, np = {
 	auto: ["describe_data", "read"],
 	conservative: ["describe_data"],
 	aggressive: ["describe_data", "read"],
@@ -11493,8 +11499,8 @@ var ep = {
 		"search_data"
 	]
 };
-function np(e, t) {
-	let n = ep[e.contextPreset ?? "auto"] ?? {}, r = e.contextOptions === !1 ? {} : e.contextOptions ?? {};
+function rp(e, t) {
+	let n = tp[e.contextPreset ?? "auto"] ?? {}, r = e.contextOptions === !1 ? {} : e.contextOptions ?? {};
 	return {
 		...n,
 		...r,
@@ -11504,7 +11510,7 @@ function np(e, t) {
 }
 //#endregion
 //#region src/core/sdk/middlewareStack.ts
-var rp = {
+var ip = {
 	dataHint: 10,
 	usageHints: 20,
 	todos: 30,
@@ -11521,17 +11527,17 @@ var rp = {
 	subagents: 140,
 	augmentSystem: 150
 };
-function ip(e) {
+function ap(e) {
 	return e.map((e, t) => ({
 		m: e,
 		i: t,
-		p: rp[e.name] ?? Infinity
+		p: ip[e.name] ?? Infinity
 	})).sort((e, t) => e.p - t.p || e.i - t.i).map((e) => e.m);
 }
 //#endregion
 //#region src/core/tools/fetchDoc.ts
-var ap = 3e4, op = [r(async ({ url: e, as: t }) => {
-	let n = new AbortController(), r = setTimeout(() => n.abort(), ap);
+var op = 3e4, sp = [r(async ({ url: e, as: t }) => {
+	let n = new AbortController(), r = setTimeout(() => n.abort(), op);
 	try {
 		let r = await fetch(e, {
 			method: "GET",
@@ -11548,7 +11554,7 @@ var ap = 3e4, op = [r(async ({ url: e, as: t }) => {
 		].join("\n");
 	} catch (t) {
 		let r = t?.message || String(t);
-		return n.signal.aborted ? `获取失败:请求超时(${ap}ms,${e})。` : /Failed to fetch|NetworkError|CORS|blocked/i.test(r) ? `获取失败:可能是 CORS 跨域拦截或网络错误(${r})。浏览器仅能 GET 同源或服务端已配置 CORS 的资源;跨域抓取需后端代理。` : `获取失败:${r}`;
+		return n.signal.aborted ? `获取失败:请求超时(${op}ms,${e})。` : /Failed to fetch|NetworkError|CORS|blocked/i.test(r) ? `获取失败:可能是 CORS 跨域拦截或网络错误(${r})。浏览器仅能 GET 同源或服务端已配置 CORS 的资源;跨域抓取需后端代理。` : `获取失败:${r}`;
 	} finally {
 		clearTimeout(r);
 	}
@@ -11559,7 +11565,7 @@ var ap = 3e4, op = [r(async ({ url: e, as: t }) => {
 		url: t.string().describe("要抓取的 URL(同源或已配 CORS)"),
 		as: t.enum(["text", "markdown"]).optional().describe("返回格式标签,默认 text")
 	})
-})], sp = [
+})], cp = [
 	"id",
 	"class",
 	"href",
@@ -11571,12 +11577,12 @@ var ap = 3e4, op = [r(async ({ url: e, as: t }) => {
 	"aria-label",
 	"name",
 	"type"
-], cp = /^(value|srcdoc|formaction|on\w+)$/i, lp = /token|secret|password|passwd|api[-_]?key|auth|cred|csrf|session/i;
-function up(e, t) {
+], lp = /^(value|srcdoc|formaction|on\w+)$/i, up = /token|secret|password|passwd|api[-_]?key|auth|cred|csrf|session/i;
+function dp(e, t) {
 	if (!e) return null;
-	let { depth: n, attrs: r, includeText: i = !0 } = t, a = r !== void 0, o = r ?? sp, s = (e) => {
+	let { depth: n, attrs: r, includeText: i = !0 } = t, a = r !== void 0, o = r ?? cp, s = (e) => {
 		let t = {};
-		for (let n of Array.from(e.attributes)) (a ? o.includes(n.name) : o.includes(n.name) || n.name.startsWith("data-")) && (cp.test(n.name) || lp.test(n.name) || (t[n.name] = n.value));
+		for (let n of Array.from(e.attributes)) (a ? o.includes(n.name) : o.includes(n.name) || n.name.startsWith("data-")) && (lp.test(n.name) || up.test(n.name) || (t[n.name] = n.value));
 		return t;
 	}, c = (e, t) => {
 		let n = {
@@ -11592,10 +11598,10 @@ function up(e, t) {
 	};
 	return c(e, n);
 }
-var dp = r(({ selector: e, depth: t, attrs: n, includeText: r }) => {
+var fp = r(({ selector: e, depth: t, attrs: n, includeText: r }) => {
 	let i = e ? document.querySelector(e) : document.body;
 	if (!i) return `未找到匹配元素:selector="${e}"`;
-	let a = up(i, {
+	let a = dp(i, {
 		depth: t ?? 3,
 		attrs: n,
 		includeText: r ?? !0
@@ -11610,22 +11616,22 @@ var dp = r(({ selector: e, depth: t, attrs: n, includeText: r }) => {
 		attrs: t.array(t.string()).optional().describe("属性白名单(传了 = 严格白名单;不传 = 默认常用 + data-*)"),
 		includeText: t.boolean().optional().describe("是否包含直接文本(默认 true)")
 	})
-}), fp = [dp], pp = /* @__PURE__ */ "display.position.visibility.opacity.color.background-color.background-image.font-size.font-weight.line-height.text-align.z-index.overflow.width.height.margin.padding.border.border-radius.box-shadow.transform.transition.animation.cursor.pointer-events.flex-direction.gap.max-width.min-height".split("."), mp = /* @__PURE__ */ new WeakMap(), hp = !1;
-function gp() {
-	if (hp) return;
+}), pp = [fp], mp = /* @__PURE__ */ "display.position.visibility.opacity.color.background-color.background-image.font-size.font-weight.line-height.text-align.z-index.overflow.width.height.margin.padding.border.border-radius.box-shadow.transform.transition.animation.cursor.pointer-events.flex-direction.gap.max-width.min-height".split("."), hp = /* @__PURE__ */ new WeakMap(), gp = !1;
+function _p() {
+	if (gp) return;
 	let e = globalThis.EventTarget;
 	if (!e?.prototype?.addEventListener) return;
-	hp = !0;
+	gp = !0;
 	let t = e.prototype.addEventListener, n = e.prototype.removeEventListener;
 	e.prototype.addEventListener = function(e, ...n) {
 		try {
-			let t = mp.get(this);
-			t || (t = /* @__PURE__ */ new Map(), mp.set(this, t)), t.set(String(e), (t.get(String(e)) ?? 0) + 1);
+			let t = hp.get(this);
+			t || (t = /* @__PURE__ */ new Map(), hp.set(this, t)), t.set(String(e), (t.get(String(e)) ?? 0) + 1);
 		} catch {}
 		return t.call(this, e, ...n);
 	}, e.prototype.removeEventListener = function(e, ...t) {
 		try {
-			let t = mp.get(this);
+			let t = hp.get(this);
 			if (t) {
 				let n = (t.get(String(e)) ?? 1) - 1;
 				n <= 0 ? t.delete(String(e)) : t.set(String(e), n);
@@ -11634,10 +11640,10 @@ function gp() {
 		return n.call(this, e, ...t);
 	};
 }
-function _p(e) {
-	return [...mp.get(e)?.entries() ?? []].filter(([, e]) => e > 0).map(([e]) => e);
+function vp(e) {
+	return [...hp.get(e)?.entries() ?? []].filter(([, e]) => e > 0).map(([e]) => e);
 }
-function vp(e, t = 12) {
+function yp(e, t = 12) {
 	let n = [], r = e, i = 0;
 	for (; r && r.tagName && i < t;) {
 		let e = r.tagName.toLowerCase(), t = r.id;
@@ -11658,7 +11664,7 @@ function vp(e, t = 12) {
 	}
 	return n.join(" > ");
 }
-function yp(e, t, n = {}) {
+function bp(e, t, n = {}) {
 	if (!e) return {
 		hits: [],
 		total: 0,
@@ -11696,7 +11702,7 @@ function yp(e, t, n = {}) {
 				n = r.slice(Math.max(0, i - 20), i + t.length + 40);
 			}
 			return {
-				selector: vp(e),
+				selector: yp(e),
 				tag: e.tagName.toLowerCase(),
 				text: n.slice(0, 120)
 			};
@@ -11705,7 +11711,7 @@ function yp(e, t, n = {}) {
 		truncated: a.length > o
 	};
 }
-var bp = [
+var xp = [
 	"content",
 	"display",
 	"width",
@@ -11713,14 +11719,14 @@ var bp = [
 	"background-color",
 	"position"
 ];
-function xp(e, t = {}) {
+function Sp(e, t = {}) {
 	if (!e) return null;
 	let n = {
-		selector: vp(e),
+		selector: yp(e),
 		tag: e.tagName.toLowerCase(),
 		attrs: {}
 	};
-	for (let t of Array.from(e.attributes)) !(sp.includes(t.name) || t.name.startsWith("data-")) || cp.test(t.name) || lp.test(t.name) || (n.attrs[t.name] = t.value);
+	for (let t of Array.from(e.attributes)) !(cp.includes(t.name) || t.name.startsWith("data-")) || lp.test(t.name) || up.test(t.name) || (n.attrs[t.name] = t.value);
 	let r = Array.from(e.childNodes).filter((e) => e.nodeType === 3).map((e) => e.textContent || "").join("").trim();
 	r && (n.text = r.slice(0, 400));
 	let i = String(e.innerText ?? e.textContent ?? "").trim();
@@ -11742,7 +11748,7 @@ function xp(e, t = {}) {
 		if (typeof a != "function") return r;
 		try {
 			let i = a(e, n ?? null);
-			for (let e of n ? bp : t.styles ?? pp) {
+			for (let e of n ? xp : t.styles ?? mp) {
 				let t = typeof i.getPropertyValue == "function" ? i.getPropertyValue(e) : i[e];
 				t && (r[e] = String(t).slice(0, 200));
 			}
@@ -11760,16 +11766,16 @@ function xp(e, t = {}) {
 		n.events = {
 			inline: t,
 			vue: r ? Object.keys(r).filter((e) => /^on[A-Z]/.test(e)).map((e) => e.slice(2).toLowerCase()) : [],
-			captured: _p(e)
+			captured: vp(e)
 		};
 	}
 	return n;
 }
-var Sp = r(({ query: e, mode: t, limit: n, root: r }) => {
-	gp();
+var Cp = r(({ query: e, mode: t, limit: n, root: r }) => {
+	_p();
 	let i = r ? document.querySelector(r) : document;
 	if (r && !i) return `未找到 root 元素:selector="${r}"`;
-	let a = yp(i, e, {
+	let a = bp(i, e, {
 		mode: t,
 		limit: n
 	});
@@ -11786,11 +11792,11 @@ var Sp = r(({ query: e, mode: t, limit: n, root: r }) => {
 		limit: t.number().int().min(1).max(20).optional().describe("返回上限(默认 10)"),
 		root: t.string().optional().describe("限定搜索范围的容器选择器(默认整页)")
 	})
-}), Cp = r(({ selector: e, styles: t, includeHtml: n, htmlLimit: r, includeEvents: i, includeRect: a, pseudo: o }) => {
-	gp();
+}), wp = r(({ selector: e, styles: t, includeHtml: n, htmlLimit: r, includeEvents: i, includeRect: a, pseudo: o }) => {
+	_p();
 	let s = document.querySelector(e);
 	if (!s) return `未找到匹配元素:selector="${e}"(可先用 dom_search 定位)`;
-	let c = xp(s, {
+	let c = Sp(s, {
 		styles: t,
 		includeHtml: n,
 		htmlLimit: r,
@@ -11811,7 +11817,7 @@ var Sp = r(({ query: e, mode: t, limit: n, root: r }) => {
 		includeRect: t.boolean().optional().describe("是否含几何位置(默认 true)"),
 		pseudo: t.boolean().optional().describe("是否含 ::before/::after 伪元素摘要(默认 false)")
 	})
-}), wp = {
+}), Tp = {
 	name: "dom-inspect",
 	description: "页面 DOM 深度检视工具(dom_search 搜索元素 / dom_info 读内容·计算样式·事件绑定·几何)。定位元素、验证样式落地、排查交互绑定时加载",
 	getContent: () => [
@@ -11828,15 +11834,15 @@ var Sp = r(({ query: e, mode: t, limit: n, root: r }) => {
 		"## 排障套路",
 		"1. dom_search(mode:\"text\", query:按钮文案) 定位 → 2. dom_info(styles:[\"display\",\"background-color\",\"pointer-events\"]) 验证样式/点击性 → 3. 不符则改数据(get_dom 看结构对照)"
 	].join("\n"),
-	tools: [() => [Sp, Cp]]
+	tools: [() => [Cp, wp]]
 };
 //#endregion
 //#region src/core/tools/envTool.ts
-function Tp(e) {
+function Ep(e) {
 	let t = e;
 	return typeof t.tagName == "string" || typeof t.nodeType == "number" && typeof t.nodeName == "string";
 }
-function Ep(e, t = 3, n = 2e3, r, i) {
+function Dp(e, t = 3, n = 2e3, r, i) {
 	if (e == null) return e;
 	if (typeof e == "string") return e.length > n ? e.slice(0, n) + "…(已截断)" : e;
 	if (typeof e == "number" || typeof e == "boolean") return e;
@@ -11845,14 +11851,14 @@ function Ep(e, t = 3, n = 2e3, r, i) {
 	if (typeof e == "bigint") return `${e.toString()}n`;
 	if (typeof e != "object") return String(e);
 	let a = e;
-	if (Tp(a)) {
+	if (Ep(a)) {
 		let e = a;
 		return e.tagName ? `[Element: <${e.tagName.toLowerCase()}>]` : `[Node: ${e.nodeName}]`;
 	}
 	if (r?.has(a)) return "[Circular]";
 	let o = r ?? /* @__PURE__ */ new WeakSet();
 	if (o.add(a), Array.isArray(e)) {
-		let r = e.slice(0, 100).map((e) => Ep(e, t - 1, n, o, i));
+		let r = e.slice(0, 100).map((e) => Dp(e, t - 1, n, o, i));
 		return e.length > 100 && r.push(`…(共 ${e.length} 项,已截断)`), r;
 	}
 	if (t < 0) return "(对象,已截断)";
@@ -11865,14 +11871,14 @@ function Ep(e, t = 3, n = 2e3, r, i) {
 		}
 		try {
 			let e = a[r];
-			i?.test(r) ? s[r] = "[REDACTED]" : s[r] = Ep(e, t - 1, n, o, i);
+			i?.test(r) ? s[r] = "[REDACTED]" : s[r] = Dp(e, t - 1, n, o, i);
 		} catch {
 			s[r] = "(getter 抛错)";
 		}
 	}
 	return s;
 }
-function Dp(e) {
+function Op(e) {
 	let t = e ?? (typeof window < "u" ? window : {}), n = t.navigator, r = t.location, i = t.document;
 	return {
 		location: {
@@ -11905,9 +11911,9 @@ function Dp(e) {
 		} : "(无 document)"
 	};
 }
-var Op = /^(localStorage|sessionStorage|cookie|document|frames|frameElement|opener|parent|top|self|window|globalThis|closed|history|navigation|trustedTypes|origin|crossOriginIsolated)$/, kp = /token|secret|password|passwd|api[-_]?key|auth|cred|csrf|session|ticket/i, Ap = r(({ key: e }) => {
+var kp = /^(localStorage|sessionStorage|cookie|document|frames|frameElement|opener|parent|top|self|window|globalThis|closed|history|navigation|trustedTypes|origin|crossOriginIsolated)$/, Ap = /token|secret|password|passwd|api[-_]?key|auth|cred|csrf|session|ticket/i, jp = r(({ key: e }) => {
 	if (e) {
-		if (Op.test(e) || kp.test(e)) return JSON.stringify({
+		if (kp.test(e) || Ap.test(e)) return JSON.stringify({
 			key: e,
 			denied: !0,
 			reason: "安全:该 key 在 denylist(localStorage/sessionStorage/cookie/document 或敏感命名 token/secret/key/auth),不读取防泄漏"
@@ -11917,18 +11923,18 @@ var Op = /^(localStorage|sessionStorage|cookie|document|frames|frameElement|open
 			key: e,
 			exists: t !== void 0,
 			type: typeof t,
-			value: Ep(t, 3, 2e3, void 0, kp)
+			value: Dp(t, 3, 2e3, void 0, Ap)
 		}, null, 2);
 	}
-	return JSON.stringify(Dp(), null, 2);
+	return JSON.stringify(Op(), null, 2);
 }, {
 	name: "inspect_env",
 	description: "读宿主页面环境信息(排查调试)。不传参返回摘要(URL/origin、浏览器/语言、viewport、title/readyState);传 key 读指定 window 属性值(如 key:\"appConfig\")。只读,大结果自动外存 vfs。",
 	schema: t.object({ key: t.string().optional().describe("要读取的 window 属性名(如 \"appConfig\"/\"__DEBUG__\");不传 = 返回环境摘要") })
-}), jp = [Ap];
+}), Mp = [jp];
 //#endregion
 //#region src/core/harness/budget.ts
-function Mp(e, t, n) {
+function Np(e, t, n) {
 	let r = 0;
 	return {
 		name: "budget",
@@ -11953,12 +11959,12 @@ function Mp(e, t, n) {
 }
 //#endregion
 //#region src/core/sdk/actions.ts
-var Np = /^[a-zA-Z][a-zA-Z0-9_]*$/;
-function Pp(e) {
+var Pp = /^[a-zA-Z][a-zA-Z0-9_]*$/;
+function Fp(e) {
 	let n = [];
 	for (let [i, a] of Object.entries(e)) {
-		if (!Np.test(i)) {
-			console.warn(`[page-agent-sdk][actions] 动作名 "${i}" 非法(须匹配 ${Np}),已跳过`);
+		if (!Pp.test(i)) {
+			console.warn(`[page-agent-sdk][actions] 动作名 "${i}" 非法(须匹配 ${Pp}),已跳过`);
 			continue;
 		}
 		let e = a.description || `宿主动作 ${i}`;
@@ -11978,9 +11984,9 @@ function Pp(e) {
 	}
 	return n;
 }
-function Fp(e) {
+function Ip(e) {
 	let t = {};
-	for (let [n, r] of Object.entries(e)) Np.test(n) && (t[n] = {
+	for (let [n, r] of Object.entries(e)) Pp.test(n) && (t[n] = {
 		description: r.description,
 		hasParams: !!r.params
 	});
@@ -11988,12 +11994,12 @@ function Fp(e) {
 }
 //#endregion
 //#region src/core/toolsets.ts
-var Ip = op, Lp = fp;
-function Rp(e, t) {
+var Lp = sp, Rp = pp;
+function zp(e, t) {
 	return rd(e, t);
 }
-function zp(e, t, n, r, i) {
-	let a = Qf(e);
+function Bp(e, t, n, r, i) {
+	let a = $f(e);
 	return [
 		...a.dataOps ? t : [],
 		...a.fetch ? n : [],
@@ -12003,7 +12009,7 @@ function zp(e, t, n, r, i) {
 }
 //#endregion
 //#region src/core/sdk/toolRegistry.ts
-function Bp(e) {
+function Vp(e) {
 	let t = /* @__PURE__ */ new Map(), n = [];
 	for (let r of e) for (let e of r.tools) {
 		let i = t.get(e.name);
@@ -12023,15 +12029,15 @@ function Bp(e) {
 }
 //#endregion
 //#region src/core/harness/usageHints.ts
-var Vp = .7;
-function Hp(e, t, n) {
-	let r = Qf(e);
+var Hp = .7;
+function Up(e, t, n) {
+	let r = $f(e);
 	return {
 		name: "usageHints",
 		augmentPrompt: (i) => {
 			let a = [];
 			if (r.planning && (a.push("【自适应规划】按任务复杂度决定是否先规划,不要对简单任务过度编排:"), a.push("  · 简单/明确任务(改单字段、调样式、查值)→ 直接 read/write 执行,不必 write_todos。"), a.push("  · 复杂任务(多步、大改、有歧义、不可逆)→ 先 write_todos 拆解,首个任务标 in_progress,逐项推进。"), a.push("  · 执行中发现步骤要改/补/细分 → 用 update_todo({id, content?, status?}) 按 id 增量改单项,不必重传整个清单。"), a.push("  · update_todo 标 completed 时附 evidence: 本次实际写入的 jsonPath(如 \"components.2\"),供收口对账;工作经委派子 agent 完成等无主写路径时,如实写明完成方式(勿编造路径)。"), e?.humanConfirm ? a.push("  · 规划出多步方案若需用户拍板 → 先 request_human_confirmation 给方案选项,确认后再执行。") : a.push("  · 规划出多步方案若需用户拍板 → 以文字列出方案选项等用户回复,勿自行拍板。"), a.push("  · 计划修订有次数上限(maxPlanRevisions,默认 5,只计 write_todos 调用、调研轮不计):勿反复改计划而不执行,规划充分后即开始 write 落地。")), t && (a.push("改主数据前先 read({jsonPath}) 读其当前真实值(返回末尾 hash=xxx 为乐观锁标识),基于真实值改,不要凭记忆。写入是否被自动校验由集成方 conflictWatchFields 声明决定:若已声明且主数据在你 read 之后被外部改过,会触发冲突——集成方若开启人工介入,工具会挂起等用户决定(保留外部/强制覆盖/回退),你应等待工具返回后按结果继续(保留外部→重新 read 再改;强制覆盖→已写入,继续;回退→已回退到历史快照,基于回退值重写);未开启人工介入时返回 VERSION_CONFLICT 不写入,重新 read 拿最新值再改。"), a.push("不确定主数据字段结构时用 describe_data 查看说明。"), a.push("修改大对象/数组优先用 write 增量改({patch:{op,jsonPath,value}} 只发改动部分),避免 write({value}) 整体重传被 max_tokens 截断导致 JSON 不完整、校验失败。"), a.push("修改主数据出错时可用 restore_data 回退最近一次。"), a.push("在大数组里按条件筛选元素用 query_data(JSONPath,如 $.components[?(@.type==\"card\" && @.price<100)]),返回匹配元素的 path/index;定位后再 write({patch}) 改。"), a.push("找名字记不清的元素用 search_data(支持 substring/regex/fuzzy 模糊搜索)。"), a.push("需要过滤/映射/聚合/批量重写大数组时用 eval_script(沙箱脚本,入参 data);只读探查用 mode=query,批量重写用 mode=transform(返回值经校验后落地)。"), a.push("读大数组用 read({jsonPath,offset,limit}) 分页(返回 hasMore=true 时 offset+=limit 续读);一次读多个不相关子路径用 read({jsonPaths});复杂改动先 write({...,dryRun:true}) 预检不落盘。"), a.push("【省轮次·批量】≥2 个路径一律 read({jsonPaths:[...]}) 一次取回(路径互不相关也合批,禁止连续单路径 read);改多处用 write({patches:[{op:\"set\",jsonPath,value},...]}) 一次提交多改动(原子任一失败回滚),勿逐个 write 烧轮次预算。"), a.push("读到 <subtree Nkb keys:[…] #指纹> 或 <code Nkb> 占位 = 该子树键名/体积可见但内容未见:写入前先窄读全文(read({jsonPath:\"该子树路径\"}),结果根豁免返全文)或 set_focus 聚焦该区域;勿凭键名印象猜路径/猜值直写(直接写占位子树会被拦下要求先窄读)。"), a.push("对比当前与历史快照(或一段 JSON against)的差异用 diff_data({snapshotId?,against?})(返回结构化 path→from/to,verify 自纠/操作审计/\"刚才改了啥\");只读查历史快照值用 history_data({id?,jsonPath?})。")), r.subagent && a.push("独立子任务可 spawn_agent 委派(过程隔离,不占主上下文):默认只读,需要子 agent 写数据时传 writablePaths(路径前缀白名单,越界 PATH_OUT_OF_SCOPE)。多个独立子任务可 spawn_agents 并行委派(各子互不通信,结论由你汇总;并行委派不可授写权限,写操作由你收尾执行)。"), r.inspectEnv && a.push("排查页面环境(当前 URL/浏览器/视口/集成方调试变量)用 inspect_env——不传参返回环境摘要(location/navigator/viewport/document),传 key 读特定 window 属性(如 inspect_env({key:\"appConfig\"}) 读 window.appConfig)。改完数据看渲染、定位\"为何没生效\"时用它(只读,不改数据)。"), r.domInspect && a.push("改完数据想确认渲染是否生效(或定位元素/辅助 UI 设计问答)用 get_dom({selector?,depth?}) 读渲染后 DOM(结构化返回 tag/attrs/text/children,depth 控制深度防爆炸,只读)。配合宿主 actions(save_draft/publish 等)形成\"改数据→get_dom 看渲染→触发动作\"闭环。"), r.draftWrite && (a.push("生成超大 JSON(如 50+ 组件页面,单次 write 受 max_tokens 限制装不下)用 draft_write 分块构建 → draft_commit 原子提交:draft_write({draftId, chunk, mode}) mode:\"start\" 新建/\"append\" 追加(拼 JSON 片段到 drafts 池);累积完 draft_commit({draftId}) 合并 + schema 校验 + 写主数据(失败草稿保留可修后重试,成功自动清草稿)。小改仍用 write patch,只在大 JSON 从零生成时用 draft。"), a.push("⚠️ 大 JSON 分块构建是典型多轮工具调用(draft_write×N + draft_commit + read 确认 + 调研 read/query),默认 maxToolRounds=30(3.43 起;轮次预算吃紧时 system 会注入预算提示段,按提示优先收口);目标组件数很大时集成方仍可在 createChatSdk 显式上调 maxToolRounds(按 N+10 估算)。draft_commit 提交同样走乐观锁(改前 read 拿 hash,bind 被改过会触发冲突介入,不静默覆盖)。")), r.focus && (a.push("【上下文聚焦】判断任务范围,用 set_focus/add_focus/remove_focus/clear_focus 自动收敛工作范围:"), a.push("  · 局部任务(只改某一组件/区域,如「调导航栏」「改 components.3 样式」)→ 先 read 定位 jsonPath,再 set_focus({path:\"该子树路径\"}) 聚焦;聚焦后每轮只看该子树结构,写其他位置会被 PATH_DENIED 拒绝。"), a.push("  · 多个相关组件(如「同时改导航栏和页脚」)→ set_focus 聚焦首个后用 add_focus({path}) 追加其余;聚焦后可写任一焦点子树,越界仍被拒;移除单个用 remove_focus({path})。"), a.push("  · 全局任务(多处/整体结构,如「重排所有组件」「换主题」)→ 不要聚焦,保持全量视野直接写。"), a.push("  · 完成局部精修、要转向其他区域或做整体改动 → 调 clear_focus 退出聚焦(清空全部焦点),恢复全部读写权限。"), a.push("  · set_focus/add_focus 的 path 必须在 schema 内(类型校验);不确定路径先 read/describe_data 查。")), e?.subagents?.length) {
-				let t = e.subagents.filter((e) => (e.temperature ?? 0) >= Vp || /规划|创意|设计|方案|brainstorm|plan/i.test(e.description)), n = e.subagents.filter((e) => (e.temperature ?? 0) < Vp && /反思|审查|挑刺|校验|review|critique|reflect/i.test(e.description));
+				let t = e.subagents.filter((e) => (e.temperature ?? 0) >= Hp || /规划|创意|设计|方案|brainstorm|plan/i.test(e.description)), n = e.subagents.filter((e) => (e.temperature ?? 0) < Hp && /反思|审查|挑刺|校验|review|critique|reflect/i.test(e.description));
 				a.push("【规划-反思-执行·路由】按任务性质选模式,不要对简单任务过度编排:"), t.length && (a.push(`  · 创作/设计/开放性需求(如"设计主题风格""换个感觉")→ 先调 ${t.map((e) => "use_" + e.id).join("/")} 出 2-3 套方案(高温创意),`), a.push(e?.humanConfirm ? "    不要自己拍板;拿到方案后,若需用户拍板用 request_human_confirmation 弹选项。" : "    不要自己拍板;拿到方案后以文字列出选项等用户回复(humanConfirm 未开,勿调不存在工具)。")), n.length && a.push(`  · 严谨/易错/校验类 → 可先调 ${n.map((e) => "use_" + e.id).join("/")} 反思挑刺(低温审查),据反馈修订。`), a.push("  · 方案定稿后,由你(主 agent)用 write 落地成 JSON(低温度执行 + schema 校验 + 写前确认)。"), a.push("  · 简单/明确任务(如\"标题改红色\")直接执行,不必走规划-反思。");
 			}
 			e?.humanConfirm && (a.push("【人工确认·必读】以下情形必须先调 request_human_confirmation 征询用户、拿到答复后再继续,不要自行拍板:"), a.push("  1) 用户让你「给方案/列选项/我来选/挑一个」时:把每个方案作为一个 option,调 request_human_confirmation(question=简述, options=[方案A,方案B,...], recommendation=你推荐的)。不要只回文字罗列方案让用户自己回复——要用工具把选项做成可点选按钮。"), a.push("  2) 需求有歧义/不确定时:调工具问清楚(options 不传则用户答同意或拒绝)。"), a.push("  3) 即将执行高风险不可逆操作(删除/覆盖/批量改动)前:调工具确认。"), a.push("  4) 规划出多步方案需用户确认时:把整个方案(或关键分步)作为 option 调 request_human_confirmation,确认后再执行。"), a.push("用户在选项里选了哪个,就按那个方案继续;选「拒绝」则停止并询问如何调整。"));
@@ -12051,7 +12057,7 @@ function Hp(e, t, n) {
 }
 //#endregion
 //#region src/core/harness/resourcesPin.ts
-function Up(e) {
+function Wp(e) {
 	return {
 		name: "resourcesPin",
 		augmentPrompt: () => {
@@ -12065,15 +12071,15 @@ function Up(e) {
 }
 //#endregion
 //#region src/core/backends/skillStore.ts
-var Wp = "v:1::skill-store", Gp = "chat-sdk";
-function Kp(e, t, n) {
-	return `${Wp}::${e}::${t}::${n}`;
+var Gp = "v:1::skill-store", Kp = "chat-sdk";
+function qp(e, t, n) {
+	return `${Gp}::${e}::${t}::${n}`;
 }
-function qp(e, t) {
-	return `${Wp}::${e}::${t}::`;
+function Jp(e, t) {
+	return `${Gp}::${e}::${t}::`;
 }
-function Jp(e = {}) {
-	let t = e.dbName ?? Gp, n = e.backend ?? "indexed", r = e.id ?? "", i, a, o = new Promise((e) => {
+function Yp(e = {}) {
+	let t = e.dbName ?? Kp, n = e.backend ?? "indexed", r = e.id ?? "", i, a, o = new Promise((e) => {
 		a = e;
 	});
 	return (async () => {
@@ -12095,36 +12101,36 @@ function Jp(e = {}) {
 		ready: o,
 		async list() {
 			let e = [];
-			return await i.scan(qp(t, r), (t, n) => {
+			return await i.scan(Jp(t, r), (t, n) => {
 				e.push(n);
 			}), e;
 		},
 		async get(e) {
-			return await i.get(Kp(t, r, e));
+			return await i.get(qp(t, r, e));
 		},
 		async put(e) {
 			try {
-				await i.set(Kp(t, r, e.name), e);
+				await i.set(qp(t, r, e.name), e);
 			} catch (e) {
 				Ff(e) && (i = Uf());
 			}
 		},
 		async remove(e) {
-			let n = Kp(t, r, e);
+			let n = qp(t, r, e);
 			return await i.get(n) == null ? !1 : (await i.del(n), !0);
 		},
 		async clear() {
-			await i.clearPrefix(qp(t, r));
+			await i.clearPrefix(Jp(t, r));
 		},
 		dispose() {}
 	};
 }
-var Yp = /large_results\/[^\s"'`),]+\.txt/g;
-function Xp(e) {
+var Xp = /large_results\/[^\s"'`),]+\.txt/g;
+function Zp(e) {
 	let t = /* @__PURE__ */ new Set(), n = (e) => {
 		if (typeof e != "string" || !e) return;
 		let n;
-		for (Yp.lastIndex = 0; (n = Yp.exec(e)) !== null;) t.add(n[0]);
+		for (Xp.lastIndex = 0; (n = Xp.exec(e)) !== null;) t.add(n[0]);
 	};
 	for (let r of e) {
 		if (n(r.content), r.steps) for (let e of r.steps) n(e.result);
@@ -12132,14 +12138,14 @@ function Xp(e) {
 	}
 	return t;
 }
-function Zp(e, t) {
+function Qp(e, t) {
 	let n = [];
 	for (let r of Object.keys(e)) r.startsWith("large_results/") && !t.has(r) && n.push(r);
 	return n;
 }
 //#endregion
 //#region src/core/utils/serialRunner.ts
-function Qp() {
+function $p() {
 	let e = Promise.resolve();
 	return function(t) {
 		let n = e.then(t, t);
@@ -12148,24 +12154,24 @@ function Qp() {
 }
 //#endregion
 //#region src/core/sdk/createChatSdk.ts
-var $p = 30, em = /* @__PURE__ */ new Map();
-function tm(e, t) {
+var em = 30, tm = /* @__PURE__ */ new Map();
+function nm(e, t) {
 	return e === "restore_data" ? "restore" : e === "write" ? t?.del ? "delete" : t?.patch ? "edit" : "set" : null;
 }
-function nm(e) {
+function rm(e) {
 	return e === "spawn_agent" || e === "spawn_agents" || e.startsWith("use_");
 }
-function rm(e, t, n, r) {
+function im(e, t, n, r) {
 	let i = 0;
 	return {
 		name: "sdk-events",
 		wrapToolCall: async (t, r) => {
-			let i = await r(t), a = tm(t.name, t.args);
+			let i = await r(t), a = nm(t.name, t.args);
 			return a ? e({
 				type: "data_change",
 				operation: a,
 				value: n()?.bind
-			}) : i.status === "done" && nm(t.name) && e({
+			}) : i.status === "done" && rm(t.name) && e({
 				type: "data_change",
 				operation: "edit",
 				value: n()?.bind
@@ -12193,7 +12199,7 @@ function rm(e, t, n, r) {
 		}
 	};
 }
-function im(e, t, n, r, i) {
+function am(e, t, n, r, i) {
 	if (!n) return i && console.warn(`[page-agent-sdk][focus] capabilities.focus 关闭,${t} 忽略`), {
 		ok: !1,
 		error: "capabilities.focus 关闭"
@@ -12211,16 +12217,16 @@ function im(e, t, n, r, i) {
 		error: "当前无主数据 schema,无法聚焦"
 	});
 }
-function am(e, n) {
+function om(e, n) {
 	let i = {
 		prompt_tokens: 0,
 		completion_tokens: 0,
 		total_tokens: 0
-	}, a = xf(() => J, () => e.conflictPolicy ?? "ask"), o = /* @__PURE__ */ Lt(0), s = Yf(e.storage);
+	}, a = xf(() => J, () => e.conflictPolicy ?? "ask"), o = /* @__PURE__ */ Lt(0), s = Xf(e.storage);
 	e.debug && s && s.onEvent((e) => console.log("[page-agent-sdk][storage]", e));
 	let { modelCaps: c, summaryLlmInvoke: l, titleLlmInvoke: u, compressDecisionInvoke: d } = bf(e), f = c;
 	if (e.debug && console.log("[page-agent-sdk][modelCaps]", f), f.contextWindow < 2e5) throw Error(`[page-agent-sdk] 模型上下文窗口 ${f.contextWindow} 小于最小支持 ${p}(需 ≥200K 窗口模型,如 GLM-5.2/Claude/Kimi/Qwen-1M/DeepSeek-v4)`);
-	let h = np(e, f.contextWindow), g = h.enableLLMSummary !== !1, _ = (e.contextOptions && e.contextOptions.preserveLastToolResults) ?? tp[e.contextPreset ?? "auto"], v = new Set(_), y = e.llm;
+	let h = rp(e, f.contextWindow), g = h.enableLLMSummary !== !1, _ = (e.contextOptions && e.contextOptions.preserveLastToolResults) ?? np[e.contextPreset ?? "auto"], v = new Set(_), y = e.llm;
 	e.debug && !l && console.warn("[page-agent-sdk][summarization] 未构造 llmInvoke(apiKey 缺失?),摘要回退零成本索引摘要");
 	let b = /* @__PURE__ */ Et([]), x = fu(e.vfs?.initialFiles, {
 		persist: s ? { save: (e) => {
@@ -12276,7 +12282,7 @@ function am(e, n) {
 	let M = { current: null }, N = e.data ? {
 		...e.data,
 		description: e.data.description ?? "主数据对象"
-	} : void 0, P = !(e.subagents ?? []).some((e) => e._codeAsset) && Qf(e.capabilities).subagent, ie = e.subagents;
+	} : void 0, P = !(e.subagents ?? []).some((e) => e._codeAsset) && $f(e.capabilities).subagent, ie = e.subagents;
 	P && N?.schema && Xo(N.schema).length && (ie = [...e.subagents ?? [], af()], console.info("[page-agent-sdk] 检测到 schema 含代码组件数组(如 components[].code),已自动装配 HTML 代码子 agent(委派编排 + vfs 工作副本 + 格式校验 + 增量 commit)。需定制(codeField/formatCheck/craftNotes 等)请显式传 createHtmlSubagent(...)"));
 	let F = (ie ?? []).filter((e) => !!e._codeAsset), I = /* @__PURE__ */ new Set();
 	for (let e of F) {
@@ -12293,7 +12299,7 @@ function am(e, n) {
 		getTodos: () => M.current?.getState?.()?.todos ?? [],
 		messages: b,
 		maxCheckpoints: le && typeof le == "object" ? le.maxCheckpoints : void 0
-	}) : null, de = !le || typeof le != "object" || le.auto !== !1, z = Qf(e.capabilities), B = z.dataOps, fe = z.draftWrite, pe = z.automation, me = cu({
+	}) : null, de = !le || typeof le != "object" || le.auto !== !1, z = $f(e.capabilities), B = z.dataOps, fe = z.draftWrite, pe = z.automation, me = cu({
 		...e,
 		locale: e.i18n?.locale
 	});
@@ -12310,7 +12316,7 @@ function am(e, n) {
 		vfsStore: fe || N?.resources?.length ? x : void 0,
 		...se.length ? { pgIdPaths: se } : {},
 		...ce.length ? { largeTextPaths: ce } : {}
-	}) : [], he = B ? V : [], H = B && N ? V.controller ?? null : null, ge = B && N?.resources?.length && H?.getResourcesSnapshot ? Up({ getResourcesSnapshot: () => H?.getResourcesSnapshot?.() ?? [] }) : void 0, U = () => H?.get() ?? N, _e = new Set(V.map((e) => e.name)), ve = e.conflictWatchFields ?? [], ye = !ve.includes("*") && ve.length ? new Set(ve) : void 0, be = H ? Fd({
+	}) : [], he = B ? V : [], H = B && N ? V.controller ?? null : null, ge = B && N?.resources?.length && H?.getResourcesSnapshot ? Wp({ getResourcesSnapshot: () => H?.getResourcesSnapshot?.() ?? [] }) : void 0, U = () => H?.get() ?? N, _e = new Set(V.map((e) => e.name)), ve = e.conflictWatchFields ?? [], ye = !ve.includes("*") && ve.length ? new Set(ve) : void 0, be = H ? Fd({
 		getBind: () => U()?.bind,
 		recomputeAll: () => H.recomputeAllBaselines?.(),
 		hasBaselines: () => H.hasBaselines?.() ?? !1,
@@ -12327,15 +12333,15 @@ function am(e, n) {
 				}
 			}), Vt(n));
 		}
-	}) : void 0, W = /* @__PURE__ */ new Map(), xe = zp(z, he, op, z.domInspect && !z.skills ? [
-		...fp,
-		Sp,
-		Cp
-	] : fp, jp);
+	}) : void 0, W = /* @__PURE__ */ new Map(), xe = Bp(z, he, sp, z.domInspect && !z.skills ? [
+		...pp,
+		Cp,
+		wp
+	] : pp, Mp);
 	xe.forEach((e) => W.set(e.name, "builtin"));
 	let Se = [...e.tools || []];
 	Se.forEach((e) => W.set(e.name, "user"));
-	let Ce = Pp(e.actions ?? {});
+	let Ce = Fp(e.actions ?? {});
 	Ce.forEach((e) => W.set(e.name, "action"));
 	let we = [], Te = !1, Ee = e.humanConfirm !== !1 && (!e.approval || e.approval.humanConfirmTool !== !1), De = Ee ? Cl() : null;
 	De && W.set(xl, "builtin");
@@ -12408,7 +12414,7 @@ function am(e, n) {
 	let G = [], Fe = /* @__PURE__ */ new Map(), K = Ie();
 	function Ie() {
 		ki(Se), ki(Ce), ki(G);
-		let { tools: e, collisions: t } = Bp([
+		let { tools: e, collisions: t } = Vp([
 			{
 				label: "builtin",
 				tools: xe
@@ -12556,8 +12562,8 @@ function am(e, n) {
 		} : void 0
 	}) : void 0, pt = Xe ? $l({
 		contextWindow: f.contextWindow,
-		thresholdRatio: np(e, f.contextWindow).summaryThresholdRatio
-	}) : void 0, mt = Hp({
+		thresholdRatio: rp(e, f.contextWindow).summaryThresholdRatio
+	}) : void 0, mt = Up({
 		...z,
 		humanConfirm: Ee,
 		subagents: oe?.map(lt)
@@ -12577,7 +12583,7 @@ function am(e, n) {
 				return;
 			}
 		}
-	} : null, _t = $f(e.onEvent), J = _t.emit, vt, yt = [], bt = (e) => ({
+	} : null, _t = ep(e.onEvent), J = _t.emit, vt, yt = [], bt = (e) => ({
 		name: e.name,
 		description: e.description,
 		content: typeof e.getContent == "function" ? e.getContent() : ""
@@ -12585,7 +12591,7 @@ function am(e, n) {
 		name: e.name,
 		description: e.description,
 		getContent: () => e.content
-	}), St = e.skillStorage === !1 ? null : Jp({
+	}), St = e.skillStorage === !1 ? null : Yp({
 		...typeof e.skillStorage == "object" ? e.skillStorage : {},
 		id: e.skillStorage && typeof e.skillStorage == "object" && e.skillStorage.id ? e.skillStorage.id : `agent::${n}`
 	}), Ct = () => {
@@ -12617,14 +12623,14 @@ function am(e, n) {
 			decideInvoke: d,
 			getSnapshot: () => pt?.getSnapshot()
 		} : {}
-	}) : void 0, Dt = ip([
+	}) : void 0, Dt = ap([
 		...ht ? [ht] : [],
 		mt,
 		...Re ? [T] : [],
 		E,
 		D,
 		...Le ? [w] : [],
-		...Be ? [vt = _c([...z.domInspect && !(e.skills || []).some((e) => e.name === wp.name) ? [wp] : [], ...e.skills || []], {
+		...Be ? [vt = _c([...z.domInspect && !(e.skills || []).some((e) => e.name === Tp.name) ? [Tp] : [], ...e.skills || []], {
 			readVfs: Ve ? (e) => x.files[e]?.content : void 0,
 			onToolsReady: (e, t) => {
 				for (let n of t) {
@@ -12654,12 +12660,12 @@ function am(e, n) {
 		...gt ? [gt] : [],
 		...pt ? [pt] : [],
 		...e.middleware || [],
-		...pe ? [Mp(i, {
+		...pe ? [Np(i, {
 			tokenBudget: e.tokenBudget,
 			timeBudgetMs: e.timeBudgetMs
 		}, J)] : [],
-		rm(J, b, U, i)
-	]), Ot = e.maxMemoryRounds ?? $p;
+		im(J, b, U, i)
+	]), Ot = e.maxMemoryRounds ?? em;
 	function kt(e) {
 		return (e) => {
 			e.type !== "approval_request" && J(e);
@@ -12673,7 +12679,7 @@ function am(e, n) {
 			e.debug && console.warn("[page-agent-sdk][persist] refreshSessions 失败(已吞):", t);
 		}
 	}
-	let Mt = Qp(), Nt = /* @__PURE__ */ new Set();
+	let Mt = $p(), Nt = /* @__PURE__ */ new Set();
 	function Y(e) {
 		let t = new AbortController(), n = () => t.abort();
 		return e && (e.aborted ? t.abort() : e.addEventListener("abort", n, { once: !0 })), Nt.add(t), {
@@ -12782,7 +12788,7 @@ function am(e, n) {
 					code: "IMAGE_UNSUPPORTED_MODEL"
 				}), Error(`[page-agent-sdk] ${e}`);
 			}
-			x?.setProtectedRefs?.(Xp(b));
+			x?.setProtectedRefs?.(Zp(b));
 			let i = pe ? t.maxAutoRetries ?? 1 : 0, o = 0, c = !1, l = kt(t.signal);
 			if (t.signal) {
 				let e = () => a.resolve("keep_external");
@@ -12857,7 +12863,7 @@ function am(e, n) {
 			if (await X.initDone, !e.length) return [];
 			if (X.refCount <= 0) throw Error("page-agent-sdk: agent 已释放(unmount),拒绝排队中的 batch");
 			let r = [], i = kt(n);
-			if (x?.setProtectedRefs?.(Xp(b)), n) {
+			if (x?.setProtectedRefs?.(Zp(b)), n) {
 				let e = () => a.resolve("keep_external");
 				n.aborted ? e() : n.addEventListener("abort", e, { once: !0 });
 			}
@@ -13004,7 +13010,7 @@ function am(e, n) {
 					code: "IMAGE_UNSUPPORTED_MODEL"
 				}), Error(`[page-agent-sdk] ${e}`);
 			}
-			x?.setProtectedRefs?.(Xp(e));
+			x?.setProtectedRefs?.(Zp(e));
 			let i = (e) => {
 				t?.(e), J(e), e.type === "subagent" && (e.kind === "tool_call" || e.kind === "tool_result") && X.infoTick.value++;
 			};
@@ -13019,7 +13025,7 @@ function am(e, n) {
 			if (X.refCount--, X.refCount <= 0) {
 				Pt(), Te = !0, s && (x.flush?.(), s.flush(), s.dispose()), St && St.dispose();
 				let e = X.mcpClosers.splice(0);
-				e.length && Promise.allSettled(e.map((e) => e())), em.delete(n);
+				e.length && Promise.allSettled(e.map((e) => e())), tm.delete(n);
 			}
 		},
 		resolveConflict: a.resolve,
@@ -13130,7 +13136,7 @@ function am(e, n) {
 				workingMemory: ze ? j.getWorkingMemory() : void 0,
 				focus: ke ? A.getFocus() : void 0,
 				focuses: ke ? A.getFocuses() : [],
-				actions: Fp(e.actions ?? {}),
+				actions: Ip(e.actions ?? {}),
 				subagent: {
 					enabled: !!nt,
 					maxDepth: e.subagent?.maxDepth ?? 1,
@@ -13217,11 +13223,11 @@ function am(e, n) {
 			return ke ? A.getFocuses() : [];
 		},
 		setFocus(t) {
-			let n = im(t, "setFocus", ke, () => U()?.schema, e.debug);
+			let n = am(t, "setFocus", ke, () => U()?.schema, e.debug);
 			return n.ok ? (A.setFocus(t), e.debug && A.isInvokeActive() && console.info("[page-agent-sdk][focus] 在途流程进行中,聚焦将在下一次输入生效(当前流程不受影响)"), X.infoTick.value++, { ok: !0 }) : n;
 		},
 		addFocus(t) {
-			let n = im(t, "addFocus", ke, () => U()?.schema, e.debug);
+			let n = am(t, "addFocus", ke, () => U()?.schema, e.debug);
 			return n.ok ? A.getFocuses().length >= 8 ? (e.debug && console.warn("[page-agent-sdk][focus] addFocus 拒绝:焦点数已达上限 8(augmentPrompt 注入每焦点子树 schema,过多致 system prompt 超预算)"), {
 				ok: !1,
 				error: "焦点数上限 8(避免 system prompt 撑爆)"
@@ -13271,14 +13277,14 @@ function am(e, n) {
 	}
 	function Rt(e) {
 		let t = {};
-		for (let n of Xp(e)) {
+		for (let n of Zp(e)) {
 			let e = x.files[n];
 			e && (t[n] = e.content);
 		}
 		return t;
 	}
 	function zt() {
-		let e = Zp(x.files, Xp(b));
+		let e = Qp(x.files, Zp(b));
 		for (let t of e) delete x.files[t];
 	}
 	function Bt() {
@@ -13489,12 +13495,12 @@ function am(e, n) {
 		});
 	})(), X;
 }
-function om(e, t) {
+function sm(e, t) {
 	let n = e.id ?? Sf();
 	e.id || console.warn(`[page-agent-sdk] 未传 options.id,已生成随机 id "${n}"。刷新后持久化数据无法恢复,请传稳定 id。`);
-	let r = e.streaming ?? !0, i = e.ui ?? "default", a, o = e.shareContext ? em.get(n) : void 0;
-	o ? a = o : (a = am(e, n), e.shareContext && em.set(n, a)), a.refCount++;
-	let s = null, c = Xf(e), l = null, u = null;
+	let r = e.streaming ?? !0, i = e.ui ?? "default", a, o = e.shareContext ? tm.get(n) : void 0;
+	o ? a = o : (a = om(e, n), e.shareContext && tm.set(n, a)), a.refCount++;
+	let s = null, c = Zf(e), l = null, u = null;
 	async function d(n) {
 		if (await a.initDone, s) {
 			s.show();
@@ -13713,7 +13719,7 @@ function om(e, t) {
 }
 //#endregion
 //#region src/core/sdk/ragSubagent.ts
-function sm(e, t, n, r, i) {
+function cm(e, t, n, r, i) {
 	let a = [];
 	e && a.push("vfs_grep + vfs_read(搜预注入文档)"), t && a.push(`${r}(语义检索)`), n && a.push(`${i}(按 source 加载)`), a.push("fetch_document(公网 URL)");
 	let o = [];
@@ -13728,7 +13734,7 @@ function sm(e, t, n, r, i) {
 
 你是只读检索角色,不要尝试修改任何数据。不要尝试上面未列出的工具。`;
 }
-function cm(e, t, n, r, i) {
+function lm(e, t, n, r, i) {
 	let a = [], o = [];
 	return e && (a.push("- vfs_grep / vfs_read:搜集成方预注入 vfs 的文档(组件文档 / UI 规范)—— 快、静态,先查"), o.push("- 静态文档(组件库文档 / UI 规范):vfs_grep")), t && (a.push(`- ${r}:语义检索(retriever 向量库)—— 模糊匹配,关键词不确定 / 语义相似时用`), o.push(`- 语义相似(「瀑布流组件」「倒计时」「拼团」):${r}`)), n && (a.push(`- ${i}:按 source 精确加载(已知文档 id / URL / key)—— 精确取特定文档`), o.push(`- 已知文档 id / URL:${i}`)), a.push("- fetch_document:公网 URL —— 查公开资料"), o.push("- 公开 URL(设计规范网站 / 第三方文档):fetch_document"), `# 知识检索策略(RAG)
 
@@ -13745,12 +13751,12 @@ ${a.join("\n")}
 ## 何时用何源
 ${o.join("\n")}`;
 }
-var lm = {
+var um = {
 	name: "rag-search",
 	description: "多源知识检索策略:vfs 预注入文档 → 语义检索 → 指定文档加载 → 公网;综合结构化结论 + 溯源",
-	getContent: () => cm(!0, !0, !0, "search_docs", "load_doc")
+	getContent: () => lm(!0, !0, !0, "search_docs", "load_doc")
 };
-function um(e, n, i) {
+function dm(e, n, i) {
 	let a = r(async ({ query: e, topK: t }) => {
 		try {
 			let r = await n(e, { topK: t ?? i });
@@ -13768,7 +13774,7 @@ function um(e, n, i) {
 	});
 	return ki([a]), a;
 }
-function dm(e, n) {
+function fm(e, n) {
 	let i = r(async ({ source: e }) => {
 		try {
 			let t = await n(e), r = Array.isArray(t) ? t : [t];
@@ -13783,19 +13789,19 @@ function dm(e, n) {
 	});
 	return ki([i]), i;
 }
-function fm(e) {
+function pm(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(um(s, t, o)), n && p.push(dm(c, n)), f && p.push(...f);
+	t && p.push(dm(s, t, o)), n && p.push(fm(c, n)), f && p.push(...f);
 	let m = r ? [
 		"vfs_grep",
 		"vfs_read",
 		"vfs_json_read"
-	] : void 0, h = sm(r, !!t, !!n, s, c), g = {
+	] : void 0, h = cm(r, !!t, !!n, s, c), g = {
 		name: "rag-search",
-		description: lm.description,
-		getContent: () => cm(r, !!t, !!n, s, c)
+		description: um.description,
+		getContent: () => lm(r, !!t, !!n, s, c)
 	};
 	return {
 		id: i,
@@ -13810,7 +13816,7 @@ function fm(e) {
 }
 //#endregion
 //#region src/core/utils/clipboard.ts
-async function pm(e) {
+async function mm(e) {
 	try {
 		let t = globalThis.navigator?.clipboard;
 		if (t && typeof t.writeText == "function") return await t.writeText(e), !0;
@@ -13828,8 +13834,8 @@ async function pm(e) {
 }
 //#endregion
 //#region src/core/composables/useChat.ts
-var mm = 4e3;
-function hm(e = {}) {
+var hm = 4e3;
+function gm(e = {}) {
 	let { fetchResponse: t, fetchStream: n, onPersist: r, onClear: i, onQueuedCleared: a, onBeforeRegenerate: o } = e, s = /* @__PURE__ */ Et({
 		messages: e.messages ?? [],
 		loading: !1,
@@ -13909,7 +13915,7 @@ function hm(e = {}) {
 								let t = e.delta || "";
 								n.subReasonFull = (n.subReasonFull || "") + t;
 								let r = (n.subReason || "") + t;
-								n.subReason = r.length > mm ? r.slice(-4e3) : r;
+								n.subReason = r.length > hm ? r.slice(-4e3) : r;
 								break;
 							}
 							n.children ||= [];
@@ -14039,7 +14045,7 @@ function hm(e = {}) {
 }
 //#endregion
 //#region src/core/components/icons.ts
-var gm = {
+var _m = {
 	header: "🤖",
 	subagent: "🤖",
 	subagentProgress: "🧬",
@@ -14050,10 +14056,10 @@ var gm = {
 	recommend: "💡",
 	conflict: "⚠️"
 };
-function _m(e) {
-	let t = { ...gm };
+function vm(e) {
+	let t = { ..._m };
 	if (!e) return t;
-	let n = Object.keys(gm);
+	let n = Object.keys(_m);
 	for (let r of n) {
 		let n = e[r];
 		typeof n == "string" && (t[r] = n);
@@ -14062,7 +14068,7 @@ function _m(e) {
 }
 //#endregion
 //#region src/core/components/messages.ts
-var vm = {
+var ym = {
 	defaultTitle: "AI 助手",
 	inputPlaceholder: "输入消息,Enter 发送...",
 	newSession: "新建会话",
@@ -14286,8 +14292,8 @@ var vm = {
 	codeDemoText: "这是一段示例文字，用于展示 CSS 效果。",
 	codeDemoButton: "按钮",
 	codeDemoInput: "输入框"
-}, ym = {
-	"zh-CN": vm,
+}, bm = {
+	"zh-CN": ym,
 	"en-US": {
 		defaultTitle: "AI Assistant",
 		inputPlaceholder: "Type a message, Enter to send...",
@@ -14514,10 +14520,10 @@ var vm = {
 		codeDemoInput: "Input"
 	}
 };
-function bm(e = "zh-CN", t) {
+function xm(e = "zh-CN", t) {
 	let n = {
-		...vm,
-		...ym[e]
+		...ym,
+		...bm[e]
 	};
 	if (!t) return n;
 	let r = { ...n };
@@ -14529,9 +14535,9 @@ function bm(e = "zh-CN", t) {
 }
 //#endregion
 //#region src/core/composables/chatContext.ts
-var xm = Symbol("chatContext");
-function Sm(e = {}) {
-	let t = hm({
+var Sm = Symbol("chatContext");
+function Cm(e = {}) {
+	let t = gm({
 		fetchResponse: e.fetchResponse,
 		fetchStream: e.fetchStream,
 		messages: e.messages,
@@ -14553,7 +14559,7 @@ function Sm(e = {}) {
 	}, h = /* @__PURE__ */ Lt({}), g = (e) => h.value[e] === !0, _ = (e) => {
 		h.value[e] = !g(e);
 	}, v = /* @__PURE__ */ Lt(!1), y = (e) => {
-		pm(e).then((e) => {
+		mm(e).then((e) => {
 			e && (v.value = !0, setTimeout(() => {
 				v.value = !1;
 			}, 1500));
@@ -14615,7 +14621,7 @@ function Sm(e = {}) {
 		e.onClearFocus?.();
 	}, F = (t) => {
 		e.onFocusChipClick?.(t);
-	}, I = _m(e.icons), ae = e.locale ?? "zh-CN", oe = bm(ae, e.dialogMessages);
+	}, I = vm(e.icons), ae = e.locale ?? "zh-CN", oe = xm(ae, e.dialogMessages);
 	return {
 		chat: t,
 		inputText: o,
@@ -14653,18 +14659,19 @@ function Sm(e = {}) {
 		focusChipClick: F,
 		icons: I,
 		locale: ae,
-		messages: oe
+		messages: oe,
+		toolStepView: e.toolStepView
 	};
 }
-function Cm() {
-	let e = Gn(xm);
+function wm() {
+	let e = Gn(Sm);
 	if (!e) throw Error("useChatContext 必须在 provide(chatContextKey) 的组件子树内调用");
 	return e;
 }
 //#endregion
 //#region src/core/index.headless.ts
-function wm(e) {
-	return om(e);
+function Tm(e) {
+	return sm(e);
 }
 //#endregion
-export { Zf as CAPABILITIES, ep as CONTEXT_PRESETS, lf as CompressDecisionSchema, pp as DEFAULT_COMPUTED_STYLES, Pc as DEFAULT_PROMPT_SOFT_CAP, au as DEFAULT_SYSTEM_PROMPT, id as HTML_VOID_TAGS, xl as HUMAN_CONFIRM_TOOL_NAME, li as ImageInputError, p as MIN_CONTEXT_WINDOW, Ki as MODEL_UNAVAILABLE_GUIDANCE, Nc as SOFT_CAP_MIN_WINDOW, Dc as STOP_WORDS, js as UNSAFE_KEYS, Fp as actionsToInspectInfo, Pp as actionsToTools, ai as agentError, Ql as analyzeContext, Ws as applyPatchToClone, qs as applyPatchToLive, Ku as applyPatchesToBind, Wo as arrayMinLength, ii as asAgentError, Wd as buildCollectorJs, vp as buildCssPath, su as buildDataPrompt, Bd as buildDiagnosticsReport, Gd as buildSandboxSrcdoc, cu as buildSystemPrompt, xm as chatContextKey, Gu as commitSetToBind, Zd as composeStructureThenRender, bi as compressImage, iu as connectMcp, C as constructLlmFromConfig, S as constructOpenLlmSync, pm as copyText, Po as createAgent, bl as createApprovalMiddleware, Sm as createChatContext, wm as createChatSdk, jl as createCheckpointManager, Ml as createCheckpointMiddleware, xf as createConflictManager, $l as createContextInspectorMiddleware, rd as createDataOps, tf as createHtmlFormatCheck, Xd as createHtmlRenderCheck, af as createHtmlSubagent, wl as createHumanConfirmMiddleware, Cl as createHumanConfirmTool, Uf as createMemoryBackend, pl as createMemoryMiddleware, u as createProxyLlm, fm as createRagSubagent, Qi as createSandboxRunner, $f as createSdkEvents, Qp as createSerialRunner, qf as createSessionStore, Jp as createSkillStore, il as createSubagentMiddleware, Bc as createSubagentTracker, sl as createSubagentsMiddleware, Hp as createUsageHintsMiddleware, Nl as createVerifyMiddleware, fu as createVfs, Gf as createWebStorageBackend, zl as createWriteBackCheck, qi as decorateModelUnavailable, Is as deepClone, Rp as defineDataToolset, rc as defineSkill, of as defineTool, Fs as deleteByPath, uf as deriveTitle, is as describeSchemaNode, bo as detectGarbledToolCall, Zs as diffObjects, Cp as domInfoTool, wp as domInspectSkill, Sp as domSearchTool, up as domToStructure, fp as domTools, Lp as domToolsStatic, Go as elementSchemaCandidates, gp as ensureDomListenerRecorder, kc as estimateMessageTokens, Ac as estimateRoundTokens, h as estimateTokens, T as extractReasoningDelta, _s as extractSchemaHint, eu as extractText, w as extractTextDelta, E as extractUsage, op as fetchDocTools, Ip as fetchTools, Xs as findStrippedKeys, as as formatConstraints, ei as formatZodIssues, Q as getByPath, dp as getDomTool, xp as getElementInfo, Dp as getEnvSummary, _p as getRecordedListeners, Jd as getSandboxLifecycle, Ro as getSchemaAtPath, Fo as getSchemaTopKeys, Hs as hashValue, fs as htmlOrchestratorPrompt, jc as indexSummarize, Ap as inspectEnvTool, jp as inspectTools, df as isChatModel, Wi as isContextLengthError, Gi as isModelUnavailableError, Io as isPathAllowed, Ff as isQuotaError, Ms as isUnsafePath, ca as jpEval, ni as jsonParseError, Bs as limitDepth, Rd as maskUrlCredentials, Rs as maybeParseValue, Md as measureWriteScale, Ud as normalizeRenderResult, ee as normalizeUsage, _ as offloadPassThroughChars, g as offloadThresholdChars, ds as presets, Qo as projectBySchema, Zo as projectBySchemaDeep, zs as projectFields, Mc as recallRounds, Yd as renderInSandbox, os as renderSchemaHint, ss as renderSchemaOverview, us as renderSchemaShallow, Qf as resolveCapabilities, np as resolveContextOptions, Xf as resolveDialogConfig, bf as resolveLlm, m as resolveModelCaps, Fc as resolvePromptSoftCap, Vo as resolveSchemaPath, Yf as resolveStorage, Ys as restoreInPlace, Js as restoreLive, ri as routeError, fa as runSandboxedScript, Ns as safeMerge, Ep as safeSerialize, $ as safeStringify, Uo as schemaHasRefinement, yp as searchDom, ua as searchJson, zp as selectBuiltinTools, Ps as setByPath, Ic as shouldTriggerCompression, Vd as stringifyDiagnosticsReport, ps as systemPromptHelpers, Oc as tokenize, Z as toolError, Lo as unwrapSchema, hm as useChat, Cm as useChatContext, Ho as validateAtPath, od as validateHtmlFormat, Uu as validateRootValueLocally, Wu as validateWriteLocally, Us as watchFieldsHash, e as z, ti as zodError };
+export { Qf as CAPABILITIES, tp as CONTEXT_PRESETS, lf as CompressDecisionSchema, mp as DEFAULT_COMPUTED_STYLES, Pc as DEFAULT_PROMPT_SOFT_CAP, au as DEFAULT_SYSTEM_PROMPT, id as HTML_VOID_TAGS, xl as HUMAN_CONFIRM_TOOL_NAME, li as ImageInputError, p as MIN_CONTEXT_WINDOW, Ki as MODEL_UNAVAILABLE_GUIDANCE, Nc as SOFT_CAP_MIN_WINDOW, Dc as STOP_WORDS, js as UNSAFE_KEYS, Ip as actionsToInspectInfo, Fp as actionsToTools, ai as agentError, Ql as analyzeContext, Ws as applyPatchToClone, qs as applyPatchToLive, Ku as applyPatchesToBind, Wo as arrayMinLength, ii as asAgentError, Wd as buildCollectorJs, yp as buildCssPath, su as buildDataPrompt, Bd as buildDiagnosticsReport, Gd as buildSandboxSrcdoc, cu as buildSystemPrompt, Sm as chatContextKey, Gu as commitSetToBind, Zd as composeStructureThenRender, bi as compressImage, iu as connectMcp, C as constructLlmFromConfig, S as constructOpenLlmSync, mm as copyText, Po as createAgent, bl as createApprovalMiddleware, Cm as createChatContext, Tm as createChatSdk, jl as createCheckpointManager, Ml as createCheckpointMiddleware, xf as createConflictManager, $l as createContextInspectorMiddleware, rd as createDataOps, tf as createHtmlFormatCheck, Xd as createHtmlRenderCheck, af as createHtmlSubagent, wl as createHumanConfirmMiddleware, Cl as createHumanConfirmTool, Uf as createMemoryBackend, pl as createMemoryMiddleware, u as createProxyLlm, pm as createRagSubagent, Qi as createSandboxRunner, ep as createSdkEvents, $p as createSerialRunner, qf as createSessionStore, Jf as createSessionStoreWithBackend, Yp as createSkillStore, il as createSubagentMiddleware, Bc as createSubagentTracker, sl as createSubagentsMiddleware, Up as createUsageHintsMiddleware, Nl as createVerifyMiddleware, fu as createVfs, Gf as createWebStorageBackend, zl as createWriteBackCheck, qi as decorateModelUnavailable, Is as deepClone, zp as defineDataToolset, rc as defineSkill, of as defineTool, Fs as deleteByPath, uf as deriveTitle, is as describeSchemaNode, bo as detectGarbledToolCall, Zs as diffObjects, wp as domInfoTool, Tp as domInspectSkill, Cp as domSearchTool, dp as domToStructure, pp as domTools, Rp as domToolsStatic, Go as elementSchemaCandidates, _p as ensureDomListenerRecorder, kc as estimateMessageTokens, Ac as estimateRoundTokens, h as estimateTokens, T as extractReasoningDelta, _s as extractSchemaHint, eu as extractText, w as extractTextDelta, E as extractUsage, sp as fetchDocTools, Lp as fetchTools, Xs as findStrippedKeys, as as formatConstraints, ei as formatZodIssues, Q as getByPath, fp as getDomTool, Sp as getElementInfo, Op as getEnvSummary, vp as getRecordedListeners, Jd as getSandboxLifecycle, Ro as getSchemaAtPath, Fo as getSchemaTopKeys, Hs as hashValue, fs as htmlOrchestratorPrompt, jc as indexSummarize, jp as inspectEnvTool, Mp as inspectTools, df as isChatModel, Wi as isContextLengthError, Gi as isModelUnavailableError, Io as isPathAllowed, Ff as isQuotaError, Ms as isUnsafePath, ca as jpEval, ni as jsonParseError, Bs as limitDepth, Rd as maskUrlCredentials, Rs as maybeParseValue, Md as measureWriteScale, Ud as normalizeRenderResult, ee as normalizeUsage, _ as offloadPassThroughChars, g as offloadThresholdChars, ds as presets, Qo as projectBySchema, Zo as projectBySchemaDeep, zs as projectFields, Mc as recallRounds, Yd as renderInSandbox, os as renderSchemaHint, ss as renderSchemaOverview, us as renderSchemaShallow, $f as resolveCapabilities, rp as resolveContextOptions, Zf as resolveDialogConfig, bf as resolveLlm, m as resolveModelCaps, Fc as resolvePromptSoftCap, Vo as resolveSchemaPath, Xf as resolveStorage, Ys as restoreInPlace, Js as restoreLive, ri as routeError, fa as runSandboxedScript, Ns as safeMerge, Dp as safeSerialize, $ as safeStringify, Uo as schemaHasRefinement, bp as searchDom, ua as searchJson, Bp as selectBuiltinTools, Ps as setByPath, Ic as shouldTriggerCompression, Vd as stringifyDiagnosticsReport, ps as systemPromptHelpers, Oc as tokenize, Z as toolError, Lo as unwrapSchema, gm as useChat, wm as useChatContext, Ho as validateAtPath, od as validateHtmlFormat, Uu as validateRootValueLocally, Wu as validateWriteLocally, Us as watchFieldsHash, e as z, ti as zodError };