@kritchoff/agent-browser 0.9.51 → 1.0.0

package/scripts/snapshot_manager.sh

@@ -1,293 +0,0 @@
-#!/bin/bash
-# Emulator snapshot import/export utility
-#
-# Manages Android emulator snapshots for agent-browser.
-# Snapshots are stored in the emulator's AVD directory and can be
-# exported as compressed tar.gz files for sharing or backup.
-#
-# Usage:
-#   ./scripts/snapshot_manager.sh export <name> <output.tar.gz>
-#   ./scripts/snapshot_manager.sh import <input.tar.gz> [name]
-#   ./scripts/snapshot_manager.sh list
-#   ./scripts/snapshot_manager.sh validate <name>
-#
-# Examples:
-#   # Export current snapshot for sharing
-#   ./scripts/snapshot_manager.sh export w8rl_clean ./my_snapshot.tar.gz
-#
-#   # Import a snapshot from a file
-#   ./scripts/snapshot_manager.sh import ./my_snapshot.tar.gz
-#
-#   # Import with a different name
-#   ./scripts/snapshot_manager.sh import ./my_snapshot.tar.gz imported_snapshot
-#
-#   # List all available snapshots
-#   ./scripts/snapshot_manager.sh list
-#
-#   # Validate a snapshot is not corrupt
-#   ./scripts/snapshot_manager.sh validate w8rl_clean
-
-set -euo pipefail
-
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-PROJECT_DIR="$(dirname "$SCRIPT_DIR")"
-
-cd "$PROJECT_DIR"
-
-# Respect COMPOSE_FILE from environment
-COMPOSE_FILE="${COMPOSE_FILE:-docker-compose.prod.yml}"
-
-# Detect container name using docker compose
-CONTAINER=$(docker compose -f "$COMPOSE_FILE" ps -q android-service)
-if [ -z "$CONTAINER" ]; then
-    echo "Error: android-service container not running."
-    exit 1
-fi
-
-AVD_NAME="${EMULATOR_NAME:-Pixel_6_API_34}"
-SNAPSHOT_BASE="/root/.android/avd/${AVD_NAME}.avd/snapshots"
-
-# Colors for output
-RED='\033[0;31m'
-GREEN='\033[0;32m'
-YELLOW='\033[1;33m'
-BLUE='\033[0;34m'
-NC='\033[0m' # No Color
-
-log_info() {
-    echo -e "${BLUE}[INFO]${NC} $1"
-}
-
-log_success() {
-    echo -e "${GREEN}[OK]${NC} $1"
-}
-
-log_warn() {
-    echo -e "${YELLOW}[WARN]${NC} $1"
-}
-
-log_error() {
-    echo -e "${RED}[ERROR]${NC} $1"
-}
-
-# Check if container is running
-check_container() {
-    # Use docker inspect for reliable status check (avoids SIGPIPE with grep -q)
-    if [ "$(docker inspect -f '{{.State.Running}}' "$CONTAINER" 2>/dev/null)" != "true" ]; then
-        log_error "Container '${CONTAINER}' is not running"
-        log_info "Start it with: docker compose -f ${COMPOSE_FILE} up -d android-service"
-        exit 1
-    fi
-}
-
-# Validate a snapshot has all required files and is not corrupt
-validate_snapshot_internal() {
-    local name="$1"
-    local snapshot_dir="${SNAPSHOT_BASE}/${name}"
-    local valid=true
-
-    log_info "Validating snapshot '${name}'..."
-
-    for file in ram.bin snapshot.pb hardware.ini; do
-        if docker exec "$CONTAINER" test -f "${snapshot_dir}/${file}"; then
-            local size
-            size=$(docker exec "$CONTAINER" stat -c%s "${snapshot_dir}/${file}")
-            echo -e "  ${GREEN}✓${NC} ${file}: ${size} bytes"
-        else
-            echo -e "  ${RED}✗${NC} ${file}: MISSING"
-            valid=false
-        fi
-    done
-
-    # Check ram.bin size (must be >= 1MB)
-    if docker exec "$CONTAINER" test -f "${snapshot_dir}/ram.bin"; then
-        local ram_size
-        ram_size=$(docker exec "$CONTAINER" stat -c%s "${snapshot_dir}/ram.bin")
-        if [ "$ram_size" -lt 1000000 ]; then
-            echo -e "  ${RED}✗${NC} ram.bin too small (${ram_size} bytes, expected >= 1MB)"
-            valid=false
-        fi
-    fi
-
-    if [ "$valid" = true ]; then
-        log_success "Snapshot validation passed"
-        return 0
-    else
-        log_error "Snapshot validation failed"
-        return 1
-    fi
-}
-
-# Export a snapshot to a tar.gz file
-cmd_export() {
-    local name="${1:?Usage: $0 export <name> <output.tar.gz>}"
-    local output="${2:?Usage: $0 export <name> <output.tar.gz>}"
-
-    check_container
-
-    # Validate snapshot exists
-    if ! docker exec "$CONTAINER" test -d "${SNAPSHOT_BASE}/${name}"; then
-        log_error "Snapshot '${name}' does not exist"
-        exit 1
-    fi
-
-    log_info "Exporting snapshot '${name}' to ${output}..."
-
-    # Validate before export
-    if ! validate_snapshot_internal "$name"; then
-        log_error "Cannot export invalid snapshot"
-        exit 1
-    fi
-
-    # Create tar.gz from snapshot directory
-    docker exec "$CONTAINER" tar -czf - -C "$SNAPSHOT_BASE" "$name" > "$output"
-
-    local size
-    size=$(ls -lh "$output" | awk '{print $5}')
-    log_success "Exported: ${output} (${size})"
-}
-
-# Import a snapshot from a tar.gz file
-cmd_import() {
-    local input="${1:?Usage: $0 import <input.tar.gz> [name]}"
-
-    # Extract original name from tar
-    # Disable pipefail to avoid SIGPIPE from tar | head
-    set +o pipefail
-    local original_name
-    original_name=$(tar -tzf "$input" 2>/dev/null | head -1 | cut -d'/' -f1)
-    set -o pipefail
-
-    local name="${2:-$original_name}"
-
-    if [ -z "$name" ]; then
-        log_error "Could not determine snapshot name from archive"
-        exit 1
-    fi
-
-    check_container
-
-    log_info "Importing snapshot from ${input} as '${name}'..."
-
-    # Ensure snapshot directory exists
-    docker exec "$CONTAINER" mkdir -p "$SNAPSHOT_BASE"
-
-    # Remove existing snapshot if present
-    if docker exec "$CONTAINER" test -d "${SNAPSHOT_BASE}/${name}"; then
-        log_warn "Removing existing snapshot '${name}'..."
-        docker exec "$CONTAINER" rm -rf "${SNAPSHOT_BASE}/${name}"
-    fi
-
-    # Extract snapshot into container
-    # Use 'docker cp' to avoid stdin pipe issues
-    log_info "Copying archive to container..."
-    docker cp "$input" "$CONTAINER:/tmp/import_snapshot.tar.gz"
-
-    log_info "Extracting archive..."
-    if ! docker exec "$CONTAINER" tar -xzf /tmp/import_snapshot.tar.gz -C "$SNAPSHOT_BASE"; then
-        log_error "Failed to extract snapshot archive"
-        docker exec "$CONTAINER" rm -f /tmp/import_snapshot.tar.gz
-        exit 1
-    fi
-
-    # Clean up
-    docker exec "$CONTAINER" rm -f /tmp/import_snapshot.tar.gz
-
-    # If renaming, move the extracted directory
-    if [ "$name" != "$original_name" ]; then
-        docker exec "$CONTAINER" mv "${SNAPSHOT_BASE}/${original_name}" "${SNAPSHOT_BASE}/${name}"
-    fi
-
-    # Validate after import
-    if validate_snapshot_internal "$name"; then
-        log_success "Import completed successfully"
-        docker exec "$CONTAINER" ls -lh "${SNAPSHOT_BASE}/${name}/"
-    else
-        log_error "Import failed - snapshot validation failed"
-        exit 1
-    fi
-}
-
-# List all snapshots
-cmd_list() {
-    check_container
-
-    log_info "Available snapshots in ${CONTAINER}:"
-    echo ""
-
-    if docker exec "$CONTAINER" test -d "$SNAPSHOT_BASE"; then
-        docker exec "$CONTAINER" ls -la "$SNAPSHOT_BASE" 2>/dev/null | tail -n +2 || echo "  (none)"
-
-        echo ""
-        log_info "Snapshot details:"
-        for snapshot in $(docker exec "$CONTAINER" ls "$SNAPSHOT_BASE" 2>/dev/null); do
-            local snapshot_dir="${SNAPSHOT_BASE}/${snapshot}"
-            if docker exec "$CONTAINER" test -d "$snapshot_dir"; then
-                local ram_size
-                ram_size=$(docker exec "$CONTAINER" stat -c%s "${snapshot_dir}/ram.bin" 2>/dev/null || echo "0")
-                local ram_mb=$((ram_size / 1024 / 1024))
-                echo "  ${snapshot}: ${ram_mb}MB RAM"
-            fi
-        done
-    else
-        echo "  No snapshots found (snapshot directory does not exist)"
-    fi
-}
-
-# Validate a snapshot
-cmd_validate() {
-    local name="${1:?Usage: $0 validate <name>}"
-
-    check_container
-
-    if ! docker exec "$CONTAINER" test -d "${SNAPSHOT_BASE}/${name}"; then
-        log_error "Snapshot '${name}' does not exist"
-        exit 1
-    fi
-
-    validate_snapshot_internal "$name"
-}
-
-# Show usage
-usage() {
-    echo "Usage: $0 {export|import|list|validate} [args...]"
-    echo ""
-    echo "Commands:"
-    echo "  export <name> <output.tar.gz>  Export a snapshot to a file"
-    echo "  import <input.tar.gz> [name]   Import a snapshot from a file"
-    echo "  list                           List all available snapshots"
-    echo "  validate <name>                Validate a snapshot is not corrupt"
-    echo ""
-    echo "Examples:"
-    echo "  $0 export w8rl_clean ./my_snapshot.tar.gz"
-    echo "  $0 import ./my_snapshot.tar.gz"
-    echo "  $0 import ./my_snapshot.tar.gz custom_name"
-    echo "  $0 list"
-    echo "  $0 validate w8rl_clean"
-}
-
-# Main command dispatch
-case "${1:-}" in
-    export)
-        shift
-        cmd_export "$@"
-        ;;
-    import)
-        shift
-        cmd_import "$@"
-        ;;
-    list)
-        cmd_list
-        ;;
-    validate)
-        shift
-        cmd_validate "$@"
-        ;;
-    -h|--help|help)
-        usage
-        ;;
-    *)
-        usage
-        exit 1
-        ;;
-esac

package/scripts/vaccine-run

@@ -1,26 +0,0 @@
-#!/bin/bash
-exec 2>&1
-
-echo "[vaccine] Waiting for emulator..."
-adb wait-for-device
-
-echo "[vaccine] Waiting for boot completion..."
-while [[ -z $(adb shell getprop sys.boot_completed) ]]; do sleep 1; done
-
-echo "[vaccine] Waiting for Package Manager..."
-while ! adb shell pm list packages > /dev/null 2>&1; do sleep 1; done
-
-echo "[vaccine] Applying permissions to org.chromium.chrome (WootzApp)..."
-adb shell pm grant org.chromium.chrome android.permission.ACCESS_FINE_LOCATION || true
-adb shell pm grant org.chromium.chrome android.permission.CAMERA || true
-adb shell pm grant org.chromium.chrome android.permission.RECORD_AUDIO || true
-
-# Fallback for standard Chrome if present
-adb shell pm grant com.android.chrome android.permission.ACCESS_FINE_LOCATION || true
-adb shell pm grant com.android.chrome android.permission.CAMERA || true
-adb shell pm grant com.android.chrome android.permission.RECORD_AUDIO || true
-
-echo "[vaccine] Permissions granted."
-
-# Prevent restart
-touch /etc/services.d/vaccine/down

package/sdk.sh

@@ -1,176 +0,0 @@
-#!/bin/bash
-# Agent Browser SDK Wrapper
-# 
-# A user-friendly entry point for AI Agents to interact with the Android Browser Environment.
-# Handles "Hyper-Speed Snapshot" logic for instant startups.
-#
-# Usage:
-#   ./sdk.sh start      - Start the environment (Cold boot 1st time, Warm boot after)
-#   ./sdk.sh stop       - Stop the environment
-#   ./sdk.sh reset      - Fast Reset the browser (15s)
-#   ./sdk.sh agent ...  - Run agent commands (e.g. ./sdk.sh agent open google.com)
-#
-
-set -e
-
-# Set high timeouts for large image downloads
-export COMPOSE_HTTP_TIMEOUT=900
-export DOCKER_CLIENT_TIMEOUT=900
-
-SDK_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-CACHE_DIR="$SDK_ROOT/cache"
-SNAPSHOT_DIR="$CACHE_DIR/snapshots/quickboot"
-
-# Default to production/local build unless --dist is used
-COMPOSE_FILE="$SDK_ROOT/docker-compose.prod.yml"
-
-# Colors
-GREEN='\033[0;32m'
-BLUE='\033[0;34m'
-YELLOW='\033[1;33m'
-RED='\033[0;31m'
-NC='\033[0m' # No Color
-
-# Parse global options
-while [[ $# -gt 0 ]]; do
-    case $1 in
-        --dist)
-            COMPOSE_FILE="$SDK_ROOT/docker-compose.sdk.yml"
-            shift
-            ;;
-        *)
-            break
-            ;;
-    esac
-done
-
-# Ensure cache dir exists
-mkdir -p "$CACHE_DIR/snapshots"
-
-log_info() { echo -e "${BLUE}[SDK]${NC} $1"; }
-log_success() { echo -e "${GREEN}[SDK]${NC} $1"; }
-log_warn() { echo -e "${YELLOW}[SDK]${NC} $1"; }
-log_error() { echo -e "${RED}[SDK]${NC} $1"; }
-
-pull_images_with_retry() {
-    if [[ "$COMPOSE_FILE" != *"docker-compose.sdk.yml" ]]; then
-        return 0
-    fi
-
-    local max_retries=10
-    local count=0
-    
-    log_info "Please wait while we get things ready..."
-    
-    while [ $count -lt $max_retries ]; do
-        if docker compose -f "$COMPOSE_FILE" pull; then
-            return 0
-        fi
-        
-        count=$((count + 1))
-        log_warn "Download failed/interrupted. Retrying ($count/$max_retries) in 10s..."
-        sleep 10
-    done
-    
-    log_error "Failed to download images after $max_retries attempts. Please check your internet connection."
-    exit 1
-}
-
-cmd_start() {
-    log_info "Initializing Agent Environment (using $COMPOSE_FILE)..."
-    export COMPOSE_FILE="$COMPOSE_FILE"
-    pull_images_with_retry
-
-    log_info "Cleaning up previous container state..."
-    docker compose -f "$COMPOSE_FILE" down -v --remove-orphans >/dev/null 2>&1 || true
-
-    if [ -d "$SNAPSHOT_DIR" ]; then
-        # === WARM START ===
-        log_success "Found cached baseline snapshot. Performing HYPER-SPEED WARM BOOT..."
-        export EMULATOR_SNAPSHOT_NAME="quickboot"
-        "$SDK_ROOT/start.sh"
-    else
-        # === COLD START & FREEZE ===
-        log_warn "No baseline found. Performing FIRST RUN SETUP (Cold Boot)..."
-        log_warn "This will take ~60-90 seconds, but only once."
-
-        export EMULATOR_SNAPSHOT_NAME=""
-
-        "$SDK_ROOT/start.sh" &
-        START_PID=$!
-        wait $START_PID
-        
-        if [ $? -ne 0 ]; then
-            log_error "Startup failed."
-            exit 1
-        fi
-
-        cd "$SDK_ROOT"
-        CONTAINER=$(docker compose ps -q android-service)
-        
-        if [ -z "$CONTAINER" ]; then
-            log_error "Error: Android container not found."
-            exit 1
-        fi
-
-        log_info "Saving emulator state (quickboot)..."
-        if docker exec "$CONTAINER" adb emu avd snapshot save quickboot; then
-             log_success "Snapshot saved to host volume."
-             log_success "Setup Complete! Future runs will launch instantly."
-        else
-             log_error "Failed to save snapshot inside emulator."
-             exit 1
-        fi
-    fi
-}
-
-cmd_stop() {
-    log_info "Stopping environment (using $COMPOSE_FILE)..."
-    cd "$SDK_ROOT"
-    docker compose -f "$COMPOSE_FILE" stop
-    log_success "Stopped."
-}
-
-cmd_clean() {
-    log_info "Tearing down environment and releasing ports (using $COMPOSE_FILE)..."
-    cd "$SDK_ROOT"
-    docker compose -f "$COMPOSE_FILE" down -v --remove-orphans
-    log_success "Environment cleaned."
-}
-
-cmd_reset() {
-    log_info "Performing Fast Browser Reset..."
-    export COMPOSE_FILE="$COMPOSE_FILE"
-    "$SDK_ROOT/scripts/fast_reset.sh"
-}
-
-cmd_agent() {
-    if [ -f "$SDK_ROOT/agent" ]; then
-        "$SDK_ROOT/agent" "$@"
-    else
-        node "$SDK_ROOT/bin/agent-browser.js" "$@"
-    fi
-}
-
-case "$1" in
-    start)
-        cmd_start
-        ;;
-    stop)
-        cmd_stop
-        ;;
-    clean)
-        cmd_clean
-        ;;
-    reset)
-        cmd_reset
-        ;;
-    agent)
-        shift
-        cmd_agent "$@"
-        ;;
-    *)
-        echo "Usage: $0 {start|stop|clean|reset|agent}"
-        exit 1
-        ;;
-esac

package/start.sh

@@ -1,109 +0,0 @@
-#!/bin/bash
-set -e
-
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-
-# Colors
-GREEN='\033[0;32m'
-BLUE='\033[0;34m'
-YELLOW='\033[1;33m'
-RED='\033[0;31m'
-NC='\033[0m' # No Color
-
-echo -e "${BLUE}=================================================${NC}"
-echo -e "${BLUE}   Agent Browser - Android Environment Setup     ${NC}"
-echo -e "${BLUE}=================================================${NC}"
-
-SNAPSHOT_PATH=""
-while [[ $# -gt 0 ]]; do
-    case $1 in
-        --snapshot)
-            SNAPSHOT_PATH="$2"
-            shift 2
-            ;;
-        *)
-            echo "Unknown option: $1"
-            exit 1
-            ;;
-    esac
-done
-
-# 1. Pre-flight Checks
-echo -e "\n${YELLOW}[1/4] Checking System Requirements...${NC}"
-
-if ! command -v docker &> /dev/null; then
-    echo -e "${RED}Error: Docker is not installed.${NC}"
-    exit 1
-fi
-
-if [[ "$OSTYPE" == "linux-gnu"* ]]; then
-    if [ -e /dev/kvm ]; then
-        echo -e "${GREEN}✓ KVM Acceleration detected (/dev/kvm)${NC}"
-    else
-        echo -e "${YELLOW}⚠ Warning: No KVM detected. Emulator will be slow.${NC}"
-    fi
-fi
-
-# 2. Start Services
-echo -e "\n${YELLOW}[2/4] Starting Docker Stack...${NC}"
-echo "      (First run may take a few minutes to download images)"
-
-docker compose -f "${COMPOSE_FILE:-docker-compose.prod.yml}" up -d --build --remove-orphans
-
-# Find actual container names
-ANDROID_CONTAINER=$(docker compose -f "${COMPOSE_FILE:-docker-compose.prod.yml}" ps -q android-service)
-AGENT_CONTAINER=$(docker compose -f "${COMPOSE_FILE:-docker-compose.prod.yml}" ps -q agent-service)
-
-# 3. Wait for Readiness
-echo -e "\n${YELLOW}[3/4] Waiting for Initialization...${NC}"
-
-wait_for_log() {
-    local container=$1
-    local pattern=$2
-    local label=$3
-    
-    echo -n "      Waiting for $label... "
-    until docker logs "$container" 2>&1 | grep -q "$pattern"; do
-        sleep 1 # Faster polling
-    done
-    echo -e "${GREEN}Done!${NC}"
-}
-
-if [ -z "$SNAPSHOT_PATH" ] && [ -z "$EMULATOR_SNAPSHOT_NAME" ]; then
-    # --- COLD BOOT PATH (Wait for everything) ---
-    wait_for_log "$ANDROID_CONTAINER" "Emulator boot complete" "Android Emulator Boot"
-    wait_for_log "$ANDROID_CONTAINER" "APK installation complete" "WootzApp Installation"
-    wait_for_log "$ANDROID_CONTAINER" "CDP Bridge ready" "CDP Bridge"
-else
-    # --- WARM BOOT PATH (Hyper-Speed) ---
-    # We skip Boot and APK installation because they are inside the snapshot.
-    # We only wait for the Daemon to reconnect to the resumed emulator.
-    echo -e "${GREEN}      Snapshot detected. Skipping OS boot and APK install waits.${NC}"
-fi
-
-# We always wait for the Daemon because it's the final bridge to the SDK
-wait_for_log "$AGENT_CONTAINER" "Daemon listening on TCP" "Agent Daemon Connection"
-
-# 3.5 Network Rehydration (Warm Boot Only)
-if [ -n "$SNAPSHOT_PATH" ] || [ -n "$EMULATOR_SNAPSHOT_NAME" ]; then
-    echo "      Rehydrating Android network connection..."
-    # Toggle airplane mode to force DHCP lease renewal
-    docker exec "$ANDROID_CONTAINER" adb shell cmd connectivity airplane-mode enable
-    sleep 2
-    docker exec "$ANDROID_CONTAINER" adb shell cmd connectivity airplane-mode disable
-    # Wait for internet to come back
-    sleep 3
-fi
-
-# 4. Success
-echo -e "\n${GREEN}[4/4] Environment Ready!${NC}"
-echo -e "${BLUE}=================================================${NC}"
-echo -e "You can now control the Android browser."
-echo -e ""
-echo -e "Try these commands:"
-echo -e "  ${GREEN}./agent open https://google.com${NC}"
-echo -e "  ${GREEN}./agent snapshot${NC}"
-echo -e "  ${GREEN}./agent click @e1${NC}"
-echo -e ""
-echo -e "See COMMANDS.md for full reference."
-echo -e "${BLUE}=================================================${NC}"