@page-agent/ui 0.0.7

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Alibaba
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/lib/index.d.ts

@@ -0,0 +1,297 @@
+import { Motion } from 'ai-motion';
+
+export declare type AgentStatus = 'idle' | 'running' | 'paused' | 'completed' | 'error';
+
+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";
+        };
+    };
+};
+
+export declare class I18n {
+    private language;
+    private translations;
+    constructor(language?: SupportedLanguage);
+    t(key: TranslationKey, params?: TranslationParams): string;
+    private getNestedValue;
+    private interpolate;
+    getLanguage(): SupportedLanguage;
+}
+
+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}}\"";
+            };
+        };
+    };
+};
+
+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)];
+
+/**
+ * Agent control panel
+ */
+export declare class Panel {
+    #private;
+    get wrapper(): HTMLElement;
+    constructor(config: PanelConfig);
+    /**
+     * Ask for user input
+     */
+    askUser(question: string): Promise<string>;
+    show(): void;
+    hide(): void;
+    reset(): void;
+    expand(): void;
+    collapse(): void;
+    /**
+     * Update panel with semantic data - i18n handled internally
+     */
+    update(data: PanelUpdate): void;
+    /**
+     * Dispose panel
+     */
+    dispose(): void;
+}
+
+/**
+ * Panel configuration
+ */
+export declare interface PanelConfig {
+    language?: SupportedLanguage;
+    onExecuteTask: (task: string) => void;
+    onStop: () => void;
+    onPauseToggle: () => boolean;
+    getPaused: () => boolean;
+}
+
+/**
+ * Semantic update types - Panel handles i18n internally
+ */
+export declare type PanelUpdate = {
+    type: 'thinking';
+    text?: string;
+} | {
+    type: 'input';
+    task: string;
+} | {
+    type: 'question';
+    question: string;
+} | {
+    type: 'userAnswer';
+    input: string;
+} | {
+    type: 'retry';
+    current: number;
+    max: number;
+} | {
+    type: 'error';
+    message: string;
+} | {
+    type: 'output';
+    text: string;
+} | {
+    type: 'completed';
+} | {
+    type: 'toolExecuting';
+    toolName: string;
+    args: any;
+} | {
+    type: 'toolCompleted';
+    toolName: string;
+    args: any;
+    result?: string;
+    duration?: number;
+};
+
+export 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
+ */
+export 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;
+}
+
+export declare type SupportedLanguage = keyof typeof locales;
+
+export declare type TranslationKey = NestedKeyOf<TranslationSchema>;
+
+declare type TranslationParams = Record<string, string | number>;
+
+declare type TranslationSchema = DeepStringify<typeof enUS>;
+
+export declare class UIState {
+    private steps;
+    private currentStep;
+    private status;
+    private stepCounter;
+    addStep(stepData: Omit<Step, 'id' | 'stepNumber' | 'timestamp'>): Step;
+    updateCurrentStep(updates: Partial<Step>): Step | null;
+    getCurrentStep(): Step | null;
+    getAllSteps(): Step[];
+    getStatus(): AgentStatus;
+    reset(): void;
+    private updateStatus;
+    private generateId;
+}
+
+export { }