page-agent-sdk 3.44.0 → 3.44.1

package/dist/page-agent-sdk.js

@@ -5378,7 +5378,7 @@ var Gu = "", Ku = "根(整体)", qu = /* @__PURE__ */ new Set([
 ]), Ju = /* @__PURE__ */ new Set(["resource_update", "resource_delete"]), Yu = /* @__PURE__ */ new Set(["remove", "move"]);
 function Xu(e) {
 	let t = String(e).trim();
-	return t === "(root)" || t === "$" ? Gu : (t.startsWith("$.") ? t = t.slice(2) : t.startsWith("$") && (t = t.slice(1)), t);
+	return t === "(root)" || t === "$" ? Gu : (t.startsWith("$.") ? t = t.slice(2) : t.startsWith("$") && (t = t.slice(1)), t = t.replace(/\[(\d+)\]/g, ".$1"), t);
 }
 function Zu(e) {
 	let t = Xu(e);
@@ -5641,9 +5641,9 @@ function jd(e) {
 function Md(e, t) {
 	return !(!e.length || !e.some((e) => e.status !== "completed") || /[?？]\s*$/.test(t));
 }
-function Nd(e) {
-	let t = e.filter((e) => e.status !== "completed"), n = t.map((e) => `#${e.id} [${e.status}] ${e.content.length > 60 ? `${e.content.slice(0, 60)}…` : e.content}`).join("\n"), r = e.filter((e) => e.status === "completed" && !e.evidence), i = r.length ? `\n另有 ${r.length} 项已标记完成但 evidence 为空(${r.map((e) => `#${e.id}`).join("、")}):标记完成时请用 update_todo 附 evidence(本次实际写入的 jsonPath,如 components.2);经委派完成等无主写路径时如实写明完成方式。` : "";
-	return `⚠️ 任务未完成:待办清单还有 ${t.length} 项未完成:\n${n}\n若这些工作实际已完成,请先用 update_todo 把它们全部标记 completed(或一次 write_todos 整表替换)再给出最终总结;若尚未完成,请继续执行剩余任务。不要中途停止。${i}`;
+function Nd(e, t) {
+	let n = e.filter((e) => e.status !== "completed"), r = n.map((e) => `#${e.id} [${e.status}] ${e.content.length > 60 ? `${e.content.slice(0, 60)}…` : e.content}`).join("\n"), i = e.filter((e) => e.status === "completed" && !e.evidence && (!t || t.get(e.id) !== "completed")), a = i.length ? `\n另有 ${i.length} 项已标记完成但 evidence 为空(${i.map((e) => `#${e.id}`).join("、")}):标记完成时请用 update_todo 附 evidence(本次实际写入的 jsonPath,如 components.2);经委派完成等无主写路径时如实写明完成方式。` : "";
+	return `⚠️ 任务未完成:待办清单还有 ${n.length} 项未完成:\n${r}\n若这些工作实际已完成,请先用 update_todo 把它们全部标记 completed(或一次 write_todos 整表替换)再给出最终总结;若尚未完成,请继续执行剩余任务。不要中途停止。${a}`;
 }
 function Pd(e = [], n = {}) {
 	let i = Ad(e), a = 0, o = 0, s = !1, c = 0, l = n.maxPlanRevisions ?? 5;
@@ -5746,7 +5746,7 @@ function Bd(e) {
 		gate: {
 			stage: "completion_gate",
 			attempt: t.completionRetries,
-			feedback: Nd(e.todos),
+			feedback: Nd(e.todos, e.todosStatusAtStart),
 			logData: { pending: e.todos.filter((e) => e.status !== "completed").map((e) => e.id) }
 		}
 	};
@@ -6506,14 +6506,14 @@ function ff(e) {
 				for (let e = 0; e < o.length; e++) {
 					let t = p[e];
 					if (!t) continue;
-					let n = `${o[e].call.name}|${JSON.stringify(o[e].call.args ?? {})}`, r = t.status === "error" || typeof t.content == "string" && t.content.startsWith("ERROR:"), i = t.content;
-					if (r) {
-						let e = (v.get(n) ?? 0) + 1;
-						v.set(n, e), e >= 2 && (i = `${t.content}\n(提示:同参数已连续失败 ${e} 次,原样重试大概率仍失败;请检查参数/换路径/换方法,或向用户如实说明困难)`);
-					} else v.delete(n);
+					let n = (e) => e && typeof e == "object" && !Array.isArray(e) ? Object.fromEntries(Object.keys(e).sort().map((t) => [t, n(e[t])])) : e, r = `${o[e].call.name}|${JSON.stringify(n(o[e].call.args ?? {}))}`, i = t.status === "error" || typeof t.content == "string" && t.content.startsWith("ERROR:"), a = t.content;
+					if (i) {
+						let e = (v.get(r) ?? 0) + 1;
+						v.set(r, e), e >= 2 && (a = `${t.content}\n(提示:同参数已连续失败 ${e} 次,原样重试大概率仍失败;请检查参数/换路径/换方法,或向用户如实说明困难)`);
+					} else v.delete(r);
 					c.push(new s({
 						tool_call_id: o[e].id,
-						content: i
+						content: a
 					}));
 				}
 				for (let e = 0; e < o.length; e++) {
@@ -11434,42 +11434,49 @@ function Ag(e, n = {}) {
 			message: `jsonPath "${m}" 含非法段(__proto__/constructor/prototype)`,
 			hint: "使用正常属性路径,如 components.0.text(数组索引数字)"
 		});
+		let h = (e, t) => {
+			let n = (e ? gf(o, e) : o)?.shape;
+			return n && typeof n == "object" ? Object.keys(n) : t && typeof t == "object" && !Array.isArray(t) ? Object.keys(t) : [];
+		};
 		if (!mf(m, o, l)) {
-			let e = /[.[]/.test(m) ? m.replace(/[.[][^.[]*$/, "") : "", t = e ? fp(s, e) : s, n = t && typeof t == "object" && !Array.isArray(t) ? `;父级 "${e || "(root)"}" 的实际字段:${Object.keys(t).slice(0, 12).join(", ")}${Object.keys(t).length > 12 ? " …" : ""}` : "";
+			let e = /[.[]/.test(m) ? m.replace(/[.[][^.[]*$/, "") : "", t = h(e, e ? fp(s, e) : s), n = t.length ? `;父级 "${e || "(root)"}" 的可用字段:${t.slice(0, 12).join(", ")}${t.length > 12 ? " …" : ""}` : "";
 			return $({
 				code: "PATH_DENIED",
 				message: `read @ "${m}" 不在 schema 声明字段内`,
 				hint: `主数据仅暴露 schema 声明的字段;若需操作该字段,集成方需在 schema 中声明它${n}`
 			});
 		}
-		let h = m ? fp(s, m) : s;
-		if (m && h === void 0) {
-			let e = /[.[]/.test(m) ? m.replace(/[.[][^.[]*$/, "") : "", t = e ? fp(s, e) : s, n = Array.isArray(t) ? `父级 "${e || "(root)"}" 是 ${t.length} 元数组,有效索引 0-${Math.max(t.length - 1, 0)};先 read({jsonPath:"${e}"}) 确认现状,追加元素走 write 的 append` : t && typeof t == "object" ? `父级 "${e || "(root)"}" 的可用字段:${Object.keys(t).slice(0, 12).join(", ")}${Object.keys(t).length > 12 ? " …" : ""};先 read({jsonPath:"${e}"}) 确认` : `父级 "${e || "(root)"}" 不存在或不是容器;先 read() 不传 jsonPath 查看顶层字段`;
-			return $({
-				code: "PATH_NOT_FOUND",
-				path: m,
-				message: `路径 "${m}" 不存在`,
-				hint: n
-			});
+		let g = m ? fp(s, m) : s;
+		if (m && g === void 0) {
+			let e = gf(o, m);
+			if (!(e && typeof e.isOptional == "function" && e.isOptional())) {
+				let e = /[.[]/.test(m) ? m.replace(/[.[][^.[]*$/, "") : "", t = e ? fp(s, e) : s, n = h(e, t), r = Array.isArray(t) ? `父级 "${e || "(root)"}" 是 ${t.length} 元数组,有效索引 0-${Math.max(t.length - 1, 0)};先 read({jsonPath:"${e}"}) 确认现状,追加元素走 write 的 append` : n.length ? `父级 "${e || "(root)"}" 的可用字段:${n.slice(0, 12).join(", ")}${n.length > 12 ? " …" : ""};先 read({jsonPath:"${e}"}) 确认` : `父级 "${e || "(root)"}" 不存在或不是容器;先 read() 不传 jsonPath 查看顶层字段`;
+				return $({
+					code: "PATH_NOT_FOUND",
+					path: m,
+					message: `路径 "${m}" 不存在`,
+					hint: r
+				});
+			}
 		}
-		if (!m && l) h = kf(h, o);
+		if (!m && l) g = kf(g, o);
 		else if (l) {
 			let e = gf(o, m);
-			e && (h = kf(h, e));
+			e && (g = kf(g, e));
 		}
-		let g = h;
-		p && (g = pg({
+		let _ = g;
+		p && (_ = pg({
 			jp: m,
-			resolved: g,
+			resolved: _,
 			resourcesByPath: p.resourcesByPath,
 			resourceStore: p.resourceStore
-		})), b(f, d), n && n.length && (g = _p(g, n)), r != null && (g = vp(g, r)), g = Tg(g, d === "", D, E);
-		let _ = e ? "" : `主数据说明: ${c}\n格式: 写入值需为 JSON,且通过声明的 schema 校验(校验失败时 write 会返回结构化错误)。字段约束(类型/min/max/enum/必填/默认)见 systemPrompt「可操作数据」段,或用 schema_data({ jsonPath }) 按需查。\n\n`, y = n && n.length ? `(字段裁剪:${n.join(",")})` : "", x = r == null ? "" : `(深度≤${r})`, S = y || x ? ` ${y}${x}` : "";
-		if ((i !== void 0 || a !== void 0) && Array.isArray(g)) {
-			let e = g.length, t = Math.max(0, i ?? 0), n = Math.min(200, Math.max(1, a ?? 50)), r = g.slice(t, t + n), o = t + n < e;
-			return `${_}主数据${m ? ` @ ${m}` : ""} 数组分页[offset=${t},limit=${n}]${S} = ${yp(r)} (total=${e}, hasMore=${o}) (hash=${f})`;
+		})), b(f, d), n && n.length && (_ = _p(_, n)), r != null && (_ = vp(_, r)), _ = Tg(_, d === "", D, E);
+		let y = e ? "" : `主数据说明: ${c}\n格式: 写入值需为 JSON,且通过声明的 schema 校验(校验失败时 write 会返回结构化错误)。字段约束(类型/min/max/enum/必填/默认)见 systemPrompt「可操作数据」段,或用 schema_data({ jsonPath }) 按需查。\n\n`, x = n && n.length ? `(字段裁剪:${n.join(",")})` : "", S = r == null ? "" : `(深度≤${r})`, C = x || S ? ` ${x}${S}` : "";
+		if ((i !== void 0 || a !== void 0) && Array.isArray(_)) {
+			let e = _.length, t = Math.max(0, i ?? 0), n = Math.min(200, Math.max(1, a ?? 50)), r = _.slice(t, t + n), o = t + n < e;
+			return `${y}主数据${m ? ` @ ${m}` : ""} 数组分页[offset=${t},limit=${n}]${C} = ${yp(r)} (total=${e}, hasMore=${o}) (hash=${f})`;
 		}
-		return g === void 0 ? `${_}主数据${m ? ` @ ${m}` : ""}${S} = (undefined) (hash=${f})` : `${_}主数据${m ? ` @ ${m}` : ""}${S} = ${yp(g)} (hash=${f})`;
+		return _ === void 0 ? `${y}主数据${m ? ` @ ${m}` : ""}${C} = (undefined) (hash=${f})` : `${y}主数据${m ? ` @ ${m}` : ""}${C} = ${yp(_)} (hash=${f})`;
 	}, {
 		name: "read",
 		description: "读取主数据(高层入口,合并 describe/get)。不传 jsonPath → 返回主数据说明 + 格式提示(含字段约束);传 jsonPath → 返回该子路径当前值 + hash;传 jsonPaths → 一次读多个不相关子路径(省多轮往返)。hash 用于乐观锁(声明 conflictWatchFields 后 write 自动比对;未声明不自动校验)。fields(字段裁剪)/depth(深度截断)减体积;offset+limit 对数组目标分页(返回切片 + total/hasMore)。",

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

@@ -55171,7 +55171,7 @@ var aQ = "", fCe = "根(整体)", pCe = /* @__PURE__ */ new Set([
 ]), mCe = /* @__PURE__ */ new Set(["resource_update", "resource_delete"]), hCe = /* @__PURE__ */ new Set(["remove", "move"]);
 function oQ(e) {
 	let t = String(e).trim();
-	return t === "(root)" || t === "$" ? aQ : (t.startsWith("$.") ? t = t.slice(2) : t.startsWith("$") && (t = t.slice(1)), t);
+	return t === "(root)" || t === "$" ? aQ : (t.startsWith("$.") ? t = t.slice(2) : t.startsWith("$") && (t = t.slice(1)), t = t.replace(/\[(\d+)\]/g, ".$1"), t);
 }
 function sQ(e) {
 	let t = oQ(e);
@@ -55442,9 +55442,9 @@ function VCe(e) {
 function HCe(e, t) {
 	return !(!e.length || !e.some((e) => e.status !== "completed") || /[?？]\s*$/.test(t));
 }
-function UCe(e) {
-	let t = e.filter((e) => e.status !== "completed"), n = t.map((e) => `#${e.id} [${e.status}] ${e.content.length > 60 ? `${e.content.slice(0, 60)}…` : e.content}`).join("\n"), r = e.filter((e) => e.status === "completed" && !e.evidence), i = r.length ? `\n另有 ${r.length} 项已标记完成但 evidence 为空(${r.map((e) => `#${e.id}`).join("、")}):标记完成时请用 update_todo 附 evidence(本次实际写入的 jsonPath,如 components.2);经委派完成等无主写路径时如实写明完成方式。` : "";
-	return `⚠️ 任务未完成:待办清单还有 ${t.length} 项未完成:\n${n}\n若这些工作实际已完成,请先用 update_todo 把它们全部标记 completed(或一次 write_todos 整表替换)再给出最终总结;若尚未完成,请继续执行剩余任务。不要中途停止。${i}`;
+function UCe(e, t) {
+	let n = e.filter((e) => e.status !== "completed"), r = n.map((e) => `#${e.id} [${e.status}] ${e.content.length > 60 ? `${e.content.slice(0, 60)}…` : e.content}`).join("\n"), i = e.filter((e) => e.status === "completed" && !e.evidence && (!t || t.get(e.id) !== "completed")), a = i.length ? `\n另有 ${i.length} 项已标记完成但 evidence 为空(${i.map((e) => `#${e.id}`).join("、")}):标记完成时请用 update_todo 附 evidence(本次实际写入的 jsonPath,如 components.2);经委派完成等无主写路径时如实写明完成方式。` : "";
+	return `⚠️ 任务未完成:待办清单还有 ${n.length} 项未完成:\n${r}\n若这些工作实际已完成,请先用 update_todo 把它们全部标记 completed(或一次 write_todos 整表替换)再给出最终总结;若尚未完成,请继续执行剩余任务。不要中途停止。${a}`;
 }
 function gQ(e = [], t = {}) {
 	var n;
@@ -55549,7 +55549,7 @@ function JCe(e) {
 		gate: {
 			stage: "completion_gate",
 			attempt: r.completionRetries,
-			feedback: UCe(e.todos),
+			feedback: UCe(e.todos, e.todosStatusAtStart),
 			logData: { pending: e.todos.filter((e) => e.status !== "completed").map((e) => e.id) }
 		}
 	};
@@ -56323,15 +56323,15 @@ function OQ(e) {
 					var fe;
 					let t = d[e];
 					if (!t) continue;
-					let n = `${a[e].call.name}|${JSON.stringify((fe = a[e].call.args) == null ? {} : fe)}`, r = t.status === "error" || typeof t.content == "string" && t.content.startsWith("ERROR:"), i = t.content;
-					if (r) {
+					let n = (e) => e && typeof e == "object" && !Array.isArray(e) ? Object.fromEntries(Object.keys(e).sort().map((t) => [t, n(e[t])])) : e, r = `${a[e].call.name}|${JSON.stringify(n((fe = a[e].call.args) == null ? {} : fe))}`, i = t.status === "error" || typeof t.content == "string" && t.content.startsWith("ERROR:"), s = t.content;
+					if (i) {
 						var me;
-						let e = ((me = g.get(n)) == null ? 0 : me) + 1;
-						g.set(n, e), e >= 2 && (i = `${t.content}\n(提示:同参数已连续失败 ${e} 次,原样重试大概率仍失败;请检查参数/换路径/换方法,或向用户如实说明困难)`);
-					} else g.delete(n);
+						let e = ((me = g.get(r)) == null ? 0 : me) + 1;
+						g.set(r, e), e >= 2 && (s = `${t.content}\n(提示:同参数已连续失败 ${e} 次,原样重试大概率仍失败;请检查参数/换路径/换方法,或向用户如实说明困难)`);
+					} else g.delete(r);
 					o.push(new my({
 						tool_call_id: a[e].id,
-						content: i
+						content: s
 					}));
 				}
 				for (let e = 0; e < a.length; e++) {
@@ -69067,42 +69067,49 @@ function $6(e, t = {}) {
 			message: `jsonPath "${l}" 含非法段(__proto__/constructor/prototype)`,
 			hint: "使用正常属性路径,如 components.0.text(数组索引数字)"
 		});
+		let u = (e, t) => {
+			let n = e ? MQ(d, e) : d, r = n == null ? void 0 : n.shape;
+			return r && typeof r == "object" ? Object.keys(r) : t && typeof t == "object" && !Array.isArray(t) ? Object.keys(t) : [];
+		};
 		if (!AQ(l, d, m)) {
-			let e = /[.[]/.test(l) ? l.replace(/[.[][^.[]*$/, "") : "", t = e ? i$(f, e) : f, n = t && typeof t == "object" && !Array.isArray(t) ? `;父级 "${e || "(root)"}" 的实际字段:${Object.keys(t).slice(0, 12).join(", ")}${Object.keys(t).length > 12 ? " …" : ""}` : "";
+			let e = /[.[]/.test(l) ? l.replace(/[.[][^.[]*$/, "") : "", t = u(e, e ? i$(f, e) : f), n = t.length ? `;父级 "${e || "(root)"}" 的可用字段:${t.slice(0, 12).join(", ")}${t.length > 12 ? " …" : ""}` : "";
 			return TZ({
 				code: "PATH_DENIED",
 				message: `read @ "${l}" 不在 schema 声明字段内`,
 				hint: `主数据仅暴露 schema 声明的字段;若需操作该字段,集成方需在 schema 中声明它${n}`
 			});
 		}
-		let u = l ? i$(f, l) : f;
-		if (l && u === void 0) {
-			let e = /[.[]/.test(l) ? l.replace(/[.[][^.[]*$/, "") : "", t = e ? i$(f, e) : f, n = Array.isArray(t) ? `父级 "${e || "(root)"}" 是 ${t.length} 元数组,有效索引 0-${Math.max(t.length - 1, 0)};先 read({jsonPath:"${e}"}) 确认现状,追加元素走 write 的 append` : t && typeof t == "object" ? `父级 "${e || "(root)"}" 的可用字段:${Object.keys(t).slice(0, 12).join(", ")}${Object.keys(t).length > 12 ? " …" : ""};先 read({jsonPath:"${e}"}) 确认` : `父级 "${e || "(root)"}" 不存在或不是容器;先 read() 不传 jsonPath 查看顶层字段`;
-			return TZ({
-				code: "PATH_NOT_FOUND",
-				path: l,
-				message: `路径 "${l}" 不存在`,
-				hint: n
-			});
+		let h = l ? i$(f, l) : f;
+		if (l && h === void 0) {
+			let e = MQ(d, l);
+			if (!(e && typeof e.isOptional == "function" && e.isOptional())) {
+				let e = /[.[]/.test(l) ? l.replace(/[.[][^.[]*$/, "") : "", t = e ? i$(f, e) : f, n = u(e, t), r = Array.isArray(t) ? `父级 "${e || "(root)"}" 是 ${t.length} 元数组,有效索引 0-${Math.max(t.length - 1, 0)};先 read({jsonPath:"${e}"}) 确认现状,追加元素走 write 的 append` : n.length ? `父级 "${e || "(root)"}" 的可用字段:${n.slice(0, 12).join(", ")}${n.length > 12 ? " …" : ""};先 read({jsonPath:"${e}"}) 确认` : `父级 "${e || "(root)"}" 不存在或不是容器;先 read() 不传 jsonPath 查看顶层字段`;
+				return TZ({
+					code: "PATH_NOT_FOUND",
+					path: l,
+					message: `路径 "${l}" 不存在`,
+					hint: r
+				});
+			}
 		}
-		if (!l && m) u = HQ(u, d);
+		if (!l && m) h = HQ(h, d);
 		else if (m) {
 			let e = MQ(d, l);
-			e && (u = HQ(u, e));
+			e && (h = HQ(h, e));
 		}
-		let h = u;
-		v && (h = J6({
+		let g = h;
+		v && (g = J6({
 			jp: l,
-			resolved: h,
+			resolved: g,
 			resourcesByPath: v.resourcesByPath,
 			resourceStore: v.resourceStore
-		})), T(c, s), n && n.length && (h = l$(h, n)), r != null && (h = u$(h, r)), h = Q6(h, s === "", ee, M);
-		let g = e ? "" : `主数据说明: ${p}\n格式: 写入值需为 JSON,且通过声明的 schema 校验(校验失败时 write 会返回结构化错误)。字段约束(类型/min/max/enum/必填/默认)见 systemPrompt「可操作数据」段,或用 schema_data({ jsonPath }) 按需查。\n\n`, _ = n && n.length ? `(字段裁剪:${n.join(",")})` : "", y = r == null ? "" : `(深度≤${r})`, b = _ || y ? ` ${_}${y}` : "";
-		if ((i !== void 0 || a !== void 0) && Array.isArray(h)) {
-			let e = h.length, t = Math.max(0, i == null ? 0 : i), n = Math.min(200, Math.max(1, a == null ? 50 : a)), r = h.slice(t, t + n), o = t + n < e;
-			return `${g}主数据${l ? ` @ ${l}` : ""} 数组分页[offset=${t},limit=${n}]${b} = ${d$(r)} (total=${e}, hasMore=${o}) (hash=${c})`;
+		})), T(c, s), n && n.length && (g = l$(g, n)), r != null && (g = u$(g, r)), g = Q6(g, s === "", ee, M);
+		let _ = e ? "" : `主数据说明: ${p}\n格式: 写入值需为 JSON,且通过声明的 schema 校验(校验失败时 write 会返回结构化错误)。字段约束(类型/min/max/enum/必填/默认)见 systemPrompt「可操作数据」段,或用 schema_data({ jsonPath }) 按需查。\n\n`, y = n && n.length ? `(字段裁剪:${n.join(",")})` : "", b = r == null ? "" : `(深度≤${r})`, x = y || b ? ` ${y}${b}` : "";
+		if ((i !== void 0 || a !== void 0) && Array.isArray(g)) {
+			let e = g.length, t = Math.max(0, i == null ? 0 : i), n = Math.min(200, Math.max(1, a == null ? 50 : a)), r = g.slice(t, t + n), o = t + n < e;
+			return `${_}主数据${l ? ` @ ${l}` : ""} 数组分页[offset=${t},limit=${n}]${x} = ${d$(r)} (total=${e}, hasMore=${o}) (hash=${c})`;
 		}
-		return h === void 0 ? `${g}主数据${l ? ` @ ${l}` : ""}${b} = (undefined) (hash=${c})` : `${g}主数据${l ? ` @ ${l}` : ""}${b} = ${d$(h)} (hash=${c})`;
+		return g === void 0 ? `${_}主数据${l ? ` @ ${l}` : ""}${x} = (undefined) (hash=${c})` : `${_}主数据${l ? ` @ ${l}` : ""}${x} = ${d$(g)} (hash=${c})`;
 	}, {
 		name: "read",
 		description: "读取主数据(高层入口,合并 describe/get)。不传 jsonPath → 返回主数据说明 + 格式提示(含字段约束);传 jsonPath → 返回该子路径当前值 + hash;传 jsonPaths → 一次读多个不相关子路径(省多轮往返)。hash 用于乐观锁(声明 conflictWatchFields 后 write 自动比对;未声明不自动校验)。fields(字段裁剪)/depth(深度截断)减体积;offset+limit 对数组目标分页(返回切片 + total/hasMore)。",