page-agent-sdk 3.25.0 → 3.26.0

package/dist/page-agent-sdk.js

@@ -10916,7 +10916,7 @@ function Sg(e) {
 		id: _,
 		ts: Date.now(),
 		op: "edit",
-		value: Cd(t),
+		value: f ?? Cd(t),
 		...l ? { label: l } : {}
 	}); a.length > o;) a.shift();
 	for (let e of m) e.op === "remove" && Sd(t, e.jp);
@@ -11002,32 +11002,35 @@ function kg(e, n = {}) {
 	} : void 0, m = [], h = n.maxSnapshots ?? 20, g = /* @__PURE__ */ new Map(), _ = "", v = (e) => e?.configurable?.__pgDataScope ?? _, y = (e) => g.get(e ?? _), b = (e, t) => {
 		let n = t ?? _;
 		e === void 0 ? g.delete(n) : g.set(n, e);
-	}, x = n.autoLock !== !1, S = n.largeTextThreshold ?? 200, C = (n.largeTextPaths ?? []).map((e) => {
+	}, x = (e) => {
+		let t = kd(s);
+		return b(t, e), t;
+	}, S = n.autoLock !== !1, C = n.largeTextThreshold ?? 200, w = (n.largeTextPaths ?? []).map((e) => {
 		let t = e.lastIndexOf(".");
 		return t > 0 ? {
 			arrayPath: e.slice(0, t),
 			field: e.slice(t + 1)
 		} : null;
-	}).filter((e) => e !== null), w = !0;
-	function T() {
-		w = !0;
+	}).filter((e) => e !== null), T = !0;
+	function E() {
+		T = !0;
 	}
-	let E = {
+	let D = {
 		get: () => ({
 			schema: o,
 			bind: s,
 			description: c
 		}),
 		set: (e) => {
-			o = i.length ? $u(e.schema, i).schema : e.schema, s = e.bind, c = e.description ?? "主数据对象", l = Mu(o), m.length = 0, g.clear(), f(e.resources), d?.clear(), T();
+			o = i.length ? $u(e.schema, i).schema : e.schema, s = e.bind, c = e.description ?? "主数据对象", l = Mu(o), m.length = 0, g.clear(), f(e.resources), d?.clear(), E();
 		},
 		update: (e) => {
-			s = e, m.length = 0, g.clear(), T();
+			s = e, m.length = 0, g.clear(), E();
 		},
-		markDataDirty: T,
+		markDataDirty: E,
 		consumeDataDirty: () => {
-			let e = w;
-			return w = !1, e;
+			let e = T;
+			return T = !1, e;
 		},
 		enterScope: (e) => {
 			let t = _;
@@ -11074,14 +11077,14 @@ function kg(e, n = {}) {
 		} : void 0,
 		updateResource: d ? (e, t) => {
 			let n = og(e);
-			d.update(n, t), xd(s, n, t), T();
+			d.update(n, t), xd(s, n, t), E();
 		} : void 0,
 		deleteResource: d ? (e) => d.delete(e) : void 0,
 		listResources: d ? () => d.list() : void 0
-	}, D = (e) => {
+	}, O = (e) => {
 		n.onAudit?.(e);
 	};
-	function O(e, t) {
+	function k(e, t) {
 		let n = Cd(s), r = m.length ? m[m.length - 1].id + 1 : 1;
 		for (m.push({
 			id: r,
@@ -11092,7 +11095,7 @@ function kg(e, n = {}) {
 		}); m.length > h;) m.shift();
 		return r;
 	}
-	async function k(e, t, r) {
+	async function A(e, t, r) {
 		if (!t || t === "") return null;
 		let i = kd(s);
 		if (i === t) return null;
@@ -11113,17 +11116,17 @@ function kg(e, n = {}) {
 		if (a.action === "restore") {
 			if (!m.length) return `无历史快照可回退(本次为首次操作)。当前值:${Dd(s, 400)} (hash=${i})。请重新 read 再改或选「强制覆盖」。`;
 			let e = m[m.length - 1];
-			return Pd(s, Cd(e.value)), T(), `已回退主数据到历史快照 #${e.id}[${e.op}]。当前值:${Dd(s, 400)} (hash=${kd(s)})。请基于回退后的值重写或停止。`;
+			return Pd(s, Cd(e.value)), E(), `已回退主数据到历史快照 #${e.id}[${e.op}]。当前值:${Dd(s, 400)} (hash=${kd(s)})。请基于回退后的值重写或停止。`;
 		}
 		return null;
 	}
-	let A = (e, t = !0) => {
+	let ee = (e, t = !0) => {
 		e.writeCapable = t;
-	}, ee = r(async () => [`说明: ${c}`, "格式: 写入值需为 JSON,且通过声明的 schema 校验(校验失败时 set_data/edit_data 会返回结构化错误,含具体字段与期望类型)。"].join("\n"), {
+	}, j = r(async () => [`说明: ${c}`, "格式: 写入值需为 JSON,且通过声明的 schema 校验(校验失败时 set_data/edit_data 会返回结构化错误,含具体字段与期望类型)。"].join("\n"), {
 		name: "describe_data",
 		description: "获取主数据的说明与格式要求。",
 		schema: t.object({})
-	}), j = r(async ({ jsonPath: e }, t) => {
+	}), te = r(async ({ jsonPath: e }, t) => {
 		let n = v(t), r = e || "";
 		if (vd(r)) return $({
 			code: "PATH_UNSAFE",
@@ -11143,13 +11146,13 @@ function kg(e, n = {}) {
 			resourceStore: p.resourceStore
 		}));
 		let a = kd(s);
-		return b(a, n), i === void 0 ? `主数据${r ? ` @ ${r}` : ""} = (undefined) (hash=${a})` : (i = wg(i, n === "", C, S), `主数据${r ? ` @ ${r}` : ""} = ${Dd(i)} (hash=${a})`);
+		return b(a, n), i === void 0 ? `主数据${r ? ` @ ${r}` : ""} = (undefined) (hash=${a})` : (i = wg(i, n === "", w, C), `主数据${r ? ` @ ${r}` : ""} = ${Dd(i)} (hash=${a})`);
 	}, {
 		name: "get_data",
 		description: "@deprecated(改用 read,等价且支持 fields/depth/分页)。读取主数据当前值(返回含 hash 供乐观锁);jsonPath 可选读子路径。大结果自动外存 vfs。",
 		schema: t.object({ jsonPath: t.string().optional().describe("相对主数据根的点号路径(如 components.0.text);不传则读整个主数据") })
-	}), te = r(async ({ value: e, expectedHash: t }, n) => {
-		let r = v(n), i = await k("set", t || (x ? y(r) : void 0));
+	}), M = r(async ({ value: e, expectedHash: t }, n) => {
+		let r = v(n), i = await A("set", t || (S ? y(r) : void 0));
 		if (i !== null) return i;
 		let c = wd(e);
 		if (c.parseError) return Nl("", e, c.parseError);
@@ -11160,8 +11163,8 @@ function kg(e, n = {}) {
 			allowKeys: l,
 			snapshots: m,
 			maxSnapshots: h,
-			audit: D,
-			onWrite: T,
+			audit: O,
+			onWrite: E,
 			internalAfterWrite: a,
 			protectedCtx: p
 		});
@@ -11174,8 +11177,8 @@ function kg(e, n = {}) {
 			expectedHash: t.string().optional().describe("乐观锁:改前 read/get 返回的 hash;传入则校验,不一致拒绝写入防覆盖。不传则自动用你最后读到的 hash(autoLock)")
 		})
 	});
-	A(te);
-	let M = r(async (e, t) => {
+	ee(M);
+	let ne = r(async (e, t) => {
 		let n = v(t), r = e.op ?? e.patch?.op, i = e.jsonPath ?? e.patch?.jsonPath, c = e.value ?? e.patch?.value, u = e.expectedHash;
 		if (!r) return $({
 			code: "MISSING_VALUE",
@@ -11193,7 +11196,7 @@ function kg(e, n = {}) {
 			message: `edit_data @ "${d}" 不在 schema 声明字段内`,
 			hint: "仅 schema 声明的 key 可写;若需操作该字段,集成方需在 schema 中声明它"
 		});
-		let f = await k("edit", u || (x ? y(n) : void 0));
+		let f = await A("edit", u || (S ? y(n) : void 0));
 		if (f !== null) return f;
 		if (typeof s != "object" || !s) return $({
 			code: "NOT_OBJECT",
@@ -11211,19 +11214,21 @@ function kg(e, n = {}) {
 			allowKeys: l,
 			snapshots: m,
 			maxSnapshots: h,
-			markDataDirty: T,
+			markDataDirty: E,
 			schemaErrorMode: "zod",
 			internalAfterWrite: a,
 			protectedCtx: p
 		});
 		if (!g.ok) return g.error;
 		let _ = g.applied[0];
-		return D({
+		O({
 			op: "edit",
 			detail: `${_.op}${d ? "@" + d : ""}`,
 			value: _.value,
 			timestamp: Date.now()
-		}), b(kd(s), n), `已 edit 主数据(${_.op}${d ? " @ " + d : ""})。当前值:${Dd(s, 600)} (新 hash=${kd(s)})`;
+		});
+		let b = x(n);
+		return `已 edit 主数据(${_.op}${d ? " @ " + d : ""})。当前值:${Dd(s, 600)} (新 hash=${b})`;
 	}, {
 		name: "edit_data",
 		description: "增量编辑主数据(advanced;simple 用 write 等价)。op:set/remove/merge/append/move;jsonPath 相对根(数组索引用数字);value 对象或 JSON 字符串。schema 校验失败不写;expectedHash 可选乐观锁。大对象优先增量改。",
@@ -11250,8 +11255,8 @@ function kg(e, n = {}) {
 			}).optional().describe("容错:误传 write 的 {patch:{op,jsonPath,value}} 形式时从此取值(顶层优先)。正常用顶层 op/jsonPath/value 即可")
 		})
 	});
-	A(M);
-	let ne = r(async ({ jsonPath: e, expectedHash: t }, n) => {
+	ee(ne);
+	let N = r(async ({ jsonPath: e, expectedHash: t }, n) => {
 		let r = v(n);
 		if (!e) return $({
 			code: "MISSING_VALUE",
@@ -11276,11 +11281,11 @@ function kg(e, n = {}) {
 				hint: t.spec.mode === "freeze" ? "冻结字段不可删;如需移除请联系集成方调整 data.resources" : "verbatim 字段不可直接删;先 resource_delete({path}) 释放资源保护后再删"
 			});
 		}
-		let i = await k("delete", t || (x ? y(r) : void 0));
+		let i = await A("delete", t || (S ? y(r) : void 0));
 		if (i !== null) return i;
-		O("delete");
+		k("delete");
 		let a = Sd(s, e);
-		return T(), D({
+		return E(), O({
 			op: "delete",
 			detail: e,
 			timestamp: Date.now()
@@ -11293,8 +11298,8 @@ function kg(e, n = {}) {
 			expectedHash: t.string().optional().describe("乐观锁:改前 read/get 返回的 hash;传入则校验,不一致拒绝删除防覆盖")
 		})
 	});
-	A(ne);
-	let N = r(async ({ id: e }, t) => {
+	ee(N);
+	let P = r(async ({ id: e }, t) => {
 		let n = v(t);
 		if (!m.length) return $({
 			code: "NO_SNAPSHOT",
@@ -11308,7 +11313,7 @@ function kg(e, n = {}) {
 			hint: "用 history_data({list:true}) 查看可用快照序号"
 		});
 		let i = o.safeParse(r.value);
-		return i.success ? (Pd(s, Cd(r.value)), T(), D({
+		return i.success ? (Pd(s, Cd(r.value)), E(), O({
 			op: "restore",
 			detail: `#${r.id}`,
 			timestamp: Date.now()
@@ -11323,8 +11328,8 @@ function kg(e, n = {}) {
 		description: "把主数据回退到某个快照(就地还原,保留响应式)。不传 id 则回退最近一次(快速回退)。可用 history_data({list:true}) 查看快照列表。",
 		schema: t.object({ id: t.number().int().optional().describe("指定快照序号;不传则回退最近一次") })
 	});
-	A(N);
-	let P = r(async ({ id: e, jsonPath: t, list: n }) => {
+	ee(P);
+	let re = r(async ({ id: e, jsonPath: t, list: n }) => {
 		if (n) {
 			if (!m.length) return "无快照。set/edit/delete 会自动存快照。";
 			let e = m.map((e) => {
@@ -11369,7 +11374,7 @@ function kg(e, n = {}) {
 			jsonPath: t.string().optional().describe("只看快照的某子路径(相对主数据根);不传则整个快照"),
 			list: t.boolean().optional().describe("true 则列出快照时间线元信息(序号/操作/标签/时间/大小);不传则查看单条快照内容")
 		})
-	}), re = r(async ({ expr: e, limit: t }, n) => {
+	}), F = r(async ({ expr: e, limit: t }, n) => {
 		let r = v(n);
 		if (typeof s != "object" || !s) return $({
 			code: "NOT_OBJECT",
@@ -11387,7 +11392,7 @@ function kg(e, n = {}) {
 				details: { expr: e }
 			});
 		}
-		let c = t ?? 50, u = a.slice(0, c), d = u.map((e) => `{"path":${JSON.stringify(e.path)},"index":${e.index === void 0 ? "null" : e.index},"value":${Dd(wg(e.value, r === "", C, S))}}`);
+		let c = t ?? 50, u = a.slice(0, c), d = u.map((e) => `{"path":${JSON.stringify(e.path)},"index":${e.index === void 0 ? "null" : e.index},"value":${Dd(wg(e.value, r === "", w, C))}}`);
 		return `{"matched":${a.length},"returned":${u.length},"truncated":${a.length > c},"results":[${d.join(",")}]}`;
 	}, {
 		name: "query_data",
@@ -11396,7 +11401,7 @@ function kg(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")
 		})
-	}), F = r(async ({ query: e, mode: t, fuzzyThreshold: n, matchKey: r, limit: i }) => {
+	}), I = r(async ({ query: e, mode: t, fuzzyThreshold: n, matchKey: r, limit: i }) => {
 		if (s == null) return $({
 			code: "EMPTY",
 			message: "主数据为空,无可搜索内容"
@@ -11434,7 +11439,7 @@ function kg(e, n = {}) {
 			matchKey: t.boolean().optional().describe("是否同时匹配 key 名,默认 true"),
 			limit: t.number().int().min(1).max(200).optional().describe("返回上限,默认 50")
 		})
-	}), I = r(async ({ script: e, mode: t, jsonPath: n }, r) => {
+	}), ie = r(async ({ script: e, mode: t, jsonPath: n }, r) => {
 		let i = v(r);
 		if (e.length > 8e3) return $({
 			code: "SCRIPT_TOO_LARGE",
@@ -11480,13 +11485,13 @@ function kg(e, n = {}) {
 					allowKeys: l,
 					snapshots: m,
 					maxSnapshots: h,
-					markDataDirty: T,
+					markDataDirty: E,
 					schemaErrorMode: "schema_invalid",
 					snapshotLabel: "eval_transform_subtree",
 					internalAfterWrite: a,
 					protectedCtx: p
 				});
-				return t.ok ? (D({
+				return t.ok ? (O({
 					op: "edit",
 					detail: `eval_transform_subtree @ ${c}`,
 					timestamp: Date.now()
@@ -11505,13 +11510,13 @@ function kg(e, n = {}) {
 					allowKeys: l,
 					snapshots: m,
 					maxSnapshots: h,
-					markDataDirty: T,
+					markDataDirty: E,
 					schemaErrorMode: "schema_invalid",
 					snapshotLabel: "eval_transform",
 					internalAfterWrite: a,
 					protectedCtx: p
 				});
-				return t.ok ? (D({
+				return t.ok ? (O({
 					op: "edit",
 					detail: `eval_transform(${t.applied.length} patches)`,
 					timestamp: Date.now()
@@ -11531,7 +11536,7 @@ function kg(e, n = {}) {
 				code: "LEAF_BIND",
 				message: `主数据 bind 为原始类型(${s === null ? "null" : typeof s}),eval transform 无法就地替换外部持有的值引用`,
 				hint: "主数据 bind 必须为对象/数组;叶子值请用对象包裹或集成方通过 sdk.setData 替换 bind"
-			}) : (O("edit", "eval_transform"), n.data !== null && typeof n.data == "object" && (l ? yd(s, n.data) : Fd(s, n.data)), T(), D({
+			}) : (k("edit", "eval_transform"), n.data !== null && typeof n.data == "object" && (l ? yd(s, n.data) : Fd(s, n.data)), E(), O({
 				op: "edit",
 				detail: "eval_transform",
 				timestamp: Date.now()
@@ -11556,8 +11561,8 @@ function kg(e, n = {}) {
 			jsonPath: t.string().optional().describe("子树模式:仅对 jsonPath 指向的子树执行(降低大 JSON 成本);transform 时返回值作为该子树新值")
 		})
 	});
-	A(I, (e) => e?.mode === "transform");
-	let ie = r(async ({ jsonPath: e, jsonPaths: t, fields: r, depth: i, offset: a, limit: u }, d) => {
+	ee(ie, (e) => e?.mode === "transform");
+	let L = r(async ({ jsonPath: e, jsonPaths: t, fields: r, depth: i, offset: a, limit: u }, d) => {
 		let f = v(d), m = kd(s);
 		if (t && t.length) {
 			let e = !1, a = t.map((t) => {
@@ -11581,7 +11586,7 @@ function kg(e, n = {}) {
 				} catch (e) {
 					return `- ${a}: [READ_INTERCEPT: ${e.message}]`;
 				}
-				return r && r.length && (u = Td(u, r)), i != null && (u = Ed(u, i)), u = wg(u, f === "", C, S), u === void 0 ? `- ${a} = (undefined)` : `- ${a} = ${Dd(u)}`;
+				return r && r.length && (u = Td(u, r)), i != null && (u = Ed(u, i)), u = wg(u, f === "", w, C), u === void 0 ? `- ${a} = (undefined)` : `- ${a} = ${Dd(u)}`;
 			});
 			return e && b(m, f), `多路径读取(共 ${t.length} 项,hash=${m}):\n${a.join("\n")}`;
 		}
@@ -11616,8 +11621,8 @@ function kg(e, n = {}) {
 				message: `read 拦截器抛错: ${e.message}`
 			});
 		}
-		b(m, f), r && r.length && (_ = Td(_, r)), i != null && (_ = Ed(_, i)), _ = wg(_, f === "", C, S);
-		let y = e ? "" : `主数据说明: ${c}\n格式: 写入值需为 JSON,且通过声明的 schema 校验(校验失败时 write 会返回结构化错误)。字段约束(类型/min/max/enum/必填/默认)见 systemPrompt「可操作数据」段,或用 schema_data({ jsonPath }) 按需查。\n\n`, x = r && r.length ? `(字段裁剪:${r.join(",")})` : "", w = i == null ? "" : `(深度≤${i})`, T = x || w ? ` ${x}${w}` : "";
+		b(m, f), r && r.length && (_ = Td(_, r)), i != null && (_ = Ed(_, i)), _ = wg(_, f === "", w, C);
+		let y = e ? "" : `主数据说明: ${c}\n格式: 写入值需为 JSON,且通过声明的 schema 校验(校验失败时 write 会返回结构化错误)。字段约束(类型/min/max/enum/必填/默认)见 systemPrompt「可操作数据」段,或用 schema_data({ jsonPath }) 按需查。\n\n`, x = r && r.length ? `(字段裁剪:${r.join(",")})` : "", S = i == null ? "" : `(深度≤${i})`, T = x || S ? ` ${x}${S}` : "";
 		if ((a !== void 0 || u !== void 0) && Array.isArray(_)) {
 			let e = _.length, t = Math.max(0, a ?? 0), n = Math.min(200, Math.max(1, u ?? 50)), r = _.slice(t, t + n), i = t + n < e;
 			return `${y}主数据${h ? ` @ ${h}` : ""} 数组分页[offset=${t},limit=${n}]${T} = ${Dd(r)} (total=${e}, hasMore=${i}) (hash=${m})`;
@@ -11634,7 +11639,7 @@ function kg(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")
 		})
-	}), L = r(async ({ value: e, patch: t, patches: r, del: i, dryRun: c }, u) => {
+	}), R = r(async ({ value: e, patch: t, patches: r, del: i, dryRun: c }, u) => {
 		let d = v(u), f = "set";
 		i ? f = "delete" : (r && r.length || t) && (f = "edit");
 		let g = t?.value === void 0 ? e : t.value, _;
@@ -11663,12 +11668,12 @@ function kg(e, n = {}) {
 				message: `write 拦截器抛错: ${e.message}`
 			});
 		}
-		let S = x ? y(d) : void 0;
-		if (c && S !== void 0) {
+		let C = S ? y(d) : void 0;
+		if (c && C !== void 0) {
 			let e = kd(s);
-			if (e !== S) return $({
+			if (e !== C) return $({
 				code: "VERSION_CONFLICT",
-				message: `dryRun 预检发现乐观锁冲突: expectedHash=${S} 当前 hash=${e}(主数据在你 read 后被改)`,
+				message: `dryRun 预检发现乐观锁冲突: expectedHash=${C} 当前 hash=${e}(主数据在你 read 后被改)`,
 				hint: "重新 read 拿最新 hash 再预检/写"
 			});
 		}
@@ -11696,19 +11701,19 @@ function kg(e, n = {}) {
 					hint: e.spec.mode === "freeze" ? "冻结字段不可删" : "verbatim 字段不可直接删;先 resource_delete 释放"
 				});
 			}
-			let e = await k("delete", S);
+			let e = await A("delete", C);
 			if (e !== null) return e;
 			if (c) {
 				let e = Cd(s);
 				return Sd(e, t.jsonPath) ? `dryRun(delete): 将删除 @ ${t.jsonPath}。预览剩余:${Dd(e, 600)}。未实际写入、未入快照。` : `dryRun(delete): @ ${t.jsonPath} 不存在(无需删除)。未实际写入。`;
 			}
-			O("delete");
+			k("delete");
 			let n = Sd(s, t.jsonPath);
-			return T(), D({
+			return E(), O({
 				op: "delete",
 				detail: t.jsonPath,
 				timestamp: Date.now()
-			}), a && (a(s, null), T()), b(kd(s), d), n ? `已删除主数据 @ ${t.jsonPath}` : `主数据 @ ${t.jsonPath} 不存在(无需删除)`;
+			}), a && (a(s, null), E()), b(kd(s), d), n ? `已删除主数据 @ ${t.jsonPath}` : `主数据 @ ${t.jsonPath} 不存在(无需删除)`;
 		}
 		if (f === "edit") {
 			if (typeof s != "object" || !s) return $({
@@ -11716,7 +11721,7 @@ function kg(e, n = {}) {
 				message: `edit 仅适用于对象/数组主数据,当前是 ${s === void 0 ? "undefined" : typeof s}`,
 				hint: "叶子用 write(value) 整体设置"
 			});
-			let e = await k("edit", S);
+			let e = await A("edit", C);
 			if (e !== null) return e;
 			let n = _ || (r && r.length ? r : [{
 				op: t.op ?? "set",
@@ -11729,40 +11734,44 @@ function kg(e, n = {}) {
 				allowKeys: l,
 				snapshots: m,
 				maxSnapshots: h,
-				markDataDirty: T,
+				markDataDirty: E,
 				schemaErrorMode: "zod",
 				dryRun: c,
 				internalAfterWrite: a,
 				protectedCtx: p
 			});
-			return i.ok ? c ? `dryRun(edit): ${i.applied.length} 个 patch 预检通过(schema 校验 OK)。预览结果:${Dd(i.clone, 600)}。未实际写入、未入快照。` : (D({
+			if (!i.ok) return i.error;
+			if (c) return `dryRun(edit): ${i.applied.length} 个 patch 预检通过(schema 校验 OK)。预览结果:${Dd(i.clone, 600)}。未实际写入、未入快照。`;
+			O({
 				op: "edit",
 				detail: `${i.applied.length} 个 patch${i.applied.length > 1 ? "(批量)" : ""}`,
 				value: i.applied.map((e) => `${e.op}@${e.jp}`),
 				timestamp: Date.now()
-			}), b(kd(s), d), Og(i.clone), `已 write(edit) 主数据(${i.applied.length} 个 patch)。当前值:${Dd(i.clone, 600)} (新 hash=${kd(s)})`) : i.error;
-		}
-		let C = wd(g);
-		if (C.parseError) return Nl("", g, C.parseError);
-		let w = await k("set", S);
-		if (w !== null) return w;
-		let E = xg({
+			});
+			let u = x(d);
+			return Og(i.clone), `已 write(edit) 主数据(${i.applied.length} 个 patch)。当前值:${Dd(i.clone, 600)} (新 hash=${u})`;
+		}
+		let w = wd(g);
+		if (w.parseError) return Nl("", g, w.parseError);
+		let T = await A("set", C);
+		if (T !== null) return T;
+		let D = xg({
 			bindRef: s,
-			value: C.parsed,
+			value: w.parsed,
 			schema: o,
 			allowKeys: l,
 			snapshots: m,
 			maxSnapshots: h,
-			audit: D,
+			audit: O,
 			dryRun: c,
-			onWrite: T,
+			onWrite: E,
 			internalAfterWrite: a,
 			protectedCtx: p
 		});
-		if (!E.ok) return E.error;
-		if (c) return `dryRun(set): schema 校验通过。预览新值:${Dd(E.data, 600)}。未实际写入、未入快照。`;
-		let A = kd(s);
-		return b(A, d), Og(E.data), `已 write(set) 主数据 = ${Dd(E.data, 600)} (新 hash=${A})${l ? "(白名单模式:仅更新 schema 声明字段,未声明字段保留)" : ""}`;
+		if (!D.ok) return D.error;
+		if (c) return `dryRun(set): schema 校验通过。预览新值:${Dd(D.data, 600)}。未实际写入、未入快照。`;
+		let ee = kd(s);
+		return b(ee, d), Og(D.data), `已 write(set) 主数据 = ${Dd(D.data, 600)} (新 hash=${ee})${l ? "(白名单模式:仅更新 schema 声明字段,未声明字段保留)" : ""}`;
 	}, {
 		name: "write",
 		description: "写入主数据(高层入口,合并 set/edit/delete + 自动乐观锁 + 自动快照)。四意图:① 整体替换 write({value:整个对象});② 增量 write({patch:{op,jsonPath,value}}) op=set/remove/merge/append/move(move 的 value=目标路径字符串);③ 批量原子 write({patches:[...]})(任一失败整批回滚);④ 删子路径 write({patch:{jsonPath},del:true})。dryRun:true 预检不落盘。写入自动 schema 校验(失败不写,按错误修正重试)+ 自动快照。详细用法见系统提示「能力使用提示」。",
@@ -11794,8 +11803,8 @@ function kg(e, n = {}) {
 			dryRun: t.boolean().optional().describe("预检模式:走完整校验链(schema + 白名单 + patch 应用到 clone)但不落盘、不入快照,返回预览。四意图(value/patch/patches/del)均支持;乐观锁冲突照常检测(返回 VERSION_CONFLICT 不挂起)")
 		})
 	});
-	A(L);
-	let R = r(async ({ jsonPath: e }) => {
+	ee(R);
+	let z = r(async ({ jsonPath: e }) => {
 		let t = e || "", n = t ? Fu(o, t) : o;
 		return n ? `schema${t ? ` @ ${t}` : ""} = ${Dd(Ju(n))}` : $({
 			code: "PATH_DENIED",
@@ -11806,7 +11815,7 @@ function kg(e, n = {}) {
 		name: "schema_data",
 		description: "查看主数据(或子路径)的字段约束:类型/min/max/enum/必填/默认值/嵌套 shape。写前查约束,避免写错重试。不传 jsonPath 查根;传子路径(如 components.0)查该位置约束。",
 		schema: t.object({ jsonPath: t.string().optional().describe("要查约束的子路径;不传查根 schema") })
-	}), z = r(async ({ snapshotId: e, against: t }) => {
+	}), B = r(async ({ snapshotId: e, against: t }) => {
 		let n = t != null, r, i;
 		if (n) {
 			let e = t;
@@ -11838,7 +11847,7 @@ function kg(e, n = {}) {
 			snapshotId: t.number().int().optional().describe("对比的快照序号;不传则最近一次"),
 			against: t.unknown().optional().describe("对比的一段 JSON 值(与 snapshotId 互斥;传则忽略快照)")
 		})
-	}), B = [];
+	}), ae = [];
 	if (n.vfsStore) {
 		let e = n.vfsStore, i = (e) => `drafts/${e}.json`, c = r(({ draftId: t, chunk: n, mode: r }) => {
 			let a = i(t), o = e.files[a], s = r === "append" && o, c = s ? o.content + n : n;
@@ -11879,7 +11888,7 @@ function kg(e, n = {}) {
 					}
 				});
 			}
-			let g = await k("set", n || (x ? y(c) : void 0));
+			let g = await A("set", n || (S ? y(c) : void 0));
 			if (g !== null) return g;
 			let _ = xg({
 				bindRef: s,
@@ -11888,9 +11897,9 @@ function kg(e, n = {}) {
 				allowKeys: l,
 				snapshots: m,
 				maxSnapshots: h,
-				audit: D,
+				audit: O,
 				op: "draft_commit",
-				onWrite: T,
+				onWrite: E,
 				internalAfterWrite: a,
 				protectedCtx: p
 			});
@@ -11903,9 +11912,9 @@ function kg(e, n = {}) {
 				expectedHash: t.string().optional().describe("乐观锁:改前 read/get 返回的 hash;传入则校验,不一致拒绝写入防覆盖。不传则自动用你最后读到的 hash(autoLock)")
 			})
 		});
-		A(u), B.push(c, u);
+		ee(u), ae.push(c, u);
 	}
-	let ae = [];
+	let V = [];
 	if (e.resources?.length && d) {
 		let e = r(async ({ path: e, handle: t }) => {
 			let n = e;
@@ -11975,7 +11984,7 @@ function kg(e, n = {}) {
 					details: jl(n.error.issues)
 				});
 			}
-			d.update(i, t), xd(s, i, t), b(kd(s), r), T();
+			d.update(i, t), xd(s, i, t), b(kd(s), r), E();
 			let l = d.get(i)?.handle;
 			return `已更新 verbatim 资源 "${e}" = ${Dd(t, 200)}(handle ${l ?? "(未知)"} 不变)。后续 write 该字段写回句柄 ⟦res:${l}⟧ 或新值`;
 		}, {
@@ -11986,7 +11995,7 @@ function kg(e, n = {}) {
 				value: t.unknown().describe("新值(需符合字段 schema 类型)")
 			})
 		});
-		A(n);
+		ee(n);
 		let i = r(async () => {
 			let e = d.list();
 			return e.length ? Dd({ resources: e }) : "当前无已注册的受保护资源(read 受保护路径会懒注册)";
@@ -12009,10 +12018,9 @@ function kg(e, n = {}) {
 				handle: t.string().optional().describe("占位符句柄(与 path 二选一)")
 			})
 		});
-		A(a), ae.push(e, n, i, a);
+		ee(a), V.push(e, n, i, a);
 	}
-	let V = [
-		ee,
+	let oe = [
 		j,
 		te,
 		M,
@@ -12026,21 +12034,22 @@ function kg(e, n = {}) {
 		L,
 		R,
 		z,
-		...B,
-		...ae
+		B,
+		...ae,
+		...V
 	];
-	Object.defineProperty(V, "controller", {
-		value: E,
+	Object.defineProperty(oe, "controller", {
+		value: D,
 		enumerable: !1,
 		configurable: !1,
 		writable: !1
 	});
-	for (let e of V) Object.defineProperty(e, "__dataOpsScoped", {
+	for (let e of oe) Object.defineProperty(e, "__dataOpsScoped", {
 		value: !0,
 		enumerable: !1,
 		configurable: !1
 	});
-	return V;
+	return oe;
 }
 //#endregion
 //#region src/core/tools/fetchDoc.ts