aidevops 2.52.1

package/.agent/scripts/stagehand-helper.sh

@@ -0,0 +1,321 @@
+#!/bin/bash
+# shellcheck disable=SC2034,SC2155,SC2317,SC2329,SC2016,SC2181,SC1091,SC2154,SC2015,SC2086,SC2129,SC2030,SC2031,SC2119,SC2120,SC2001,SC2162,SC2088,SC2089,SC2090,SC2029,SC2006,SC2153
+
+# Stagehand Helper - AI Browser Automation Framework Integration
+# Part of AI DevOps Framework
+# Provides local setup and usage of Stagehand for browser automation
+
+# Source shared constants and functions
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+source "${SCRIPT_DIR}/shared-constants.sh"
+
+# Colors for output
+readonly BLUE='\033[0;34m'
+readonly GREEN='\033[0;32m'
+readonly YELLOW='\033[1;33m'
+readonly RED='\033[0;31m'
+readonly NC='\033[0m'
+
+# Print functions
+print_info() {
+    local msg="$1"
+    echo -e "${BLUE}[INFO]${NC} $msg"
+    return 0
+}
+
+print_success() {
+    local msg="$1"
+    echo -e "${GREEN}[SUCCESS]${NC} $msg"
+    return 0
+}
+
+print_warning() {
+    local msg="$1"
+    echo -e "${YELLOW}[WARNING]${NC} $msg"
+    return 0
+}
+
+print_error() {
+    local msg="$1"
+    echo -e "${RED}[ERROR]${NC} $msg" >&2
+    return 0
+}
+
+# Stagehand-specific constants
+readonly STAGEHAND_CONFIG_DIR="${HOME}/.aidevops/stagehand"
+readonly STAGEHAND_EXAMPLES_DIR="${STAGEHAND_CONFIG_DIR}/examples"
+readonly STAGEHAND_LOGS_DIR="${STAGEHAND_CONFIG_DIR}/logs"
+readonly STAGEHAND_CACHE_DIR="${STAGEHAND_CONFIG_DIR}/cache"
+
+# Create necessary directories
+create_stagehand_directories() {
+    local directories=(
+        "$STAGEHAND_CONFIG_DIR"
+        "$STAGEHAND_EXAMPLES_DIR"
+        "$STAGEHAND_LOGS_DIR"
+        "$STAGEHAND_CACHE_DIR"
+    )
+    
+    for dir in "${directories[@]}"; do
+        mkdir -p "$dir"
+    done
+    
+    print_success "Created Stagehand directories"
+    return 0
+}
+
+# Install Stagehand and dependencies
+install_stagehand() {
+    print_info "Installing Stagehand AI Browser Automation Framework..."
+    
+    # Check for Bun (preferred) or Node.js
+    local use_bun=false
+    if command -v bun &> /dev/null; then
+        use_bun=true
+        print_success "Using Bun $(bun --version)"
+    elif command -v node &> /dev/null; then
+        if ! command -v npm &> /dev/null; then
+            print_error "npm is required but not installed. Please install npm or Bun."
+            return 1
+        fi
+        print_info "Using Node.js (install Bun for faster setup: curl -fsSL https://bun.sh/install | bash)"
+    else
+        print_error "Bun or Node.js is required. Install Bun: curl -fsSL https://bun.sh/install | bash"
+        return 1
+    fi
+    
+    # Create project directory
+    create_stagehand_directories
+    
+    # Initialize project if needed
+    if [[ ! -f "${STAGEHAND_CONFIG_DIR}/package.json" ]]; then
+        print_info "Initializing project..."
+        cd "$STAGEHAND_CONFIG_DIR" || return 1
+        if [[ "$use_bun" == "true" ]]; then
+            bun init -y > /dev/null 2>&1
+        else
+            npm init -y > /dev/null 2>&1
+        fi
+    fi
+    
+    # Install Stagehand
+    print_info "Installing @browserbasehq/stagehand..."
+    cd "$STAGEHAND_CONFIG_DIR" || return 1
+    if [[ "$use_bun" == "true" ]]; then
+        bun add @browserbasehq/stagehand
+    else
+        # NOSONAR - npm scripts required for Playwright browser automation binaries
+        npm install @browserbasehq/stagehand
+    fi
+    
+    # Install additional dependencies for better functionality
+    print_info "Installing additional dependencies..."
+    if [[ "$use_bun" == "true" ]]; then
+        bun add zod dotenv
+    else
+        # NOSONAR - npm scripts required for dependency compilation
+        npm install zod dotenv
+    fi
+    
+    print_success "Stagehand installation completed"
+    return 0
+}
+
+# Create example Stagehand script
+create_example_script() {
+    local example_file="${STAGEHAND_EXAMPLES_DIR}/basic-example.js"
+    
+    cat > "$example_file" << 'EOF'
+// Basic Stagehand Example
+// AI-powered browser automation with natural language
+
+import { Stagehand } from "@browserbasehq/stagehand";
+import { z } from "zod";
+
+async function main() {
+    // Initialize Stagehand
+    const stagehand = new Stagehand({
+        env: "LOCAL", // Use local browser
+        verbose: 1,
+        debugDom: true
+    });
+
+    try {
+        // Initialize browser context
+        await stagehand.init();
+        
+        // Navigate to a website
+        await stagehand.page.goto("https://example.com");
+        
+        // Use natural language to interact with the page
+        await stagehand.act("click on the 'More information...' link");
+        
+        // Extract structured data from the page
+        const pageInfo = await stagehand.extract(
+            "extract the page title and main heading",
+            z.object({
+                title: z.string().describe("The page title"),
+                heading: z.string().describe("The main heading text")
+            })
+        );
+        
+        console.log("Extracted data:", pageInfo);
+        
+        // Use observe to discover available actions
+        const actions = await stagehand.observe("find all clickable buttons");
+        console.log("Available actions:", actions);
+        
+    } catch (error) {
+        console.error("Error during automation:", error);
+    } finally {
+        // Clean up
+        await stagehand.close();
+    }
+    return 0
+}
+
+// Run the example
+main().catch(console.error);
+EOF
+
+    print_success "Created basic example script at: $example_file"
+    return 0
+}
+
+# Create environment configuration
+create_env_config() {
+    local env_file="${STAGEHAND_CONFIG_DIR}/.env"
+    
+    if [[ -f "$env_file" ]]; then
+        print_info "Environment file already exists: $env_file"
+        return 0
+    fi
+    
+    cat > "$env_file" << 'EOF'
+# Stagehand Configuration
+# Copy this file and customize for your needs
+
+# OpenAI API Key (for AI-powered actions)
+OPENAI_API_KEY=your_openai_api_key_here
+
+# Anthropic API Key (alternative AI provider)
+ANTHROPIC_API_KEY=your_anthropic_api_key_here
+
+# Browserbase credentials (optional, for cloud browsers)
+BROWSERBASE_API_KEY=your_browserbase_api_key_here
+BROWSERBASE_PROJECT_ID=your_browserbase_project_id_here
+
+# Browser configuration
+STAGEHAND_ENV=LOCAL
+STAGEHAND_HEADLESS=false
+STAGEHAND_VERBOSE=1
+STAGEHAND_DEBUG_DOM=true
+
+# Logging
+STAGEHAND_LOG_LEVEL=info
+STAGEHAND_LOG_FILE=stagehand.log
+EOF
+
+    print_success "Created environment configuration at: $env_file"
+    print_info "Please edit $env_file to add your API keys"
+    return 0
+}
+
+# Show help information
+show_help() {
+    cat << EOF
+Stagehand Helper - AI Browser Automation Framework Integration
+
+USAGE:
+    $0 [COMMAND] [OPTIONS]
+
+COMMANDS:
+    help                    Show this help message
+    install                 Install Stagehand and dependencies
+    setup                   Complete setup (install + configure)
+    create-example          Create basic example script
+    run-example             Run the basic example script
+    status                  Check Stagehand installation status
+    logs                    Show recent Stagehand logs
+    clean                   Clean cache and temporary files
+
+EXAMPLES:
+    $0 install              # Install Stagehand
+    $0 setup                # Complete setup
+    $0 run-example          # Run basic example
+    $0 status               # Check installation
+
+DOCUMENTATION:
+    For detailed documentation, see: .agent/STAGEHAND.md
+    Official docs: https://docs.stagehand.dev
+    GitHub: https://github.com/browserbase/stagehand
+
+EOF
+    return 0
+}
+
+# Main function
+main() {
+    local command="${1:-help}"
+    
+    case "$command" in
+        "help")
+            show_help
+            ;;
+        "install")
+            install_stagehand
+            ;;
+        "setup")
+            install_stagehand && create_env_config && create_example_script
+            ;;
+        "create-example")
+            create_stagehand_directories && create_example_script
+            ;;
+        "run-example")
+            if [[ -f "${STAGEHAND_EXAMPLES_DIR}/basic-example.js" ]]; then
+                cd "$STAGEHAND_CONFIG_DIR" || return 1
+                node "${STAGEHAND_EXAMPLES_DIR}/basic-example.js"
+            else
+                print_error "Example script not found. Run '$0 create-example' first."
+                return 1
+            fi
+            ;;
+        "status")
+            if [[ -d "$STAGEHAND_CONFIG_DIR" ]] && [[ -f "${STAGEHAND_CONFIG_DIR}/package.json" ]]; then
+                print_success "Stagehand is installed at: $STAGEHAND_CONFIG_DIR"
+                if command -v node &> /dev/null; then
+                    print_info "Node.js version: $(node --version)"
+                fi
+                if command -v npm &> /dev/null; then
+                    print_info "npm version: $(npm --version)"
+                fi
+            else
+                print_error "Stagehand is not installed. Run '$0 install' first."
+                return 1
+            fi
+            ;;
+        "logs")
+            if [[ -f "${STAGEHAND_LOGS_DIR}/stagehand.log" ]]; then
+                tail -n 50 "${STAGEHAND_LOGS_DIR}/stagehand.log"
+            else
+                print_info "No log files found"
+            fi
+            ;;
+        "clean")
+            print_info "Cleaning Stagehand cache and temporary files..."
+            rm -rf "${STAGEHAND_CACHE_DIR:?}"/*
+            rm -rf "${STAGEHAND_LOGS_DIR:?}"/*
+            print_success "Cleanup completed"
+            ;;
+        *)
+            print_error "$ERROR_UNKNOWN_COMMAND $command"
+            show_help
+            return 1
+            ;;
+    esac
+    
+    return 0
+}
+
+# Execute main function with all arguments
+main "$@"

package/.agent/scripts/stagehand-python-helper.sh

@@ -0,0 +1,321 @@
+#!/bin/bash
+# shellcheck disable=SC2034,SC2155,SC2317,SC2329,SC2016,SC2181,SC1091,SC2154,SC2015,SC2086,SC2129,SC2030,SC2031,SC2119,SC2120,SC2001,SC2162,SC2088,SC2089,SC2090,SC2029,SC2006,SC2153
+
+# Stagehand Python Helper - AI Browser Automation Framework Integration
+# Part of AI DevOps Framework
+# Provides local setup and usage of Stagehand Python for browser automation
+
+# Source shared constants and functions
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+source "${SCRIPT_DIR}/shared-constants.sh"
+
+# Colors for output
+readonly BLUE='\033[0;34m'
+readonly GREEN='\033[0;32m'
+readonly YELLOW='\033[1;33m'
+readonly RED='\033[0;31m'
+readonly NC='\033[0m'
+
+# Print functions
+print_info() {
+    local msg="$1"
+    echo -e "${BLUE}[INFO]${NC} $msg"
+    return 0
+}
+
+print_success() {
+    local msg="$1"
+    echo -e "${GREEN}[SUCCESS]${NC} $msg"
+    return 0
+}
+
+print_warning() {
+    local msg="$1"
+    echo -e "${YELLOW}[WARNING]${NC} $msg"
+    return 0
+}
+
+print_error() {
+    local msg="$1"
+    echo -e "${RED}[ERROR]${NC} $msg" >&2
+    return 0
+}
+
+# Stagehand Python-specific constants
+readonly STAGEHAND_PYTHON_CONFIG_DIR="${HOME}/.aidevops/stagehand-python"
+readonly STAGEHAND_PYTHON_EXAMPLES_DIR="${STAGEHAND_PYTHON_CONFIG_DIR}/examples"
+readonly STAGEHAND_PYTHON_LOGS_DIR="${STAGEHAND_PYTHON_CONFIG_DIR}/logs"
+readonly STAGEHAND_PYTHON_CACHE_DIR="${STAGEHAND_PYTHON_CONFIG_DIR}/cache"
+readonly STAGEHAND_PYTHON_VENV_DIR="${STAGEHAND_PYTHON_CONFIG_DIR}/.venv"
+
+# Create necessary directories
+create_stagehand_python_directories() {
+    local directories=(
+        "$STAGEHAND_PYTHON_CONFIG_DIR"
+        "$STAGEHAND_PYTHON_EXAMPLES_DIR"
+        "$STAGEHAND_PYTHON_LOGS_DIR"
+        "$STAGEHAND_PYTHON_CACHE_DIR"
+    )
+    
+    for dir in "${directories[@]}"; do
+        mkdir -p "$dir"
+    done
+    
+    print_success "Created Stagehand Python directories"
+    return 0
+}
+
+# Check Python installation and version
+check_python_requirements() {
+    print_info "Checking Python requirements..."
+    
+    # Check for Python 3.8+
+    if command -v python3 &> /dev/null; then
+        local python_version
+        python_version=$(python3 --version | cut -d' ' -f2)
+        print_success "Python 3 found: $python_version"
+        
+        # Check if version is 3.8+
+        local major minor
+        major=$(echo "$python_version" | cut -d'.' -f1)
+        minor=$(echo "$python_version" | cut -d'.' -f2)
+        
+        if [[ "$major" -ge 3 ]] && [[ "$minor" -ge 8 ]]; then
+            print_success "Python version is compatible (3.8+)"
+        else
+            print_error "Python 3.8+ is required. Found: $python_version"
+            return 1
+        fi
+    else
+        print_error "Python 3 is not installed. Please install Python 3.8+ first."
+        return 1
+    fi
+    
+    # Check for pip
+    if command -v pip3 &> /dev/null; then
+        local pip_version
+        pip_version=$(pip3 --version | cut -d' ' -f2)
+        print_success "pip3 found: $pip_version"
+    else
+        print_error "pip3 is not installed. Please install pip3 first."
+        return 1
+    fi
+    
+    return 0
+}
+
+# Install Stagehand Python with virtual environment
+install_stagehand_python() {
+    print_info "Installing Stagehand Python AI Browser Automation Framework..."
+    
+    # Check requirements first
+    if ! check_python_requirements; then
+        return 1
+    fi
+    
+    # Create directories
+    create_stagehand_python_directories
+    
+    cd "$STAGEHAND_PYTHON_CONFIG_DIR" || return 1
+    
+    # Check if uv is available (recommended)
+    if command -v uv &> /dev/null; then
+        print_info "Using uv for faster installation..."
+        
+        # Create virtual environment with uv
+        print_info "Creating virtual environment with uv..."
+        uv venv .venv
+        
+        # Activate virtual environment
+        # shellcheck source=/dev/null
+        source .venv/bin/activate
+        
+        # Install Stagehand with uv
+        print_info "Installing stagehand with uv..."
+        uv pip install stagehand
+        
+        # Install additional dependencies
+        print_info "Installing additional dependencies..."
+        uv pip install python-dotenv pydantic playwright
+        
+    else
+        print_info "Using pip for installation..."
+        
+        # Create virtual environment with venv
+        print_info "Creating virtual environment..."
+        python3 -m venv .venv
+        
+        # Activate virtual environment
+        # shellcheck source=/dev/null
+        source .venv/bin/activate
+        
+        # Upgrade pip
+        pip install --upgrade pip
+        
+        # Install Stagehand
+        print_info "Installing stagehand..."
+        pip install stagehand
+        
+        # Install additional dependencies
+        print_info "Installing additional dependencies..."
+        pip install python-dotenv pydantic playwright
+    fi
+    
+    # Install Playwright browsers
+    print_info "Installing Playwright browsers..."
+    playwright install
+    
+    print_success "Stagehand Python installation completed"
+    print_info "Virtual environment created at: $STAGEHAND_PYTHON_VENV_DIR"
+    return 0
+}
+
+# Create Python environment configuration
+create_python_env_config() {
+    local env_file="${STAGEHAND_PYTHON_CONFIG_DIR}/.env"
+    
+    if [[ -f "$env_file" ]]; then
+        print_info "Environment file already exists: $env_file"
+        return 0
+    fi
+    
+    cat > "$env_file" << 'EOF'
+# Stagehand Python Configuration
+# Copy this file and customize for your needs
+
+# AI Model Configuration (choose one)
+OPENAI_API_KEY=your_openai_api_key_here
+ANTHROPIC_API_KEY=your_anthropic_api_key_here
+GOOGLE_API_KEY=your_google_api_key_here
+
+# Browserbase Configuration (optional, for cloud browsers)
+BROWSERBASE_API_KEY=your_browserbase_api_key_here
+BROWSERBASE_PROJECT_ID=your_browserbase_project_id_here
+
+# Stagehand Configuration
+STAGEHAND_ENV=LOCAL
+STAGEHAND_HEADLESS=false
+STAGEHAND_VERBOSE=1
+STAGEHAND_DEBUG_DOM=true
+
+# Model Configuration
+MODEL_NAME=google/gemini-2.5-flash-preview-05-20
+MODEL_API_KEY=${GOOGLE_API_KEY}
+
+# Logging Configuration
+LOG_LEVEL=INFO
+LOG_FILE=stagehand-python.log
+EOF
+
+    print_success "Created Python environment configuration at: $env_file"
+    print_info "Please edit $env_file to add your API keys"
+    return 0
+}
+
+# Show help information
+show_help() {
+    cat << EOF
+Stagehand Python Helper - AI Browser Automation Framework Integration
+
+USAGE:
+    $0 [COMMAND] [OPTIONS]
+
+COMMANDS:
+    help                    Show this help message
+    install                 Install Stagehand Python and dependencies
+    setup                   Complete setup (install + configure + examples)
+    create-examples         Create Python example scripts
+    run-example [NAME]      Run a specific example script
+    status                  Check Stagehand Python installation status
+    activate                Show activation command for virtual environment
+    logs                    Show recent Stagehand Python logs
+    clean                   Clean cache and temporary files
+    test                    Run basic functionality test
+
+EXAMPLES:
+    $0 install              # Install Stagehand Python
+    $0 setup                # Complete setup
+    $0 activate             # Show venv activation command
+    $0 run-example basic    # Run basic example
+    $0 status               # Check installation
+
+VIRTUAL ENVIRONMENT:
+    To activate the virtual environment manually:
+    source ~/.aidevops/stagehand-python/.venv/bin/activate
+
+DOCUMENTATION:
+    For detailed documentation, see: .agent/STAGEHAND-PYTHON.md
+    Official docs: https://docs.stagehand.dev
+    GitHub: https://github.com/browserbase/stagehand-python
+
+EOF
+    return 0
+}
+
+# Main function
+main() {
+    local command="${1:-help}"
+    
+    case "$command" in
+        "help")
+            show_help
+            ;;
+        "install")
+            install_stagehand_python
+            ;;
+        "setup")
+            install_stagehand_python && create_python_env_config
+            ;;
+        "create-examples")
+            create_stagehand_python_directories
+            print_info "Python examples will be created by the setup script"
+            ;;
+        "status")
+            if [[ -d "$STAGEHAND_PYTHON_VENV_DIR" ]] && [[ -f "${STAGEHAND_PYTHON_VENV_DIR}/bin/activate" ]]; then
+                print_success "Stagehand Python is installed at: $STAGEHAND_PYTHON_CONFIG_DIR"
+                print_info "Virtual environment: $STAGEHAND_PYTHON_VENV_DIR"
+                if command -v python3 &> /dev/null; then
+                    print_info "Python version: $(python3 --version)"
+                fi
+                if [[ -f "${STAGEHAND_PYTHON_VENV_DIR}/bin/python" ]]; then
+                    print_info "Virtual env Python: $(${STAGEHAND_PYTHON_VENV_DIR}/bin/python --version)"
+                fi
+            else
+                print_error "Stagehand Python is not installed. Run '$0 install' first."
+                return 1
+            fi
+            ;;
+        "activate")
+            if [[ -f "${STAGEHAND_PYTHON_VENV_DIR}/bin/activate" ]]; then
+                print_info "To activate the virtual environment, run:"
+                echo "source ${STAGEHAND_PYTHON_VENV_DIR}/bin/activate"
+            else
+                print_error "Virtual environment not found. Run '$0 install' first."
+                return 1
+            fi
+            ;;
+        "logs")
+            if [[ -f "${STAGEHAND_PYTHON_LOGS_DIR}/stagehand-python.log" ]]; then
+                tail -n 50 "${STAGEHAND_PYTHON_LOGS_DIR}/stagehand-python.log"
+            else
+                print_info "No log files found"
+            fi
+            ;;
+        "clean")
+            print_info "Cleaning Stagehand Python cache and temporary files..."
+            rm -rf "${STAGEHAND_PYTHON_CACHE_DIR:?}"/*
+            rm -rf "${STAGEHAND_PYTHON_LOGS_DIR:?}"/*
+            print_success "Cleanup completed"
+            ;;
+        *)
+            print_error "$ERROR_UNKNOWN_COMMAND $command"
+            show_help
+            return 1
+            ;;
+    esac
+    
+    return 0
+}
+
+# Execute main function with all arguments
+main "$@"