page-agent 0.0.7 → 0.0.10

package/README.md

@@ -1,6 +1,6 @@
 # PageAgent 🤖🪄
 
-![banner](https://img.alicdn.com/imgextra/i1/O1CN01RY0Wvh26ATVeDIX7v_!!6000000007621-0-tps-1672-512.jpg)
+![banner](https://img.alicdn.com/imgextra/i3/O1CN01MyVCS21EoKkIHUT1s_!!6000000000398-49-tps-1280-353.webp)
 
 [![npm version](https://badge.fury.io/js/page-agent.svg)](https://badge.fury.io/js/page-agent) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) [![TypeScript](https://img.shields.io/badge/%3C%2F%3E-TypeScript-%230074c1.svg)](http://www.typescriptlang.org/) [![Downloads](https://img.shields.io/npm/dt/page-agent.svg)](https://www.npmjs.com/package/page-agent) [![Bundle Size](https://img.shields.io/bundlephobia/minzip/page-agent)](https://bundlephobia.com/package/page-agent) [![GitHub stars](https://img.shields.io/github/stars/alibaba/page-agent.svg)](https://github.com/alibaba/page-agent)
 
@@ -72,11 +72,8 @@ PageAgent adopts a simplified monorepo structure:
 ```
 packages/
 ├── page-agent/          # AI agent (npm: page-agent)
-│   ├── PageAgent        # Agent main loop
-│   ├── tools/           # LLM tool definitions
-│   ├── ui/              # UI components & panels
-│   └── llms/            # LLM integration layer
 ├── page-controller/     # DOM operations (npm: @page-agent/page-controller)
+├── ui/                  # Panel & Mask & Mouse Animation (npm: @page-agent/ui)
 └── website/             # Demo & Documentation site
 ```
 

package/dist/lib/PageAgent.d.ts

@@ -1,6 +1,8 @@
-import { Motion } from 'ai-motion';
 import { PageController } from '@page-agent/page-controller';
 import { PageControllerConfig } from '@page-agent/page-controller';
+import { Panel } from '@page-agent/ui';
+import { SimulatorMask } from '@page-agent/ui';
+import { SupportedLanguage } from '@page-agent/ui';
 import { z } from 'zod';
 
 export declare interface AgentBrain {
@@ -87,102 +89,12 @@ export declare interface AgentHistory {
     };
 }
 
-declare type DeepStringify<T> = {
-    [K in keyof T]: T[K] extends string ? string : T[K] extends object ? DeepStringify<T[K]> : T[K];
-};
-
-declare const enUS: {
-    readonly ui: {
-        readonly panel: {
-            readonly ready: "Ready";
-            readonly thinking: "Thinking...";
-            readonly paused: "Paused";
-            readonly taskInput: "Enter new task, describe steps in detail, press Enter to submit";
-            readonly userAnswerPrompt: "Please answer the question above, press Enter to submit";
-            readonly taskTerminated: "Task terminated";
-            readonly taskCompleted: "Task completed";
-            readonly continueExecution: "Continue execution";
-            readonly userAnswer: "User answer: {{input}}";
-            readonly question: "Question: {{question}}";
-            readonly waitingPlaceholder: "Waiting for task to start...";
-            readonly pause: "Pause";
-            readonly continue: "Continue";
-            readonly stop: "Stop";
-            readonly expand: "Expand history";
-            readonly collapse: "Collapse history";
-            readonly step: "Step {{number}} · {{time}}{{duration}}";
-        };
-        readonly tools: {
-            readonly clicking: "Clicking element [{{index}}]...";
-            readonly inputting: "Inputting text to element [{{index}}]...";
-            readonly selecting: "Selecting option \"{{text}}\"...";
-            readonly scrolling: "Scrolling page...";
-            readonly waiting: "Waiting {{seconds}} seconds...";
-            readonly done: "Task done";
-            readonly clicked: "🖱️ Clicked element [{{index}}]";
-            readonly inputted: "⌨️ Inputted text \"{{text}}\"";
-            readonly selected: "☑️ Selected option \"{{text}}\"";
-            readonly scrolled: "🛞 Page scrolled";
-            readonly waited: "⌛️ Wait completed";
-            readonly executing: "Executing {{toolName}}...";
-            readonly resultSuccess: "success";
-            readonly resultFailure: "failed";
-            readonly resultError: "error";
-        };
-        readonly errors: {
-            readonly elementNotFound: "No interactive element found at index {{index}}";
-            readonly taskRequired: "Task description is required";
-            readonly executionFailed: "Task execution failed";
-            readonly notInputElement: "Element is not an input or textarea";
-            readonly notSelectElement: "Element is not a select element";
-            readonly optionNotFound: "Option \"{{text}}\" not found";
-        };
-    };
-};
-
-/**
- * Type-safe event bus
- * @note Mainly used to decouple logic and UI
- * @note All modules of a PageAgent instance share the same EventBus instance for communication
- * @note Use with caution if delivery guarantee is needed for logic communication
- * @note `on` `once` `emit` methods handle built-in events with type protection, use `addEventListener` for other events
- */
-declare class EventBus extends EventTarget {
-    /**
-     * Listen to built-in events
-     */
-    on<T extends keyof PageAgentEventMap>(event: T, handler: EventHandler<T>): void;
-    /**
-     * Listen to built-in events (one-time)
-     */
-    once<T extends keyof PageAgentEventMap>(event: T, handler: EventHandler<T>): void;
-    /**
-     * Emit built-in events
-     */
-    emit<T extends keyof PageAgentEventMap>(event: T, ...args: PageAgentEventMap[T]['params'] extends undefined ? [] : [PageAgentEventMap[T]['params']]): void;
-}
-
-/**
- * Event handler type definitions
- */
-declare type EventHandler<T extends keyof PageAgentEventMap> = PageAgentEventMap[T]['params'] extends undefined ? () => void : (params: PageAgentEventMap[T]['params']) => void;
-
 export declare interface ExecutionResult {
     success: boolean;
     data: string;
     history: AgentHistory[];
 }
 
-declare class I18n {
-    private language;
-    private translations;
-    constructor(language?: SupportedLanguage);
-    t(key: TranslationKey, params?: TranslationParams): string;
-    private getNestedValue;
-    private interpolate;
-    getLanguage(): SupportedLanguage;
-}
-
 declare interface LLMConfig {
     baseURL?: string;
     apiKey?: string;
@@ -192,105 +104,6 @@ declare interface LLMConfig {
     maxRetries?: number;
 }
 
-declare const locales: {
-    readonly 'en-US': {
-        readonly ui: {
-            readonly panel: {
-                readonly ready: "Ready";
-                readonly thinking: "Thinking...";
-                readonly paused: "Paused";
-                readonly taskInput: "Enter new task, describe steps in detail, press Enter to submit";
-                readonly userAnswerPrompt: "Please answer the question above, press Enter to submit";
-                readonly taskTerminated: "Task terminated";
-                readonly taskCompleted: "Task completed";
-                readonly continueExecution: "Continue execution";
-                readonly userAnswer: "User answer: {{input}}";
-                readonly question: "Question: {{question}}";
-                readonly waitingPlaceholder: "Waiting for task to start...";
-                readonly pause: "Pause";
-                readonly continue: "Continue";
-                readonly stop: "Stop";
-                readonly expand: "Expand history";
-                readonly collapse: "Collapse history";
-                readonly step: "Step {{number}} · {{time}}{{duration}}";
-            };
-            readonly tools: {
-                readonly clicking: "Clicking element [{{index}}]...";
-                readonly inputting: "Inputting text to element [{{index}}]...";
-                readonly selecting: "Selecting option \"{{text}}\"...";
-                readonly scrolling: "Scrolling page...";
-                readonly waiting: "Waiting {{seconds}} seconds...";
-                readonly done: "Task done";
-                readonly clicked: "🖱️ Clicked element [{{index}}]";
-                readonly inputted: "⌨️ Inputted text \"{{text}}\"";
-                readonly selected: "☑️ Selected option \"{{text}}\"";
-                readonly scrolled: "🛞 Page scrolled";
-                readonly waited: "⌛️ Wait completed";
-                readonly executing: "Executing {{toolName}}...";
-                readonly resultSuccess: "success";
-                readonly resultFailure: "failed";
-                readonly resultError: "error";
-            };
-            readonly errors: {
-                readonly elementNotFound: "No interactive element found at index {{index}}";
-                readonly taskRequired: "Task description is required";
-                readonly executionFailed: "Task execution failed";
-                readonly notInputElement: "Element is not an input or textarea";
-                readonly notSelectElement: "Element is not a select element";
-                readonly optionNotFound: "Option \"{{text}}\" not found";
-            };
-        };
-    };
-    readonly 'zh-CN': {
-        readonly ui: {
-            readonly panel: {
-                readonly ready: "准备就绪";
-                readonly thinking: "正在思考...";
-                readonly paused: "暂停中，稍后";
-                readonly taskInput: "输入新任务，详细描述步骤，回车提交";
-                readonly userAnswerPrompt: "请回答上面问题，回车提交";
-                readonly taskTerminated: "任务已终止";
-                readonly taskCompleted: "任务结束";
-                readonly continueExecution: "继续执行";
-                readonly userAnswer: "用户回答: {{input}}";
-                readonly question: "询问: {{question}}";
-                readonly waitingPlaceholder: "等待任务开始...";
-                readonly pause: "暂停";
-                readonly continue: "继续";
-                readonly stop: "终止";
-                readonly expand: "展开历史";
-                readonly collapse: "收起历史";
-                readonly step: "步骤 {{number}} · {{time}}{{duration}}";
-            };
-            readonly tools: {
-                readonly clicking: "正在点击元素 [{{index}}]...";
-                readonly inputting: "正在输入文本到元素 [{{index}}]...";
-                readonly selecting: "正在选择选项 \"{{text}}\"...";
-                readonly scrolling: "正在滚动页面...";
-                readonly waiting: "等待 {{seconds}} 秒...";
-                readonly done: "结束任务";
-                readonly clicked: "🖱️ 已点击元素 [{{index}}]";
-                readonly inputted: "⌨️ 已输入文本 \"{{text}}\"";
-                readonly selected: "☑️ 已选择选项 \"{{text}}\"";
-                readonly scrolled: "🛞 页面滚动完成";
-                readonly waited: "⌛️ 等待完成";
-                readonly executing: "正在执行 {{toolName}}...";
-                readonly resultSuccess: "成功";
-                readonly resultFailure: "失败";
-                readonly resultError: "错误";
-            };
-            readonly errors: {
-                readonly elementNotFound: "未找到索引为 {{index}} 的交互元素";
-                readonly taskRequired: "任务描述不能为空";
-                readonly executionFailed: "任务执行失败";
-                readonly notInputElement: "元素不是输入框或文本域";
-                readonly notSelectElement: "元素不是选择框";
-                readonly optionNotFound: "未找到选项 \"{{text}}\"";
-            };
-        };
-    };
-};
-
 /**
  * MacroTool input structure
  */
@@ -309,16 +122,10 @@ export declare interface MacroToolResult {
     output: string;
 }
 
-declare type NestedKeyOf<ObjectType extends object> = {
-    [Key in keyof ObjectType & (string | number)]: ObjectType[Key] extends object ? `${Key}` | `${Key}.${NestedKeyOf<ObjectType[Key]>}` : `${Key}`;
-}[keyof ObjectType & (string | number)];
-
 export declare class PageAgent extends EventTarget {
     #private;
     config: PageAgentConfig;
     id: string;
-    bus: EventBus;
-    i18n: I18n;
     panel: Panel;
     tools: typeof tools;
     paused: boolean;
@@ -341,31 +148,6 @@ export declare class PageAgent extends EventTarget {
 
 export declare type PageAgentConfig = LLMConfig & AgentConfig & PageControllerConfig;
 
-/**
- * Event mapping definitions
- * @note Event bus callbacks must be repeatable without errors
- */
-declare interface PageAgentEventMap {
-    'panel:show': {
-        params: undefined;
-    };
-    'panel:hide': {
-        params: undefined;
-    };
-    'panel:reset': {
-        params: undefined;
-    };
-    'panel:update': {
-        params: Omit<Step, 'id' | 'stepNumber' | 'timestamp'>;
-    };
-    'panel:expand': {
-        params: undefined;
-    };
-    'panel:collapse': {
-        params: undefined;
-    };
-}
-
 /**
  * Internal tool definition that has access to PageAgent `this` context
  */
@@ -375,52 +157,6 @@ export declare interface PageAgentTool<TParams = any> {
     execute: (this: PageAgent, args: TParams) => Promise<string>;
 }
 
-/**
- * Agent control panel
- */
-declare class Panel {
-    #private;
-    get wrapper(): HTMLElement;
-    constructor(pageAgent: PageAgent);
-    /**
-     * Ask for user input
-     */
-    askUser(question: string): Promise<string>;
-    /**
-     * Dispose panel
-     */
-    dispose(): void;
-}
-
-declare class SimulatorMask {
-    #private;
-    wrapper: HTMLDivElement;
-    motion: Motion;
-    constructor();
-    setCursorPosition(x: number, y: number): void;
-    triggerClickAnimation(): void;
-    show(): void;
-    hide(): void;
-    dispose(): void;
-}
-
-/**
- * Agent execution state management
- */
-declare interface Step {
-    id: string;
-    stepNumber: number;
-    timestamp: Date;
-    type: 'thinking' | 'tool_executing' | 'completed' | 'error' | 'output' | 'input' | 'retry';
-    toolName?: string;
-    toolArgs?: any;
-    toolResult?: any;
-    displayText: string;
-    duration?: number;
-}
-
-declare type SupportedLanguage = keyof typeof locales;
-
 export declare function tool<TParams>(options: PageAgentTool<TParams>): PageAgentTool<TParams>;
 
 /**
@@ -429,10 +165,4 @@ export declare function tool<TParams>(options: PageAgentTool<TParams>): PageAgen
  */
 declare const tools: Map<string, PageAgentTool<any>>;
 
-declare type TranslationKey = NestedKeyOf<TranslationSchema>;
-
-declare type TranslationParams = Record<string, string | number>;
-
-declare type TranslationSchema = DeepStringify<typeof enUS>;
-
 export { }