page-agent-sdk 2.20.1 → 2.22.0

package/dist/page-agent-sdk.js

@@ -22,11 +22,14 @@ function v(e) {
 	let t = e.model || "gpt-3.5-turbo", r = e.temperature, i = e.maxTokens, a = e.baseUrl;
 	if (e.mode === "direct") {
 		try {
-			typeof location < "u" && location.protocol === "https:" && ![
+			if (typeof location < "u" && location.protocol === "https:" && ![
 				"localhost",
 				"127.0.0.1",
 				"0.0.0.0"
-			].includes(location.hostname) && console.warn("[page-agent-sdk][proxyLlm] direct 模式在生产环境会泄露 apiKey,建议改用 proxy 模式");
+			].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 模式");
+			}
 		} catch {}
 		if (!e.apiKey) throw Error("[page-agent-sdk][proxyLlm] direct 模式需提供 apiKey(开发环境用真实 key)");
 		return new n({
@@ -14044,12 +14047,12 @@ function Hg(e, t) {
 	});
 }
 function Ug(e, t, n) {
-	let r = n?.message || String(n);
+	let r = n?.message || String(n), i = typeof t == "string" ? t : JSON.stringify(t);
 	return $({
 		code: "JSON_PARSE",
 		...e === void 0 ? {} : { path: e },
 		message: `value 不是合法 JSON:${r}`,
-		hint: `检查引号/逗号/括号是否闭合;字符串值需双引号包裹(如 '"dark"' 表示字符串 dark,数字直接写如 5);预览前 80 字符:${t.slice(0, 80)}`
+		hint: `检查引号/逗号/括号是否闭合;字符串值需双引号包裹(如 '"dark"' 表示字符串 dark,数字直接写如 5);预览前 80 字符:${i.slice(0, 80)}`
 	});
 }
 function Wg(e) {
@@ -14629,7 +14632,7 @@ function x_(e) {
 		return y_(e, t);
 	}
 	function de(e) {
-		return e.map((e) => {
+		return !E && !S ? [] : e.map((e) => {
 			let t = le(e), n = { role: t === "human" ? "user" : t === "ai" ? "assistant" : t }, r = typeof e.content == "string" ? e.content : JSON.stringify(e.content);
 			r && (n.content = r.length > v_ ? r.slice(0, v_) + `…(截断 ${r.length - v_} 字符)` : r);
 			let i = e.tool_calls;
@@ -15408,24 +15411,25 @@ function rv(e) {
 	return t;
 }
 function iv(e) {
-	let t = [], n = e.maxCheckpoints ?? 5, r = 1;
+	let t = [], n = e.maxCheckpoints ?? 5, r = 1, i, a;
 	return {
-		save(i) {
-			let a = rv(e.messages), o = {};
-			if (e.getData) o[""] = Q_(e.getData());
-			else for (let t of e.slotPaths ?? []) o[t] = Q_($_(window, t));
-			let s = {
+		save(o) {
+			let s = rv(e.messages), c = {};
+			if (e.getData) ((e.consumeDataDirty?.() ?? !0) || a === void 0) && (a = Q_(e.getData())), c[""] = a;
+			else for (let t of e.slotPaths ?? []) c[t] = Q_($_(window, t));
+			((e.vfsStore.consumeDirty?.() ?? !0) || i === void 0) && (i = Q_(e.vfsStore.files));
+			let l = {
 				id: r++,
-				label: i,
+				label: o,
 				timestamp: Date.now(),
-				messages: Q_(a),
-				windowVals: o,
-				vfs: Q_(e.vfsStore.files),
+				messages: Q_(s),
+				windowVals: c,
+				vfs: i,
 				todos: Q_(e.getTodos()),
-				messageCount: a.length
+				messageCount: s.length
 			};
-			for (t.push(s); t.length > n;) t.shift();
-			return s.id;
+			for (t.push(l); t.length > n;) t.shift();
+			return l.id;
 		},
 		list() {
 			return t.map((e) => ({
@@ -15448,15 +15452,15 @@ function iv(e) {
 					typeof n == "object" && n && tv(n, Q_(t));
 				}
 			} else for (let [e, t] of Object.entries(r.windowVals)) nv(e, Q_(t));
-			let i = e.vfsStore.files;
-			for (let e of Object.keys(i)) delete i[e];
-			return Object.assign(i, Q_(r.vfs)), e.todosMw.reset(Q_(r.todos)), !0;
+			let o = e.vfsStore.files;
+			for (let e of Object.keys(o)) delete o[e];
+			return Object.assign(o, Q_(r.vfs)), e.todosMw.reset(Q_(r.todos)), a = void 0, i = void 0, !0;
 		},
 		exportStack() {
 			return Q_(t);
 		},
 		importStack(e) {
-			t.length = 0;
+			t.length = 0, i = void 0, a = void 0;
 			let n = Array.isArray(e) ? e : [];
 			for (let e of n) e && typeof e == "object" && "id" in e && "messages" in e && typeof e.id == "number" && Number.isFinite(e.id) && t.push(e);
 			r = t.reduce((e, t) => Math.max(e, t.id), 0) + 1;
@@ -16383,9 +16387,21 @@ var _y = {
 	"3. 不确定某字段结构时,read({ jsonPath }) 返回含格式说明,字段以返回为准;",
 	"4. 写入若被 schema 校验拒绝(返回结构化错误含字段名与期望类型),按错误修正后重试,不要放弃;",
 	"5. 优先用 write 的 patch 增量改(只发改动,如 write({ value, patch:{ op, jsonPath } })),避免整体重传大 JSON 被截断。"
-].join("\n") }, yy = 15, by = 4e3;
-function xy(e, t) {
+].join("\n") }, yy = 15, by = 4e3, xy = /* @__PURE__ */ new WeakMap();
+function Sy(e, t) {
 	if (!e) return "";
+	let n = t ? `${t.maxKeys ?? ""}|${t.maxChars ?? ""}` : "";
+	if (typeof e == "object") {
+		let t = xy.get(e);
+		if (t && t.optsKey === n) return t.hint;
+	}
+	let r = Cy(e, t);
+	return typeof e == "object" && xy.set(e, {
+		optsKey: n,
+		hint: r
+	}), r;
+}
+function Cy(e, t) {
 	let n = my(e);
 	if (n) {
 		let r = t?.maxKeys ?? yy, i = t?.maxChars ?? by;
@@ -16399,36 +16415,36 @@ function xy(e, t) {
 }
 //#endregion
 //#region src/core/sdk/promptBuilder.ts
-var Sy = [
+var wy = [
 	"你是一个 JSON 操作助手。集成方声明了一个主数据对象(含 zod schema 校验),你通过专用工具安全地读写它来完成任务。",
 	"所有写操作都经范围控制(仅 schema 声明字段内)与 schema 校验(不合法会返回结构化错误而非写入),并自动留快照可回退。",
 	"大对象/数组优先用增量 patch(只发改动)而非整体重传,避免输出被截断。",
 	"---",
 	vy.reliableWriteRules
 ].join("\n\n");
-function Cy(e, t) {
+function Ty(e, t) {
 	if (!e) return "";
-	let n = xy(e.schema, t);
+	let n = Sy(e.schema, t);
 	return `\n\n## 可操作数据(字段以 read 工具返回的实际值为准)\n${e.description ? e.description + "\n" : ""}${n}`;
 }
-function wy(e) {
+function Ey(e) {
 	let t = e.appendReliableWriteRules !== !1;
-	return e.systemPrompt ? t ? e.systemPrompt + "\n\n---\n\n" + vy.reliableWriteRules : e.systemPrompt : Sy;
+	return e.systemPrompt ? t ? e.systemPrompt + "\n\n---\n\n" + vy.reliableWriteRules : e.systemPrompt : wy;
 }
 //#endregion
 //#region src/core/sdk/llmResolver.ts
-function Ty(e) {
+function Dy(e) {
 	return !!e && typeof e == "object" && typeof e.invoke == "function" && typeof e.stream == "function";
 }
-function Ey(e) {
+function Oy(e) {
 	let t = e.content;
 	return typeof t == "string" ? t : Array.isArray(t) ? t.map((e) => typeof e == "string" ? e : e?.text ?? "").join("") : String(t ?? "");
 }
-function Dy(e) {
+function ky(e) {
 	let t = e.summaryLlm ?? e.llm;
 	if (!t) return;
 	let r = e.summaryTemperature ?? .3, i = e.summaryMaxTokens ?? 1024, s = e.summaryTimeoutMs ?? 15e3, c;
-	if (Ty(t)) c = t;
+	if (Dy(t)) c = t;
 	else {
 		let a = t;
 		if (!a.apiKey) {
@@ -16450,26 +16466,26 @@ function Dy(e) {
 	return async (e) => {
 		let t = new AbortController(), n = setTimeout(() => t.abort(), s);
 		try {
-			return Ey(await c.invoke([new o("你是对话历史压缩助手。把下面按轮次索引的对话要点,改写成一段连贯、紧凑的中文摘要,保留关键事实、用户意图与已用工具,不要编造。直接输出摘要正文。"), new a(e)], { signal: t.signal })).trim();
+			return Oy(await c.invoke([new o("你是对话历史压缩助手。把下面按轮次索引的对话要点,改写成一段连贯、紧凑的中文摘要,保留关键事实、用户意图与已用工具,不要编造。直接输出摘要正文。"), new a(e)], { signal: t.signal })).trim();
 		} finally {
 			clearTimeout(n);
 		}
 	};
 }
-function Oy(e) {
-	let t = Ty(e.llm) ? void 0 : e.llm;
+function Ay(e) {
+	let t = Dy(e.llm) ? void 0 : e.llm;
 	return {
 		modelCaps: $g({
 			model: t?.model,
 			contextWindow: e.contextWindow ?? t?.contextWindow,
 			maxOutputTokens: e.maxOutputTokens ?? t?.maxOutputTokens
 		}),
-		summaryLlmInvoke: Dy(e)
+		summaryLlmInvoke: ky(e)
 	};
 }
 //#endregion
 //#region src/core/sdk/conflictManager.ts
-function ky(e) {
+function jy(e) {
 	let t = /* @__PURE__ */ U(null), n = 0;
 	function r(r) {
 		return new Promise((i) => {
@@ -16480,7 +16496,9 @@ function ky(e) {
 				id: ++n,
 				resolve: i
 			};
-			t.value = o, e?.()({
+			t.value = o;
+			let s = e?.();
+			s?.({
 				type: "conflict",
 				conflict: o
 			});
@@ -16498,7 +16516,7 @@ function ky(e) {
 }
 //#endregion
 //#region src/core/utils/id.ts
-function Ay() {
+function My() {
 	try {
 		if (typeof crypto < "u" && typeof crypto.randomUUID == "function") return crypto.randomUUID();
 	} catch {}
@@ -16506,57 +16524,59 @@ function Ay() {
 }
 //#endregion
 //#region src/core/backends/storage.ts
-var jy = "chat-sdk", My = 52428800, Ny = 4194304, Py = 10485760, Fy = .9, Iy = 500, Ly = 300, Ry = "__meta__", zy = "v:1", By = [
+var Ny = "chat-sdk", Py = 52428800, Fy = 4194304, Iy = 10485760, Ly = .9, Ry = 500, zy = 300, By = "__meta__", Vy = "v:1", Hy = [
 	"messages",
 	"vfs",
 	"todos",
-	"memory"
+	"memory",
+	"checkpoints",
+	"usage"
 ];
-function Vy(e) {
-	return e === "local" || e === "session" ? Ny : My;
+function Uy(e) {
+	return e === "local" || e === "session" ? Fy : Py;
 }
-function Hy(e) {
+function Wy(e) {
 	if (typeof e != "object" || !e) return !1;
 	let t = e;
 	return t.name === "QuotaExceededError" || t.name === "NS_ERROR_DOM_QUOTA_REACHED" || t.code === 22 || t.code === 1014;
 }
-function Uy(e, t, n, r) {
+function Gy(e, t, n, r) {
 	return [
-		zy,
+		Vy,
 		e,
 		t,
 		n,
 		r
 	].join("::");
 }
-function Wy(e, t, n) {
+function Ky(e, t, n) {
 	return [
-		zy,
+		Vy,
 		e,
 		t,
 		n
 	].join("::") + "::";
 }
-function Gy(e, t) {
+function qy(e, t) {
 	return [
-		zy,
+		Vy,
 		e,
 		t
 	].join("::") + "::";
 }
-function Ky(e) {
-	return [zy, e].join("::") + "::";
-}
-var qy = null;
 function Jy(e) {
-	qy ||= new TextEncoder();
+	return [Vy, e].join("::") + "::";
+}
+var Yy = null;
+function Xy(e) {
+	Yy ||= new TextEncoder();
 	try {
-		return qy.encode(JSON.stringify(e)).length;
+		return Yy.encode(JSON.stringify(e)).length;
 	} catch {
 		return 0;
 	}
 }
-function Yy(e, t, n) {
+function Zy(e, t, n) {
 	let r = e.reduce((e, t) => e + t.bytes, 0);
 	if (r <= t) return [];
 	let i = t * n, a = [...e].sort((e, t) => e.lastAccessed - t.lastAccessed), o = [];
@@ -16566,7 +16586,7 @@ function Yy(e, t, n) {
 	}
 	return o;
 }
-function Xy() {
+function Qy() {
 	let e = /* @__PURE__ */ new Map();
 	return {
 		async get(t) {
@@ -16586,7 +16606,7 @@ function Xy() {
 		}
 	};
 }
-function Zy(e) {
+function $y(e) {
 	return new Promise((t, n) => {
 		if (typeof indexedDB > "u") {
 			n(/* @__PURE__ */ Error("indexedDB 不可用"));
@@ -16647,7 +16667,7 @@ function Zy(e) {
 		}, r.onerror = () => n(r.error);
 	});
 }
-function Qy(e) {
+function eb(e) {
 	return {
 		async get(t) {
 			let n = e.getItem(t);
@@ -16681,12 +16701,12 @@ function Qy(e) {
 		}
 	};
 }
-function $y(e, t, n) {
+function tb(e, t, n) {
 	let r = (e.get(t) ?? Promise.resolve()).then(n, n);
 	return e.set(t, r.then(() => void 0, () => void 0)), r;
 }
-function eb(e = {}) {
-	let t = e.dbName ?? jy, n = e.backend ?? "indexed", r = e.maxBytes ?? Vy(n), i = e.maxBytesPerSession ?? Py, a = e.evictionWatermark ?? Fy, o = e.debounceMs ?? Iy, s = /* @__PURE__ */ new Set();
+function nb(e = {}) {
+	let t = e.dbName ?? Ny, n = e.backend ?? "indexed", r = e.maxBytes ?? Uy(n), i = e.maxBytesPerSession ?? Iy, a = e.evictionWatermark ?? Ly, o = e.debounceMs ?? Ry, s = /* @__PURE__ */ new Set();
 	function c(e) {
 		for (let t of s) try {
 			t(e);
@@ -16699,16 +16719,16 @@ function eb(e = {}) {
 		try {
 			if (n === "indexed") {
 				if (typeof indexedDB > "u") throw Error("indexedDB 不可用");
-				l = await Zy(t), d(!0);
+				l = await $y(t), d(!0);
 			} else if (n === "session") {
 				if (typeof sessionStorage > "u") throw Error("sessionStorage 不可用");
-				l = Qy(sessionStorage), d(!0);
+				l = eb(sessionStorage), d(!0);
 			} else if (n === "local") {
 				if (typeof localStorage > "u") throw Error("localStorage 不可用");
-				l = Qy(localStorage), d(!0);
-			} else l = Xy(), d(!1);
+				l = eb(localStorage), d(!0);
+			} else l = Qy(), d(!1);
 		} catch (e) {
-			l = Xy();
+			l = Qy();
 			let t = e instanceof Error ? e.message : String(e);
 			d(!1), Promise.resolve().then(() => c({
 				type: "degraded",
@@ -16718,10 +16738,10 @@ function eb(e = {}) {
 	})();
 	let p = /* @__PURE__ */ new Map(), m = /* @__PURE__ */ new Map(), h = /* @__PURE__ */ new Map();
 	function g(e, n, r, a) {
-		let o = Uy(t, r, a, Ry);
-		return $y(h, o, async () => {
+		let o = Gy(t, r, a, By);
+		return tb(h, o, async () => {
 			let t = async () => {
-				let t = await l.get(o), s = await l.get(e), u = s == null ? 0 : Jy(s), d = Jy(n), f = (t?.bytes ?? 0) + (d - u);
+				let t = await l.get(o), s = await l.get(e), u = s == null ? 0 : Xy(s), d = Xy(n), f = (t?.bytes ?? 0) + (d - u);
 				if (f > i) {
 					c({
 						type: "quota",
@@ -16743,12 +16763,12 @@ function eb(e = {}) {
 			try {
 				await t();
 			} catch (e) {
-				if (Hy(e) && !u) {
+				if (Wy(e) && !u) {
 					u = !0;
 					try {
 						await b();
 					} catch {}
-					l = Xy(), Promise.resolve().then(() => c({
+					l = Qy(), Promise.resolve().then(() => c({
 						type: "degraded",
 						reason: "存储配额超限(QuotaExceededError),已淘汰最旧会话并降级内存"
 					}));
@@ -16760,7 +16780,7 @@ function eb(e = {}) {
 		});
 	}
 	function _(e, n, r, i) {
-		let a = Uy(t, e, n, r), s = p.get(a);
+		let a = Gy(t, e, n, r), s = p.get(a);
 		s && s.resolve();
 		let c = m.get(a);
 		return c && clearTimeout(c), new Promise((t) => {
@@ -16787,15 +16807,15 @@ function eb(e = {}) {
 	function y() {
 		v ||= setTimeout(() => {
 			v = null, b();
-		}, Ly);
+		}, zy);
 	}
 	async function b() {
 		let e = [];
-		await l.scan(Ky(t), (t, n) => {
+		await l.scan(Jy(t), (t, n) => {
 			t.endsWith("::__meta__") && e.push(n);
 		});
-		let n = Yy(e, r, a);
-		for (let e of n) await l.clearPrefix(Wy(t, e.agentId, e.sessionId)), c({
+		let n = Zy(e, r, a);
+		for (let e of n) await l.clearPrefix(Ky(t, e.agentId, e.sessionId)), c({
 			type: "evicted",
 			agentId: e.agentId,
 			sessionId: e.sessionId,
@@ -16806,13 +16826,13 @@ function eb(e = {}) {
 		ready: f,
 		async listSessions(e) {
 			let n = [];
-			return await l.scan(Gy(t, e), (e, t) => {
+			return await l.scan(qy(t, e), (e, t) => {
 				e.endsWith("::__meta__") && n.push(t);
 			}), n.sort((e, t) => t.lastAccessed - e.lastAccessed);
 		},
 		async load(e, n) {
-			let r = Uy(t, e, n, Ry);
-			return await $y(h, r, async () => {
+			let r = Gy(t, e, n, By);
+			return await tb(h, r, async () => {
 				let i = await l.get(r);
 				if (!i) return;
 				let a = {
@@ -16821,8 +16841,8 @@ function eb(e = {}) {
 					todos: [],
 					memory: ""
 				};
-				for (let r of By) {
-					let i = await l.get(Uy(t, e, n, r));
+				for (let r of Hy) {
+					let i = await l.get(Gy(t, e, n, r));
 					i != null && (a[r] = i);
 				}
 				return i.lastAccessed = Date.now(), await l.set(r, i), a;
@@ -16830,7 +16850,7 @@ function eb(e = {}) {
 		},
 		async save(e, t, n) {
 			let r = [];
-			for (let i of By) n[i] !== void 0 && r.push(_(e, t, i, n[i]));
+			for (let i of Hy) n[i] !== void 0 && r.push(_(e, t, i, n[i]));
 			await Promise.all(r);
 		},
 		async flush() {
@@ -16844,10 +16864,10 @@ function eb(e = {}) {
 			})), c({ type: "flush" }), await b();
 		},
 		async deleteSession(e, n) {
-			await l.clearPrefix(Wy(t, e, n));
+			await l.clearPrefix(Ky(t, e, n));
 		},
 		async createSession(e, n, r) {
-			let i = r ?? Ay(), a = Date.now(), o = {
+			let i = r ?? My(), a = Date.now(), o = {
 				agentId: e,
 				sessionId: i,
 				createdAt: a,
@@ -16855,7 +16875,7 @@ function eb(e = {}) {
 				bytes: 0,
 				title: n
 			};
-			return await l.set(Uy(t, e, i, Ry), o), i;
+			return await l.set(Gy(t, e, i, By), o), i;
 		},
 		onEvent(e) {
 			s.add(e);
@@ -16870,15 +16890,102 @@ function eb(e = {}) {
 }
 //#endregion
 //#region src/core/sdk/optionsResolver.ts
-function tb(e) {
-	return e === void 0 || e === !1 ? null : typeof e == "string" ? eb({ backend: e }) : e.enabled === !1 ? null : eb(e);
+function rb(e) {
+	return e === void 0 || e === !1 ? null : typeof e == "string" ? nb({ backend: e }) : e.enabled === !1 ? null : nb(e);
 }
-function nb(e) {
+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 rb(e) {
+function sb(e) {
 	let t = /* @__PURE__ */ new Set(), n = (n) => {
 		if (n.type !== "approval_request") {
 			if (e) try {
@@ -16904,7 +17011,7 @@ function rb(e) {
 }
 //#endregion
 //#region src/core/sdk/contextPreset.ts
-var ib = {
+var cb = {
 	auto: {
 		summaryThresholdRatio: .5,
 		windowRatio: .4,
@@ -16932,7 +17039,7 @@ var ib = {
 		enableRecall: !0,
 		enableLLMSummary: !0
 	}
-}, ab = {
+}, lb = {
 	auto: ["describe_data", "read"],
 	conservative: ["describe_data"],
 	aggressive: ["describe_data", "read"],
@@ -16943,8 +17050,8 @@ var ib = {
 		"search_data"
 	]
 };
-function ob(e, t) {
-	let n = ib[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,
@@ -16954,7 +17061,7 @@ function ob(e, t) {
 }
 //#endregion
 //#region src/core/sdk/middlewareStack.ts
-var sb = {
+var db = {
 	dataHint: 10,
 	usageHints: 20,
 	todos: 30,
@@ -16971,29 +17078,29 @@ var sb = {
 	subagents: 140,
 	augmentSystem: 150
 };
-function cb(e) {
+function fb(e) {
 	return e.map((e, t) => ({
 		m: e,
 		i: t,
-		p: sb[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 lb = /* @__PURE__ */ new Set([
+var pb = /* @__PURE__ */ new Set([
 	"__proto__",
 	"constructor",
 	"prototype"
 ]);
-function ub(e) {
-	return e.split(".").some((e) => lb.has(e));
+function mb(e) {
+	return e.split(".").some((e) => pb.has(e));
 }
-function db(e, t) {
-	if (!(!t || typeof t != "object" || Array.isArray(t))) for (let n of Object.keys(t)) lb.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 fb(e, t) {
+function gb(e, t) {
 	if (!t) return e;
-	if (ub(t)) return;
+	if (mb(t)) return;
 	let n = t.split("."), r = e;
 	for (let e of n) {
 		if (r == null) return;
@@ -17001,8 +17108,8 @@ function fb(e, t) {
 	}
 	return r;
 }
-function pb(e, t, n) {
-	if (!t || ub(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];
@@ -17010,8 +17117,8 @@ function pb(e, t, n) {
 	}
 	i[r[r.length - 1]] = n;
 }
-function mb(e, t) {
-	if (!t || ub(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;
@@ -17020,10 +17127,10 @@ function mb(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 hb(e) {
+function yb(e) {
 	return e === void 0 ? void 0 : JSON.parse(JSON.stringify(e));
 }
-function gb(e) {
+function bb(e) {
 	if (typeof e != "string") return { parsed: e };
 	let t = e.trim();
 	if (!t) return { parsed: e };
@@ -17034,23 +17141,23 @@ function gb(e) {
 		return n ? { parseError: t } : { parsed: e };
 	}
 }
-function _b(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) => _b(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 vb(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) => vb(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] = vb(e[r], t - 1);
+	for (let r of Object.keys(e)) n[r] = Sb(e[r], t - 1);
 	return n;
 }
-function yb(e, t = Infinity) {
+function Cb(e, t = Infinity) {
 	let n = /* @__PURE__ */ new WeakSet(), r;
 	try {
 		r = JSON.stringify(e, (e, t) => {
@@ -17069,7 +17176,7 @@ function yb(e, t = Infinity) {
 	}
 	return r.length > t && (r = r.slice(0, t) + `\n…[已截断,原长度 ${r.length}]`), r;
 }
-function bb(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);
@@ -17077,32 +17184,32 @@ function bb(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 xb(e) {
-	return bb(yb(e)).toString(36);
+function Tb(e) {
+	return wb(Cb(e)).toString(36);
 }
-function Sb(e, t, n, r) {
-	if (t === "set") return n ? (pb(e, n, r), null) : "set 操作需要 jsonPath(整体替换请用 set_data)";
-	if (t === "remove") return n ? (mb(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 ? fb(e, n) : e;
-		return typeof t != "object" || !t || Array.isArray(t) ? `merge 目标${n ? `(${n})` : "(根)"}不是对象` : (db(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 ? fb(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 Cb(e, t, n, r) {
-	if (t === "set") pb(e, n, r);
-	else if (t === "remove") mb(e, n);
-	else if (t === "merge") db(n ? fb(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 ? fb(e, n) : e;
+		let t = n ? gb(e, n) : e;
 		Array.isArray(r) ? t.push(...r) : t.push(r);
 	}
 }
-function wb(e, t) {
-	typeof e == "object" && e && Tb(e, t);
+function Ob(e, t) {
+	typeof e == "object" && e && kb(e, t);
 }
-function Tb(e, t) {
+function kb(e, t) {
 	if (Array.isArray(e)) {
 		e.length = 0, Array.isArray(t) && e.push(...t);
 		return;
@@ -17111,7 +17218,7 @@ function Tb(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 Eb(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)",
@@ -17130,14 +17237,14 @@ function Eb(e, t, n = "") {
 				path: i,
 				from: e[a],
 				to: void 0
-			}) : r.push(...Eb(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(...Eb(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
@@ -17149,91 +17256,98 @@ function Eb(e, t, n = "") {
 	}
 	return r;
 }
-var Db = {
+var jb = {
 	largeResults: 4194304,
 	drafts: 2097152,
 	userFiles: 2097152
-}, Ob = [
+}, Mb = [
 	"largeResults",
 	"drafts",
 	"userFiles"
-], kb = .9;
-function Ab(e, t = {}) {
+], Nb = .9;
+function Pb(e, t = {}) {
 	let n = Object.create(null);
-	if (e) for (let [t, r] of Object.entries(e)) n[Pb(t)] = {
+	if (e) for (let [t, r] of Object.entries(e)) n[Rb(t)] = {
 		content: r,
-		updatedAt: Ib()
+		updatedAt: Bb()
 	};
 	let { persist: r } = t, i = t.maxBytes ?? 8388608, a = {
-		...Db,
+		...jb,
 		...t.poolBytes ?? {}
 	};
 	function o(e) {
-		let t = Pb(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 += Mb(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 Ob) {
+		for (let e of Mb) {
 			let t = a[e];
 			if (s(e) <= t) continue;
-			let r = t * kb, 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 (Nb(n) > i) {
-			let e = i * kb, t = Object.entries(n).sort((e, t) => e[1].updatedAt - t[1].updatedAt);
-			for (let [r] of t) if (delete n[r], Nb(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 = null;
-	function u() {
+	let l = !0, u = null;
+	function d() {
 		if (!r?.save) return;
 		let e = {};
 		for (let [t, r] of Object.entries(n)) e[t] = { ...r };
 		r.save(e);
 	}
-	function d() {
-		r?.save && (l && clearTimeout(l), l = setTimeout(() => {
-			l = null, u();
+	function f() {
+		r?.save && (u && clearTimeout(u), u = setTimeout(() => {
+			u = null, d();
 		}, 800));
 	}
-	let f = { files: new Proxy(n, {
-		set(e, t, n) {
-			let r = Reflect.set(e, t, n);
-			return r && (c(), d()), r;
-		},
-		deleteProperty(e, t) {
-			let n = Reflect.deleteProperty(e, t);
-			return n && d(), n;
-		}
-	}) };
-	return r && (f.hydrate = (e) => {
-		for (let [t, r] of Object.entries(e)) n[Pb(t)] = r;
-		c();
-	}, f.flush = () => {
-		l &&= (clearTimeout(l), null), u();
-	}, f.clear = () => {
+	let p = {
+		files: new Proxy(n, {
+			set(e, t, n) {
+				let r = Reflect.set(e, t, n);
+				return r && (l = !0, c(), f()), r;
+			},
+			deleteProperty(e, t) {
+				let n = Reflect.deleteProperty(e, t);
+				return n && (l = !0, f()), n;
+			}
+		}),
+		isDirty: () => l,
+		consumeDirty: () => {
+			let e = l;
+			return l = !1, e;
+		}
+	};
+	return r && (p.hydrate = (e) => {
+		for (let [t, r] of Object.entries(e)) n[Rb(t)] = r;
+		c(), l = !0;
+	}, p.flush = () => {
+		u &&= (clearTimeout(u), null), d();
+	}, p.clear = () => {
 		for (let e of Object.keys(n)) delete n[e];
-		d();
-	}), f;
+		f(), l = !0;
+	}), p;
 }
-var jb = null;
-function Mb(e) {
-	return jb ||= new TextEncoder(), jb.encode(e).length;
+var Fb = null;
+function Ib(e) {
+	return Fb ||= new TextEncoder(), Fb.encode(e).length;
 }
-function Nb(e) {
+function Lb(e) {
 	let t = 0;
-	for (let n of Object.values(e)) t += Mb(n.content);
+	for (let n of Object.values(e)) t += Ib(n.content);
 	return t;
 }
-function Pb(e) {
+function Rb(e) {
 	return e.replace(/^\/+/, "").replace(/\/+/g, "/");
 }
-function Fb(e) {
+function zb(e) {
 	let t = "";
 	for (let n = 0; n < e.length; n++) {
 		let r = e[n];
@@ -17241,10 +17355,10 @@ function Fb(e) {
 	}
 	return RegExp("^" + t + "$");
 }
-function Ib() {
+function Bb() {
 	return Date.now();
 }
-var Lb = [
+var Vb = [
 	"vfs_read",
 	"vfs_write",
 	"vfs_edit",
@@ -17254,10 +17368,10 @@ var Lb = [
 	"vfs_json_read",
 	"vfs_json_patch"
 ];
-function Rb(e) {
+function Hb(e) {
 	return [
 		r(async ({ path: t, offset: n, limit: r }) => {
-			let i = e.files[Pb(t)];
+			let i = e.files[Rb(t)];
 			if (!i) return $({
 				code: "NOT_FOUND",
 				path: t,
@@ -17286,9 +17400,9 @@ function Rb(e) {
 					hint: "jsonString=true 要求 content 是合法 JSON;检查引号/逗号/括号配对;或省略 jsonString 写纯文本"
 				});
 			}
-			return e.files[Pb(t)] = {
+			return e.files[Rb(t)] = {
 				content: n,
-				updatedAt: Ib()
+				updatedAt: Bb()
 			}, `已写入 ${t}(${n.length} 字符)${r ? "(JSON 校验通过)" : ""}`;
 		}, {
 			name: "vfs_write",
@@ -17300,7 +17414,7 @@ function Rb(e) {
 			})
 		}),
 		r(async ({ path: t, oldString: n, newString: r }) => {
-			let i = Pb(t), a = e.files[i];
+			let i = Rb(t), a = e.files[i];
 			if (!a) return $({
 				code: "NOT_FOUND",
 				path: t,
@@ -17330,7 +17444,7 @@ function Rb(e) {
 			}
 			return e.files[i] = {
 				content: a.content.replace(n, r),
-				updatedAt: Ib()
+				updatedAt: Bb()
 			}, `已替换 ${t} 中 1 处。`;
 		}, {
 			name: "vfs_edit",
@@ -17352,7 +17466,7 @@ function Rb(e) {
 		r(async ({ pattern: t }) => {
 			let n;
 			try {
-				n = Fb(t);
+				n = zb(t);
 			} catch (e) {
 				return $({
 					code: "GLOB_INVALID",
@@ -17381,7 +17495,7 @@ function Rb(e) {
 					details: { pattern: t }
 				});
 			}
-			let i = n ? [Pb(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) => {
@@ -17398,7 +17512,7 @@ function Rb(e) {
 			})
 		}),
 		r(async ({ path: t, jsonPath: n }) => {
-			let r = Pb(t), i = e.files[r];
+			let r = Rb(t), i = e.files[r];
 			if (!i) return $({
 				code: "NOT_FOUND",
 				path: t,
@@ -17417,7 +17531,7 @@ function Rb(e) {
 				});
 			}
 			if (n) {
-				let e = fb(a, n);
+				let e = gb(a, n);
 				return e === void 0 ? $({
 					code: "VFS_PATH_NOT_FOUND",
 					path: t,
@@ -17435,7 +17549,7 @@ function Rb(e) {
 			})
 		}),
 		r(async ({ path: t, patches: n }) => {
-			let r = Pb(t), i = e.files[r];
+			let r = Rb(t), i = e.files[r];
 			if (!i) return $({
 				code: "NOT_FOUND",
 				path: t,
@@ -17453,9 +17567,9 @@ function Rb(e) {
 					hint: "vfs_json_patch 要求文件内容是合法 JSON"
 				});
 			}
-			let o = hb(a), s = [];
+			let o = yb(a), s = [];
 			for (let e of n) {
-				let n = Sb(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,
@@ -17468,7 +17582,7 @@ function Rb(e) {
 			let c = JSON.stringify(o);
 			return e.files[r] = {
 				content: c,
-				updatedAt: Ib()
+				updatedAt: Bb()
 			}, `已对 ${t} 应用 ${n.length} 个 patch(影响 ${s.length} 处:${s.join(", ")}),文件现 ${c.length} 字符`;
 		}, {
 			name: "vfs_json_patch",
@@ -17489,17 +17603,17 @@ function Rb(e) {
 		})
 	];
 }
-function zb(e) {
+function Ub(e) {
 	return {
 		name: "vfs",
-		tools: Rb(e),
+		tools: Hb(e),
 		beforeAgent: () => ({ files: e.files })
 	};
 }
 //#endregion
 //#region src/core/tools/dataSlotQuery.ts
-var Bb = /[\w$-]/;
-function Vb(e) {
+var Wb = /[\w$-]/;
+function Gb(e) {
 	let t = [], n = e.trim(), r = +(n[0] === "$");
 	for (; r < n.length;) {
 		let e = n[r];
@@ -17510,7 +17624,7 @@ function Vb(e) {
 					continue;
 				}
 				let e = "";
-				for (; r < n.length && Bb.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",
@@ -17523,7 +17637,7 @@ function Vb(e) {
 				continue;
 			}
 			let e = "";
-			for (; r < n.length && Bb.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",
@@ -17579,7 +17693,7 @@ function Vb(e) {
 	}
 	return t;
 }
-function Hb(e) {
+function Kb(e) {
 	let t = [], n = 0, r = e.trim();
 	for (; n < r.length;) {
 		let e = r[n];
@@ -17624,7 +17738,7 @@ function Hb(e) {
 	}
 	return t;
 }
-var Ub = class {
+var qb = class {
 	toks;
 	item;
 	pos = 0;
@@ -17660,12 +17774,12 @@ var Ub = class {
 			return this.next(), e;
 		}
 		let e = this.operand(), t = this.peek();
-		return t === "==" || t === "!=" || t === "<" || t === "<=" || t === ">" || t === ">=" ? (this.next(), Kb(t, e, this.operand())) : Wb(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 Gb(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;
@@ -17675,10 +17789,10 @@ var Ub = class {
 		throw Error(`过滤表达式:未知操作数 '${e}'`);
 	}
 };
-function Wb(e) {
+function Jb(e) {
 	return !!e && e !== 0 && e !== "" && e !== null;
 }
-function Gb(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;
@@ -17686,7 +17800,7 @@ function Gb(e, t) {
 	}
 	return r;
 }
-function Kb(e, t, n) {
+function Xb(e, t, n) {
 	switch (e) {
 		case "==": return t === n;
 		case "!=": return t !== n;
@@ -17697,47 +17811,47 @@ function Kb(e, t, n) {
 		default: return !1;
 	}
 }
-function qb(e, t) {
-	return new Ub(Hb(e), t).parse();
+function Zb(e, t) {
+	return new qb(Kb(e), t).parse();
 }
-function Jb(e, t) {
+function Qb(e, t) {
 	return e ? `${e}.${t}` : String(t);
 }
-function Yb(e, t) {
+function $b(e, t) {
 	let n = [{
 		path: "",
 		value: e
 	}];
-	for (let e of Vb(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: Jb(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: Jb(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: Jb(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: Jb(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: Jb(e.path, n),
+						path: Qb(e.path, n),
 						value: e.value[n]
 					};
 					n === r && t.push(a), i(a);
@@ -17748,7 +17862,7 @@ function Yb(e, t) {
 			let e = (n) => {
 				if (n.value != null && typeof n.value == "object") for (let r of Object.keys(n.value)) {
 					let i = {
-						path: Jb(n.path, r),
+						path: Qb(n.path, r),
 						value: n.value[r]
 					};
 					t.push(i), e(i);
@@ -17757,16 +17871,16 @@ function Yb(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) => {
-				qb(e.filter, n) && t.push({
-					path: Jb(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];
-				qb(e.filter, i) && t.push({
-					path: Jb(r.path, n),
+				Zb(e.filter, i) && t.push({
+					path: Qb(r.path, n),
 					value: i
 				});
 			}
@@ -17775,7 +17889,7 @@ function Yb(e, t) {
 	}
 	return n;
 }
-function Xb(e, t) {
+function ex(e, t) {
 	let n = e.length, r = t.length;
 	if (!n) return r;
 	if (!r) return n;
@@ -17791,7 +17905,7 @@ function Xb(e, t) {
 	}
 	return i[r];
 }
-function Zb(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");
@@ -17801,11 +17915,11 @@ function Zb(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, Jb(l, t), String(t)));
-			else for (let t of Object.keys(e)) c(e[t], Jb(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 = Qb(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,
@@ -17816,7 +17930,7 @@ function Zb(e, t, n = {}) {
 			return;
 		}
 		if (a && u) {
-			let e = Qb(u, t, r, n.fuzzyThreshold ?? 2, s);
+			let e = nx(u, t, r, n.fuzzyThreshold ?? 2, s);
 			e && o.push({
 				path: l,
 				key: u,
@@ -17827,18 +17941,18 @@ function Zb(e, t, n = {}) {
 	};
 	return c(e, ""), o;
 }
-function Qb(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 = Xb(a, o);
+		let e = ex(a, o);
 		return e <= r ? r - e + 1 : null;
 	}
 	return null;
 }
-var $b = [
+var rx = [
 	"self.fetch = () => { throw new Error('fetch 已被沙箱禁用') }",
 	"self.XMLHttpRequest = function(){ throw new Error('XMLHttpRequest 已被沙箱禁用') }",
 	"self.importScripts = () => { throw new Error('importScripts 已被沙箱禁用') }",
@@ -17850,7 +17964,7 @@ var $b = [
 	"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"), ex = [
+].join("\n"), ix = [
 	{
 		re: /\bimport\s*\(/,
 		msg: "动态 import() 拉外网模块"
@@ -17876,8 +17990,8 @@ var $b = [
 		msg: "require() 拉模块"
 	}
 ];
-function tx(e, t, n = 3e3) {
-	for (let { re: e, msg: n } of ex) 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
@@ -17894,7 +18008,7 @@ function tx(e, t, n = 3e3) {
 					elapsedMs: Date.now() - i
 				});
 			}
-		}, s = $b + "\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);
@@ -17929,7 +18043,7 @@ function tx(e, t, n = 3e3) {
 }
 //#endregion
 //#region src/core/tools/dataOps.ts
-var nx = /* @__PURE__ */ new Set([
+var ox = /* @__PURE__ */ new Set([
 	"describe_data",
 	"get_data",
 	"set_data",
@@ -17941,11 +18055,11 @@ var nx = /* @__PURE__ */ new Set([
 	"diff_data",
 	"draft_write",
 	"draft_commit"
-]), rx = /* @__PURE__ */ new Set(["read", "write"]);
-function ix(e, t = "simple") {
-	return t === "advanced" ? e : t === "minimal" ? e.filter((e) => rx.has(e.name)) : e.filter((e) => !nx.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 ax(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,
@@ -17964,41 +18078,132 @@ function ax(e) {
 			hint: "主数据 bind 必须为对象/数组;叶子值请用对象包裹(如 {value:\"x\"})或集成方通过 sdk.setData 替换 bind"
 		})
 	};
-	let d = hb(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 ? db(t, u.data) : Tb(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: xb(t),
+		hash: Tb(t),
 		data: u.data
 	};
 }
-function ox(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 = {
+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;
+	}
+	let m = {
 		get: () => ({
 			schema: i,
 			bind: a,
 			description: o
 		}),
 		set: (e) => {
-			i = e.schema, a = e.bind, o = e.description ?? "主数据对象", s = ey(i), c.length = 0, u = void 0;
+			i = e.schema, a = e.bind, o = e.description ?? "主数据对象", s = ey(i), c.length = 0, u = void 0, p();
 		},
 		update: (e) => {
-			a = e, c.length = 0, u = void 0;
+			a = e, c.length = 0, u = void 0, p();
+		},
+		markDataDirty: p,
+		consumeDataDirty: () => {
+			let e = f;
+			return f = !1, e;
 		}
-	}, p = (e) => {
+	}, h = (e) => {
 		n.onAudit?.(e);
 	};
-	function m(e, t) {
-		let n = hb(a), r = c.length ? c[c.length - 1].id + 1 : 1;
+	function g(e, t) {
+		let n = yb(a), r = c.length ? c[c.length - 1].id + 1 : 1;
 		for (c.push({
 			id: r,
 			ts: Date.now(),
@@ -18008,14 +18213,14 @@ function ox(e, n = {}) {
 		}); c.length > l;) c.shift();
 		return r;
 	}
-	async function h(e, t, r) {
+	async function _(e, t, r) {
 		if (!t || t === "") return null;
-		let i = xb(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)。当前值:${yb(a, 400)}`
+			hint: `重新 read 拿最新值与 hash,基于最新值修改后再写入(传新的 expectedHash)。当前值:${Cb(a, 400)}`
 		});
 		let o = await n.onConflict({
 			op: e,
@@ -18025,21 +18230,21 @@ function ox(e, n = {}) {
 			expectedHash: t,
 			snapshotId: 0
 		});
-		if (o.action === "keep_external") return `已保留外部修改(未写入)。当前值:${yb(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 `无历史快照可回退(本次为首次操作)。当前值:${yb(a, 400)} (hash=${i})。请重新 read 再改或选「强制覆盖」。`;
+			if (!c.length) return `无历史快照可回退(本次为首次操作)。当前值:${Cb(a, 400)} (hash=${i})。请重新 read 再改或选「强制覆盖」。`;
 			let e = c[c.length - 1];
-			return wb(a, hb(e.value)), `已回退主数据到历史快照 #${e.id}[${e.op}]。当前值:${yb(a, 400)} (hash=${xb(a)})。请基于回退后的值重写或停止。`;
+			return Ob(a, yb(e.value)), p(), `已回退主数据到历史快照 #${e.id}[${e.op}]。当前值:${Cb(a, 400)} (hash=${Tb(a)})。请基于回退后的值重写或停止。`;
 		}
 		return null;
 	}
-	let g = r(async () => [`说明: ${o}`, "格式: 写入值需为 JSON,且通过声明的 schema 校验(校验失败时 set_data/edit_data 会返回结构化错误,含具体字段与期望类型)。"].join("\n"), {
+	let v = r(async () => [`说明: ${o}`, "格式: 写入值需为 JSON,且通过声明的 schema 校验(校验失败时 set_data/edit_data 会返回结构化错误,含具体字段与期望类型)。"].join("\n"), {
 		name: "describe_data",
 		description: "获取主数据的说明与格式要求。",
 		schema: t.object({})
-	}), _ = r(async ({ jsonPath: e }) => {
+	}), y = r(async ({ jsonPath: e }) => {
 		let t = e || "";
-		if (ub(t)) return $({
+		if (mb(t)) return $({
 			code: "PATH_UNSAFE",
 			message: `jsonPath "${t}" 含非法段(__proto__/constructor/prototype)`,
 			hint: "使用正常属性路径,如 components.0.text(数组索引用数字)"
@@ -18049,29 +18254,30 @@ function ox(e, n = {}) {
 			message: `get_data @ "${t}" 不在 schema 声明字段内(仅 schema 声明的 key 可读)`,
 			hint: "主数据仅暴露 schema 声明的字段;若需操作该字段,集成方需在 schema 中声明它"
 		});
-		let n = t ? fb(a, t) : a;
+		let n = t ? gb(a, t) : a;
 		t || (n = ay(n, s));
-		let r = xb(a);
-		return u = r, n === void 0 ? `主数据${t ? ` @ ${t}` : ""} = (undefined) (hash=${r})` : `主数据${t ? ` @ ${t}` : ""} = ${yb(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)。",
 		schema: t.object({ jsonPath: t.string().optional().describe("相对主数据根的点号路径(如 components.0.text);不传则读整个主数据") })
-	}), v = r(async ({ value: e, expectedHash: t }) => {
-		let n = await h("set", t || (d ? u : void 0));
+	}), b = r(async ({ value: e, expectedHash: t }) => {
+		let n = await _("set", t || (d ? u : void 0));
 		if (n !== null) return n;
-		let r = gb(e);
+		let r = bb(e);
 		if (r.parseError) return Ug("", e, r.parseError);
-		let o = ax({
+		let o = lx({
 			bindRef: a,
 			value: r.parsed,
 			schema: i,
 			allowKeys: s,
 			snapshots: c,
 			maxSnapshots: l,
-			audit: p
+			audit: h,
+			onWrite: p
 		});
-		return o.ok ? (u = o.hash, `已设置主数据 = ${yb(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:{...}})局部合并。",
@@ -18079,55 +18285,53 @@ function ox(e, n = {}) {
 			value: t.unknown().describe("JSON 对象(推荐直传,如 {title:\"x\"}),或 JSON 字符串;需符合 schema"),
 			expectedHash: t.string().optional().describe("乐观锁:改前 read/get 返回的 hash;传入则校验,不一致拒绝写入防覆盖。不传则自动用你最后读到的 hash(autoLock)")
 		})
-	}), y = r(async (e) => {
+	}), x = r(async (e) => {
 		let t = e.op ?? e.patch?.op, n = e.jsonPath ?? e.patch?.jsonPath, r = e.value ?? e.patch?.value, o = e.expectedHash;
 		if (!t) return $({
 			code: "MISSING_VALUE",
 			message: "edit_data 需要 op(set/remove/merge/append)",
 			hint: "顶层 op 或 patch.op 至少传一个"
 		});
-		let c = n || "";
-		if (ub(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 h("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 = gb(r);
-			if (e.parseError) return Ug("", r, e.parseError);
-			f = e.parsed;
-		}
-		let g = hb(a), _ = Sb(g, t, c, f);
-		if (_) return $({
-			code: "PATCH_FAILED",
-			message: _,
-			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 v = i.safeParse(g);
-		return v.success ? (m("edit"), Cb(a, t, c, f), p({
+		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 = xb(a), `已 edit 主数据(${t}${c ? " @ " + c : ""})。当前值:${yb(a, 600)} (新 hash=${xb(a)})`) : Hg("", v.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,默认开)防\"基于过期值覆盖\"。",
@@ -18152,13 +18356,13 @@ function ox(e, n = {}) {
 				value: t.unknown().optional()
 			}).optional().describe("容错:误传 write 的 {patch:{op,jsonPath,value}} 形式时从此取值(顶层优先)。正常用顶层 op/jsonPath/value 即可")
 		})
-	}), b = r(async ({ jsonPath: e, expectedHash: t }) => {
+	}), S = r(async ({ jsonPath: e, expectedHash: t }) => {
 		if (!e) return $({
 			code: "MISSING_VALUE",
 			message: "delete_data 需要 jsonPath 指定要删的子路径(主数据整体不可删,用 set_data 整体替换)",
 			hint: "如 jsonPath:\"components.0\" 删数组首项"
 		});
-		if (ub(e)) return $({
+		if (mb(e)) return $({
 			code: "PATH_UNSAFE",
 			message: `jsonPath "${e}" 含非法段`,
 			hint: "使用正常属性路径"
@@ -18168,15 +18372,15 @@ function ox(e, n = {}) {
 			message: `delete_data @ "${e}" 不在 schema 声明字段内`,
 			hint: "仅 schema 声明的 key 可删"
 		});
-		let n = await h("delete", t || (d ? u : void 0));
+		let n = await _("delete", t || (d ? u : void 0));
 		if (n !== null) return n;
-		m("delete");
-		let r = mb(a, e);
-		return p({
+		g("delete");
+		let r = vb(a, e);
+		return p(), h({
 			op: "delete",
 			detail: e,
 			timestamp: Date.now()
-		}), u = xb(a), r ? `已删除主数据 @ ${e}` : `主数据 @ ${e} 不存在(无需删除)`;
+		}), u = Tb(a), r ? `已删除主数据 @ ${e}` : `主数据 @ ${e} 不存在(无需删除)`;
 	}, {
 		name: "delete_data",
 		description: "删除主数据的某个子路径(jsonPath)。主数据整体不可删(用 set_data 整体替换)。expectedHash(可选):改前 read/get 返回的 hash;不传时自动用你最后读到的 hash(autoLock,默认开)防\"基于过期值删除\"。",
@@ -18184,11 +18388,11 @@ function ox(e, n = {}) {
 			jsonPath: t.string().describe("要删除的子路径(相对主数据根,如 components.0)"),
 			expectedHash: t.string().optional().describe("乐观锁:改前 read/get 返回的 hash;传入则校验,不一致拒绝删除防覆盖")
 		})
-	}), x = r(async ({ label: e }) => `已为主数据创建快照 #${m("manual", e)}${e ? `(${e})` : ""}。可用 list_data_snapshots 查看、restore_data 回退。`, {
+	}), C = r(async ({ label: e }) => `已为主数据创建快照 #${g("manual", e)}${e ? `(${e})` : ""}。可用 list_data_snapshots 查看、restore_data 回退。`, {
 		name: "snapshot_data",
 		description: "为主数据手动创建一个命名快照(检查点)。set/edit/delete 也会自动存快照。",
 		schema: t.object({ label: t.string().optional().describe("可选的快照标签,便于识别") })
-	}), S = r(async () => {
+	}), w = r(async () => {
 		if (!c.length) return "无快照。set/edit/delete 会自动存快照,也可用 snapshot_data 手动创建检查点。";
 		let e = c.map((e) => {
 			let t = JSON.stringify(e.value ?? "").length, n = new Date(e.ts).toLocaleTimeString("zh-CN", { hour12: !1 });
@@ -18199,7 +18403,7 @@ function ox(e, n = {}) {
 		name: "list_data_snapshots",
 		description: "列出主数据的快照时间线(序号、操作类型、标签、大小)。",
 		schema: t.object({})
-	}), C = r(async ({ id: e }) => {
+	}), T = r(async ({ id: e }) => {
 		if (!c.length) return $({
 			code: "NO_SNAPSHOT",
 			message: "无快照可回退",
@@ -18212,11 +18416,11 @@ function ox(e, n = {}) {
 			hint: "用 list_data_snapshots 查看可用快照序号"
 		});
 		let n = i.safeParse(t.value);
-		return n.success ? (wb(a, hb(t.value)), p({
+		return n.success ? (Ob(a, yb(t.value)), p(), h({
 			op: "restore",
 			detail: `#${t.id}`,
 			timestamp: Date.now()
-		}), u = xb(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 可能已变更;该快照已过期,选其他快照或重新设置",
@@ -18226,7 +18430,7 @@ function ox(e, n = {}) {
 		name: "restore_data",
 		description: "把主数据回退到某个快照(就地还原,保留响应式)。不传 id 则回退最近一次(快速回退)。可用 list_data_snapshots 查看快照列表。",
 		schema: t.object({ id: t.number().int().optional().describe("指定快照序号;不传则回退最近一次") })
-	}), w = r(async ({ id: e, jsonPath: t }) => {
+	}), E = r(async ({ id: e, jsonPath: t }) => {
 		if (!c.length) return $({
 			code: "NO_SNAPSHOT",
 			message: "无历史快照可查看",
@@ -18238,9 +18442,9 @@ function ox(e, n = {}) {
 			message: `未找到快照 #${e}`,
 			hint: "不传 id 查看最近一次;或用 list_data_snapshots(advanced) 查看可用序号"
 		});
-		let r = hb(n.value), a = t || "";
+		let r = yb(n.value), a = t || "";
 		if (a) {
-			if (ub(a)) return $({
+			if (mb(a)) return $({
 				code: "PATH_UNSAFE",
 				message: `jsonPath "${a}" 含非法段`,
 				hint: "使用正常属性路径"
@@ -18250,11 +18454,11 @@ function ox(e, n = {}) {
 				message: `history_data @ "${a}" 不在 schema 声明字段内`,
 				hint: "仅 schema 声明的 key 可读"
 			});
-			r = fb(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}` : ""} = ${yb(r)}`;
+		return `快照 #${n.id}[${n.op}]${n.label ? `(${n.label})` : ""}${a ? ` @ ${a}` : ""} = ${Cb(r)}`;
 	}, {
 		name: "history_data",
 		description: "只读查看某次快照(默认最近一次)的内容,不回退当前主数据。看上一版长啥样而不影响当前(冲突诊断/verify 自纠/用户问\"刚才改了啥\")。可选 id 指定快照序号、jsonPath 只看子路径(按 schema 投影)。",
@@ -18262,7 +18466,7 @@ function ox(e, n = {}) {
 			id: t.number().int().optional().describe("快照序号;不传则最近一次"),
 			jsonPath: t.string().optional().describe("只看快照的某子路径(相对主数据根);不传则整个快照")
 		})
-	}), T = r(async ({ expr: e, limit: t }) => {
+	}), D = r(async ({ expr: e, limit: t }) => {
 		if (typeof a != "object" || !a) return $({
 			code: "NOT_OBJECT",
 			message: `主数据不是对象/数组,无法查询(当前为 ${a === void 0 ? "undefined" : typeof a})`,
@@ -18270,7 +18474,7 @@ function ox(e, n = {}) {
 		});
 		let n = s ? ay(a, s) : a, r;
 		try {
-			r = Yb(n, e);
+			r = $b(n, e);
 		} catch (t) {
 			return $({
 				code: "JSONPATH_SYNTAX",
@@ -18279,7 +18483,7 @@ function ox(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":${yb(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",
@@ -18288,19 +18492,19 @@ function ox(e, n = {}) {
 			expr: t.string().describe("JSONPath 表达式,如 $.components[?(@.type==\"card\" && @.price<100)] 或 $..title(递归找所有 title)"),
 			limit: t.number().int().min(1).max(200).optional().describe("返回结果上限,默认 50")
 		})
-	}), E = r(async ({ query: e, mode: t, fuzzyThreshold: n, matchKey: r, limit: i }) => {
+	}), O = r(async ({ query: e, mode: t, fuzzyThreshold: n, matchKey: r, limit: i }) => {
 		if (a == null) return $({
 			code: "EMPTY",
 			message: "主数据为空,无可搜索内容"
 		});
 		try {
-			let o = Zb(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 yb({
+			return Cb({
 				matched: o.length,
 				results: o
 			});
@@ -18326,7 +18530,7 @@ function ox(e, n = {}) {
 			matchKey: t.boolean().optional().describe("是否同时匹配 key 名,默认 true"),
 			limit: t.number().int().min(1).max(200).optional().describe("返回上限,默认 50")
 		})
-	}), D = r(async ({ script: e, mode: t, jsonPath: n }) => {
+	}), k = r(async ({ script: e, mode: t, jsonPath: n }) => {
 		if (e.length > 8e3) return $({
 			code: "SCRIPT_TOO_LARGE",
 			message: `脚本过长(${e.length} 字符,上限 8000)`,
@@ -18339,44 +18543,47 @@ function ox(e, n = {}) {
 				message: `eval_script @ "${r}" 不在 schema 声明字段内`,
 				hint: "仅 schema 声明的 key 可作为子树"
 			});
-			if (o = fb(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 = hb(o), l = await tx(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 = hb(a), n = Sb(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 ? (m("edit", "eval_transform_subtree"), Cb(a, "set", r, e), p({
+				return t.ok ? (h({
 					op: "edit",
 					detail: `eval_transform_subtree @ ${r}`,
 					timestamp: Date.now()
-				}), u = xb(a), `已通过脚本 transform 子树 @ ${r} 更新(耗时 ${l.elapsedMs}ms)。当前值: ${yb(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 $({
@@ -18384,77 +18591,43 @@ function ox(e, n = {}) {
 					message: `主数据 bind 为原始类型(${a === null ? "null" : typeof a}),eval transform(patches) 无法就地替换`,
 					hint: "主数据 bind 必须为对象/数组;叶子值请用对象包裹或集成方通过 sdk.setData 替换 bind"
 				});
-				let t = e.patches, n = hb(a), r = [];
-				for (let e = 0; e < t.length; e++) {
-					let a = t[e], o = a.jsonPath || "";
-					if (ub(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 = gb(a.value);
-						if (t.parseError) return Ug(`patches[${e}]`, a.value, t.parseError);
-						l = t.parsed;
-					}
-					let u = Sb(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"
 				});
-				m("edit", "eval_transform");
-				for (let e of r) Cb(a, e.op, e.jp, e.value);
-				return p({
+				return t.ok ? (h({
 					op: "edit",
-					detail: `eval_transform(${r.length} patches)`,
+					detail: `eval_transform(${t.applied.length} patches)`,
 					timestamp: Date.now()
-				}), u = xb(a), `已通过脚本 transform(patches) 更新主数据(${r.length} 个 patch,耗时 ${l.elapsedMs}ms)。当前值: ${yb(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"
-			}) : (m("edit", "eval_transform"), t.data !== null && typeof t.data == "object" && (s ? db(a, t.data) : Tb(a, t.data)), p({
+			}) : (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 = xb(a), `已通过脚本 transform 更新主数据(耗时 ${l.elapsedMs}ms)。当前值: ${yb(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 yb({
+		return Cb({
 			ok: !0,
-			result: l.result,
-			elapsedMs: l.elapsedMs
+			result: f.result,
+			elapsedMs: f.elapsedMs
 		});
 	}, {
 		name: "eval_script",
@@ -18464,13 +18637,13 @@ function ox(e, n = {}) {
 			mode: t.enum(["query", "transform"]).optional().describe("query=只读返回结果(默认),transform=校验后落地为新值"),
 			jsonPath: t.string().optional().describe("子树模式:仅对 jsonPath 指向的子树执行(降低大 JSON 成本);transform 时返回值作为该子树新值")
 		})
-	}), O = r(async ({ jsonPath: e, jsonPaths: t, fields: r, depth: c, offset: l, limit: d }) => {
-		let f = xb(a);
+	}), A = r(async ({ jsonPath: e, jsonPaths: t, fields: r, depth: c, offset: l, limit: d }) => {
+		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 ? fb(a, t) : a;
+				let o = t ? gb(a, t) : a;
 				if (!t) o = ay(o, s);
 				else if (s) {
 					let e = ry(i, t);
@@ -18482,12 +18655,12 @@ function ox(e, n = {}) {
 				} catch (e) {
 					return `- ${t}: [READ_INTERCEPT: ${e.message}]`;
 				}
-				return r && r.length && (l = _b(l, r)), c != null && (l = vb(l, c)), l === void 0 ? `- ${t} = (undefined)` : `- ${t} = ${yb(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 (ub(p)) return $({
+		if (mb(p)) return $({
 			code: "PATH_UNSAFE",
 			message: `jsonPath "${p}" 含非法段(__proto__/constructor/prototype)`,
 			hint: "使用正常属性路径,如 components.0.text(数组索引数字)"
@@ -18497,7 +18670,7 @@ function ox(e, n = {}) {
 			message: `read @ "${p}" 不在 schema 声明字段内`,
 			hint: "主数据仅暴露 schema 声明的字段;若需操作该字段,集成方需在 schema 中声明它"
 		});
-		let m = p ? fb(a, p) : a;
+		let m = p ? gb(a, p) : a;
 		if (!p) m = ay(m, s);
 		else if (s) {
 			let e = ry(i, p);
@@ -18512,13 +18685,13 @@ function ox(e, n = {}) {
 				message: `read 拦截器抛错: ${e.message}`
 			});
 		}
-		r && r.length && (h = _b(h, r)), c != null && (h = vb(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} = ${yb(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} = ${yb(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 拦截器对返回值脱敏/派生。",
@@ -18530,51 +18703,51 @@ function ox(e, n = {}) {
 			offset: t.number().int().min(0).optional().describe("数组分页起始偏移(仅当读取目标是数组时生效,默认 0),配合 limit 分页读大数组"),
 			limit: t.number().int().min(1).max(200).optional().describe("数组分页每页条数(默认 50,上限 200;仅数组时生效),返回切片 + total/hasMore")
 		})
-	}), k = r(async ({ value: e, patch: t, patches: r, del: o, dryRun: f }) => {
-		let g = "set";
-		o ? g = "delete" : (r && r.length || t) && (g = "edit");
-		let _ = t?.value === void 0 ? e : t.value, v;
+	}), j = r(async ({ value: e, patch: t, patches: r, del: o, dryRun: f }) => {
+		let m = "set";
+		o ? m = "delete" : (r && r.length || t) && (m = "edit");
+		let v = t?.value === void 0 ? e : t.value, y;
 		if (n.interceptors?.write) try {
-			let i = g === "delete" ? {
+			let i = m === "delete" ? {
 				del: !0,
 				jsonPath: t?.jsonPath
-			} : g === "edit" && r && r.length ? { patches: r } : g === "edit" ? {
+			} : m === "edit" && r && r.length ? { patches: r } : m === "edit" ? {
 				op: t.op ?? "set",
 				jsonPath: t.jsonPath || "",
-				value: _
+				value: v
 			} : e, o = n.interceptors.write(i, a);
 			if (o && typeof o == "object" && "error" in o) return $({
 				code: "WRITE_INTERCEPT",
 				message: `write 拦截器拒绝: ${o.error}`
 			});
-			if (g !== "delete") if (g === "edit" && r && r.length) v = o && Array.isArray(o) ? o : r;
-			else if (g === "edit") if (o && typeof o == "object" && "op" in o && "jsonPath" in o) {
+			if (m !== "delete") if (m === "edit" && r && r.length) y = o && Array.isArray(o) ? o : r;
+			else if (m === "edit") if (o && typeof o == "object" && "op" in o && "jsonPath" in o) {
 				let e = o;
-				e.op && (t.op = e.op), e.jsonPath !== void 0 && (t.jsonPath = e.jsonPath), _ = e.value;
-			} else _ = o;
-			else _ = o;
+				e.op && (t.op = e.op), e.jsonPath !== void 0 && (t.jsonPath = e.jsonPath), v = e.value;
+			} else v = o;
+			else v = o;
 		} catch (e) {
 			return $({
 				code: "WRITE_INTERCEPT",
 				message: `write 拦截器抛错: ${e.message}`
 			});
 		}
-		let y = d ? u : void 0;
-		if (f && y !== void 0) {
-			let e = xb(a);
-			if (e !== y) return $({
+		let b = d ? u : void 0;
+		if (f && b !== void 0) {
+			let e = Tb(a);
+			if (e !== b) return $({
 				code: "VERSION_CONFLICT",
-				message: `dryRun 预检发现乐观锁冲突: expectedHash=${y} 当前 hash=${e}(主数据在你 read 后被改)`,
+				message: `dryRun 预检发现乐观锁冲突: expectedHash=${b} 当前 hash=${e}(主数据在你 read 后被改)`,
 				hint: "重新 read 拿最新 hash 再预检/写"
 			});
 		}
-		if (g === "delete") {
+		if (m === "delete") {
 			if (!t?.jsonPath) return $({
 				code: "MISSING_VALUE",
 				message: "delete 需要 patch.jsonPath 指定要删的子路径(主数据整体不可删,用 write(value) 整体替换)",
 				hint: "如 patch:{jsonPath:\"components.0\"}, del:true"
 			});
-			if (ub(t.jsonPath)) return $({
+			if (mb(t.jsonPath)) return $({
 				code: "PATH_UNSAFE",
 				message: `jsonPath "${t.jsonPath}" 含非法段`,
 				hint: "使用正常属性路径"
@@ -18584,95 +18757,66 @@ function ox(e, n = {}) {
 				message: `write delete @ "${t.jsonPath}" 不在 schema 声明字段内`,
 				hint: "仅 schema 声明的 key 可删"
 			});
-			let e = await h("delete", y);
+			let e = await _("delete", b);
 			if (e !== null) return e;
 			if (f) {
-				let e = hb(a);
-				return mb(e, t.jsonPath) ? `dryRun(delete): 将删除 @ ${t.jsonPath}。预览剩余:${yb(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} 不存在(无需删除)。未实际写入。`;
 			}
-			m("delete");
-			let n = mb(a, t.jsonPath);
-			return p({
+			g("delete");
+			let n = vb(a, t.jsonPath);
+			return p(), h({
 				op: "delete",
 				detail: t.jsonPath,
 				timestamp: Date.now()
-			}), u = xb(a), n ? `已删除主数据 @ ${t.jsonPath}` : `主数据 @ ${t.jsonPath} 不存在(无需删除)`;
+			}), u = Tb(a), n ? `已删除主数据 @ ${t.jsonPath}` : `主数据 @ ${t.jsonPath} 不存在(无需删除)`;
 		}
-		if (g === "edit") {
+		if (m === "edit") {
 			if (typeof a != "object" || !a) return $({
 				code: "NOT_OBJECT",
 				message: `edit 仅适用于对象/数组主数据,当前是 ${a === void 0 ? "undefined" : typeof a}`,
 				hint: "叶子用 write(value) 整体设置"
 			});
-			let e = await h("edit", y);
+			let e = await _("edit", b);
 			if (e !== null) return e;
-			let n = v || (r && r.length ? r : [{
+			let n = y || (r && r.length ? r : [{
 				op: t.op ?? "set",
 				jsonPath: t.jsonPath || "",
-				value: _
-			}]), o = hb(a), c = [];
-			for (let e = 0; e < n.length; e++) {
-				let t = n[e], r = t.jsonPath || "";
-				if (ub(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, 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 = gb(t.value);
-					if (n.parseError) return Ug(`patches[${e}]`, t.value, n.parseError);
-					l = n.parsed;
-				}
-				let u = Sb(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)。预览结果:${yb(o, 600)}。未实际写入、未入快照。`;
-			m("edit");
-			for (let e of c) Cb(a, e.op, e.jp, e.value);
-			return p({
+				value: v
+			}]), 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 = xb(a), `已 write(edit) 主数据(${c.length} 个 patch)。当前值:${yb(a, 600)} (新 hash=${xb(a)})`;
+			}), u = Tb(a), `已 write(edit) 主数据(${o.applied.length} 个 patch)。当前值:${Cb(a, 600)} (新 hash=${Tb(a)})`) : o.error;
 		}
-		let b = gb(_);
-		if (b.parseError) return Ug("", _, b.parseError);
-		let x = await h("set", y);
-		if (x !== null) return x;
-		let S = ax({
+		let x = bb(v);
+		if (x.parseError) return Ug("", v, x.parseError);
+		let S = await _("set", b);
+		if (S !== null) return S;
+		let C = lx({
 			bindRef: a,
-			value: b.parsed,
+			value: x.parsed,
 			schema: i,
 			allowKeys: s,
 			snapshots: c,
 			maxSnapshots: l,
-			audit: p,
-			dryRun: f
+			audit: h,
+			dryRun: f,
+			onWrite: p
 		});
-		return S.ok ? f ? `dryRun(set): schema 校验通过。预览新值:${yb(S.data, 600)}。未实际写入、未入快照。` : (u = S.hash, `已 write(set) 主数据 = ${yb(S.data, 600)} (新 hash=${S.hash})${s ? "(白名单模式:仅更新 schema 声明字段,未声明字段保留)" : ""}`) : S.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)。",
@@ -18701,9 +18845,9 @@ function ox(e, n = {}) {
 			del: t.boolean().optional().describe("true 则删除 patch.jsonPath 指定的子路径(等价 delete_data)"),
 			dryRun: t.boolean().optional().describe("预检模式:走完整校验链(schema + 白名单 + patch 应用到 clone)但不落盘、不入快照,返回预览。四意图(value/patch/patches/del)均支持;乐观锁冲突照常检测(返回 VERSION_CONFLICT 不挂起)")
 		})
-	}), A = r(async ({ jsonPath: e }) => {
+	}), M = r(async ({ jsonPath: e }) => {
 		let t = e || "", n = t ? ry(i, t) : i;
-		return n ? `schema${t ? ` @ ${t}` : ""} = ${yb(dy(n))}` : $({
+		return n ? `schema${t ? ` @ ${t}` : ""} = ${Cb(dy(n))}` : $({
 			code: "PATH_DENIED",
 			message: `schema @ "${t}" 不存在`,
 			hint: "jsonPath 需在 schema 声明字段内(用 read() 不传 jsonPath 查看顶层字段)"
@@ -18712,12 +18856,12 @@ function ox(e, n = {}) {
 		name: "schema_data",
 		description: "查看主数据(或子路径)的字段约束:类型/min/max/enum/必填/默认值/嵌套 shape。写前查约束,避免写错重试。不传 jsonPath 查根;传子路径(如 components.0)查该位置约束。",
 		schema: t.object({ jsonPath: t.string().optional().describe("要查约束的子路径;不传查根 schema") })
-	}), j = r(async ({ snapshotId: e, against: t }) => {
+	}), ee = r(async ({ snapshotId: e, against: t }) => {
 		let n = t != null, r, i;
 		if (n) {
 			let e = t;
 			if (typeof e == "string") {
-				let t = gb(e);
+				let t = bb(e);
 				t.parseError || (e = t.parsed);
 			}
 			r = e, i = "against";
@@ -18735,8 +18879,8 @@ function ox(e, n = {}) {
 			});
 			r = t.value, i = `快照 #${t.id}`;
 		}
-		let o = s ? ay(a, s) : a, l = Eb(r, hb(o));
-		return l.length ? `差异(当前 vs ${i},共 ${l.length} 处):\n${l.map((e) => `  ${e.path}: ${yb(e.from)} → ${yb(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 互斥,传则忽略快照)。",
@@ -18744,7 +18888,7 @@ function ox(e, n = {}) {
 			snapshotId: t.number().int().optional().describe("对比的快照序号;不传则最近一次"),
 			against: t.unknown().optional().describe("对比的一段 JSON 值(与 snapshotId 互斥;传则忽略快照)")
 		})
-	}), M = [];
+	}), N = [];
 	if (n.vfsStore) {
 		let e = n.vfsStore, o = (e) => `drafts/${e}.json`, d = r(({ draftId: t, chunk: n, mode: r }) => {
 			let i = o(t), a = e.files[i], s = r === "append" && a, c = s ? a.content + n : n;
@@ -18785,27 +18929,26 @@ function ox(e, n = {}) {
 					}
 				});
 			}
-			let f = ax({
+			let f = lx({
 				bindRef: a,
 				value: d,
 				schema: i,
 				allowKeys: s,
 				snapshots: c,
 				maxSnapshots: l,
-				audit: p,
-				op: "draft_commit"
+				audit: h,
+				op: "draft_commit",
+				onWrite: p
 			});
-			return f.ok ? (u = f.hash, delete e.files[n], `已 draft_commit 草稿 "${t}" → 主数据 = ${yb(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)。",
 			schema: t.object({ draftId: t.string().describe("要提交的草稿标识(对应 draft_write 的 draftId)") })
 		});
-		M.push(d, f);
+		N.push(d, f);
 	}
-	let ee = [
-		g,
-		_,
+	let P = [
 		v,
 		y,
 		b,
@@ -18820,19 +18963,21 @@ function ox(e, n = {}) {
 		k,
 		A,
 		j,
-		...M
+		M,
+		ee,
+		...N
 	];
-	return Object.defineProperty(ee, "controller", {
-		value: f,
+	return Object.defineProperty(P, "controller", {
+		value: m,
 		enumerable: !1,
 		configurable: !1,
 		writable: !1
-	}), ee;
+	}), P;
 }
 //#endregion
 //#region src/core/tools/fetchDoc.ts
-var sx = 3e4, cx = [r(async ({ url: e, as: t }) => {
-	let n = new AbortController(), r = setTimeout(() => n.abort(), sx);
+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",
@@ -18849,7 +18994,7 @@ var sx = 3e4, cx = [r(async ({ url: e, as: t }) => {
 		].join("\n");
 	} catch (t) {
 		let r = t?.message || String(t);
-		return n.signal.aborted ? `获取失败:请求超时(${sx}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);
 	}
@@ -18860,7 +19005,7 @@ var sx = 3e4, cx = [r(async ({ url: e, as: t }) => {
 		url: t.string().describe("要抓取的 URL(同源或已配 CORS)"),
 		as: t.enum(["text", "markdown"]).optional().describe("返回格式标签,默认 text")
 	})
-})], lx = [
+})], mx = [
 	"id",
 	"class",
 	"href",
@@ -18872,12 +19017,12 @@ var sx = 3e4, cx = [r(async ({ url: e, as: t }) => {
 	"aria-label",
 	"name",
 	"type"
-], ux = /^(value|srcdoc|formaction|on\w+)$/i, dx = /token|secret|password|passwd|api[-_]?key|auth|cred|csrf|session/i;
-function fx(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 ?? lx, 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-")) && (ux.test(n.name) || dx.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 = {
@@ -18893,10 +19038,10 @@ function fx(e, t) {
 	};
 	return c(e, n);
 }
-var px = 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 = fx(i, {
+	let a = _x(i, {
 		depth: t ?? 3,
 		attrs: n,
 		includeText: r ?? !0
@@ -18911,14 +19056,14 @@ var px = r(({ selector: e, depth: t, attrs: n, includeText: r }) => {
 		attrs: t.array(t.string()).optional().describe("属性白名单(传了 = 严格白名单;不传 = 默认常用 + data-*)"),
 		includeText: t.boolean().optional().describe("是否包含直接文本(默认 true)")
 	})
-}), mx = [px];
+}), yx = [vx];
 //#endregion
 //#region src/core/tools/envTool.ts
-function hx(e) {
+function bx(e) {
 	let t = e;
 	return typeof t.tagName == "string" || typeof t.nodeType == "number" && typeof t.nodeName == "string";
 }
-function gx(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;
@@ -18927,14 +19072,14 @@ function gx(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 (hx(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) => gx(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 "(对象,已截断)";
@@ -18946,14 +19091,14 @@ function gx(e, t = 3, n = 2e3, r) {
 			break;
 		}
 		try {
-			o[r] = gx(i[r], t - 1, n, a);
+			o[r] = xx(i[r], t - 1, n, a);
 		} catch {
 			o[r] = "(getter 抛错)";
 		}
 	}
 	return o;
 }
-function _x(e) {
+function Sx(e) {
 	let t = e ?? (typeof window < "u" ? window : {}), n = t.navigator, r = t.location, i = t.document;
 	return {
 		location: {
@@ -18986,9 +19131,9 @@ function _x(e) {
 		} : "(无 document)"
 	};
 }
-var vx = /^(localStorage|sessionStorage|cookie|document|frames|frameElement|opener|parent|top|self|window|globalThis|closed|history|navigation|trustedTypes|origin|crossOriginIsolated)$/, yx = /token|secret|password|passwd|api[-_]?key|auth|cred|csrf|session|ticket/i, bx = 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 (vx.test(e) || yx.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),不读取防泄漏"
@@ -18998,18 +19143,18 @@ var vx = /^(localStorage|sessionStorage|cookie|document|frames|frameElement|open
 			key: e,
 			exists: t !== void 0,
 			type: typeof t,
-			value: gx(t)
+			value: xx(t)
 		}, null, 2);
 	}
-	return JSON.stringify(_x(), 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__\");不传 = 返回环境摘要") })
-}), xx = [bx];
+}), Ex = [Tx];
 //#endregion
 //#region src/core/harness/budget.ts
-function Sx(e, t, n) {
+function Dx(e, t, n) {
 	let r = 0;
 	return {
 		name: "budget",
@@ -19034,12 +19179,12 @@ function Sx(e, t, n) {
 }
 //#endregion
 //#region src/core/sdk/actions.ts
-var Cx = /^[a-zA-Z][a-zA-Z0-9_]*$/;
-function wx(e) {
+var Ox = /^[a-zA-Z][a-zA-Z0-9_]*$/;
+function kx(e) {
 	let n = [];
 	for (let [i, a] of Object.entries(e)) {
-		if (!Cx.test(i)) {
-			console.warn(`[page-agent-sdk][actions] 动作名 "${i}" 非法(须匹配 ${Cx}),已跳过`);
+		if (!Ox.test(i)) {
+			console.warn(`[page-agent-sdk][actions] 动作名 "${i}" 非法(须匹配 ${Ox}),已跳过`);
 			continue;
 		}
 		let e = a.description || `宿主动作 ${i}`;
@@ -19059,9 +19204,9 @@ function wx(e) {
 	}
 	return n;
 }
-function Tx(e) {
+function Ax(e) {
 	let t = {};
-	for (let [n, r] of Object.entries(e)) Cx.test(n) && (t[n] = {
+	for (let [n, r] of Object.entries(e)) Ox.test(n) && (t[n] = {
 		description: r.description,
 		hasParams: !!r.params
 	});
@@ -19069,31 +19214,31 @@ function Tx(e) {
 }
 //#endregion
 //#region src/core/toolsets.ts
-var Ex = cx, Dx = mx;
-function Ox(e, t) {
-	return ox(e, t);
+var jx = px, Mx = yx;
+function Nx(e, t) {
+	return dx(e, t);
 }
-function kx(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 Ax = .7;
-function jx(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) >= Ax || /规划|创意|设计|方案|brainstorm|plan/i.test(e.description)), i = e.subagents.filter((e) => (e.temperature ?? 0) < Ax && /反思|审查|挑刺|校验|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;
 		}
@@ -19101,72 +19246,72 @@ function jx(e, t, n = "simple") {
 }
 //#endregion
 //#region src/core/backends/skillStore.ts
-var Mx = "v:1::skill-store", Nx = "chat-sdk";
-function Px(e, t, n) {
-	return `${Mx}::${e}::${t}::${n}`;
+var Lx = "v:1::skill-store", Rx = "chat-sdk";
+function zx(e, t, n) {
+	return `${Lx}::${e}::${t}::${n}`;
 }
-function Fx(e, t) {
-	return `${Mx}::${e}::${t}::`;
+function Bx(e, t) {
+	return `${Lx}::${e}::${t}::`;
 }
-function Ix(e = {}) {
-	let t = e.dbName ?? Nx, 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 () => {
 		try {
 			if (n === "indexed") {
 				if (typeof indexedDB > "u") throw Error("indexedDB 不可用");
-				i = await Zy(t), a(!0);
+				i = await $y(t), a(!0);
 			} else if (n === "session") {
 				if (typeof sessionStorage > "u") throw Error("sessionStorage 不可用");
-				i = Qy(sessionStorage), a(!0);
+				i = eb(sessionStorage), a(!0);
 			} else if (n === "local") {
 				if (typeof localStorage > "u") throw Error("localStorage 不可用");
-				i = Qy(localStorage), a(!0);
-			} else i = Xy(), a(!1);
+				i = eb(localStorage), a(!0);
+			} else i = Qy(), a(!1);
 		} catch {
-			i = Xy(), a(!1);
+			i = Qy(), a(!1);
 		}
 	})(), {
 		ready: o,
 		async list() {
 			let e = [];
-			return await i.scan(Fx(t, r), (t, n) => {
+			return await i.scan(Bx(t, r), (t, n) => {
 				e.push(n);
 			}), e;
 		},
 		async get(e) {
-			return await i.get(Px(t, r, e));
+			return await i.get(zx(t, r, e));
 		},
 		async put(e) {
 			try {
-				await i.set(Px(t, r, e.name), e);
+				await i.set(zx(t, r, e.name), e);
 			} catch (e) {
-				Hy(e) && (i = Xy());
+				Wy(e) && (i = Qy());
 			}
 		},
 		async remove(e) {
-			let n = Px(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(Fx(t, r));
+			await i.clearPrefix(Bx(t, r));
 		},
 		dispose() {}
 	};
 }
 //#endregion
 //#region src/core/sdk/createChatSdk.ts
-var Lx = 50, Rx = /* @__PURE__ */ new Map();
-function zx(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 Bx(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 = zx(t.name, t.args);
+			let i = await r(t), a = Wx(t.name, t.args);
 			return a && e({
 				type: "data_change",
 				operation: a,
@@ -19201,18 +19346,18 @@ function Bx(e, t, n, r) {
 		}
 	};
 }
-function Vx(e, i) {
+function Kx(e, i) {
 	let a = {
 		prompt_tokens: 0,
 		completion_tokens: 0,
 		total_tokens: 0
-	}, o = ky(() => Oe), s = /* @__PURE__ */ U(0), c = tb(e.storage);
+	}, o = jy(() => Oe), s = /* @__PURE__ */ U(0), c = rb(e.storage);
 	e.debug && c && c.onEvent((e) => console.log("[page-agent-sdk][storage]", e));
-	let { modelCaps: l, summaryLlmInvoke: u } = Oy(e), d = l;
+	let { modelCaps: l, summaryLlmInvoke: u } = Ay(e), d = l;
 	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 = Ab(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,
@@ -19225,24 +19370,25 @@ function Vx(e, i) {
 		description: e.data.description ?? "主数据对象"
 	} : void 0, x = e.checkpoint, S = x !== void 0 && x !== !1, C = S ? iv({
 		getData: () => N()?.bind,
+		consumeDataDirty: () => ee?.consumeDataDirty?.() ?? !0,
 		slotPaths: b ? [""] : [],
 		vfsStore: m,
 		todosMw: h,
 		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 = wy(e), j = E && b ? ox(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 ? ix(j, e.toolMode) : [], ee = E && b ? j.controller ?? null : null, N = () => ee?.get() ?? b, P = /* @__PURE__ */ new Map(), F = kx(T, M, cx, mx, xx);
+	}) : [], 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 = wx(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");
@@ -19279,11 +19425,11 @@ function Vx(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 Lb) 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,
@@ -19313,7 +19459,7 @@ function Vx(e, i) {
 			llm: e.llm,
 			tools: xe
 		} : void 0
-	}) : void 0, Ce = jx({
+	}) : void 0, Ce = Ix({
 		...T,
 		humanConfirm: R,
 		subagents: e.subagents?.map((e) => ({
@@ -19323,7 +19469,7 @@ function Vx(e, i) {
 		}))
 	}, E && !!b, e.toolMode), we = b ? {
 		name: "dataHint",
-		augmentPrompt: () => Cy(N(), e.schemaHint) || void 0
+		augmentPrompt: () => Ty(N(), e.schemaHint) || void 0
 	} : null, Te = e.augmentSystem ? {
 		name: "augmentSystem",
 		augmentPrompt: (t) => {
@@ -19337,7 +19483,7 @@ function Vx(e, i) {
 				return;
 			}
 		}
-	} : null, Ee = e.onEvent, De = rb(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() : ""
@@ -19345,7 +19491,7 @@ function Vx(e, i) {
 		name: e.name,
 		description: e.description,
 		getContent: () => e.content
-	}), Ne = e.skillStorage === !1 ? null : Ix({
+	}), 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 = () => {
@@ -19368,18 +19514,18 @@ function Vx(e, i) {
 				B.infoTick.value++;
 			}
 		} catch {}
-	}, Ie = cb([
+	}, Ie = fb([
 		...we ? [we] : [],
 		Ce,
 		...oe ? [g] : [],
 		...ae ? [h] : [],
 		...ce ? [ke = z_(e.skills || [], { readVfs: le ? (e) => m.files[e]?.content : void 0 })] : [],
-		...le ? [zb(m)] : [],
+		...le ? [Ub(m)] : [],
 		...ue ? [$v({
-			...ob(e, d.contextWindow),
+			...ub(e, d.contextWindow),
 			llmInvoke: u,
 			getRegisteredData: () => N() ? [{ description: N().description ?? "主数据对象" }] : [],
-			preserveLastToolResults: (e.contextOptions && e.contextOptions.preserveLastToolResults) ?? ab[e.contextPreset ?? "auto"]
+			preserveLastToolResults: (e.contextOptions && e.contextOptions.preserveLastToolResults) ?? lb[e.contextPreset ?? "auto"]
 		})] : [],
 		...se ? [_] : [],
 		...de ? [v] : [],
@@ -19392,12 +19538,12 @@ function Vx(e, i) {
 		...ve ? [ve] : [],
 		...Te ? [Te] : [],
 		...e.middleware || [],
-		...k ? [Sx(a, {
+		...k ? [Dx(a, {
 			tokenBudget: e.tokenBudget,
 			timeBudgetMs: e.timeBudgetMs
 		}, Oe)] : [],
-		Bx(Oe, p, N, a)
-	]), Le = e.maxMemoryRounds ?? Lx, B = {
+		Gx(Oe, p, N, a)
+	]), Le = e.maxMemoryRounds ?? Hx, B = {
 		agentId: i,
 		store: c,
 		messages: p,
@@ -19500,6 +19646,7 @@ function Vx(e, i) {
 			for (let r = 0; r < e.length; r++) {
 				let i = e[r];
 				C && C.save(`batch:${r}`);
+				let a = p.length;
 				try {
 					p.push({
 						role: "user",
@@ -19522,11 +19669,12 @@ function Vx(e, i) {
 						task: i,
 						ok: !0
 					});
-				} catch (a) {
-					let o = Gg(a, "fatal");
+				} catch (o) {
+					p.length > a && p.splice(a);
+					let s = Gg(o, "fatal");
 					Oe({
 						type: "error",
-						message: `批量任务 ${r + 1}/${e.length} 失败:${o.message}`,
+						message: `批量任务 ${r + 1}/${e.length} 失败:${s.message}`,
 						severity: "observable",
 						code: "BATCH_TASK_FAILED",
 						context: {
@@ -19536,7 +19684,7 @@ function Vx(e, i) {
 					}), n.push({
 						index: r,
 						task: i,
-						error: o.message,
+						error: s.message,
 						ok: !1
 					}), t?.({
 						done: r + 1,
@@ -19573,7 +19721,7 @@ function Vx(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())), Rx.delete(i);
+				e.length && Promise.allSettled(e.map((e) => e())), Ux.delete(i);
 			}
 		},
 		resolveConflict: o.resolve,
@@ -19590,7 +19738,7 @@ function Vx(e, i) {
 			return t < 0 ? !1 : (I.splice(t, 1), z = ie(), B.agent && B.agent.setTools(z), B.infoTick.value++, !0);
 		},
 		setLlm(t) {
-			let r = Ty(t) ? t : new n({
+			let r = Dy(t) ? t : new n({
 				apiKey: t.apiKey,
 				model: t.model,
 				temperature: t.temperature,
@@ -19631,8 +19779,8 @@ function Vx(e, i) {
 		getInfo() {
 			return {
 				id: i,
-				model: Ty(f) ? f.model ?? f.modelName : f.model,
-				systemPrompt: B.agent?.getEffectiveSystemPrompt?.() ?? A + Cy(N(), e.schemaHint),
+				model: Dy(f) ? f.model ?? f.modelName : f.model,
+				systemPrompt: B.agent?.getEffectiveSystemPrompt?.() ?? A + Ty(N(), e.schemaHint),
 				tools: (B.agent?.allTools ?? z).map((e) => ({
 					name: e.name,
 					description: e.description,
@@ -19666,7 +19814,7 @@ function Vx(e, i) {
 					spans: B.agent.spans.value,
 					metrics: r_(B.agent.spans.value)
 				} : void 0,
-				actions: Tx(e.actions ?? {}),
+				actions: Ax(e.actions ?? {}),
 				subagent: {
 					enabled: !!_e,
 					maxDepth: e.subagent?.maxDepth ?? 1,
@@ -19754,7 +19902,7 @@ function Vx(e, i) {
 			}), z = ie(), e.debug && console.log(`[page-agent-sdk][mcp] 注入 ${n.length} 个工具,${B.mcpServers.length} 个 server`);
 		}
 		B.agent = x_({
-			...Ty(e.llm) ? { llm: e.llm } : {
+			...Dy(e.llm) ? { llm: e.llm } : {
 				apiKey: e.llm.apiKey,
 				baseUrl: e.llm.baseUrl,
 				model: e.llm.model,
@@ -19773,7 +19921,7 @@ function Vx(e, i) {
 			maxOutputTokens: d.maxOutputTokens,
 			maxVerifyAttempts: me ? pe : 0,
 			onLlmChange: (t) => {
-				let n = Ty(t) ? void 0 : t;
+				let n = Dy(t) ? void 0 : t;
 				d = $g({
 					model: n?.model ?? t.model ?? t.modelName,
 					contextWindow: e.contextWindow ?? n?.contextWindow,
@@ -19795,12 +19943,12 @@ function Vx(e, i) {
 		});
 	})(), B;
 }
-function Hx(e) {
-	let t = e.id ?? Ay();
+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 ? Rx.get(t) : void 0;
-	a ? i = a : (i = Vx(e, t), e.shareContext && Rx.set(t, i)), i.refCount++;
-	let o = null, s = null, c = nb(e), l = null, u = null;
+	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) {
 			m();
@@ -19839,7 +19987,7 @@ function Hx(e) {
 					i.afterRound(), i.store && await i.store.flush();
 				},
 				onClear: () => {
-					i.store && (i.sessionId = Ay(), i.vfsStore.clear?.(), i.todosMw.reset([]), e.memory || i.memoryMw.reset(""), i.agent.debugLogs.value = [], i.store.createSession(i.agentId, e.session?.title, i.sessionId));
+					i.store && (i.sessionId = My(), i.vfsStore.clear?.(), i.todosMw.reset([]), e.memory || i.memoryMw.reset(""), i.agent.debugLogs.value = [], i.store.createSession(i.agentId, e.session?.title, i.sessionId));
 				},
 				pendingConflict: i.pendingConflict.value,
 				onResolveConflict: (e) => i.resolveConflict(e),
@@ -19958,7 +20106,7 @@ function Hx(e) {
 					error: "schema 校验失败:" + (t.error?.message ?? "未知错误")
 				};
 			}
-			return tv(r, e), t?.emit !== !1 && i.emit({
+			return tv(r, e), i.dataOpsController?.markDataDirty?.(), t?.emit !== !1 && i.emit({
 				type: "data_change",
 				operation: "set",
 				value: r
@@ -19980,7 +20128,7 @@ function Hx(e) {
 }
 //#endregion
 //#region src/core/sdk/defineTool.ts
-function Ux(e) {
+function Jx(e) {
 	return r(async (t) => {
 		let n = await e.handler(t);
 		return typeof n == "string" ? n : JSON.stringify(n);
@@ -19991,4 +20139,4 @@ function Ux(e) {
 	});
 }
 //#endregion
-export { ib as CONTEXT_PRESETS, Bg as ChatDialog, nf as CodePreview, Sy as DEFAULT_SYSTEM_PROMPT, J_ as HUMAN_CONFIRM_TOOL_NAME, af as MessageContent, Gv as STOP_WORDS, xh as SkillPanel, lb as UNSAFE_KEYS, Tx as actionsToInspectInfo, wx as actionsToTools, Kg as agentError, Sb as applyPatchToClone, Cb as applyPatchToLive, Gg as asAgentError, Cy as buildDataPrompt, wy as buildSystemPrompt, ax as commitSetToBind, Lv as connectMcp, wl as copyText, x_ as createAgent, q_ as createApprovalMiddleware, Hx as createChatSdk, iv as createCheckpointManager, av as createCheckpointMiddleware, ky as createConflictManager, ox as createDataOps, Z_ as createHumanConfirmMiddleware, X_ as createHumanConfirmTool, Xy as createMemoryBackend, B_ as createMemoryMiddleware, v as createProxyLlm, rb as createSdkEvents, eb as createSessionStore, Ix as createSkillStore, _v as createSubagentMiddleware, bv as createSubagentsMiddleware, jx as createUsageHintsMiddleware, xv as createVerifyMiddleware, Ab as createVfs, Qy as createWebStorageBackend, Dv as createWriteBackCheck, hb as deepClone, Ox as defineDataToolset, N_ as defineSkill, Ux as defineTool, mb as deleteByPath, dy as describeSchemaNode, p_ as detectGarbledToolCall, Eb as diffObjects, fx as domToStructure, mx as domTools, Dx as domToolsStatic, qv as estimateMessageTokens, Jv as estimateRoundTokens, e_ as estimateTokens, xy as extractSchemaHint, Pv as extractText, cx as fetchDocTools, Ex as fetchTools, ix as filterByToolMode, fy as formatConstraints, Vg as formatZodIssues, fb as getByPath, px as getDomTool, _x as getEnvSummary, ry as getSchemaAtPath, ey as getSchemaTopKeys, r_ as getTraceMetrics, xb as hashValue, Yv as indexSummarize, bx as inspectEnvTool, xx as inspectTools, Ty as isChatModel, ty as isPathAllowed, Hy as isQuotaError, ub as isUnsafePath, Yb as jpEval, Ug as jsonParseError, vb as limitDepth, gb as maybeParseValue, n_ as offloadPassThroughChars, t_ as offloadThresholdChars, _y as presets, ay as projectBySchema, iy as projectBySchemaDeep, _b as projectFields, Xv as recallRounds, py as renderSchemaHint, my as renderSchemaOverview, gy as renderSchemaShallow, ob as resolveContextOptions, nb as resolveDialogConfig, Oy as resolveLlm, $g as resolveModelCaps, tb as resolveStorage, Tb as restoreInPlace, wb as restoreLive, Wg as routeError, tx as runSandboxedScript, db as safeMerge, gx as safeSerialize, yb as safeStringify, Zb as searchJson, kx as selectBuiltinTools, pb 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 };