@hao-gd/page-agent-ui 1.10.1

package/dist/lib/index.d.ts

@@ -0,0 +1,801 @@
+/**
+ * Derived active LLM configuration from the currently selected provider + model.
+ */
+export declare interface ActiveLLMConfig {
+    baseURL: string;
+    model: string;
+    apiKey?: string;
+    apiFormat: ApiFormat;
+    temperature: number;
+    maxSteps: number;
+}
+
+/**
+ * Supported API protocol formats.
+ * - `openai`: OpenAI Chat Completions API (/chat/completions)
+ * - `anthropic`: Anthropic Messages API (/messages)
+ */
+export declare type ApiFormat = 'openai' | 'anthropic';
+
+/**
+ * A single conversation representing one agent task session.
+ */
+export declare interface Conversation {
+    /** Unique identifier */
+    id: string;
+    /** Display title — derived from the first task or auto-generated */
+    title: string;
+    /** Unix timestamp of creation */
+    createdAt: number;
+    /** Unix timestamp of last modification */
+    updatedAt: number;
+    /** The original task description */
+    task: string;
+    /** Full history of agent events */
+    history: ConversationHistoryEvent[];
+    /** Result of the most recent run, or null if never completed */
+    lastResult: {
+        success: boolean;
+        data: string;
+        history?: ConversationHistoryEvent[];
+    } | null;
+    /** Agent status at save time */
+    status: 'idle' | 'running' | 'completed' | 'error' | 'stopped';
+}
+
+export declare interface ConversationErrorEvent {
+    type: 'error';
+    message: string;
+}
+
+/**
+ * Serializable history event stored in a conversation.
+ * Mirrors the agent's HistoricalEvent shape but is self-contained
+ * so the UI package stays independent of @hao-gd/page-agent-core.
+ */
+export declare type ConversationHistoryEvent = ConversationStepEvent | ConversationObservationEvent | ConversationUserTakeoverEvent | ConversationRetryEvent | ConversationErrorEvent;
+
+export declare interface ConversationObservationEvent {
+    type: 'observation';
+    content: string;
+}
+
+export declare interface ConversationRetryEvent {
+    type: 'retry';
+    message: string;
+    attempt: number;
+    maxAttempts: number;
+}
+
+export declare interface ConversationStepEvent {
+    type: 'step';
+    stepIndex: number;
+    reflection: {
+        evaluation_previous_goal?: string;
+        memory?: string;
+        next_goal?: string;
+    };
+    action: {
+        name: string;
+        input: unknown;
+        output: string;
+    };
+    usage?: {
+        promptTokens: number;
+        completionTokens: number;
+        totalTokens: number;
+        cachedTokens?: number;
+        reasoningTokens?: number;
+    };
+    rawResponse?: unknown;
+    rawRequest?: unknown;
+}
+
+/**
+ * Static helper for persisting and retrieving conversations via IndexedDB.
+ *
+ * Usage:
+ *   await ConversationStorage.save(conv)
+ *   const all = await ConversationStorage.list()
+ *   const active = await ConversationStorage.getActiveId()
+ */
+export declare const ConversationStorage: {
+    /** List all conversations ordered by updatedAt descending (newest first). */
+    list(): Promise<Conversation[]>;
+    /** Get a single conversation by id. */
+    get(id: string): Promise<Conversation | undefined>;
+    /** Insert or update a conversation. */
+    save(conv: Conversation): Promise<void>;
+    /** Delete a conversation by id. */
+    delete(id: string): Promise<void>;
+    /** Get the currently active conversation id from localStorage. */
+    getActiveId(): string | null;
+    /** Set the currently active conversation id in localStorage. */
+    setActiveId(id: string): void;
+    /** Clear the active conversation marker. */
+    clearActiveId(): void;
+};
+
+export declare interface ConversationUserTakeoverEvent {
+    type: 'user_takeover';
+}
+
+declare type DeepStringify<T> = {
+    [K in keyof T]: T[K] extends string ? string : T[K] extends object ? DeepStringify<T[K]> : T[K];
+};
+
+/**
+ * Derive a title from a task string: first line, truncated.
+ */
+export declare function deriveTitle(task: string): string;
+
+declare const enUS: {
+    readonly ui: {
+        readonly panel: {
+            readonly ready: "Ready";
+            readonly thinking: "Thinking...";
+            readonly taskInput: "Enter new task, describe steps in detail, press Ctrl/Cmd+Enter to submit";
+            readonly taskInputWindows: "Enter new task, describe steps in detail, press Enter to submit, Shift+Enter for new line";
+            readonly userAnswerPrompt: "Please answer the question above, press Ctrl/Cmd+Enter to submit";
+            readonly userAnswerPromptWindows: "Please answer the question above, press Enter to submit, Shift+Enter for new line";
+            readonly waitingPlaceholder: "Waiting for task to start...";
+            readonly stop: "Stop";
+            readonly close: "Close";
+            readonly expand: "Expand history";
+            readonly history: "History";
+            readonly step: "Step {{number}}";
+            readonly newConversation: "New Conversation";
+            readonly conversations: "Conversations";
+            readonly noConversations: "No conversations";
+            readonly conversationDefaultTitle: "New Conversation";
+            readonly deleteConversation: "Delete conversation";
+            readonly timeJustNow: "Just now";
+            readonly timeMinutesAgo: "{{n}}m ago";
+            readonly timeHoursAgo: "{{n}}h ago";
+            readonly timeDaysAgo: "{{n}}d ago";
+        };
+        readonly settings: {
+            readonly title: "Settings";
+            readonly modelTab: "Model Config";
+            readonly providersTab: "Providers";
+            readonly generalTab: "General";
+            readonly baseURL: "Base URL";
+            readonly baseURLHint: "API endpoint (without /chat/completions or /messages)";
+            readonly apiFormat: "API Format";
+            readonly apiFormatHint: "Select the API protocol format for this provider";
+            readonly apiFormatOpenAI: "OpenAI Chat Completions";
+            readonly apiFormatAnthropic: "Anthropic Messages";
+            readonly model: "Model";
+            readonly modelHint: "Model name (e.g. gpt-4o, claude-opus-4-8)";
+            readonly apiKey: "API Key";
+            readonly apiKeyHint: "Your API key (stored locally in browser)";
+            readonly temperature: "Temperature";
+            readonly maxSteps: "Max Steps";
+            readonly maxStepsHint: "Maximum agent loop iterations (5-200)";
+            readonly save: "Save";
+            readonly cancel: "Cancel";
+            readonly saved: "Settings saved. Restart agent for changes to take effect.";
+            readonly activeProvider: "Active Provider";
+            readonly enableProvider: "Enable";
+            readonly selectedProvider: "Enabled";
+            readonly providerName: "Provider Name";
+            readonly providerNameHint: "Display name (e.g. OpenAI, Anthropic)";
+            readonly models: "Models";
+            readonly addModel: "+ Add Model";
+            readonly addProvider: "+ Add Provider";
+            readonly currentModel: "Current";
+            readonly modelNameHint: "Model ID (e.g. gpt-4o)";
+            readonly useThisModel: "Use This";
+            readonly enabled: "Enabled";
+            readonly noProviders: "No providers configured. Add one to get started.";
+            readonly deleteProvider: "Delete Provider";
+            readonly enabledProviderLocked: "Enabled provider cannot be deleted";
+            readonly deleteModel: "Delete";
+            readonly confirmDeleteProvider: "Delete this provider and all its models?";
+        };
+        readonly modelSwitcher: {
+            readonly configureProviders: "Configure Providers...";
+            readonly noModels: "No models configured";
+            readonly searchPlaceholder: "Search models...";
+        };
+        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 askingUser: "Asking user...";
+            readonly done: "Task done";
+            readonly executing: "Executing {{toolName}}...";
+        };
+        readonly skills: {
+            readonly tab: "Skills";
+            readonly create: "Create Skill";
+            readonly edit: "Edit Skill";
+            readonly importJSON: "Import Skill";
+            readonly exportJSON: "Export JSON";
+            readonly delete: "Delete";
+            readonly confirmDelete: "Are you sure you want to delete this skill?";
+            readonly empty: "No skills configured. Create one or import from JSON.";
+            readonly builtIn: "Built-in Skills";
+            readonly pasteJSON: "Paste skill JSON here:";
+            readonly loadError: "Failed to load skills.";
+            readonly fieldId: "Skill ID";
+            readonly fieldName: "Name";
+            readonly fieldVersion: "Version";
+            readonly fieldDescription: "Description";
+            readonly fieldPromptFragment: "System Prompt Fragment";
+            readonly fieldPromptPlaceholder: "Tell the LLM when and how to use this skill's tools...";
+            readonly fieldTools: "Tools (JSON array)";
+            readonly fieldToolsHint: "Define tools as JSON. executeCode should be the source code of an async function.";
+            readonly fieldRequired: "ID and Name are required";
+            readonly saveFailed: "Failed to save skill: ";
+            readonly importFailed: "Failed to import skill: ";
+            readonly importAsText: "Create skill from pasted text";
+            readonly importHint: "Paste JSON for a full skill definition, or paste markdown/text to auto-create a knowledge skill.";
+        };
+    };
+};
+
+/** Generate a short unique id for a conversation. */
+export declare function generateConversationId(): string;
+
+/** Generate a short unique id for a custom skill. */
+export declare function generateSkillId(): string;
+
+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 taskInput: "Enter new task, describe steps in detail, press Ctrl/Cmd+Enter to submit";
+                readonly taskInputWindows: "Enter new task, describe steps in detail, press Enter to submit, Shift+Enter for new line";
+                readonly userAnswerPrompt: "Please answer the question above, press Ctrl/Cmd+Enter to submit";
+                readonly userAnswerPromptWindows: "Please answer the question above, press Enter to submit, Shift+Enter for new line";
+                readonly waitingPlaceholder: "Waiting for task to start...";
+                readonly stop: "Stop";
+                readonly close: "Close";
+                readonly expand: "Expand history";
+                readonly history: "History";
+                readonly step: "Step {{number}}";
+                readonly newConversation: "New Conversation";
+                readonly conversations: "Conversations";
+                readonly noConversations: "No conversations";
+                readonly conversationDefaultTitle: "New Conversation";
+                readonly deleteConversation: "Delete conversation";
+                readonly timeJustNow: "Just now";
+                readonly timeMinutesAgo: "{{n}}m ago";
+                readonly timeHoursAgo: "{{n}}h ago";
+                readonly timeDaysAgo: "{{n}}d ago";
+            };
+            readonly settings: {
+                readonly title: "Settings";
+                readonly modelTab: "Model Config";
+                readonly providersTab: "Providers";
+                readonly generalTab: "General";
+                readonly baseURL: "Base URL";
+                readonly baseURLHint: "API endpoint (without /chat/completions or /messages)";
+                readonly apiFormat: "API Format";
+                readonly apiFormatHint: "Select the API protocol format for this provider";
+                readonly apiFormatOpenAI: "OpenAI Chat Completions";
+                readonly apiFormatAnthropic: "Anthropic Messages";
+                readonly model: "Model";
+                readonly modelHint: "Model name (e.g. gpt-4o, claude-opus-4-8)";
+                readonly apiKey: "API Key";
+                readonly apiKeyHint: "Your API key (stored locally in browser)";
+                readonly temperature: "Temperature";
+                readonly maxSteps: "Max Steps";
+                readonly maxStepsHint: "Maximum agent loop iterations (5-200)";
+                readonly save: "Save";
+                readonly cancel: "Cancel";
+                readonly saved: "Settings saved. Restart agent for changes to take effect.";
+                readonly activeProvider: "Active Provider";
+                readonly enableProvider: "Enable";
+                readonly selectedProvider: "Enabled";
+                readonly providerName: "Provider Name";
+                readonly providerNameHint: "Display name (e.g. OpenAI, Anthropic)";
+                readonly models: "Models";
+                readonly addModel: "+ Add Model";
+                readonly addProvider: "+ Add Provider";
+                readonly currentModel: "Current";
+                readonly modelNameHint: "Model ID (e.g. gpt-4o)";
+                readonly useThisModel: "Use This";
+                readonly enabled: "Enabled";
+                readonly noProviders: "No providers configured. Add one to get started.";
+                readonly deleteProvider: "Delete Provider";
+                readonly enabledProviderLocked: "Enabled provider cannot be deleted";
+                readonly deleteModel: "Delete";
+                readonly confirmDeleteProvider: "Delete this provider and all its models?";
+            };
+            readonly modelSwitcher: {
+                readonly configureProviders: "Configure Providers...";
+                readonly noModels: "No models configured";
+                readonly searchPlaceholder: "Search models...";
+            };
+            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 askingUser: "Asking user...";
+                readonly done: "Task done";
+                readonly executing: "Executing {{toolName}}...";
+            };
+            readonly skills: {
+                readonly tab: "Skills";
+                readonly create: "Create Skill";
+                readonly edit: "Edit Skill";
+                readonly importJSON: "Import Skill";
+                readonly exportJSON: "Export JSON";
+                readonly delete: "Delete";
+                readonly confirmDelete: "Are you sure you want to delete this skill?";
+                readonly empty: "No skills configured. Create one or import from JSON.";
+                readonly builtIn: "Built-in Skills";
+                readonly pasteJSON: "Paste skill JSON here:";
+                readonly loadError: "Failed to load skills.";
+                readonly fieldId: "Skill ID";
+                readonly fieldName: "Name";
+                readonly fieldVersion: "Version";
+                readonly fieldDescription: "Description";
+                readonly fieldPromptFragment: "System Prompt Fragment";
+                readonly fieldPromptPlaceholder: "Tell the LLM when and how to use this skill's tools...";
+                readonly fieldTools: "Tools (JSON array)";
+                readonly fieldToolsHint: "Define tools as JSON. executeCode should be the source code of an async function.";
+                readonly fieldRequired: "ID and Name are required";
+                readonly saveFailed: "Failed to save skill: ";
+                readonly importFailed: "Failed to import skill: ";
+                readonly importAsText: "Create skill from pasted text";
+                readonly importHint: "Paste JSON for a full skill definition, or paste markdown/text to auto-create a knowledge skill.";
+            };
+        };
+    };
+    readonly 'zh-CN': {
+        readonly ui: {
+            readonly panel: {
+                readonly ready: "准备就绪";
+                readonly thinking: "正在思考...";
+                readonly taskInput: "输入新任务，详细描述步骤，按 Ctrl/Cmd+Enter 提交";
+                readonly taskInputWindows: "输入新任务，详细描述步骤，按 Enter 提交，Shift+Enter 换行";
+                readonly userAnswerPrompt: "请回答上面问题，按 Ctrl/Cmd+Enter 提交";
+                readonly userAnswerPromptWindows: "请回答上面问题，按 Enter 提交，Shift+Enter 换行";
+                readonly waitingPlaceholder: "等待任务开始...";
+                readonly stop: "终止";
+                readonly close: "关闭";
+                readonly expand: "展开历史";
+                readonly history: "历史记录";
+                readonly step: "步骤 {{number}}";
+                readonly newConversation: "新建会话";
+                readonly conversations: "会话列表";
+                readonly noConversations: "暂无会话";
+                readonly conversationDefaultTitle: "新的会话";
+                readonly deleteConversation: "删除会话";
+                readonly timeJustNow: "刚刚";
+                readonly timeMinutesAgo: "{{n}}分钟前";
+                readonly timeHoursAgo: "{{n}}小时前";
+                readonly timeDaysAgo: "{{n}}天前";
+            };
+            readonly settings: {
+                readonly title: "设置";
+                readonly modelTab: "模型配置";
+                readonly providersTab: "供应商";
+                readonly generalTab: "通用";
+                readonly baseURL: "API 地址";
+                readonly baseURLHint: "API 端点 (不包含 /chat/completions 或 /messages)";
+                readonly apiFormat: "API 格式";
+                readonly apiFormatHint: "选择此供应商使用的 API 协议格式";
+                readonly apiFormatOpenAI: "OpenAI Chat Completions";
+                readonly apiFormatAnthropic: "Anthropic Messages";
+                readonly model: "模型";
+                readonly modelHint: "模型名称 (例如 gpt-4o, claude-opus-4-8)";
+                readonly apiKey: "API 密钥";
+                readonly apiKeyHint: "密钥仅存储在浏览器本地";
+                readonly temperature: "温度参数";
+                readonly maxSteps: "最大步数";
+                readonly maxStepsHint: "Agent 循环最大迭代次数 (5-200)";
+                readonly save: "保存";
+                readonly cancel: "取消";
+                readonly saved: "设置已保存。重新启动 Agent 后生效。";
+                readonly activeProvider: "当前供应商";
+                readonly enableProvider: "启用";
+                readonly selectedProvider: "已启用";
+                readonly providerName: "供应商名称";
+                readonly providerNameHint: "显示名称 (例如 OpenAI, Anthropic)";
+                readonly models: "模型列表";
+                readonly addModel: "+ 添加模型";
+                readonly addProvider: "+ 添加供应商";
+                readonly currentModel: "当前使用";
+                readonly modelNameHint: "模型标识 (例如 gpt-4o)";
+                readonly useThisModel: "设为当前";
+                readonly enabled: "已启用";
+                readonly noProviders: "尚未配置供应商，请添加一个开始使用。";
+                readonly deleteProvider: "删除供应商";
+                readonly enabledProviderLocked: "已启用的供应商无法删除";
+                readonly deleteModel: "删除";
+                readonly confirmDeleteProvider: "确认删除此供应商及其所有模型？";
+            };
+            readonly modelSwitcher: {
+                readonly configureProviders: "配置供应商...";
+                readonly noModels: "未配置模型";
+                readonly searchPlaceholder: "搜索模型...";
+            };
+            readonly tools: {
+                readonly clicking: "正在点击元素 [{{index}}]...";
+                readonly inputting: "正在输入文本到元素 [{{index}}]...";
+                readonly selecting: "正在选择选项 \"{{text}}\"...";
+                readonly scrolling: "正在滚动页面...";
+                readonly waiting: "等待 {{seconds}} 秒...";
+                readonly askingUser: "正在询问用户...";
+                readonly done: "结束任务";
+                readonly executing: "正在执行 {{toolName}}...";
+            };
+            readonly skills: {
+                readonly tab: "技能";
+                readonly create: "创建技能";
+                readonly edit: "编辑技能";
+                readonly importJSON: "导入技能";
+                readonly exportJSON: "导出 JSON";
+                readonly delete: "删除";
+                readonly confirmDelete: "确认删除此技能？";
+                readonly empty: "尚未配置技能。请创建或从 JSON 导入。";
+                readonly builtIn: "内置技能";
+                readonly pasteJSON: "请粘贴 Skill JSON：";
+                readonly loadError: "技能加载失败。";
+                readonly fieldId: "技能 ID";
+                readonly fieldName: "名称";
+                readonly fieldVersion: "版本";
+                readonly fieldDescription: "描述";
+                readonly fieldPromptFragment: "System Prompt 片段";
+                readonly fieldPromptPlaceholder: "告诉 LLM 何时以及如何使用此技能的工具...";
+                readonly fieldTools: "工具（JSON 数组）";
+                readonly fieldToolsHint: "以 JSON 定义工具。executeCode 应为 async 函数的源代码。";
+                readonly fieldRequired: "ID 和名称为必填项";
+                readonly saveFailed: "保存技能失败：";
+                readonly importFailed: "导入技能失败：";
+                readonly importAsText: "将粘贴的文本创建为技能";
+                readonly importHint: "粘贴 JSON 可导入完整技能定义，粘贴 Markdown/文本可自动创建知识型技能。";
+            };
+        };
+    };
+};
+
+/**
+ * Per-model configuration within a provider.
+ */
+export declare interface ModelConfig {
+    /** Model identifier (e.g. "gpt-4o", "claude-opus-4-8") */
+    name: string;
+    /** Per-model temperature override. Falls back to global default if unset. */
+    temperature?: number;
+}
+
+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)];
+
+/**
+ * Complete settings stored in localStorage.
+ */
+export declare interface PageAgentSettings {
+    /** All configured providers */
+    providers: ProviderConfig[];
+    /** ID of the currently active provider */
+    activeProviderId: string;
+    /** Name of the currently active model (within the active provider) */
+    activeModelName: string;
+    /** Global maximum agent loop iterations */
+    maxSteps: number;
+    /** Global default temperature (overridable per-model) */
+    temperature: number;
+}
+
+/**
+ * Agent control panel
+ *
+ * Architecture:
+ * - History list: renders directly from agent.history (historical events)
+ * - Header bar: shows activity events (transient state) and agent status
+ * - Draggable: header acts as drag handle, position saved to localStorage
+ * - Resizable: top-edge resize handle
+ *
+ * This separation ensures data consistency - history is the single source of truth
+ * for what has been done, while activity shows what is happening now.
+ */
+export declare class Panel {
+    #private;
+    get wrapper(): HTMLElement;
+    /**
+     * Create a Panel bound to an agent
+     * @param agent - Agent instance that implements PanelAgentAdapter
+     * @param config - Optional panel configuration
+     */
+    constructor(agent: PanelAgentAdapter, config?: PanelConfig);
+    show(): void;
+    hide(): void;
+    reset(): void;
+    expand(): void;
+    collapse(): void;
+    /**
+     * Dispose panel and clean up event listeners
+     */
+    dispose(): void;
+    /**
+     * Get the active LLM config derived from the currently selected provider + model.
+     * Returns null if no active provider/model is configured.
+     */
+    getActiveLLMConfig(): ActiveLLMConfig | null;
+    /**
+     * Get current settings from storage (public, for use by PageAgent during initialization).
+     */
+    getSettings(): Record<string, string>;
+}
+
+/**
+ * Minimal interface that Panel expects from an agent.
+ * Panel does not depend on PageAgent directly - it only requires this interface.
+ * This enables decoupling and allows any agent implementation to work with Panel.
+ *
+ * Events:
+ * - 'statuschange': Agent status changed
+ * - 'historychange': Historical events updated (persisted)
+ * - 'activity': Transient activity for immediate UI feedback (thinking/executing/etc)
+ * - 'dispose': Agent is being disposed
+ */
+declare interface PanelAgentAdapter extends EventTarget {
+    /** Current agent status */
+    readonly status: 'idle' | 'running' | 'completed' | 'error' | 'stopped';
+    /** Result of the most recent run, or `null` before the first run completes */
+    readonly lastResult: {
+        success: boolean;
+    } | null;
+    /** History of agent events */
+    readonly history: readonly {
+        type: 'step' | 'observation' | 'user_takeover' | 'retry' | 'error';
+        stepIndex?: number;
+        /** For 'step' type */
+        reflection?: {
+            evaluation_previous_goal?: string;
+            memory?: string;
+            next_goal?: string;
+        };
+        /** For 'step' type */
+        action?: {
+            name: string;
+            input: unknown;
+            output: string;
+        };
+        /** For 'observation' type */
+        content?: string;
+        /** For 'retry' type */
+        attempt?: number;
+        maxAttempts?: number;
+        /** For 'retry' and 'error' types */
+        message?: string;
+    }[];
+    /** Current task being executed */
+    readonly task: string;
+    /**
+     * Called when the agent needs to ask the user questions.
+     * If unset, the `ask_user` tool will be disabled.
+     * Panel will set this to handle user questions via its UI.
+     * The optional `signal` aborts when the task is stopped or disposed.
+     */
+    onAskUser?: (question: string, options?: {
+        signal: AbortSignal;
+    }) => Promise<string>;
+    /** Execute a task */
+    execute(task: string): Promise<unknown>;
+    /** Stop the current task (agent remains reusable) */
+    stop(): Promise<void>;
+    /** Dispose the agent (terminal, cannot be reused) */
+    dispose(): void;
+    /**
+     * Get the current page's simplified HTML content for DOM preview.
+     * Returns null/undefined when DOM preview is not supported.
+     * Called on-demand when the user opens the DOM preview panel.
+     */
+    getSimplifiedHTML?(): string | null | undefined;
+    /**
+     * Snapshot the current agent state for conversation persistence.
+     * Returns a serializable state object, or null if no meaningful state exists.
+     */
+    getConversationState?(): {
+        task: string;
+        history: readonly unknown[];
+        lastResult: {
+            success: boolean;
+            data: string;
+        } | null;
+        status: 'idle' | 'running' | 'completed' | 'error' | 'stopped';
+    } | null;
+    /**
+     * Restore agent state from a previously saved conversation snapshot.
+     * Emits historychange and statuschange so the UI re-renders.
+     */
+    restoreConversationState?(state: {
+        task: string;
+        history: readonly unknown[];
+        lastResult: {
+            success: boolean;
+            data: string;
+        } | null;
+        status: 'idle' | 'running' | 'completed' | 'error' | 'stopped';
+    }): void;
+    /**
+     * Reset the agent to a fresh state for a new conversation.
+     * Emits events so the UI clears history and shows the input area.
+     */
+    newConversation?(): void;
+    /** Get metadata for all registered skills */
+    getAvailableSkills?(): {
+        id: string;
+        name: string;
+        description: string;
+        version: string;
+        author?: string;
+        icon?: string;
+        active: boolean;
+        hasConfig: boolean;
+        configSchema?: object;
+        source: string;
+    }[];
+    /** Get IDs of currently active skills */
+    getActiveSkillIds?(): string[];
+    /** Load (activate) a skill by id or full skill object */
+    loadSkill?(skillOrId: unknown): Promise<void>;
+    /** Unload (deactivate) a skill by id */
+    unloadSkill?(skillId: string): Promise<void>;
+    /** Get current config for a skill */
+    getSkillConfig?(skillId: string): Record<string, unknown>;
+    /** Update config for a skill */
+    updateSkillConfig?(skillId: string, config: Record<string, unknown>): Promise<void>;
+    /** Subscribe to skill change events */
+    onSkillChange?(callback: () => void): void;
+}
+
+/**
+ * Panel configuration
+ */
+export declare interface PanelConfig {
+    language?: SupportedLanguage;
+    /**
+     * Whether to prompt for next task after task completion
+     * @default true
+     */
+    promptForNextTask?: boolean;
+    /** Default model config values from agent initialization (used as form defaults) */
+    defaults?: {
+        baseURL?: string;
+        model?: string;
+        apiKey?: string;
+        temperature?: number;
+        maxSteps?: number;
+    };
+}
+
+/**
+ * A configured LLM provider with its models.
+ */
+export declare interface ProviderConfig {
+    /** Unique identifier */
+    id: string;
+    /** Display name (e.g. "OpenAI", "Anthropic") */
+    name: string;
+    /** API endpoint (base URL, without the endpoint path) */
+    baseURL: string;
+    /** API protocol format */
+    apiFormat: ApiFormat;
+    /** API key (stored locally in browser) */
+    apiKey?: string;
+    /** Models configured under this provider */
+    models: ModelConfig[];
+    /** Whether this provider is active and visible in the quick-switch dropdown */
+    enabled: boolean;
+}
+
+/**
+ * Resolve the currently active provider and model from settings.
+ *
+ * Resolution order:
+ * 1. Find provider by activeProviderId (must be enabled)
+ * 2. Fall back to first enabled provider
+ * 3. Find model by activeModelName within the resolved provider
+ * 4. Fall back to first model in that provider
+ *
+ * Returns null if no enabled provider with models is configured.
+ */
+export declare function resolveActiveModel(settings: PageAgentSettings): ResolvedActiveModel | null;
+
+/**
+ * Result of resolving the active provider + model from settings.
+ */
+export declare interface ResolvedActiveModel {
+    provider: ProviderConfig;
+    model: ModelConfig;
+}
+
+/**
+ * Static helper for persisting and retrieving Skills via IndexedDB.
+ * Mirrors ConversationStorage from conversations.ts.
+ *
+ * Usage:
+ *   await SkillStorage.save(skill)
+ *   const all = await SkillStorage.list()
+ *   const enabled = await SkillStorage.listEnabled()
+ */
+export declare const SkillStorage: {
+    /** List all skills ordered by updatedAt descending (newest first). */
+    list(): Promise<StoredSkill[]>;
+    /** List all enabled skills. */
+    listEnabled(): Promise<StoredSkill[]>;
+    /** Get a single skill by id. */
+    get(id: string): Promise<StoredSkill | undefined>;
+    /** Insert or update a skill. */
+    save(skill: StoredSkill): Promise<void>;
+    /** Batch save multiple skills. */
+    saveAll(skills: StoredSkill[]): Promise<void>;
+    /** Delete a skill by id. */
+    delete(id: string): Promise<void>;
+    /** Toggle the enabled state of a skill. */
+    toggleEnabled(id: string, enabled: boolean): Promise<void>;
+    /** Update config for a skill. */
+    updateConfig(id: string, config: Record<string, unknown>): Promise<void>;
+    /** Clear all skills. */
+    clear(): Promise<void>;
+    /** Export a skill as JSON string. */
+    exportJSON(id: string): Promise<string | null>;
+    /** Import a skill from JSON string. */
+    importJSON(json: string): Promise<StoredSkill>;
+    /** Get the total count of stored skills. */
+    count(): Promise<number>;
+};
+
+/**
+ * Serializable skill definition stored in IndexedDB.
+ */
+export declare interface StoredSkill {
+    id: string;
+    name: string;
+    description: string;
+    version: string;
+    icon?: string;
+    author?: string;
+    systemPromptFragment?: string;
+    tools?: StoredTool[];
+    config?: Record<string, unknown>;
+    enabled: boolean;
+    createdAt: number;
+    updatedAt: number;
+}
+
+/**
+ * Serializable tool definition stored in IndexedDB.
+ * Mirrors PageAgentTool but with serializable fields only.
+ */
+export declare interface StoredTool {
+    name: string;
+    description: string;
+    inputSchema: Record<string, unknown>;
+    executeCode: string;
+}
+
+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 { }