@kritchoff/agent-browser 0.9.3 → 0.9.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kritchoff/agent-browser",
-  "version": "0.9.3",
+  "version": "0.9.5",
   "description": "Headless browser automation CLI for AI agents",
   "type": "module",
   "main": "dist/index.js",
@@ -11,6 +11,7 @@
     "scripts",
     "skills",
     "sdk.sh",
+    "start.sh",
     "docker-compose.sdk.yml"
   ],
   "bin": {

package/start.sh

@@ -0,0 +1,117 @@
+#!/bin/bash
+set -e
+
+# 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 > /dev/null 2>&1
+
+# 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)
+
+# 2b. Import Snapshot (if requested)
+if [ -n "$SNAPSHOT_PATH" ]; then
+    echo -e "\n${YELLOW}[2.5/4] Importing Snapshot: $SNAPSHOT_PATH...${NC}"
+    
+    # Wait for container to be responsive
+    echo -n "      Waiting for container to be ready for import... "
+    until docker exec "$ANDROID_CONTAINER" echo "ready" &>/dev/null; do
+        sleep 1
+    done
+    echo -e "${GREEN}OK${NC}"
+
+    # Import
+    if ./scripts/snapshot_manager.sh import "$SNAPSHOT_PATH" "w8rl_imported"; then
+        echo -e "${GREEN}      Snapshot imported successfully.${NC}"
+        
+        # Configure emulator to load this snapshot
+        # We set the env var in the container for the next boot
+        # (This assumes the entrypoint script respects EMULATOR_SNAPSHOT_NAME)
+        # For now, we'll rely on the default behavior or standard AVD loading
+        
+        echo "      Restarting Android service to load snapshot..."
+        docker compose -f "${COMPOSE_FILE:-docker-compose.prod.yml}" restart android-service
+        
+        # Update container ID after restart
+        ANDROID_CONTAINER=$(docker compose -f "${COMPOSE_FILE:-docker-compose.prod.yml}" ps -q android-service)
+    else
+        echo -e "${RED}Error: Failed to import snapshot.${NC}"
+        exit 1
+    fi
+fi
+
+# 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 2
+    done
+    echo -e "${GREEN}Done!${NC}"
+}
+
+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"
+wait_for_log "$AGENT_CONTAINER" "Ready on port 3000" "Agent Daemon Connection"
+
+# 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}"