@coolkiller007/my-page-agent 0.1.14 → 0.1.15

package/dist/index.d.ts

@@ -42,6 +42,11 @@ declare interface AgentConfig extends LLMConfig {
      * @default 40
      */
     maxSteps?: number;
+    /**
+     * 拼装 LLM 提示词时，最近保留完整详情的历史步数；更早的步骤会被压缩成一行。
+     * @default 15
+     */
+    historyWindow?: number;
     /**
      * 用于扩展 PageAgent 能力的自定义工具
      * @experimental
@@ -231,6 +236,7 @@ declare class AgentRuntime extends EventTarget {
     /** 合并后的 Agent 配置（含最大步数上限） */
     readonly config: AgentRuntimeConfig & {
         maxSteps: number;
+        historyWindow: number;
     };
     /** 内部工具集合（按工具名索引） */
     readonly tools: typeof tools;
@@ -558,7 +564,7 @@ declare function getSelectorMap(flatTree: FlatDomTree): Map<number, InteractiveE
 /**
  * 所有历史事件的联合类型
  */
-export declare type HistoricalEvent = AgentStepEvent | ObservationEvent | UserTakeoverEvent | RetryEvent | AgentErrorEvent;
+export declare type HistoricalEvent = AgentStepEvent | ObservationEvent | UserTakeoverEvent | TaskStartEvent | RetryEvent | AgentErrorEvent;
 
 declare interface InteractiveElementDomNode {
     tagName: string;
@@ -741,6 +747,16 @@ declare type SupportedLanguage = 'en-US' | 'zh-CN';
 /** 受支持的语言代码类型 */
 declare type SupportedLanguage_2 = keyof typeof locales;
 
+/**
+ * 任务开始事件 - 标记一个新任务的起点
+ * @note history 数组跨任务持久保留（不再在每次 execute 时清空），
+ * 该事件用于在历史记录中分隔不同任务，UI 据此渲染各自的任务卡片。
+ */
+declare interface TaskStartEvent {
+    type: 'task_start';
+    task: string;
+}
+
 declare interface TextDomNode {
     type: 'TEXT_NODE';
     text: string;
@@ -839,7 +855,7 @@ declare interface UIAdapter extends EventTarget {
     } | null;
     /** agent 事件历史 */
     readonly history: readonly {
-        type: 'step' | 'observation' | 'user_takeover' | 'retry' | 'error';
+        type: 'step' | 'observation' | 'user_takeover' | 'task_start' | 'retry' | 'error';
         stepIndex?: number;
         /** 仅用于 'step' 类型 */
         reflection?: {
@@ -855,6 +871,8 @@ declare interface UIAdapter extends EventTarget {
         };
         /** 仅用于 'observation' 类型 */
         content?: string;
+        /** 仅用于 'task_start' 类型 */
+        task?: string;
         /** 仅用于 'retry' 类型 */
         attempt?: number;
         maxAttempts?: number;

package/dist/index.js

@@ -2756,6 +2756,7 @@ var UI = class {
 		if (status === "running") {
 			this.show();
 			this.#hideInputArea();
+			if (!this.#isExpanded) this.#expand();
 		}
 		if (status === "completed" || status === "error" || status === "stopped") {
 			if (!this.#isExpanded) this.#expand();
@@ -3149,16 +3150,15 @@ var UI = class {
 	* 直接从 agent.history 渲染历史
 	*
 	* 渲染内容：
-	* 1. 任务（第一项，来自 agent.task）
+	* 1. 任务卡片（每个 task_start 事件对应一张，history 跨任务持久保留，因此可展示历次任务）
 	* 2. 反思卡片（评估、记忆、下一步目标）
 	* 3. 工具执行及输出
 	* 4. 观察
 	*/
 	#renderHistory() {
 		const items = [];
-		const task = this.#agent.task;
-		if (task) items.push(this.#createTaskCard(task));
 		const history = this.#agent.history;
+		if (history.length === 0 && this.#agent.task) items.push(this.#createTaskCard(this.#agent.task));
 		for (const event of history) items.push(...this.#createHistoryCards(event));
 		this.#historySection.innerHTML = items.join("");
 		this.#scrollToBottom();
@@ -3176,7 +3176,9 @@ var UI = class {
 	#createHistoryCards(event) {
 		const cards = [];
 		const meta = event.type === "step" && event.stepIndex !== void 0 ? this.#i18n.t("ui.step", { number: (event.stepIndex + 1).toString() }) : void 0;
-		if (event.type === "step") {
+		if (event.type === "task_start") {
+			if (event.task) cards.push(this.#createTaskCard(event.task));
+		} else if (event.type === "step") {
 			if (event.reflection) {
 				const lines = createReflectionLines(event.reflection);
 				if (lines.length > 0) cards.push(createCard({
@@ -4146,6 +4148,8 @@ var AgentRuntime = class extends EventTarget {
 	#abortController = new AbortController();
 	/** 本轮任务收集的观察消息（暂存，稍后统一写入历史） */
 	#observations = [];
+	/** 当前任务在 history 数组中的起始下标（用于跨任务保留历史时，把 prompt/循环检测限定在当前任务范围内） */
+	#taskHistoryStart = 0;
 	/** 当前一次运行完全结束时 resolve。由 `stop()` 等待。 */
 	#running = Promise.resolve();
 	#lastResult = null;
@@ -4163,7 +4167,8 @@ var AgentRuntime = class extends EventTarget {
 		super();
 		this.config = {
 			...config,
-			maxSteps: config.maxSteps ?? 40
+			maxSteps: config.maxSteps ?? 40,
+			historyWindow: config.historyWindow ?? 5
 		};
 		this.#llm = new LLM(this.config);
 		this.tools = new Map(tools);
@@ -4205,6 +4210,10 @@ var AgentRuntime = class extends EventTarget {
 	get lastResult() {
 		return this.#lastResult;
 	}
+	/** 当前任务自身的历史事件（不含之前任务留下的记录），用于 prompt 拼装、循环检测等按任务隔离的场景 */
+	get #currentTaskHistory() {
+		return this.history.slice(this.#taskHistoryStart);
+	}
 	/** 触发 statuschange 事件 */
 	#emitStatusChange() {
 		this.dispatchEvent(new Event("statuschange"));
@@ -4256,7 +4265,11 @@ var AgentRuntime = class extends EventTarget {
 		if (!task) throw new Error("Task is required");
 		this.task = task;
 		this.taskId = uid();
-		this.history = [];
+		this.#taskHistoryStart = this.history.length;
+		this.#emitHistoryChange({
+			type: "task_start",
+			task
+		});
 		this.#observations = [];
 		this.#states = {
 			totalWaitTime: 0,
@@ -4297,7 +4310,7 @@ var AgentRuntime = class extends EventTarget {
 					taskResult = {
 						success: false,
 						data: message,
-						history: this.history
+						history: this.#currentTaskHistory
 					};
 					this.#lastResult = taskResult;
 					finalStatus = "error";
@@ -4355,7 +4368,7 @@ var AgentRuntime = class extends EventTarget {
 						taskResult = {
 							success,
 							data,
-							history: this.history
+							history: this.#currentTaskHistory
 						};
 						this.#lastResult = taskResult;
 						finalStatus = "completed";
@@ -4377,14 +4390,14 @@ var AgentRuntime = class extends EventTarget {
 					taskResult = {
 						success: false,
 						data: message,
-						history: this.history
+						history: this.#currentTaskHistory
 					};
 					this.#lastResult = taskResult;
 					finalStatus = isAbortError ? "stopped" : "error";
 					break;
 				} finally {
 					console.groupEnd();
-					await onAfterStep?.(this, this.history);
+					await onAfterStep?.(this, this.#currentTaskHistory);
 				}
 				step++;
 			}
@@ -4506,7 +4519,7 @@ var AgentRuntime = class extends EventTarget {
 	*/
 	async #handleObservations(step) {
 		if (this.#states.totalWaitTime >= 3) this.pushObservation(`You have waited ${this.#states.totalWaitTime} seconds accumulatively. DO NOT wait any longer unless you have a good reason.`);
-		const recentSteps = this.history.filter((e) => e.type === "step").slice(-3);
+		const recentSteps = this.#currentTaskHistory.filter((e) => e.type === "step").slice(-3);
 		if (recentSteps.length === 3) {
 			const isSameAction = (a, b) => a.action.name === b.action.name && JSON.stringify(a.action.input) === JSON.stringify(b.action.input);
 			if (isSameAction(recentSteps[0], recentSteps[1]) && isSameAction(recentSteps[1], recentSteps[2])) this.pushObservation(`⚠️ Loop detected: you repeated the exact same action ("${recentSteps[0].action.name}" with identical input) 3 times in a row with no new result. STOP repeating it. If the target genuinely does not exist (e.g. search returns empty), report this explicitly and call \`done\`, or try a clearly different action/strategy instead.`);
@@ -4539,7 +4552,8 @@ var AgentRuntime = class extends EventTarget {
 		const browserState = this.#states.browserState;
 		let prompt = "";
 		prompt += await this.#getInstructions();
-		const stepCount = this.history.filter((e) => e.type === "step").length;
+		const currentTaskHistory = this.#currentTaskHistory;
+		const stepCount = currentTaskHistory.filter((e) => e.type === "step").length;
 		prompt += "<agent_state>\n";
 		prompt += "<user_request>\n";
 		prompt += `${this.task}\n`;
@@ -4549,10 +4563,10 @@ var AgentRuntime = class extends EventTarget {
 		prompt += `Current time: ${(/* @__PURE__ */ new Date()).toLocaleString()}\n`;
 		prompt += "</step_info>\n";
 		prompt += "</agent_state>\n\n";
-		const windowStart = Math.max(0, stepCount - 5);
+		const windowStart = Math.max(0, stepCount - this.config.historyWindow);
 		prompt += "<agent_history>\n";
 		let stepIndex = 0;
-		for (const event of this.history) if (event.type === "step") {
+		for (const event of currentTaskHistory) if (event.type === "step") {
 			stepIndex++;
 			if (stepIndex <= windowStart) {
 				prompt += `<step_${stepIndex}>Action: ${event.action.name} — Next Goal: ${event.reflection.next_goal}</step_${stepIndex}>\n`;