@coolkiller007/my-page-agent 0.1.15 → 0.2.1

package/dist/index.d.ts

@@ -275,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;
 }
@@ -323,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 操作提供异步方法，并保持状态隔离。
@@ -634,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}}]...";
@@ -678,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}}]...";
@@ -755,6 +784,7 @@ declare type SupportedLanguage_2 = keyof typeof locales;
 declare interface TaskStartEvent {
     type: 'task_start';
     task: string;
+    attachmentNames?: string[];
 }
 
 declare interface TextDomNode {
@@ -873,6 +903,8 @@ declare interface UIAdapter extends EventTarget {
         content?: string;
         /** 仅用于 'task_start' 类型 */
         task?: string;
+        /** 仅用于 'task_start' 类型 */
+        attachmentNames?: string[];
         /** 仅用于 'retry' 类型 */
         attempt?: number;
         maxAttempts?: number;
@@ -890,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（终态，不可复用） */