@coolkiller007/my-page-agent 0.1.14 → 0.2.0

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;
@@ -269,7 +275,7 @@ declare class AgentRuntime extends EventTarget {
      * 外部错误（前置检查/配置/钩子）会直接抛出；
      * Agent 内部错误会被捕获并加入历史，同时返回失败结果
      */
-    execute(task: string): Promise<ExecutionResult>;
+    execute(task: string, attachments?: Attachment[]): Promise<ExecutionResult>;
     /** 销毁 Agent：中止任务、释放浏览器控制器，并触发 dispose 事件（一次性） */
     dispose(): void;
 }
@@ -317,6 +323,25 @@ declare interface AgentTool<TParams = any> {
     execute: (this: AgentRuntime, args: TParams, ctx: ToolContext) => Promise<string>;
 }
 
+/**
+ * 用户随任务一起上传的附件（图片或文本类文件）
+ */
+declare interface Attachment {
+    name: string;
+    mimeType: string;
+    dataUrl: string;
+}
+
+/**
+ * 用户随任务一起上传的附件（图片或文本类文件）
+ * @note 与 agent/types.ts 中的 Attachment 结构一致，但独立声明以保持 UI 与 Agent 解耦
+ */
+declare interface Attachment_2 {
+    name: string;
+    mimeType: string;
+    dataUrl: string;
+}
+
 /**
  * BrowserController 管理 DOM 状态和元素交互。
  * 它为所有 DOM 操作提供异步方法，并保持状态隔离。
@@ -558,7 +583,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;
@@ -628,6 +653,11 @@ declare const locales: {
             readonly expand: "Expand history";
             readonly collapse: "Collapse history";
             readonly step: "Step {{number}}";
+            readonly attachButtonTitle: "Attach files";
+            readonly attachTooMany: "You can attach up to {{max}} files";
+            readonly attachTooLarge: "\"{{name}}\" exceeds the {{maxMB}}MB size limit";
+            readonly attachUnsupportedType: "\"{{name}}\" is not a supported file type";
+            readonly attachmentsLabel: "📎 Attachments: {{names}}";
             readonly tools: {
                 readonly clicking: "Clicking element [{{index}}]...";
                 readonly inputting: "Inputting text to element [{{index}}]...";
@@ -672,6 +702,11 @@ declare const locales: {
             readonly expand: "展开历史";
             readonly collapse: "收起历史";
             readonly step: "步骤 {{number}}";
+            readonly attachButtonTitle: "添加附件";
+            readonly attachTooMany: "最多可添加 {{max}} 个文件";
+            readonly attachTooLarge: "\"{{name}}\" 超过 {{maxMB}}MB 大小限制";
+            readonly attachUnsupportedType: "\"{{name}}\" 不是支持的文件类型";
+            readonly attachmentsLabel: "📎 附件: {{names}}";
             readonly tools: {
                 readonly clicking: "正在点击元素 [{{index}}]...";
                 readonly inputting: "正在输入文本到元素 [{{index}}]...";
@@ -741,6 +776,17 @@ 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;
+    attachmentNames?: string[];
+}
+
 declare interface TextDomNode {
     type: 'TEXT_NODE';
     text: string;
@@ -839,7 +885,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 +901,10 @@ declare interface UIAdapter extends EventTarget {
         };
         /** 仅用于 'observation' 类型 */
         content?: string;
+        /** 仅用于 'task_start' 类型 */
+        task?: string;
+        /** 仅用于 'task_start' 类型 */
+        attachmentNames?: string[];
         /** 仅用于 'retry' 类型 */
         attempt?: number;
         maxAttempts?: number;
@@ -872,8 +922,8 @@ declare interface UIAdapter extends EventTarget {
     onAskUser?: (question: string, options?: {
         signal: AbortSignal;
     }) => Promise<string>;
-    /** 执行一个任务 */
-    execute(task: string): Promise<unknown>;
+    /** 执行一个任务；attachments 为随任务一起上传的图片/文本附件（可选） */
+    execute(task: string, attachments?: Attachment_2[]): Promise<unknown>;
     /** 停止当前任务（agent 仍可复用） */
     stop(): Promise<void>;
     /** 销毁 agent（终态，不可复用） */