browser-opt 1.0.1

package/dist/browser-opt/runner/actions/utils/dom-action.d.ts

@@ -0,0 +1,8 @@
+/**
+ * browser-opt DOM 动作兜底工具，负责在 snapshot 信息缺失时按页面真实 DOM
+ * 的字段上下文定位控件，并执行点击、输入等通用动作。
+ */
+import type { BrowserAgent } from '@browser-automated/browser-core/agent';
+export declare function clickFieldScopedDomTarget(agent: BrowserAgent, field: string, target: string): string | null;
+export declare function fillFieldScopedDomTarget(agent: BrowserAgent, field: string, value: string): string | null;
+//# sourceMappingURL=dom-action.d.ts.map

package/dist/browser-opt/runner/actions/utils/dom-action.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dom-action.d.ts","sourceRoot":"","sources":["../../../../../src/browser-opt/runner/actions/utils/dom-action.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uCAAuC,CAAC;AAS1E,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAiB3G;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAgBzG"}

package/dist/browser-opt/runner/actions/utils/dom-action.js

@@ -0,0 +1,167 @@
+export function clickFieldScopedDomTarget(agent, field, target) {
+    const script = `(() => {
+  const helper = ${fieldScopedDomHelperSource()};
+  return JSON.stringify(helper.clickFieldScopedTarget(${JSON.stringify(field)}, ${JSON.stringify(target)}));
+})()`;
+    try {
+        const parsed = parseEvalJson(agent.evaluate(script));
+        if (parsed.found && parsed.clicked) {
+            agent.waitMs(300);
+            const clickedText = parsed.targetText ? ` (${parsed.targetText.trim()})` : '';
+            return `click dom ${field} -> ${target}${clickedText}`;
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+export function fillFieldScopedDomTarget(agent, field, value) {
+    const script = `(() => {
+  const helper = ${fieldScopedDomHelperSource()};
+  return JSON.stringify(helper.fillFieldScopedTarget(${JSON.stringify(field)}, ${JSON.stringify(value)}));
+})()`;
+    try {
+        const parsed = parseEvalJson(agent.evaluate(script));
+        if (parsed.found && parsed.filled) {
+            agent.waitMs(300);
+            return `fill dom ${field} ${JSON.stringify(value)}`;
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+function parseEvalJson(raw) {
+    const decoded = JSON.parse(raw.trim());
+    return typeof decoded === 'string'
+        ? JSON.parse(decoded)
+        : decoded;
+}
+/** 返回页面上下文内使用的字段近邻定位工具源码，兼容常见表单和伪控件结构。 */
+function fieldScopedDomHelperSource() {
+    return `
+(() => {
+const normalize = (value) => String(value || '').replace(/[\\s：:，,。；*"'‘’“”]/g, '').toLowerCase();
+const visible = (element) => {
+  const style = window.getComputedStyle(element);
+  const rect = element.getBoundingClientRect();
+  return style.visibility !== 'hidden' && style.display !== 'none' && rect.width > 0 && rect.height > 0;
+};
+const textOf = (element) => [
+  element.textContent,
+  element.getAttribute('aria-label'),
+  element.getAttribute('placeholder'),
+  element.getAttribute('title'),
+  element.getAttribute('value'),
+].filter(Boolean).join(' ');
+const textMatches = (element, text) => normalize(textOf(element)).includes(text);
+const disabled = (element) => element.disabled === true || element.getAttribute('aria-disabled') === 'true' || element.matches('[disabled], .disabled, .ant-select-disabled, .is-disabled');
+const clickable = (element) => {
+  if (disabled(element)) return false;
+  const style = window.getComputedStyle(element);
+  const role = element.getAttribute('role') || '';
+  return element instanceof HTMLButtonElement
+    || element instanceof HTMLAnchorElement
+    || element instanceof HTMLInputElement
+    || element instanceof HTMLTextAreaElement
+    || Boolean(element.onclick)
+    || ['button', 'option', 'menuitem', 'menuitemcheckbox', 'checkbox', 'radio', 'switch'].includes(role)
+    || element.tabIndex >= 0
+    || style.cursor === 'pointer'
+    || element.matches('.ant-select, .ant-select-selector, .ant-cascader, .ant-cascader-picker, .el-select, .el-input, .el-input__inner');
+};
+const inputLike = (element) => {
+  if (disabled(element)) return false;
+  if (element instanceof HTMLTextAreaElement) return true;
+  if (element instanceof HTMLInputElement) return !['hidden', 'file', 'checkbox', 'radio', 'button', 'submit', 'reset'].includes(element.type);
+  return element.isContentEditable === true;
+};
+const dispatchMouse = (element) => {
+  element.scrollIntoView({ block: 'center', inline: 'nearest' });
+  const rect = element.getBoundingClientRect();
+  const init = {
+    bubbles: true,
+    cancelable: true,
+    view: window,
+    clientX: (rect.left + rect.right) / 2,
+    clientY: (rect.top + rect.bottom) / 2,
+  };
+  element.dispatchEvent(new MouseEvent('pointerdown', init));
+  element.dispatchEvent(new MouseEvent('mousedown', init));
+  element.dispatchEvent(new MouseEvent('mouseup', init));
+  element.dispatchEvent(new MouseEvent('click', init));
+};
+const dispatchValue = (element, value) => {
+  element.scrollIntoView({ block: 'center', inline: 'nearest' });
+  element.focus?.();
+  if (element instanceof HTMLInputElement || element instanceof HTMLTextAreaElement) {
+    const proto = element instanceof HTMLTextAreaElement ? HTMLTextAreaElement.prototype : HTMLInputElement.prototype;
+    const setter = Object.getOwnPropertyDescriptor(proto, 'value')?.set;
+    setter?.call(element, value);
+  } else if (element.isContentEditable) {
+    element.textContent = value;
+  }
+  element.dispatchEvent(new Event('input', { bubbles: true }));
+  element.dispatchEvent(new Event('change', { bubbles: true }));
+  element.blur?.();
+};
+const candidates = () => [...document.body.querySelectorAll('*')].filter((element) => visible(element));
+const fieldElements = (field) => {
+  const fieldText = normalize(field);
+  return candidates()
+    .filter((element) => textMatches(element, fieldText))
+    .map((element) => ({ element, rect: element.getBoundingClientRect(), textLength: normalize(textOf(element)).length }))
+    .sort((a, b) => a.textLength - b.textLength || (a.rect.width * a.rect.height) - (b.rect.width * b.rect.height));
+};
+const closestFieldContainer = (element) => element.closest('.ant-form-item, .el-form-item, .form-item, [class*="form-item"], [class*="FormItem"], [class*="field"], [class*="Field"]');
+const nearestByPosition = (fields, targets) => {
+  const scored = [];
+  for (const field of fields) {
+    for (const item of targets) {
+      const rect = item.element.getBoundingClientRect();
+      if (rect.top < field.rect.top - 8) continue;
+      const verticalGap = Math.max(0, rect.top - field.rect.bottom);
+      if (verticalGap > 260) continue;
+      const horizontalGap = Math.abs(rect.left - field.rect.left);
+      scored.push({ element: item.element, score: verticalGap * 10 + horizontalGap });
+    }
+  }
+  scored.sort((a, b) => a.score - b.score);
+  return scored[0]?.element || null;
+};
+const scopedTarget = (field, predicate) => {
+  const fields = fieldElements(field);
+  for (const fieldItem of fields) {
+    const container = closestFieldContainer(fieldItem.element);
+    const scoped = container ? [...container.querySelectorAll('*')].filter((element) => visible(element) && predicate(element)) : [];
+    if (scoped.length > 0) {
+      return { element: scoped[0], fields };
+    }
+  }
+  const targets = candidates().filter(predicate).map((element) => ({ element }));
+  return { element: nearestByPosition(fields, targets), fields };
+};
+function clickFieldScopedTarget(field, target) {
+  const targetText = normalize(target);
+  const result = scopedTarget(field, (element) => clickable(element) && textMatches(element, targetText));
+  if (result.element) {
+    dispatchMouse(result.element);
+    return { found: true, clicked: true, targetText: textOf(result.element) };
+  }
+  return { found: result.fields.length > 0, clicked: false };
+}
+function fillFieldScopedTarget(field, value) {
+  const result = scopedTarget(field, inputLike);
+  if (result.element) {
+    dispatchValue(result.element, value);
+    return { found: true, filled: true, targetText: textOf(result.element) };
+  }
+  return { found: result.fields.length > 0, filled: false };
+}
+return { clickFieldScopedTarget, fillFieldScopedTarget };
+})()
+`;
+}
+//# sourceMappingURL=dom-action.js.map

package/dist/browser-opt/runner/actions/utils/dom-action.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dom-action.js","sourceRoot":"","sources":["../../../../../src/browser-opt/runner/actions/utils/dom-action.ts"],"names":[],"mappings":"AAaA,MAAM,UAAU,yBAAyB,CAAC,KAAmB,EAAE,KAAa,EAAE,MAAc;IAC1F,MAAM,MAAM,GAAG;mBACE,0BAA0B,EAAE;wDACS,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC;KACnG,CAAC;IAEJ,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,aAAa,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;QACrD,IAAI,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAClB,MAAM,WAAW,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YAC9E,OAAO,aAAa,KAAK,OAAO,MAAM,GAAG,WAAW,EAAE,CAAC;QACzD,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,KAAmB,EAAE,KAAa,EAAE,KAAa;IACxF,MAAM,MAAM,GAAG;mBACE,0BAA0B,EAAE;uDACQ,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;KACjG,CAAC;IAEJ,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,aAAa,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;QACrD,IAAI,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YAClC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAClB,OAAO,YAAY,KAAK,IAAI,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;QACtD,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,aAAa,CAAC,GAAW;IAChC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,CAAY,CAAC;IAClD,OAAO,OAAO,OAAO,KAAK,QAAQ;QAChC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAyB;QAC7C,CAAC,CAAC,OAA+B,CAAC;AACtC,CAAC;AAED,0CAA0C;AAC1C,SAAS,0BAA0B;IACjC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyHR,CAAC;AACF,CAAC"}

package/dist/browser-opt/runner/actions/utils/fill-action.d.ts

@@ -0,0 +1,10 @@
+/**
+ * browser-opt 输入动作执行器，负责定位输入框并处理登录页阻塞的 handoff。
+ */
+import type { BrowserAgent } from '@browser-automated/browser-core/agent';
+import type { DeterministicAction, SnapshotEvidence } from '../../../type.js';
+/** 执行输入动作，登录页阻塞时转为 handoff，避免误报找不到业务字段。 */
+export declare function executeFillAction(agent: BrowserAgent, action: Extract<DeterministicAction, {
+    type: 'fill';
+}>, snapshot: SnapshotEvidence): string;
+//# sourceMappingURL=fill-action.d.ts.map

package/dist/browser-opt/runner/actions/utils/fill-action.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fill-action.d.ts","sourceRoot":"","sources":["../../../../../src/browser-opt/runner/actions/utils/fill-action.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uCAAuC,CAAC;AAC1E,OAAO,KAAK,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAK9E,2CAA2C;AAC3C,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,YAAY,EACnB,MAAM,EAAE,OAAO,CAAC,mBAAmB,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,EACtD,QAAQ,EAAE,gBAAgB,GACzB,MAAM,CAoBR"}

package/dist/browser-opt/runner/actions/utils/fill-action.js

@@ -0,0 +1,20 @@
+import { findTextboxRef } from '../../../utils.js';
+import { buildLoginHandoffActionOutput, isLoginLikeSnapshot } from '../../handoff.js';
+import { fillFieldScopedDomTarget } from './dom-action.js';
+/** 执行输入动作，登录页阻塞时转为 handoff，避免误报找不到业务字段。 */
+export function executeFillAction(agent, action, snapshot) {
+    const ref = findTextboxRef(snapshot, action.field);
+    if (!ref) {
+        if (isLoginLikeSnapshot(snapshot)) {
+            return buildLoginHandoffActionOutput(agent, `当前页面仍在登录页，无法继续填写“${action.field}”，请先完成登录后再继续自动化。`);
+        }
+        const domOutput = fillFieldScopedDomTarget(agent, action.field, action.value);
+        if (domOutput) {
+            return domOutput;
+        }
+        throw new Error(`无法找到输入框：${action.field}`);
+    }
+    const output = agent.fill(ref, action.value);
+    return `fill @${ref} ${JSON.stringify(action.value)}\n${output}`.trim();
+}
+//# sourceMappingURL=fill-action.js.map

package/dist/browser-opt/runner/actions/utils/fill-action.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fill-action.js","sourceRoot":"","sources":["../../../../../src/browser-opt/runner/actions/utils/fill-action.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,6BAA6B,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACtF,OAAO,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAE3D,2CAA2C;AAC3C,MAAM,UAAU,iBAAiB,CAC/B,KAAmB,EACnB,MAAsD,EACtD,QAA0B;IAE1B,MAAM,GAAG,GAAG,cAAc,CAAC,QAAQ,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;IACnD,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,IAAI,mBAAmB,CAAC,QAAQ,CAAC,EAAE,CAAC;YAClC,OAAO,6BAA6B,CAClC,KAAK,EACL,oBAAoB,MAAM,CAAC,KAAK,kBAAkB,CACnD,CAAC;QACJ,CAAC;QAED,MAAM,SAAS,GAAG,wBAAwB,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;QAC9E,IAAI,SAAS,EAAE,CAAC;YACd,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,MAAM,IAAI,KAAK,CAAC,WAAW,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;IAC7C,CAAC;IAED,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;IAC7C,OAAO,SAAS,GAAG,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC;AAC1E,CAAC"}

package/dist/browser-opt/runner/actions/utils/handoff-action.d.ts

@@ -0,0 +1,10 @@
+/**
+ * browser-opt 人工接管动作执行器，负责把 handoff 消息交给 agent-browser。
+ */
+import type { BrowserAgent } from '@browser-automated/browser-core/agent';
+import type { DeterministicAction } from '../../../type.js';
+/** 执行人工接管动作，保持输出格式与其他确定性动作一致。 */
+export declare function executeHandoffAction(agent: BrowserAgent, action: Extract<DeterministicAction, {
+    type: 'handoff';
+}>): string;
+//# sourceMappingURL=handoff-action.d.ts.map

package/dist/browser-opt/runner/actions/utils/handoff-action.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handoff-action.d.ts","sourceRoot":"","sources":["../../../../../src/browser-opt/runner/actions/utils/handoff-action.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uCAAuC,CAAC;AAC1E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAE5D,iCAAiC;AACjC,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,YAAY,EACnB,MAAM,EAAE,OAAO,CAAC,mBAAmB,EAAE;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,CAAC,GACxD,MAAM,CAGR"}

package/dist/browser-opt/runner/actions/utils/handoff-action.js

@@ -0,0 +1,6 @@
+/** 执行人工接管动作，保持输出格式与其他确定性动作一致。 */
+export function executeHandoffAction(agent, action) {
+    const output = agent.handoff(action.message);
+    return `handoff ${JSON.stringify(action.message)}\n${output}`.trim();
+}
+//# sourceMappingURL=handoff-action.js.map

package/dist/browser-opt/runner/actions/utils/handoff-action.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handoff-action.js","sourceRoot":"","sources":["../../../../../src/browser-opt/runner/actions/utils/handoff-action.ts"],"names":[],"mappings":"AAMA,iCAAiC;AACjC,MAAM,UAAU,oBAAoB,CAClC,KAAmB,EACnB,MAAyD;IAEzD,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC7C,OAAO,WAAW,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC;AACvE,CAAC"}

package/dist/browser-opt/runner/actions/utils/open-action.d.ts

@@ -0,0 +1,10 @@
+/**
+ * browser-opt 打开页面动作执行器，负责处理重复打开跳过和实际 open 命令下发。
+ */
+import type { BrowserAgent } from '@browser-automated/browser-core/agent';
+import type { DeterministicAction, DeterministicExecutionOptions } from '../../../type.js';
+/** 执行打开页面动作，避免重复打开 runner 已初始化的目标地址。 */
+export declare function executeOpenAction(agent: BrowserAgent, action: Extract<DeterministicAction, {
+    type: 'open';
+}>, options: DeterministicExecutionOptions): string;
+//# sourceMappingURL=open-action.d.ts.map

package/dist/browser-opt/runner/actions/utils/open-action.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-action.d.ts","sourceRoot":"","sources":["../../../../../src/browser-opt/runner/actions/utils/open-action.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uCAAuC,CAAC;AAC1E,OAAO,KAAK,EAAE,mBAAmB,EAAE,6BAA6B,EAAE,MAAM,kBAAkB,CAAC;AAG3F,wCAAwC;AACxC,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,YAAY,EACnB,MAAM,EAAE,OAAO,CAAC,mBAAmB,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,EACtD,OAAO,EAAE,6BAA6B,GACrC,MAAM,CAMR"}

package/dist/browser-opt/runner/actions/utils/open-action.js

@@ -0,0 +1,9 @@
+import { normalizeUrlForCompare } from '../../evidence.js';
+/** 执行打开页面动作，避免重复打开 runner 已初始化的目标地址。 */
+export function executeOpenAction(agent, action, options) {
+    if (options.alreadyOpenedUrl && normalizeUrlForCompare(action.url) === normalizeUrlForCompare(options.alreadyOpenedUrl)) {
+        return `open skipped: ${action.url} 已由 runner 初始化打开`;
+    }
+    return agent.open(action.url);
+}
+//# sourceMappingURL=open-action.js.map

package/dist/browser-opt/runner/actions/utils/open-action.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-action.js","sourceRoot":"","sources":["../../../../../src/browser-opt/runner/actions/utils/open-action.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAE3D,wCAAwC;AACxC,MAAM,UAAU,iBAAiB,CAC/B,KAAmB,EACnB,MAAsD,EACtD,OAAsC;IAEtC,IAAI,OAAO,CAAC,gBAAgB,IAAI,sBAAsB,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,sBAAsB,CAAC,OAAO,CAAC,gBAAgB,CAAC,EAAE,CAAC;QACxH,OAAO,iBAAiB,MAAM,CAAC,GAAG,kBAAkB,CAAC;IACvD,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;AAChC,CAAC"}

package/dist/browser-opt/runner/actions/utils/select-option-action.d.ts

@@ -0,0 +1,17 @@
+/**
+ * browser-opt 选项选择动作执行器，负责下拉、单选、复选和 switch 的确定性选择流程。
+ */
+import type { BrowserAgent } from '@browser-automated/browser-core/agent';
+import type { DeterministicAction, SnapshotEvidence, DeterministicExecutionOptions } from '../../../type.js';
+/** 执行选项选择动作，包含 switch、原生单选复选框和长表单滚动搜索兜底。 */
+export declare function executeSelectOptionAction(agent: BrowserAgent, action: Extract<DeterministicAction, {
+    type: 'select-option';
+}>, snapshot: SnapshotEvidence, options: DeterministicExecutionOptions): string;
+/** 对选择动作做后置状态确认，防止命令发出但页面没有完成目标状态时误报成功。 */
+export declare function verifySelectOptionActionEffect(agent: BrowserAgent, action: Extract<DeterministicAction, {
+    type: 'select-option';
+}>, afterSnapshot: SnapshotEvidence): {
+    passed: boolean;
+    message: string;
+};
+//# sourceMappingURL=select-option-action.d.ts.map

package/dist/browser-opt/runner/actions/utils/select-option-action.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"select-option-action.d.ts","sourceRoot":"","sources":["../../../../../src/browser-opt/runner/actions/utils/select-option-action.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uCAAuC,CAAC;AAC1E,OAAO,KAAK,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,6BAA6B,EAAE,MAAM,kBAAkB,CAAC;AAY7G,4CAA4C;AAC5C,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,YAAY,EACnB,MAAM,EAAE,OAAO,CAAC,mBAAmB,EAAE;IAAE,IAAI,EAAE,eAAe,CAAA;CAAE,CAAC,EAC/D,QAAQ,EAAE,gBAAgB,EAC1B,OAAO,EAAE,6BAA6B,GACrC,MAAM,CAiFR;AAED,2CAA2C;AAC3C,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,YAAY,EACnB,MAAM,EAAE,OAAO,CAAC,mBAAmB,EAAE;IAAE,IAAI,EAAE,eAAe,CAAA;CAAE,CAAC,EAC/D,aAAa,EAAE,gBAAgB,GAC9B;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CA+BtC"}