page-agent-sdk 2.21.0 → 2.22.1

package/dist/page-agent-sdk.js

@@ -21,16 +21,18 @@ function _(e) {
 function v(e) {
 	let t = e.model || "gpt-3.5-turbo", r = e.temperature, i = e.maxTokens, a = e.baseUrl;
 	if (e.mode === "direct") {
+		let o = !1;
 		try {
-			if (typeof location < "u" && location.protocol === "https:" && ![
+			o = typeof location < "u" && location.protocol === "https:" && ![
 				"localhost",
 				"127.0.0.1",
 				"0.0.0.0"
-			].includes(location.hostname)) {
-				if (e.throwOnDirectInProduction) throw Error("[page-agent-sdk][proxyLlm] direct 模式在生产环境(https + 非本地)会泄露 apiKey(进 bundle),建议改用 proxy 模式(throwOnDirectInProduction 已启用强安全闸;若确需生产直连,设为 false 显式承认风险)");
-				console.warn("[page-agent-sdk][proxyLlm] direct 模式在生产环境(https + 非本地)会泄露 apiKey(进 bundle),建议改用 proxy 模式");
-			}
+			].includes(location.hostname);
 		} catch {}
+		if (o) {
+			if (e.throwOnDirectInProduction) throw Error("[page-agent-sdk][proxyLlm] direct 模式在生产环境(https + 非本地)会泄露 apiKey(进 bundle),建议改用 proxy 模式(throwOnDirectInProduction 已启用强安全闸;若确需生产直连,设为 false 显式承认风险)");
+			console.warn("[page-agent-sdk][proxyLlm] direct 模式在生产环境(https + 非本地)会泄露 apiKey(进 bundle),建议改用 proxy 模式");
+		}
 		if (!e.apiKey) throw Error("[page-agent-sdk][proxyLlm] direct 模式需提供 apiKey(开发环境用真实 key)");
 		return new n({
 			apiKey: e.apiKey,
@@ -16897,8 +16899,95 @@ function ib(e) {
 	return e.dialog ?? {};
 }
 //#endregion
+//#region src/core/capabilities.ts
+var ab = [
+	{
+		name: "dataOps",
+		defaultOn: !0
+	},
+	{
+		name: "fetch",
+		defaultOn: !0
+	},
+	{
+		name: "planning",
+		defaultOn: !0
+	},
+	{
+		name: "missionAnchor",
+		defaultOn: !0
+	},
+	{
+		name: "workingMemory",
+		defaultOn: !0
+	},
+	{
+		name: "skills",
+		defaultOn: !0
+	},
+	{
+		name: "vfs",
+		defaultOn: !0
+	},
+	{
+		name: "summarization",
+		defaultOn: !0
+	},
+	{
+		name: "memory",
+		defaultOn: !0
+	},
+	{
+		name: "subagent",
+		defaultOn: !0
+	},
+	{
+		name: "inspectEnv",
+		defaultOn: !0
+	},
+	{
+		name: "verify",
+		defaultOn: !1
+	},
+	{
+		name: "domInspect",
+		defaultOn: !1
+	},
+	{
+		name: "draftWrite",
+		defaultOn: !1,
+		requires: ["dataOps", "vfs"]
+	},
+	{
+		name: "tracing",
+		defaultOn: !1
+	},
+	{
+		name: "todoDeps",
+		defaultOn: !1
+	},
+	{
+		name: "automation",
+		defaultOn: !1
+	}
+];
+function ob(e) {
+	let t = {};
+	for (let n of ab) {
+		let r = e?.[n.name];
+		t[n.name] = n.defaultOn ? r !== !1 : r === !0;
+	}
+	for (let e of ab) if (e.requires && t[e.name]) {
+		for (let n of e.requires) if (!t[n]) {
+			t[e.name] = !1;
+			break;
+		}
+	}
+	return t;
+}
+//#endregion
 //#region src/core/sdk/events.ts
-function ab(e) {
+function sb(e) {
 	let t = /* @__PURE__ */ new Set(), n = (n) => {
 		if (n.type !== "approval_request") {
 			if (e) try {
@@ -16924,7 +17013,7 @@ function ab(e) {
 }
 //#endregion
 //#region src/core/sdk/contextPreset.ts
-var ob = {
+var cb = {
 	auto: {
 		summaryThresholdRatio: .5,
 		windowRatio: .4,
@@ -16952,7 +17041,7 @@ var ob = {
 		enableRecall: !0,
 		enableLLMSummary: !0
 	}
-}, sb = {
+}, lb = {
 	auto: ["describe_data", "read"],
 	conservative: ["describe_data"],
 	aggressive: ["describe_data", "read"],
@@ -16963,8 +17052,8 @@ var ob = {
 		"search_data"
 	]
 };
-function cb(e, t) {
-	let n = ob[e.contextPreset ?? "auto"] ?? {}, r = e.contextOptions === !1 ? {} : e.contextOptions ?? {};
+function ub(e, t) {
+	let n = cb[e.contextPreset ?? "auto"] ?? {}, r = e.contextOptions === !1 ? {} : e.contextOptions ?? {};
 	return {
 		...n,
 		...r,
@@ -16974,7 +17063,7 @@ function cb(e, t) {
 }
 //#endregion
 //#region src/core/sdk/middlewareStack.ts
-var lb = {
+var db = {
 	dataHint: 10,
 	usageHints: 20,
 	todos: 30,
@@ -16991,29 +17080,29 @@ var lb = {
 	subagents: 140,
 	augmentSystem: 150
 };
-function ub(e) {
+function fb(e) {
 	return e.map((e, t) => ({
 		m: e,
 		i: t,
-		p: lb[e.name] ?? Infinity
+		p: db[e.name] ?? Infinity
 	})).sort((e, t) => e.p - t.p || e.i - t.i).map((e) => e.m);
 }
 //#endregion
 //#region src/core/tools/jsonUtils.ts
-var db = /* @__PURE__ */ new Set([
+var pb = /* @__PURE__ */ new Set([
 	"__proto__",
 	"constructor",
 	"prototype"
 ]);
-function fb(e) {
-	return e.split(".").some((e) => db.has(e));
+function mb(e) {
+	return e.split(".").some((e) => pb.has(e));
 }
-function pb(e, t) {
-	if (!(!t || typeof t != "object" || Array.isArray(t))) for (let n of Object.keys(t)) db.has(n) || (e[n] = t[n]);
+function hb(e, t) {
+	if (!(!t || typeof t != "object" || Array.isArray(t))) for (let n of Object.keys(t)) pb.has(n) || (e[n] = t[n]);
 }
-function mb(e, t) {
+function gb(e, t) {
 	if (!t) return e;
-	if (fb(t)) return;
+	if (mb(t)) return;
 	let n = t.split("."), r = e;
 	for (let e of n) {
 		if (r == null) return;
@@ -17021,8 +17110,8 @@ function mb(e, t) {
 	}
 	return r;
 }
-function hb(e, t, n) {
-	if (!t || fb(t)) return;
+function _b(e, t, n) {
+	if (!t || mb(t)) return;
 	let r = t.split("."), i = e;
 	for (let e = 0; e < r.length - 1; e++) {
 		let t = r[e];
@@ -17030,8 +17119,8 @@ function hb(e, t, n) {
 	}
 	i[r[r.length - 1]] = n;
 }
-function gb(e, t) {
-	if (!t || fb(t)) return !1;
+function vb(e, t) {
+	if (!t || mb(t)) return !1;
 	let n = t.split("."), r = e;
 	for (let e = 0; e < n.length - 1; e++) {
 		if (r == null) return !1;
@@ -17040,10 +17129,10 @@ function gb(e, t) {
 	let i = n[n.length - 1];
 	return r == null || !(i in r) ? !1 : (Array.isArray(r) && /^\d+$/.test(i) ? r.splice(Number(i), 1) : delete r[i], !0);
 }
-function _b(e) {
+function yb(e) {
 	return e === void 0 ? void 0 : JSON.parse(JSON.stringify(e));
 }
-function vb(e) {
+function bb(e) {
 	if (typeof e != "string") return { parsed: e };
 	let t = e.trim();
 	if (!t) return { parsed: e };
@@ -17054,23 +17143,23 @@ function vb(e) {
 		return n ? { parseError: t } : { parsed: e };
 	}
 }
-function yb(e, t) {
+function xb(e, t) {
 	if (typeof e != "object" || !e) return e;
 	let n = new Set(t);
-	if (Array.isArray(e)) return e.map((e) => yb(e, t));
+	if (Array.isArray(e)) return e.map((e) => xb(e, t));
 	let r = {};
 	for (let t of Object.keys(e)) n.has(t) && (r[t] = e[t]);
 	return r;
 }
-function bb(e, t) {
+function Sb(e, t) {
 	if (typeof e != "object" || !e) return e;
 	if (t <= 0) return Array.isArray(e) ? `[...${e.length}]` : "{...}";
-	if (Array.isArray(e)) return e.map((e) => bb(e, t - 1));
+	if (Array.isArray(e)) return e.map((e) => Sb(e, t - 1));
 	let n = {};
-	for (let r of Object.keys(e)) n[r] = bb(e[r], t - 1);
+	for (let r of Object.keys(e)) n[r] = Sb(e[r], t - 1);
 	return n;
 }
-function xb(e, t = Infinity) {
+function Cb(e, t = Infinity) {
 	let n = /* @__PURE__ */ new WeakSet(), r;
 	try {
 		r = JSON.stringify(e, (e, t) => {
@@ -17089,7 +17178,7 @@ function xb(e, t = Infinity) {
 	}
 	return r.length > t && (r = r.slice(0, t) + `\n…[已截断,原长度 ${r.length}]`), r;
 }
-function Sb(e, t = 0) {
+function wb(e, t = 0) {
 	let n = 3735928559 ^ t, r = 1103547991 ^ t;
 	for (let t = 0; t < e.length; t++) {
 		let i = e.charCodeAt(t);
@@ -17097,32 +17186,32 @@ function Sb(e, t = 0) {
 	}
 	return n = Math.imul(n ^ n >>> 16, 2246822507) ^ Math.imul(r ^ r >>> 13, 3266489909), r = Math.imul(r ^ r >>> 16, 2246822507) ^ Math.imul(n ^ n >>> 13, 3266489909), 4294967296 * (2097151 & r) + (n >>> 0);
 }
-function Cb(e) {
-	return Sb(xb(e)).toString(36);
+function Tb(e) {
+	return wb(Cb(e)).toString(36);
 }
-function wb(e, t, n, r) {
-	if (t === "set") return n ? (hb(e, n, r), null) : "set 操作需要 jsonPath(整体替换请用 set_data)";
-	if (t === "remove") return n ? (gb(e, n), null) : "remove 操作需要 jsonPath";
+function Eb(e, t, n, r) {
+	if (t === "set") return n ? (_b(e, n, r), null) : "set 操作需要 jsonPath(整体替换请用 set_data)";
+	if (t === "remove") return n ? (vb(e, n), null) : "remove 操作需要 jsonPath";
 	if (t === "merge") {
-		let t = n ? mb(e, n) : e;
-		return typeof t != "object" || !t || Array.isArray(t) ? `merge 目标${n ? `(${n})` : "(根)"}不是对象` : (pb(t, r), null);
+		let t = n ? gb(e, n) : e;
+		return typeof t != "object" || !t || Array.isArray(t) ? `merge 目标${n ? `(${n})` : "(根)"}不是对象` : (hb(t, r), null);
 	}
-	let i = n ? mb(e, n) : e;
+	let i = n ? gb(e, n) : e;
 	return Array.isArray(i) ? (Array.isArray(r) ? i.push(...r) : i.push(r), null) : `append 目标${n ? `(${n})` : "(根)"}不是数组`;
 }
-function Tb(e, t, n, r) {
-	if (t === "set") hb(e, n, r);
-	else if (t === "remove") gb(e, n);
-	else if (t === "merge") pb(n ? mb(e, n) : e, r);
+function Db(e, t, n, r) {
+	if (t === "set") _b(e, n, r);
+	else if (t === "remove") vb(e, n);
+	else if (t === "merge") hb(n ? gb(e, n) : e, r);
 	else {
-		let t = n ? mb(e, n) : e;
+		let t = n ? gb(e, n) : e;
 		Array.isArray(r) ? t.push(...r) : t.push(r);
 	}
 }
-function Eb(e, t) {
-	typeof e == "object" && e && Db(e, t);
+function Ob(e, t) {
+	typeof e == "object" && e && kb(e, t);
 }
-function Db(e, t) {
+function kb(e, t) {
 	if (Array.isArray(e)) {
 		e.length = 0, Array.isArray(t) && e.push(...t);
 		return;
@@ -17131,7 +17220,7 @@ function Db(e, t) {
 	for (let t of Object.keys(e)) t in n || delete e[t];
 	for (let t of Object.keys(n)) e[t] = n[t];
 }
-function Ob(e, t, n = "") {
+function Ab(e, t, n = "") {
 	let r = [];
 	if (!(typeof e == "object" && e) || !(typeof t == "object" && t) || Array.isArray(e) !== Array.isArray(t)) return e !== t && r.push({
 		path: n || "(root)",
@@ -17150,14 +17239,14 @@ function Ob(e, t, n = "") {
 				path: i,
 				from: e[a],
 				to: void 0
-			}) : r.push(...Ob(e[a], t[a], i));
+			}) : r.push(...Ab(e[a], t[a], i));
 		}
 		return r;
 	}
 	let i = e, a = t, o = /* @__PURE__ */ new Set([...Object.keys(i), ...Object.keys(a)]);
 	for (let e of o) {
 		let t = n ? `${n}.${e}` : e;
-		e in i ? e in a ? r.push(...Ob(i[e], a[e], t)) : r.push({
+		e in i ? e in a ? r.push(...Ab(i[e], a[e], t)) : r.push({
 			path: t,
 			from: i[e],
 			to: void 0
@@ -17169,44 +17258,44 @@ function Ob(e, t, n = "") {
 	}
 	return r;
 }
-var kb = {
+var jb = {
 	largeResults: 4194304,
 	drafts: 2097152,
 	userFiles: 2097152
-}, Ab = [
+}, Mb = [
 	"largeResults",
 	"drafts",
 	"userFiles"
-], jb = .9;
-function Mb(e, t = {}) {
+], Nb = .9;
+function Pb(e, t = {}) {
 	let n = Object.create(null);
-	if (e) for (let [t, r] of Object.entries(e)) n[Ib(t)] = {
+	if (e) for (let [t, r] of Object.entries(e)) n[Rb(t)] = {
 		content: r,
-		updatedAt: Rb()
+		updatedAt: Bb()
 	};
 	let { persist: r } = t, i = t.maxBytes ?? 8388608, a = {
-		...kb,
+		...jb,
 		...t.poolBytes ?? {}
 	};
 	function o(e) {
-		let t = Ib(e);
+		let t = Rb(e);
 		return t.startsWith("large_results/") ? "largeResults" : t.startsWith("drafts/") ? "drafts" : "userFiles";
 	}
 	function s(e) {
 		let t = 0;
-		for (let [r, i] of Object.entries(n)) o(r) === e && (t += Pb(i.content));
+		for (let [r, i] of Object.entries(n)) o(r) === e && (t += Ib(i.content));
 		return t;
 	}
 	function c() {
-		for (let e of Ab) {
+		for (let e of Mb) {
 			let t = a[e];
 			if (s(e) <= t) continue;
-			let r = t * jb, i = Object.entries(n).filter(([t]) => o(t) === e).sort((e, t) => e[1].updatedAt - t[1].updatedAt);
+			let r = t * Nb, i = Object.entries(n).filter(([t]) => o(t) === e).sort((e, t) => e[1].updatedAt - t[1].updatedAt);
 			for (let [t] of i) if (delete n[t], s(e) <= r) break;
 		}
-		if (Fb(n) > i) {
-			let e = i * jb, t = Object.entries(n).sort((e, t) => e[1].updatedAt - t[1].updatedAt);
-			for (let [r] of t) if (delete n[r], Fb(n) <= e) break;
+		if (Lb(n) > i) {
+			let e = i * Nb, t = Object.entries(n).sort((e, t) => e[1].updatedAt - t[1].updatedAt);
+			for (let [r] of t) if (delete n[r], Lb(n) <= e) break;
 		}
 	}
 	let l = !0, u = null;
@@ -17239,7 +17328,7 @@ function Mb(e, t = {}) {
 		}
 	};
 	return r && (p.hydrate = (e) => {
-		for (let [t, r] of Object.entries(e)) n[Ib(t)] = r;
+		for (let [t, r] of Object.entries(e)) n[Rb(t)] = r;
 		c(), l = !0;
 	}, p.flush = () => {
 		u &&= (clearTimeout(u), null), d();
@@ -17248,19 +17337,19 @@ function Mb(e, t = {}) {
 		f(), l = !0;
 	}), p;
 }
-var Nb = null;
-function Pb(e) {
-	return Nb ||= new TextEncoder(), Nb.encode(e).length;
+var Fb = null;
+function Ib(e) {
+	return Fb ||= new TextEncoder(), Fb.encode(e).length;
 }
-function Fb(e) {
+function Lb(e) {
 	let t = 0;
-	for (let n of Object.values(e)) t += Pb(n.content);
+	for (let n of Object.values(e)) t += Ib(n.content);
 	return t;
 }
-function Ib(e) {
+function Rb(e) {
 	return e.replace(/^\/+/, "").replace(/\/+/g, "/");
 }
-function Lb(e) {
+function zb(e) {
 	let t = "";
 	for (let n = 0; n < e.length; n++) {
 		let r = e[n];
@@ -17268,10 +17357,10 @@ function Lb(e) {
 	}
 	return RegExp("^" + t + "$");
 }
-function Rb() {
+function Bb() {
 	return Date.now();
 }
-var zb = [
+var Vb = [
 	"vfs_read",
 	"vfs_write",
 	"vfs_edit",
@@ -17281,10 +17370,10 @@ var zb = [
 	"vfs_json_read",
 	"vfs_json_patch"
 ];
-function Bb(e) {
+function Hb(e) {
 	return [
 		r(async ({ path: t, offset: n, limit: r }) => {
-			let i = e.files[Ib(t)];
+			let i = e.files[Rb(t)];
 			if (!i) return $({
 				code: "NOT_FOUND",
 				path: t,
@@ -17313,9 +17402,9 @@ function Bb(e) {
 					hint: "jsonString=true 要求 content 是合法 JSON;检查引号/逗号/括号配对;或省略 jsonString 写纯文本"
 				});
 			}
-			return e.files[Ib(t)] = {
+			return e.files[Rb(t)] = {
 				content: n,
-				updatedAt: Rb()
+				updatedAt: Bb()
 			}, `已写入 ${t}(${n.length} 字符)${r ? "(JSON 校验通过)" : ""}`;
 		}, {
 			name: "vfs_write",
@@ -17327,7 +17416,7 @@ function Bb(e) {
 			})
 		}),
 		r(async ({ path: t, oldString: n, newString: r }) => {
-			let i = Ib(t), a = e.files[i];
+			let i = Rb(t), a = e.files[i];
 			if (!a) return $({
 				code: "NOT_FOUND",
 				path: t,
@@ -17357,7 +17446,7 @@ function Bb(e) {
 			}
 			return e.files[i] = {
 				content: a.content.replace(n, r),
-				updatedAt: Rb()
+				updatedAt: Bb()
 			}, `已替换 ${t} 中 1 处。`;
 		}, {
 			name: "vfs_edit",
@@ -17379,7 +17468,7 @@ function Bb(e) {
 		r(async ({ pattern: t }) => {
 			let n;
 			try {
-				n = Lb(t);
+				n = zb(t);
 			} catch (e) {
 				return $({
 					code: "GLOB_INVALID",
@@ -17408,7 +17497,7 @@ function Bb(e) {
 					details: { pattern: t }
 				});
 			}
-			let i = n ? [Ib(n)] : Object.keys(e.files), a = [];
+			let i = n ? [Rb(n)] : Object.keys(e.files), a = [];
 			for (let t of i) {
 				let n = e.files[t];
 				n && n.content.split("\n").forEach((e, n) => {
@@ -17425,7 +17514,7 @@ function Bb(e) {
 			})
 		}),
 		r(async ({ path: t, jsonPath: n }) => {
-			let r = Ib(t), i = e.files[r];
+			let r = Rb(t), i = e.files[r];
 			if (!i) return $({
 				code: "NOT_FOUND",
 				path: t,
@@ -17444,7 +17533,7 @@ function Bb(e) {
 				});
 			}
 			if (n) {
-				let e = mb(a, n);
+				let e = gb(a, n);
 				return e === void 0 ? $({
 					code: "VFS_PATH_NOT_FOUND",
 					path: t,
@@ -17462,7 +17551,7 @@ function Bb(e) {
 			})
 		}),
 		r(async ({ path: t, patches: n }) => {
-			let r = Ib(t), i = e.files[r];
+			let r = Rb(t), i = e.files[r];
 			if (!i) return $({
 				code: "NOT_FOUND",
 				path: t,
@@ -17480,9 +17569,9 @@ function Bb(e) {
 					hint: "vfs_json_patch 要求文件内容是合法 JSON"
 				});
 			}
-			let o = _b(a), s = [];
+			let o = yb(a), s = [];
 			for (let e of n) {
-				let n = wb(o, e.op, e.jsonPath, e.value);
+				let n = Eb(o, e.op, e.jsonPath, e.value);
 				if (n) return $({
 					code: "PATCH_FAILED",
 					path: t,
@@ -17495,7 +17584,7 @@ function Bb(e) {
 			let c = JSON.stringify(o);
 			return e.files[r] = {
 				content: c,
-				updatedAt: Rb()
+				updatedAt: Bb()
 			}, `已对 ${t} 应用 ${n.length} 个 patch(影响 ${s.length} 处:${s.join(", ")}),文件现 ${c.length} 字符`;
 		}, {
 			name: "vfs_json_patch",
@@ -17516,17 +17605,17 @@ function Bb(e) {
 		})
 	];
 }
-function Vb(e) {
+function Ub(e) {
 	return {
 		name: "vfs",
-		tools: Bb(e),
+		tools: Hb(e),
 		beforeAgent: () => ({ files: e.files })
 	};
 }
 //#endregion
 //#region src/core/tools/dataSlotQuery.ts
-var Hb = /[\w$-]/;
-function Ub(e) {
+var Wb = /[\w$-]/;
+function Gb(e) {
 	let t = [], n = e.trim(), r = +(n[0] === "$");
 	for (; r < n.length;) {
 		let e = n[r];
@@ -17537,7 +17626,7 @@ function Ub(e) {
 					continue;
 				}
 				let e = "";
-				for (; r < n.length && Hb.test(n[r]);) e += n[r++];
+				for (; r < n.length && Wb.test(n[r]);) e += n[r++];
 				if (!e) throw Error("JSONPath: .. 后缺属性名");
 				t.push({
 					type: "descendKey",
@@ -17550,7 +17639,7 @@ function Ub(e) {
 				continue;
 			}
 			let e = "";
-			for (; r < n.length && Hb.test(n[r]);) e += n[r++];
+			for (; r < n.length && Wb.test(n[r]);) e += n[r++];
 			if (!e) throw Error("JSONPath: . 后缺属性名");
 			t.push({
 				type: "key",
@@ -17606,7 +17695,7 @@ function Ub(e) {
 	}
 	return t;
 }
-function Wb(e) {
+function Kb(e) {
 	let t = [], n = 0, r = e.trim();
 	for (; n < r.length;) {
 		let e = r[n];
@@ -17651,7 +17740,7 @@ function Wb(e) {
 	}
 	return t;
 }
-var Gb = class {
+var qb = class {
 	toks;
 	item;
 	pos = 0;
@@ -17687,12 +17776,12 @@ var Gb = class {
 			return this.next(), e;
 		}
 		let e = this.operand(), t = this.peek();
-		return t === "==" || t === "!=" || t === "<" || t === "<=" || t === ">" || t === ">=" ? (this.next(), Jb(t, e, this.operand())) : Kb(e);
+		return t === "==" || t === "!=" || t === "<" || t === "<=" || t === ">" || t === ">=" ? (this.next(), Xb(t, e, this.operand())) : Jb(e);
 	}
 	operand() {
 		let e = this.next();
 		if (e === void 0) throw Error("过滤表达式:缺操作数");
-		if (e.startsWith("@")) return qb(e, this.item);
+		if (e.startsWith("@")) return Yb(e, this.item);
 		if (e[0] === "'" || e[0] === "\"") return e.slice(1, -1);
 		if (e === "true") return !0;
 		if (e === "false") return !1;
@@ -17702,10 +17791,10 @@ var Gb = class {
 		throw Error(`过滤表达式:未知操作数 '${e}'`);
 	}
 };
-function Kb(e) {
+function Jb(e) {
 	return !!e && e !== 0 && e !== "" && e !== null;
 }
-function qb(e, t) {
+function Yb(e, t) {
 	let n = e.split(".").filter((e) => e && e !== "@"), r = t;
 	for (let e of n) {
 		if (typeof r != "object" || !r) return;
@@ -17713,7 +17802,7 @@ function qb(e, t) {
 	}
 	return r;
 }
-function Jb(e, t, n) {
+function Xb(e, t, n) {
 	switch (e) {
 		case "==": return t === n;
 		case "!=": return t !== n;
@@ -17724,47 +17813,47 @@ function Jb(e, t, n) {
 		default: return !1;
 	}
 }
-function Yb(e, t) {
-	return new Gb(Wb(e), t).parse();
+function Zb(e, t) {
+	return new qb(Kb(e), t).parse();
 }
-function Xb(e, t) {
+function Qb(e, t) {
 	return e ? `${e}.${t}` : String(t);
 }
-function Zb(e, t) {
+function $b(e, t) {
 	let n = [{
 		path: "",
 		value: e
 	}];
-	for (let e of Ub(t)) {
+	for (let e of Gb(t)) {
 		let t = [];
 		if (e.type === "key") for (let r of n) r.value != null && typeof r.value == "object" && e.key in r.value && t.push({
-			path: Xb(r.path, e.key),
+			path: Qb(r.path, e.key),
 			value: r.value[e.key]
 		});
 		else if (e.type === "index") {
 			for (let r of n) if (Array.isArray(r.value)) {
 				let n = r.value[e.index];
 				e.index >= 0 && e.index < r.value.length && t.push({
-					path: Xb(r.path, e.index),
+					path: Qb(r.path, e.index),
 					value: n,
 					index: e.index
 				});
 			}
 		} else if (e.type === "wildcard") {
 			for (let e of n) if (Array.isArray(e.value)) e.value.forEach((n, r) => t.push({
-				path: Xb(e.path, r),
+				path: Qb(e.path, r),
 				value: n,
 				index: r
 			}));
 			else if (e.value != null && typeof e.value == "object") for (let n of Object.keys(e.value)) t.push({
-				path: Xb(e.path, n),
+				path: Qb(e.path, n),
 				value: e.value[n]
 			});
 		} else if (e.type === "descendKey") {
 			let r = e.key, i = (e) => {
 				if (e.value != null && typeof e.value == "object") for (let n of Object.keys(e.value)) {
 					let a = {
-						path: Xb(e.path, n),
+						path: Qb(e.path, n),
 						value: e.value[n]
 					};
 					n === r && t.push(a), i(a);
@@ -17775,7 +17864,7 @@ function Zb(e, t) {
 			let e = (n) => {
 				if (n.value != null && typeof n.value == "object") for (let r of Object.keys(n.value)) {
 					let i = {
-						path: Xb(n.path, r),
+						path: Qb(n.path, r),
 						value: n.value[r]
 					};
 					t.push(i), e(i);
@@ -17784,16 +17873,16 @@ function Zb(e, t) {
 			for (let t of n) e(t);
 		} else if (e.type === "filter") {
 			for (let r of n) if (Array.isArray(r.value)) r.value.forEach((n, i) => {
-				Yb(e.filter, n) && t.push({
-					path: Xb(r.path, i),
+				Zb(e.filter, n) && t.push({
+					path: Qb(r.path, i),
 					value: n,
 					index: i
 				});
 			});
 			else if (r.value != null && typeof r.value == "object") for (let n of Object.keys(r.value)) {
 				let i = r.value[n];
-				Yb(e.filter, i) && t.push({
-					path: Xb(r.path, n),
+				Zb(e.filter, i) && t.push({
+					path: Qb(r.path, n),
 					value: i
 				});
 			}
@@ -17802,7 +17891,7 @@ function Zb(e, t) {
 	}
 	return n;
 }
-function Qb(e, t) {
+function ex(e, t) {
 	let n = e.length, r = t.length;
 	if (!n) return r;
 	if (!r) return n;
@@ -17818,7 +17907,7 @@ function Qb(e, t) {
 	}
 	return i[r];
 }
-function $b(e, t, n = {}) {
+function tx(e, t, n = {}) {
 	let r = n.mode || "substring", i = n.limit ?? 50, a = n.matchKey !== !1, o = [], s = null;
 	if (r === "regex") try {
 		s = new RegExp(t, "i");
@@ -17828,11 +17917,11 @@ function $b(e, t, n = {}) {
 	let c = (e, l, u) => {
 		if (o.length >= i || e == null) return;
 		if (typeof e == "object") {
-			if (Array.isArray(e)) e.forEach((e, t) => c(e, Xb(l, t), String(t)));
-			else for (let t of Object.keys(e)) c(e[t], Xb(l, t), t);
+			if (Array.isArray(e)) e.forEach((e, t) => c(e, Qb(l, t), String(t)));
+			else for (let t of Object.keys(e)) c(e[t], Qb(l, t), t);
 			return;
 		}
-		let d = String(e), f = ex(d, t, r, n.fuzzyThreshold ?? 2, s);
+		let d = String(e), f = nx(d, t, r, n.fuzzyThreshold ?? 2, s);
 		if (f) {
 			o.push({
 				path: l,
@@ -17843,7 +17932,7 @@ function $b(e, t, n = {}) {
 			return;
 		}
 		if (a && u) {
-			let e = ex(u, t, r, n.fuzzyThreshold ?? 2, s);
+			let e = nx(u, t, r, n.fuzzyThreshold ?? 2, s);
 			e && o.push({
 				path: l,
 				key: u,
@@ -17854,18 +17943,18 @@ function $b(e, t, n = {}) {
 	};
 	return c(e, ""), o;
 }
-function ex(e, t, n, r, i) {
+function nx(e, t, n, r, i) {
 	let a = e.toLowerCase(), o = t.toLowerCase();
 	if (n === "substring") return a.includes(o) ? 1 : null;
 	if (n === "regex") return i && i.test(e) ? 1 : null;
 	if (n === "fuzzy") {
 		if (a.includes(o)) return 2;
-		let e = Qb(a, o);
+		let e = ex(a, o);
 		return e <= r ? r - e + 1 : null;
 	}
 	return null;
 }
-var tx = [
+var rx = [
 	"self.fetch = () => { throw new Error('fetch 已被沙箱禁用') }",
 	"self.XMLHttpRequest = function(){ throw new Error('XMLHttpRequest 已被沙箱禁用') }",
 	"self.importScripts = () => { throw new Error('importScripts 已被沙箱禁用') }",
@@ -17877,7 +17966,7 @@ var tx = [
 	"try { self.EventSource = undefined } catch {}",
 	"try { self.BroadcastChannel = undefined } catch {}",
 	"if (self.navigator && self.navigator.sendBeacon) self.navigator.sendBeacon = () => { throw new Error('sendBeacon 已被沙箱禁用') }"
-].join("\n"), nx = [
+].join("\n"), ix = [
 	{
 		re: /\bimport\s*\(/,
 		msg: "动态 import() 拉外网模块"
@@ -17903,8 +17992,8 @@ var tx = [
 		msg: "require() 拉模块"
 	}
 ];
-function rx(e, t, n = 3e3) {
-	for (let { re: e, msg: n } of nx) if (e.test(t)) return Promise.resolve({
+function ax(e, t, n = 3e3) {
+	for (let { re: e, msg: n } of ix) if (e.test(t)) return Promise.resolve({
 		ok: !1,
 		error: `沙箱拒绝执行:脚本含禁用模式(${n})`,
 		elapsedMs: 0
@@ -17921,7 +18010,7 @@ function rx(e, t, n = 3e3) {
 					elapsedMs: Date.now() - i
 				});
 			}
-		}, s = tx + "\nself.onmessage = async (e) => {\n  try {\n    const fn = new Function(\"data\", e.data.script);\n    try { self.eval = undefined; self.Function = undefined; } catch {}\n    let result = fn(e.data.data);\n    if (result && typeof result.then === \"function\") result = await result;\n    self.postMessage({ ok: true, result });\n  } catch (err) {\n    self.postMessage({ ok: false, error: String((err && err.message) || err) });\n  }\n};", c = "", l;
+		}, s = rx + "\nself.onmessage = async (e) => {\n  try {\n    const fn = new Function(\"data\", e.data.script);\n    try { self.eval = undefined; self.Function = undefined; } catch {}\n    let result = fn(e.data.data);\n    if (result && typeof result.then === \"function\") result = await result;\n    self.postMessage({ ok: true, result });\n  } catch (err) {\n    self.postMessage({ ok: false, error: String((err && err.message) || err) });\n  }\n};", c = "", l;
 		try {
 			let e = new Blob([s], { type: "application/javascript" });
 			c = URL.createObjectURL(e), l = new Worker(c);
@@ -17956,7 +18045,7 @@ function rx(e, t, n = 3e3) {
 }
 //#endregion
 //#region src/core/tools/dataOps.ts
-var ix = /* @__PURE__ */ new Set([
+var ox = /* @__PURE__ */ new Set([
 	"describe_data",
 	"get_data",
 	"set_data",
@@ -17968,11 +18057,11 @@ var ix = /* @__PURE__ */ new Set([
 	"diff_data",
 	"draft_write",
 	"draft_commit"
-]), ax = /* @__PURE__ */ new Set(["read", "write"]);
-function ox(e, t = "simple") {
-	return t === "advanced" ? e : t === "minimal" ? e.filter((e) => ax.has(e.name)) : e.filter((e) => !ix.has(e.name));
+]), sx = /* @__PURE__ */ new Set(["read", "write"]);
+function cx(e, t = "simple") {
+	return t === "advanced" ? e : t === "minimal" ? e.filter((e) => sx.has(e.name)) : e.filter((e) => !ox.has(e.name));
 }
-function sx(e) {
+function lx(e) {
 	let { bindRef: t, value: n, schema: r, allowKeys: i, snapshots: a, maxSnapshots: o, audit: s, dryRun: c, op: l = "set" } = e, u = r.safeParse(n);
 	if (!u.success) return {
 		ok: !1,
@@ -17991,24 +18080,106 @@ function sx(e) {
 			hint: "主数据 bind 必须为对象/数组;叶子值请用对象包裹(如 {value:\"x\"})或集成方通过 sdk.setData 替换 bind"
 		})
 	};
-	let d = _b(t), f = a.length ? a[a.length - 1].id + 1 : 1;
+	let d = yb(t), f = a.length ? a[a.length - 1].id + 1 : 1;
 	for (a.push({
 		id: f,
 		ts: Date.now(),
 		op: l,
 		value: d
 	}); a.length > o;) a.shift();
-	return u.data !== null && typeof u.data == "object" && (i ? pb(t, u.data) : Db(t, u.data)), s({
+	return u.data !== null && typeof u.data == "object" && (i ? hb(t, u.data) : kb(t, u.data)), s({
 		op: l,
 		value: u.data,
 		timestamp: Date.now()
 	}), e.onWrite?.(), {
 		ok: !0,
-		hash: Cb(t),
+		hash: Tb(t),
 		data: u.data
 	};
 }
-function cx(e, n = {}) {
+function ux(e) {
+	let { bindRef: t, patches: n, schema: r, allowKeys: i, snapshots: a, maxSnapshots: o, markDataDirty: s, schemaErrorMode: c = "zod", snapshotLabel: l, dryRun: u } = e, d = yb(t), f = [];
+	for (let e = 0; e < n.length; e++) {
+		let t = n[e], a = t.jsonPath || "";
+		if (mb(a)) return {
+			ok: !1,
+			error: $({
+				code: "PATH_UNSAFE",
+				message: `patches[${e}] jsonPath "${a}" 含非法段`,
+				hint: "使用正常属性路径,如 components.0.text"
+			})
+		};
+		if (!ty(a, r, i)) return {
+			ok: !1,
+			error: $({
+				code: "PATH_DENIED",
+				message: `patches[${e}] @ "${a}" 不在 schema 声明字段内`,
+				hint: "仅 schema 声明的 key 可写"
+			})
+		};
+		let o = t.op ?? "set", s;
+		if (o !== "remove") {
+			if (t.value === void 0 || t.value === "") return {
+				ok: !1,
+				error: $({
+					code: "MISSING_VALUE",
+					message: `patches[${e}] ${o} 操作需要 value`,
+					hint: `op 为 ${o} 时 value 必填;删除请用 op:'remove'`
+				})
+			};
+			let n = bb(t.value);
+			if (n.parseError) return {
+				ok: !1,
+				error: Ug(`patches[${e}]`, t.value, n.parseError)
+			};
+			s = n.parsed;
+		}
+		let c = Eb(d, o, a, s);
+		if (c) return {
+			ok: !1,
+			error: $({
+				code: "PATCH_FAILED",
+				message: `patches[${e}]: ${c}`,
+				hint: "检查 op 与目标类型:merge 需对象,append 需数组"
+			})
+		};
+		f.push({
+			op: o,
+			jp: a,
+			value: s
+		});
+	}
+	let p = r.safeParse(d);
+	if (!p.success) return {
+		ok: !1,
+		error: c === "schema_invalid" ? $({
+			code: "SCHEMA_INVALID",
+			message: "patches 应用后整体校验失败,未写入",
+			hint: "确认 patches 合并后整体仍符合 schema",
+			details: Vg(p.error.issues)
+		}) : Hg("", p.error.issues)
+	};
+	if (u) return {
+		ok: !0,
+		applied: f,
+		clone: d
+	};
+	let m = a.length ? a[a.length - 1].id + 1 : 1;
+	for (a.push({
+		id: m,
+		ts: Date.now(),
+		op: "edit",
+		value: yb(t),
+		...l ? { label: l } : {}
+	}); a.length > o;) a.shift();
+	for (let e of f) Db(t, e.op, e.jp, e.value);
+	return s?.(), {
+		ok: !0,
+		applied: f,
+		clone: d
+	};
+}
+function dx(e, n = {}) {
 	let i = e.schema, a = e.bind, o = e.description ?? "主数据对象", s = ey(i), c = [], l = n.maxSnapshots ?? 20, u, d = n.autoLock !== !1, f = !0;
 	function p() {
 		f = !0;
@@ -18034,7 +18205,7 @@ function cx(e, n = {}) {
 		n.onAudit?.(e);
 	};
 	function g(e, t) {
-		let n = _b(a), r = c.length ? c[c.length - 1].id + 1 : 1;
+		let n = yb(a), r = c.length ? c[c.length - 1].id + 1 : 1;
 		for (c.push({
 			id: r,
 			ts: Date.now(),
@@ -18046,12 +18217,12 @@ function cx(e, n = {}) {
 	}
 	async function _(e, t, r) {
 		if (!t || t === "") return null;
-		let i = Cb(a);
+		let i = Tb(a);
 		if (i === t) return null;
 		if (!n.onConflict) return $({
 			code: "VERSION_CONFLICT",
 			message: `乐观锁冲突:expectedHash=${t} 但当前 hash=${i}。主数据在你 read 之后已被修改(外部代码/其他 agent/用户手动改)。`,
-			hint: `重新 read 拿最新值与 hash,基于最新值修改后再写入(传新的 expectedHash)。当前值:${xb(a, 400)}`
+			hint: `重新 read 拿最新值与 hash,基于最新值修改后再写入(传新的 expectedHash)。当前值:${Cb(a, 400)}`
 		});
 		let o = await n.onConflict({
 			op: e,
@@ -18061,11 +18232,11 @@ function cx(e, n = {}) {
 			expectedHash: t,
 			snapshotId: 0
 		});
-		if (o.action === "keep_external") return `已保留外部修改(未写入)。当前值:${xb(a, 400)} (hash=${i})。请重新 read 拿最新值与 hash 再改。`;
+		if (o.action === "keep_external") return `已保留外部修改(未写入)。当前值:${Cb(a, 400)} (hash=${i})。请重新 read 拿最新值与 hash 再改。`;
 		if (o.action === "restore") {
-			if (!c.length) return `无历史快照可回退(本次为首次操作)。当前值:${xb(a, 400)} (hash=${i})。请重新 read 再改或选「强制覆盖」。`;
+			if (!c.length) return `无历史快照可回退(本次为首次操作)。当前值:${Cb(a, 400)} (hash=${i})。请重新 read 再改或选「强制覆盖」。`;
 			let e = c[c.length - 1];
-			return Eb(a, _b(e.value)), p(), `已回退主数据到历史快照 #${e.id}[${e.op}]。当前值:${xb(a, 400)} (hash=${Cb(a)})。请基于回退后的值重写或停止。`;
+			return Ob(a, yb(e.value)), p(), `已回退主数据到历史快照 #${e.id}[${e.op}]。当前值:${Cb(a, 400)} (hash=${Tb(a)})。请基于回退后的值重写或停止。`;
 		}
 		return null;
 	}
@@ -18075,7 +18246,7 @@ function cx(e, n = {}) {
 		schema: t.object({})
 	}), y = r(async ({ jsonPath: e }) => {
 		let t = e || "";
-		if (fb(t)) return $({
+		if (mb(t)) return $({
 			code: "PATH_UNSAFE",
 			message: `jsonPath "${t}" 含非法段(__proto__/constructor/prototype)`,
 			hint: "使用正常属性路径,如 components.0.text(数组索引用数字)"
@@ -18085,10 +18256,10 @@ function cx(e, n = {}) {
 			message: `get_data @ "${t}" 不在 schema 声明字段内(仅 schema 声明的 key 可读)`,
 			hint: "主数据仅暴露 schema 声明的字段;若需操作该字段,集成方需在 schema 中声明它"
 		});
-		let n = t ? mb(a, t) : a;
+		let n = t ? gb(a, t) : a;
 		t || (n = ay(n, s));
-		let r = Cb(a);
-		return u = r, n === void 0 ? `主数据${t ? ` @ ${t}` : ""} = (undefined) (hash=${r})` : `主数据${t ? ` @ ${t}` : ""} = ${xb(n)} (hash=${r})`;
+		let r = Tb(a);
+		return u = r, n === void 0 ? `主数据${t ? ` @ ${t}` : ""} = (undefined) (hash=${r})` : `主数据${t ? ` @ ${t}` : ""} = ${Cb(n)} (hash=${r})`;
 	}, {
 		name: "get_data",
 		description: "读取主数据的当前值(安全序列化:函数/DOM/循环引用做摘要;大结果由系统自动外存,提示用 vfs_read 回读)。返回含 hash(乐观锁):改前先 read/get 拿 hash,写入时传 expectedHash 回传,系统对比当前 hash 防\"基于过期值覆盖\"。jsonPath 可选:读整个主数据不传,读子路径传(如 components.0.text)。",
@@ -18096,9 +18267,9 @@ function cx(e, n = {}) {
 	}), b = r(async ({ value: e, expectedHash: t }) => {
 		let n = await _("set", t || (d ? u : void 0));
 		if (n !== null) return n;
-		let r = vb(e);
+		let r = bb(e);
 		if (r.parseError) return Ug("", e, r.parseError);
-		let o = sx({
+		let o = lx({
 			bindRef: a,
 			value: r.parsed,
 			schema: i,
@@ -18108,7 +18279,7 @@ function cx(e, n = {}) {
 			audit: h,
 			onWrite: p
 		});
-		return o.ok ? (u = o.hash, `已设置主数据 = ${xb(o.data, 600)} (新 hash=${o.hash})${s ? "(白名单模式:仅更新 schema 声明字段,未声明字段保留)" : ""}`) : o.error;
+		return o.ok ? (u = o.hash, `已设置主数据 = ${Cb(o.data, 600)} (新 hash=${o.hash})${s ? "(白名单模式:仅更新 schema 声明字段,未声明字段保留)" : ""}`) : o.error;
 	}, {
 		name: "set_data",
 		description: "设置主数据的值(整体替换)。value 为 JSON 对象(或 JSON 字符串),需通过 schema 校验。校验失败会返回错误而非写入。expectedHash(可选):改前 read/get 返回的 hash,传入则启用乐观锁;不传时系统自动用你最后一次读到的 hash 比对(autoLock,默认开)。大对象/数组强烈建议改用 edit_data 增量 patch。白名单模式(schema 为 ZodObject 子集):set 为根级浅合并,深层子对象整体替换(未传字段丢失);保留深层字段请用 edit_data({op:\"merge\", jsonPath:\"子路径\", value:{...}})局部合并。",
@@ -18123,48 +18294,46 @@ function cx(e, n = {}) {
 			message: "edit_data 需要 op(set/remove/merge/append)",
 			hint: "顶层 op 或 patch.op 至少传一个"
 		});
-		let c = n || "";
-		if (fb(c)) return $({
+		let f = n || "";
+		if (mb(f)) return $({
 			code: "PATH_UNSAFE",
-			message: `jsonPath "${c}" 含非法段(__proto__/constructor/prototype)`,
+			message: `jsonPath "${f}" 含非法段(__proto__/constructor/prototype)`,
 			hint: "使用正常的属性路径,如 components.0.text(数组索引用数字)"
 		});
-		if (!ty(c, i, s)) return $({
+		if (!ty(f, i, s)) return $({
 			code: "PATH_DENIED",
-			message: `edit_data @ "${c}" 不在 schema 声明字段内`,
+			message: `edit_data @ "${f}" 不在 schema 声明字段内`,
 			hint: "仅 schema 声明的 key 可写;若需操作该字段,集成方需在 schema 中声明它"
 		});
-		let l = await _("edit", o || (d ? u : void 0));
-		if (l !== null) return l;
+		let m = await _("edit", o || (d ? u : void 0));
+		if (m !== null) return m;
 		if (typeof a != "object" || !a) return $({
 			code: "NOT_OBJECT",
 			message: `edit 仅适用于对象/数组主数据,当前是 ${a === void 0 ? "undefined" : typeof a}`,
 			hint: "叶子(原始类型)请用 set_data 整体设置"
 		});
-		let f;
-		if (t !== "remove") {
-			if (r === void 0 || r === "") return $({
-				code: "MISSING_VALUE",
-				message: `${t} 操作需要 value`,
-				hint: `op 为 ${t} 时 value 必填;删除请用 op:'remove'`
-			});
-			let e = vb(r);
-			if (e.parseError) return Ug("", r, e.parseError);
-			f = e.parsed;
-		}
-		let m = _b(a), v = wb(m, t, c, f);
-		if (v) return $({
-			code: "PATCH_FAILED",
-			message: v,
-			hint: "检查 op 与目标类型:merge 需对象,append 需数组;jsonPath 指向需存在"
+		let g = ux({
+			bindRef: a,
+			patches: [{
+				op: t,
+				jsonPath: f,
+				value: r
+			}],
+			schema: i,
+			allowKeys: s,
+			snapshots: c,
+			maxSnapshots: l,
+			markDataDirty: p,
+			schemaErrorMode: "zod"
 		});
-		let y = i.safeParse(m);
-		return y.success ? (g("edit"), Tb(a, t, c, f), p(), h({
+		if (!g.ok) return g.error;
+		let v = g.applied[0];
+		return h({
 			op: "edit",
-			detail: `${t}${c ? "@" + c : ""}`,
-			value: f,
+			detail: `${v.op}${f ? "@" + f : ""}`,
+			value: v.value,
 			timestamp: Date.now()
-		}), u = Cb(a), `已 edit 主数据(${t}${c ? " @ " + c : ""})。当前值:${xb(a, 600)} (新 hash=${Cb(a)})`) : Hg("", y.error.issues);
+		}), u = Tb(a), `已 edit 主数据(${v.op}${f ? " @ " + f : ""})。当前值:${Cb(a, 600)} (新 hash=${Tb(a)})`;
 	}, {
 		name: "edit_data",
 		description: "增量编辑主数据(对象/数组),只发改动的 patch,无需重传整个大对象。op:set(在 jsonPath 设值)、remove(删 jsonPath)、merge(把 value 合并到 jsonPath 指向的对象,默认根)、append(把 value 追加到 jsonPath 指向的数组,默认根)。jsonPath 为相对主数据根的点号路径(数组索引用数字,如 components.0.text);value 为 JSON 对象(推荐直传)或 JSON 字符串。整体仍经 schema 校验,失败不写入。expectedHash(可选):改前 read/get 返回的 hash;不传时自动用你最后读到的 hash(autoLock,默认开)防\"基于过期值覆盖\"。",
@@ -18195,7 +18364,7 @@ function cx(e, n = {}) {
 			message: "delete_data 需要 jsonPath 指定要删的子路径(主数据整体不可删,用 set_data 整体替换)",
 			hint: "如 jsonPath:\"components.0\" 删数组首项"
 		});
-		if (fb(e)) return $({
+		if (mb(e)) return $({
 			code: "PATH_UNSAFE",
 			message: `jsonPath "${e}" 含非法段`,
 			hint: "使用正常属性路径"
@@ -18208,12 +18377,12 @@ function cx(e, n = {}) {
 		let n = await _("delete", t || (d ? u : void 0));
 		if (n !== null) return n;
 		g("delete");
-		let r = gb(a, e);
+		let r = vb(a, e);
 		return p(), h({
 			op: "delete",
 			detail: e,
 			timestamp: Date.now()
-		}), u = Cb(a), r ? `已删除主数据 @ ${e}` : `主数据 @ ${e} 不存在(无需删除)`;
+		}), u = Tb(a), r ? `已删除主数据 @ ${e}` : `主数据 @ ${e} 不存在(无需删除)`;
 	}, {
 		name: "delete_data",
 		description: "删除主数据的某个子路径(jsonPath)。主数据整体不可删(用 set_data 整体替换)。expectedHash(可选):改前 read/get 返回的 hash;不传时自动用你最后读到的 hash(autoLock,默认开)防\"基于过期值删除\"。",
@@ -18249,11 +18418,11 @@ function cx(e, n = {}) {
 			hint: "用 list_data_snapshots 查看可用快照序号"
 		});
 		let n = i.safeParse(t.value);
-		return n.success ? (Eb(a, _b(t.value)), p(), h({
+		return n.success ? (Ob(a, yb(t.value)), p(), h({
 			op: "restore",
 			detail: `#${t.id}`,
 			timestamp: Date.now()
-		}), u = Cb(a), `已回退主数据到快照 #${t.id}[${t.op}]${t.label ? `(${t.label})` : ""}。`) : $({
+		}), u = Tb(a), `已回退主数据到快照 #${t.id}[${t.op}]${t.label ? `(${t.label})` : ""}。`) : $({
 			code: "SNAPSHOT_SCHEMA_INVALID",
 			message: `快照 #${t.id} 的值不符合当前 schema,无法回退`,
 			hint: "schema 可能已变更;该快照已过期,选其他快照或重新设置",
@@ -18275,9 +18444,9 @@ function cx(e, n = {}) {
 			message: `未找到快照 #${e}`,
 			hint: "不传 id 查看最近一次;或用 list_data_snapshots(advanced) 查看可用序号"
 		});
-		let r = _b(n.value), a = t || "";
+		let r = yb(n.value), a = t || "";
 		if (a) {
-			if (fb(a)) return $({
+			if (mb(a)) return $({
 				code: "PATH_UNSAFE",
 				message: `jsonPath "${a}" 含非法段`,
 				hint: "使用正常属性路径"
@@ -18287,11 +18456,11 @@ function cx(e, n = {}) {
 				message: `history_data @ "${a}" 不在 schema 声明字段内`,
 				hint: "仅 schema 声明的 key 可读"
 			});
-			r = mb(r, a);
+			r = gb(r, a);
 			let e = ry(i, a);
 			e && (r = iy(r, e));
 		} else s && (r = iy(r, i));
-		return `快照 #${n.id}[${n.op}]${n.label ? `(${n.label})` : ""}${a ? ` @ ${a}` : ""} = ${xb(r)}`;
+		return `快照 #${n.id}[${n.op}]${n.label ? `(${n.label})` : ""}${a ? ` @ ${a}` : ""} = ${Cb(r)}`;
 	}, {
 		name: "history_data",
 		description: "只读查看某次快照(默认最近一次)的内容,不回退当前主数据。看上一版长啥样而不影响当前(冲突诊断/verify 自纠/用户问\"刚才改了啥\")。可选 id 指定快照序号、jsonPath 只看子路径(按 schema 投影)。",
@@ -18307,7 +18476,7 @@ function cx(e, n = {}) {
 		});
 		let n = s ? ay(a, s) : a, r;
 		try {
-			r = Zb(n, e);
+			r = $b(n, e);
 		} catch (t) {
 			return $({
 				code: "JSONPATH_SYNTAX",
@@ -18316,7 +18485,7 @@ function cx(e, n = {}) {
 				details: { expr: e }
 			});
 		}
-		let i = t ?? 50, o = r.slice(0, i), c = o.map((e) => `{"path":${JSON.stringify(e.path)},"index":${e.index === void 0 ? "null" : e.index},"value":${xb(e.value)}}`);
+		let i = t ?? 50, o = r.slice(0, i), c = o.map((e) => `{"path":${JSON.stringify(e.path)},"index":${e.index === void 0 ? "null" : e.index},"value":${Cb(e.value)}}`);
 		return `{"matched":${r.length},"returned":${o.length},"truncated":${r.length > i},"results":[${c.join(",")}]}`;
 	}, {
 		name: "query_data",
@@ -18331,13 +18500,13 @@ function cx(e, n = {}) {
 			message: "主数据为空,无可搜索内容"
 		});
 		try {
-			let o = $b(s ? ay(a, s) : a, e, {
+			let o = tx(s ? ay(a, s) : a, e, {
 				mode: t,
 				fuzzyThreshold: n,
 				matchKey: r,
 				limit: i ?? 50
 			});
-			return xb({
+			return Cb({
 				matched: o.length,
 				results: o
 			});
@@ -18376,44 +18545,47 @@ function cx(e, n = {}) {
 				message: `eval_script @ "${r}" 不在 schema 声明字段内`,
 				hint: "仅 schema 声明的 key 可作为子树"
 			});
-			if (o = mb(a, r), s) {
+			if (o = gb(a, r), s) {
 				let e = ry(i, r);
 				e && (o = iy(o, e));
 			}
 		} else o = s ? ay(a, s) : a;
-		let c = _b(o), l = await rx(c, e, r && JSON.stringify(c).length > 1e5 ? 8e3 : 3e3);
-		if (!l.ok) {
-			let t = /超时/.test(l.error || "");
+		let d = yb(o), f = await ax(d, e, r && JSON.stringify(d).length > 1e5 ? 8e3 : 3e3);
+		if (!f.ok) {
+			let t = /超时/.test(f.error || "");
 			return $({
 				code: t ? "SCRIPT_TIMEOUT" : "SCRIPT_ERROR",
-				message: `脚本执行失败: ${l.error}`,
+				message: `脚本执行失败: ${f.error}`,
 				hint: t ? "脚本可能有死循环或过重计算;加边界检查/分批;transform 返回完整新值勿返回巨大中间结果" : "检查脚本语法与运行时错误;入参为 data(主数据深拷贝),沙箱内禁用 fetch/XHR/WebSocket",
 				details: {
-					elapsedMs: l.elapsedMs,
+					elapsedMs: f.elapsedMs,
 					scriptLen: e.length
 				}
 			});
 		}
 		if (t === "transform") {
-			let e = l.result;
+			let e = f.result;
 			if (r) {
-				let t = _b(a), n = wb(t, "set", r, e);
-				if (n) return $({
-					code: "PATCH_FAILED",
-					message: `eval 子树 transform @ "${r}" 失败: ${n}`,
-					hint: "检查子路径:set 需父为对象/数组"
+				let t = ux({
+					bindRef: a,
+					patches: [{
+						op: "set",
+						jsonPath: r,
+						value: e
+					}],
+					schema: i,
+					allowKeys: s,
+					snapshots: c,
+					maxSnapshots: l,
+					markDataDirty: p,
+					schemaErrorMode: "schema_invalid",
+					snapshotLabel: "eval_transform_subtree"
 				});
-				let o = i.safeParse(t);
-				return o.success ? (g("edit", "eval_transform_subtree"), Tb(a, "set", r, e), p(), h({
+				return t.ok ? (h({
 					op: "edit",
 					detail: `eval_transform_subtree @ ${r}`,
 					timestamp: Date.now()
-				}), u = Cb(a), `已通过脚本 transform 子树 @ ${r} 更新(耗时 ${l.elapsedMs}ms)。当前值: ${xb(a, 600)}`) : $({
-					code: "SCHEMA_INVALID",
-					message: `脚本返回值作为子树 @ "${r}" 后整体校验失败,未写入`,
-					hint: `确认返回值符合 ${r} 处的子 schema`,
-					details: Vg(o.error.issues)
-				});
+				}), u = Tb(a), `已通过脚本 transform 子树 @ ${r} 更新(耗时 ${f.elapsedMs}ms)。当前值: ${Cb(a, 600)}`) : t.error;
 			}
 			if (e && typeof e == "object" && !Array.isArray(e) && "patches" in e && Array.isArray(e.patches)) {
 				if (typeof a != "object" || !a) return $({
@@ -18421,77 +18593,43 @@ function cx(e, n = {}) {
 					message: `主数据 bind 为原始类型(${a === null ? "null" : typeof a}),eval transform(patches) 无法就地替换`,
 					hint: "主数据 bind 必须为对象/数组;叶子值请用对象包裹或集成方通过 sdk.setData 替换 bind"
 				});
-				let t = e.patches, n = _b(a), r = [];
-				for (let e = 0; e < t.length; e++) {
-					let a = t[e], o = a.jsonPath || "";
-					if (fb(o)) return $({
-						code: "PATH_UNSAFE",
-						message: `patches[${e}] jsonPath "${o}" 含非法段`,
-						hint: "使用正常属性路径"
-					});
-					if (!ty(o, i, s)) return $({
-						code: "PATH_DENIED",
-						message: `patches[${e}] @ "${o}" 不在 schema 声明字段内`,
-						hint: "仅 schema 声明的 key 可写"
-					});
-					let c = a.op, l;
-					if (c !== "remove") {
-						if (a.value === void 0 || a.value === "") return $({
-							code: "MISSING_VALUE",
-							message: `patches[${e}] ${c} 操作需要 value`,
-							hint: `op 为 ${c} 时 value 必填`
-						});
-						let t = vb(a.value);
-						if (t.parseError) return Ug(`patches[${e}]`, a.value, t.parseError);
-						l = t.parsed;
-					}
-					let u = wb(n, c, o, l);
-					if (u) return $({
-						code: "PATCH_FAILED",
-						message: `patches[${e}]: ${u}`,
-						hint: "检查 op 与目标类型:merge 需对象,append 需数组"
-					});
-					r.push({
-						op: c,
-						jp: o,
-						value: l
-					});
-				}
-				let o = i.safeParse(n);
-				if (!o.success) return $({
-					code: "SCHEMA_INVALID",
-					message: "脚本 patches 应用后整体校验失败,未写入",
-					hint: "确认 patches 合并后整体仍符合 schema",
-					details: Vg(o.error.issues)
+				let t = ux({
+					bindRef: a,
+					patches: e.patches,
+					schema: i,
+					allowKeys: s,
+					snapshots: c,
+					maxSnapshots: l,
+					markDataDirty: p,
+					schemaErrorMode: "schema_invalid",
+					snapshotLabel: "eval_transform"
 				});
-				g("edit", "eval_transform");
-				for (let e of r) Tb(a, e.op, e.jp, e.value);
-				return p(), h({
+				return t.ok ? (h({
 					op: "edit",
-					detail: `eval_transform(${r.length} patches)`,
+					detail: `eval_transform(${t.applied.length} patches)`,
 					timestamp: Date.now()
-				}), u = Cb(a), `已通过脚本 transform(patches) 更新主数据(${r.length} 个 patch,耗时 ${l.elapsedMs}ms)。当前值: ${xb(a, 600)}`;
+				}), u = Tb(a), `已通过脚本 transform(patches) 更新主数据(${t.applied.length} 个 patch,耗时 ${f.elapsedMs}ms)。当前值: ${Cb(a, 600)}`) : t.error;
 			}
 			let t = i.safeParse(e);
 			return t.success ? typeof a != "object" || !a ? $({
 				code: "LEAF_BIND",
 				message: `主数据 bind 为原始类型(${a === null ? "null" : typeof a}),eval transform 无法就地替换外部持有的值引用`,
 				hint: "主数据 bind 必须为对象/数组;叶子值请用对象包裹或集成方通过 sdk.setData 替换 bind"
-			}) : (g("edit", "eval_transform"), t.data !== null && typeof t.data == "object" && (s ? pb(a, t.data) : Db(a, t.data)), p(), h({
+			}) : (g("edit", "eval_transform"), t.data !== null && typeof t.data == "object" && (s ? hb(a, t.data) : kb(a, t.data)), p(), h({
 				op: "edit",
 				detail: "eval_transform",
 				timestamp: Date.now()
-			}), u = Cb(a), `已通过脚本 transform 更新主数据(耗时 ${l.elapsedMs}ms)。当前值: ${xb(a, 600)}`) : $({
+			}), u = Tb(a), `已通过脚本 transform 更新主数据(耗时 ${f.elapsedMs}ms)。当前值: ${Cb(a, 600)}`) : $({
 				code: "SCHEMA_INVALID",
 				message: "脚本返回值校验失败,未写入(transform 模式要求返回主数据的完整新值且符合 schema)",
 				hint: "确认脚本 return 了完整新值(非部分);或返回 {patches:[...]} 走增量模式;按 describe_data() 查看格式",
 				details: Vg(t.error.issues)
 			});
 		}
-		return xb({
+		return Cb({
 			ok: !0,
-			result: l.result,
-			elapsedMs: l.elapsedMs
+			result: f.result,
+			elapsedMs: f.elapsedMs
 		});
 	}, {
 		name: "eval_script",
@@ -18502,12 +18640,12 @@ function cx(e, n = {}) {
 			jsonPath: t.string().optional().describe("子树模式:仅对 jsonPath 指向的子树执行(降低大 JSON 成本);transform 时返回值作为该子树新值")
 		})
 	}), A = r(async ({ jsonPath: e, jsonPaths: t, fields: r, depth: c, offset: l, limit: d }) => {
-		let f = Cb(a);
+		let f = Tb(a);
 		if (u = f, t && t.length) {
 			let e = t.map((e) => {
 				let t = e || "";
 				if (!ty(t, i, s)) return `- ${t || "(根)"}: [PATH_DENIED: 不在 schema 声明字段内]`;
-				let o = t ? mb(a, t) : a;
+				let o = t ? gb(a, t) : a;
 				if (!t) o = ay(o, s);
 				else if (s) {
 					let e = ry(i, t);
@@ -18519,12 +18657,12 @@ function cx(e, n = {}) {
 				} catch (e) {
 					return `- ${t}: [READ_INTERCEPT: ${e.message}]`;
 				}
-				return r && r.length && (l = yb(l, r)), c != null && (l = bb(l, c)), l === void 0 ? `- ${t} = (undefined)` : `- ${t} = ${xb(l)}`;
+				return r && r.length && (l = xb(l, r)), c != null && (l = Sb(l, c)), l === void 0 ? `- ${t} = (undefined)` : `- ${t} = ${Cb(l)}`;
 			});
 			return `多路径读取(共 ${t.length} 项,hash=${f}):\n${e.join("\n")}`;
 		}
 		let p = e || "";
-		if (fb(p)) return $({
+		if (mb(p)) return $({
 			code: "PATH_UNSAFE",
 			message: `jsonPath "${p}" 含非法段(__proto__/constructor/prototype)`,
 			hint: "使用正常属性路径,如 components.0.text(数组索引数字)"
@@ -18534,7 +18672,7 @@ function cx(e, n = {}) {
 			message: `read @ "${p}" 不在 schema 声明字段内`,
 			hint: "主数据仅暴露 schema 声明的字段;若需操作该字段,集成方需在 schema 中声明它"
 		});
-		let m = p ? mb(a, p) : a;
+		let m = p ? gb(a, p) : a;
 		if (!p) m = ay(m, s);
 		else if (s) {
 			let e = ry(i, p);
@@ -18549,13 +18687,13 @@ function cx(e, n = {}) {
 				message: `read 拦截器抛错: ${e.message}`
 			});
 		}
-		r && r.length && (h = yb(h, r)), c != null && (h = bb(h, c));
+		r && r.length && (h = xb(h, r)), c != null && (h = Sb(h, c));
 		let g = e ? "" : `主数据说明: ${o}\n格式: 写入值需为 JSON,且通过声明的 schema 校验(校验失败时 write 会返回结构化错误)。字段约束(类型/min/max/enum/必填/默认)见 systemPrompt「可操作数据」段,或用 schema_data({ jsonPath }) 按需查。\n\n`, _ = r && r.length ? `(字段裁剪:${r.join(",")})` : "", v = c == null ? "" : `(深度≤${c})`, y = _ || v ? ` ${_}${v}` : "";
 		if ((l !== void 0 || d !== void 0) && Array.isArray(h)) {
 			let e = h.length, t = Math.max(0, l ?? 0), n = Math.min(200, Math.max(1, d ?? 50)), r = h.slice(t, t + n), i = t + n < e;
-			return `${g}主数据${p ? ` @ ${p}` : ""} 数组分页[offset=${t},limit=${n}]${y} = ${xb(r)} (total=${e}, hasMore=${i}) (hash=${f})`;
+			return `${g}主数据${p ? ` @ ${p}` : ""} 数组分页[offset=${t},limit=${n}]${y} = ${Cb(r)} (total=${e}, hasMore=${i}) (hash=${f})`;
 		}
-		return h === void 0 ? `${g}主数据${p ? ` @ ${p}` : ""}${y} = (undefined) (hash=${f})` : `${g}主数据${p ? ` @ ${p}` : ""}${y} = ${xb(h)} (hash=${f})`;
+		return h === void 0 ? `${g}主数据${p ? ` @ ${p}` : ""}${y} = (undefined) (hash=${f})` : `${g}主数据${p ? ` @ ${p}` : ""}${y} = ${Cb(h)} (hash=${f})`;
 	}, {
 		name: "read",
 		description: "读取主数据(高层入口,合并 describe/get)。不传 jsonPath → 返回主数据说明 + 格式提示(含字段约束);传 jsonPath → 返回该子路径当前值 + hash;传 jsonPaths → 一次读多个不相关子路径(省多轮往返)。hash 用于乐观锁(默认 autoLock,write 时自动比对,无需手动传)。fields(字段裁剪)/depth(深度截断)减体积;offset+limit 对数组目标分页(返回切片 + total/hasMore)。集成方可能经 read 拦截器对返回值脱敏/派生。",
@@ -18598,7 +18736,7 @@ function cx(e, n = {}) {
 		}
 		let b = d ? u : void 0;
 		if (f && b !== void 0) {
-			let e = Cb(a);
+			let e = Tb(a);
 			if (e !== b) return $({
 				code: "VERSION_CONFLICT",
 				message: `dryRun 预检发现乐观锁冲突: expectedHash=${b} 当前 hash=${e}(主数据在你 read 后被改)`,
@@ -18611,7 +18749,7 @@ function cx(e, n = {}) {
 				message: "delete 需要 patch.jsonPath 指定要删的子路径(主数据整体不可删,用 write(value) 整体替换)",
 				hint: "如 patch:{jsonPath:\"components.0\"}, del:true"
 			});
-			if (fb(t.jsonPath)) return $({
+			if (mb(t.jsonPath)) return $({
 				code: "PATH_UNSAFE",
 				message: `jsonPath "${t.jsonPath}" 含非法段`,
 				hint: "使用正常属性路径"
@@ -18624,16 +18762,16 @@ function cx(e, n = {}) {
 			let e = await _("delete", b);
 			if (e !== null) return e;
 			if (f) {
-				let e = _b(a);
-				return gb(e, t.jsonPath) ? `dryRun(delete): 将删除 @ ${t.jsonPath}。预览剩余:${xb(e, 600)}。未实际写入、未入快照。` : `dryRun(delete): @ ${t.jsonPath} 不存在(无需删除)。未实际写入。`;
+				let e = yb(a);
+				return vb(e, t.jsonPath) ? `dryRun(delete): 将删除 @ ${t.jsonPath}。预览剩余:${Cb(e, 600)}。未实际写入、未入快照。` : `dryRun(delete): @ ${t.jsonPath} 不存在(无需删除)。未实际写入。`;
 			}
 			g("delete");
-			let n = gb(a, t.jsonPath);
+			let n = vb(a, t.jsonPath);
 			return p(), h({
 				op: "delete",
 				detail: t.jsonPath,
 				timestamp: Date.now()
-			}), u = Cb(a), n ? `已删除主数据 @ ${t.jsonPath}` : `主数据 @ ${t.jsonPath} 不存在(无需删除)`;
+			}), u = Tb(a), n ? `已删除主数据 @ ${t.jsonPath}` : `主数据 @ ${t.jsonPath} 不存在(无需删除)`;
 		}
 		if (m === "edit") {
 			if (typeof a != "object" || !a) return $({
@@ -18647,59 +18785,29 @@ function cx(e, n = {}) {
 				op: t.op ?? "set",
 				jsonPath: t.jsonPath || "",
 				value: v
-			}]), o = _b(a), c = [];
-			for (let e = 0; e < n.length; e++) {
-				let t = n[e], r = t.jsonPath || "";
-				if (fb(r)) return $({
-					code: "PATH_UNSAFE",
-					message: `patches[${e}] jsonPath "${r}" 含非法段`,
-					hint: "使用正常属性路径,如 components.0.text"
-				});
-				if (!ty(r, i, s)) return $({
-					code: "PATH_DENIED",
-					message: `patches[${e}] @ "${r}" 不在 schema 声明字段内`,
-					hint: "仅 schema 声明的 key 可写"
-				});
-				let a = t.op ?? "set", l;
-				if (a !== "remove") {
-					if (t.value === void 0 || t.value === "") return $({
-						code: "MISSING_VALUE",
-						message: `patches[${e}] ${a} 操作需要 value`,
-						hint: `op 为 ${a} 时 value 必填;删除请用 op:'remove'`
-					});
-					let n = vb(t.value);
-					if (n.parseError) return Ug(`patches[${e}]`, t.value, n.parseError);
-					l = n.parsed;
-				}
-				let u = wb(o, a, r, l);
-				if (u) return $({
-					code: "PATCH_FAILED",
-					message: `patches[${e}]: ${u}`,
-					hint: "检查 op 与目标类型:merge 需对象,append 需数组"
-				});
-				c.push({
-					op: a,
-					jp: r,
-					value: l
-				});
-			}
-			let l = i.safeParse(o);
-			if (!l.success) return Hg("", l.error.issues);
-			if (f) return `dryRun(edit): ${c.length} 个 patch 预检通过(schema 校验 OK)。预览结果:${xb(o, 600)}。未实际写入、未入快照。`;
-			g("edit");
-			for (let e of c) Tb(a, e.op, e.jp, e.value);
-			return p(), h({
+			}]), o = ux({
+				bindRef: a,
+				patches: n,
+				schema: i,
+				allowKeys: s,
+				snapshots: c,
+				maxSnapshots: l,
+				markDataDirty: p,
+				schemaErrorMode: "zod",
+				dryRun: f
+			});
+			return o.ok ? f ? `dryRun(edit): ${o.applied.length} 个 patch 预检通过(schema 校验 OK)。预览结果:${Cb(o.clone, 600)}。未实际写入、未入快照。` : (h({
 				op: "edit",
-				detail: `${c.length} 个 patch${c.length > 1 ? "(批量)" : ""}`,
-				value: c.map((e) => `${e.op}@${e.jp}`),
+				detail: `${o.applied.length} 个 patch${o.applied.length > 1 ? "(批量)" : ""}`,
+				value: o.applied.map((e) => `${e.op}@${e.jp}`),
 				timestamp: Date.now()
-			}), u = Cb(a), `已 write(edit) 主数据(${c.length} 个 patch)。当前值:${xb(a, 600)} (新 hash=${Cb(a)})`;
+			}), u = Tb(a), `已 write(edit) 主数据(${o.applied.length} 个 patch)。当前值:${Cb(a, 600)} (新 hash=${Tb(a)})`) : o.error;
 		}
-		let x = vb(v);
+		let x = bb(v);
 		if (x.parseError) return Ug("", v, x.parseError);
 		let S = await _("set", b);
 		if (S !== null) return S;
-		let C = sx({
+		let C = lx({
 			bindRef: a,
 			value: x.parsed,
 			schema: i,
@@ -18710,7 +18818,7 @@ function cx(e, n = {}) {
 			dryRun: f,
 			onWrite: p
 		});
-		return C.ok ? f ? `dryRun(set): schema 校验通过。预览新值:${xb(C.data, 600)}。未实际写入、未入快照。` : (u = C.hash, `已 write(set) 主数据 = ${xb(C.data, 600)} (新 hash=${C.hash})${s ? "(白名单模式:仅更新 schema 声明字段,未声明字段保留)" : ""}`) : C.error;
+		return C.ok ? f ? `dryRun(set): schema 校验通过。预览新值:${Cb(C.data, 600)}。未实际写入、未入快照。` : (u = C.hash, `已 write(set) 主数据 = ${Cb(C.data, 600)} (新 hash=${C.hash})${s ? "(白名单模式:仅更新 schema 声明字段,未声明字段保留)" : ""}`) : C.error;
 	}, {
 		name: "write",
 		description: "写入主数据(高层入口,合并 set/edit/delete + 自动乐观锁 + 自动快照)。四种意图:① 整体替换 write({ value }) value 为整个 JSON 对象(推荐)或字符串;② 单个增量 patch write({ patch:{op,jsonPath,value} }) op=set/remove/merge/append,jsonPath 相对主数据根(如 components.0.props.title),patch.value 是该 patch 的值(自带,与 patches 一致——string/number 直传该字段新值,勿包成 {字段:值} 对象);也兼容 write({ value, patch:{op,jsonPath} }) 顶层 value 形式(向后兼容,但优先用 patch.value 避免与①整体 set 的 value 语义混淆);③ 批量增量 write({ patches:[{op,jsonPath,value},...] }) 一次原子应用多个 patch(任一失败整体不写入,适合一次改多处);④ 删除 write({ patch:{jsonPath}, del:true })。写入自动经 schema 校验(失败不写)+ 自动存快照(可 restore_data 回退)+ 自动乐观锁(autoLock,用你最后 read 到的 hash 比对,冲突则 VERSION_CONFLICT)。集成方可能经 write 拦截器校验/转换/拒绝(批量模式拦截器收到 {patches},返回新 patches 数组或 {error})。dryRun(可选):预检模式,走完整校验链(schema + 白名单 + patch 应用到 clone)但不落盘/入快照,返回预览(四意图均支持,复杂改动先看会改成啥、能否过 schema)。",
@@ -18741,7 +18849,7 @@ function cx(e, n = {}) {
 		})
 	}), M = r(async ({ jsonPath: e }) => {
 		let t = e || "", n = t ? ry(i, t) : i;
-		return n ? `schema${t ? ` @ ${t}` : ""} = ${xb(dy(n))}` : $({
+		return n ? `schema${t ? ` @ ${t}` : ""} = ${Cb(dy(n))}` : $({
 			code: "PATH_DENIED",
 			message: `schema @ "${t}" 不存在`,
 			hint: "jsonPath 需在 schema 声明字段内(用 read() 不传 jsonPath 查看顶层字段)"
@@ -18755,7 +18863,7 @@ function cx(e, n = {}) {
 		if (n) {
 			let e = t;
 			if (typeof e == "string") {
-				let t = vb(e);
+				let t = bb(e);
 				t.parseError || (e = t.parsed);
 			}
 			r = e, i = "against";
@@ -18773,8 +18881,8 @@ function cx(e, n = {}) {
 			});
 			r = t.value, i = `快照 #${t.id}`;
 		}
-		let o = s ? ay(a, s) : a, l = Ob(r, _b(o));
-		return l.length ? `差异(当前 vs ${i},共 ${l.length} 处):\n${l.map((e) => `  ${e.path}: ${xb(e.from)} → ${xb(e.to)}`).join("\n")}` : `无差异:当前主数据与 ${i} 完全相同。`;
+		let o = s ? ay(a, s) : a, l = Ab(r, yb(o));
+		return l.length ? `差异(当前 vs ${i},共 ${l.length} 处):\n${l.map((e) => `  ${e.path}: ${Cb(e.from)} → ${Cb(e.to)}`).join("\n")}` : `无差异:当前主数据与 ${i} 完全相同。`;
 	}, {
 		name: "diff_data",
 		description: "对比当前主数据与某快照(默认最近)或一段 JSON(against)的差异,返回结构化 {path, from→to} 列表。供 verify 自纠/冲突诊断/操作审计(\"刚才改了啥\")。snapshotId 指定快照;against 传一段 JSON 值(与 snapshotId 互斥,传则忽略快照)。",
@@ -18823,7 +18931,7 @@ function cx(e, n = {}) {
 					}
 				});
 			}
-			let f = sx({
+			let f = lx({
 				bindRef: a,
 				value: d,
 				schema: i,
@@ -18834,7 +18942,7 @@ function cx(e, n = {}) {
 				op: "draft_commit",
 				onWrite: p
 			});
-			return f.ok ? (u = f.hash, delete e.files[n], `已 draft_commit 草稿 "${t}" → 主数据 = ${xb(f.data, 600)} (新 hash=${f.hash})${s ? "(白名单模式:仅更新 schema 声明字段)" : ""}。草稿已清理。`) : f.error;
+			return f.ok ? (u = f.hash, delete e.files[n], `已 draft_commit 草稿 "${t}" → 主数据 = ${Cb(f.data, 600)} (新 hash=${f.hash})${s ? "(白名单模式:仅更新 schema 声明字段)" : ""}。草稿已清理。`) : f.error;
 		}, {
 			name: "draft_commit",
 			description: "把 draft_write 累积的草稿合并 + schema 校验 + 原子提交到主数据(失败不污染 bind,草稿保留供修后重试)。流程:读 drafts/{draftId}.json → JSON.parse(失败 JSON_INVALID,草稿保留)→ schema 校验(失败 SCHEMA_INVALID,草稿保留)→ 写 bind + 自动快照(与 write(set)/set_data 共用 commitSetToBind,restore_data 可回退)→ 清草稿。适合从零生成大 JSON(如 50+ 组件页面):分块 draft_write 累积 → draft_commit 一次提交。小改仍用 write/patch(无需 draft)。",
@@ -18870,8 +18978,8 @@ function cx(e, n = {}) {
 }
 //#endregion
 //#region src/core/tools/fetchDoc.ts
-var lx = 3e4, ux = [r(async ({ url: e, as: t }) => {
-	let n = new AbortController(), r = setTimeout(() => n.abort(), lx);
+var fx = 3e4, px = [r(async ({ url: e, as: t }) => {
+	let n = new AbortController(), r = setTimeout(() => n.abort(), fx);
 	try {
 		let r = await fetch(e, {
 			method: "GET",
@@ -18888,7 +18996,7 @@ var lx = 3e4, ux = [r(async ({ url: e, as: t }) => {
 		].join("\n");
 	} catch (t) {
 		let r = t?.message || String(t);
-		return n.signal.aborted ? `获取失败:请求超时(${lx}ms,${e})。` : /Failed to fetch|NetworkError|CORS|blocked/i.test(r) ? `获取失败:可能是 CORS 跨域拦截或网络错误(${r})。浏览器仅能 GET 同源或服务端已配置 CORS 的资源;跨域抓取需后端代理。` : `获取失败:${r}`;
+		return n.signal.aborted ? `获取失败:请求超时(${fx}ms,${e})。` : /Failed to fetch|NetworkError|CORS|blocked/i.test(r) ? `获取失败:可能是 CORS 跨域拦截或网络错误(${r})。浏览器仅能 GET 同源或服务端已配置 CORS 的资源;跨域抓取需后端代理。` : `获取失败:${r}`;
 	} finally {
 		clearTimeout(r);
 	}
@@ -18899,7 +19007,7 @@ var lx = 3e4, ux = [r(async ({ url: e, as: t }) => {
 		url: t.string().describe("要抓取的 URL(同源或已配 CORS)"),
 		as: t.enum(["text", "markdown"]).optional().describe("返回格式标签,默认 text")
 	})
-})], dx = [
+})], mx = [
 	"id",
 	"class",
 	"href",
@@ -18911,12 +19019,12 @@ var lx = 3e4, ux = [r(async ({ url: e, as: t }) => {
 	"aria-label",
 	"name",
 	"type"
-], fx = /^(value|srcdoc|formaction|on\w+)$/i, px = /token|secret|password|passwd|api[-_]?key|auth|cred|csrf|session/i;
-function mx(e, t) {
+], hx = /^(value|srcdoc|formaction|on\w+)$/i, gx = /token|secret|password|passwd|api[-_]?key|auth|cred|csrf|session/i;
+function _x(e, t) {
 	if (!e) return null;
-	let { depth: n, attrs: r, includeText: i = !0 } = t, a = r !== void 0, o = r ?? dx, s = (e) => {
+	let { depth: n, attrs: r, includeText: i = !0 } = t, a = r !== void 0, o = r ?? mx, 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-")) && (fx.test(n.name) || px.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-")) && (hx.test(n.name) || gx.test(n.name) || (t[n.name] = n.value));
 		return t;
 	}, c = (e, t) => {
 		let n = {
@@ -18932,10 +19040,10 @@ function mx(e, t) {
 	};
 	return c(e, n);
 }
-var hx = r(({ selector: e, depth: t, attrs: n, includeText: r }) => {
+var vx = r(({ selector: e, depth: t, attrs: n, includeText: r }) => {
 	let i = e ? document.querySelector(e) : document.body;
 	if (!i) return `未找到匹配元素:selector="${e}"`;
-	let a = mx(i, {
+	let a = _x(i, {
 		depth: t ?? 3,
 		attrs: n,
 		includeText: r ?? !0
@@ -18950,14 +19058,14 @@ var hx = r(({ selector: e, depth: t, attrs: n, includeText: r }) => {
 		attrs: t.array(t.string()).optional().describe("属性白名单(传了 = 严格白名单;不传 = 默认常用 + data-*)"),
 		includeText: t.boolean().optional().describe("是否包含直接文本(默认 true)")
 	})
-}), gx = [hx];
+}), yx = [vx];
 //#endregion
 //#region src/core/tools/envTool.ts
-function _x(e) {
+function bx(e) {
 	let t = e;
 	return typeof t.tagName == "string" || typeof t.nodeType == "number" && typeof t.nodeName == "string";
 }
-function vx(e, t = 3, n = 2e3, r) {
+function xx(e, t = 3, n = 2e3, r) {
 	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;
@@ -18966,14 +19074,14 @@ function vx(e, t = 3, n = 2e3, r) {
 	if (typeof e == "bigint") return `${e.toString()}n`;
 	if (typeof e != "object") return String(e);
 	let i = e;
-	if (_x(i)) {
+	if (bx(i)) {
 		let e = i;
 		return e.tagName ? `[Element: <${e.tagName.toLowerCase()}>]` : `[Node: ${e.nodeName}]`;
 	}
 	if (r?.has(i)) return "[Circular]";
 	let a = r ?? /* @__PURE__ */ new WeakSet();
 	if (a.add(i), Array.isArray(e)) {
-		let r = e.slice(0, 100).map((e) => vx(e, t - 1, n, a));
+		let r = e.slice(0, 100).map((e) => xx(e, t - 1, n, a));
 		return e.length > 100 && r.push(`…(共 ${e.length} 项,已截断)`), r;
 	}
 	if (t < 0) return "(对象,已截断)";
@@ -18985,14 +19093,14 @@ function vx(e, t = 3, n = 2e3, r) {
 			break;
 		}
 		try {
-			o[r] = vx(i[r], t - 1, n, a);
+			o[r] = xx(i[r], t - 1, n, a);
 		} catch {
 			o[r] = "(getter 抛错)";
 		}
 	}
 	return o;
 }
-function yx(e) {
+function Sx(e) {
 	let t = e ?? (typeof window < "u" ? window : {}), n = t.navigator, r = t.location, i = t.document;
 	return {
 		location: {
@@ -19025,9 +19133,9 @@ function yx(e) {
 		} : "(无 document)"
 	};
 }
-var bx = /^(localStorage|sessionStorage|cookie|document|frames|frameElement|opener|parent|top|self|window|globalThis|closed|history|navigation|trustedTypes|origin|crossOriginIsolated)$/, xx = /token|secret|password|passwd|api[-_]?key|auth|cred|csrf|session|ticket/i, Sx = r(({ key: e }) => {
+var Cx = /^(localStorage|sessionStorage|cookie|document|frames|frameElement|opener|parent|top|self|window|globalThis|closed|history|navigation|trustedTypes|origin|crossOriginIsolated)$/, wx = /token|secret|password|passwd|api[-_]?key|auth|cred|csrf|session|ticket/i, Tx = r(({ key: e }) => {
 	if (e) {
-		if (bx.test(e) || xx.test(e)) return JSON.stringify({
+		if (Cx.test(e) || wx.test(e)) return JSON.stringify({
 			key: e,
 			denied: !0,
 			reason: "安全:该 key 在 denylist(localStorage/sessionStorage/cookie/document 或敏感命名 token/secret/key/auth),不读取防泄漏"
@@ -19037,18 +19145,18 @@ var bx = /^(localStorage|sessionStorage|cookie|document|frames|frameElement|open
 			key: e,
 			exists: t !== void 0,
 			type: typeof t,
-			value: vx(t)
+			value: xx(t)
 		}, null, 2);
 	}
-	return JSON.stringify(yx(), null, 2);
+	return JSON.stringify(Sx(), null, 2);
 }, {
 	name: "inspect_env",
 	description: "读取宿主页面环境信息(排查调试用,默认开启)。不传参 = 返回环境摘要(location 的 URL/origin/path、navigator 的浏览器/语言、viewport 视口尺寸、document 的 title/readyState);传 key = 读取指定 window 属性值(如 inspect_env({key:\"appConfig\"}) 读集成方挂的调试变量 window.appConfig)。用于排查「当前页面在哪/什么浏览器/视口多大/调试变量值是什么」。轻量只读,大结果自动外存 vfs。",
 	schema: t.object({ key: t.string().optional().describe("要读取的 window 属性名(如 \"appConfig\"/\"__DEBUG__\");不传 = 返回环境摘要") })
-}), Cx = [Sx];
+}), Ex = [Tx];
 //#endregion
 //#region src/core/harness/budget.ts
-function wx(e, t, n) {
+function Dx(e, t, n) {
 	let r = 0;
 	return {
 		name: "budget",
@@ -19073,12 +19181,12 @@ function wx(e, t, n) {
 }
 //#endregion
 //#region src/core/sdk/actions.ts
-var Tx = /^[a-zA-Z][a-zA-Z0-9_]*$/;
-function Ex(e) {
+var Ox = /^[a-zA-Z][a-zA-Z0-9_]*$/;
+function kx(e) {
 	let n = [];
 	for (let [i, a] of Object.entries(e)) {
-		if (!Tx.test(i)) {
-			console.warn(`[page-agent-sdk][actions] 动作名 "${i}" 非法(须匹配 ${Tx}),已跳过`);
+		if (!Ox.test(i)) {
+			console.warn(`[page-agent-sdk][actions] 动作名 "${i}" 非法(须匹配 ${Ox}),已跳过`);
 			continue;
 		}
 		let e = a.description || `宿主动作 ${i}`;
@@ -19098,9 +19206,9 @@ function Ex(e) {
 	}
 	return n;
 }
-function Dx(e) {
+function Ax(e) {
 	let t = {};
-	for (let [n, r] of Object.entries(e)) Tx.test(n) && (t[n] = {
+	for (let [n, r] of Object.entries(e)) Ox.test(n) && (t[n] = {
 		description: r.description,
 		hasParams: !!r.params
 	});
@@ -19108,31 +19216,31 @@ function Dx(e) {
 }
 //#endregion
 //#region src/core/toolsets.ts
-var Ox = ux, kx = gx;
-function Ax(e, t) {
-	return cx(e, t);
+var jx = px, Mx = yx;
+function Nx(e, t) {
+	return dx(e, t);
 }
-function jx(e, t, n, r, i) {
-	let a = e?.dataOps !== !1, o = e?.fetch !== !1, s = e?.domInspect === !0, c = e?.inspectEnv !== !1;
+function Px(e, t, n, r, i) {
+	let a = ob(e);
 	return [
-		...a ? t : [],
-		...o ? n : [],
-		...s && r ? r : [],
-		...c && i ? i : []
+		...a.dataOps ? t : [],
+		...a.fetch ? n : [],
+		...a.domInspect && r ? r : [],
+		...a.inspectEnv && i ? i : []
 	];
 }
 //#endregion
 //#region src/core/harness/usageHints.ts
-var Mx = .7;
-function Nx(e, t, n = "simple") {
-	let r = n !== "advanced";
+var Fx = .7;
+function Ix(e, t, n = "simple") {
+	let r = ob(e), i = n !== "advanced";
 	return {
 		name: "usageHints",
 		augmentPrompt: () => {
 			let n = [];
-			if (e?.planning !== !1 && (n.push("【自适应规划】按任务复杂度决定是否先规划,不要对简单任务过度编排:"), n.push("  · 简单/明确任务(改单字段、调样式、查值)→ 直接 read/write 执行,不必 write_todos。"), n.push("  · 复杂任务(多步、大改、有歧义、不可逆)→ 先 write_todos 拆解,首个任务标 in_progress,逐项推进。"), n.push("  · 执行中发现步骤要改/补/细分 → 用 update_todo({id, content?, status?}) 按 id 增量改单项,不必重传整个清单。"), n.push("  · 规划出多步方案若需用户拍板 → 先 request_human_confirmation 给方案选项,确认后再执行。"), n.push("  · 规划阶段有轮次预算(maxPlanRevisions,默认 5):勿反复调研/改计划而不执行,规划充分后即开始 write 落地。")), t && (r ? (n.push("读写主数据用 read/write(高层入口,自动乐观锁 + 自动快照)。read({jsonPath}) 读子路径当前值(返回含 hash,write 时自动比对,无需手动传);read() 不传读整个主数据 + 说明。write 改值两姿势:① 改单个字段/子路径用 write({patch:{op:\"set\", jsonPath:\"路径.字段\", value:新值}})——patch.value 就是该字段的新值(类型匹配:string 直传字符串、number 传数字、对象传对象),不要包成 {字段:值} 对象(字段名已在 jsonPath);也兼容 write({value:新值, patch:{op,jsonPath}}) 顶层 value(向后兼容,但优先 patch.value,避免与整体 set 的 value 混淆);② 替换整个对象用 write({value:{整个新对象}})。op:set 设值 / remove 删 / merge 合并对象 / append 追加数组;批量多改动 write({patches:[{op,jsonPath,value},...]});删子路径 write({patch:{jsonPath:\"路径\"}, del:true})。写入自动经 schema 校验(失败不写,按错误提示改值类型/形状后重试)+ 自动存快照(出错可用 restore_data 回退)。"), n.push("修改大对象/数组优先用 write 的 patch 增量(只发改动部分),避免整体重传被 max_tokens 截断致 JSON 不完整。"), n.push("读大数组(read 返回 hasMore=true)用 read({jsonPath,offset,limit}) 分页(offset+=limit 续读,默认 limit=50);一次读多个不相关子路径用 read({jsonPaths:[...]}) 省轮次;复杂 patches 改动先 write({patches,dryRun:true}) 预检(走完整校验不落盘)。"), n.push("查历史快照值(看上一版长啥样 / 冲突诊断 / 用户问\"刚才改了啥\")用 history_data({id?,jsonPath?})(只读不改当前);对比当前与历史快照的差异需切 advanced 用 diff_data(返回结构化 path→from/to)。"), n.push("在大数组里按条件筛选用 query_data(JSONPath,如 $.components[?(@.type==\"card\" && @.price<100)]),返回匹配元素 path/index;定位后用 write patch 改。找名字记不清的元素用 search_data(substring/regex/fuzzy)。批量过滤/映射/聚合/重写大数组用 eval_script(沙箱脚本,mode=query 只读/transform 落地)。")) : (n.push("改主数据前先 get_data({jsonPath}) 读其当前真实值与 hash(返回末尾 hash=xxx),基于真实值改,不要凭记忆。写入(set/edit/delete)时回传 expectedHash=该 hash 启用乐观锁——若主数据在你 get 之后被外部代码/其他 agent/用户手动改过,会触发冲突:集成方若开启人工介入,工具会挂起等用户决定(保留外部/强制覆盖/回退),你应等待工具返回后按结果继续(保留外部→重新 get 再改;强制覆盖→已写入,继续;回退→已回退到历史快照,基于回退值重写);未开启人工介入时返回 VERSION_CONFLICT 不写入,重新 get 拿最新值与 hash 再改。"), n.push("不确定主数据字段结构时用 describe_data 查看说明。"), n.push("修改大对象/数组优先用 edit_data 增量 patch(只发改动部分),避免 set_data 整体重传被 max_tokens 截断导致 JSON 不完整、校验失败。"), n.push("修改主数据出错时可用 restore_data 回退最近一次。"), n.push("在大数组里按条件筛选元素用 query_data(JSONPath,如 $.components[?(@.type==\"card\" && @.price<100)]),返回匹配元素的 path/index;定位后再 edit_data 改。"), n.push("找名字记不清的元素用 search_data(支持 substring/regex/fuzzy 模糊搜索)。"), n.push("需要过滤/映射/聚合/批量重写大数组时用 eval_script(沙箱脚本,入参 data);只读探查用 mode=query,批量重写用 mode=transform(返回值经校验后落地)。"), n.push("读大数组用 read({jsonPath,offset,limit}) 分页(返回 hasMore=true 时 offset+=limit 续读);一次读多个不相关子路径用 read({jsonPaths});复杂改动先 write({...,dryRun:true}) 预检不落盘。"), n.push("对比当前与历史快照(或一段 JSON against)的差异用 diff_data({snapshotId?,against?})(返回结构化 path→from/to,verify 自纠/操作审计/\"刚才改了啥\");只读查历史快照值用 history_data({id?,jsonPath?})。"))), e?.subagent !== !1 && n.push("独立子任务可 spawn_agent 委派(只读工具,过程不占主上下文)。"), e?.inspectEnv !== !1 && n.push("排查页面环境(当前 URL/浏览器/视口/集成方调试变量)用 inspect_env——不传参返回环境摘要(location/navigator/viewport/document),传 key 读特定 window 属性(如 inspect_env({key:\"appConfig\"}) 读 window.appConfig)。改完数据看渲染、定位\"为何没生效\"时用它(只读,不改数据)。"), e?.draftWrite && n.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。"), e?.todoDeps && n.push("复杂任务可用 todos 层级依赖:write_todos 时给 todo 传 parentId(父任务 id,表达层级)+ deps(依赖的 todo id 数组,必须先完成)。有依赖的任务,deps 全 completed 后再标 in_progress;完成时 update_todo({id, status:\"completed\", evidence:\"完成证据\"}) 记证据。无依赖关系的任务不传 parentId/deps(扁平)。"), e?.subagents?.length) {
-				let t = e.subagents.filter((e) => (e.temperature ?? 0) >= Mx || /规划|创意|设计|方案|brainstorm|plan/i.test(e.description)), i = e.subagents.filter((e) => (e.temperature ?? 0) < Mx && /反思|审查|挑刺|校验|review|critique|reflect/i.test(e.description));
-				n.push("【规划-反思-执行·路由】按任务性质选模式,不要对简单任务过度编排:"), t.length && (n.push(`  · 创作/设计/开放性需求(如"设计主题风格""换个感觉")→ 先调 ${t.map((e) => "use_" + e.id).join("/")} 出 2-3 套方案(高温创意),`), n.push("    不要自己拍板;拿到方案后,若需用户拍板用 request_human_confirmation 弹选项。")), i.length && n.push(`  · 严谨/易错/校验类 → 可先调 ${i.map((e) => "use_" + e.id).join("/")} 反思挑刺(低温审查),据反馈修订。`), n.push(r ? "  · 方案定稿后,由你(主 agent)用 write 落地成 JSON(低温度执行 + schema 校验 + 写前确认)。" : "  · 方案定稿后,由你(主 agent)用 edit_data 落地成 JSON(低温度执行 + schema 校验 + 写前确认)。"), n.push("  · 简单/明确任务(如\"标题改红色\")直接执行,不必走规划-反思。");
+			if (r.planning && (n.push("【自适应规划】按任务复杂度决定是否先规划,不要对简单任务过度编排:"), n.push("  · 简单/明确任务(改单字段、调样式、查值)→ 直接 read/write 执行,不必 write_todos。"), n.push("  · 复杂任务(多步、大改、有歧义、不可逆)→ 先 write_todos 拆解,首个任务标 in_progress,逐项推进。"), n.push("  · 执行中发现步骤要改/补/细分 → 用 update_todo({id, content?, status?}) 按 id 增量改单项,不必重传整个清单。"), n.push("  · 规划出多步方案若需用户拍板 → 先 request_human_confirmation 给方案选项,确认后再执行。"), n.push("  · 规划阶段有轮次预算(maxPlanRevisions,默认 5):勿反复调研/改计划而不执行,规划充分后即开始 write 落地。")), t && (i ? (n.push("读写主数据用 read/write(高层入口,自动乐观锁 + 自动快照)。read({jsonPath}) 读子路径当前值(返回含 hash,write 时自动比对,无需手动传);read() 不传读整个主数据 + 说明。write 改值两姿势:① 改单个字段/子路径用 write({patch:{op:\"set\", jsonPath:\"路径.字段\", value:新值}})——patch.value 就是该字段的新值(类型匹配:string 直传字符串、number 传数字、对象传对象),不要包成 {字段:值} 对象(字段名已在 jsonPath);也兼容 write({value:新值, patch:{op,jsonPath}}) 顶层 value(向后兼容,但优先 patch.value,避免与整体 set 的 value 混淆);② 替换整个对象用 write({value:{整个新对象}})。op:set 设值 / remove 删 / merge 合并对象 / append 追加数组;批量多改动 write({patches:[{op,jsonPath,value},...]});删子路径 write({patch:{jsonPath:\"路径\"}, del:true})。写入自动经 schema 校验(失败不写,按错误提示改值类型/形状后重试)+ 自动存快照(出错可用 restore_data 回退)。"), n.push("修改大对象/数组优先用 write 的 patch 增量(只发改动部分),避免整体重传被 max_tokens 截断致 JSON 不完整。"), n.push("读大数组(read 返回 hasMore=true)用 read({jsonPath,offset,limit}) 分页(offset+=limit 续读,默认 limit=50);一次读多个不相关子路径用 read({jsonPaths:[...]}) 省轮次;复杂 patches 改动先 write({patches,dryRun:true}) 预检(走完整校验不落盘)。"), n.push("查历史快照值(看上一版长啥样 / 冲突诊断 / 用户问\"刚才改了啥\")用 history_data({id?,jsonPath?})(只读不改当前);对比当前与历史快照的差异需切 advanced 用 diff_data(返回结构化 path→from/to)。"), n.push("在大数组里按条件筛选用 query_data(JSONPath,如 $.components[?(@.type==\"card\" && @.price<100)]),返回匹配元素 path/index;定位后用 write patch 改。找名字记不清的元素用 search_data(substring/regex/fuzzy)。批量过滤/映射/聚合/重写大数组用 eval_script(沙箱脚本,mode=query 只读/transform 落地)。")) : (n.push("改主数据前先 get_data({jsonPath}) 读其当前真实值与 hash(返回末尾 hash=xxx),基于真实值改,不要凭记忆。写入(set/edit/delete)时回传 expectedHash=该 hash 启用乐观锁——若主数据在你 get 之后被外部代码/其他 agent/用户手动改过,会触发冲突:集成方若开启人工介入,工具会挂起等用户决定(保留外部/强制覆盖/回退),你应等待工具返回后按结果继续(保留外部→重新 get 再改;强制覆盖→已写入,继续;回退→已回退到历史快照,基于回退值重写);未开启人工介入时返回 VERSION_CONFLICT 不写入,重新 get 拿最新值与 hash 再改。"), n.push("不确定主数据字段结构时用 describe_data 查看说明。"), n.push("修改大对象/数组优先用 edit_data 增量 patch(只发改动部分),避免 set_data 整体重传被 max_tokens 截断导致 JSON 不完整、校验失败。"), n.push("修改主数据出错时可用 restore_data 回退最近一次。"), n.push("在大数组里按条件筛选元素用 query_data(JSONPath,如 $.components[?(@.type==\"card\" && @.price<100)]),返回匹配元素的 path/index;定位后再 edit_data 改。"), n.push("找名字记不清的元素用 search_data(支持 substring/regex/fuzzy 模糊搜索)。"), n.push("需要过滤/映射/聚合/批量重写大数组时用 eval_script(沙箱脚本,入参 data);只读探查用 mode=query,批量重写用 mode=transform(返回值经校验后落地)。"), n.push("读大数组用 read({jsonPath,offset,limit}) 分页(返回 hasMore=true 时 offset+=limit 续读);一次读多个不相关子路径用 read({jsonPaths});复杂改动先 write({...,dryRun:true}) 预检不落盘。"), n.push("对比当前与历史快照(或一段 JSON against)的差异用 diff_data({snapshotId?,against?})(返回结构化 path→from/to,verify 自纠/操作审计/\"刚才改了啥\");只读查历史快照值用 history_data({id?,jsonPath?})。"))), r.subagent && n.push("独立子任务可 spawn_agent 委派(只读工具,过程不占主上下文)。"), r.inspectEnv && n.push("排查页面环境(当前 URL/浏览器/视口/集成方调试变量)用 inspect_env——不传参返回环境摘要(location/navigator/viewport/document),传 key 读特定 window 属性(如 inspect_env({key:\"appConfig\"}) 读 window.appConfig)。改完数据看渲染、定位\"为何没生效\"时用它(只读,不改数据)。"), r.draftWrite && n.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。"), r.todoDeps && n.push("复杂任务可用 todos 层级依赖:write_todos 时给 todo 传 parentId(父任务 id,表达层级)+ deps(依赖的 todo id 数组,必须先完成)。有依赖的任务,deps 全 completed 后再标 in_progress;完成时 update_todo({id, status:\"completed\", evidence:\"完成证据\"}) 记证据。无依赖关系的任务不传 parentId/deps(扁平)。"), e?.subagents?.length) {
+				let t = e.subagents.filter((e) => (e.temperature ?? 0) >= Fx || /规划|创意|设计|方案|brainstorm|plan/i.test(e.description)), r = e.subagents.filter((e) => (e.temperature ?? 0) < Fx && /反思|审查|挑刺|校验|review|critique|reflect/i.test(e.description));
+				n.push("【规划-反思-执行·路由】按任务性质选模式,不要对简单任务过度编排:"), t.length && (n.push(`  · 创作/设计/开放性需求(如"设计主题风格""换个感觉")→ 先调 ${t.map((e) => "use_" + e.id).join("/")} 出 2-3 套方案(高温创意),`), n.push("    不要自己拍板;拿到方案后,若需用户拍板用 request_human_confirmation 弹选项。")), r.length && n.push(`  · 严谨/易错/校验类 → 可先调 ${r.map((e) => "use_" + e.id).join("/")} 反思挑刺(低温审查),据反馈修订。`), n.push(i ? "  · 方案定稿后,由你(主 agent)用 write 落地成 JSON(低温度执行 + schema 校验 + 写前确认)。" : "  · 方案定稿后,由你(主 agent)用 edit_data 落地成 JSON(低温度执行 + schema 校验 + 写前确认)。"), n.push("  · 简单/明确任务(如\"标题改红色\")直接执行,不必走规划-反思。");
 			}
 			return e?.humanConfirm && (n.push("【人工确认·必读】以下情形必须先调 request_human_confirmation 征询用户、拿到答复后再继续,不要自行拍板:"), n.push("  1) 用户让你「给方案/列选项/我来选/挑一个」时:把每个方案作为一个 option,调 request_human_confirmation(question=简述, options=[方案A,方案B,...], recommendation=你推荐的)。不要只回文字罗列方案让用户自己回复——要用工具把选项做成可点选按钮。"), n.push("  2) 需求有歧义/不确定时:调工具问清楚(options 不传则用户答同意或拒绝)。"), n.push("  3) 即将执行高风险不可逆操作(删除/覆盖/批量改动)前:调工具确认。"), n.push("  4) 规划出多步方案需用户确认时:把整个方案(或关键分步)作为 option 调 request_human_confirmation,确认后再执行。"), n.push("用户在选项里选了哪个,就按那个方案继续;选「拒绝」则停止并询问如何调整。")), n.length && n.unshift("调用工具务必用标准 function calling(工具调用)格式发起,不要在回复正文里输出伪 XML/标签(如 deepseek 的 tool_calls 标签、invoke、function_call、tool_call 等)或 JSON 文本——那不会被识别为工具调用,会被当普通文字,工具不执行。"), n.length ? "## 能力使用提示\n" + n.join("\n") : void 0;
 		}
@@ -19140,15 +19248,15 @@ function Nx(e, t, n = "simple") {
 }
 //#endregion
 //#region src/core/backends/skillStore.ts
-var Px = "v:1::skill-store", Fx = "chat-sdk";
-function Ix(e, t, n) {
-	return `${Px}::${e}::${t}::${n}`;
+var Lx = "v:1::skill-store", Rx = "chat-sdk";
+function zx(e, t, n) {
+	return `${Lx}::${e}::${t}::${n}`;
 }
-function Lx(e, t) {
-	return `${Px}::${e}::${t}::`;
+function Bx(e, t) {
+	return `${Lx}::${e}::${t}::`;
 }
-function Rx(e = {}) {
-	let t = e.dbName ?? Fx, n = e.backend ?? "indexed", r = e.id ?? "", i, a, o = new Promise((e) => {
+function Vx(e = {}) {
+	let t = e.dbName ?? Rx, n = e.backend ?? "indexed", r = e.id ?? "", i, a, o = new Promise((e) => {
 		a = e;
 	});
 	return (async () => {
@@ -19170,42 +19278,42 @@ function Rx(e = {}) {
 		ready: o,
 		async list() {
 			let e = [];
-			return await i.scan(Lx(t, r), (t, n) => {
+			return await i.scan(Bx(t, r), (t, n) => {
 				e.push(n);
 			}), e;
 		},
 		async get(e) {
-			return await i.get(Ix(t, r, e));
+			return await i.get(zx(t, r, e));
 		},
 		async put(e) {
 			try {
-				await i.set(Ix(t, r, e.name), e);
+				await i.set(zx(t, r, e.name), e);
 			} catch (e) {
 				Wy(e) && (i = Qy());
 			}
 		},
 		async remove(e) {
-			let n = Ix(t, r, e);
+			let n = zx(t, r, e);
 			return await i.get(n) != null && (await i.del(n), !0);
 		},
 		async clear() {
-			await i.clearPrefix(Lx(t, r));
+			await i.clearPrefix(Bx(t, r));
 		},
 		dispose() {}
 	};
 }
 //#endregion
 //#region src/core/sdk/createChatSdk.ts
-var zx = 50, Bx = /* @__PURE__ */ new Map();
-function Vx(e, t) {
+var Hx = 50, Ux = /* @__PURE__ */ new Map();
+function Wx(e, t) {
 	return e === "set_data" ? "set" : e === "edit_data" ? "edit" : e === "delete_data" ? "delete" : e === "restore_data" ? "restore" : e === "write" ? t?.del ? "delete" : t?.patch ? "edit" : "set" : null;
 }
-function Hx(e, t, n, r) {
+function Gx(e, t, n, r) {
 	let i = 0;
 	return {
 		name: "sdk-events",
 		wrapToolCall: async (t, r) => {
-			let i = await r(t), a = Vx(t.name, t.args);
+			let i = await r(t), a = Wx(t.name, t.args);
 			return a && e({
 				type: "data_change",
 				operation: a,
@@ -19240,7 +19348,7 @@ function Hx(e, t, n, r) {
 		}
 	};
 }
-function Ux(e, i) {
+function Kx(e, i) {
 	let a = {
 		prompt_tokens: 0,
 		completion_tokens: 0,
@@ -19251,7 +19359,7 @@ function Ux(e, i) {
 	e.debug && console.log("[page-agent-sdk][modelCaps]", d);
 	let f = e.llm;
 	e.debug && !u && console.warn("[page-agent-sdk][summarization] 未构造 llmInvoke(apiKey 缺失?),摘要回退零成本索引摘要");
-	let p = /* @__PURE__ */ tn([]), m = Mb(e.vfs?.initialFiles, {
+	let p = /* @__PURE__ */ tn([]), m = Pb(e.vfs?.initialFiles, {
 		persist: c ? { save: (e) => {
 			B.sessionId && c && c.save(i, B.sessionId, { vfs: e });
 		} } : void 0,
@@ -19271,18 +19379,18 @@ function Ux(e, i) {
 		getTodos: () => y.current?.getState?.()?.todos ?? [],
 		messages: p,
 		maxCheckpoints: x && typeof x == "object" ? x.maxCheckpoints : void 0
-	}) : null, w = !x || typeof x != "object" || x.auto !== !1, T = e.capabilities, E = T?.dataOps !== !1, D = T?.draftWrite === !0, O = T?.tracing === !0, k = T?.automation === !0, A = Ey(e), j = E && b ? cx(b, {
+	}) : null, w = !x || typeof x != "object" || x.auto !== !1, T = ob(e.capabilities), E = T.dataOps, D = T.draftWrite, O = T.tracing, k = T.automation, A = Ey(e), j = E && b ? dx(b, {
 		onAudit: e.onAudit ?? (e.debug ? (e) => console.log("[page-agent-sdk][data audit]", e) : void 0),
 		maxSnapshots: e.maxSnapshots,
 		onConflict: o.set,
 		autoLock: e.autoLock,
 		interceptors: e.interceptors,
 		vfsStore: D ? m : void 0
-	}) : [], M = E ? ox(j, e.toolMode) : [], ee = E && b ? j.controller ?? null : null, N = () => ee?.get() ?? b, P = /* @__PURE__ */ new Map(), F = jx(T, M, ux, gx, Cx);
+	}) : [], M = E ? cx(j, e.toolMode) : [], ee = E && b ? j.controller ?? null : null, N = () => ee?.get() ?? b, P = /* @__PURE__ */ new Map(), F = Px(T, M, px, yx, Ex);
 	F.forEach((e) => P.set(e.name, "builtin"));
 	let I = [...e.tools || []];
 	I.forEach((e) => P.set(e.name, "user"));
-	let te = Ex(e.actions ?? {});
+	let te = kx(e.actions ?? {});
 	te.forEach((e) => P.set(e.name, "action"));
 	let L = [], R = e.humanConfirm !== !1 && (!e.approval || e.approval.humanConfirmTool !== !1), ne = R ? X_() : null;
 	ne && P.set(J_, "builtin");
@@ -19319,11 +19427,11 @@ function Ux(e, i) {
 			...L
 		];
 	}
-	let ae = T?.planning !== !1, oe = T?.missionAnchor !== !1, se = T?.workingMemory !== !1, ce = T?.skills !== !1, le = T?.vfs !== !1;
-	if (le) for (let e of zb) P.set(e, "builtin");
+	let ae = T.planning, oe = T.missionAnchor, se = T.workingMemory, ce = T.skills, le = T.vfs;
+	if (le) for (let e of Vb) P.set(e, "builtin");
 	if (ae) for (let e of h.tools ?? []) P.set(e.name, "builtin");
-	let ue = T?.summarization !== !1, de = T?.memory !== !1, fe = T?.subagent !== !1, pe = e.verify?.maxAttempts ?? 2, me = T?.verify === !0 && e.verify?.enabled !== !1 && pe > 0;
-	e.verify?.check && T?.verify !== !0 && console.warn("[page-agent-sdk][verify] 检测到 verify.check 但 capabilities.verify 未开启,verify 未装载");
+	let ue = T.summarization, de = T.memory, fe = T.subagent, pe = e.verify?.maxAttempts ?? 2, me = T.verify && e.verify?.enabled !== !1 && pe > 0;
+	e.verify?.check && !T.verify && console.warn("[page-agent-sdk][verify] 检测到 verify.check 但 capabilities.verify 未开启,verify 未装载");
 	let he = e.subagent, ge = he?.allowedTools ?? [], _e = !fe || he?.enabled === !1 ? void 0 : _v({
 		llm: he?.llm ?? e.llm,
 		allTools: z,
@@ -19353,7 +19461,7 @@ function Ux(e, i) {
 			llm: e.llm,
 			tools: xe
 		} : void 0
-	}) : void 0, Ce = Nx({
+	}) : void 0, Ce = Ix({
 		...T,
 		humanConfirm: R,
 		subagents: e.subagents?.map((e) => ({
@@ -19377,7 +19485,7 @@ function Ux(e, i) {
 				return;
 			}
 		}
-	} : null, Ee = e.onEvent, De = ab(e.onEvent), Oe = De.emit, ke, Ae = [], je = (e) => ({
+	} : null, Ee = e.onEvent, De = sb(e.onEvent), Oe = De.emit, ke, Ae = [], je = (e) => ({
 		name: e.name,
 		description: e.description,
 		content: typeof e.getContent == "function" ? e.getContent() : ""
@@ -19385,7 +19493,7 @@ function Ux(e, i) {
 		name: e.name,
 		description: e.description,
 		getContent: () => e.content
-	}), Ne = e.skillStorage === !1 ? null : Rx({
+	}), Ne = e.skillStorage === !1 ? null : Vx({
 		...typeof e.skillStorage == "object" ? e.skillStorage : {},
 		id: e.skillStorage && typeof e.skillStorage == "object" && e.skillStorage.id ? e.skillStorage.id : `agent::${i}`
 	}), Pe = () => {
@@ -19408,18 +19516,18 @@ function Ux(e, i) {
 				B.infoTick.value++;
 			}
 		} catch {}
-	}, Ie = ub([
+	}, Ie = fb([
 		...we ? [we] : [],
 		Ce,
 		...oe ? [g] : [],
 		...ae ? [h] : [],
 		...ce ? [ke = z_(e.skills || [], { readVfs: le ? (e) => m.files[e]?.content : void 0 })] : [],
-		...le ? [Vb(m)] : [],
+		...le ? [Ub(m)] : [],
 		...ue ? [$v({
-			...cb(e, d.contextWindow),
+			...ub(e, d.contextWindow),
 			llmInvoke: u,
 			getRegisteredData: () => N() ? [{ description: N().description ?? "主数据对象" }] : [],
-			preserveLastToolResults: (e.contextOptions && e.contextOptions.preserveLastToolResults) ?? sb[e.contextPreset ?? "auto"]
+			preserveLastToolResults: (e.contextOptions && e.contextOptions.preserveLastToolResults) ?? lb[e.contextPreset ?? "auto"]
 		})] : [],
 		...se ? [_] : [],
 		...de ? [v] : [],
@@ -19432,12 +19540,12 @@ function Ux(e, i) {
 		...ve ? [ve] : [],
 		...Te ? [Te] : [],
 		...e.middleware || [],
-		...k ? [wx(a, {
+		...k ? [Dx(a, {
 			tokenBudget: e.tokenBudget,
 			timeBudgetMs: e.timeBudgetMs
 		}, Oe)] : [],
-		Hx(Oe, p, N, a)
-	]), Le = e.maxMemoryRounds ?? zx, B = {
+		Gx(Oe, p, N, a)
+	]), Le = e.maxMemoryRounds ?? Hx, B = {
 		agentId: i,
 		store: c,
 		messages: p,
@@ -19615,7 +19723,7 @@ function Ux(e, i) {
 			if (B.refCount--, B.refCount <= 0) {
 				c && (m.flush?.(), c.flush(), c.dispose()), Ne && Ne.dispose();
 				let e = B.mcpClosers.splice(0);
-				e.length && Promise.allSettled(e.map((e) => e())), Bx.delete(i);
+				e.length && Promise.allSettled(e.map((e) => e())), Ux.delete(i);
 			}
 		},
 		resolveConflict: o.resolve,
@@ -19708,7 +19816,7 @@ function Ux(e, i) {
 					spans: B.agent.spans.value,
 					metrics: r_(B.agent.spans.value)
 				} : void 0,
-				actions: Dx(e.actions ?? {}),
+				actions: Ax(e.actions ?? {}),
 				subagent: {
 					enabled: !!_e,
 					maxDepth: e.subagent?.maxDepth ?? 1,
@@ -19837,11 +19945,11 @@ function Ux(e, i) {
 		});
 	})(), B;
 }
-function Wx(e) {
+function qx(e) {
 	let t = e.id ?? My();
 	e.id || console.warn(`[page-agent-sdk] 未传 options.id,已生成随机 id "${t}"。刷新后持久化数据无法恢复,请传稳定 id。`);
-	let n = e.streaming ?? !0, r = e.ui ?? "default", i, a = e.shareContext ? Bx.get(t) : void 0;
-	a ? i = a : (i = Ux(e, t), e.shareContext && Bx.set(t, i)), i.refCount++;
+	let n = e.streaming ?? !0, r = e.ui ?? "default", i, a = e.shareContext ? Ux.get(t) : void 0;
+	a ? i = a : (i = Kx(e, t), e.shareContext && Ux.set(t, i)), i.refCount++;
 	let o = null, s = null, c = ib(e), l = null, u = null;
 	async function d(t) {
 		if (await i.initDone, o) {
@@ -20022,7 +20130,7 @@ function Wx(e) {
 }
 //#endregion
 //#region src/core/sdk/defineTool.ts
-function Gx(e) {
+function Jx(e) {
 	return r(async (t) => {
 		let n = await e.handler(t);
 		return typeof n == "string" ? n : JSON.stringify(n);
@@ -20033,4 +20141,4 @@ function Gx(e) {
 	});
 }
 //#endregion
-export { ob as CONTEXT_PRESETS, Bg as ChatDialog, nf as CodePreview, wy as DEFAULT_SYSTEM_PROMPT, J_ as HUMAN_CONFIRM_TOOL_NAME, af as MessageContent, Gv as STOP_WORDS, xh as SkillPanel, db as UNSAFE_KEYS, Dx as actionsToInspectInfo, Ex as actionsToTools, Kg as agentError, wb as applyPatchToClone, Tb as applyPatchToLive, Gg as asAgentError, Ty as buildDataPrompt, Ey as buildSystemPrompt, sx as commitSetToBind, Lv as connectMcp, wl as copyText, x_ as createAgent, q_ as createApprovalMiddleware, Wx as createChatSdk, iv as createCheckpointManager, av as createCheckpointMiddleware, jy as createConflictManager, cx as createDataOps, Z_ as createHumanConfirmMiddleware, X_ as createHumanConfirmTool, Qy as createMemoryBackend, B_ as createMemoryMiddleware, v as createProxyLlm, ab as createSdkEvents, nb as createSessionStore, Rx as createSkillStore, _v as createSubagentMiddleware, bv as createSubagentsMiddleware, Nx as createUsageHintsMiddleware, xv as createVerifyMiddleware, Mb as createVfs, eb as createWebStorageBackend, Dv as createWriteBackCheck, _b as deepClone, Ax as defineDataToolset, N_ as defineSkill, Gx as defineTool, gb as deleteByPath, dy as describeSchemaNode, p_ as detectGarbledToolCall, Ob as diffObjects, mx as domToStructure, gx as domTools, kx as domToolsStatic, qv as estimateMessageTokens, Jv as estimateRoundTokens, e_ as estimateTokens, Sy as extractSchemaHint, Pv as extractText, ux as fetchDocTools, Ox as fetchTools, ox as filterByToolMode, fy as formatConstraints, Vg as formatZodIssues, mb as getByPath, hx as getDomTool, yx as getEnvSummary, ry as getSchemaAtPath, ey as getSchemaTopKeys, r_ as getTraceMetrics, Cb as hashValue, Yv as indexSummarize, Sx as inspectEnvTool, Cx as inspectTools, Dy as isChatModel, ty as isPathAllowed, Wy as isQuotaError, fb as isUnsafePath, Zb as jpEval, Ug as jsonParseError, bb as limitDepth, vb as maybeParseValue, n_ as offloadPassThroughChars, t_ as offloadThresholdChars, _y as presets, ay as projectBySchema, iy as projectBySchemaDeep, yb as projectFields, Xv as recallRounds, py as renderSchemaHint, my as renderSchemaOverview, gy as renderSchemaShallow, cb as resolveContextOptions, ib as resolveDialogConfig, Ay as resolveLlm, $g as resolveModelCaps, rb as resolveStorage, Db as restoreInPlace, Eb as restoreLive, Wg as routeError, rx as runSandboxedScript, pb as safeMerge, vx as safeSerialize, xb as safeStringify, $b as searchJson, jx as selectBuiltinTools, hb as setByPath, vy as systemPromptHelpers, Kv as tokenize, $ as toolError, ny as unwrapSchema, Cl as useChat, e as z, Hg as zodError };
+export { ab as CAPABILITIES, cb as CONTEXT_PRESETS, Bg as ChatDialog, nf as CodePreview, wy as DEFAULT_SYSTEM_PROMPT, J_ as HUMAN_CONFIRM_TOOL_NAME, af as MessageContent, Gv as STOP_WORDS, xh as SkillPanel, pb as UNSAFE_KEYS, Ax as actionsToInspectInfo, kx as actionsToTools, Kg as agentError, Eb as applyPatchToClone, Db as applyPatchToLive, Gg as asAgentError, Ty as buildDataPrompt, Ey as buildSystemPrompt, lx as commitSetToBind, Lv as connectMcp, wl as copyText, x_ as createAgent, q_ as createApprovalMiddleware, qx as createChatSdk, iv as createCheckpointManager, av as createCheckpointMiddleware, jy as createConflictManager, dx as createDataOps, Z_ as createHumanConfirmMiddleware, X_ as createHumanConfirmTool, Qy as createMemoryBackend, B_ as createMemoryMiddleware, v as createProxyLlm, sb as createSdkEvents, nb as createSessionStore, Vx as createSkillStore, _v as createSubagentMiddleware, bv as createSubagentsMiddleware, Ix as createUsageHintsMiddleware, xv as createVerifyMiddleware, Pb as createVfs, eb as createWebStorageBackend, Dv as createWriteBackCheck, yb as deepClone, Nx as defineDataToolset, N_ as defineSkill, Jx as defineTool, vb as deleteByPath, dy as describeSchemaNode, p_ as detectGarbledToolCall, Ab as diffObjects, _x as domToStructure, yx as domTools, Mx as domToolsStatic, qv as estimateMessageTokens, Jv as estimateRoundTokens, e_ as estimateTokens, Sy as extractSchemaHint, Pv as extractText, px as fetchDocTools, jx as fetchTools, cx as filterByToolMode, fy as formatConstraints, Vg as formatZodIssues, gb as getByPath, vx as getDomTool, Sx as getEnvSummary, ry as getSchemaAtPath, ey as getSchemaTopKeys, r_ as getTraceMetrics, Tb as hashValue, Yv as indexSummarize, Tx as inspectEnvTool, Ex as inspectTools, Dy as isChatModel, ty as isPathAllowed, Wy as isQuotaError, mb as isUnsafePath, $b as jpEval, Ug as jsonParseError, Sb as limitDepth, bb as maybeParseValue, n_ as offloadPassThroughChars, t_ as offloadThresholdChars, _y as presets, ay as projectBySchema, iy as projectBySchemaDeep, xb as projectFields, Xv as recallRounds, py as renderSchemaHint, my as renderSchemaOverview, gy as renderSchemaShallow, ob as resolveCapabilities, ub as resolveContextOptions, ib as resolveDialogConfig, Ay as resolveLlm, $g as resolveModelCaps, rb as resolveStorage, kb as restoreInPlace, Ob as restoreLive, Wg as routeError, ax as runSandboxedScript, hb as safeMerge, xx as safeSerialize, Cb as safeStringify, tx as searchJson, Px as selectBuiltinTools, _b as setByPath, vy as systemPromptHelpers, Kv as tokenize, $ as toolError, ny as unwrapSchema, Cl as useChat, e as z, Hg as zodError };