page-agent-sdk 2.15.1 → 2.16.0

package/dist/page-agent-sdk.js

@@ -13936,20 +13936,34 @@ function xg(e) {
 }
 function Sg(e, t) {
 	let n = t.threshold ?? 6e3;
-	if (e.length <= n) return e;
+	if (e.length <= n) return { content: e };
 	if (t.vfsAvailable && t.files) {
 		let n = `large_results/${t.toolName}-${xg(e)}.txt`, r = bg(n);
-		return t.files[r] = {
+		t.files[r] = {
 			content: e,
 			updatedAt: Date.now()
-		}, [
-			e.slice(0, 1e3),
-			`…[结果过大(共 ${e.length} 字符),已转存到虚拟工作区:${n}]`,
-			`需要完整或局部数据时:用 vfs_read({ path: "${n}", offset, limit }) 分页回读,或 vfs_grep({ pattern, path: "${n}" }) 局部检索。`
-		].join("\n");
+		};
+		let i = e.slice(0, 1e3), a = e.length, o = a > 1e4 ? `结果较大(共 ${a} 字符),建议分页读取:vfs_read({ path: "${n}", offset: 0, limit: 100 }) 起步,按需 offset += 100 续读,或 vfs_grep({ pattern, path: "${n}" }) 局部检索` : void 0;
+		return {
+			offloaded: !0,
+			content: [
+				i,
+				`…[结果过大(共 ${a} 字符),已转存到虚拟工作区:${n}]`,
+				`需要完整或局部数据时:用 vfs_read({ path: "${n}", offset, limit }) 分页回读,或 vfs_grep({ pattern, path: "${n}" }) 局部检索。`,
+				...o ? [o] : []
+			].join("\n"),
+			path: n,
+			totalChars: a,
+			preview: i,
+			suggestedReadPlan: o
+		};
 	}
 	let r = t.passThroughChars ?? n;
-	return e.length <= r ? e : e.slice(0, r) + `\n…[结果过大(共 ${e.length} 字符),vfs 未启用无法外存,已截断,仅显示前 ${r} 字符。建议开启 vfs(capabilities.vfs 默认开启)以完整外存可回读]`;
+	return e.length <= r ? { content: e } : {
+		offloaded: !1,
+		content: e.slice(0, r) + `\n…[结果过大(共 ${e.length} 字符),vfs 未启用无法外存,已截断,仅显示前 ${r} 字符。建议开启 vfs(capabilities.vfs 默认开启)以完整外存可回读]`,
+		totalChars: e.length
+	};
 }
 //#endregion
 //#region src/core/utils/pool.ts
@@ -14354,7 +14368,7 @@ function Wg(e) {
 				toolName: e.name,
 				threshold: E,
 				passThroughChars: D
-			}), {
+			}).content, {
 				content: r,
 				status: "done"
 			};
@@ -16127,9 +16141,26 @@ var Gv = {
 		recallTopK: 5,
 		enableRecall: !0,
 		enableLLMSummary: !0
+	},
+	complex: {
+		summaryThresholdRatio: .7,
+		windowRatio: .6,
+		recallTopK: 5,
+		enableRecall: !0,
+		enableLLMSummary: !0
 	}
+}, Kv = {
+	auto: ["describe_data", "read"],
+	conservative: ["describe_data"],
+	aggressive: ["describe_data", "read"],
+	complex: [
+		"describe_data",
+		"read",
+		"query_data",
+		"search_data"
+	]
 };
-function Kv(e, t) {
+function qv(e, t) {
 	let n = Gv[e.contextPreset ?? "auto"] ?? {}, r = e.contextOptions === !1 ? {} : e.contextOptions ?? {};
 	return {
 		...n,
@@ -16147,7 +16178,7 @@ function $(e) {
 	};
 	return e.path !== void 0 && (t.path = e.path), e.hint && (t.hint = e.hint), e.details !== void 0 && (t.details = e.details), `ERROR: ${JSON.stringify(t)}`;
 }
-function qv(e) {
+function Jv(e) {
 	return e.slice(0, 10).map((e) => {
 		let t = e, n = {
 			path: (Array.isArray(t.path) ? t.path.join(".") : String(t.path ?? "")) || "(root)",
@@ -16156,16 +16187,16 @@ function qv(e) {
 		return t.expected !== void 0 && (n.expected = t.expected), t.received !== void 0 && (n.received = t.received), t.code !== void 0 && (n.code = t.code), n;
 	});
 }
-function Jv(e, t) {
+function Yv(e, t) {
 	return $({
 		code: "SCHEMA_INVALID",
 		path: e,
 		message: `值不符合 "${e}" 的 schema(${t.length} 处问题)`,
 		hint: `用 read({jsonPath:"${e}"}) 查看当前值,按 describe_data() 查看主数据 schema,修正后重试;改大对象优先用 write 的 patch 增量(只发改动部分)`,
-		details: qv(t)
+		details: Jv(t)
 	});
 }
-function Yv(e, t, n) {
+function Xv(e, t, n) {
 	let r = n?.message || String(n);
 	return $({
 		code: "JSON_PARSE",
@@ -16174,62 +16205,218 @@ function Yv(e, t, n) {
 		hint: `检查引号/逗号/括号是否闭合;字符串值需双引号包裹(如 '"dark"' 表示字符串 dark,数字直接写如 5);预览前 80 字符:${t.slice(0, 80)}`
 	});
 }
-var Xv = .9;
-function Zv(e, t = {}) {
+//#endregion
+//#region src/core/tools/jsonUtils.ts
+var Zv = /* @__PURE__ */ new Set([
+	"__proto__",
+	"constructor",
+	"prototype"
+]);
+function Qv(e) {
+	return e.split(".").some((e) => Zv.has(e));
+}
+function $v(e, t) {
+	if (!(!t || typeof t != "object" || Array.isArray(t))) for (let n of Object.keys(t)) Zv.has(n) || (e[n] = t[n]);
+}
+function ey(e, t) {
+	if (!t) return e;
+	if (Qv(t)) return;
+	let n = t.split("."), r = e;
+	for (let e of n) {
+		if (r == null) return;
+		r = r[e];
+	}
+	return r;
+}
+function ty(e, t, n) {
+	if (!t || Qv(t)) return;
+	let r = t.split("."), i = e;
+	for (let e = 0; e < r.length - 1; e++) {
+		let t = r[e];
+		(i[t] == null || typeof i[t] != "object") && (i[t] = {}), i = i[t];
+	}
+	i[r[r.length - 1]] = n;
+}
+function ny(e, t) {
+	if (!t || Qv(t)) return !1;
+	let n = t.split("."), r = e;
+	for (let e = 0; e < n.length - 1; e++) {
+		if (r == null) return !1;
+		r = r[n[e]];
+	}
+	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 ry(e) {
+	return e === void 0 ? void 0 : JSON.parse(JSON.stringify(e));
+}
+function iy(e) {
+	if (typeof e != "string") return { parsed: e };
+	let t = e.trim();
+	if (!t) return { parsed: e };
+	let n = t[0] === "{" || t[0] === "[";
+	try {
+		return { parsed: JSON.parse(t) };
+	} catch (t) {
+		return n ? { parseError: t } : { parsed: e };
+	}
+}
+function ay(e, t) {
+	if (typeof e != "object" || !e) return e;
+	let n = new Set(t);
+	if (Array.isArray(e)) return e.map((e) => ay(e, t));
+	let r = {};
+	for (let t of Object.keys(e)) n.has(t) && (r[t] = e[t]);
+	return r;
+}
+function oy(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) => oy(e, t - 1));
+	let n = {};
+	for (let r of Object.keys(e)) n[r] = oy(e[r], t - 1);
+	return n;
+}
+function sy(e, t = Infinity) {
+	let n = /* @__PURE__ */ new WeakSet(), r;
+	try {
+		r = JSON.stringify(e, (e, t) => {
+			if (typeof t == "function") return "[Function]";
+			if (typeof t == "bigint") return t.toString();
+			if (typeof t == "object" && t) {
+				if (typeof HTMLElement < "u" && t instanceof HTMLElement) return `[HTMLElement: <${t.tagName.toLowerCase()}>]`;
+				if (typeof Node < "u" && t instanceof Node) return `[Node: type=${t.nodeType}]`;
+				if (n.has(t)) return "[Circular]";
+				n.add(t);
+			}
+			return t;
+		}, 0);
+	} catch (e) {
+		r = `[无法序列化: ${e?.message || String(e)}]`;
+	}
+	return r.length > t && (r = r.slice(0, t) + `\n…[已截断,原长度 ${r.length}]`), r;
+}
+function cy(e) {
+	let t = sy(e), n = 5381;
+	for (let e = 0; e < t.length; e++) n = (n << 5) + n + t.charCodeAt(e) >>> 0;
+	return n.toString(36);
+}
+function ly(e, t, n, r) {
+	if (t === "set") return n ? (ty(e, n, r), null) : "set 操作需要 jsonPath(整体替换请用 set_data)";
+	if (t === "remove") return n ? (ny(e, n), null) : "remove 操作需要 jsonPath";
+	if (t === "merge") {
+		let t = n ? ey(e, n) : e;
+		return typeof t != "object" || !t || Array.isArray(t) ? `merge 目标${n ? `(${n})` : "(根)"}不是对象` : ($v(t, r), null);
+	}
+	let i = n ? ey(e, n) : e;
+	return Array.isArray(i) ? (Array.isArray(r) ? i.push(...r) : i.push(r), null) : `append 目标${n ? `(${n})` : "(根)"}不是数组`;
+}
+function uy(e, t, n, r) {
+	if (t === "set") ty(e, n, r);
+	else if (t === "remove") ny(e, n);
+	else if (t === "merge") $v(n ? ey(e, n) : e, r);
+	else {
+		let t = n ? ey(e, n) : e;
+		Array.isArray(r) ? t.push(...r) : t.push(r);
+	}
+}
+function dy(e, t) {
+	typeof e == "object" && e && fy(e, t);
+}
+function fy(e, t) {
+	if (Array.isArray(e)) {
+		e.length = 0, Array.isArray(t) && e.push(...t);
+		return;
+	}
+	let n = t && typeof t == "object" && !Array.isArray(t) ? 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];
+}
+var py = {
+	largeResults: 4194304,
+	drafts: 2097152,
+	userFiles: 2097152
+}, my = [
+	"largeResults",
+	"drafts",
+	"userFiles"
+], hy = .9;
+function gy(e, t = {}) {
 	let n = Object.create(null);
-	if (e) for (let [t, r] of Object.entries(e)) n[ey(t)] = {
+	if (e) for (let [t, r] of Object.entries(e)) n[by(t)] = {
 		content: r,
-		updatedAt: ny()
+		updatedAt: Sy()
+	};
+	let { persist: r } = t, i = t.maxBytes ?? 8388608, a = {
+		...py,
+		...t.poolBytes ?? {}
 	};
-	let { persist: r } = t, i = t.maxBytes ?? 4194304;
-	function a() {
-		if ($v(n) <= i) return;
-		let e = i * Xv, t = Object.entries(n).sort((e, t) => e[1].updatedAt - t[1].updatedAt);
-		for (let [r] of t) if (delete n[r], $v(n) <= e) break;
-	}
-	let o = null;
-	function s() {
+	function o(e) {
+		let t = by(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 += vy(i.content));
+		return t;
+	}
+	function c() {
+		for (let e of my) {
+			let t = a[e];
+			if (s(e) <= t) continue;
+			let r = t * hy, 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 (yy(n) > i) {
+			let e = i * hy, t = Object.entries(n).sort((e, t) => e[1].updatedAt - t[1].updatedAt);
+			for (let [r] of t) if (delete n[r], yy(n) <= e) break;
+		}
+	}
+	let l = null;
+	function u() {
 		if (!r?.save) return;
 		let e = {};
 		for (let [t, r] of Object.entries(n)) e[t] = { ...r };
 		r.save(e);
 	}
-	function c() {
-		r?.save && (o && clearTimeout(o), o = setTimeout(() => {
-			o = null, s();
+	function d() {
+		r?.save && (l && clearTimeout(l), l = setTimeout(() => {
+			l = null, u();
 		}, 800));
 	}
-	let l = { files: new Proxy(n, {
+	let f = { files: new Proxy(n, {
 		set(e, t, n) {
 			let r = Reflect.set(e, t, n);
-			return r && (a(), c()), r;
+			return r && (c(), d()), r;
 		},
 		deleteProperty(e, t) {
 			let n = Reflect.deleteProperty(e, t);
-			return n && c(), n;
+			return n && d(), n;
 		}
 	}) };
-	return r && (l.hydrate = (e) => {
-		for (let [t, r] of Object.entries(e)) n[ey(t)] = r;
-		a();
-	}, l.flush = () => {
-		o &&= (clearTimeout(o), null), s();
-	}, l.clear = () => {
-		for (let e of Object.keys(n)) delete n[e];
+	return r && (f.hydrate = (e) => {
+		for (let [t, r] of Object.entries(e)) n[by(t)] = r;
 		c();
-	}), l;
+	}, f.flush = () => {
+		l &&= (clearTimeout(l), null), u();
+	}, f.clear = () => {
+		for (let e of Object.keys(n)) delete n[e];
+		d();
+	}), f;
 }
-var Qv = null;
-function $v(e) {
-	Qv ||= new TextEncoder();
+var _y = null;
+function vy(e) {
+	return _y ||= new TextEncoder(), _y.encode(e).length;
+}
+function yy(e) {
 	let t = 0;
-	for (let n of Object.values(e)) t += Qv.encode(n.content).length;
+	for (let n of Object.values(e)) t += vy(n.content);
 	return t;
 }
-function ey(e) {
+function by(e) {
 	return e.replace(/^\/+/, "").replace(/\/+/g, "/");
 }
-function ty(e) {
+function xy(e) {
 	let t = "";
 	for (let n = 0; n < e.length; n++) {
 		let r = e[n];
@@ -16237,13 +16424,23 @@ function ty(e) {
 	}
 	return RegExp("^" + t + "$");
 }
-function ny() {
+function Sy() {
 	return Date.now();
 }
-function ry(e) {
+var Cy = [
+	"vfs_read",
+	"vfs_write",
+	"vfs_edit",
+	"vfs_ls",
+	"vfs_glob",
+	"vfs_grep",
+	"vfs_json_read",
+	"vfs_json_patch"
+];
+function wy(e) {
 	return [
 		r(async ({ path: t, offset: n, limit: r }) => {
-			let i = e.files[ey(t)];
+			let i = e.files[by(t)];
 			if (!i) return $({
 				code: "NOT_FOUND",
 				path: t,
@@ -16261,19 +16458,32 @@ function ry(e) {
 				limit: t.number().int().min(1).default(2e3).describe("读取行数")
 			})
 		}),
-		r(async ({ path: t, content: n }) => (e.files[ey(t)] = {
-			content: n,
-			updatedAt: ny()
-		}, `已写入 ${t}(${n.length} 字符)`), {
+		r(async ({ path: t, content: n, jsonString: r }) => {
+			if (r) try {
+				JSON.parse(n);
+			} catch (e) {
+				return $({
+					code: "VFS_JSON_INVALID",
+					path: t,
+					message: `content 非合法 JSON: ${e.message}`,
+					hint: "jsonString=true 要求 content 是合法 JSON;检查引号/逗号/括号配对;或省略 jsonString 写纯文本"
+				});
+			}
+			return e.files[by(t)] = {
+				content: n,
+				updatedAt: Sy()
+			}, `已写入 ${t}(${n.length} 字符)${r ? "(JSON 校验通过)" : ""}`;
+		}, {
 			name: "vfs_write",
-			description: "写入/覆盖虚拟工作区文件,作为中间工作记忆。",
+			description: "写入/覆盖虚拟工作区文件,作为中间工作记忆。jsonString=true 时校验 content 是合法 JSON(配合 vfs_json_read/vfs_json_patch 操作 JSON 文件)。",
 			schema: t.object({
 				path: t.string().describe("文件路径"),
-				content: t.string().describe("完整内容")
+				content: t.string().describe("完整内容"),
+				jsonString: t.boolean().optional().describe("true 时校验 content 是合法 JSON(非法返回 VFS_JSON_INVALID 不写入);省略/false 写纯文本不校验")
 			})
 		}),
 		r(async ({ path: t, oldString: n, newString: r }) => {
-			let i = ey(t), a = e.files[i];
+			let i = by(t), a = e.files[i];
 			if (!a) return $({
 				code: "NOT_FOUND",
 				path: t,
@@ -16303,7 +16513,7 @@ function ry(e) {
 			}
 			return e.files[i] = {
 				content: a.content.replace(n, r),
-				updatedAt: ny()
+				updatedAt: Sy()
 			}, `已替换 ${t} 中 1 处。`;
 		}, {
 			name: "vfs_edit",
@@ -16325,7 +16535,7 @@ function ry(e) {
 		r(async ({ pattern: t }) => {
 			let n;
 			try {
-				n = ty(t);
+				n = xy(t);
 			} catch (e) {
 				return $({
 					code: "GLOB_INVALID",
@@ -16354,7 +16564,7 @@ function ry(e) {
 					details: { pattern: t }
 				});
 			}
-			let i = n ? [ey(n)] : Object.keys(e.files), a = [];
+			let i = n ? [by(n)] : Object.keys(e.files), a = [];
 			for (let t of i) {
 				let n = e.files[t];
 				n && n.content.split("\n").forEach((e, n) => {
@@ -16369,20 +16579,110 @@ function ry(e) {
 				pattern: t.string().describe("正则表达式"),
 				path: t.string().optional().describe("限定单个文件,不传则搜索全部")
 			})
+		}),
+		r(async ({ path: t, jsonPath: n }) => {
+			let r = by(t), i = e.files[r];
+			if (!i) return $({
+				code: "NOT_FOUND",
+				path: t,
+				message: `未找到文件 "${t}"`,
+				hint: "用 vfs_ls 查看虚拟工作区文件列表"
+			});
+			let a;
+			try {
+				a = JSON.parse(i.content);
+			} catch (e) {
+				return $({
+					code: "VFS_JSON_INVALID",
+					path: t,
+					message: `文件内容非合法 JSON: ${e.message}`,
+					hint: "vfs_json_read 要求文件内容是合法 JSON;先 vfs_read 查看实际内容,或 vfs_write({jsonString:true}) 重写为合法 JSON"
+				});
+			}
+			if (n) {
+				let e = ey(a, n);
+				return e === void 0 ? $({
+					code: "VFS_PATH_NOT_FOUND",
+					path: t,
+					message: `jsonPath "${n}" 不存在`,
+					hint: "不传 jsonPath 整体读查看结构,或核对路径段"
+				}) : `${t}#${n} (JSON):\n${JSON.stringify(e)}`;
+			}
+			return `${t} (JSON):\n${JSON.stringify(a)}`;
+		}, {
+			name: "vfs_json_read",
+			description: "把虚拟工作区文件当 JSON 读取:先 parse 整文件,再按 jsonPath 取子树(省略返整体)。文件非合法 JSON 报 VFS_JSON_INVALID。适合结构化读取 vfs 内大 JSON。",
+			schema: t.object({
+				path: t.string().describe("文件路径(内容须为合法 JSON)"),
+				jsonPath: t.string().optional().describe("点分隔子路径(如 components.0.title);省略读整体")
+			})
+		}),
+		r(async ({ path: t, patches: n }) => {
+			let r = by(t), i = e.files[r];
+			if (!i) return $({
+				code: "NOT_FOUND",
+				path: t,
+				message: `未找到文件 "${t}"`,
+				hint: "用 vfs_ls 查看虚拟工作区文件列表"
+			});
+			let a;
+			try {
+				a = JSON.parse(i.content);
+			} catch (e) {
+				return $({
+					code: "VFS_JSON_INVALID",
+					path: t,
+					message: `文件内容非合法 JSON: ${e.message}`,
+					hint: "vfs_json_patch 要求文件内容是合法 JSON"
+				});
+			}
+			let o = ry(a), s = [];
+			for (let e of n) {
+				let n = ly(o, e.op, e.jsonPath, e.value);
+				if (n) return $({
+					code: "PATCH_FAILED",
+					path: t,
+					message: n,
+					hint: "修正 patches 后重试(原文件未改动)",
+					details: { failedPatch: e }
+				});
+				s.push(e.jsonPath || "(根)");
+			}
+			let c = JSON.stringify(o);
+			return e.files[r] = {
+				content: c,
+				updatedAt: Sy()
+			}, `已对 ${t} 应用 ${n.length} 个 patch(影响 ${s.length} 处:${s.join(", ")}),文件现 ${c.length} 字符`;
+		}, {
+			name: "vfs_json_patch",
+			description: "在虚拟工作区 JSON 文件内做原子 jsonPath patch(set/remove/merge/append)。先 parse → clone 上应用全部 patches → 任一失败或 JSON 非法则整体不写回(原文件不变)。",
+			schema: t.object({
+				path: t.string().describe("文件路径(内容须为合法 JSON)"),
+				patches: t.array(t.object({
+					op: t.enum([
+						"set",
+						"remove",
+						"merge",
+						"append"
+					]).describe("操作"),
+					jsonPath: t.string().describe("点分隔路径(如 components.0.title);merge/append 目标可为根(空串)"),
+					value: t.any().optional().describe("set/merge/append 的值(remove 不需要)")
+				})).describe("按顺序应用的 patch 列表(原子:任一失败整体不写回)")
+			})
 		})
 	];
 }
-function iy(e) {
+function Ty(e) {
 	return {
 		name: "vfs",
-		tools: ry(e),
+		tools: wy(e),
 		beforeAgent: () => ({ files: e.files })
 	};
 }
 //#endregion
 //#region src/core/tools/dataSlotQuery.ts
-var ay = /[\w$-]/;
-function oy(e) {
+var Ey = /[\w$-]/;
+function Dy(e) {
 	let t = [], n = e.trim(), r = +(n[0] === "$");
 	for (; r < n.length;) {
 		let e = n[r];
@@ -16393,7 +16693,7 @@ function oy(e) {
 					continue;
 				}
 				let e = "";
-				for (; r < n.length && ay.test(n[r]);) e += n[r++];
+				for (; r < n.length && Ey.test(n[r]);) e += n[r++];
 				if (!e) throw Error("JSONPath: .. 后缺属性名");
 				t.push({
 					type: "descendKey",
@@ -16406,7 +16706,7 @@ function oy(e) {
 				continue;
 			}
 			let e = "";
-			for (; r < n.length && ay.test(n[r]);) e += n[r++];
+			for (; r < n.length && Ey.test(n[r]);) e += n[r++];
 			if (!e) throw Error("JSONPath: . 后缺属性名");
 			t.push({
 				type: "key",
@@ -16462,7 +16762,7 @@ function oy(e) {
 	}
 	return t;
 }
-function sy(e) {
+function Oy(e) {
 	let t = [], n = 0, r = e.trim();
 	for (; n < r.length;) {
 		let e = r[n];
@@ -16507,7 +16807,7 @@ function sy(e) {
 	}
 	return t;
 }
-var cy = class {
+var ky = class {
 	toks;
 	item;
 	pos = 0;
@@ -16543,12 +16843,12 @@ var cy = class {
 			return this.next(), e;
 		}
 		let e = this.operand(), t = this.peek();
-		return t === "==" || t === "!=" || t === "<" || t === "<=" || t === ">" || t === ">=" ? (this.next(), dy(t, e, this.operand())) : ly(e);
+		return t === "==" || t === "!=" || t === "<" || t === "<=" || t === ">" || t === ">=" ? (this.next(), My(t, e, this.operand())) : Ay(e);
 	}
 	operand() {
 		let e = this.next();
 		if (e === void 0) throw Error("过滤表达式:缺操作数");
-		if (e.startsWith("@")) return uy(e, this.item);
+		if (e.startsWith("@")) return jy(e, this.item);
 		if (e[0] === "'" || e[0] === "\"") return e.slice(1, -1);
 		if (e === "true") return !0;
 		if (e === "false") return !1;
@@ -16558,10 +16858,10 @@ var cy = class {
 		throw Error(`过滤表达式:未知操作数 '${e}'`);
 	}
 };
-function ly(e) {
+function Ay(e) {
 	return !!e && e !== 0 && e !== "" && e !== null;
 }
-function uy(e, t) {
+function jy(e, t) {
 	let n = e.split(".").filter((e) => e && e !== "@"), r = t;
 	for (let e of n) {
 		if (typeof r != "object" || !r) return;
@@ -16569,7 +16869,7 @@ function uy(e, t) {
 	}
 	return r;
 }
-function dy(e, t, n) {
+function My(e, t, n) {
 	switch (e) {
 		case "==": return t === n;
 		case "!=": return t !== n;
@@ -16580,47 +16880,47 @@ function dy(e, t, n) {
 		default: return !1;
 	}
 }
-function fy(e, t) {
-	return new cy(sy(e), t).parse();
+function Ny(e, t) {
+	return new ky(Oy(e), t).parse();
 }
-function py(e, t) {
+function Py(e, t) {
 	return e ? `${e}.${t}` : String(t);
 }
-function my(e, t) {
+function Fy(e, t) {
 	let n = [{
 		path: "",
 		value: e
 	}];
-	for (let e of oy(t)) {
+	for (let e of Dy(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: py(r.path, e.key),
+			path: Py(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: py(r.path, e.index),
+					path: Py(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: py(e.path, r),
+				path: Py(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: py(e.path, n),
+				path: Py(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: py(e.path, n),
+						path: Py(e.path, n),
 						value: e.value[n]
 					};
 					n === r && t.push(a), i(a);
@@ -16631,7 +16931,7 @@ function my(e, t) {
 			let e = (n) => {
 				if (n.value != null && typeof n.value == "object") for (let r of Object.keys(n.value)) {
 					let i = {
-						path: py(n.path, r),
+						path: Py(n.path, r),
 						value: n.value[r]
 					};
 					t.push(i), e(i);
@@ -16640,16 +16940,16 @@ function my(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) => {
-				fy(e.filter, n) && t.push({
-					path: py(r.path, i),
+				Ny(e.filter, n) && t.push({
+					path: Py(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];
-				fy(e.filter, i) && t.push({
-					path: py(r.path, n),
+				Ny(e.filter, i) && t.push({
+					path: Py(r.path, n),
 					value: i
 				});
 			}
@@ -16658,7 +16958,7 @@ function my(e, t) {
 	}
 	return n;
 }
-function hy(e, t) {
+function Iy(e, t) {
 	let n = e.length, r = t.length;
 	if (!n) return r;
 	if (!r) return n;
@@ -16674,7 +16974,7 @@ function hy(e, t) {
 	}
 	return i[r];
 }
-function gy(e, t, n = {}) {
+function Ly(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");
@@ -16684,11 +16984,11 @@ function gy(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, py(l, t), String(t)));
-			else for (let t of Object.keys(e)) c(e[t], py(l, t), t);
+			if (Array.isArray(e)) e.forEach((e, t) => c(e, Py(l, t), String(t)));
+			else for (let t of Object.keys(e)) c(e[t], Py(l, t), t);
 			return;
 		}
-		let d = String(e), f = _y(d, t, r, n.fuzzyThreshold ?? 2, s);
+		let d = String(e), f = Ry(d, t, r, n.fuzzyThreshold ?? 2, s);
 		if (f) {
 			o.push({
 				path: l,
@@ -16699,7 +16999,7 @@ function gy(e, t, n = {}) {
 			return;
 		}
 		if (a && u) {
-			let e = _y(u, t, r, n.fuzzyThreshold ?? 2, s);
+			let e = Ry(u, t, r, n.fuzzyThreshold ?? 2, s);
 			e && o.push({
 				path: l,
 				key: u,
@@ -16710,18 +17010,18 @@ function gy(e, t, n = {}) {
 	};
 	return c(e, ""), o;
 }
-function _y(e, t, n, r, i) {
+function Ry(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 = hy(a, o);
+		let e = Iy(a, o);
 		return e <= r ? r - e + 1 : null;
 	}
 	return null;
 }
-var vy = [
+var zy = [
 	"self.fetch = () => { throw new Error('fetch 已被沙箱禁用') }",
 	"self.XMLHttpRequest = function(){ throw new Error('XMLHttpRequest 已被沙箱禁用') }",
 	"self.importScripts = () => { throw new Error('importScripts 已被沙箱禁用') }",
@@ -16734,7 +17034,7 @@ var vy = [
 	"try { self.BroadcastChannel = undefined } catch {}",
 	"if (self.navigator && self.navigator.sendBeacon) self.navigator.sendBeacon = () => { throw new Error('sendBeacon 已被沙箱禁用') }"
 ].join("\n");
-function yy(e, t, n = 3e3) {
+function By(e, t, n = 3e3) {
 	return new Promise((r) => {
 		let i = Date.now(), a = !1, o = (e) => {
 			if (!a) {
@@ -16747,7 +17047,7 @@ function yy(e, t, n = 3e3) {
 					elapsedMs: Date.now() - i
 				});
 			}
-		}, s = vy + "\nself.onmessage = async (e) => {\n  try {\n    const fn = new Function(\"data\", e.data.script);\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 = zy + "\nself.onmessage = async (e) => {\n  try {\n    const fn = new Function(\"data\", e.data.script);\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);
@@ -16781,135 +17081,8 @@ function yy(e, t, n = 3e3) {
 	});
 }
 //#endregion
-//#region src/core/tools/jsonUtils.ts
-var by = /* @__PURE__ */ new Set([
-	"__proto__",
-	"constructor",
-	"prototype"
-]);
-function xy(e) {
-	return e.split(".").some((e) => by.has(e));
-}
-function Sy(e, t) {
-	if (!(!t || typeof t != "object" || Array.isArray(t))) for (let n of Object.keys(t)) by.has(n) || (e[n] = t[n]);
-}
-function Cy(e, t) {
-	if (!t) return e;
-	if (xy(t)) return;
-	let n = t.split("."), r = e;
-	for (let e of n) {
-		if (r == null) return;
-		r = r[e];
-	}
-	return r;
-}
-function wy(e, t, n) {
-	if (!t || xy(t)) return;
-	let r = t.split("."), i = e;
-	for (let e = 0; e < r.length - 1; e++) {
-		let t = r[e];
-		(i[t] == null || typeof i[t] != "object") && (i[t] = {}), i = i[t];
-	}
-	i[r[r.length - 1]] = n;
-}
-function Ty(e, t) {
-	if (!t || xy(t)) return !1;
-	let n = t.split("."), r = e;
-	for (let e = 0; e < n.length - 1; e++) {
-		if (r == null) return !1;
-		r = r[n[e]];
-	}
-	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 Ey(e) {
-	return e === void 0 ? void 0 : JSON.parse(JSON.stringify(e));
-}
-function Dy(e) {
-	if (typeof e != "string") return { parsed: e };
-	let t = e.trim();
-	if (!t) return { parsed: e };
-	let n = t[0] === "{" || t[0] === "[";
-	try {
-		return { parsed: JSON.parse(t) };
-	} catch (t) {
-		return n ? { parseError: t } : { parsed: e };
-	}
-}
-function Oy(e, t) {
-	if (typeof e != "object" || !e) return e;
-	let n = new Set(t);
-	if (Array.isArray(e)) return e.map((e) => Oy(e, t));
-	let r = {};
-	for (let t of Object.keys(e)) n.has(t) && (r[t] = e[t]);
-	return r;
-}
-function ky(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) => ky(e, t - 1));
-	let n = {};
-	for (let r of Object.keys(e)) n[r] = ky(e[r], t - 1);
-	return n;
-}
-function Ay(e, t = Infinity) {
-	let n = /* @__PURE__ */ new WeakSet(), r;
-	try {
-		r = JSON.stringify(e, (e, t) => {
-			if (typeof t == "function") return "[Function]";
-			if (typeof t == "bigint") return t.toString();
-			if (typeof t == "object" && t) {
-				if (typeof HTMLElement < "u" && t instanceof HTMLElement) return `[HTMLElement: <${t.tagName.toLowerCase()}>]`;
-				if (typeof Node < "u" && t instanceof Node) return `[Node: type=${t.nodeType}]`;
-				if (n.has(t)) return "[Circular]";
-				n.add(t);
-			}
-			return t;
-		}, 0);
-	} catch (e) {
-		r = `[无法序列化: ${e?.message || String(e)}]`;
-	}
-	return r.length > t && (r = r.slice(0, t) + `\n…[已截断,原长度 ${r.length}]`), r;
-}
-function jy(e) {
-	let t = Ay(e), n = 5381;
-	for (let e = 0; e < t.length; e++) n = (n << 5) + n + t.charCodeAt(e) >>> 0;
-	return n.toString(36);
-}
-function My(e, t, n, r) {
-	if (t === "set") return n ? (wy(e, n, r), null) : "set 操作需要 jsonPath(整体替换请用 set_data)";
-	if (t === "remove") return n ? (Ty(e, n), null) : "remove 操作需要 jsonPath";
-	if (t === "merge") {
-		let t = n ? Cy(e, n) : e;
-		return typeof t != "object" || !t || Array.isArray(t) ? `merge 目标${n ? `(${n})` : "(根)"}不是对象` : (Sy(t, r), null);
-	}
-	let i = n ? Cy(e, n) : e;
-	return Array.isArray(i) ? (Array.isArray(r) ? i.push(...r) : i.push(r), null) : `append 目标${n ? `(${n})` : "(根)"}不是数组`;
-}
-function Ny(e, t, n, r) {
-	if (t === "set") wy(e, n, r);
-	else if (t === "remove") Ty(e, n);
-	else if (t === "merge") Sy(n ? Cy(e, n) : e, r);
-	else {
-		let t = n ? Cy(e, n) : e;
-		Array.isArray(r) ? t.push(...r) : t.push(r);
-	}
-}
-function Py(e, t) {
-	typeof e == "object" && e && Fy(e, t);
-}
-function Fy(e, t) {
-	if (Array.isArray(e)) {
-		e.length = 0, Array.isArray(t) && e.push(...t);
-		return;
-	}
-	let n = t && typeof t == "object" && !Array.isArray(t) ? 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];
-}
-//#endregion
 //#region src/core/tools/schemaUtils.ts
-function Iy(e) {
+function Vy(e) {
 	let t = e;
 	for (let e = 0; e < 5 && t && t._def; e++) {
 		if (t._def.innerType) {
@@ -16926,12 +17099,12 @@ function Iy(e) {
 		return null;
 	}
 }
-function Ly(e, t, n) {
+function Hy(e, t, n) {
 	if (!n || !e) return !0;
-	let r = Ry(t);
+	let r = Uy(t);
 	for (let t of e.split(".")) {
 		if (!r) return !1;
-		if (r = Ry(r), r && r.shape && typeof r.shape == "object") {
+		if (r = Uy(r), r && r.shape && typeof r.shape == "object") {
 			let e = typeof r.shape == "function" ? r.shape() : r.shape;
 			if (!(t in e)) return !1;
 			r = e[t];
@@ -16940,7 +17113,7 @@ function Ly(e, t, n) {
 	}
 	return !0;
 }
-function Ry(e) {
+function Uy(e) {
 	let t = e;
 	for (let e = 0; e < 8 && t && t._def; e++) {
 		if (t._def.innerType) {
@@ -16959,35 +17132,35 @@ function Ry(e) {
 	}
 	return t;
 }
-function zy(e, t) {
+function Wy(e, t) {
 	if (!t) return e;
-	let n = Ry(e), r = t.split(".");
+	let n = Uy(e), r = t.split(".");
 	for (let e of r) {
 		if (!n) return null;
-		if (n = Ry(n), n && n.shape && typeof n.shape == "object") n = (typeof n.shape == "function" ? n.shape() : n.shape)[e];
+		if (n = Uy(n), n && n.shape && typeof n.shape == "object") n = (typeof n.shape == "function" ? n.shape() : n.shape)[e];
 		else if (n && (n._def?.type || n.element)) n = n.element ?? n._def?.type;
 		else return null;
 	}
 	return n ?? null;
 }
-function By(e, t) {
+function Gy(e, t) {
 	if (typeof e != "object" || !e || !t) return e;
-	let n = Ry(t);
+	let n = Uy(t);
 	if (!n || !n.shape) {
 		if (Array.isArray(e) && (n?._def?.type || n?.element)) {
 			let t = n.element ?? n._def?.type;
-			return e.map((e) => By(e, t));
+			return e.map((e) => Gy(e, t));
 		}
 		return e;
 	}
 	let r = typeof n.shape == "function" ? n.shape() : n.shape, i = {};
 	for (let t of Object.keys(e)) if (t in r) {
 		let n = e[t];
-		i[t] = By(n, r[t]);
+		i[t] = Gy(n, r[t]);
 	}
 	return i;
 }
-function Vy(e, t) {
+function Ky(e, t) {
 	if (!t || typeof e != "object" || !e || Array.isArray(e)) return e;
 	let n = new Set(t), r = {};
 	for (let t of Object.keys(e)) n.has(t) && (r[t] = e[t]);
@@ -16995,25 +17168,25 @@ function Vy(e, t) {
 }
 //#endregion
 //#region src/core/tools/dataOps.ts
-var Hy = /* @__PURE__ */ new Set([
+var qy = /* @__PURE__ */ new Set([
 	"describe_data",
 	"get_data",
 	"set_data",
 	"edit_data",
 	"delete_data"
-]), Uy = /* @__PURE__ */ new Set(["read", "write"]);
-function Wy(e, t = "simple") {
-	return t === "advanced" ? e : t === "minimal" ? e.filter((e) => Uy.has(e.name)) : e.filter((e) => !Hy.has(e.name));
+]), Jy = /* @__PURE__ */ new Set(["read", "write"]);
+function Yy(e, t = "simple") {
+	return t === "advanced" ? e : t === "minimal" ? e.filter((e) => Jy.has(e.name)) : e.filter((e) => !qy.has(e.name));
 }
-function Gy(e, n = {}) {
-	let i = e.schema, a = e.bind, o = e.description ?? "主数据对象", s = Iy(i), c = [], l = n.maxSnapshots ?? 20, u, d = n.autoLock !== !1, f = {
+function Xy(e, n = {}) {
+	let i = e.schema, a = e.bind, o = e.description ?? "主数据对象", s = Vy(i), c = [], l = n.maxSnapshots ?? 20, u, d = n.autoLock !== !1, f = {
 		get: () => ({
 			schema: i,
 			bind: a,
 			description: o
 		}),
 		set: (e) => {
-			i = e.schema, a = e.bind, o = e.description ?? "主数据对象", s = Iy(i), c.length = 0, u = void 0;
+			i = e.schema, a = e.bind, o = e.description ?? "主数据对象", s = Vy(i), c.length = 0, u = void 0;
 		},
 		update: (e) => {
 			a = e, c.length = 0, u = void 0;
@@ -17022,7 +17195,7 @@ function Gy(e, n = {}) {
 		n.onAudit?.(e);
 	};
 	function m(e, t) {
-		let n = Ey(a), r = c.length ? c[c.length - 1].id + 1 : 1;
+		let n = ry(a), r = c.length ? c[c.length - 1].id + 1 : 1;
 		for (c.push({
 			id: r,
 			ts: Date.now(),
@@ -17034,12 +17207,12 @@ function Gy(e, n = {}) {
 	}
 	async function h(e, t, r) {
 		if (!t || t === "") return null;
-		let i = jy(a);
+		let i = cy(a);
 		if (i === t) return null;
 		if (!n.onConflict) return $({
 			code: "VERSION_CONFLICT",
 			message: `乐观锁冲突:expectedHash=${t} 但当前 hash=${i}。主数据在你 read 之后已被修改(外部代码/其他 agent/用户手动改)。`,
-			hint: `重新 read 拿最新值与 hash,基于最新值修改后再写入(传新的 expectedHash)。当前值:${Ay(a, 400)}`
+			hint: `重新 read 拿最新值与 hash,基于最新值修改后再写入(传新的 expectedHash)。当前值:${sy(a, 400)}`
 		});
 		let o = await n.onConflict({
 			op: e,
@@ -17049,11 +17222,11 @@ function Gy(e, n = {}) {
 			expectedHash: t,
 			snapshotId: 0
 		});
-		if (o.action === "keep_external") return `已保留外部修改(未写入)。当前值:${Ay(a, 400)} (hash=${i})。请重新 read 拿最新值与 hash 再改。`;
+		if (o.action === "keep_external") return `已保留外部修改(未写入)。当前值:${sy(a, 400)} (hash=${i})。请重新 read 拿最新值与 hash 再改。`;
 		if (o.action === "restore") {
-			if (!c.length) return `无历史快照可回退(本次为首次操作)。当前值:${Ay(a, 400)} (hash=${i})。请重新 read 再改或选「强制覆盖」。`;
+			if (!c.length) return `无历史快照可回退(本次为首次操作)。当前值:${sy(a, 400)} (hash=${i})。请重新 read 再改或选「强制覆盖」。`;
 			let e = c[c.length - 1];
-			return Py(a, Ey(e.value)), `已回退主数据到历史快照 #${e.id}[${e.op}]。当前值:${Ay(a, 400)} (hash=${jy(a)})。请基于回退后的值重写或停止。`;
+			return dy(a, ry(e.value)), `已回退主数据到历史快照 #${e.id}[${e.op}]。当前值:${sy(a, 400)} (hash=${cy(a)})。请基于回退后的值重写或停止。`;
 		}
 		return null;
 	}
@@ -17065,15 +17238,15 @@ function Gy(e, n = {}) {
 		}),
 		r(async ({ jsonPath: e }) => {
 			let t = e || "";
-			if (!Ly(t, i, s)) return $({
+			if (!Hy(t, i, s)) return $({
 				code: "PATH_DENIED",
 				message: `get_data @ "${t}" 不在 schema 声明字段内(仅 schema 声明的 key 可读)`,
 				hint: "主数据仅暴露 schema 声明的字段;若需操作该字段,集成方需在 schema 中声明它"
 			});
-			let n = t ? Cy(a, t) : a;
-			t || (n = Vy(n, s));
-			let r = jy(a);
-			return u = r, n === void 0 ? `主数据${t ? ` @ ${t}` : ""} = (undefined) (hash=${r})` : `主数据${t ? ` @ ${t}` : ""} = ${Ay(n)} (hash=${r})`;
+			let n = t ? ey(a, t) : a;
+			t || (n = Ky(n, s));
+			let r = cy(a);
+			return u = r, n === void 0 ? `主数据${t ? ` @ ${t}` : ""} = (undefined) (hash=${r})` : `主数据${t ? ` @ ${t}` : ""} = ${sy(n)} (hash=${r})`;
 		}, {
 			name: "get_data",
 			description: "读取主数据的当前值(安全序列化:函数/DOM/循环引用做摘要;大结果由系统自动外存,提示用 vfs_read 回读)。返回含 hash(乐观锁):改前先 read/get 拿 hash,写入时传 expectedHash 回传,系统对比当前 hash 防\"基于过期值覆盖\"。jsonPath 可选:读整个主数据不传,读子路径传(如 components.0.text)。",
@@ -17082,19 +17255,19 @@ function Gy(e, n = {}) {
 		r(async ({ value: e, expectedHash: t }) => {
 			let n = await h("set", t || (d ? u : void 0));
 			if (n !== null) return n;
-			let r, o = Dy(e);
-			if (o.parseError) return Yv("", e, o.parseError);
+			let r, o = iy(e);
+			if (o.parseError) return Xv("", e, o.parseError);
 			r = o.parsed;
 			let c = i.safeParse(r);
 			return c.success ? typeof a != "object" || !a ? $({
 				code: "LEAF_BIND",
 				message: `主数据 bind 为原始类型(${a === null ? "null" : typeof a}),set_data 无法就地替换外部持有的值引用`,
 				hint: "主数据 bind 必须为对象/数组(低代码主 JSON 本就是);叶子值请用对象包裹(如 {value:\"x\"})或集成方通过 sdk.setData 替换 bind"
-			}) : (m("set"), c.data !== null && typeof c.data == "object" && (s ? Sy(a, c.data) : Fy(a, c.data)), p({
+			}) : (m("set"), c.data !== null && typeof c.data == "object" && (s ? $v(a, c.data) : fy(a, c.data)), p({
 				op: "set",
 				value: c.data,
 				timestamp: Date.now()
-			}), u = jy(a), `已设置主数据 = ${Ay(c.data, 600)} (新 hash=${jy(a)})${s ? "(白名单模式:仅更新 schema 声明字段,未声明字段保留)" : ""}`) : Jv("", c.error.issues);
+			}), u = cy(a), `已设置主数据 = ${sy(c.data, 600)} (新 hash=${cy(a)})${s ? "(白名单模式:仅更新 schema 声明字段,未声明字段保留)" : ""}`) : Yv("", c.error.issues);
 		}, {
 			name: "set_data",
 			description: "设置主数据的值(整体替换)。value 为 JSON 对象(或 JSON 字符串),需通过 schema 校验。校验失败会返回错误而非写入。expectedHash(可选):改前 read/get 返回的 hash,传入则启用乐观锁;不传时系统自动用你最后一次读到的 hash 比对(autoLock,默认开)。大对象/数组强烈建议改用 edit_data 增量 patch。",
@@ -17105,12 +17278,12 @@ function Gy(e, n = {}) {
 		}),
 		r(async ({ op: e, jsonPath: t, value: n, expectedHash: r }) => {
 			let o = t || "";
-			if (xy(o)) return $({
+			if (Qv(o)) return $({
 				code: "PATH_UNSAFE",
 				message: `jsonPath "${o}" 含非法段(__proto__/constructor/prototype)`,
 				hint: "使用正常的属性路径,如 components.0.text(数组索引用数字)"
 			});
-			if (!Ly(o, i, s)) return $({
+			if (!Hy(o, i, s)) return $({
 				code: "PATH_DENIED",
 				message: `edit_data @ "${o}" 不在 schema 声明字段内`,
 				hint: "仅 schema 声明的 key 可写;若需操作该字段,集成方需在 schema 中声明它"
@@ -17129,23 +17302,23 @@ function Gy(e, n = {}) {
 					message: `${e} 操作需要 value`,
 					hint: `op 为 ${e} 时 value 必填;删除请用 op:'remove'`
 				});
-				let t = Dy(n);
-				if (t.parseError) return Yv("", n, t.parseError);
+				let t = iy(n);
+				if (t.parseError) return Xv("", n, t.parseError);
 				l = t.parsed;
 			}
-			let f = Ey(a), g = My(f, e, o, l);
+			let f = ry(a), g = ly(f, e, o, l);
 			if (g) return $({
 				code: "PATCH_FAILED",
 				message: g,
 				hint: "检查 op 与目标类型:merge 需对象,append 需数组;jsonPath 指向需存在"
 			});
 			let _ = i.safeParse(f);
-			return _.success ? (m("edit"), Ny(a, e, o, l), p({
+			return _.success ? (m("edit"), uy(a, e, o, l), p({
 				op: "edit",
 				detail: `${e}${o ? "@" + o : ""}`,
 				value: l,
 				timestamp: Date.now()
-			}), u = jy(a), `已 edit 主数据(${e}${o ? " @ " + o : ""})。当前值:${Ay(a, 600)} (新 hash=${jy(a)})`) : Jv("", _.error.issues);
+			}), u = cy(a), `已 edit 主数据(${e}${o ? " @ " + o : ""})。当前值:${sy(a, 600)} (新 hash=${cy(a)})`) : Yv("", _.error.issues);
 		}, {
 			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,默认开)防\"基于过期值覆盖\"。",
@@ -17167,12 +17340,12 @@ function Gy(e, n = {}) {
 				message: "delete_data 需要 jsonPath 指定要删的子路径(主数据整体不可删,用 set_data 整体替换)",
 				hint: "如 jsonPath:\"components.0\" 删数组首项"
 			});
-			if (xy(e)) return $({
+			if (Qv(e)) return $({
 				code: "PATH_UNSAFE",
 				message: `jsonPath "${e}" 含非法段`,
 				hint: "使用正常属性路径"
 			});
-			if (!Ly(e, i, s)) return $({
+			if (!Hy(e, i, s)) return $({
 				code: "PATH_DENIED",
 				message: `delete_data @ "${e}" 不在 schema 声明字段内`,
 				hint: "仅 schema 声明的 key 可删"
@@ -17180,12 +17353,12 @@ function Gy(e, n = {}) {
 			let n = await h("delete", t || (d ? u : void 0));
 			if (n !== null) return n;
 			m("delete");
-			let r = Ty(a, e);
+			let r = ny(a, e);
 			return p({
 				op: "delete",
 				detail: e,
 				timestamp: Date.now()
-			}), u = jy(a), r ? `已删除主数据 @ ${e}` : `主数据 @ ${e} 不存在(无需删除)`;
+			}), u = cy(a), r ? `已删除主数据 @ ${e}` : `主数据 @ ${e} 不存在(无需删除)`;
 		}, {
 			name: "delete_data",
 			description: "删除主数据的某个子路径(jsonPath)。主数据整体不可删(用 set_data 整体替换)。expectedHash(可选):改前 read/get 返回的 hash;不传时自动用你最后读到的 hash(autoLock,默认开)防\"基于过期值删除\"。",
@@ -17224,15 +17397,15 @@ function Gy(e, n = {}) {
 				hint: "用 list_data_snapshots 查看可用快照序号"
 			});
 			let n = i.safeParse(t.value);
-			return n.success ? (Py(a, Ey(t.value)), p({
+			return n.success ? (dy(a, ry(t.value)), p({
 				op: "restore",
 				detail: `#${t.id}`,
 				timestamp: Date.now()
-			}), u = jy(a), `已回退主数据到快照 #${t.id}[${t.op}]${t.label ? `(${t.label})` : ""}。`) : $({
+			}), u = cy(a), `已回退主数据到快照 #${t.id}[${t.op}]${t.label ? `(${t.label})` : ""}。`) : $({
 				code: "SNAPSHOT_SCHEMA_INVALID",
 				message: `快照 #${t.id} 的值不符合当前 schema,无法回退`,
 				hint: "schema 可能已变更;该快照已过期,选其他快照或重新设置",
-				details: qv(n.error.issues)
+				details: Jv(n.error.issues)
 			});
 		}, {
 			name: "restore_data",
@@ -17245,9 +17418,9 @@ function Gy(e, n = {}) {
 				message: `主数据不是对象/数组,无法查询(当前为 ${a === void 0 ? "undefined" : typeof a})`,
 				hint: "query 仅适用于对象/数组;叶子用 get_data 读"
 			});
-			let n = s ? Vy(a, s) : a, r;
+			let n = s ? Ky(a, s) : a, r;
 			try {
-				r = my(n, e);
+				r = Fy(n, e);
 			} catch (t) {
 				return $({
 					code: "JSONPATH_SYNTAX",
@@ -17256,7 +17429,7 @@ function Gy(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":${Ay(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":${sy(e.value)}}`);
 			return `{"matched":${r.length},"returned":${o.length},"truncated":${r.length > i},"results":[${c.join(",")}]}`;
 		}, {
 			name: "query_data",
@@ -17272,13 +17445,13 @@ function Gy(e, n = {}) {
 				message: "主数据为空,无可搜索内容"
 			});
 			try {
-				let o = gy(s ? Vy(a, s) : a, e, {
+				let o = Ly(s ? Ky(a, s) : a, e, {
 					mode: t,
 					fuzzyThreshold: n,
 					matchKey: r,
 					limit: i ?? 50
 				});
-				return Ay({
+				return sy({
 					matched: o.length,
 					results: o
 				});
@@ -17311,7 +17484,7 @@ function Gy(e, n = {}) {
 				message: `脚本过长(${e.length} 字符,上限 8000)`,
 				hint: "精简脚本;复杂逻辑可分步(先 query 探查再 transform 改),或拆成多次 eval"
 			});
-			let n = await yy(Ey(s ? Vy(a, s) : a), e, 3e3);
+			let n = await By(ry(s ? Ky(a, s) : a), e, 3e3);
 			if (!n.ok) {
 				let t = /超时/.test(n.error || "");
 				return $({
@@ -17332,15 +17505,15 @@ function Gy(e, n = {}) {
 						message: `主数据 bind 为原始类型(${a === null ? "null" : typeof a}),eval transform(patches) 无法就地替换`,
 						hint: "主数据 bind 必须为对象/数组;叶子值请用对象包裹或集成方通过 sdk.setData 替换 bind"
 					});
-					let t = e.patches, r = Ey(a), o = [];
+					let t = e.patches, r = ry(a), o = [];
 					for (let e = 0; e < t.length; e++) {
 						let n = t[e], a = n.jsonPath || "";
-						if (xy(a)) return $({
+						if (Qv(a)) return $({
 							code: "PATH_UNSAFE",
 							message: `patches[${e}] jsonPath "${a}" 含非法段`,
 							hint: "使用正常属性路径"
 						});
-						if (!Ly(a, i, s)) return $({
+						if (!Hy(a, i, s)) return $({
 							code: "PATH_DENIED",
 							message: `patches[${e}] @ "${a}" 不在 schema 声明字段内`,
 							hint: "仅 schema 声明的 key 可写"
@@ -17352,11 +17525,11 @@ function Gy(e, n = {}) {
 								message: `patches[${e}] ${c} 操作需要 value`,
 								hint: `op 为 ${c} 时 value 必填`
 							});
-							let t = Dy(n.value);
-							if (t.parseError) return Yv(`patches[${e}]`, n.value, t.parseError);
+							let t = iy(n.value);
+							if (t.parseError) return Xv(`patches[${e}]`, n.value, t.parseError);
 							l = t.parsed;
 						}
-						let u = My(r, c, a, l);
+						let u = ly(r, c, a, l);
 						if (u) return $({
 							code: "PATCH_FAILED",
 							message: `patches[${e}]: ${u}`,
@@ -17373,33 +17546,33 @@ function Gy(e, n = {}) {
 						code: "SCHEMA_INVALID",
 						message: "脚本 patches 应用后整体校验失败,未写入",
 						hint: "确认 patches 合并后整体仍符合 schema",
-						details: qv(c.error.issues)
+						details: Jv(c.error.issues)
 					});
 					m("edit", "eval_transform");
-					for (let e of o) Ny(a, e.op, e.jp, e.value);
+					for (let e of o) uy(a, e.op, e.jp, e.value);
 					return p({
 						op: "edit",
 						detail: `eval_transform(${o.length} patches)`,
 						timestamp: Date.now()
-					}), u = jy(a), `已通过脚本 transform(patches) 更新主数据(${o.length} 个 patch,耗时 ${n.elapsedMs}ms)。当前值: ${Ay(a, 600)}`;
+					}), u = cy(a), `已通过脚本 transform(patches) 更新主数据(${o.length} 个 patch,耗时 ${n.elapsedMs}ms)。当前值: ${sy(a, 600)}`;
 				}
 				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 ? Sy(a, t.data) : Fy(a, t.data)), p({
+				}) : (m("edit", "eval_transform"), t.data !== null && typeof t.data == "object" && (s ? $v(a, t.data) : fy(a, t.data)), p({
 					op: "edit",
 					detail: "eval_transform",
 					timestamp: Date.now()
-				}), u = jy(a), `已通过脚本 transform 更新主数据(耗时 ${n.elapsedMs}ms)。当前值: ${Ay(a, 600)}`) : $({
+				}), u = cy(a), `已通过脚本 transform 更新主数据(耗时 ${n.elapsedMs}ms)。当前值: ${sy(a, 600)}`) : $({
 					code: "SCHEMA_INVALID",
 					message: "脚本返回值校验失败,未写入(transform 模式要求返回主数据的完整新值且符合 schema)",
 					hint: "确认脚本 return 了完整新值(非部分);或返回 {patches:[...]} 走增量模式;按 describe_data() 查看格式",
-					details: qv(t.error.issues)
+					details: Jv(t.error.issues)
 				});
 			}
-			return Ay({
+			return sy({
 				ok: !0,
 				result: n.result,
 				elapsedMs: n.elapsedMs
@@ -17414,16 +17587,16 @@ function Gy(e, n = {}) {
 		}),
 		r(async ({ jsonPath: e, fields: t, depth: r }) => {
 			let c = e || "";
-			if (!Ly(c, i, s)) return $({
+			if (!Hy(c, i, s)) return $({
 				code: "PATH_DENIED",
 				message: `read @ "${c}" 不在 schema 声明字段内`,
 				hint: "主数据仅暴露 schema 声明的字段;若需操作该字段,集成方需在 schema 中声明它"
 			});
-			let l = c ? Cy(a, c) : a;
-			if (!c) l = Vy(l, s);
+			let l = c ? ey(a, c) : a;
+			if (!c) l = Ky(l, s);
 			else if (s) {
-				let e = zy(i, c);
-				e && (l = By(l, e));
+				let e = Wy(i, c);
+				e && (l = Gy(l, e));
 			}
 			let d = l;
 			if (n.interceptors?.read) try {
@@ -17434,11 +17607,11 @@ function Gy(e, n = {}) {
 					message: `read 拦截器抛错: ${e.message}`
 				});
 			}
-			t && t.length && (d = Oy(d, t)), r != null && (d = ky(d, r));
-			let f = jy(a);
+			t && t.length && (d = ay(d, t)), r != null && (d = oy(d, r));
+			let f = cy(a);
 			u = f;
 			let p = t && t.length ? `(字段裁剪:${t.join(",")})` : "", m = r == null ? "" : `(深度≤${r})`, h = p || m ? ` ${p}${m}` : "", g = e ? "" : `主数据说明: ${o}\n格式: 写入值需为 JSON,且通过声明的 schema 校验(校验失败时 write 会返回结构化错误)。\n\n`;
-			return d === void 0 ? `${g}主数据${e ? ` @ ${e}` : ""}${h} = (undefined) (hash=${f})` : `${g}主数据${e ? ` @ ${e}` : ""}${h} = ${Ay(d)} (hash=${f})`;
+			return d === void 0 ? `${g}主数据${e ? ` @ ${e}` : ""}${h} = (undefined) (hash=${f})` : `${g}主数据${e ? ` @ ${e}` : ""}${h} = ${sy(d)} (hash=${f})`;
 		}, {
 			name: "read",
 			description: "读取主数据(高层入口,合并 describe/get)。不传 jsonPath → 返回主数据说明 + 格式提示;传 jsonPath → 返回该子路径当前值 + hash。hash 用于乐观锁(默认 autoLock,write 时自动比对,无需手动传)。fields(可选):字段裁剪,只返回对象(及数组元素)的指定字段,减少大对象返回体积;depth(可选):嵌套深度限制(0=只根占位,1=根+子,递归截断深层),减少深层结构返回体积。两者可组合,先裁字段再截深度。集成方可能经 read 拦截器对返回值脱敏/派生。",
@@ -17484,12 +17657,12 @@ function Gy(e, n = {}) {
 					message: "delete 需要 patch.jsonPath 指定要删的子路径(主数据整体不可删,用 write(value) 整体替换)",
 					hint: "如 patch:{jsonPath:\"components.0\"}, del:true"
 				});
-				if (xy(t.jsonPath)) return $({
+				if (Qv(t.jsonPath)) return $({
 					code: "PATH_UNSAFE",
 					message: `jsonPath "${t.jsonPath}" 含非法段`,
 					hint: "使用正常属性路径"
 				});
-				if (!Ly(t.jsonPath, i, s)) return $({
+				if (!Hy(t.jsonPath, i, s)) return $({
 					code: "PATH_DENIED",
 					message: `write delete @ "${t.jsonPath}" 不在 schema 声明字段内`,
 					hint: "仅 schema 声明的 key 可删"
@@ -17497,12 +17670,12 @@ function Gy(e, n = {}) {
 				let e = await h("delete", g);
 				if (e !== null) return e;
 				m("delete");
-				let n = Ty(a, t.jsonPath);
+				let n = ny(a, t.jsonPath);
 				return p({
 					op: "delete",
 					detail: t.jsonPath,
 					timestamp: Date.now()
-				}), u = jy(a), n ? `已删除主数据 @ ${t.jsonPath}` : `主数据 @ ${t.jsonPath} 不存在(无需删除)`;
+				}), u = cy(a), n ? `已删除主数据 @ ${t.jsonPath}` : `主数据 @ ${t.jsonPath} 不存在(无需删除)`;
 			}
 			if (c === "edit") {
 				if (typeof a != "object" || !a) return $({
@@ -17516,15 +17689,15 @@ function Gy(e, n = {}) {
 					op: t.op,
 					jsonPath: t.jsonPath || "",
 					value: l
-				}]), o = Ey(a), c = [];
+				}]), o = ry(a), c = [];
 				for (let e = 0; e < n.length; e++) {
 					let t = n[e], r = t.jsonPath || "";
-					if (xy(r)) return $({
+					if (Qv(r)) return $({
 						code: "PATH_UNSAFE",
 						message: `patches[${e}] jsonPath "${r}" 含非法段`,
 						hint: "使用正常属性路径,如 components.0.text"
 					});
-					if (!Ly(r, i, s)) return $({
+					if (!Hy(r, i, s)) return $({
 						code: "PATH_DENIED",
 						message: `patches[${e}] @ "${r}" 不在 schema 声明字段内`,
 						hint: "仅 schema 声明的 key 可写"
@@ -17536,11 +17709,11 @@ function Gy(e, n = {}) {
 							message: `patches[${e}] ${a} 操作需要 value`,
 							hint: `op 为 ${a} 时 value 必填;删除请用 op:'remove'`
 						});
-						let n = Dy(t.value);
-						if (n.parseError) return Yv(`patches[${e}]`, t.value, n.parseError);
+						let n = iy(t.value);
+						if (n.parseError) return Xv(`patches[${e}]`, t.value, n.parseError);
 						l = n.parsed;
 					}
-					let u = My(o, a, r, l);
+					let u = ly(o, a, r, l);
 					if (u) return $({
 						code: "PATCH_FAILED",
 						message: `patches[${e}]: ${u}`,
@@ -17553,18 +17726,18 @@ function Gy(e, n = {}) {
 					});
 				}
 				let d = i.safeParse(o);
-				if (!d.success) return Jv("", d.error.issues);
+				if (!d.success) return Yv("", d.error.issues);
 				m("edit");
-				for (let e of c) Ny(a, e.op, e.jp, e.value);
+				for (let e of c) uy(a, e.op, e.jp, e.value);
 				return p({
 					op: "edit",
 					detail: `${c.length} 个 patch${c.length > 1 ? "(批量)" : ""}`,
 					value: c.map((e) => `${e.op}@${e.jp}`),
 					timestamp: Date.now()
-				}), u = jy(a), `已 write(edit) 主数据(${c.length} 个 patch)。当前值:${Ay(a, 600)} (新 hash=${jy(a)})`;
+				}), u = cy(a), `已 write(edit) 主数据(${c.length} 个 patch)。当前值:${sy(a, 600)} (新 hash=${cy(a)})`;
 			}
-			let _, v = Dy(l);
-			if (v.parseError) return Yv("", l, v.parseError);
+			let _, v = iy(l);
+			if (v.parseError) return Xv("", l, v.parseError);
 			_ = v.parsed;
 			let y = await h("set", g);
 			if (y !== null) return y;
@@ -17573,11 +17746,11 @@ function Gy(e, n = {}) {
 				code: "LEAF_BIND",
 				message: `主数据 bind 为原始类型(${a === null ? "null" : typeof a}),write(set) 无法就地替换外部持有的值引用`,
 				hint: "主数据 bind 必须为对象/数组;叶子值请用对象包裹(如 {value:\"x\"})或集成方通过 sdk.setData 替换 bind"
-			}) : (m("set"), b.data !== null && typeof b.data == "object" && (s ? Sy(a, b.data) : Fy(a, b.data)), p({
+			}) : (m("set"), b.data !== null && typeof b.data == "object" && (s ? $v(a, b.data) : fy(a, b.data)), p({
 				op: "set",
 				value: b.data,
 				timestamp: Date.now()
-			}), u = jy(a), `已 write(set) 主数据 = ${Ay(b.data, 600)} (新 hash=${jy(a)})${s ? "(白名单模式:仅更新 schema 声明字段,未声明字段保留)" : ""}`) : Jv("", b.error.issues);
+			}), u = cy(a), `已 write(set) 主数据 = ${sy(b.data, 600)} (新 hash=${cy(a)})${s ? "(白名单模式:仅更新 schema 声明字段,未声明字段保留)" : ""}`) : Yv("", b.error.issues);
 		}, {
 			name: "write",
 			description: "写入主数据(高层入口,合并 set/edit/delete + 自动乐观锁 + 自动快照)。四种意图:① 整体替换 write({ value }) value 为 JSON 对象(推荐)或字符串;② 单个增量 patch write({ value, patch:{op,jsonPath} }) op=set/remove/merge/append,jsonPath 相对主数据根(如 components.0.text),value 作为该 patch 的值;③ 批量增量 write({ patches:[{op,jsonPath,value},...] }) 一次原子应用多个 patch(任一失败整体不写入,适合一次改多处);④ 删除 write({ patch:{jsonPath}, del:true })。写入自动经 schema 校验(失败不写)+ 自动存快照(可 restore_data 回退)+ 自动乐观锁(autoLock,用你最后 read 到的 hash 比对,冲突则 VERSION_CONFLICT)。集成方可能经 write 拦截器校验/转换/拒绝(批量模式拦截器收到 {patches},返回新 patches 数组或 {error})。",
@@ -17615,8 +17788,8 @@ function Gy(e, n = {}) {
 }
 //#endregion
 //#region src/core/tools/fetchDoc.ts
-var Ky = 3e4, qy = [r(async ({ url: e, as: t }) => {
-	let n = new AbortController(), r = setTimeout(() => n.abort(), Ky);
+var Zy = 3e4, Qy = [r(async ({ url: e, as: t }) => {
+	let n = new AbortController(), r = setTimeout(() => n.abort(), Zy);
 	try {
 		let r = await fetch(e, {
 			method: "GET",
@@ -17633,7 +17806,7 @@ var Ky = 3e4, qy = [r(async ({ url: e, as: t }) => {
 		].join("\n");
 	} catch (t) {
 		let r = t?.message || String(t);
-		return n.signal.aborted ? `获取失败:请求超时(${Ky}ms,${e})。` : /Failed to fetch|NetworkError|CORS|blocked/i.test(r) ? `获取失败:可能是 CORS 跨域拦截或网络错误(${r})。浏览器仅能 GET 同源或服务端已配置 CORS 的资源;跨域抓取需后端代理。` : `获取失败:${r}`;
+		return n.signal.aborted ? `获取失败:请求超时(${Zy}ms,${e})。` : /Failed to fetch|NetworkError|CORS|blocked/i.test(r) ? `获取失败:可能是 CORS 跨域拦截或网络错误(${r})。浏览器仅能 GET 同源或服务端已配置 CORS 的资源;跨域抓取需后端代理。` : `获取失败:${r}`;
 	} finally {
 		clearTimeout(r);
 	}
@@ -17644,25 +17817,25 @@ var Ky = 3e4, qy = [r(async ({ url: e, as: t }) => {
 		url: t.string().describe("要抓取的 URL(同源或已配 CORS)"),
 		as: t.enum(["text", "markdown"]).optional().describe("返回格式标签,默认 text")
 	})
-})], Jy = qy;
-function Yy(e, t) {
-	return Gy(e, t);
+})], $y = Qy;
+function eb(e, t) {
+	return Xy(e, t);
 }
-function Xy(e, t, n) {
+function tb(e, t, n) {
 	let r = e?.dataOps !== !1, i = e?.fetch !== !1;
 	return [...r ? t : [], ...i ? n : []];
 }
 //#endregion
 //#region src/core/harness/usageHints.ts
-var Zy = .7;
-function Qy(e, t, n = "simple") {
+var nb = .7;
+function rb(e, t, n = "simple") {
 	let r = n !== "advanced";
 	return {
 		name: "usageHints",
 		augmentPrompt: () => {
 			let n = [];
 			if (e?.planning !== !1 && n.push("多步任务建议先 write_todos 拆解为步骤并逐步推进。"), t && (r ? (n.push("读写主数据用 read/write(高层入口,自动乐观锁 + 自动快照)。read({jsonPath}) 读子路径当前值(返回含 hash,write 时自动比对,无需手动传);read() 不传读整个主数据 + 说明。write({value}) 整体替换(value 直传 JSON 对象,如 {title:\"x\"},无需 stringify);write({value, patch:{op,jsonPath}}) 增量 patch(op=set/remove/merge/append);write({patch:{jsonPath}, del:true}) 删除子路径。写入自动经 schema 校验(失败不写)+ 自动存快照(出错可用 restore_data 回退)。"), n.push("修改大对象/数组优先用 write 的 patch 增量(只发改动部分),避免整体重传被 max_tokens 截断致 JSON 不完整。"), 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(返回值经校验后落地)。"))), e?.subagent !== !1 && n.push("独立子任务可 spawn_agent 委派(只读工具,过程不占主上下文)。"), e?.subagents?.length) {
-				let t = e.subagents.filter((e) => (e.temperature ?? 0) >= Zy || /规划|创意|设计|方案|brainstorm|plan/i.test(e.description)), i = e.subagents.filter((e) => (e.temperature ?? 0) < Zy && /反思|审查|挑刺|校验|review|critique|reflect/i.test(e.description));
+				let t = e.subagents.filter((e) => (e.temperature ?? 0) >= nb || /规划|创意|设计|方案|brainstorm|plan/i.test(e.description)), i = e.subagents.filter((e) => (e.temperature ?? 0) < nb && /反思|审查|挑刺|校验|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("  · 简单/明确任务(如\"标题改红色\")直接执行,不必走规划-反思。");
 			}
 			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("用户在选项里选了哪个,就按那个方案继续;选「拒绝」则停止并询问如何调整。")), n.length && n.unshift("调用工具务必用标准 function calling(工具调用)格式发起,不要在回复正文里输出伪 XML/标签(如 deepseek 的 tool_calls 标签、invoke、function_call、tool_call 等)或 JSON 文本——那不会被识别为工具调用,会被当普通文字,工具不执行。"), n.length ? "## 能力使用提示\n" + n.join("\n") : void 0;
@@ -17671,15 +17844,15 @@ function Qy(e, t, n = "simple") {
 }
 //#endregion
 //#region src/core/backends/skillStore.ts
-var $y = "v:1::skill-store", eb = "chat-sdk";
-function tb(e, t, n) {
-	return `${$y}::${e}::${t}::${n}`;
+var ib = "v:1::skill-store", ab = "chat-sdk";
+function ob(e, t, n) {
+	return `${ib}::${e}::${t}::${n}`;
 }
-function nb(e, t) {
-	return `${$y}::${e}::${t}::`;
+function sb(e, t) {
+	return `${ib}::${e}::${t}::`;
 }
-function rb(e = {}) {
-	let t = e.dbName ?? eb, n = e.backend ?? "indexed", r = e.id ?? "", i, a, o = new Promise((e) => {
+function cb(e = {}) {
+	let t = e.dbName ?? ab, n = e.backend ?? "indexed", r = e.id ?? "", i, a, o = new Promise((e) => {
 		a = e;
 	});
 	return (async () => {
@@ -17701,42 +17874,42 @@ function rb(e = {}) {
 		ready: o,
 		async list() {
 			let e = [];
-			return await i.scan(nb(t, r), (t, n) => {
+			return await i.scan(sb(t, r), (t, n) => {
 				e.push(n);
 			}), e;
 		},
 		async get(e) {
-			return await i.get(tb(t, r, e));
+			return await i.get(ob(t, r, e));
 		},
 		async put(e) {
 			try {
-				await i.set(tb(t, r, e.name), e);
+				await i.set(ob(t, r, e.name), e);
 			} catch (e) {
 				kv(e) && (i = Lv());
 			}
 		},
 		async remove(e) {
-			let n = tb(t, r, e);
+			let n = ob(t, r, e);
 			return await i.get(n) != null && (await i.del(n), !0);
 		},
 		async clear() {
-			await i.clearPrefix(nb(t, r));
+			await i.clearPrefix(sb(t, r));
 		},
 		dispose() {}
 	};
 }
 //#endregion
 //#region src/core/sdk/createChatSdk.ts
-var ib = 50, ab = /* @__PURE__ */ new Map();
-function ob(e, t) {
+var lb = 50, ub = /* @__PURE__ */ new Map();
+function db(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 sb(e, t, n, r) {
+function fb(e, t, n, r) {
 	let i = 0;
 	return {
 		name: "sdk-events",
 		wrapToolCall: async (t, r) => {
-			let i = await r(t), a = ob(t.name, t.args);
+			let i = await r(t), a = db(t.name, t.args);
 			return a && e({
 				type: "data_change",
 				operation: a,
@@ -17771,7 +17944,7 @@ function sb(e, t, n, r) {
 		}
 	};
 }
-function cb(e, i) {
+function pb(e, i) {
 	let a = {
 		prompt_tokens: 0,
 		completion_tokens: 0,
@@ -17782,11 +17955,12 @@ function cb(e, i) {
 	e.debug && console.log("[page-agent-sdk][modelCaps]", d);
 	let f = e.llm;
 	e.debug && !u && console.warn("[page-agent-sdk][summarization] 未构造 llmInvoke(apiKey 缺失?),摘要回退零成本索引摘要");
-	let p = /* @__PURE__ */ tn([]), m = Zv(e.vfs?.initialFiles, {
+	let p = /* @__PURE__ */ tn([]), m = gy(e.vfs?.initialFiles, {
 		persist: c ? { save: (e) => {
 			z.sessionId && c && c.save(i, z.sessionId, { vfs: e });
 		} } : void 0,
-		maxBytes: e.vfs?.maxBytes
+		maxBytes: e.vfs?.maxBytes,
+		poolBytes: e.vfs?.poolBytes
 	}), h = Kg(), g = e_(e.memory || "");
 	typeof e.memory == "function" && g.refresh();
 	let _ = { current: null }, v = e.data ? {
@@ -17800,13 +17974,13 @@ function cb(e, i) {
 		getTodos: () => _.current?.getState?.()?.todos ?? [],
 		messages: p,
 		maxCheckpoints: y && typeof y == "object" ? y.maxCheckpoints : void 0
-	}) : null, S = !y || typeof y != "object" || y.auto !== !1, C = e.capabilities, w = C?.dataOps !== !1, T = dv(e), E = w && v ? Gy(v, {
+	}) : null, S = !y || typeof y != "object" || y.auto !== !1, C = e.capabilities, w = C?.dataOps !== !1, T = dv(e), E = w && v ? Xy(v, {
 		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
-	}) : [], D = w ? Wy(E, e.toolMode) : [], O = w && v ? E.controller ?? null : null, k = () => O?.get() ?? v, A = /* @__PURE__ */ new Map(), j = Xy(C, D, qy);
+	}) : [], D = w ? Yy(E, e.toolMode) : [], O = w && v ? E.controller ?? null : null, k = () => O?.get() ?? v, A = /* @__PURE__ */ new Map(), j = tb(C, D, Qy);
 	j.forEach((e) => A.set(e.name, "builtin"));
 	let M = [...e.tools || []];
 	M.forEach((e) => A.set(e.name, "user"));
@@ -17843,7 +18017,9 @@ function cb(e, i) {
 			...ee
 		];
 	}
-	let ne = C?.planning !== !1, re = C?.skills !== !1, ie = C?.vfs !== !1, ae = C?.summarization !== !1, oe = C?.memory !== !1, se = C?.subagent !== !1, ce = e.verify?.maxAttempts ?? 2, le = C?.verify === !0 && e.verify?.enabled !== !1 && ce > 0;
+	let ne = C?.planning !== !1, re = C?.skills !== !1, ie = C?.vfs !== !1;
+	if (ie) for (let e of Cy) A.set(e, "builtin");
+	let ae = C?.summarization !== !1, oe = C?.memory !== !1, se = C?.subagent !== !1, ce = e.verify?.maxAttempts ?? 2, le = C?.verify === !0 && e.verify?.enabled !== !1 && ce > 0;
 	e.verify?.check && C?.verify !== !0 && console.warn("[page-agent-sdk][verify] 检测到 verify.check 但 capabilities.verify 未开启,verify 未装载");
 	let ue = e.subagent, L = ue?.allowedTools ?? [], de = !se || ue?.enabled === !1 ? void 0 : E_({
 		llm: ue?.llm ?? e.llm,
@@ -17874,7 +18050,7 @@ function cb(e, i) {
 			llm: e.llm,
 			tools: he
 		} : void 0
-	}) : void 0, _e = Qy({
+	}) : void 0, _e = rb({
 		...C,
 		humanConfirm: N,
 		subagents: e.subagents?.map((e) => ({
@@ -17906,7 +18082,7 @@ function cb(e, i) {
 		name: e.name,
 		description: e.description,
 		getContent: () => e.content
-	}), R = e.skillStorage === !1 ? null : rb({
+	}), R = e.skillStorage === !1 ? null : cb({
 		...typeof e.skillStorage == "object" ? e.skillStorage : {},
 		id: e.skillStorage && typeof e.skillStorage == "object" && e.skillStorage.id ? e.skillStorage.id : `agent::${i}`
 	}), De = () => {
@@ -17934,12 +18110,12 @@ function cb(e, i) {
 		_e,
 		...ne ? [h] : [],
 		...re ? [Ce = $g(e.skills || [], { readVfs: ie ? (e) => m.files[e]?.content : void 0 })] : [],
-		...ie ? [iy(m)] : [],
+		...ie ? [Ty(m)] : [],
 		...ae ? [av({
-			...Kv(e, d.contextWindow),
+			...qv(e, d.contextWindow),
 			llmInvoke: u,
 			getRegisteredData: () => k() ? [{ description: k().description ?? "主数据对象" }] : [],
-			preserveLastToolResults: (e.contextOptions && e.contextOptions.preserveLastToolResults) ?? ["describe_data", "read"]
+			preserveLastToolResults: (e.contextOptions && e.contextOptions.preserveLastToolResults) ?? Kv[e.contextPreset ?? "auto"]
 		})] : [],
 		...oe ? [g] : [],
 		...e.permissions?.length ? [a_(e.permissions)] : [],
@@ -17951,8 +18127,8 @@ function cb(e, i) {
 		...fe ? [fe] : [],
 		...ye ? [ye] : [],
 		...e.middleware || [],
-		sb(Se, p, k, a)
-	], Ae = e.maxMemoryRounds ?? ib, z = {
+		fb(Se, p, k, a)
+	], Ae = e.maxMemoryRounds ?? lb, z = {
 		agentId: i,
 		store: c,
 		messages: p,
@@ -18054,7 +18230,7 @@ function cb(e, i) {
 			if (z.refCount--, z.refCount <= 0) {
 				c && (m.flush?.(), c.flush(), c.dispose()), R && R.dispose();
 				let e = z.mcpClosers.splice(0);
-				e.length && Promise.allSettled(e.map((e) => e())), ab.delete(i);
+				e.length && Promise.allSettled(e.map((e) => e())), ub.delete(i);
 			}
 		},
 		resolveConflict: o.resolve,
@@ -18128,6 +18304,7 @@ function cb(e, i) {
 					description: k().description,
 					schema: k().schema
 				} : void 0,
+				contextPreset: e.contextPreset ?? "auto",
 				memory: g.get(),
 				middleware: ke.map((e) => e.name),
 				todos: (z.agent?.getState?.()?.todos ?? []).map((e) => ({
@@ -18243,11 +18420,11 @@ function cb(e, i) {
 		});
 	})(), z;
 }
-function lb(e) {
+function mb(e) {
 	let t = e.id ?? _v();
 	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 ? ab.get(t) : void 0;
-	a ? i = a : (i = cb(e, t), e.shareContext && ab.set(t, i)), i.refCount++;
+	let n = e.streaming ?? !0, r = e.ui ?? "default", i, a = e.shareContext ? ub.get(t) : void 0;
+	a ? i = a : (i = pb(e, t), e.shareContext && ub.set(t, i)), i.refCount++;
 	let o = null, s = null, c = Uv(e), l = null, u = null;
 	async function d(t) {
 		if (await i.initDone, o) {
@@ -18425,7 +18602,7 @@ function lb(e) {
 }
 //#endregion
 //#region src/core/sdk/defineTool.ts
-function ub(e) {
+function hb(e) {
 	return r(async (t) => {
 		let n = await e.handler(t);
 		return typeof n == "string" ? n : JSON.stringify(n);
@@ -18436,4 +18613,4 @@ function ub(e) {
 	});
 }
 //#endregion
-export { Gv as CONTEXT_PRESETS, yg as ChatDialog, nf as CodePreview, lv as DEFAULT_SYSTEM_PROMPT, s_ as HUMAN_CONFIRM_TOOL_NAME, af as MessageContent, Z_ as STOP_WORDS, sh as SkillPanel, by as UNSAFE_KEYS, My as applyPatchToClone, Ny as applyPatchToLive, uv as buildDataPrompt, dv as buildSystemPrompt, K_ as connectMcp, wl as copyText, Wg as createAgent, o_ as createApprovalMiddleware, lb as createChatSdk, __ as createCheckpointManager, v_ as createCheckpointMiddleware, gv as createConflictManager, Gy as createDataOps, u_ as createHumanConfirmMiddleware, l_ as createHumanConfirmTool, Lv as createMemoryBackend, e_ as createMemoryMiddleware, v as createProxyLlm, Wv as createSdkEvents, Vv as createSessionStore, rb as createSkillStore, E_ as createSubagentMiddleware, k_ as createSubagentsMiddleware, Qy as createUsageHintsMiddleware, A_ as createVerifyMiddleware, Zv as createVfs, zv as createWebStorageBackend, I_ as createWriteBackCheck, Ey as deepClone, Yy as defineDataToolset, qg as defineSkill, ub as defineTool, Ty as deleteByPath, zg as detectGarbledToolCall, $_ as estimateMessageTokens, ev as estimateRoundTokens, Dg as estimateTokens, cv as extractSchemaHint, U_ as extractText, qy as fetchDocTools, Jy as fetchTools, Wy as filterByToolMode, qv as formatZodIssues, Cy as getByPath, zy as getSchemaAtPath, Iy as getSchemaTopKeys, jy as hashValue, tv as indexSummarize, fv as isChatModel, Ly as isPathAllowed, kv as isQuotaError, xy as isUnsafePath, my as jpEval, Yv as jsonParseError, ky as limitDepth, Dy as maybeParseValue, kg as offloadPassThroughChars, Og as offloadThresholdChars, ov as presets, Vy as projectBySchema, By as projectBySchemaDeep, Oy as projectFields, nv as recallRounds, Kv as resolveContextOptions, Uv as resolveDialogConfig, hv as resolveLlm, Eg as resolveModelCaps, Hv as resolveStorage, Fy as restoreInPlace, Py as restoreLive, yy as runSandboxedScript, Sy as safeMerge, Ay as safeStringify, gy as searchJson, Xy as selectBuiltinTools, wy as setByPath, sv as systemPromptHelpers, Q_ as tokenize, $ as toolError, Ry as unwrapSchema, Cl as useChat, e as z, Jv as zodError };
+export { Gv as CONTEXT_PRESETS, yg as ChatDialog, nf as CodePreview, lv as DEFAULT_SYSTEM_PROMPT, s_ as HUMAN_CONFIRM_TOOL_NAME, af as MessageContent, Z_ as STOP_WORDS, sh as SkillPanel, Zv as UNSAFE_KEYS, ly as applyPatchToClone, uy as applyPatchToLive, uv as buildDataPrompt, dv as buildSystemPrompt, K_ as connectMcp, wl as copyText, Wg as createAgent, o_ as createApprovalMiddleware, mb as createChatSdk, __ as createCheckpointManager, v_ as createCheckpointMiddleware, gv as createConflictManager, Xy as createDataOps, u_ as createHumanConfirmMiddleware, l_ as createHumanConfirmTool, Lv as createMemoryBackend, e_ as createMemoryMiddleware, v as createProxyLlm, Wv as createSdkEvents, Vv as createSessionStore, cb as createSkillStore, E_ as createSubagentMiddleware, k_ as createSubagentsMiddleware, rb as createUsageHintsMiddleware, A_ as createVerifyMiddleware, gy as createVfs, zv as createWebStorageBackend, I_ as createWriteBackCheck, ry as deepClone, eb as defineDataToolset, qg as defineSkill, hb as defineTool, ny as deleteByPath, zg as detectGarbledToolCall, $_ as estimateMessageTokens, ev as estimateRoundTokens, Dg as estimateTokens, cv as extractSchemaHint, U_ as extractText, Qy as fetchDocTools, $y as fetchTools, Yy as filterByToolMode, Jv as formatZodIssues, ey as getByPath, Wy as getSchemaAtPath, Vy as getSchemaTopKeys, cy as hashValue, tv as indexSummarize, fv as isChatModel, Hy as isPathAllowed, kv as isQuotaError, Qv as isUnsafePath, Fy as jpEval, Xv as jsonParseError, oy as limitDepth, iy as maybeParseValue, kg as offloadPassThroughChars, Og as offloadThresholdChars, ov as presets, Ky as projectBySchema, Gy as projectBySchemaDeep, ay as projectFields, nv as recallRounds, qv as resolveContextOptions, Uv as resolveDialogConfig, hv as resolveLlm, Eg as resolveModelCaps, Hv as resolveStorage, fy as restoreInPlace, dy as restoreLive, By as runSandboxedScript, $v as safeMerge, sy as safeStringify, Ly as searchJson, tb as selectBuiltinTools, ty as setByPath, sv as systemPromptHelpers, Q_ as tokenize, $ as toolError, Uy as unwrapSchema, Cl as useChat, e as z, Yv as zodError };