agentpage 0.0.42 → 0.0.44

package/dist/index.mjs

@@ -225,6 +225,43 @@ function isPotentialDomMutation(toolName, toolInput) {
 	].includes(action);
 }
 /**
+* 判定动作是否为"确定性推进"——比 isPotentialDomMutation 更窄。
+*
+* 包含以下必定产生可见状态变化或属于显式用户意图的动作：
+* - 表单输入类：fill / type / select_option / clear / check / uncheck
+* - 键盘动作类：press（Enter 提交、Tab 切焦等均属用户显式操作）
+* - 导航类：navigate.*
+* - 自定义工具：非 SDK 内置工具（dom/navigate/page_info/wait/evaluate）
+*   均由开发者注册、模型有意调用，视为确定性推进
+*
+* click 不在此列——因为 click 可能点了但完全没效果（如点击无 click listener 的元素）。
+*
+* 用途：协议缺失计数重置与豁免。仅当本轮有"确定性推进"时才重置协议缺失计数器，
+* 避免模型反复点击无效目标导致死循环。
+*/
+function isConfirmedProgressAction(toolName, toolInput) {
+	if (toolName === "navigate") return true;
+	if (![
+		"dom",
+		"navigate",
+		"page_info",
+		"wait",
+		"evaluate"
+	].includes(toolName)) return true;
+	if (toolName !== "dom") return false;
+	const action = getToolAction(toolInput);
+	if (!action) return false;
+	return [
+		"fill",
+		"type",
+		"select_option",
+		"clear",
+		"check",
+		"uncheck",
+		"press"
+	].includes(action);
+}
+/**
 * 采集找不到元素任务。
 *
 * 返回 null 表示当前结果不属于“元素未找到”，
@@ -949,6 +986,7 @@ async function executeAgentLoop(params) {
 		}
 		let roundHasError = false;
 		let roundHasPotentialDomMutation = false;
+		let roundHasConfirmedProgress = false;
 		const executedTaskCalls = [];
 		const roundMissingTasks = [];
 		for (const tc of response.toolCalls) {
@@ -980,6 +1018,7 @@ async function executeAgentLoop(params) {
 			if (missingTask) roundMissingTasks.push(missingTask);
 			if (result.details && typeof result.details === "object") roundHasError = roundHasError || Boolean(result.details.error);
 			if (!hasToolError(result) && isPotentialDomMutation(tc.name, tc.input)) roundHasPotentialDomMutation = true;
+			if (!hasToolError(result) && isConfirmedProgressAction(tc.name, tc.input)) roundHasConfirmedProgress = true;
 			if (tc.name === "page_info" && getToolAction(tc.input) === "snapshot") {
 				pageContext.latestSnapshot = toContentString(result.content);
 				recordSnapshotStats(pageContext.latestSnapshot);
@@ -1001,9 +1040,8 @@ async function executeAgentLoop(params) {
 			if (nextByHeuristic !== remainingInstruction) {
 				remainingInstruction = nextByHeuristic;
 				consecutiveNoProtocolRounds = 0;
-			} else if (executedTaskCalls.length > 0) {
-				if (!roundHasPotentialDomMutation || roundHasError) consecutiveNoProtocolRounds += 1;
-			}
+			} else if (executedTaskCalls.length > 0) if (!roundHasConfirmedProgress || roundHasError) consecutiveNoProtocolRounds += 1;
+			else consecutiveNoProtocolRounds = 0;
 		}
 		previousRoundModelOutput = parsedInstructionState.hasRemainingProtocol ? normalizeModelOutput(response.text) : `REMAINING: ${remainingInstruction || "DONE"}`;
 		lastRoundHadError = roundHasError;
@@ -1829,7 +1867,8 @@ function buildSystemPrompt(params = {}) {
 		"- Only interactive elements carry #hashID; others are context-only and cannot be targeted.",
 		"- Bracket tag may show ARIA role ([combobox], [slider]) as primary interaction hint.",
 		"- listeners=\"...\" = bound event handlers (abbrevs below). Prefer targets with matching listeners.",
-		"- Click priority: clk/pdn/mdn, onclick, native link/button, role=button/link. Avoid focus-only or hover-only signals.",
+		"- Click target MUST have click signal: listeners containing clk/pdn/mdn, or onclick attr, or native <a>/<button>, or role=button/link. NEVER click elements with only blr/fcs (focus/blur) — they are not click targets.",
+		"- If the text you want to click has no click signal, look at its parent row/container or nearby sibling that does have clk listener.",
 		"- No-effect fallback: try nearest actionable sibling/ancestor in same semantic group instead of repeating.",
 		"- Batch fill/type/check/select_option freely within one round. A click always ends the round — send at most ONE click as the LAST action in a batch.",
 		"- Input order (MANDATORY): focus/click → fill/type/select_option per target. Multi-field: focus A→fill A→focus B→fill B.",