@hao-gd/page-agent-ui 1.10.7 → 1.11.0

package/dist/lib/index.d.ts

@@ -1,3 +1,31 @@
+/** Outcome of a gate request. */
+export declare type ActionGateDecision = 'allow' | 'block' | 'deny';
+
+/** Action descriptor handed to the Panel by the runtime gate. */
+export declare interface ActionGateInfo {
+    tool: string;
+    input: unknown;
+    step: number;
+    risk: ActionRisk;
+    /** 0..1 locator confidence; low values escalate the gate. */
+    confidence?: number;
+    /** Human readable target (element label, selector, ...). */
+    target?: string;
+    /** The model's stated reasoning for this action (the "why"). */
+    reflection?: {
+        evaluation_previous_goal?: string;
+        memory?: string;
+        next_goal?: string;
+    };
+}
+
+/** Resolved risk metadata for an action awaiting approval. */
+export declare interface ActionRisk {
+    level: RiskLevel;
+    isSideEffectFree: boolean;
+    reason?: string;
+}
+
 /**
  * Derived active LLM configuration from the currently selected provider + model.
  */
@@ -141,9 +169,80 @@ declare const enUS: {
             readonly waitingPlaceholder: "Waiting for task to start...";
             readonly stop: "Stop";
             readonly close: "Close";
+            readonly send: "Send";
             readonly expand: "Expand history";
             readonly history: "History";
             readonly step: "Step {{number}}";
+            readonly you: "You";
+            readonly agent: "Page Agent";
+            readonly tokens: "tokens";
+            readonly thinkingPhase: "Thinking";
+            readonly sameAsPrevious: "Same as previous step";
+            readonly thinkingSameAsPrevious: "Thinking unchanged from the previous step";
+            readonly repeatedStep: "Repeat";
+            readonly copy: "Copy";
+            readonly copied: "Copied";
+            readonly expandStep: "Expand step";
+            readonly collapseStep: "Collapse step";
+            readonly activityIdle: "Waiting for you";
+            readonly interactionMode: "Interaction mode";
+            readonly autopilot: "Autopilot";
+            readonly collaborative: "Step-by-step";
+            readonly autopilotHint: "Runs everything automatically, blocking only irreversible actions";
+            readonly collaborativeHint: "Pauses before each step for your approval";
+            readonly copilot: "Co-pilot";
+            readonly copilotHint: "Reads and draft edits run freely, committed changes ask first";
+            readonly stepMode: "Step-by-step";
+            readonly stepModeHint: "Pauses before every action with its tool, target and rationale";
+            readonly approvalTitle: "Your approval is needed";
+            readonly waitingApproval: "Waiting for approval";
+            readonly approvalBody: "The agent is ready for the next step. Review it, then continue or switch to autopilot.";
+            readonly approvalContinue: "Continue";
+            readonly approvalBlock: "Reject this action";
+            readonly approvalAuto: "Run automatically";
+            readonly approvalStop: "Stop task";
+            readonly approvalStep: "Step {{number}}";
+            readonly gateTitle: "Confirm this action";
+            readonly gateBody: "This action changes state outside the agent. Review the details below.";
+            readonly gateTarget: "Element #{{index}}";
+            readonly gateValue: "Value";
+            readonly gateWhy: "Why";
+            readonly gateOutcome: "Last step";
+            readonly approvalBatch: "Always allow {{action}}";
+            readonly approvalShortcut: "Enter allows · Esc rejects this action";
+            readonly actionRejected: "Action rejected — the agent is re-planning";
+            readonly risk: {
+                readonly L0: "Read-only";
+                readonly L1: "Reversible";
+                readonly L2: "Committed change";
+                readonly L3: "Irreversible";
+            };
+            readonly riskHint: {
+                readonly destructive: "This can delete, pay or otherwise do something that cannot be undone.";
+                readonly commit: "This changes data outside the agent.";
+                readonly lowConfidence: "The target element is ambiguous, so confirmation is required.";
+                readonly generic: "This action changes state and needs your confirmation.";
+                readonly stepMode: "Step-by-step mode pauses on every action so you can verify them one by one.";
+                readonly done: "This finishes the task and returns the result above.";
+            };
+            readonly undo: "Undo";
+            readonly undoHint: "Filled automatically — you can undo this";
+            readonly resumeTitle: "Task interrupted";
+            readonly resumeHint: "Continue from where it stopped — the previous steps are kept";
+            readonly resumeAction: "Resume";
+            readonly taskAborted: "Task stopped";
+            readonly tool: {
+                readonly click_element_by_index: "Click element";
+                readonly input_text: "Type into field";
+                readonly select_dropdown_option: "Select option";
+                readonly execute_javascript: "Run JavaScript";
+                readonly scroll: "Scroll page";
+                readonly read_page_content: "Read page";
+                readonly save_data: "Save data";
+                readonly wait: "Wait";
+                readonly done: "Finish task";
+                readonly ask_user: "Ask you a question";
+            };
             readonly newConversation: "New Conversation";
             readonly conversations: "Conversations";
             readonly noConversations: "No conversations";
@@ -156,6 +255,15 @@ declare const enUS: {
         };
         readonly settings: {
             readonly title: "Settings";
+            readonly subtitle: "Models, agent behaviour and skills";
+            readonly navProviders: "Models";
+            readonly navAgent: "Agent";
+            readonly navSkills: "Skills";
+            readonly navSafety: "Approval";
+            readonly autoSave: "Changes are saved automatically";
+            readonly done: "Done";
+            readonly quickStart: "Quick start";
+            readonly quickStartHint: "Pick a provider preset, then paste your API key.";
             readonly modelTab: "Model Config";
             readonly providersTab: "Providers";
             readonly generalTab: "General";
@@ -172,6 +280,16 @@ declare const enUS: {
             readonly temperature: "Temperature";
             readonly maxSteps: "Max Steps";
             readonly maxStepsHint: "Maximum agent loop iterations (5-200)";
+            readonly safetyPolicy: "Authorization policy";
+            readonly safetyPolicyHint: "Choose how far the agent may go without asking you first.";
+            readonly safetyRemember: "Remember per-action approval";
+            readonly safetyRememberHint: "Adds an \"always allow this action type\" button to confirmation cards. Scoped to the current task.";
+            readonly safetyMatrix: "Risk tiers";
+            readonly riskL0Desc: "Page reads, DOM queries and waiting — never asked.";
+            readonly riskL1Desc: "Field fills and dropdown picks — automatic, with undo.";
+            readonly riskL2Desc: "Submits, saves and script execution — asked in Co-pilot mode.";
+            readonly riskL3Desc: "Deletes, payments and other irreversible actions — always asked.";
+            readonly safetyNote: "Low-confidence element matches are escalated to a confirmation even for low-risk actions.";
             readonly save: "Save";
             readonly cancel: "Cancel";
             readonly saved: "Settings saved. Restart agent for changes to take effect.";
@@ -181,6 +299,7 @@ declare const enUS: {
             readonly providerName: "Provider Name";
             readonly providerNameHint: "Display name (e.g. OpenAI, Anthropic)";
             readonly models: "Models";
+            readonly modelsCount: "{{n}} models";
             readonly addModel: "+ Add Model";
             readonly addProvider: "+ Add Provider";
             readonly currentModel: "Current";
@@ -204,6 +323,9 @@ declare const enUS: {
             readonly selecting: "Selecting option \"{{text}}\"...";
             readonly scrolling: "Scrolling page...";
             readonly waiting: "Waiting {{seconds}} seconds...";
+            readonly element: "Element";
+            readonly scrollPage: "Whole page";
+            readonly readWholePage: "Full page text";
             readonly askingUser: "Asking user...";
             readonly done: "Task done";
             readonly executing: "Executing {{toolName}}...";
@@ -253,6 +375,14 @@ export declare class I18n {
     getLanguage(): SupportedLanguage;
 }
 
+/**
+ * How the agent advances between steps.
+ * - `autopilot`: runs autonomously; only L3 (irreversible) actions block.
+ * - `copilot`: L2+ actions block, reads and draft edits flow through.
+ * - `step`: debug mode — every step pauses for confirmation.
+ */
+export declare type InteractionMode = 'autopilot' | 'copilot' | 'step';
+
 declare const locales: {
     readonly 'en-US': {
         readonly ui: {
@@ -266,9 +396,80 @@ declare const locales: {
                 readonly waitingPlaceholder: "Waiting for task to start...";
                 readonly stop: "Stop";
                 readonly close: "Close";
+                readonly send: "Send";
                 readonly expand: "Expand history";
                 readonly history: "History";
                 readonly step: "Step {{number}}";
+                readonly you: "You";
+                readonly agent: "Page Agent";
+                readonly tokens: "tokens";
+                readonly thinkingPhase: "Thinking";
+                readonly sameAsPrevious: "Same as previous step";
+                readonly thinkingSameAsPrevious: "Thinking unchanged from the previous step";
+                readonly repeatedStep: "Repeat";
+                readonly copy: "Copy";
+                readonly copied: "Copied";
+                readonly expandStep: "Expand step";
+                readonly collapseStep: "Collapse step";
+                readonly activityIdle: "Waiting for you";
+                readonly interactionMode: "Interaction mode";
+                readonly autopilot: "Autopilot";
+                readonly collaborative: "Step-by-step";
+                readonly autopilotHint: "Runs everything automatically, blocking only irreversible actions";
+                readonly collaborativeHint: "Pauses before each step for your approval";
+                readonly copilot: "Co-pilot";
+                readonly copilotHint: "Reads and draft edits run freely, committed changes ask first";
+                readonly stepMode: "Step-by-step";
+                readonly stepModeHint: "Pauses before every action with its tool, target and rationale";
+                readonly approvalTitle: "Your approval is needed";
+                readonly waitingApproval: "Waiting for approval";
+                readonly approvalBody: "The agent is ready for the next step. Review it, then continue or switch to autopilot.";
+                readonly approvalContinue: "Continue";
+                readonly approvalBlock: "Reject this action";
+                readonly approvalAuto: "Run automatically";
+                readonly approvalStop: "Stop task";
+                readonly approvalStep: "Step {{number}}";
+                readonly gateTitle: "Confirm this action";
+                readonly gateBody: "This action changes state outside the agent. Review the details below.";
+                readonly gateTarget: "Element #{{index}}";
+                readonly gateValue: "Value";
+                readonly gateWhy: "Why";
+                readonly gateOutcome: "Last step";
+                readonly approvalBatch: "Always allow {{action}}";
+                readonly approvalShortcut: "Enter allows · Esc rejects this action";
+                readonly actionRejected: "Action rejected — the agent is re-planning";
+                readonly risk: {
+                    readonly L0: "Read-only";
+                    readonly L1: "Reversible";
+                    readonly L2: "Committed change";
+                    readonly L3: "Irreversible";
+                };
+                readonly riskHint: {
+                    readonly destructive: "This can delete, pay or otherwise do something that cannot be undone.";
+                    readonly commit: "This changes data outside the agent.";
+                    readonly lowConfidence: "The target element is ambiguous, so confirmation is required.";
+                    readonly generic: "This action changes state and needs your confirmation.";
+                    readonly stepMode: "Step-by-step mode pauses on every action so you can verify them one by one.";
+                    readonly done: "This finishes the task and returns the result above.";
+                };
+                readonly undo: "Undo";
+                readonly undoHint: "Filled automatically — you can undo this";
+                readonly resumeTitle: "Task interrupted";
+                readonly resumeHint: "Continue from where it stopped — the previous steps are kept";
+                readonly resumeAction: "Resume";
+                readonly taskAborted: "Task stopped";
+                readonly tool: {
+                    readonly click_element_by_index: "Click element";
+                    readonly input_text: "Type into field";
+                    readonly select_dropdown_option: "Select option";
+                    readonly execute_javascript: "Run JavaScript";
+                    readonly scroll: "Scroll page";
+                    readonly read_page_content: "Read page";
+                    readonly save_data: "Save data";
+                    readonly wait: "Wait";
+                    readonly done: "Finish task";
+                    readonly ask_user: "Ask you a question";
+                };
                 readonly newConversation: "New Conversation";
                 readonly conversations: "Conversations";
                 readonly noConversations: "No conversations";
@@ -281,6 +482,15 @@ declare const locales: {
             };
             readonly settings: {
                 readonly title: "Settings";
+                readonly subtitle: "Models, agent behaviour and skills";
+                readonly navProviders: "Models";
+                readonly navAgent: "Agent";
+                readonly navSkills: "Skills";
+                readonly navSafety: "Approval";
+                readonly autoSave: "Changes are saved automatically";
+                readonly done: "Done";
+                readonly quickStart: "Quick start";
+                readonly quickStartHint: "Pick a provider preset, then paste your API key.";
                 readonly modelTab: "Model Config";
                 readonly providersTab: "Providers";
                 readonly generalTab: "General";
@@ -297,6 +507,16 @@ declare const locales: {
                 readonly temperature: "Temperature";
                 readonly maxSteps: "Max Steps";
                 readonly maxStepsHint: "Maximum agent loop iterations (5-200)";
+                readonly safetyPolicy: "Authorization policy";
+                readonly safetyPolicyHint: "Choose how far the agent may go without asking you first.";
+                readonly safetyRemember: "Remember per-action approval";
+                readonly safetyRememberHint: "Adds an \"always allow this action type\" button to confirmation cards. Scoped to the current task.";
+                readonly safetyMatrix: "Risk tiers";
+                readonly riskL0Desc: "Page reads, DOM queries and waiting — never asked.";
+                readonly riskL1Desc: "Field fills and dropdown picks — automatic, with undo.";
+                readonly riskL2Desc: "Submits, saves and script execution — asked in Co-pilot mode.";
+                readonly riskL3Desc: "Deletes, payments and other irreversible actions — always asked.";
+                readonly safetyNote: "Low-confidence element matches are escalated to a confirmation even for low-risk actions.";
                 readonly save: "Save";
                 readonly cancel: "Cancel";
                 readonly saved: "Settings saved. Restart agent for changes to take effect.";
@@ -306,6 +526,7 @@ declare const locales: {
                 readonly providerName: "Provider Name";
                 readonly providerNameHint: "Display name (e.g. OpenAI, Anthropic)";
                 readonly models: "Models";
+                readonly modelsCount: "{{n}} models";
                 readonly addModel: "+ Add Model";
                 readonly addProvider: "+ Add Provider";
                 readonly currentModel: "Current";
@@ -329,6 +550,9 @@ declare const locales: {
                 readonly selecting: "Selecting option \"{{text}}\"...";
                 readonly scrolling: "Scrolling page...";
                 readonly waiting: "Waiting {{seconds}} seconds...";
+                readonly element: "Element";
+                readonly scrollPage: "Whole page";
+                readonly readWholePage: "Full page text";
                 readonly askingUser: "Asking user...";
                 readonly done: "Task done";
                 readonly executing: "Executing {{toolName}}...";
@@ -373,9 +597,80 @@ declare const locales: {
                 readonly waitingPlaceholder: "等待任务开始...";
                 readonly stop: "终止";
                 readonly close: "关闭";
+                readonly send: "发送";
                 readonly expand: "展开历史";
                 readonly history: "历史记录";
                 readonly step: "步骤 {{number}}";
+                readonly you: "你";
+                readonly agent: "Page Agent";
+                readonly tokens: "字元";
+                readonly thinkingPhase: "思考";
+                readonly sameAsPrevious: "与上一步相同";
+                readonly thinkingSameAsPrevious: "思考内容与上一步相同";
+                readonly repeatedStep: "重复";
+                readonly copy: "复制";
+                readonly copied: "已复制";
+                readonly expandStep: "展开步骤";
+                readonly collapseStep: "收起步骤";
+                readonly activityIdle: "等待你的指令";
+                readonly interactionMode: "交互模式";
+                readonly autopilot: "自动驾驶";
+                readonly collaborative: "分步协同";
+                readonly autopilotHint: "全自动执行，仅在不可逆操作前阻断";
+                readonly collaborativeHint: "每一步执行前暂停，等待你确认";
+                readonly copilot: "协同模式";
+                readonly copilotHint: "读取与草稿自动执行，关键变更前向你确认";
+                readonly stepMode: "单步调试";
+                readonly stepModeHint: "每个动作执行前暂停，显示工具、目标与理由";
+                readonly approvalTitle: "等待你的确认";
+                readonly waitingApproval: "等待你的确认";
+                readonly approvalBody: "Agent 已准备好执行下一步。确认后再继续，或切换为自动驾驶。";
+                readonly approvalContinue: "允许执行";
+                readonly approvalBlock: "拒绝这一步";
+                readonly approvalAuto: "转为自动驾驶";
+                readonly approvalStop: "终止任务";
+                readonly approvalStep: "步骤 {{number}}";
+                readonly gateTitle: "请确认这一步操作";
+                readonly gateBody: "该操作会改变外部状态，请先核对下面的细节。";
+                readonly gateTarget: "元素 #{{index}}";
+                readonly gateValue: "内容";
+                readonly gateWhy: "为什么要这样做";
+                readonly gateOutcome: "上一步";
+                readonly approvalBatch: "本任务内始终允许「{{action}}」";
+                readonly approvalShortcut: "Enter 允许 · Esc 拒绝这一步";
+                readonly actionRejected: "已拒绝该动作，Agent 正在换个做法";
+                readonly risk: {
+                    readonly L0: "只读";
+                    readonly L1: "可撤销";
+                    readonly L2: "关键变更";
+                    readonly L3: "不可逆";
+                };
+                readonly riskHint: {
+                    readonly destructive: "该操作可能删除、付款或产生无法撤销的后果。";
+                    readonly commit: "该操作会修改 Agent 之外的数据。";
+                    readonly lowConfidence: "目标元素存在歧义，因此需要你确认。";
+                    readonly generic: "该操作会改变状态，需要你确认。";
+                    readonly stepMode: "单步调试模式：每个动作都会暂停，便于你逐条核对。";
+                    readonly done: "这一步会结束任务，并返回上面的结果。";
+                };
+                readonly undo: "撤销";
+                readonly undoHint: "已自动填入，可撤销";
+                readonly resumeTitle: "任务已中断";
+                readonly resumeHint: "可从中断处继续，保留之前的思考链路";
+                readonly resumeAction: "继续执行";
+                readonly taskAborted: "任务已终止";
+                readonly tool: {
+                    readonly click_element_by_index: "点击元素";
+                    readonly input_text: "填写字段";
+                    readonly select_dropdown_option: "选择选项";
+                    readonly execute_javascript: "执行脚本";
+                    readonly scroll: "滚动页面";
+                    readonly read_page_content: "读取页面";
+                    readonly save_data: "保存数据";
+                    readonly wait: "等待";
+                    readonly done: "结束任务";
+                    readonly ask_user: "向你提问";
+                };
                 readonly newConversation: "新建会话";
                 readonly conversations: "会话列表";
                 readonly noConversations: "暂无会话";
@@ -388,6 +683,15 @@ declare const locales: {
             };
             readonly settings: {
                 readonly title: "设置";
+                readonly subtitle: "模型、Agent 行为与技能";
+                readonly navProviders: "模型";
+                readonly navAgent: "Agent";
+                readonly navSkills: "技能";
+                readonly navSafety: "授权";
+                readonly autoSave: "修改会自动保存";
+                readonly done: "完成";
+                readonly quickStart: "快速开始";
+                readonly quickStartHint: "选择一个供应商预设，然后填入 API 密钥。";
                 readonly modelTab: "模型配置";
                 readonly providersTab: "供应商";
                 readonly generalTab: "通用";
@@ -404,6 +708,16 @@ declare const locales: {
                 readonly temperature: "温度参数";
                 readonly maxSteps: "最大步数";
                 readonly maxStepsHint: "Agent 循环最大迭代次数 (5-200)";
+                readonly safetyPolicy: "授权策略";
+                readonly safetyPolicyHint: "选择 Agent 可以不经确认走多远。";
+                readonly safetyRemember: "记住同类操作的授权";
+                readonly safetyRememberHint: "在确认卡片上提供「本任务内始终允许此类操作」按钮，仅在当前任务生效。";
+                readonly safetyMatrix: "风险分级";
+                readonly riskL0Desc: "读取页面、查询 DOM、等待 —— 不打断你。";
+                readonly riskL1Desc: "填写字段、选择选项 —— 自动执行，可撤销。";
+                readonly riskL2Desc: "提交、保存、执行脚本 —— 协同模式下询问。";
+                readonly riskL3Desc: "删除、支付等不可逆操作 —— 始终询问。";
+                readonly safetyNote: "元素定位置信度较低时，即使是低风险操作也会升级为确认。";
                 readonly save: "保存";
                 readonly cancel: "取消";
                 readonly saved: "设置已保存。重新启动 Agent 后生效。";
@@ -413,6 +727,7 @@ declare const locales: {
                 readonly providerName: "供应商名称";
                 readonly providerNameHint: "显示名称 (例如 OpenAI, Anthropic)";
                 readonly models: "模型列表";
+                readonly modelsCount: "{{n}} 个模型";
                 readonly addModel: "+ 添加模型";
                 readonly addProvider: "+ 添加供应商";
                 readonly currentModel: "当前使用";
@@ -436,6 +751,9 @@ declare const locales: {
                 readonly selecting: "正在选择选项 \"{{text}}\"...";
                 readonly scrolling: "正在滚动页面...";
                 readonly waiting: "等待 {{seconds}} 秒...";
+                readonly element: "元素";
+                readonly scrollPage: "整页滚动";
+                readonly readWholePage: "整页文本";
                 readonly askingUser: "正在询问用户...";
                 readonly done: "结束任务";
                 readonly executing: "正在执行 {{toolName}}...";
@@ -521,6 +839,25 @@ export declare class Panel {
      * @param config - Optional panel configuration
      */
     constructor(agent: PanelAgentAdapter, config?: PanelConfig);
+    getInteractionMode(): InteractionMode;
+    /** Switch authorization policy: autopilot / copilot (balanced) / step. */
+    setInteractionMode(mode: InteractionMode): void;
+    /**
+     * Called by the runtime after the model picked an action.
+     *
+     * Risk-tiered: L0/L1 flow through silently, the policy threshold decides for
+     * L2, and L3 always blocks. Returns `deny` to abort the task.
+     */
+    requestActionApproval(info: ActionGateInfo): Promise<ActionGateDecision>;
+    /**
+     * Legacy pre-planning gate.
+     *
+     * Kept for API compatibility: gating now happens in
+     * {@link requestActionApproval} — i.e. *after* the model has planned — so the
+     * user always sees the concrete tool, target, arguments and the model's
+     * stated goal instead of an empty "next step?" prompt.
+     */
+    waitForStepApproval(_stepIndex: number): Promise<void>;
     show(): void;
     hide(): void;
     reset(): void;
@@ -575,6 +912,14 @@ declare interface PanelAgentAdapter extends EventTarget {
             input: unknown;
             output: string;
         };
+        /** For 'step' type — LLM token usage for this step */
+        usage?: {
+            promptTokens: number;
+            completionTokens: number;
+            totalTokens: number;
+            cachedTokens?: number;
+            reasoningTokens?: number;
+        };
         /** For 'observation' type */
         content?: string;
         /** For 'retry' type */
@@ -594,10 +939,24 @@ declare interface PanelAgentAdapter extends EventTarget {
     onAskUser?: (question: string, options?: {
         signal: AbortSignal;
     }) => Promise<string>;
-    /** Execute a task */
-    execute(task: string): Promise<unknown>;
+    /**
+     * Execute a task.
+     * `resume: true` continues the previous run (keeps history / reasoning chain)
+     * instead of starting a brand-new task.
+     */
+    execute(task: string, options?: {
+        resume?: boolean;
+    }): Promise<unknown>;
     /** Stop the current task (agent remains reusable) */
     stop(): Promise<void>;
+    /**
+     * Revert the most recent reversible action (field fill / option select).
+     * Optional: enables the "Undo" affordance for automatically executed edits.
+     */
+    undoLastAction?(): Promise<{
+        success: boolean;
+        message: string;
+    }>;
     /** Dispose the agent (terminal, cannot be reused) */
     dispose(): void;
     /**
@@ -674,6 +1033,17 @@ export declare interface PanelConfig {
      * @default true
      */
     promptForNextTask?: boolean;
+    /**
+     * Authorization policy for agent actions.
+     * - `autopilot`: autonomous, only L3 blocks (default)
+     * - `copilot`: L2+ blocks, reads and draft edits flow through
+     * - `step`: debug mode, every step pauses
+     * - `collaborative`: deprecated alias for `copilot`
+     * @default 'autopilot'
+     */
+    interactionMode?: InteractionMode | 'collaborative';
+    /** Remember "always allow this action type" choices for the current task. */
+    rememberApprovals?: boolean;
     /** Default model config values from agent initialization (used as form defaults) */
     defaults?: {
         baseURL?: string;
@@ -725,6 +1095,14 @@ export declare interface ResolvedActiveModel {
     model: ModelConfig;
 }
 
+/**
+ * Risk tier of a concrete agent action.
+ *
+ * Mirrors `RiskLevel` from `@hao-gd/page-agent-core` so the Panel stays
+ * decoupled from the core package while still rendering risk-aware gates.
+ */
+export declare type RiskLevel = 'L0' | 'L1' | 'L2' | 'L3';
+
 /**
  * Static helper for persisting and retrieving Skills via IndexedDB.
  * Mirrors ConversationStorage from conversations.ts.