@tanzerfe/page-use 0.0.2

package/dist/index-DtJ3mvL2.d.mts

@@ -0,0 +1,583 @@
+import { AgentStatus, PageAgentConfig } from "page-agent";
+import { LitElement, PropertyValues } from "lit";
+//#region src/core/types.d.ts
+/**
+ * Page Use 对外类型：菜单结构、能力 API、进度事件、任务结果。
+ * 对接方（其它智能体）只需依赖本文件与 capability/ 下的导出。
+ */
+/**
+ * 宿主导航菜单节点：用于生成站点地图写入系统提示，并据此生成「打开 XX」快捷指令。
+ * path 为路由路径（不含 hash 前缀 `#`，前导 `/` 可有可无）；有子节点的分组节点可不填 path。
+ */
+interface PageUseMenuNode {
+  label: string;
+  path?: string;
+  /** 保留路由但不在导航中展示：模型无法点击到达，不列入站点地图 */
+  hidden?: boolean;
+  children?: PageUseMenuNode[];
+}
+/**
+ * 任务来源标识，用于面板展示、历史记录与日志排查。
+ * 约定值：'launcher' 调试面板；其它智能体自行命名（如 'assistant'）。
+ */
+type PageUseTaskSource = string;
+/** 调用失败原因（任务未真正开始执行时） */
+type PageUseErrorCode =
+/** 未调用 createPageUse，或未配置 LLM 端点 baseURL */
+'NOT_CONFIGURED' |
+/** 已配置但宿主已销毁（destroy 之后、例如登出） */
+'NOT_READY' |
+/** 已有任务执行中；同一时刻只允许一个任务操作页面 */
+'BUSY' |
+/** 指令为空 */
+'EMPTY_TASK' |
+/** agent 构造或钩子抛出的外部错误 */
+'AGENT_ERROR';
+/**
+ * 任务最终状态：
+ * - completed：模型调用 done 且声明成功
+ * - failed：模型调用 done 但声明未达成
+ * - stopped：被终止（调用方 abort、stop() 或面板「终止」）
+ * - error：执行出错（模型异常、超出最大步数等）或未能开始（见 errorCode）
+ */
+type PageUseTaskStatus = 'completed' | 'failed' | 'stopped' | 'error';
+interface PageUseStepLog {
+  index: number;
+  /** 工具名，用于图标与颜色区分；另有 'error' / 'retry' 两个伪工具名表示执行出错与重试 */
+  tool: string;
+  /** 模型对上一步的评估 */
+  evaluation: string;
+  /** 模型对下一步的目标描述 */
+  goal: string;
+  /** 工具名 + 关键入参摘要 */
+  action: string;
+  output: string;
+  /** 该步是否失败（工具返回以 ❌ 开头或出现"失败"字样） */
+  failed: boolean;
+}
+interface PageUseTaskResult {
+  /** 本次任务 ID；未能开始时为空串 */
+  taskId: string;
+  task: string;
+  source: PageUseTaskSource;
+  status: PageUseTaskStatus;
+  /** 等价于 status === 'completed' */
+  success: boolean;
+  /** 模型给出的结论，或失败原因 */
+  summary: string;
+  /** 仅在任务未能开始或外部错误时有值 */
+  errorCode?: PageUseErrorCode;
+  steps: PageUseStepLog[];
+  tokens: number;
+  durationMs: number;
+}
+/** 进度事件：run() 的 onProgress 只收到本任务事件；subscribe() 收到全部任务事件 */
+type PageUseProgressEvent = {
+  type: 'started';
+  taskId: string;
+  task: string;
+  source: PageUseTaskSource;
+} | {
+  type: 'activity';
+  taskId: string;
+  text: string;
+} | {
+  type: 'step';
+  taskId: string;
+  step: PageUseStepLog;
+} | {
+  type: 'question';
+  taskId: string;
+  question: string;
+} | {
+  type: 'finished';
+  taskId: string;
+  result: PageUseTaskResult;
+};
+interface PageUseRunOptions {
+  /** 任务来源，默认 'unknown' */
+  source?: PageUseTaskSource;
+  /** 中断信号：abort 后任务以 stopped 结束 */
+  signal?: AbortSignal;
+  onProgress?: (event: PageUseProgressEvent) => void;
+  /**
+   * 模型向用户提问（ask_user 工具）时的回答方式。
+   * 不传时：调试面板已挂载则由面板作答；否则自动回复「无法补充信息」让模型自行决策或结束。
+   */
+  onAskUser?: (question: string) => Promise<string>;
+}
+/** 能力状态快照（非响应式） */
+interface PageUseSnapshot {
+  /** 已配置端点且宿主未销毁，可立即接收任务 */
+  ready: boolean;
+  running: boolean;
+  taskId: string;
+  task: string;
+  source: PageUseTaskSource;
+  activity: string;
+  steps: number;
+}
+/** 快捷指令：label 为按钮文字，task 为下达的完整指令 */
+interface PageUsePreset {
+  label: string;
+  task: string;
+}
+//#endregion
+//#region src/capability/api.d.ts
+interface PageUseCapability {
+  /** 协议版本；不兼容变更时递增，调用方可据此判断 */
+  readonly version: 1;
+  /** 已调用 createPageUse 且配置了端点、未销毁，可立即接收任务 */
+  isReady(): boolean;
+  /** 下达指令并等待结束；不会 reject，失败信息见结果的 status / errorCode */
+  run(task: string, options?: PageUseRunOptions): Promise<PageUseTaskResult>;
+  /** 终止当前任务（无论由谁下达）；当前任务将以 stopped 结束 */
+  stop(): Promise<void>;
+  getSnapshot(): PageUseSnapshot;
+  /** 订阅全部任务的进度事件；返回取消订阅函数 */
+  subscribe(listener: (event: PageUseProgressEvent) => void): () => void;
+}
+declare const pageUseCapability: PageUseCapability;
+//#endregion
+//#region src/core/options.d.ts
+/** 默认模型，仅为示例取值；接入其它端点时应通过 llm.model 显式指定支持 function calling 的模型 */
+declare const DEFAULT_MODEL = "deepseek-chat";
+/** 单次任务最大步数；每步一次 LLM 调用，防止死循环消耗 token */
+declare const DEFAULT_MAX_STEPS = 20;
+/** 默认会话头：OpenCode Go 要求每个会话带稳定的 x-opencode-session 用于路由与提示缓存 */
+declare const DEFAULT_SESSION_HEADER = "x-opencode-session";
+/** localStorage / sessionStorage 键前缀，可通过 storageKeyPrefix 覆盖 */
+declare const DEFAULT_STORAGE_KEY_PREFIX = "tz-page-use";
+interface PageUseLLMOptions {
+  /**
+   * OpenAI 兼容端点（到版本前缀为止，如 https://api.deepseek.com/v1）。
+   * 可传相对路径（如本地代理 /__page-use-llm），会按当前 origin 补为绝对地址。
+   */
+  baseURL: string;
+  /**
+   * 前端直连时的 Key。生产环境建议留空，由网关/代理注入，避免 Key 出现在前端产物中。
+   */
+  apiKey?: string;
+  model?: string;
+  maxSteps?: number;
+  /** 部分模型拒绝对象形式 tool_choice（"Invalid tool_choice type"）时打开 */
+  disableNamedToolChoice?: boolean;
+  /** 额外合并进请求体的字段，例：DeepSeek 关闭思考模式 { thinking: { type: 'disabled' } } */
+  extraBody?: Record<string, unknown>;
+  /**
+   * 会话 ID 请求头名，每个任务生成一个新 ID；false 表示不发送
+   * （直连不需要该头的端点时关闭，避免 CORS 预检拒绝自定义头）。默认 x-opencode-session。
+   */
+  sessionHeader?: string | false;
+}
+/**
+ * 路由模式，决定站点地图中路径的写法与默认的当前路径读取方式：
+ * - hash：页面 URL 形如 `/#/a/b`
+ * - history：页面 URL 形如 `/a/b`
+ */
+type PageUseRouterMode = 'hash' | 'history';
+interface PageUseOptions {
+  llm: PageUseLLMOptions;
+  /** 系统名称，写入系统提示「你正在「xxx」内替用户操作页面」 */
+  appName: string;
+  /** 每次任务开始（及每一步）时读取最新的可见菜单；返回空时站点地图为空 */
+  getMenus?: () => PageUseMenuNode[] | undefined;
+  /** 默认 'hash' */
+  routerMode?: PageUseRouterMode;
+  /** 读取当前路由路径（不含 `#`）；默认按 routerMode 从 location 读取 */
+  getCurrentPath?: () => string;
+  /** 由路径解析路由名，用于匹配 routeHints；不传时 routeHints 仅按路径匹配 */
+  resolveRouteName?: (path: string) => string | undefined;
+  /** 按页操作提示：key 为路由名或路径（不含前导 `/`），value 为提示文本 */
+  routeHints?: Record<string, string>;
+  /** 页面布局描述，替换系统提示中的「页面结构」段落；不传时使用通用描述 */
+  layoutHint?: string;
+  /** 任务开始前的宿主预处理，例如展开折叠的侧栏，使菜单文字对模型可见 */
+  beforeTask?: () => void | Promise<void>;
+  /** 调试面板设置中 beforeTask 开关的显示名，默认「任务开始前执行宿主预处理」 */
+  beforeTaskLabel?: string;
+  /** 存储键前缀，默认 'tz-page-use'；同源多应用共存时用于隔离 */
+  storageKeyPrefix?: string;
+  /** 透传给 page-agent 的配置，覆盖包内默认值（stepDelay、language 等） */
+  pageAgentOptions?: Partial<PageAgentConfig>;
+  /** 是否安装 window.__TZ_PAGE_USE__ 全局桥接，默认 true */
+  exposeGlobal?: boolean;
+}
+interface NormalizedLLMOptions {
+  /** 绝对地址；page-agent 内部 `new URL(baseURL)` 解析，相对路径会抛错 */
+  baseURL: string;
+  apiKey: string;
+  model: string;
+  maxSteps: number;
+  disableNamedToolChoice: boolean;
+  extraBody: Record<string, unknown>;
+  /** 空串表示不发送会话头 */
+  sessionHeader: string;
+}
+interface NormalizedPageUseOptions {
+  llm: NormalizedLLMOptions;
+  appName: string;
+  getMenus: () => PageUseMenuNode[] | undefined;
+  routerMode: PageUseRouterMode;
+  getCurrentPath: () => string;
+  resolveRouteName?: (path: string) => string | undefined;
+  routeHints: Record<string, string>;
+  layoutHint?: string;
+  beforeTask?: () => void | Promise<void>;
+  beforeTaskLabel: string;
+  storageKeyPrefix: string;
+  pageAgentOptions: Partial<PageAgentConfig>;
+  exposeGlobal: boolean;
+}
+declare function normalizeOptions(options: PageUseOptions): NormalizedPageUseOptions;
+/**
+ * 调试面板是否显示。优先级：URL 参数（并记入本会话）> 会话记录 > fallback。
+ * fallback 由宿主决定（例如「开发环境显示，生产环境隐藏」）。
+ */
+declare function readLauncherSwitch(fallback: boolean, storageKeyPrefix?: string): boolean;
+//#endregion
+//#region src/create.d.ts
+interface PageUseHandle {
+  capability: PageUseCapability;
+  /** 清除配置、释放 agent（清掉高亮与蒙层）、移除全局桥接；宿主登出或卸载时调用 */
+  destroy(): void;
+}
+/**
+ * 初始化 Page Use。全局只有一份配置：重复调用会以新配置替换旧配置，
+ * 旧 handle 的 destroy 随之失效（不会误清新配置）。
+ */
+declare function createPageUse(options: PageUseOptions): PageUseHandle;
+//#endregion
+//#region src/ui/launcher.d.ts
+declare const PAGE_USE_LAUNCHER_TAG = "tz-page-use-launcher";
+interface PageUseLauncherConfig {
+  /** 入口与面板标题，默认 'Page Use' */
+  title?: string;
+  /** 追加到「常用」分组的快捷指令（排在菜单生成的「打开 XX」与通用示例之后） */
+  presets?: PageUsePreset[];
+  /** 「复杂场景」分组的快捷指令；为空时不显示该分组 */
+  scenarios?: PageUsePreset[];
+  /** 由菜单生成「打开 XX」快捷指令的数量上限，默认 6；0 表示不生成 */
+  menuPresetLimit?: number;
+  /** 任务来源 → 展示名；未登记的来源直接显示原值 */
+  sourceLabels?: Record<string, string>;
+}
+declare class PageUseLauncherElement extends LitElement {
+  static styles: import("lit").CSSResult;
+  private _config;
+  /** 面板配置；赋值后立即重新渲染 */
+  get config(): PageUseLauncherConfig;
+  set config(value: PageUseLauncherConfig | undefined);
+  private open;
+  private showSettings;
+  private task;
+  private answer;
+  private tray;
+  /**
+   * 日志区跟随滚动：默认贴底跟随新内容；用户上翻后停止跟随，
+   * 回到底部附近（阈值内）或点击「最新」后恢复。
+   */
+  private stickToBottom;
+  /** 上次渲染时日志内容的摘要；仅内容变化时才贴底，避免每秒的耗时刷新把用户拉回底部 */
+  private logSignature;
+  /** 下次渲染强制滚到底部（点击「最新」、任务开始） */
+  private forceScroll;
+  /**
+   * 入口尺寸缓存：入口在面板展开时被隐藏，offsetWidth 为 0，
+   * 因此在可见时测量并保留最近一次结果；初值为「Page Use」文案下的近似尺寸。
+   */
+  private fabSize;
+  private viewport;
+  /**
+   * 面板相对入口的对齐方式：入口在视口右半边则面板右边缘对齐入口右边缘，否则左对齐；
+   * 下半边则底边对齐（面板向上展开），否则顶边对齐。
+   * 仅在展开时计算一次并在展开期间保持，避免拖动面板越过中线时锚点切换导致跳动。
+   */
+  private panelAnchor;
+  private wasRunning;
+  private cleanups;
+  private get fabEl();
+  private get panelEl();
+  private get logEl();
+  private get textareaEl();
+  private fabDrag;
+  /** 拖动面板时反推入口位置：面板锚定角即入口所在角，收起后入口停在面板原位置 */
+  private panelDrag;
+  connectedCallback(): void;
+  disconnectedCallback(): void;
+  protected firstUpdated(): void;
+  protected updated(_changed: PropertyValues): void;
+  private onStateChange;
+  private onResize;
+  private measureFab;
+  /** 入口在视口中的矩形；未拖动过时按默认 right/bottom 推算 */
+  private fabRect;
+  private resolvePanelAnchor;
+  /** 未拖动过时用默认角落定位，拖动后切换为 left/top */
+  private fabStyle;
+  /** 面板位置完全由入口位置推导，展开时与入口重合于同一角 */
+  private panelStyle;
+  private collapse;
+  private submit;
+  private applyPreset;
+  private lastTaskText;
+  /** 回车执行、Shift+回车换行；输入法组词中的回车不触发执行 */
+  private onTaskKeydown;
+  private onTaskInput;
+  /** 按内容在 2~6 行之间调整输入框高度，超出后内部滚动 */
+  private autosizeTextarea;
+  private submitAnswer;
+  private onLogScroll;
+  /**
+   * 滚轮上翻立即停止跟随：平滑滚动的首个 scroll 事件位移可能小于阈值，
+   * 若此时仍判定为贴底，内容刷新会把视图拉回底部，表现为上翻时抖动。
+   */
+  private onLogWheel;
+  private scrollLogToBottom;
+  private toggleTray;
+  private onClearLog;
+  private sourceLabel;
+  private presets;
+  private endpointLabel;
+  private renderChips;
+  private renderPresetGroups;
+  private renderCheckbox;
+  private renderSettings;
+  private renderLog;
+  private renderTray;
+  private renderComposer;
+  render(): import("lit").TemplateResult<1>;
+}
+//#endregion
+//#region src/ui/mount.d.ts
+/** 注册 <tz-page-use-glow> 与 <tz-page-use-launcher>；重复调用安全（已注册则跳过） */
+declare function definePageUseElements(): void;
+interface MountPageUseUIOptions {
+  /** 运行期定制光晕，默认 true（仍受设置 customMaskEffect 控制） */
+  glow?: boolean;
+  /** 调试面板：false 不挂载（默认）；true 或配置对象挂载 */
+  launcher?: boolean | PageUseLauncherConfig;
+  /** 挂载容器，默认 document.body */
+  container?: HTMLElement;
+}
+/**
+ * 挂载 UI，返回卸载函数。
+ * 外层容器带 data-page-agent-ignore="true"（值必须为字符串 "true"）：
+ * page-controller 按 dataset 值精确判断后跳过整棵子树，面板与光晕不会被模型当作页面元素。
+ */
+declare function mountPageUseUI(options?: MountPageUseUIOptions): () => void;
+//#endregion
+//#region src/capability/tool.d.ts
+/** 工具名；对接方在 system 提示中引用时保持一致 */
+declare const PAGE_USE_TOOL_NAME = "operate_current_page";
+declare const PAGE_USE_TOOL: {
+  readonly type: "function";
+  readonly function: {
+    readonly name: "operate_current_page";
+    readonly description: string;
+    readonly parameters: {
+      readonly type: "object";
+      readonly properties: {
+        readonly instruction: {
+          readonly type: "string";
+          readonly description: "可独立执行的完整中文指令，写明目标页面与具体操作，例如「打开订单管理下的订单列表，筛选状态为待发货并查询，告诉我第一条订单的收货地址」。";
+        };
+      };
+      readonly required: readonly ["instruction"];
+    };
+  };
+};
+/** 把任务结果整理为给模型阅读的纯文本 */
+declare function formatPageUseResultForModel(result: PageUseTaskResult): string;
+/**
+ * 执行一次 operate_current_page 工具调用。
+ * 返回 { result, content }：content 直接作为 tool 消息回给模型，result 供对接方自行展示。
+ */
+declare function runPageUseTool(args: unknown, options?: PageUseRunOptions): Promise<{
+  result: PageUseTaskResult;
+  content: string;
+}>;
+/** 指令块类型名：模型在 shell / JSON 块中输出 {"type":"pageAction","instruction":"..."} */
+declare const PAGE_USE_COMMAND_TYPE = "pageAction";
+interface PageUseCommand {
+  type: typeof PAGE_USE_COMMAND_TYPE;
+  instruction: string;
+}
+declare function isPageUseCommand(value: unknown): value is PageUseCommand;
+//#endregion
+//#region src/capability/bridge.d.ts
+/** window 上的挂载名 */
+declare const PAGE_USE_GLOBAL_KEY = "__TZ_PAGE_USE__";
+interface PageUseGlobal extends PageUseCapability {
+  tool: typeof PAGE_USE_TOOL;
+  runTool: typeof runPageUseTool;
+}
+declare global {
+  interface Window {
+    [PAGE_USE_GLOBAL_KEY]?: PageUseGlobal;
+  }
+}
+//#endregion
+//#region src/core/store.d.ts
+/**
+ * 极简可订阅状态容器（框架无关）。
+ * 状态按不可变对象整体替换，订阅方通过引用比较即可判断变化；
+ * Vue / React / Lit 等 UI 层各自把 subscribe 接到自身的响应式机制上。
+ */
+interface ReadonlyStore<T> {
+  get(): T;
+  /** 状态变化后同步通知；返回取消订阅函数 */
+  subscribe(listener: (state: T) => void): () => void;
+}
+//#endregion
+//#region src/core/service.d.ts
+interface PageUseQuestion {
+  question: string;
+  resolve: (answer: string) => void;
+}
+/** 供 UI 读取的执行状态（不可变对象，每次变化整体替换） */
+interface PageUseState {
+  /** page-agent 状态：idle / running / completed / error / stopped */
+  status: AgentStatus;
+  activityText: string;
+  currentTask: string;
+  currentTaskId: string;
+  currentSource: PageUseTaskSource;
+  steps: PageUseStepLog[];
+  lastResult: PageUseTaskResult | null;
+  errorMessage: string;
+  /** 等待调试面板作答的问题；仅当调用方未提供 onAskUser 且面板已挂载时出现 */
+  pendingQuestion: PageUseQuestion | null;
+  totalTokens: number;
+  startedAt: number;
+  finishedAt: number;
+  /** 运行期每秒推进一次，驱动耗时显示刷新 */
+  nowTick: number;
+  /** 当前 agent 实例是否带蒙层（构造期确定）；供光晕层判断，蒙层节点为异步创建，不能靠查 DOM */
+  maskEnabled: boolean;
+  /** 已配置端点且宿主未销毁 */
+  ready: boolean;
+}
+/** 只读状态容器：UI 层订阅后自行接入响应式 */
+declare const pageUseStore: ReadonlyStore<PageUseState>;
+declare function isRunning(state?: PageUseState): boolean;
+/** 任务耗时（秒）：运行中随 nowTick 每秒刷新，结束后固定 */
+declare function getElapsedSeconds(state?: PageUseState): number;
+/** 已调用 createPageUse 且配置了端点 */
+declare function isPageUseConfigured(): boolean;
+/** 当前生效的规范化配置；未配置时为 null */
+declare function getPageUseConfig(): NormalizedPageUseOptions | null;
+/**
+ * 清屏：清空面板展示的本次执行记录（指令、步骤、结果、计数），不影响历史指令与 agent 实例。
+ * 执行中不允许清空，否则后续步骤回写会与已清空的状态错位。
+ */
+declare function clearPageUseLog(): void;
+//#endregion
+//#region src/core/settings.d.ts
+interface PageUsePoint {
+  x: number;
+  y: number;
+}
+interface PageUseSettings {
+  /** 是否显示 page-agent 自带的底部面板；默认隐藏，由调试面板承担交互 */
+  showBuiltinPanel: boolean;
+  /** 是否显示运行中的元素编号高亮框（browser-use 风格数字标签） */
+  showHighlights: boolean;
+  /** 步骤列表是否展示模型思考与工具输出细节 */
+  showStepDetails: boolean;
+  /** 任务开始前是否执行宿主提供的 beforeTask（如展开折叠侧栏） */
+  enableBeforeTask: boolean;
+  /** 运行期是否用蒙层阻断用户误点 */
+  enableMask: boolean;
+  /** 蒙层使用定制光晕与光标配色（false = page-agent 默认 ai-motion 效果） */
+  customMaskEffect: boolean;
+  /** 浮动入口位置（null = 默认右下角）；面板展开时以入口为锚点定位，不单独存位置 */
+  fabPos: PageUsePoint | null;
+}
+declare const DEFAULT_PAGE_USE_SETTINGS: Readonly<PageUseSettings>;
+declare const pageUseSettings: {
+  store: ReadonlyStore<PageUseSettings>;
+  get(): PageUseSettings;
+  update(patch: Partial<PageUseSettings>): void;
+  /** 把浮动入口（及随之定位的面板）恢复到默认角落位置 */
+  resetPositions(): void;
+};
+//#endregion
+//#region src/core/history.d.ts
+interface PageUseHistoryEntry {
+  id: string;
+  task: string;
+  /** 任务来源（'launcher' 等）；旧记录无此字段 */
+  source?: string;
+  /** null：被终止或无结论 */
+  success: boolean | null;
+  /** 结束时间戳 */
+  at: number;
+  /** 执行步数 */
+  steps: number;
+  /** 模型 done 时给出的结论 */
+  summary: string;
+}
+declare const pageUseHistory: {
+  store: ReadonlyStore<{
+    entries: PageUseHistoryEntry[];
+  }>;
+  entries(): PageUseHistoryEntry[];
+  add(entry: Omit<PageUseHistoryEntry, "id">): void;
+  remove(id: string): void;
+  clear(): void;
+};
+//#endregion
+//#region src/ui/presets.d.ts
+/** 通用示例：不依赖具体站点，覆盖详情、标签、返回等典型操作 */
+declare const PAGE_USE_STATIC_PRESETS: readonly PageUsePreset[];
+/** 取前 N 个可见叶子菜单，生成「打开 XX」快捷指令 */
+declare function buildMenuPresets(menus: PageUseMenuNode[] | undefined, limit?: number): PageUsePreset[];
+//#endregion
+//#region src/ui/glow.d.ts
+declare const PAGE_USE_GLOW_TAG = "tz-page-use-glow";
+declare class PageUseGlowElement extends LitElement {
+  static styles: import("lit").CSSResult;
+  private blocked;
+  /** 每次误触自增，作为提示条 key 重建节点以重播抖动动画 */
+  private blockCount;
+  private blockedTimer;
+  private active;
+  private unsubscribers;
+  connectedCallback(): void;
+  disconnectedCallback(): void;
+  private syncActive;
+  /**
+   * 捕获阶段监听：SimulatorMask 在自身节点上 stopPropagation，
+   * 冒泡阶段收不到，必须在 window 捕获阶段判断点击目标是否落在蒙层内。
+   */
+  private onPointerDownCapture;
+  private setListening;
+  private resetBlocked;
+  render(): import("lit").TemplateResult<1>;
+}
+//#endregion
+//#region src/core/maskTheme.d.ts
+/**
+ * 运行期蒙层与模拟光标的定制主题（覆盖 page-agent SimulatorMask 的默认视觉）。
+ *
+ * page-agent 的 CSS Module 类名带哈希（如 `_cursor_1dgwb_2`），随版本变化，
+ * 因此这里只依赖稳定的结构：
+ * - 蒙层根节点 id：`page-agent-runtime_simulator-mask`
+ * - 子节点顺序：ai-motion 光晕层在前（初始化失败时不存在），光标节点恒为最后一个子节点
+ * - 光标子节点顺序：1 点击波纹 / 2 箭头填充 / 3 箭头描边
+ * - 点击态类名包含 `clicking` 子串
+ * 升级 page-agent 后若光标样式失效，先核对 SimulatorMask 的 #createCursor 结构。
+ */
+/** 蒙层根节点 id（@page-agent/page-controller 内部常量） */
+declare const SIMULATOR_MASK_ID = "page-agent-runtime_simulator-mask";
+/** 主题色：主色 #0879ff 同系的蓝 → 青 → 靛渐变 */
+declare const PAGE_USE_MASK_COLORS: {
+  readonly primary: "#0879ff";
+  readonly cyan: "#36cfc9";
+  readonly indigo: "#597ef7";
+  /** 误触拦截时的警示色 */
+  readonly warning: "#fa8c16";
+};
+//#endregion
+export { PageUsePreset as $, runPageUseTool as A, DEFAULT_MODEL as B, PageUseGlobal as C, PageUseCommand as D, PAGE_USE_TOOL_NAME as E, PageUseLauncherConfig as F, PageUseOptions as G, DEFAULT_STORAGE_KEY_PREFIX as H, PageUseLauncherElement as I, readLauncherSwitch as J, PageUseRouterMode as K, PageUseHandle as L, definePageUseElements as M, mountPageUseUI as N, formatPageUseResultForModel as O, PAGE_USE_LAUNCHER_TAG as P, PageUseMenuNode as Q, createPageUse as R, PAGE_USE_GLOBAL_KEY as S, PAGE_USE_TOOL as T, NormalizedPageUseOptions as U, DEFAULT_SESSION_HEADER as V, PageUseLLMOptions as W, pageUseCapability as X, PageUseCapability as Y, PageUseErrorCode as Z, getPageUseConfig as _, PAGE_USE_STATIC_PRESETS as a, PageUseTaskSource as at, pageUseStore as b, pageUseHistory as c, PageUseSettings as d, PageUseProgressEvent as et, pageUseSettings as f, getElapsedSeconds as g, clearPageUseLog as h, PageUseGlowElement as i, PageUseTaskResult as it, MountPageUseUIOptions as j, isPageUseCommand as k, DEFAULT_PAGE_USE_SETTINGS as l, PageUseState as m, SIMULATOR_MASK_ID as n, PageUseSnapshot as nt, buildMenuPresets as o, PageUseTaskStatus as ot, PageUseQuestion as p, normalizeOptions as q, PAGE_USE_GLOW_TAG as r, PageUseStepLog as rt, PageUseHistoryEntry as s, PAGE_USE_MASK_COLORS as t, PageUseRunOptions as tt, PageUsePoint as u, isPageUseConfigured as v, PAGE_USE_COMMAND_TYPE as w, ReadonlyStore as x, isRunning as y, DEFAULT_MAX_STEPS as z };

package/dist/index.d.mts

@@ -0,0 +1,2 @@
+import { $ as PageUsePreset, A as runPageUseTool, B as DEFAULT_MODEL, C as PageUseGlobal, D as PageUseCommand, E as PAGE_USE_TOOL_NAME, F as PageUseLauncherConfig, G as PageUseOptions, H as DEFAULT_STORAGE_KEY_PREFIX, I as PageUseLauncherElement, J as readLauncherSwitch, K as PageUseRouterMode, L as PageUseHandle, M as definePageUseElements, N as mountPageUseUI, O as formatPageUseResultForModel, P as PAGE_USE_LAUNCHER_TAG, Q as PageUseMenuNode, R as createPageUse, S as PAGE_USE_GLOBAL_KEY, T as PAGE_USE_TOOL, U as NormalizedPageUseOptions, V as DEFAULT_SESSION_HEADER, W as PageUseLLMOptions, X as pageUseCapability, Y as PageUseCapability, Z as PageUseErrorCode, _ as getPageUseConfig, a as PAGE_USE_STATIC_PRESETS, at as PageUseTaskSource, b as pageUseStore, c as pageUseHistory, d as PageUseSettings, et as PageUseProgressEvent, f as pageUseSettings, g as getElapsedSeconds, h as clearPageUseLog, i as PageUseGlowElement, it as PageUseTaskResult, j as MountPageUseUIOptions, k as isPageUseCommand, l as DEFAULT_PAGE_USE_SETTINGS, m as PageUseState, n as SIMULATOR_MASK_ID, nt as PageUseSnapshot, o as buildMenuPresets, ot as PageUseTaskStatus, p as PageUseQuestion, q as normalizeOptions, r as PAGE_USE_GLOW_TAG, rt as PageUseStepLog, s as PageUseHistoryEntry, t as PAGE_USE_MASK_COLORS, tt as PageUseRunOptions, u as PageUsePoint, v as isPageUseConfigured, w as PAGE_USE_COMMAND_TYPE, x as ReadonlyStore, y as isRunning, z as DEFAULT_MAX_STEPS } from "./index-DtJ3mvL2.mjs";
+export { DEFAULT_MAX_STEPS, DEFAULT_MODEL, DEFAULT_PAGE_USE_SETTINGS, DEFAULT_SESSION_HEADER, DEFAULT_STORAGE_KEY_PREFIX, type MountPageUseUIOptions, type NormalizedPageUseOptions, PAGE_USE_COMMAND_TYPE, PAGE_USE_GLOBAL_KEY, PAGE_USE_GLOW_TAG, PAGE_USE_LAUNCHER_TAG, PAGE_USE_MASK_COLORS, PAGE_USE_STATIC_PRESETS, PAGE_USE_TOOL, PAGE_USE_TOOL_NAME, type PageUseCapability, type PageUseCommand, type PageUseErrorCode, type PageUseGlobal, PageUseGlowElement, type PageUseHandle, type PageUseHistoryEntry, type PageUseLLMOptions, type PageUseLauncherConfig, PageUseLauncherElement, type PageUseMenuNode, type PageUseOptions, type PageUsePoint, type PageUsePreset, type PageUseProgressEvent, type PageUseQuestion, type PageUseRouterMode, type PageUseRunOptions, type PageUseSettings, type PageUseSnapshot, type PageUseState, type PageUseStepLog, type PageUseTaskResult, type PageUseTaskSource, type PageUseTaskStatus, type ReadonlyStore, SIMULATOR_MASK_ID, buildMenuPresets, clearPageUseLog, createPageUse, definePageUseElements, formatPageUseResultForModel, getElapsedSeconds, getPageUseConfig, isPageUseCommand, isPageUseConfigured, isRunning, mountPageUseUI, normalizeOptions, pageUseCapability, pageUseHistory, pageUseSettings, pageUseStore, readLauncherSwitch, runPageUseTool };

package/dist/index.mjs

@@ -0,0 +1,3 @@
+import { A as DEFAULT_MODEL, C as pageUseStore, D as SIMULATOR_MASK_ID, E as PAGE_USE_MASK_COLORS, M as DEFAULT_STORAGE_KEY_PREFIX, N as normalizeOptions, O as pageUseHistory, P as readLauncherSwitch, S as isRunning, T as pageUseSettings, _ as pageUseCapability, a as PAGE_USE_STATIC_PRESETS, b as getPageUseConfig, c as PageUseGlowElement, d as PAGE_USE_COMMAND_TYPE, f as PAGE_USE_TOOL, g as runPageUseTool, h as isPageUseCommand, i as PageUseLauncherElement, j as DEFAULT_SESSION_HEADER, k as DEFAULT_MAX_STEPS, l as createPageUse, m as formatPageUseResultForModel, n as mountPageUseUI, o as buildMenuPresets, p as PAGE_USE_TOOL_NAME, r as PAGE_USE_LAUNCHER_TAG, s as PAGE_USE_GLOW_TAG, t as definePageUseElements, u as PAGE_USE_GLOBAL_KEY, v as clearPageUseLog, w as DEFAULT_PAGE_USE_SETTINGS, x as isPageUseConfigured, y as getElapsedSeconds } from "./src-C8EWDZVz.mjs";
+
+export { DEFAULT_MAX_STEPS, DEFAULT_MODEL, DEFAULT_PAGE_USE_SETTINGS, DEFAULT_SESSION_HEADER, DEFAULT_STORAGE_KEY_PREFIX, PAGE_USE_COMMAND_TYPE, PAGE_USE_GLOBAL_KEY, PAGE_USE_GLOW_TAG, PAGE_USE_LAUNCHER_TAG, PAGE_USE_MASK_COLORS, PAGE_USE_STATIC_PRESETS, PAGE_USE_TOOL, PAGE_USE_TOOL_NAME, PageUseGlowElement, PageUseLauncherElement, SIMULATOR_MASK_ID, buildMenuPresets, clearPageUseLog, createPageUse, definePageUseElements, formatPageUseResultForModel, getElapsedSeconds, getPageUseConfig, isPageUseCommand, isPageUseConfigured, isRunning, mountPageUseUI, normalizeOptions, pageUseCapability, pageUseHistory, pageUseSettings, pageUseStore, readLauncherSwitch, runPageUseTool };