@dommaker/harness 0.9.0 → 0.11.0

package/dist/tools/definitions/definitions/std/verification/wait-condition.yml

@@ -0,0 +1,107 @@
+# wait-condition.yml - 条件等待
+# ============================================================================
+# 能力类型: verification（工具型）
+# 来源: Superpowers - condition-based-waiting (Technique)
+# 版本: 2026-03-28 (需手动同步)
+# 执行方式: 纯脚本，轮询检查条件
+# 用途: 等待某个条件满足后再继续执行
+# ============================================================================
+
+name: wait-condition
+stage: verify
+description: 等待条件满足后再继续执行，支持轮询检查
+
+input:
+  condition:
+    type: string
+    required: true
+    description: "等待的条件（如 file exists: /path/to/file）"
+    
+  check_command:
+    type: string
+    required: true
+    description: "检查命令（返回 0 表示条件满足）"
+    
+  timeout_seconds:
+    type: number
+    required: false
+    description: 超时时间（秒）
+    default: 300
+    
+  interval_seconds:
+    type: number
+    required: false
+    description: 检查间隔（秒）
+    default: 5
+    
+  repo_path:
+    type: path
+    required: false
+    description: 项目路径（可选）
+    default: "."
+
+output:
+  satisfied:
+    type: boolean
+    description: 条件是否满足
+    
+  elapsed_seconds:
+    type: number
+    description: 已等待时间（秒）
+    
+  check_count:
+    type: number
+    description: 检查次数
+
+script: |
+  #!/bin/bash
+  set -euo pipefail
+  
+  CONDITION="{{condition}}"
+  CHECK_CMD="{{check_command}}"
+  TIMEOUT="{{timeout_seconds}}"
+  INTERVAL="{{interval_seconds}}"
+  REPO_PATH="{{repo_path}}"
+  
+  cd "$REPO_PATH" 2>/dev/null || true
+  
+  echo "⏳ 等待条件满足"
+  echo "  条件: $CONDITION"
+  echo "  检查命令: $CHECK_CMD"
+  echo "  超时: ${TIMEOUT}s"
+  echo "  间隔: ${INTERVAL}s"
+  echo ""
+  
+  ELAPSED=0
+  CHECK_COUNT=0
+  
+  while [ $ELAPSED -lt $TIMEOUT ]; do
+    CHECK_COUNT=$((CHECK_COUNT + 1))
+    
+    echo "[$CHECK_COUNT] 检查条件... (已等待 ${ELAPSED}s)"
+    
+    if eval "$CHECK_CMD" >/dev/null 2>&1; then
+      echo ""
+      echo "✅ 条件满足！"
+      echo "  已等待: ${ELAPSED}s"
+      echo "  检查次数: $CHECK_COUNT"
+      echo ""
+      echo "SATISFIED=true"
+      echo "ELAPSED=$ELAPSED"
+      echo "CHECK_COUNT=$CHECK_COUNT"
+      exit 0
+    fi
+    
+    sleep $INTERVAL
+    ELAPSED=$((ELAPSED + INTERVAL))
+  done
+  
+  echo ""
+  echo "❌ 条件未满足，已超时"
+  echo "  已等待: ${ELAPSED}s"
+  echo "  检查次数: $CHECK_COUNT"
+  echo ""
+  echo "SATISFIED=false"
+  echo "ELAPSED=$ELAPSED"
+  echo "CHECK_COUNT=$CHECK_COUNT"
+  exit 1

package/dist/tools/definitions/ext/browser/browser-automate.sh

@@ -0,0 +1,255 @@
+#!/bin/bash
+# browser-automate.sh - 浏览器自动化测试脚本
+# 基于 agent-browser-stealth 实现（Puppeteer + 隐身增强）
+
+set -e
+
+# 参数解析
+ACTION="${1:-test}"
+URL="${2:-}"
+SCRIPT="${3:-}"
+OUTPUT_DIR="${4:-/tmp/browser-test-$(date +%s)}"
+SESSION_NAME="browser-test-$(date +%s)"
+HEADLESS="${HEADLESS:-true}"
+
+# 颜色输出
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m'
+
+log_info() {
+  echo -e "${GREEN}[INFO]${NC} $1"
+}
+
+log_warn() {
+  echo -e "${YELLOW}[WARN]${NC} $1"
+}
+
+log_error() {
+  echo -e "${RED}[ERROR]${NC} $1"
+}
+
+log_debug() {
+  echo -e "${BLUE}[DEBUG]${NC} $1"
+}
+
+# 检查 agent-browser-stealth 是否安装
+check_abs() {
+  if ! command -v abs &> /dev/null; then
+    log_warn "agent-browser-stealth not found, installing..."
+    npm install -g agent-browser-stealth
+    abs install
+  fi
+}
+
+# 运行浏览器测试（使用 agent-browser-stealth）
+run_browser_test() {
+  local url="$1"
+  local actions="$2"
+  
+  log_info "Starting browser automation test (agent-browser-stealth)..."
+  log_info "URL: $url"
+  log_info "Session: $SESSION_NAME"
+  log_info "Output: $OUTPUT_DIR"
+  
+  mkdir -p "$OUTPUT_DIR"
+  
+  # 结果数组
+  declare -a RESULTS=()
+  
+  # 检查 abs 命令
+  check_abs
+  
+  # 1. 打开页面
+  log_info "Opening URL..."
+  if ! abs open "$url" --session-name "$SESSION_NAME" 2>&1 | tee -a "$OUTPUT_DIR/test.log"; then
+    log_error "Failed to open URL: $url"
+    RESULTS+=("{\"action\":\"navigate\",\"status\":\"failed\",\"url\":\"$url\"}")
+    echo "{\"results\":[$(IFS=,; echo "${RESULTS[*]}")],\"errors\":[\"Failed to open URL\"]}"
+    exit 1
+  fi
+  RESULTS+=("{\"action\":\"navigate\",\"status\":\"success\",\"url\":\"$url\"}")
+  
+  # 2. 等待页面加载
+  sleep 2
+  
+  # 3. 初始截图
+  abs screenshot "$OUTPUT_DIR/screenshot-initial.png" --session-name "$SESSION_NAME" 2>/dev/null || true
+  
+  # 4. 获取元素映射
+  log_info "Getting element snapshot..."
+  SNAPSHOT_OUTPUT=$(abs snapshot -i --session-name "$SESSION_NAME" 2>&1) || true
+  
+  # 保存 snapshot 输出供调试
+  echo "$SNAPSHOT_OUTPUT" > "$OUTPUT_DIR/snapshot.txt"
+  
+  # 5. 执行测试脚本
+  if [ -n "$actions" ] && [ "$actions" != "[]" ]; then
+    log_info "Executing test actions..."
+    
+    # 解析 JSON actions 并执行
+    echo "$actions" | jq -c '.[]' 2>/dev/null | while read -r action; do
+      action_type=$(echo "$action" | jq -r '.type')
+      selector=$(echo "$action" | jq -r '.selector // ""')
+      value=$(echo "$action" | jq -r '.value // ""')
+      delay=$(echo "$action" | jq -r '.delay // 500')
+      filename=$(echo "$action" | jq -r '.filename // "screenshot.png"')
+      should_exist=$(echo "$action" | jq -r '.shouldExist // true')
+      
+      log_debug "Action: $action_type, Selector: $selector"
+      
+      case "$action_type" in
+        click)
+          # 尝试使用 @ref 引用，否则直接使用 selector
+          if abs click "$selector" --session-name "$SESSION_NAME" 2>&1 | tee -a "$OUTPUT_DIR/test.log"; then
+            log_info "Click success: $selector"
+            sleep 0.5
+          else
+            log_warn "Click failed: $selector"
+          fi
+          ;;
+        
+        type)
+          if abs type "$selector" "$value" --session-name "$SESSION_NAME" 2>&1 | tee -a "$OUTPUT_DIR/test.log"; then
+            log_info "Type success: $selector"
+          else
+            log_warn "Type failed: $selector"
+          fi
+          ;;
+        
+        wait)
+          log_info "Waiting for: $selector"
+          sleep "${delay::-3}2"  # 转换为秒
+          ;;
+        
+        screenshot)
+          abs screenshot "$OUTPUT_DIR/$filename" --session-name "$SESSION_NAME" 2>&1 | tee -a "$OUTPUT_DIR/test.log" || true
+          log_info "Screenshot saved: $filename"
+          ;;
+        
+        assert)
+          # 使用 abs eval 检查元素是否存在
+          if abs eval "document.querySelector('$selector')" --session-name "$SESSION_NAME" 2>&1 | grep -q "null"; then
+            log_warn "Element not found: $selector"
+          else
+            log_info "Element found: $selector"
+          fi
+          ;;
+        
+        scroll)
+          abs eval "window.scrollBy(0, ${value:-500})" --session-name "$SESSION_NAME" 2>&1 | tee -a "$OUTPUT_DIR/test.log" || true
+          log_info "Scrolled: ${value:-500}px"
+          ;;
+        
+        *)
+          log_warn "Unknown action: $action_type"
+          ;;
+      esac
+    done
+  fi
+  
+  # 6. 最终截图
+  abs screenshot "$OUTPUT_DIR/screenshot-final.png" --full-page --session-name "$SESSION_NAME" 2>/dev/null || true
+  
+  # 7. 获取性能指标
+  METRICS=$(abs eval "JSON.stringify(performance.getEntriesByType('navigation')[0])" --session-name "$SESSION_NAME" 2>/dev/null || echo "{}")
+  echo "$METRICS" > "$OUTPUT_DIR/metrics.json"
+  
+  # 8. 关闭浏览器
+  abs close --session-name "$SESSION_NAME" 2>/dev/null || true
+  
+  # 9. 生成结果
+  log_info "Generating test results..."
+  
+  # 构建结果 JSON
+  cat > "$OUTPUT_DIR/test-results.json" << EOF
+{
+  "results": [
+    {"action": "navigate", "status": "success", "url": "$url"},
+    {"action": "session", "status": "success", "sessionName": "$SESSION_NAME"}
+  ],
+  "screenshots": [
+    "$OUTPUT_DIR/screenshot-initial.png",
+    "$OUTPUT_DIR/screenshot-final.png"
+  ],
+  "metrics": $METRICS,
+  "outputDir": "$OUTPUT_DIR"
+}
+EOF
+  
+  log_info "Test completed. Results:"
+  cat "$OUTPUT_DIR/test-results.json"
+}
+
+# 交互式测试模式
+run_interactive_test() {
+  local url="$1"
+  
+  log_info "Starting interactive browser session..."
+  log_info "URL: $url"
+  log_info "Session: $SESSION_NAME"
+  log_info ""
+  log_info "Commands:"
+  log_info "  abs snapshot -i           # Get interactive element references"
+  log_info "  abs click @e1             # Click element by reference"
+  log_info "  abs type @e1 'text'       # Type text"
+  log_info "  abs screenshot out.png    # Take screenshot"
+  log_info "  abs close                 # Close browser"
+  log_info ""
+  
+  check_abs
+  abs open "$url" --session-name "$SESSION_NAME"
+}
+
+# 示例测试脚本
+example_login_test() {
+  cat << 'EOF'
+[
+  {"type": "wait", "selector": "input[name='username']"},
+  {"type": "type", "selector": "input[name='username']", "value": "test@example.com"},
+  {"type": "type", "selector": "input[name='password']", "value": "password123"},
+  {"type": "click", "selector": "button[type='submit']"},
+  {"type": "wait", "selector": ".dashboard", "delay": 2000},
+  {"type": "screenshot", "filename": "dashboard.png"}
+]
+EOF
+}
+
+# 主函数
+main() {
+  case "$ACTION" in
+    test)
+      if [ -z "$URL" ]; then
+        log_error "URL is required for test action"
+        echo "Usage: $0 test <url> [script]"
+        echo "Example: $0 test https://example.com '$(example_login_test)'"
+        exit 1
+      fi
+      run_browser_test "$URL" "$SCRIPT"
+      ;;
+    
+    interactive)
+      if [ -z "$URL" ]; then
+        log_error "URL is required for interactive mode"
+        echo "Usage: $0 interactive <url>"
+        exit 1
+      fi
+      run_interactive_test "$URL"
+      ;;
+    
+    example)
+      echo "Example login test script:"
+      example_login_test
+      ;;
+    
+    *)
+      log_error "Unknown action: $ACTION"
+      echo "Actions: test, interactive, example"
+      exit 1
+      ;;
+  esac
+}
+
+main "$@"

package/dist/tools/definitions/ext/browser/browser-automate.yml

@@ -0,0 +1,166 @@
+# browser-automate.yml - 浏览器自动化测试能力
+name: browser-automate
+description: 基于 agent-browser-stealth 的浏览器自动化测试（Puppeteer + 隐身增强），支持反检测、会话保持、调试能力
+
+# 输入参数
+input:
+  url:
+    type: string
+    required: true
+    description: 要测试的页面 URL
+  
+  actions:
+    type: array
+    required: false
+    description: 测试动作列表
+    default: []
+    items:
+      type: object
+      properties:
+        type:
+          type: string
+          enum: [click, type, wait, screenshot, assert, scroll]
+          description: 动作类型
+        selector:
+          type: string
+          description: CSS 选择器
+        value:
+          type: string
+          description: 输入值（type 动作）
+        delay:
+          type: number
+          description: 延迟时间（毫秒）
+        filename:
+          type: string
+          description: 截图文件名
+        shouldExist:
+          type: boolean
+          description: 断言元素是否存在
+
+  headless:
+    type: boolean
+    required: false
+    default: true
+    description: 是否无头模式运行
+
+  timeout:
+    type: number
+    required: false
+    default: 30000
+    description: 页面加载超时时间（毫秒）
+
+# 输出
+output:
+  results:
+    type: array
+    description: 测试结果列表
+  
+  screenshots:
+    type: array
+    description: 截图文件路径列表
+  
+  metrics:
+    type: object
+    description: 页面性能指标
+  
+  errors:
+    type: array
+    description: 错误列表
+
+# 执行配置
+timeout: 300  # 秒
+agent: codex
+
+# 执行脚本
+handler: script
+script: ./browser-automate.sh
+
+# 示例用法
+examples:
+  - name: 登录测试
+    input:
+      url: https://example.com/login
+      actions:
+        - type: wait
+          selector: "input[name='username']"
+        - type: type
+          selector: "input[name='username']"
+          value: "test@example.com"
+        - type: type
+          selector: "input[name='password']"
+          value: "password123"
+        - type: click
+          selector: "button[type='submit']"
+        - type: wait
+          selector: ".dashboard"
+          delay: 2000
+        - type: screenshot
+          filename: "dashboard.png"
+        - type: assert
+          selector: ".user-profile"
+          shouldExist: true
+
+  - name: 表单填写测试
+    input:
+      url: https://example.com/form
+      actions:
+        - type: wait
+          selector: "form"
+        - type: type
+          selector: "#name"
+          value: "测试用户"
+        - type: type
+          selector: "#email"
+          value: "test@example.com"
+        - type: click
+          selector: "button[type='submit']"
+        - type: wait
+          selector: ".success-message"
+        - type: screenshot
+          filename: "form-success.png"
+
+# 与 agent-browser-stealth 集成说明
+integration:
+  agent_browser_stealth:
+    description: |
+      本 Tool 底层已使用 agent-browser-stealth 作为引擎，提供：
+      
+      1. 反检测 - 多层指纹伪装、行为人性化
+      2. 会话保持 - --session-name 支持多会话
+      3. 调试能力 - trace、profiler、console、errors
+      4. 元素引用 - snapshot -i 获取 @e1, @e2 引用
+      5. 引擎选择 - Chrome + Lightpanda
+      
+    cli_commands: |
+      # 交互式使用（更灵活）
+      abs open https://example.com --session-name my-session
+      abs snapshot -i                    # 获取元素引用 @e1, @e2, ...
+      abs click @e1                      # 点击元素
+      abs type @e2 "hello" --delay 50    # 模拟人类输入
+      abs screenshot result.png          # 截图
+      abs close                          # 关闭
+      
+    advanced: |
+      # 反检测模式
+      abs open https://example.com --risk-mode warn
+      
+      # 使用 Lightpanda 引擎（更快）
+      abs open https://example.com --engine lightpanda
+      
+      # 调试模式
+      abs open https://example.com --trace --verbose
+
+# 标签
+tags:
+  - browser
+  - e2e
+  - testing
+  - automation
+  - puppeteer
+  - stealth
+  - agent-browser-stealth
+  - dom
+  - anti-detection
+
+# 分类
+category: testing

package/dist/tools/definitions/ext/browser/browser-close.sh

@@ -0,0 +1,104 @@
+#!/bin/bash
+# browser-close.sh - 关闭浏览器会话
+# ============================================================================
+# 功能：关闭浏览器会话并清理资源
+# 底层：使用 agent-browser-stealth (abs)
+# 用途：E2E 测试、浏览器自动化结束后清理
+# ============================================================================
+
+set -e
+
+# 参数
+SESSION_ID="${1:-}"
+SAVE_SCREENSHOTS="${2:-true}"
+OUTPUT_DIR="${OUTPUT_DIR:-/tmp/browser-screenshots}"
+
+# 颜色输出
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+NC='\033[0m'
+
+log_info() { echo -e "${GREEN}[INFO]${NC} $1"; }
+log_error() { echo -e "${RED}[ERROR]${NC} $1"; }
+
+# 显示帮助
+show_help() {
+  cat << EOF
+关闭浏览器会话
+
+用法:
+  $0 <session_id> [save_screenshots]
+
+参数:
+  session_id       浏览器会话 ID
+  save_screenshots 是否保存截图 (true/false，默认 true)
+
+环境变量:
+  OUTPUT_DIR  截图输出目录（默认 /tmp/browser-screenshots）
+
+输出:
+  JSON 格式的关闭结果
+
+示例:
+  $0 browser-session-123456
+  $0 browser-session-123456 true
+EOF
+  exit 0
+}
+
+# 检查参数
+if [[ "$1" == "-h" || "$1" == "--help" || -z "$SESSION_ID" ]]; then
+  show_help
+fi
+
+# 检查 abs 是否安装
+if ! command -v abs &> /dev/null; then
+  log_error "agent-browser-stealth (abs) 未安装"
+  echo '{"success": false, "error": "abs not found"}'
+  exit 1
+fi
+
+log_info "关闭浏览器会话: $SESSION_ID"
+
+SCREENSHOTS="[]"
+
+# 保存截图（可选）
+if [[ "$SAVE_SCREENSHOTS" == "true" ]]; then
+  log_info "保存截图..."
+  mkdir -p "$OUTPUT_DIR"
+  
+  SCREENSHOT_FILE="$OUTPUT_DIR/${SESSION_ID}-final.png"
+  
+  # 尝试截图
+  if abs screenshot "$SCREENSHOT_FILE" --session-name "$SESSION_ID" 2>/dev/null; then
+    SCREENSHOTS="[\"$SCREENSHOT_FILE\"]"
+    log_info "截图已保存: $SCREENSHOT_FILE"
+  fi
+fi
+
+# 关闭浏览器
+abs close --session-name "$SESSION_ID" 2>/dev/null
+
+# 检查是否成功
+if [[ $? -eq 0 ]]; then
+  log_info "浏览器会话已关闭"
+  
+  cat << EOF
+{
+  "success": true,
+  "session_id": "$SESSION_ID",
+  "screenshots": $SCREENSHOTS,
+  "output_dir": "$OUTPUT_DIR"
+}
+EOF
+else
+  cat << EOF
+{
+  "success": false,
+  "session_id": "$SESSION_ID",
+  "error": "Failed to close browser"
+}
+EOF
+  exit 1
+fi

package/dist/tools/definitions/ext/browser/browser-close.yml

@@ -0,0 +1,55 @@
+# browser-close.yml - 关闭浏览器
+# ============================================================================
+# 工具类型: 浏览器
+# 用途: 关闭浏览器会话
+# ============================================================================
+
+name: browser/browser-close
+description: |
+  关闭浏览器会话
+  
+  功能：
+  - 关闭指定会话
+  - 清理资源
+  - 可选截图保存
+
+input:
+  - name: session_id
+    type: string
+    required: true
+    description: 浏览器会话 ID
+  
+  - name: save_screenshots
+    type: boolean
+    required: false
+    default: true
+    description: 是否保存截图
+
+output:
+  - name: success
+    type: boolean
+    description: 是否关闭成功
+  
+  - name: screenshots
+    type: array
+    description: 保存的截图路径列表
+
+# 实现说明
+implementation:
+  type: script
+  script: ./browser-close.sh
+  note: |
+    使用 agent-browser-stealth (abs) 关闭浏览器
+    
+    1. 可选保存截图
+    2. 调用 abs close 关闭会话
+    3. 清理资源
+
+# 元数据
+metadata:
+  author: Agent Studio
+  version: 1.0.0
+  tags:
+    - browser
+    - puppeteer
+    - e2e