agex 0.2.4 → 0.2.7

package/assets/scripts/ab-close-disabled.sh

@@ -0,0 +1,5 @@
+#!/bin/bash
+# Closes browser (video recording disabled)
+agent-browser close {{SESSION_ARG}}
+rm -f "{{OUTPUT_DIR}}/.session"
+echo "Browser closed"

package/assets/scripts/ab-close.sh

@@ -0,0 +1,130 @@
+#!/bin/bash
+# Merges video segments with crossfade, removes duplicate frames, and closes browser
+# Usage: ab-close [segment_numbers...]
+# Examples:
+#   ab-close           # Merge all segments
+#   ab-close 1 3 5     # Merge only segments 1, 3, 5
+
+# Remove duplicate/similar frames and create shortened video
+deduplicate_video() {
+  local input="$1"
+  local output="$2"
+  local fps="$3"
+  
+  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
+    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"
+    return 0
+  else
+    echo "Warning: deduplication failed, keeping original"
+    mv "$input" "$output"
+    return 1
+  fi
+}
+
+# Wait to capture final frame before stopping recording
+agent-browser wait 500 {{SESSION_ARG}} 2>&1 || true
+
+# Stop any active recording first (ignore errors if not recording)
+agent-browser record stop {{SESSION_ARG}} 2>&1 || true
+
+# If segment numbers provided, use only those; otherwise use all
+if [ $# -gt 0 ]; then
+  SEGMENTS=()
+  for num in "$@"; do
+    SEGMENT_FILE="{{SEGMENTS_DIR}}/segment-$(printf '%03d' $num).webm"
+    if [ -f "$SEGMENT_FILE" ]; then
+      SEGMENTS+=("$SEGMENT_FILE")
+    else
+      echo "Warning: segment $num not found ($SEGMENT_FILE)"
+    fi
+  done
+  echo "Using specified segments: $@"
+else
+  SEGMENTS=($(ls -1 "{{SEGMENTS_DIR}}"/segment-*.webm 2>/dev/null | sort))
+fi
+SEGMENT_COUNT=${#SEGMENTS[@]}
+
+if [ "$SEGMENT_COUNT" -eq "0" ]; then
+  echo "No video segments to merge"
+elif [ "$SEGMENT_COUNT" -eq "1" ]; then
+  echo "Single segment, processing..."
+  cp "${SEGMENTS[0]}" "{{RAW_VIDEO_PATH}}"
+  deduplicate_video "{{RAW_VIDEO_PATH}}" "{{FINAL_VIDEO_PATH}}" {{DEDUP_FPS}}
+  echo "Video saved: {{FINAL_VIDEO_PATH}}"
+  rm -rf "{{SEGMENTS_DIR}}"
+else
+  echo "Merging $SEGMENT_COUNT video segments with crossfade..."
+  
+  # Build ffmpeg filter for crossfade between all segments
+  # Crossfade duration in seconds
+  XFADE_DURATION=0.3
+  
+  # Build input args and filter
+  INPUTS=""
+  FILTER=""
+  
+  for i in "${!SEGMENTS[@]}"; do
+    INPUTS="$INPUTS -i \"${SEGMENTS[$i]}\""
+  done
+  
+  # For 2 segments: simple crossfade
+  # For N segments: chain crossfades
+  if [ "$SEGMENT_COUNT" -eq "2" ]; then
+    FILTER="[0:v][1:v]xfade=transition=fade:duration=$XFADE_DURATION:offset=0[outv];[0:a][1:a]acrossfade=d=$XFADE_DURATION[outa]"
+    OUTPUT_MAP="-map [outv] -map [outa]"
+  else
+    # Build chain: xfade 0+1 -> tmp1, xfade tmp1+2 -> tmp2, etc.
+    PREV="0:v"
+    PREV_A="0:a"
+    for ((i=1; i<SEGMENT_COUNT; i++)); do
+      if [ $i -eq $((SEGMENT_COUNT-1)) ]; then
+        # Last crossfade outputs to final
+        FILTER="$FILTER[$PREV][$i:v]xfade=transition=fade:duration=$XFADE_DURATION:offset=0[outv];"
+        FILTER="$FILTER[$PREV_A][$i:a]acrossfade=d=$XFADE_DURATION[outa]"
+      else
+        FILTER="$FILTER[$PREV][$i:v]xfade=transition=fade:duration=$XFADE_DURATION:offset=0[tmp$i];"
+        FILTER="$FILTER[$PREV_A][$i:a]acrossfade=d=$XFADE_DURATION[tmpa$i];"
+        PREV="tmp$i"
+        PREV_A="tmpa$i"
+      fi
+    done
+    OUTPUT_MAP="-map [outv] -map [outa]"
+  fi
+  
+  # Run ffmpeg with crossfade
+  FFMPEG_CMD="ffmpeg $INPUTS -filter_complex \"$FILTER\" $OUTPUT_MAP -y \"{{RAW_VIDEO_PATH}}\""
+  
+  # Suppress ffmpeg progress output (extremely verbose, confuses agent)
+  if eval "$FFMPEG_CMD" 2>/dev/null; then
+    echo "Video merged with crossfade"
+    deduplicate_video "{{RAW_VIDEO_PATH}}" "{{FINAL_VIDEO_PATH}}" {{DEDUP_FPS}}
+    echo "Video saved: {{FINAL_VIDEO_PATH}}"
+    rm -rf "{{SEGMENTS_DIR}}"
+  else
+    # Fallback to simple concat if crossfade fails
+    echo "Crossfade failed, trying simple concat..."
+    CONCAT_LIST="{{SEGMENTS_DIR}}/concat.txt"
+    for f in "${SEGMENTS[@]}"; do
+      echo "file '$f'"
+    done > "$CONCAT_LIST"
+    
+    # Suppress ffmpeg progress output
+    if ffmpeg -f concat -safe 0 -i "$CONCAT_LIST" -c copy "{{RAW_VIDEO_PATH}}" -y 2>/dev/null; then
+      echo "Video merged (simple concat)"
+      deduplicate_video "{{RAW_VIDEO_PATH}}" "{{FINAL_VIDEO_PATH}}" {{DEDUP_FPS}}
+      echo "Video saved: {{FINAL_VIDEO_PATH}}"
+      rm -rf "{{SEGMENTS_DIR}}"
+    else
+      echo "Warning: ffmpeg merge failed, keeping segments in {{SEGMENTS_DIR}}"
+    fi
+  fi
+fi
+
+agent-browser close {{SESSION_ARG}}
+rm -f "{{OUTPUT_DIR}}/.session"
+echo "Browser closed"

package/assets/scripts/ab-fx.sh

@@ -0,0 +1,3 @@
+#!/bin/bash
+# agex effects injection wrapper
+agent-browser eval --stdin {{SESSION_ARG}} < "{{INIT_SCRIPT_PATH}}"

package/assets/scripts/ab-move.sh

@@ -0,0 +1,19 @@
+#!/bin/bash
+# Moves the visual cursor to element center
+# Supports @ref (e.g., @e5) or CSS selector
+SELECTOR="$1"
+if [ -z "$SELECTOR" ]; then
+  echo "Usage: ab-move <selector|@ref>"
+  exit 1
+fi
+
+# Use agent-browser hover to move to element (supports @ref via getLocator!)
+HOVER_RESULT=$(agent-browser hover "$SELECTOR" 2>&1)
+if [[ "$HOVER_RESULT" == *"not found"* ]] || [[ "$HOVER_RESULT" == *"Error"* ]]; then
+  echo "element not found: $SELECTOR"
+  exit 1
+fi
+
+# Sync our visual cursor to the mouse position (hover moved mouse to element center)
+agent-browser eval "window.__agexCursor && window.__agexCursor.sync()" >/dev/null 2>&1
+echo "moved to element"

package/assets/scripts/ab-not-found.sh

@@ -0,0 +1,33 @@
+#!/bin/bash
+# Shows a visual "NOT FOUND" indicator and captures screenshot
+# Usage: ab-not-found "search term" <screenshot.png> [color]
+# Examples:
+#   ab-not-found "Login button" 001-no-login.png
+#   ab-not-found "word 'test'" 002-no-test.png "#ff0000"
+
+SEARCH_TERM="$1"
+SCREENSHOT_NAME="$2"
+COLOR="${3:-#ff4444}"
+
+if [ -z "$SEARCH_TERM" ] || [ -z "$SCREENSHOT_NAME" ]; then
+  echo "Usage: ab-not-found \"search term\" <screenshot.png> [color]"
+  exit 1
+fi
+
+SCREENSHOT_PATH="{{OUTPUT_DIR}}/$SCREENSHOT_NAME"
+
+# Escape search term for JS
+ESCAPED_TERM=$(printf '%s' "$SEARCH_TERM" | sed "s/'/\\\\'/g")
+
+# Create "NOT FOUND" overlay with search term
+agent-browser eval "window.__agexEffects.proof.notFound('${ESCAPED_TERM}','$COLOR')" 2>&1 || true
+
+# Wait for overlay to render
+agent-browser wait 200
+
+# Take screenshot
+agent-browser screenshot "$SCREENSHOT_PATH"
+echo "Screenshot saved: $SCREENSHOT_PATH"
+
+# Clean up overlay after screenshot
+agent-browser eval "window.__agexEffects.proof.clearNotFound()" 2>&1 || true

package/assets/scripts/ab-open.sh

@@ -0,0 +1,17 @@
+#!/bin/bash
+# Opens URL with agex setup (viewport, effects)
+URL="$1"
+if [ -z "$URL" ]; then
+  echo "Usage: ab-open <url>"
+  exit 1
+fi
+# Write session ID to output directory for other scripts to use
+echo "{{SESSION_ID}}" > "{{OUTPUT_DIR}}/.session"
+agent-browser open "$URL" {{SESSION_ARG}} {{HEADED_FLAG}}
+agent-browser set viewport {{VIEWPORT_WIDTH}} {{VIEWPORT_HEIGHT}} {{SESSION_ARG}}
+{{VIDEO_MKDIR}}
+{{VIDEO_INIT_COUNTER}}
+# stdout suppressed to avoid echoing JS source back to agent
+agent-browser eval --stdin {{SESSION_ARG}} < "{{INIT_SCRIPT_PATH}}" >/dev/null
+echo "Browser ready at $URL (session: {{SESSION_ID}})"
+{{VIDEO_READY_MSG}}

package/assets/scripts/ab-proof.sh

@@ -0,0 +1,126 @@
+#!/bin/bash
+# Highlights an element and captures a screenshot that includes the full element
+# Usage: ab-proof <selector|@ref> "label" <screenshot.png> [color]
+# Examples:
+#   ab-proof @e5 "Table of Contents" 001-toc.png
+#   ab-proof "#main-content" "Content verified" 002-content.png "#00ff00"
+
+SELECTOR="$1"
+LABEL="$2"
+SCREENSHOT_NAME="$3"
+COLOR="${4:-#00ff00}"
+
+if [ -z "$SELECTOR" ] || [ -z "$LABEL" ] || [ -z "$SCREENSHOT_NAME" ]; then
+  echo "Usage: ab-proof <selector|@ref> \"label\" <screenshot.png> [color]"
+  exit 1
+fi
+
+SCREENSHOT_PATH="{{OUTPUT_DIR}}/$SCREENSHOT_NAME"
+PADDING=20
+
+# Get viewport dimensions
+VIEWPORT_WIDTH={{VIEWPORT_WIDTH}}
+VIEWPORT_HEIGHT={{VIEWPORT_HEIGHT}}
+
+# Escape label for JS
+ESCAPED_LABEL=$(printf '%s' "$LABEL" | sed "s/'/\\\\'/g")
+
+# Get element bounding box
+if [[ "$SELECTOR" == @* ]]; then
+  BOX=$(agent-browser get box "$SELECTOR" 2>&1) || true
+else
+  ESCAPED_SELECTOR=$(printf '%s' "$SELECTOR" | sed "s/'/\\\\'/g")
+  BOX=$(agent-browser eval "JSON.stringify(window.__agexEffects.proof.getBoundingBox('${ESCAPED_SELECTOR}'))" 2>&1) || true
+fi
+
+if [ -z "$BOX" ] || [[ "$BOX" == "null" ]] || [[ "$BOX" == *"error"* ]]; then
+  echo "Element not found: $SELECTOR"
+  exit 1
+fi
+
+# Parse bounding box (support negative values)
+EL_X=$(echo "$BOX" | grep -o '"x":[0-9.-]*' | cut -d: -f2 | cut -d. -f1)
+EL_Y=$(echo "$BOX" | grep -o '"y":[0-9.-]*' | cut -d: -f2 | cut -d. -f1)
+EL_WIDTH=$(echo "$BOX" | grep -o '"width":[0-9.-]*' | cut -d: -f2 | cut -d. -f1)
+EL_HEIGHT=$(echo "$BOX" | grep -o '"height":[0-9.-]*' | cut -d: -f2 | cut -d. -f1)
+
+# Account for label height (approx 50px below element)
+LABEL_HEIGHT=50
+TOTAL_HEIGHT=$((EL_HEIGHT + LABEL_HEIGHT + PADDING * 2))
+TOTAL_WIDTH=$((EL_WIDTH + PADDING * 2))
+
+# Scroll element into view (centered)
+if [[ "$SELECTOR" == @* ]]; then
+  agent-browser eval "window.__agexEffects.proof.scrollToCoords($EL_Y,$VIEWPORT_HEIGHT,$EL_HEIGHT)" 2>&1 || true
+else
+  agent-browser eval "window.__agexEffects.proof.scrollToSelector('${ESCAPED_SELECTOR}')" 2>&1 || true
+fi
+
+# Wait for scroll
+agent-browser wait 200
+
+# Re-get bounding box after scroll (position changed)
+if [[ "$SELECTOR" == @* ]]; then
+  NEW_BOX=$(agent-browser get box "$SELECTOR" 2>&1) || true
+  if [ -n "$NEW_BOX" ] && [[ "$NEW_BOX" != "null" ]] && [[ "$NEW_BOX" != *"error"* ]]; then
+    NEW_X=$(echo "$NEW_BOX" | grep -o '"x":[0-9.-]*' | cut -d: -f2)
+    NEW_Y=$(echo "$NEW_BOX" | grep -o '"y":[0-9.-]*' | cut -d: -f2)
+    if [ -n "$NEW_X" ] && [ -n "$NEW_Y" ]; then
+      BOX="$NEW_BOX"
+    fi
+  fi
+else
+  BOX=$(agent-browser eval "JSON.stringify(window.__agexEffects.proof.getBoundingBox('${ESCAPED_SELECTOR}'))" 2>&1) || true
+fi
+
+# Parse updated bounding box
+EL_X=$(echo "$BOX" | grep -o '"x":[0-9.-]*' | cut -d: -f2 | cut -d. -f1)
+EL_Y=$(echo "$BOX" | grep -o '"y":[0-9.-]*' | cut -d: -f2 | cut -d. -f1)
+EL_WIDTH=$(echo "$BOX" | grep -o '"width":[0-9.-]*' | cut -d: -f2 | cut -d. -f1)
+EL_HEIGHT=$(echo "$BOX" | grep -o '"height":[0-9.-]*' | cut -d: -f2 | cut -d. -f1)
+
+# Apply highlight border + label
+agent-browser eval "window.__agexEffects.proof.highlightProof($BOX,'${ESCAPED_LABEL}','$COLOR')" 2>&1 || true
+
+# Wait for highlight to render
+agent-browser wait 100
+
+# Decide screenshot strategy based on element size vs viewport
+if [ "$TOTAL_HEIGHT" -gt "$VIEWPORT_HEIGHT" ] || [ "$TOTAL_WIDTH" -gt "$VIEWPORT_WIDTH" ]; then
+  # Element larger than viewport - use full page screenshot + crop
+  TEMP_FULL="{{OUTPUT_DIR}}/.temp-full-$$.png"
+
+  agent-browser screenshot "$TEMP_FULL" --full
+
+  # Get scroll position to calculate absolute coords
+  SCROLL_POS=$(agent-browser eval "JSON.stringify(window.__agexEffects.proof.getScrollPosition())" 2>&1) || true
+  SCROLL_X=$(echo "$SCROLL_POS" | grep -o '"x":[0-9.-]*' | cut -d: -f2 | cut -d. -f1)
+  SCROLL_Y=$(echo "$SCROLL_POS" | grep -o '"y":[0-9.-]*' | cut -d: -f2 | cut -d. -f1)
+
+  # Calculate crop region (element position + padding + label)
+  CROP_X=$((SCROLL_X + EL_X - PADDING))
+  CROP_Y=$((SCROLL_Y + EL_Y - PADDING))
+  CROP_WIDTH=$((EL_WIDTH + PADDING * 2))
+  CROP_HEIGHT=$((EL_HEIGHT + PADDING * 2 + LABEL_HEIGHT))
+
+  # Ensure non-negative
+  [ "$CROP_X" -lt 0 ] && CROP_X=0
+  [ "$CROP_Y" -lt 0 ] && CROP_Y=0
+
+  # Try to crop with ImageMagick
+  if command -v convert &> /dev/null; then
+    convert "$TEMP_FULL" -crop "${CROP_WIDTH}x${CROP_HEIGHT}+${CROP_X}+${CROP_Y}" +repage "$SCREENSHOT_PATH"
+    rm -f "$TEMP_FULL"
+    echo "Screenshot saved (cropped): $SCREENSHOT_PATH"
+  else
+    mv "$TEMP_FULL" "$SCREENSHOT_PATH"
+    echo "Screenshot saved (full page, ImageMagick not available for crop): $SCREENSHOT_PATH"
+  fi
+else
+  # Element fits in viewport - take regular screenshot
+  agent-browser screenshot "$SCREENSHOT_PATH"
+  echo "Screenshot saved: $SCREENSHOT_PATH"
+fi
+
+# Clean up highlight after screenshot
+agent-browser eval "window.__agexEffects.proof.clearProof()" 2>&1 || true

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

@@ -0,0 +1,3 @@
+#!/bin/bash
+# Video recording disabled - just run the commands
+eval "$2"

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

@@ -0,0 +1,2 @@
+#!/bin/bash
+echo "Video recording disabled"

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

@@ -0,0 +1,18 @@
+#!/bin/bash
+# Starts video recording
+COUNTER=$(cat "{{SEGMENT_COUNTER_PATH}}" 2>/dev/null || echo "0")
+COUNTER=$((COUNTER + 1))
+echo "$COUNTER" > "{{SEGMENT_COUNTER_PATH}}"
+SEGMENT_NAME=$(printf "segment-%03d.webm" "$COUNTER")
+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
+agent-browser eval --stdin {{SESSION_ARG}} < "{{INIT_SCRIPT_PATH}}" >/dev/null
+
+# Wait to capture initial frame
+agent-browser wait 200 {{SESSION_ARG}}
+
+echo "Recording started: $SEGMENT_NAME"

package/assets/scripts/ab-record-stop-disabled.sh

@@ -0,0 +1,2 @@
+#!/bin/bash
+echo "Video recording disabled"

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

@@ -0,0 +1,5 @@
+#!/bin/bash
+# Stops video recording
+agent-browser wait 200 {{SESSION_ARG}}
+agent-browser record stop {{SESSION_ARG}}
+echo "Recording stopped"

package/assets/scripts/ab-record.sh

@@ -0,0 +1,43 @@
+#!/bin/bash
+# Records a video segment with title overlay
+# Usage: ab-record "Title Text" "command1 && command2 && ..."
+
+TITLE="$1"
+COMMANDS="$2"
+
+if [ -z "$TITLE" ] || [ -z "$COMMANDS" ]; then
+  echo "Usage: ab-record \"Title Text\" \"command1 && command2 && ...\""
+  exit 1
+fi
+
+COUNTER=$(cat "{{SEGMENT_COUNTER_PATH}}" 2>/dev/null || echo "0")
+COUNTER=$((COUNTER + 1))
+echo "$COUNTER" > "{{SEGMENT_COUNTER_PATH}}"
+SEGMENT_NAME=$(printf "segment-%03d.webm" "$COUNTER")
+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
+agent-browser eval --stdin {{SESSION_ARG}} < "{{INIT_SCRIPT_PATH}}" >/dev/null
+
+# Inject title overlay
+ESCAPED_TITLE=$(printf '%s' "$TITLE" | sed "s/'/\\\\'/g")
+agent-browser eval {{SESSION_ARG}} "window.__agexEffects.banner.show('${ESCAPED_TITLE}')"
+
+# Wait for effects to be ready
+agent-browser wait 200 {{SESSION_ARG}}
+
+# Execute the commands
+eval "$COMMANDS"
+EXIT_CODE=$?
+
+# Wait before stopping to capture final frame
+agent-browser wait 200 {{SESSION_ARG}}
+
+agent-browser record stop {{SESSION_ARG}}
+echo "Recording stopped: $SEGMENT_NAME"
+
+exit $EXIT_CODE

package/assets/scripts/ab-screenshot.sh

@@ -0,0 +1,9 @@
+#!/bin/bash
+# Takes screenshot with proper path
+NAME="$1"
+if [ -z "$NAME" ]; then
+  echo "Usage: ab-screenshot <name>"
+  exit 1
+fi
+agent-browser screenshot "{{OUTPUT_DIR}}/$NAME" {{SESSION_ARG}}
+echo "Screenshot saved: {{OUTPUT_DIR}}/$NAME"

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

@@ -0,0 +1,6 @@
+#!/bin/bash
+# Auto-inject --session for all agent-browser commands
+for arg in "$@"; do
+  [ "$arg" = "--session" ] && exec "{{REAL_AGENT_BROWSER}}" "$@"
+done
+exec "{{REAL_AGENT_BROWSER}}" "$@" --session {{SESSION_ID}}

package/assets/scripts/fx-annotation.sh

@@ -0,0 +1,13 @@
+#!/bin/bash
+SELECTOR="$1"
+TEXT="$2"
+POSITION="${3:-bottom}"
+COLOR="${4:-#333}"
+if [ -z "$SELECTOR" ] || [ -z "$TEXT" ]; then
+  echo "Usage: fx-annotation <css-selector> <text> [position:top|bottom|left|right] [color]"
+  exit 1
+fi
+{{FX_INJECT_HELPER}}
+ESCAPED_SELECTOR=$(printf '%s' "$SELECTOR" | sed "s/'/\\\\'/g")
+ESCAPED_TEXT=$(printf '%s' "$TEXT" | sed "s/'/\\\\'/g")
+agent-browser eval {{SESSION_ARG}} "window.__agexEffects.annotation.add('${ESCAPED_SELECTOR}',{text:'${ESCAPED_TEXT}',position:'$POSITION',color:'$COLOR'})"

package/assets/scripts/fx-arrow.sh

@@ -0,0 +1,12 @@
+#!/bin/bash
+FROM="$1"
+TO="$2"
+COLOR="${3:-#ff4444}"
+if [ -z "$FROM" ] || [ -z "$TO" ]; then
+  echo "Usage: fx-arrow <from-css-selector> <to-css-selector> [color]"
+  exit 1
+fi
+{{FX_INJECT_HELPER}}
+ESCAPED_FROM=$(printf '%s' "$FROM" | sed "s/'/\\\\'/g")
+ESCAPED_TO=$(printf '%s' "$TO" | sed "s/'/\\\\'/g")
+agent-browser eval {{SESSION_ARG}} "window.__agexEffects.drawing.arrowBetween('${ESCAPED_FROM}','${ESCAPED_TO}','$COLOR')"

package/assets/scripts/fx-circle.sh

@@ -0,0 +1,13 @@
+#!/bin/bash
+SELECTOR="$1"
+LABEL="$2"
+COLOR="${3:-#ff4444}"
+if [ -z "$SELECTOR" ] || [ -z "$LABEL" ]; then
+  echo "Usage: fx-circle <css-selector> \"label\" [color]"
+  echo "  Example: fx-circle \"#logo\" \"Logo element\" '#ff0000'"
+  exit 1
+fi
+{{FX_INJECT_HELPER}}
+ESCAPED_SELECTOR=$(printf '%s' "$SELECTOR" | sed "s/'/\\\\'/g")
+ESCAPED_LABEL=$(printf '%s' "$LABEL" | sed "s/'/\\\\'/g")
+agent-browser eval {{SESSION_ARG}} "window.__agexEffects.drawing.circle('${ESCAPED_SELECTOR}','$COLOR','${ESCAPED_LABEL}')"

package/assets/scripts/fx-clear.sh

@@ -0,0 +1,3 @@
+#!/bin/bash
+{{FX_INJECT_HELPER}}
+agent-browser eval {{SESSION_ARG}} "window.__agexEffects.clearAll()"

package/assets/scripts/fx-highlight.sh

@@ -0,0 +1,32 @@
+#!/bin/bash
+SELECTOR="$1"
+LABEL="$2"
+COLOR="${3:-#2e7d32}"
+if [ -z "$SELECTOR" ] || [ -z "$LABEL" ]; then
+  echo "Usage: fx-highlight <selector> \"label\" [color]"
+  echo "  Examples:"
+  echo "    fx-highlight @e5 \"Logo found\" '#00ff00'"
+  echo "    fx-highlight \"img.logo\" \"Logo found\" '#00ff00'"
+  exit 1
+fi
+
+# Escape label for JS (handle quotes and backslashes)
+ESCAPED_LABEL=$(printf '%s' "$LABEL" | sed "s/\\\\/\\\\\\\\/g; s/'/\\\\'/g")
+
+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
+    echo "Element not found: $SELECTOR"
+    exit 1
+  fi
+
+  agent-browser eval {{SESSION_ARG}} "window.__agexEffects.proof.highlightBox($BOX,'${ESCAPED_LABEL}','$COLOR')" 2>&1 || true
+else
+  # CSS selector - use effects.js
+  ESCAPED_SELECTOR=$(printf '%s' "$SELECTOR" | sed "s/\\\\/\\\\\\\\/g; s/'/\\\\'/g")
+  agent-browser eval {{SESSION_ARG}} "window.__agexEffects.proof.highlightSelector('${ESCAPED_SELECTOR}','${ESCAPED_LABEL}','$COLOR')" 2>&1 || true
+fi
+
+agent-browser wait 100 {{SESSION_ARG}}
+echo "Highlighted $SELECTOR with label"

package/assets/scripts/fx-spotlight.sh

@@ -0,0 +1,13 @@
+#!/bin/bash
+SELECTOR="$1"
+LABEL="$2"
+OPACITY="${3:-0.7}"
+if [ -z "$SELECTOR" ] || [ -z "$LABEL" ]; then
+  echo "Usage: fx-spotlight <css-selector> \"label\" [opacity]"
+  echo "  Example: fx-spotlight \"#main-content\" \"Main content area\" 0.7"
+  exit 1
+fi
+{{FX_INJECT_HELPER}}
+ESCAPED_SELECTOR=$(printf '%s' "$SELECTOR" | sed "s/'/\\\\'/g")
+ESCAPED_LABEL=$(printf '%s' "$LABEL" | sed "s/'/\\\\'/g")
+agent-browser eval {{SESSION_ARG}} "window.__agexEffects.spotlight.show('${ESCAPED_SELECTOR}',{opacity:$OPACITY,label:'${ESCAPED_LABEL}'})"

package/assets/scripts/fx-title.sh

@@ -0,0 +1,11 @@
+#!/bin/bash
+TITLE="$1"
+SUBTITLE="$2"
+if [ -z "$TITLE" ]; then
+  echo "Usage: fx-title <title> [subtitle]"
+  exit 1
+fi
+{{FX_INJECT_HELPER}}
+ESCAPED_TITLE=$(printf '%s' "$TITLE" | sed "s/'/\\\\'/g")
+ESCAPED_SUBTITLE=$(printf '%s' "$SUBTITLE" | sed "s/'/\\\\'/g")
+agent-browser eval {{SESSION_ARG}} "window.__agexEffects.banner.show('${ESCAPED_TITLE}','${ESCAPED_SUBTITLE}')"

package/assets/scripts/fx-wait.sh

@@ -0,0 +1,3 @@
+#!/bin/bash
+MS="${1:-500}"
+agent-browser wait "$MS" {{SESSION_ARG}}

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

@@ -5348,6 +5348,18 @@ import * as path2 from "path";
 import { fileURLToPath } from "url";
 function getAssetsDir() {
   const __dirname2 = path2.dirname(fileURLToPath(import.meta.url));
+  let dir = __dirname2;
+  for (let i = 0; i < 5; i++) {
+    const candidate = path2.join(dir, "assets");
+    if (fs.existsSync(path2.join(candidate, "cursor.js"))) {
+      return candidate;
+    }
+    const nestedCandidate = path2.join(dir, "assets", "assets");
+    if (fs.existsSync(path2.join(nestedCandidate, "cursor.js"))) {
+      return nestedCandidate;
+    }
+    dir = path2.dirname(dir);
+  }
   return path2.resolve(__dirname2, "..", "assets");
 }
 function getCursorScriptPath() {
@@ -5409,6 +5421,18 @@ function renderScript(template, vars) {
 // ../browse/dist/scripts/index.js
 var __dirname = path3.dirname(fileURLToPath2(import.meta.url));
 function getScriptsDir() {
+  let dir = __dirname;
+  for (let i = 0; i < 5; i++) {
+    const candidate = path3.join(dir, "scripts");
+    if (fs2.existsSync(path3.join(candidate, "ab-fx.sh"))) {
+      return candidate;
+    }
+    const assetsCandidate = path3.join(dir, "assets", "scripts");
+    if (fs2.existsSync(path3.join(assetsCandidate, "ab-fx.sh"))) {
+      return assetsCandidate;
+    }
+    dir = path3.dirname(dir);
+  }
   return path3.resolve(__dirname, "..", "..", "scripts");
 }
 function loadRawScript(name) {

package/dist/cli.js

@@ -12,7 +12,7 @@ import {
   runReview,
   validate,
   viewportStringSchema
-} from "./chunk-CY6NF2GO.js";
+} from "./chunk-FCCNIKUD.js";
 
 // src/cli.ts
 import { defineCommand as defineCommand6, runMain } from "citty";

package/dist/index.js

@@ -5,7 +5,7 @@ import {
   provePr,
   runAgent,
   runReview
-} from "./chunk-CY6NF2GO.js";
+} from "./chunk-FCCNIKUD.js";
 export {
   AgexError,
   isAgexError,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agex",
-  "version": "0.2.4",
+  "version": "0.2.7",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -8,7 +8,12 @@
     "agex": "dist/cli.js"
   },
   "files": [
-    "dist",
+    "dist/cli.js",
+    "dist/cli.js.map",
+    "dist/index.js",
+    "dist/index.js.map",
+    "dist/index.d.ts",
+    "dist/chunk-*.js",
     "assets"
   ],
   "dependencies": {
@@ -21,15 +26,15 @@
     "typescript": "^5.9.3",
     "vitest": "^2.1.9",
     "agex-agent": "0.1.0",
-    "agex-core": "0.1.0",
     "agex-browse": "0.1.0",
-    "agex-prove-pr": "0.1.0",
+    "agex-core": "0.1.0",
     "agex-review": "0.1.0",
-    "agex-prove": "0.1.0"
+    "agex-prove": "0.1.0",
+    "agex-prove-pr": "0.1.0"
   },
   "scripts": {
     "build": "tsc -p tsconfig.json",
-    "bundle": "tsup && cp -r ../browse/assets ./assets",
+    "bundle": "rm -rf dist assets && tsup && mkdir -p ./assets/assets ./assets/scripts && cp -r ../browse/assets/ ./assets/assets/ && cp -r ../browse/scripts/ ./assets/scripts/",
     "test": "vitest run"
   }
 }

package/dist/cli.d.ts

@@ -1,6 +0,0 @@
-#!/usr/bin/env node
-import 'agex-prove';
-import 'agex-prove-pr';
-import 'agex-agent';
-import 'agex-review';
-import 'agex-core';