page-agent-sdk 3.33.0 → 3.34.0

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

@@ -3526,6 +3526,7 @@ var Fa = {
 function Ia(e, t = "code") {
 	let n = `use_${e}`;
 	return [
+		`【先判意图(防长对话误路由)】先判断用户是「问」还是「要生成/改」:**提问类**(这是什么组件/怎么用/某字段什么意思/为什么这样/解释代码)→ 用 read / list_components / rag_component_docs **直接回答**,绝不委派 ${n};**生成/修改类**(做一个/生成/改成/加一个 XX 组件)才按下面纪律委派 ${n}。长对话里上文全是生成记录时尤须警惕,不要把新问题当成延续旧任务。`,
 		`【执行纪律(最重要)】收到代码组件任务后:**新建类直接委派**(追加组件无需通读/翻页现有数组,子 agent 自会采样一个组件看结构;**新建组件由子 agent 全权创建** —— 它自己把整个组件(含 ${t})写进数组,你不需要也不能替它创建/追加/落地代码)→ 修改类才 read 定位(by name)→ 调 ${n} 委派 → read 核对 → 回复用户。**中间绝不输出过渡性文字** —— 「我先看看…」「稍后委派」「接下来我会…」这类计划性回复等于任务没做就结束了(回复即本轮终止);所有调研和委派在本轮内连续完成,完成后才回复总结。`,
 		"【产物形态】每个组件是完整、自包含的 HTML 页面(含 style/script,可独立成页);你只负责委派和收尾,不关心宿主如何渲染(v-html / iframe / SFC 是集成方的事)。",
 		`【主 agent 职责边界(硬规则)】禁止直接 read/write 代码组件的 ${t} 字段(read 只得 <code Nkb> 摘要没用;write 绕过 vfs/verify 危险)—— 生成/修改/排查代码一律经 ${n},收尾 read 核对。**委派返回即已落地**:${n} 的结论说「已创建组件 X」= 组件已在数组里,**不要再 write/append 一遍**(子 agent 已自己创建,你再写 = 造出重复组件,还得花轮次删;真 LLM 实测踩过:主 agent 把返回的 code 又追加了一次 → 索引 8/9 重复)。核对方式 = read 该数组尾部(确认新组件存在 + name 唯一),仅此而已。`,
@@ -6573,23 +6574,25 @@ function il(e, t, n) {
 	return r;
 }
 function al(e) {
-	let { writablePaths: t, codeVfsPrefix: n, ext: r, codeField: i = "code", onWarning: a, getController: o, vfsStore: s, craftNotes: c = !0 } = e;
+	let { writablePaths: t, codeVfsPrefix: n, ext: r, codeField: i = "code", onWarning: a, getController: o, vfsStore: s, craftNotes: c = !0 } = e, l = s, u = l.__pgLastCheckout ??= /* @__PURE__ */ new Map(), d = l.__pgPendingRetry ??= /* @__PURE__ */ new Set();
 	return {
 		name: "code-asset-checkout-commit",
 		beforeAgent: (e) => {
-			let c = o()?.get?.().bind, l = 0, u = 0, d = /* @__PURE__ */ new Map();
+			let c = o()?.get?.().bind, l = 0, f = 0, p = /* @__PURE__ */ new Map();
 			if (rl(c, t, (e) => {
 				l++;
 				let t = Q(e, i);
 				if (typeof t == "string") {
-					u++, d.set(e.__pgId, el(t));
-					let i = `${n}${e.__pgId}.${r}`;
-					s.files[i] = {
+					f++;
+					let i = e.__pgId, a = el(t);
+					p.set(i, a);
+					let o = `${n}${i}.${r}`, c = s.files[o], l = u.get(i);
+					c && typeof c.content == "string" && c.content !== t && l === a ? d.add(o) : (s.files[o] = {
 						content: t,
 						updatedAt: Date.now()
-					};
+					}, d.delete(o)), u.set(i, a);
 				}
-			}), l > 0 && u === 0 && a) {
+			}), l > 0 && f === 0 && a) {
 				let e = "";
 				for (let n of t) {
 					let t = Q(c, n);
@@ -6604,7 +6607,7 @@ function al(e) {
 				files: s.files,
 				[Kc]: /* @__PURE__ */ new Set(),
 				[qc]: { text: "" },
-				[Jc]: d,
+				[Jc]: p,
 				[Yc]: []
 			};
 		},
@@ -6667,7 +6670,7 @@ function al(e) {
 					let a = t.__pgId;
 					c.add(a);
 					let l = `${n}${a}.${r}`;
-					if (u.has(l)) try {
+					if (!(!u.has(l) && !d.has(l))) try {
 						let n = s.files[l];
 						if (n && typeof n.content == "string") {
 							let r = o.get(a);
@@ -6685,7 +6688,7 @@ function al(e) {
 								console.warn(`[page-agent-sdk][code-asset] 跳过 commit 未通过校验的半成品(可能 abort/timeout 未跑完 verify):${l} - ${s[0].message}(${s[0].code})`);
 								return;
 							}
-							eo(t, i, n.content);
+							eo(t, i, n.content), d.delete(l);
 						}
 					} catch (e) {
 						console.warn(`[page-agent-sdk][code-asset] 组件 commit 失败已跳过(其余组件不受影响):${l} - ${String(e?.message ?? e)}`);
@@ -6698,18 +6701,18 @@ function al(e) {
 				a?.markDataDirty?.(), a?.recomputeBaseline?.();
 			}
 			if (!c) return;
-			let d = Qc(e[qc]?.text ?? "");
-			if (!d.length) return;
-			let f = [];
+			let f = Qc(e[qc]?.text ?? "");
+			if (!f.length) return;
+			let p = [];
 			if (rl(l, t, (e) => {
-				(u.size === 0 || u.has(`${n}${e.__pgId}.${r}`)) && f.push(e);
-			}), !f.length) return;
-			let p = !1;
-			for (let e of d) {
-				let t = f.length === 1 ? f[0] : f.find((t) => typeof t.name == "string" && !!t.name && e.includes(t.name));
-				t && ($c(t, [e]), p = !0);
+				(u.size === 0 || u.has(`${n}${e.__pgId}.${r}`)) && p.push(e);
+			}), !p.length) return;
+			let m = !1;
+			for (let e of f) {
+				let t = p.length === 1 ? p[0] : p.find((t) => typeof t.name == "string" && !!t.name && e.includes(t.name));
+				t && ($c(t, [e]), m = !0);
 			}
-			p && a?.markDataDirty?.();
+			m && a?.markDataDirty?.();
 		}
 	};
 }
@@ -11307,6 +11310,10 @@ function jf(e, n) {
 		afterRound() {
 			Rt(), Kt();
 		},
+		clearCodeReuse() {
+			let e = x;
+			e.__pgPendingRetry?.clear(), e.__pgLastCheckout?.clear();
+		},
 		async send(e, t) {
 			if (await Y.initDone, Y.refCount <= 0) throw Error("page-agent-sdk: agent 已释放(unmount),拒绝排队中的 send");
 			t ??= {}, t?.mission && Me && C.setMission(t.mission);
@@ -12074,6 +12081,7 @@ function Mf(e, t) {
 		},
 		stream: (e, t, n) => a.stream(e, t, n),
 		afterRound: a.afterRound,
+		clearCodeReuse: () => a.clearCodeReuse(),
 		get debugLogs() {
 			return a.agent.debugLogs;
 		},
@@ -12323,33 +12331,33 @@ async function zf(e) {
 //#region src/core/composables/useChat.ts
 var Bf = 4e3;
 function Vf(e = {}) {
-	let { fetchResponse: t, fetchStream: n, onPersist: r, onClear: i, onQueuedCleared: a } = e, o = /* @__PURE__ */ yt({
+	let { fetchResponse: t, fetchStream: n, onPersist: r, onClear: i, onQueuedCleared: a, onBeforeRegenerate: o } = e, s = /* @__PURE__ */ yt({
 		messages: e.messages ?? [],
 		loading: !1,
 		error: null
-	}), s = /* @__PURE__ */ At(null), c = /* @__PURE__ */ At(!0), l = null, u = /* @__PURE__ */ At([]), d = /* @__PURE__ */ At(null);
-	function f() {}
-	function p(e) {
-		let t = s.value;
-		e.deltaY < 0 ? c.value = !1 : t && (c.value = t.scrollHeight - t.scrollTop - t.clientHeight < 64);
-	}
-	function m() {
-		s.value && requestAnimationFrame(() => {
-			let e = s.value;
-			!e || !c.value || (e.scrollTop = e.scrollHeight);
+	}), c = /* @__PURE__ */ At(null), l = /* @__PURE__ */ At(!0), u = null, d = /* @__PURE__ */ At([]), f = /* @__PURE__ */ At(null);
+	function p() {}
+	function m(e) {
+		let t = c.value;
+		e.deltaY < 0 ? l.value = !1 : t && (l.value = t.scrollHeight - t.scrollTop - t.clientHeight < 64);
+	}
+	function h() {
+		c.value && requestAnimationFrame(() => {
+			let e = c.value;
+			!e || !l.value || (e.scrollTop = e.scrollHeight);
 		});
 	}
-	function h(e, t, n, r) {
-		o.messages.push({
+	function g(e, t, n, r) {
+		s.messages.push({
 			role: e,
 			content: t,
 			timestamp: Date.now(),
 			...n && n.length ? { focuses: n } : {},
 			...r?.length ? { images: r } : {}
-		}), c.value = !0, m();
+		}), l.value = !0, h();
 	}
-	async function g(e) {
-		if (c.value = !0, n) {
+	async function _(e) {
+		if (l.value = !0, n) {
 			let t = /* @__PURE__ */ yt({
 				role: "assistant",
 				content: "",
@@ -12357,9 +12365,9 @@ function Vf(e = {}) {
 				reasoning: "",
 				steps: []
 			}), r = !1;
-			o.messages.push(t);
+			s.messages.push(t);
 			try {
-				await n(o.messages.slice(0, -1), (e) => {
+				await n(s.messages.slice(0, -1), (e) => {
 					switch (e.type) {
 						case "round_start":
 							e.round > 1 && (t.content || t.reasoning) && (r = !0);
@@ -12418,34 +12426,34 @@ function Vf(e = {}) {
 							break;
 						}
 						case "approval_request":
-							d.value = {
+							f.value = {
 								toolName: e.toolName,
 								args: e.args,
 								resolve: e.resolve
 							};
 							break;
 					}
-					m();
+					h();
 				}, e);
 			} catch (n) {
-				if (Di(n, e) || (o.error = n.message || "请求失败,请重试"), !t.content && !t.reasoning) {
-					let e = o.messages.indexOf(t);
-					e >= 0 && o.messages.splice(e, 1);
+				if (Di(n, e) || (s.error = n.message || "请求失败,请重试"), !t.content && !t.reasoning) {
+					let e = s.messages.indexOf(t);
+					e >= 0 && s.messages.splice(e, 1);
 				}
 			} finally {
-				await v();
+				await y();
 			}
 			return;
 		}
 		try {
-			h("assistant", await (t || S)(o.messages, e));
+			g("assistant", await (t || C)(s.messages, e));
 		} catch (t) {
-			Di(t, e) || (o.error = t.message || "请求失败,请重试");
+			Di(t, e) || (s.error = t.message || "请求失败,请重试");
 		} finally {
-			await v();
+			await y();
 		}
 	}
-	function _(e) {
+	function v(e) {
 		let t = (e) => {
 			if (e?.length) for (let n of e) n.status === "running" && (n.status = "error", n.result ||= "(本轮已结束,该步骤未收到结果 —— 子 agent 中断/异常)"), n.children?.length && t(n.children);
 		};
@@ -12454,78 +12462,79 @@ function Vf(e = {}) {
 			break;
 		}
 	}
-	async function v() {
-		_(o.messages);
+	async function y() {
+		v(s.messages);
 		try {
-			await r?.(o.messages);
+			await r?.(s.messages);
 		} catch {}
-		o.loading = !1, l = null;
-		let e = u.value.shift();
-		e !== void 0 && (h("user", e), o.loading = !0, o.error = null, l = new AbortController(), await g(l.signal));
+		s.loading = !1, u = null;
+		let e = d.value.shift();
+		e !== void 0 && (g("user", e), s.loading = !0, s.error = null, u = new AbortController(), await _(u.signal));
 	}
-	function y(e) {
-		u.value.splice(e, 1);
+	function b(e) {
+		d.value.splice(e, 1);
 	}
-	async function b(e, t, n) {
+	async function x(e, t, n) {
 		if (!(!e.trim() && !n?.length)) {
-			if (o.loading) {
-				u.value.push(e.trim());
+			if (s.loading) {
+				d.value.push(e.trim());
 				return;
 			}
-			h("user", e.trim() || "[image]", t, n), o.loading = !0, o.error = null, l = new AbortController(), await g(l.signal);
+			g("user", e.trim() || "[image]", t, n), s.loading = !0, s.error = null, u = new AbortController(), await _(u.signal);
 		}
 	}
-	async function x() {
-		if (o.loading) return;
-		let e = o.messages;
+	async function S() {
+		if (s.loading) return;
+		o?.();
+		let e = s.messages;
 		for (let t = e.length - 1; t >= 0; t--) if (e[t].role === "assistant") {
 			e.splice(t);
 			break;
 		}
-		e.some((e) => e.role === "user") && (o.loading = !0, o.error = null, l = new AbortController(), await g(l.signal));
+		e.some((e) => e.role === "user") && (s.loading = !0, s.error = null, u = new AbortController(), await _(u.signal));
 	}
-	async function S(e) {
+	async function C(e) {
 		return await new Promise((e) => setTimeout(e, 800 + Math.random() * 1200)), `收到你的消息:"${e.filter((e) => e.role === "user").pop()?.content}"。这是一个模拟回复,请接入实际的 AI API。`;
 	}
-	function C() {
-		i?.(), o.messages.splice(0, o.messages.length), o.error = null;
-	}
 	function w() {
-		u.value.length && a?.([...u.value]), u.value = [], l?.abort();
+		i?.(), s.messages.splice(0, s.messages.length), s.error = null;
 	}
 	function T() {
-		u.value = [], l?.abort(), l = null, o.loading = !1, o.error = null, d.value = null;
+		d.value.length && a?.([...d.value]), d.value = [], u?.abort();
+	}
+	function E() {
+		d.value = [], u?.abort(), u = null, s.loading = !1, s.error = null, f.value = null;
 	}
-	function E(e) {
-		let t = d.value;
-		t && (d.value = null, t.resolve(e));
+	function ee(e) {
+		let t = f.value;
+		t && (f.value = null, t.resolve(e));
 	}
-	async function ee() {
-		if (!o.error) return;
-		let e = o.messages, t = -1;
+	async function D() {
+		if (!s.error) return;
+		let e = s.messages, t = -1;
 		for (let n = e.length - 1; n >= 0; n--) if (e[n].role === "user") {
 			t = n;
 			break;
 		}
 		if (t < 0) return;
 		let n = e[t].content;
-		e.splice(t), o.error = null, await b(n);
+		e.splice(t), s.error = null, await x(n);
 	}
 	return {
-		state: o,
-		scrollContainer: s,
-		pendingApproval: d,
-		queuedTasks: u,
-		sendMessage: b,
-		removeQueuedTask: y,
-		clearMessages: C,
-		stop: w,
-		reset: T,
-		retry: ee,
-		regenerate: x,
-		resolveApproval: E,
-		onScroll: f,
-		onWheel: p
+		state: s,
+		scrollContainer: c,
+		pendingApproval: f,
+		queuedTasks: d,
+		sendMessage: x,
+		removeQueuedTask: b,
+		clearMessages: w,
+		stop: T,
+		reset: E,
+		retry: D,
+		regenerate: S,
+		resolveApproval: ee,
+		onScroll: p,
+		onWheel: m
 	};
 }
 //#endregion
@@ -13054,7 +13063,8 @@ function Jf(e = {}) {
 		messages: e.messages,
 		onPersist: e.onPersist,
 		onClear: e.onClear,
-		onQueuedCleared: e.onQueuedCleared
+		onQueuedCleared: e.onQueuedCleared,
+		onBeforeRegenerate: e.onBeforeRegenerate
 	}), { state: n, sendMessage: r, removeQueuedTask: i, queuedTasks: a } = t, o = /* @__PURE__ */ At(""), s = /* @__PURE__ */ At(!0), c = () => {
 		s.value = !s.value;
 	}, l = /* @__PURE__ */ At(!1), u = () => {