agex 0.2.8 → 0.2.11

package/assets/scripts/ab-click.sh

@@ -0,0 +1,137 @@
+#!/bin/bash
+# Smooth click: animates visual cursor to element, clicks, then fades cursor out
+# 1. If cursor not visible, starts from left-center of viewport
+# 2. Smoothly moves visual cursor to element's center
+# 3. Performs the actual click via agent-browser
+# 4. Fades the cursor out
+# Usage: ab-click <selector|@ref>
+SELECTOR="$1"
+if [ -z "$SELECTOR" ]; then
+  echo "Usage: ab-click <selector|@ref>"
+  exit 1
+fi
+
+# Smooth-scroll element into center of viewport so the viewer can follow
+if [[ "$SELECTOR" == @* ]]; then
+  # For @ref: get bounding box first, then smooth-scroll by coordinates
+  PRE_STYLES=$(agent-browser get styles "$SELECTOR" --json {{SESSION_ARG}} 2>&1) || true
+  PRE_Y=$(echo "$PRE_STYLES" | grep -o '"y":[0-9.-]*' | head -1 | cut -d: -f2)
+  PRE_H=$(echo "$PRE_STYLES" | grep -o '"height":[0-9.-]*' | head -1 | cut -d: -f2)
+  if [ -n "$PRE_Y" ] && [ -n "$PRE_H" ]; then
+    SCROLL_DUR=$(agent-browser eval "(function(){ var viewH=window.innerHeight; var centerY=${PRE_Y}+${PRE_H}/2; if(centerY>viewH*0.2 && centerY<viewH*0.8) return '0'; var dist=Math.abs(centerY-viewH/2); var dur=Math.max(600,Math.min(2000,Math.round(dist*1.5))); window.scrollBy({top:centerY-viewH/2,behavior:'smooth'}); return ''+dur; })()" {{SESSION_ARG}} 2>/dev/null || echo "0")
+    SCROLL_DUR=$(echo "$SCROLL_DUR" | tr -d '[:space:]"')
+    if [ -n "$SCROLL_DUR" ] && [ "$SCROLL_DUR" != "0" ]; then
+      SCROLL_WAIT=$((SCROLL_DUR + 200))
+      agent-browser wait "$SCROLL_WAIT" {{SESSION_ARG}} >/dev/null 2>&1
+    else
+      agent-browser wait 300 {{SESSION_ARG}} >/dev/null 2>&1
+    fi
+  else
+    # Fallback: use instant scrollintoview
+    agent-browser scrollintoview "$SELECTOR" {{SESSION_ARG}} >/dev/null 2>&1
+    agent-browser wait 300 {{SESSION_ARG}} >/dev/null 2>&1
+  fi
+else
+  ESCAPED_SELECTOR=$(printf '%s' "$SELECTOR" | sed "s/'/\\\\'/g")
+  SCROLL_DUR=$(agent-browser eval "'' + (window.__agexEffects ? window.__agexEffects.proof.scrollElementToCenterSmooth('${ESCAPED_SELECTOR}') : 0)" {{SESSION_ARG}} 2>/dev/null || echo "0")
+  SCROLL_DUR=$(echo "$SCROLL_DUR" | tr -d '[:space:]"')
+  if [ -z "$SCROLL_DUR" ] || [ "$SCROLL_DUR" = "0" ]; then
+    agent-browser eval "window.__agexEffects.proof.scrollElementToCenter('${ESCAPED_SELECTOR}')" {{SESSION_ARG}} >/dev/null 2>&1
+    agent-browser wait 300 {{SESSION_ARG}} >/dev/null 2>&1
+  else
+    SCROLL_WAIT=$((SCROLL_DUR + 200))
+    agent-browser wait "$SCROLL_WAIT" {{SESSION_ARG}} >/dev/null 2>&1
+  fi
+fi
+
+# Get element bounding box without interacting with it
+if [[ "$SELECTOR" == @* ]]; then
+  # For @ref: use agent-browser get styles --json which returns bounding box
+  STYLES=$(agent-browser get styles "$SELECTOR" --json {{SESSION_ARG}} 2>&1) || true
+  EL_X=$(echo "$STYLES" | grep -o '"x":[0-9.-]*' | head -1 | cut -d: -f2)
+  EL_Y=$(echo "$STYLES" | grep -o '"y":[0-9.-]*' | head -1 | cut -d: -f2)
+  EL_WIDTH=$(echo "$STYLES" | grep -o '"width":[0-9.-]*' | head -1 | cut -d: -f2)
+  EL_HEIGHT=$(echo "$STYLES" | grep -o '"height":[0-9.-]*' | head -1 | cut -d: -f2)
+
+  if [ -z "$EL_X" ] || [ -z "$EL_Y" ] || [ -z "$EL_WIDTH" ] || [ -z "$EL_HEIGHT" ]; then
+    # Last resort: just click without animation
+    agent-browser click "$SELECTOR" {{SESSION_ARG}} >/dev/null 2>&1
+    echo "clicked $SELECTOR (no animation - could not get position)"
+    exit 0
+  fi
+else
+  BOX=$(agent-browser eval "JSON.stringify(window.__agexEffects.proof.getBoundingBox('${ESCAPED_SELECTOR}'))" {{SESSION_ARG}} 2>&1) || true
+  if [ -z "$BOX" ] || [[ "$BOX" == "null" ]] || [[ "$BOX" == *"error"* ]]; then
+    echo "element not found: $SELECTOR"
+    exit 1
+  fi
+  EL_X=$(echo "$BOX" | grep -o '"x":[0-9.-]*' | cut -d: -f2)
+  EL_Y=$(echo "$BOX" | grep -o '"y":[0-9.-]*' | cut -d: -f2)
+  EL_WIDTH=$(echo "$BOX" | grep -o '"width":[0-9.-]*' | cut -d: -f2)
+  EL_HEIGHT=$(echo "$BOX" | grep -o '"height":[0-9.-]*' | cut -d: -f2)
+fi
+
+# Click target: element center
+CLICK_X=$(echo "$EL_X + $EL_WIDTH / 2" | bc -l)
+CLICK_Y=$(echo "$EL_Y + $EL_HEIGHT / 2" | bc -l)
+
+# Cursor target: center of element
+TARGET_X=$CLICK_X
+TARGET_Y=$CLICK_Y
+
+# Start animation (fire-and-forget via requestAnimationFrame) and get duration synchronously
+ANIM_DURATION=$(agent-browser eval "'' + window.__agexEffects.cursor.animateToPosition(${TARGET_X}, ${TARGET_Y})" {{SESSION_ARG}} 2>/dev/null)
+
+# Parse duration
+ANIM_DURATION=$(echo "$ANIM_DURATION" | tr -d '[:space:]"')
+if [ -z "$ANIM_DURATION" ] || [ "$ANIM_DURATION" = "0" ]; then
+  ANIM_DURATION=2000
+fi
+
+# Wait for animation to complete + pause so viewer can see the target
+WAIT_MS=$((ANIM_DURATION + 300))
+agent-browser wait "$WAIT_MS" {{SESSION_ARG}} >/dev/null 2>&1
+agent-browser wait 1000 {{SESSION_ARG}} >/dev/null 2>&1
+
+# Re-measure element position right before clicking (it may have moved during animation)
+if [[ "$SELECTOR" == @* ]]; then
+  STYLES2=$(agent-browser get styles "$SELECTOR" --json {{SESSION_ARG}} 2>&1) || true
+  EL_X2=$(echo "$STYLES2" | grep -o '"x":[0-9.-]*' | head -1 | cut -d: -f2)
+  EL_Y2=$(echo "$STYLES2" | grep -o '"y":[0-9.-]*' | head -1 | cut -d: -f2)
+  EL_W2=$(echo "$STYLES2" | grep -o '"width":[0-9.-]*' | head -1 | cut -d: -f2)
+  EL_H2=$(echo "$STYLES2" | grep -o '"height":[0-9.-]*' | head -1 | cut -d: -f2)
+  if [ -n "$EL_X2" ] && [ -n "$EL_Y2" ] && [ -n "$EL_W2" ] && [ -n "$EL_H2" ]; then
+    CLICK_X=$(echo "$EL_X2 + $EL_W2 / 2" | bc -l)
+    CLICK_Y=$(echo "$EL_Y2 + $EL_H2 / 2" | bc -l)
+  fi
+else
+  BOX2=$(agent-browser eval "JSON.stringify(window.__agexEffects.proof.getBoundingBox('${ESCAPED_SELECTOR}'))" {{SESSION_ARG}} 2>&1) || true
+  if [ -n "$BOX2" ] && [[ "$BOX2" != "null" ]] && [[ "$BOX2" != *"error"* ]]; then
+    EL_X2=$(echo "$BOX2" | grep -o '"x":[0-9.-]*' | cut -d: -f2)
+    EL_Y2=$(echo "$BOX2" | grep -o '"y":[0-9.-]*' | cut -d: -f2)
+    EL_W2=$(echo "$BOX2" | grep -o '"width":[0-9.-]*' | cut -d: -f2)
+    EL_H2=$(echo "$BOX2" | grep -o '"height":[0-9.-]*' | cut -d: -f2)
+    if [ -n "$EL_X2" ] && [ -n "$EL_Y2" ] && [ -n "$EL_W2" ] && [ -n "$EL_H2" ]; then
+      CLICK_X=$(echo "$EL_X2 + $EL_W2 / 2" | bc -l)
+      CLICK_Y=$(echo "$EL_Y2 + $EL_H2 / 2" | bc -l)
+    fi
+  fi
+fi
+
+# Snap cursor to fresh position so ripple lands on the actual element
+agent-browser eval "window.__agexEffects.cursor.setPosition(${CLICK_X}, ${CLICK_Y})" {{SESSION_ARG}} >/dev/null 2>&1
+
+# Show click ripple and perform the actual click
+agent-browser eval "window.__agexEffects.cursor.showClick(${CLICK_X}, ${CLICK_Y})" {{SESSION_ARG}} >/dev/null 2>&1
+agent-browser click "$SELECTOR" {{SESSION_ARG}} >/dev/null 2>&1
+
+# Sync _lastPos to the actual click position
+# so the next animateToPosition starts from where the native mouse really is
+agent-browser eval "window.__agexEffects.cursor._lastPos = { x: ${CLICK_X}, y: ${CLICK_Y} }" {{SESSION_ARG}} >/dev/null 2>&1
+
+# Fade cursor out
+agent-browser eval "window.__agexEffects.cursor.fadeOut()" {{SESSION_ARG}} >/dev/null 2>&1
+
+agent-browser wait 450 {{SESSION_ARG}} >/dev/null 2>&1
+
+echo "clicked $SELECTOR"

package/assets/scripts/ab-close.sh

@@ -13,11 +13,11 @@ deduplicate_video() {
   
   echo "Removing duplicate frames (output fps: $fps)..."
   # Suppress ffmpeg/ffprobe progress output (extremely verbose, confuses agent)
-  if ffmpeg -y -i "$input" -vf "mpdecimate,setpts=N/FRAME_RATE/TB" -r "$fps" -c:v libx264 "$output" 2>/dev/null; then
+  if ffmpeg -y -i "$input" -vf "mpdecimate=hi=200:lo=100:frac=0.1:max=8,setpts=N/FRAME_RATE/TB" -r "$fps" -c:v libx264 -crf 18 -preset slow -pix_fmt yuv420p -minrate 500k -maxrate 5M -bufsize 2M "$output" 2>/dev/null; then
     local orig_frames=$(ffprobe -v error -count_frames -select_streams v:0 -show_entries stream=nb_read_frames -of default=noprint_wrappers=1:nokey=1 "$input" 2>/dev/null)
     local new_frames=$(ffprobe -v error -count_frames -select_streams v:0 -show_entries stream=nb_read_frames -of default=noprint_wrappers=1:nokey=1 "$output" 2>/dev/null)
     echo "Deduplicated: $orig_frames -> $new_frames frames"
-    rm -f "$input"
+    # Keep raw video for debugging (don't delete $input)
     return 0
   else
     echo "Warning: deduplication failed, keeping original"
@@ -97,7 +97,7 @@ else
   fi
   
   # Run ffmpeg with crossfade
-  FFMPEG_CMD="ffmpeg $INPUTS -filter_complex \"$FILTER\" $OUTPUT_MAP -y \"{{RAW_VIDEO_PATH}}\""
+  FFMPEG_CMD="ffmpeg $INPUTS -filter_complex \"$FILTER\" $OUTPUT_MAP -c:v libx264 -crf 18 -preset slow -pix_fmt yuv420p -minrate 500k -maxrate 5M -bufsize 2M -y \"{{RAW_VIDEO_PATH}}\""
   
   # Suppress ffmpeg progress output (extremely verbose, confuses agent)
   if eval "$FFMPEG_CMD" 2>/dev/null; then

package/assets/scripts/ab-record-start.sh

@@ -8,8 +8,8 @@ SEGMENT_PATH="{{SEGMENTS_DIR}}/$SEGMENT_NAME"
 
 agent-browser record start "$SEGMENT_PATH" {{SESSION_ARG}}
 
-# RE-INJECT init script after recording starts (recording causes page context change)
-# stdout suppressed to avoid echoing JS source back to agent
+# Recording creates a fresh browser context — restore viewport + zoom + effects
+agent-browser set viewport {{VIEWPORT_WIDTH}} {{VIEWPORT_HEIGHT}} {{SESSION_ARG}}
 agent-browser eval --stdin {{SESSION_ARG}} < "{{INIT_SCRIPT_PATH}}" >/dev/null
 
 # Wait to capture initial frame

package/assets/scripts/ab-record.sh

@@ -19,8 +19,8 @@ SEGMENT_PATH="{{SEGMENTS_DIR}}/$SEGMENT_NAME"
 agent-browser record start "$SEGMENT_PATH" {{SESSION_ARG}}
 echo "Recording segment $SEGMENT_NAME: $TITLE"
 
-# RE-INJECT init script after recording starts (recording causes page context change)
-# stdout suppressed to avoid echoing JS source back to agent
+# Recording creates a fresh browser context — restore viewport + zoom + effects
+agent-browser set viewport {{VIEWPORT_WIDTH}} {{VIEWPORT_HEIGHT}} {{SESSION_ARG}}
 agent-browser eval --stdin {{SESSION_ARG}} < "{{INIT_SCRIPT_PATH}}" >/dev/null
 
 # Inject title overlay

package/assets/scripts/ab-toggle-animations.sh

@@ -0,0 +1,15 @@
+#!/bin/bash
+# Enable or disable CSS animations and transitions on the page.
+# Preserves agex visual effects.
+# Usage: ab-toggle-animations true|false
+#   true  = enable animations (default browser behavior)
+#   false = disable animations
+ENABLED="${1:-true}"
+{{FX_INJECT_HELPER}}
+if [ "$ENABLED" = "false" ]; then
+  agent-browser eval "window.__agexEffects.setPageAnimations(false)" {{SESSION_ARG}} >/dev/null 2>&1
+  echo "page animations disabled"
+else
+  agent-browser eval "window.__agexEffects.setPageAnimations(true)" {{SESSION_ARG}} >/dev/null 2>&1
+  echo "page animations enabled"
+fi

package/assets/scripts/ab-type.sh

@@ -0,0 +1,39 @@
+#!/bin/bash
+# Smooth type: moves cursor to input, clicks to focus, then types text slowly
+# Uses ab-click for the animated cursor movement + click
+# Usage: ab-type <selector|@ref> "text"
+SELECTOR="$1"
+TEXT="$2"
+if [ -z "$SELECTOR" ] || [ -z "$TEXT" ]; then
+  echo "Usage: ab-type <selector|@ref> \"text\""
+  exit 1
+fi
+
+# Move cursor to input and click to focus (animated)
+ab-click "$SELECTOR"
+
+# Show glow focus effect on the input
+ESCAPED_SEL=$(printf '%s' "$SELECTOR" | sed "s/'/\\\\'/g")
+agent-browser eval "window.__agexEffects.cursor.showInputFocus('${ESCAPED_SEL}')" {{SESSION_ARG}} >/dev/null 2>&1
+
+# Lock demo cursor so native mouse moves during typing don't cause jumps
+agent-browser eval "if(window.__agexCursor) window.__agexCursor.setAnimationLock(true)" {{SESSION_ARG}} >/dev/null 2>&1
+
+# Type text one character at a time with a human-like delay
+LENGTH=${#TEXT}
+for (( i=0; i<LENGTH; i++ )); do
+  CHAR="${TEXT:$i:1}"
+  agent-browser type "$SELECTOR" "$CHAR" {{SESSION_ARG}} >/dev/null 2>&1
+  agent-browser wait 70 {{SESSION_ARG}} >/dev/null 2>&1
+done
+
+# Brief pause so viewer can read the typed text
+agent-browser wait 400 {{SESSION_ARG}} >/dev/null 2>&1
+
+# Clear glow focus effect
+agent-browser eval "window.__agexEffects.cursor.clearInputFocus()" {{SESSION_ARG}} >/dev/null 2>&1
+
+# Unlock demo cursor
+agent-browser eval "if(window.__agexCursor) window.__agexCursor.setAnimationLock(false)" {{SESSION_ARG}} >/dev/null 2>&1
+
+echo "typed \"$TEXT\" into $SELECTOR"

package/assets/scripts/agent-browser-wrapper.sh

@@ -1,5 +1,6 @@
 #!/bin/bash
-# Auto-inject --session for all agent-browser commands
+# Auto-inject --session and ensure daemon discovery works
+export AGENT_BROWSER_HOME="{{AGENT_BROWSER_HOME}}"
 for arg in "$@"; do
   [ "$arg" = "--session" ] && exec "{{REAL_AGENT_BROWSER}}" "$@"
 done

package/assets/scripts/fx-highlight.sh

@@ -13,14 +13,22 @@ fi
 # Escape label for JS (handle quotes and backslashes)
 ESCAPED_LABEL=$(printf '%s' "$LABEL" | sed "s/\\\\/\\\\\\\\/g; s/'/\\\\'/g")
 
+{{FX_INJECT_HELPER}}
+
 if [[ "$SELECTOR" == @* ]]; then
-  # @ref format - use agent-browser get box to get element position
-  BOX=$(agent-browser get box "$SELECTOR" {{SESSION_ARG}} 2>&1) || true
-  if [ -z "$BOX" ] || [[ "$BOX" == *"error"* ]]; then
+  # @ref format - use get styles --json (get box does NOT support @ref)
+  STYLES=$(agent-browser get styles "$SELECTOR" --json {{SESSION_ARG}} 2>&1) || true
+  EL_X=$(echo "$STYLES" | grep -o '"x":[0-9.-]*' | head -1 | cut -d: -f2)
+  EL_Y=$(echo "$STYLES" | grep -o '"y":[0-9.-]*' | head -1 | cut -d: -f2)
+  EL_WIDTH=$(echo "$STYLES" | grep -o '"width":[0-9.-]*' | head -1 | cut -d: -f2)
+  EL_HEIGHT=$(echo "$STYLES" | grep -o '"height":[0-9.-]*' | head -1 | cut -d: -f2)
+
+  if [ -z "$EL_X" ] || [ -z "$EL_Y" ] || [ -z "$EL_WIDTH" ] || [ -z "$EL_HEIGHT" ]; then
     echo "Element not found: $SELECTOR"
     exit 1
   fi
 
+  BOX="{\"x\":$EL_X,\"y\":$EL_Y,\"width\":$EL_WIDTH,\"height\":$EL_HEIGHT}"
   agent-browser eval {{SESSION_ARG}} "window.__agexEffects.proof.highlightBox($BOX,'${ESCAPED_LABEL}','$COLOR')" 2>&1 || true
 else
   # CSS selector - use effects.js

package/assets/scripts/fx-subtitle.sh

@@ -0,0 +1,14 @@
+#!/bin/bash
+TEXT="$1"
+DURATION="${2:-0}"
+POSITION="${3:-bottom}"
+FG="${4:-}"
+BG="${5:-}"
+if [ -z "$TEXT" ]; then
+  echo "Usage: fx-subtitle <text> [duration_ms] [position] [fg_color] [bg_color]"
+  exit 1
+fi
+{{FX_INJECT_HELPER}}
+agent-browser eval {{SESSION_ARG}} "window.__agexEffects.narration.clear()"
+ESCAPED_TEXT=$(printf '%s' "$TEXT" | sed "s/'/\\\\'/g")
+agent-browser eval {{SESSION_ARG}} "window.__agexEffects.narration.showSubtitle('${ESCAPED_TEXT}',${DURATION},'${POSITION}','${FG}','${BG}')"

package/dist/{chunk-FCCNIKUD.js → chunk-EL4QILVU.js}

@@ -49,8 +49,10 @@ var ValidationError = class extends AgexError {
 };
 var SkillInstallError = class extends AgexError {
   skill;
-  constructor(skill, cause) {
-    super(`Failed to install skill: ${skill}`, "SKILL_INSTALL_ERROR", cause);
+  constructor(skill, detail, cause) {
+    const msg = detail ? `Failed to install skill: ${skill}
+${detail}` : `Failed to install skill: ${skill}`;
+    super(msg, "SKILL_INSTALL_ERROR", cause);
     this.name = "SkillInstallError";
     this.skill = skill;
   }
@@ -140,7 +142,7 @@ var DEFAULTS = {
   // Browser / video
   VIEWPORT_WIDTH: 1920,
   VIEWPORT_HEIGHT: 1080,
-  DEDUP_FPS: 5,
+  DEDUP_FPS: 24,
   XFADE_DURATION_SEC: 0.3,
   // Git truncation limits
   GIT_DIFF_MAX_LINES: 100,
@@ -4713,6 +4715,14 @@ function extractToolResult(toolCall) {
           stderr: error.stderr ?? error.message
         };
       }
+      const failure = result.failure;
+      if (failure) {
+        return {
+          exitCode: failure.exitCode ?? 1,
+          stdout: failure.stdout,
+          stderr: failure.stderr ?? failure.message
+        };
+      }
     }
   }
   return null;
@@ -5457,11 +5467,15 @@ function getScriptEntries(videoEnabled) {
     { outputName: "fx-spotlight", scriptFile: "fx-spotlight.sh" },
     { outputName: "fx-circle", scriptFile: "fx-circle.sh" },
     { outputName: "fx-arrow", scriptFile: "fx-arrow.sh" },
+    { outputName: "fx-subtitle", scriptFile: "fx-subtitle.sh" },
     { outputName: "fx-clear", scriptFile: "fx-clear.sh" },
     { outputName: "fx-wait", scriptFile: "fx-wait.sh" },
     { outputName: "ab-proof", scriptFile: "ab-proof.sh" },
     { outputName: "ab-not-found", scriptFile: "ab-not-found.sh" },
     { outputName: "ab-move", scriptFile: "ab-move.sh" },
+    { outputName: "ab-click", scriptFile: "ab-click.sh" },
+    { outputName: "ab-type", scriptFile: "ab-type.sh" },
+    { outputName: "ab-toggle-animations", scriptFile: "ab-toggle-animations.sh" },
     { outputName: "agent-browser", scriptFile: "agent-browser-wrapper.sh" }
   ];
 }
@@ -5474,19 +5488,40 @@ function loadAndRenderScript(scriptFile, vars) {
 var log8 = createLogger("browse");
 function resolveAgentBrowser() {
   try {
-    const resolved = execSync2("which agent-browser", { encoding: "utf-8" }).trim();
-    log8.debug(`resolved agent-browser: ${resolved}`);
-    return resolved;
+    const binPath = execSync2("which agent-browser", { encoding: "utf-8" }).trim();
+    log8.debug(`resolved agent-browser: ${binPath}`);
+    let home;
+    const binDir = path4.dirname(binPath);
+    const npmGlobalCandidate = path4.join(binDir, "..", "lib", "node_modules", "agent-browser");
+    if (fs3.existsSync(path4.join(npmGlobalCandidate, "package.json"))) {
+      home = path4.resolve(npmGlobalCandidate);
+    }
+    if (!home) {
+      try {
+        const realBin = fs3.realpathSync(binPath);
+        let dir = path4.dirname(realBin);
+        for (let i = 0; i < 5; i++) {
+          if (fs3.existsSync(path4.join(dir, "package.json"))) {
+            home = dir;
+            break;
+          }
+          dir = path4.dirname(dir);
+        }
+      } catch {
+      }
+    }
+    log8.debug(`agent-browser home: ${home ?? "not found"}`);
+    return { bin: binPath, home };
   } catch {
     log8.warn("agent-browser not found in PATH, using bare command name");
-    return "agent-browser";
+    return { bin: "agent-browser" };
   }
 }
 function buildFxInjectHelper(sessionArg, initScriptPath) {
   return `
-# Ensure effects are loaded (check may fail if page not ready \u2014 that's ok)
-if ! agent-browser eval ${sessionArg} "!!window.__agexEffects" 2>&1 | grep -q "true"; then
-  agent-browser eval --stdin ${sessionArg} < "${initScriptPath}" >/dev/null
+# Ensure effects are loaded (re-inject if not present)
+if ! agent-browser eval ${sessionArg} "!!window.__agexEffects" 2>/dev/null | grep -q "true"; then
+  agent-browser eval --stdin ${sessionArg} < "${initScriptPath}" >/dev/null || { echo "Error: failed to inject effects (is browser session running?)" >&2; exit 1; }
 fi`;
 }
 function buildTemplateVars(config, tempDir, sessionId, initScriptPath) {
@@ -5498,7 +5533,7 @@ function buildTemplateVars(config, tempDir, sessionId, initScriptPath) {
   const rawVideoPath = path4.join(outputDir, "recording-raw.webm");
   const finalVideoPath = path4.join(outputDir, "recording.mp4");
   const sessionArg = `--session ${sessionId}`;
-  const realAgentBrowser = resolveAgentBrowser();
+  const agentBrowser = resolveAgentBrowser();
   return {
     SESSION_ID: sessionId,
     SESSION_ARG: sessionArg,
@@ -5512,7 +5547,8 @@ function buildTemplateVars(config, tempDir, sessionId, initScriptPath) {
     RAW_VIDEO_PATH: rawVideoPath,
     FINAL_VIDEO_PATH: finalVideoPath,
     DEDUP_FPS: String(DEFAULTS.DEDUP_FPS),
-    REAL_AGENT_BROWSER: realAgentBrowser,
+    REAL_AGENT_BROWSER: agentBrowser.bin,
+    AGENT_BROWSER_HOME: agentBrowser.home ?? "",
     FX_INJECT_HELPER: buildFxInjectHelper(sessionArg, initScriptPath),
     VIDEO_MKDIR: videoEnabled ? `mkdir -p "${segmentsDir}"` : "# video recording disabled",
     VIDEO_INIT_COUNTER: videoEnabled ? `echo "0" > "${segmentCounterPath}"` : "",
@@ -5542,13 +5578,17 @@ function createWorkspaceFiles(config) {
   const initScriptPath = writeInitScript(tempDir, config);
   const vars = buildTemplateVars(config, tempDir, sessionId, initScriptPath);
   writeScripts(tempDir, vars, videoEnabled);
+  const cursorDir = path4.join(tempDir, ".cursor");
+  fs3.mkdirSync(cursorDir, { recursive: true });
+  fs3.writeFileSync(path4.join(cursorDir, "mcp.json"), JSON.stringify({ mcpServers: {} }));
   const wrapperPath = path4.join(tempDir, "ab-fx");
   return {
     workspacePath: tempDir,
     initScriptPath,
     injectEffectsCommand: wrapperPath,
     env: {
-      AGENT_BROWSER_SESSION: sessionId
+      AGENT_BROWSER_SESSION: sessionId,
+      ...vars.AGENT_BROWSER_HOME ? { AGENT_BROWSER_HOME: vars.AGENT_BROWSER_HOME } : {}
     },
     cleanup: () => {
       try {
@@ -5659,7 +5699,7 @@ EXAMPLE - FAIL case: Verifying "dropdown has Options A, B, and C" but B is missi
 # === PHASE 1: EXPLORE ===
 ab-open "https://example.com"
 agent-browser snapshot -i
-agent-browser click @dropdownButton
+ab-click @dropdownButton
 agent-browser wait 500
 agent-browser snapshot -i
 # See: link "Option A" [ref=e5], link "Option C" [ref=e7]
@@ -5670,7 +5710,7 @@ agent-browser eval 'document.body.textContent.includes("Option B") ? "found" : "
 
 # === PHASE 2: RECORD (document the FAILURE - RED highlight is PRIMARY!) ===
 ab-record-start
-agent-browser click @dropdownButton
+ab-click @dropdownButton
 agent-browser wait 500
 agent-browser snapshot -i
 # CRITICAL: For FAIL, highlight the MISSING element FIRST (this is your evidence!)
@@ -5689,6 +5729,8 @@ COMMANDS:
   ab-record-start                  # Start recording
   ab-close [1 2 ...]               # Stop recording and merge segments
   ab-screenshot <name>.png         # Capture screenshot
+  ab-click <selector|@ref>         # Smooth cursor animation + click
+  ab-type <selector|@ref> "text"   # Click input + type text slowly (triggers React events)
 
 EFFECTS (use AFTER ab-record-start):
   fx-highlight <selector> "label" [color]   # Highlight element with label
@@ -5747,6 +5789,20 @@ For elements WITH @ref:
   agent-browser get attr @e5 aria-label   # Get aria-label
   agent-browser get styles @e5 --json     # Get tag name from "tag" field
 
+TYPING INTO INPUTS:
+  ALWAYS use ab-type or agent-browser fill to type into inputs.
+  NEVER set .value via eval \u2014 it does NOT trigger React/framework events and buttons stay disabled.
+  ab-type @e1 "text"                  # Best: animated cursor + slow typing (triggers all events)
+  agent-browser fill @e1 "text"       # Instant replace (clears existing text)
+
+  IMPORTANT: ab-type APPENDS text \u2014 it does NOT clear existing content.
+  If the input already has text and you want to REPLACE it, clear first:
+    agent-browser fill @e1 "text"       # Easiest: instant replace
+    # OR for animated typing with clear:
+    ab-click @e1                        # Focus the input
+    agent-browser key @e1 Meta+a        # Select all existing text
+    ab-type @e1 "new text"              # First char replaces selection, rest appends
+
 BROWSER:
   agent-browser snapshot              # Get ALL elements with refs
   agent-browser snapshot -i           # Interactive only (buttons, links, inputs)
@@ -5755,8 +5811,8 @@ BROWSER:
   agent-browser snapshot -s "#id"     # Scope to CSS selector
   agent-browser scrollintoview @e1    # Smooth scroll to element
   agent-browser wait <ms>             # Wait milliseconds
-  agent-browser click @e1             # Click element
-  agent-browser eval '<js>'           # Run JavaScript
+  ab-click @e1                        # Click element (smooth cursor animation)
+  agent-browser eval '<js>'           # Run JavaScript (NOT for typing into inputs!)
 
 SNAPSHOT TIPS:
 - Use snapshot (no flags) when looking for VISUAL elements (images, logos, text)
@@ -5809,7 +5865,8 @@ function parseVerdict(output) {
   if (matches.length === 0) {
     return { verdict: "fail", reason: "No verdict found in output" };
   }
-  const lastMatch = matches[matches.length - 1];
+  const real = matches.filter((m) => !(m[2] ?? "").includes("PROVE_VERDICT"));
+  const lastMatch = real.length > 0 ? real[real.length - 1] : matches[matches.length - 1];
   return {
     verdict: lastMatch[1].toLowerCase(),
     reason: lastMatch[2]?.trim() || ""
@@ -5832,14 +5889,14 @@ function installSkills(workspacePath, agent, skills) {
       });
       log9.debug(`installed skill: ${skill}`);
     } catch (err) {
-      const error = new SkillInstallError(skill, err instanceof Error ? err : void 0);
+      const detail = (err?.stderr ?? err?.stdout)?.toString().trim() || err?.message || "";
+      const error = new SkillInstallError(skill, detail, err instanceof Error ? err : void 0);
       log9.warn(error.message);
     }
   }
 }
 var DEFAULT_SKILLS = ["vercel-labs/agent-browser@agent-browser"];
 var DEFAULT_OPTIONS = {
-  agent: DEFAULTS.AGENT,
   outputDir: "./prove-results",
   video: true,
   screenshots: true,
@@ -5858,7 +5915,8 @@ async function prove(assertion, options = {}) {
     throw new ValidationError("Assertion cannot be empty", "assertion");
   }
   const opts = { ...DEFAULT_OPTIONS, ...options };
-  const agent = opts.agent;
+  const adapter = opts.agent ? getAdapter(opts.agent) : await findAvailableAgent();
+  const agent = adapter.name;
   const outputDir = createOutputDir(opts.outputDir, agent, assertion);
   log9.info(`proving: "${assertion}" (agent=${agent})`);
   const browserConfig = {
@@ -6098,12 +6156,14 @@ function normalizeReviewOutput(output) {
 async function runReview(request) {
   const hypothesesCount = request.hypotheses ?? DEFAULTS.HYPOTHESES_COUNT;
   const includeWorktree = request.includeWorktree ?? true;
-  log11.info(`reviewing: base=${request.baseRef} agent=${request.agent} hypotheses=${hypothesesCount}`);
+  const adapter = request.agent ? getAdapter(request.agent) : await findAvailableAgent();
+  const agent = adapter.name;
+  log11.info(`reviewing: base=${request.baseRef} agent=${agent} hypotheses=${hypothesesCount}`);
   const gitContext = await buildGitContext(request.baseRef, includeWorktree, request.cwd);
   const planPrompt = buildPlanPrompt(gitContext, hypothesesCount, request.promptHint);
   log11.debug("generating review plan...");
   const plan = await runAgent({
-    agent: request.agent,
+    agent,
     model: request.model,
     prompt: planPrompt,
     cwd: request.cwd,
@@ -6112,7 +6172,7 @@ async function runReview(request) {
   });
   log11.debug("executing review...");
   const execution = await runAgent({
-    agent: request.agent,
+    agent,
     model: request.model,
     prompt: plan.json.stdout,
     cwd: request.cwd,
@@ -6121,7 +6181,7 @@ async function runReview(request) {
   });
   const outputJson = {
     baseRef: request.baseRef,
-    agent: request.agent,
+    agent,
     model: request.model,
     plan: plan.json,
     execution: execution.json
@@ -6170,7 +6230,7 @@ HELPER SCRIPTS:
 
 AGENT-BROWSER COMMANDS:
 - agent-browser snapshot -i          # Get interactive elements with refs (@e1, @e2)
-- agent-browser click @e1            # Click element
+- ab-click @e1                       # Click element (smooth cursor animation)
 - agent-browser fill @e2 "text"      # Fill input
 - agent-browser get text @e1         # Get element text
 - agent-browser eval "<js>"          # Run JavaScript
@@ -6248,13 +6308,15 @@ async function provePr(request) {
   const baseRef = request.baseRef || detectDefaultBranch();
   const outputDir = createOutputDir2(request.outputDir);
   const { width, height } = request.viewport;
-  log12.info(`proving PR: base=${baseRef} agent=${request.agent} hypotheses=${request.hypothesesCount}`);
+  const adapter = request.agent ? getAdapter(request.agent) : await findAvailableAgent();
+  const agent = adapter.name;
+  log12.info(`proving PR: base=${baseRef} agent=${agent} hypotheses=${request.hypothesesCount}`);
   const startTime = Date.now();
   const gitContext = await buildGitContext(baseRef, true);
   log12.debug("generating hypotheses...");
   const planPrompt = buildPlanPrompt(gitContext, request.hypothesesCount, request.hint);
   const planResult = await runAgent({
-    agent: request.agent,
+    agent,
     model: request.model,
     prompt: planPrompt,
     streamOutput: true,
@@ -6276,7 +6338,7 @@ async function provePr(request) {
   const provePrompt = buildProvePrPrompt(gitContext, hypothesesPlan, outputDir, request.url);
   try {
     const proveResult = await runAgent({
-      agent: request.agent,
+      agent,
       model: request.model,
       prompt: provePrompt,
       approveMcps: true,
@@ -6319,7 +6381,7 @@ var viewportSchema2 = external_exports.object({
 });
 var provePrRequestSchema = external_exports.object({
   baseRef: external_exports.string().optional(),
-  agent: external_exports.enum(AGENT_NAMES),
+  agent: external_exports.enum(AGENT_NAMES).optional(),
   url: external_exports.string().url("Invalid URL").optional(),
   outputDir: external_exports.string().min(1, "Output directory cannot be empty"),
   hypothesesCount: external_exports.number().int().positive("Hypotheses count must be a positive integer"),
@@ -6331,14 +6393,25 @@ var provePrRequestSchema = external_exports.object({
 
 export {
   AgexError,
+  ValidationError,
+  SkillInstallError,
   isAgexError,
+  createLogger,
   AGENT_NAMES,
   OUTPUT_MODES,
   APPROVAL_POLICIES,
+  DEFAULTS,
+  external_exports,
   viewportStringSchema,
   validate,
+  slugify,
+  timestamp,
+  buildPathEnv,
   detectDefaultBranch,
+  getAdapter,
+  findAvailableAgent,
   runAgent,
+  createWorkspaceFiles,
   prove,
   proveOptionsSchema,
   runReview,