crewly 1.2.3 → 1.2.6

package/config/skills/agent/computer-use/lib/accessibility.sh

@@ -0,0 +1,292 @@
+#!/usr/bin/env bash
+# =============================================================================
+# Accessibility API — Layer 3
+# Universal UI automation: read elements, click, type, scroll, focus.
+# =============================================================================
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+source "${SCRIPT_DIR}/../../_common/lib.sh"
+
+# -----------------------------------------------------------------------------
+# Accessibility permission check (cached per invocation)
+# -----------------------------------------------------------------------------
+_AX_CHECKED=""
+_AX_TRUSTED=""
+
+check_ax_permission() {
+  if [ -z "$_AX_CHECKED" ]; then
+    _AX_TRUSTED=$(swift -e 'import Cocoa; print(AXIsProcessTrusted())' 2>/dev/null || echo "false")
+    _AX_CHECKED="1"
+  fi
+  [ "$_AX_TRUSTED" = "true" ]
+}
+
+require_ax_permission() {
+  if ! check_ax_permission; then
+    error_exit "Accessibility permission required. Fix: System Settings > Privacy & Security > Accessibility > enable your terminal app, then restart terminal."
+  fi
+}
+
+do_check_access() {
+  if check_ax_permission; then
+    echo "{\"success\":true,\"action\":\"check-access\",\"trusted\":true,\"message\":\"Accessibility permission granted.\"}"
+  else
+    echo "{\"success\":true,\"action\":\"check-access\",\"trusted\":false,\"message\":\"Accessibility permission NOT granted. Fix: System Settings > Privacy & Security > Accessibility > enable your terminal app.\"}"
+  fi
+}
+
+# -----------------------------------------------------------------------------
+# ui_tree — Read UI element tree from an app
+# Params: appName, maxDepth (default 8)
+# -----------------------------------------------------------------------------
+ui_tree() {
+  local app_name="$1"
+  local max_depth="${2:-8}"
+  require_ax_permission
+
+  local result
+  result=$(osascript -l JavaScript -e "
+    var app = Application('System Events');
+    var proc = app.processes.byName('$app_name');
+    var maxDepth = $max_depth;
+    var nodeCount = 0;
+    var MAX_NODES = 500;
+
+    function readElement(el, depth) {
+      if (depth > maxDepth || nodeCount >= MAX_NODES) return null;
+      nodeCount++;
+      var info = {};
+      try { info.role = el.role(); } catch(e) { info.role = 'unknown'; }
+      try { var t = el.title(); if (t) info.title = t; } catch(e) {}
+      try { var v = el.value(); if (v !== null && v !== undefined) info.value = String(v).substring(0, 500); } catch(e) {}
+      try { var d = el.description(); if (d) info.description = d; } catch(e) {}
+      try { var p = el.position(); info.position = {x: p[0], y: p[1]}; } catch(e) {}
+      try { var s = el.size(); info.size = {w: s[0], h: s[1]}; } catch(e) {}
+
+      if (depth < maxDepth && nodeCount < MAX_NODES) {
+        try {
+          var children = el.uiElements();
+          if (children.length > 0) {
+            info.children = [];
+            for (var i = 0; i < Math.min(children.length, 50); i++) {
+              var child = readElement(children[i], depth + 1);
+              if (child) info.children.push(child);
+            }
+          }
+        } catch(e) {}
+      }
+      return info;
+    }
+
+    var windows = proc.windows();
+    var result = {windowCount: windows.length, windows: []};
+    for (var w = 0; w < windows.length; w++) {
+      var win = windows[w];
+      var winInfo = readElement(win, 0);
+      try { winInfo.windowTitle = win.title() || win.name() || 'Window ' + w; } catch(e) { winInfo.windowTitle = 'Window ' + w; }
+      result.windows.push(winInfo);
+    }
+    JSON.stringify(result);
+  " 2>&1)
+
+  if [ $? -ne 0 ]; then
+    error_exit "Failed to read UI tree for '$app_name': $result"
+  fi
+  echo "{\"success\":true,\"action\":\"ui-tree\",\"appName\":\"$app_name\",\"maxDepth\":$max_depth,\"ui\":$result}"
+}
+
+# -----------------------------------------------------------------------------
+# click_element — Click a UI element by role:name or coordinates
+# Params: appName, element (role:name) OR x,y
+# -----------------------------------------------------------------------------
+click_element() {
+  local app_name="$1"
+  local element="${2:-}"
+  local click_x="${3:-}"
+  local click_y="${4:-}"
+
+  if [ -n "$element" ]; then
+    # Parse role:name format
+    local role name
+    role=$(echo "$element" | cut -d: -f1)
+    name=$(echo "$element" | cut -d: -f2-)
+
+    # Find element position via Accessibility API
+    require_ax_permission
+    local pos
+    pos=$(osascript -l JavaScript -e "
+      var app = Application('System Events');
+      var proc = app.processes.byName('$app_name');
+      var found = null;
+
+      function findElement(el, depth) {
+        if (depth > 10 || found) return;
+        var elRole = '';
+        var elTitle = '';
+        var elDesc = '';
+        try { elRole = el.role(); } catch(e) {}
+        try { elTitle = el.title() || ''; } catch(e) {}
+        try { elDesc = el.description() || ''; } catch(e) {}
+
+        var roleMatch = '$role' === '' || elRole.toLowerCase().indexOf('$role'.toLowerCase()) >= 0;
+        var nameMatch = elTitle.indexOf('$name') >= 0 || elDesc.indexOf('$name') >= 0;
+
+        if (roleMatch && nameMatch) {
+          try {
+            var p = el.position();
+            var s = el.size();
+            found = {x: p[0] + s[0]/2, y: p[1] + s[1]/2};
+          } catch(e) {}
+        }
+
+        if (!found) {
+          try {
+            var children = el.uiElements();
+            for (var i = 0; i < children.length && !found; i++) {
+              findElement(children[i], depth + 1);
+            }
+          } catch(e) {}
+        }
+      }
+
+      var windows = proc.windows();
+      for (var w = 0; w < windows.length && !found; w++) {
+        findElement(windows[w], 0);
+      }
+      found ? JSON.stringify(found) : 'null';
+    " 2>&1)
+
+    if [ "$pos" = "null" ] || [ -z "$pos" ]; then
+      error_exit "Element '$element' not found in '$app_name'"
+    fi
+
+    click_x=$(echo "$pos" | jq -r '.x')
+    click_y=$(echo "$pos" | jq -r '.y')
+  fi
+
+  require_param "x or element" "$click_x"
+  require_param "y or element" "$click_y"
+
+  # Perform the click via CoreGraphics
+  osascript -l JavaScript -e "
+    ObjC.import('CoreGraphics');
+    var point = $.CGPointMake($click_x, $click_y);
+    var move = $.CGEventCreateMouseEvent(null, $.kCGEventMouseMoved, point, 0);
+    $.CGEventPost($.kCGHIDEventTap, move);
+    var down = $.CGEventCreateMouseEvent(null, $.kCGEventLeftMouseDown, point, 0);
+    $.CGEventPost($.kCGHIDEventTap, down);
+    var up = $.CGEventCreateMouseEvent(null, $.kCGEventLeftMouseUp, point, 0);
+    $.CGEventPost($.kCGHIDEventTap, up);
+    'clicked';
+  " >/dev/null 2>&1
+
+  echo "{\"success\":true,\"action\":\"click\",\"appName\":\"$app_name\",\"x\":$click_x,\"y\":$click_y,\"element\":\"${element:-coordinates}\"}"
+}
+
+# -----------------------------------------------------------------------------
+# type_text — Type text in the focused field
+# Params: text
+# -----------------------------------------------------------------------------
+type_text() {
+  local text="$1"
+  osascript -e "tell application \"System Events\" to keystroke \"$text\"" 2>/dev/null
+  local char_count=${#text}
+  echo "{\"success\":true,\"action\":\"type\",\"characters\":$char_count}"
+}
+
+# -----------------------------------------------------------------------------
+# get_text — Extract all visible text from an app
+# Params: appName, maxDepth (default 25)
+# -----------------------------------------------------------------------------
+get_text() {
+  local app_name="$1"
+  local max_depth="${2:-25}"
+  require_ax_permission
+
+  local result
+  result=$(osascript -l JavaScript -e "
+    var app = Application('System Events');
+    var proc = app.processes.byName('$app_name');
+    var texts = [];
+    var maxDepth = $max_depth;
+    var skipDescs = {'group':1,'button':1,'scroll area':1,'collection':1,'text':1,
+      'standard window':1,'image':1,'tab bar':1,'close button':1,
+      'full screen button':1,'minimize button':1};
+
+    function extractText(el, depth) {
+      if (depth > maxDepth) return;
+      var role = 'unknown';
+      try { role = el.role(); } catch(e) {}
+      try { var val = el.value(); if (val !== null && val !== undefined && String(val).trim().length > 0) texts.push({role: role, text: String(val).substring(0, 1000)}); } catch(e) {}
+      try { var title = el.title(); if (title && title.trim().length > 0) texts.push({role: role, text: title}); } catch(e) {}
+      try { var desc = el.description(); if (desc && desc.trim().length > 0 && !skipDescs[desc.toLowerCase()]) texts.push({role: role, text: desc}); } catch(e) {}
+      try { var children = el.uiElements(); for (var i = 0; i < Math.min(children.length, 100); i++) extractText(children[i], depth + 1); } catch(e) {}
+    }
+
+    var windows = proc.windows();
+    for (var w = 0; w < windows.length; w++) extractText(windows[w], 0);
+
+    var seen = {};
+    var unique = [];
+    for (var i = 0; i < texts.length; i++) {
+      if (!seen[texts[i].text]) { seen[texts[i].text] = true; unique.push(texts[i]); }
+    }
+    JSON.stringify(unique);
+  " 2>&1)
+
+  if [ $? -ne 0 ]; then
+    error_exit "Failed to get text from '$app_name': $result"
+  fi
+  echo "{\"success\":true,\"action\":\"get-text\",\"appName\":\"$app_name\",\"texts\":$result}"
+}
+
+# -----------------------------------------------------------------------------
+# scroll_app — Scroll within an app
+# Params: direction (up|down|left|right), amount (default 3), appName (optional)
+# -----------------------------------------------------------------------------
+scroll_app() {
+  local direction="${1:-down}"
+  local amount="${2:-3}"
+  local app_name="${3:-}"
+
+  if [ -n "$app_name" ]; then
+    osascript -l JavaScript -e "
+      var app = Application('System Events');
+      app.processes.byName('$app_name').frontmost = true;
+    " >/dev/null 2>&1
+    sleep 0.3
+  fi
+
+  local dx=0 dy=0
+  case "$direction" in
+    up)    dy=$amount ;;
+    down)  dy=$(( -amount )) ;;
+    left)  dx=$amount ;;
+    right) dx=$(( -amount )) ;;
+    *)     error_exit "Unknown direction: $direction" ;;
+  esac
+
+  osascript -l JavaScript -e "
+    ObjC.import('CoreGraphics');
+    var event = $.CGEventCreateScrollWheelEvent(null, $.kCGScrollEventUnitLine, 2, $dy, $dx);
+    $.CGEventPost($.kCGHIDEventTap, event);
+    'scrolled';
+  " >/dev/null 2>&1
+
+  echo "{\"success\":true,\"action\":\"scroll\",\"direction\":\"$direction\",\"amount\":$amount}"
+}
+
+# -----------------------------------------------------------------------------
+# focus_app — Bring an app to the foreground
+# Params: appName
+# -----------------------------------------------------------------------------
+focus_app() {
+  local app_name="$1"
+  osascript -l JavaScript -e "
+    var app = Application('System Events');
+    app.processes.byName('$app_name').frontmost = true;
+  " >/dev/null 2>&1
+  echo "{\"success\":true,\"action\":\"focus\",\"appName\":\"$app_name\"}"
+}

package/config/skills/agent/computer-use/lib/applescript.sh

@@ -0,0 +1,117 @@
+#!/usr/bin/env bash
+# =============================================================================
+# AppleScript/JXA Automation — Layer 2
+# Run custom AppleScript or use presets for common operations.
+# =============================================================================
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+source "${SCRIPT_DIR}/../../_common/lib.sh"
+
+# -----------------------------------------------------------------------------
+# run_applescript — Execute raw AppleScript code
+# Params: code
+# -----------------------------------------------------------------------------
+run_applescript() {
+  local code="$1"
+
+  local result
+  result=$(osascript -e "$code" 2>&1)
+  local exit_code=$?
+
+  if [ $exit_code -ne 0 ]; then
+    # Escape for JSON
+    local escaped
+    escaped=$(echo "$result" | sed 's/\\/\\\\/g; s/"/\\"/g; s/\t/\\t/g' | tr '\n' ' ')
+    echo "{\"success\":false,\"action\":\"applescript\",\"error\":\"$escaped\"}"
+    return 1
+  fi
+
+  # Escape result for JSON: handle backslashes, quotes, tabs, and newlines
+  local escaped
+  escaped=$(printf '%s' "$result" | sed 's/\\/\\\\/g; s/"/\\"/g; s/\t/\\t/g' | tr '\n' ' ' | sed 's/ *$//')
+  echo "{\"success\":true,\"action\":\"applescript\",\"result\":\"$escaped\"}"
+}
+
+# -----------------------------------------------------------------------------
+# run_preset — Execute a preset AppleScript operation
+# Params: preset, ...args
+# Presets: activate-app, get-window-list, click-menu-item, open-file,
+#          get-clipboard, set-clipboard
+# -----------------------------------------------------------------------------
+run_preset() {
+  local preset="$1"
+  shift
+
+  case "$preset" in
+    activate-app)
+      local app_name="$1"
+      require_param "app" "$app_name"
+      run_applescript "tell application \"$app_name\" to activate"
+      ;;
+
+    get-window-list)
+      local app_name="$1"
+      require_param "app" "$app_name"
+      local result
+      result=$(osascript -l JavaScript -e "
+        var app = Application('$app_name');
+        var wins = app.windows();
+        var result = [];
+        for (var i = 0; i < wins.length; i++) {
+          try {
+            result.push({index: i, name: wins[i].name()});
+          } catch(e) {
+            result.push({index: i, name: 'Window ' + i});
+          }
+        }
+        JSON.stringify(result);
+      " 2>&1)
+      if [ $? -ne 0 ]; then
+        echo "{\"success\":false,\"action\":\"applescript\",\"preset\":\"get-window-list\",\"error\":\"Failed: $result\"}"
+        return 1
+      fi
+      echo "{\"success\":true,\"action\":\"applescript\",\"preset\":\"get-window-list\",\"windows\":$result}"
+      ;;
+
+    click-menu-item)
+      local app_name="$1"
+      local menu_name="$2"
+      local item_name="$3"
+      require_param "app" "$app_name"
+      require_param "menu" "$menu_name"
+      require_param "item" "$item_name"
+      run_applescript "tell application \"System Events\" to tell process \"$app_name\" to click menu item \"$item_name\" of menu \"$menu_name\" of menu bar 1"
+      ;;
+
+    open-file)
+      local file_path="$1"
+      require_param "path" "$file_path"
+      if [ ! -e "$file_path" ]; then
+        echo "{\"success\":false,\"action\":\"applescript\",\"preset\":\"open-file\",\"error\":\"File not found: $file_path\"}"
+        return 1
+      fi
+      run_applescript "tell application \"Finder\" to open POSIX file \"$file_path\""
+      ;;
+
+    get-clipboard)
+      local content
+      content=$(pbpaste 2>/dev/null || echo "")
+      local escaped
+      escaped=$(echo "$content" | head -c 10000 | sed 's/\\/\\\\/g; s/"/\\"/g; s/\t/\\t/g' | tr '\n' ' ')
+      echo "{\"success\":true,\"action\":\"applescript\",\"preset\":\"get-clipboard\",\"content\":\"$escaped\"}"
+      ;;
+
+    set-clipboard)
+      local text="$1"
+      require_param "text" "$text"
+      echo -n "$text" | pbcopy
+      echo "{\"success\":true,\"action\":\"applescript\",\"preset\":\"set-clipboard\"}"
+      ;;
+
+    *)
+      error_exit "Unknown preset: $preset (use activate-app, get-window-list, click-menu-item, open-file, get-clipboard, set-clipboard)"
+      ;;
+  esac
+}

package/config/skills/agent/computer-use/lib/discover.sh

@@ -0,0 +1,122 @@
+#!/usr/bin/env bash
+# =============================================================================
+# App Discovery — Layer 1
+# Lists running GUI apps with bundle IDs and detects available control methods.
+# =============================================================================
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+source "${SCRIPT_DIR}/../../_common/lib.sh"
+
+# -----------------------------------------------------------------------------
+# list_apps — List all foreground GUI apps with control method detection
+# Output: JSON array of {name, bundleId, methods: [...]}
+# -----------------------------------------------------------------------------
+list_apps() {
+  local result
+  result=$(osascript -l JavaScript -e '
+    var app = Application("System Events");
+    var procs = app.processes.whose({backgroundOnly: false});
+    var result = [];
+    for (var i = 0; i < procs.length; i++) {
+      try {
+        var p = procs[i];
+        var name = p.name();
+        var bid = p.bundleIdentifier() || "unknown";
+        var methods = ["accessibility"];
+
+        // Native macOS apps support AppleScript
+        if (bid.indexOf("com.apple.") === 0) {
+          methods.push("applescript");
+        }
+        // Some third-party scriptable apps
+        var scriptable = ["com.sublimetext", "com.googlecode.iterm2",
+          "com.microsoft.VSCode", "com.brave.Browser",
+          "org.mozilla.firefox"];
+        for (var s = 0; s < scriptable.length; s++) {
+          if (bid.indexOf(scriptable[s]) === 0) {
+            methods.push("applescript");
+            break;
+          }
+        }
+        // Chrome-based browsers support CDP
+        if (bid === "com.google.Chrome" || bid === "com.brave.Browser" ||
+            bid === "com.microsoft.edgemac") {
+          methods.push("playwright");
+        }
+
+        var winCount = 0;
+        try { winCount = p.windows.length; } catch(e) {}
+
+        result.push({
+          name: name,
+          bundleId: bid,
+          windows: winCount,
+          controllable: true,
+          methods: methods
+        });
+      } catch(e) {}
+    }
+    JSON.stringify(result);
+  ' 2>&1)
+
+  if [ $? -ne 0 ]; then
+    error_exit "Failed to list apps: $result"
+  fi
+  echo "{\"success\":true,\"action\":\"list-apps\",\"apps\":$result}"
+}
+
+# -----------------------------------------------------------------------------
+# app_info — Get detailed info for a specific app
+# Params: appName
+# Output: JSON with name, bundleId, windows, methods, and basic UI summary
+# -----------------------------------------------------------------------------
+app_info() {
+  local app_name="$1"
+
+  local result
+  result=$(osascript -l JavaScript -e "
+    var app = Application('System Events');
+    var proc = app.processes.byName('$app_name');
+    var name = proc.name();
+    var bid = proc.bundleIdentifier() || 'unknown';
+    var windows = proc.windows();
+
+    var methods = ['accessibility'];
+    if (bid.indexOf('com.apple.') === 0) methods.push('applescript');
+    var scriptable = ['com.sublimetext', 'com.googlecode.iterm2',
+      'com.microsoft.VSCode', 'com.brave.Browser', 'org.mozilla.firefox'];
+    for (var s = 0; s < scriptable.length; s++) {
+      if (bid.indexOf(scriptable[s]) === 0) { methods.push('applescript'); break; }
+    }
+    if (bid === 'com.google.Chrome' || bid === 'com.brave.Browser' ||
+        bid === 'com.microsoft.edgemac') {
+      methods.push('playwright');
+    }
+
+    var winInfo = [];
+    for (var w = 0; w < windows.length; w++) {
+      var win = windows[w];
+      var wTitle = '';
+      try { wTitle = win.title() || win.name() || 'Window ' + w; } catch(e) { wTitle = 'Window ' + w; }
+      var childCount = 0;
+      try { childCount = win.uiElements().length; } catch(e) {}
+      winInfo.push({title: wTitle, elementCount: childCount});
+    }
+
+    JSON.stringify({
+      name: name,
+      bundleId: bid,
+      windows: winInfo.length,
+      windowDetails: winInfo,
+      controllable: true,
+      methods: methods
+    });
+  " 2>&1)
+
+  if [ $? -ne 0 ]; then
+    error_exit "Failed to get app info for '$app_name': $result"
+  fi
+  echo "{\"success\":true,\"action\":\"app-info\",\"app\":$result}"
+}

package/config/skills/agent/computer-use/lib/playwright.sh

@@ -0,0 +1,153 @@
+#!/usr/bin/env bash
+# =============================================================================
+# Playwright CDP Integration — Layer 4
+# Connect to Chrome via Chrome DevTools Protocol for web app automation.
+# Requires Chrome launched with --remote-debugging-port.
+# =============================================================================
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+source "${SCRIPT_DIR}/../../_common/lib.sh"
+
+DEFAULT_CDP_PORT=9222
+
+# -----------------------------------------------------------------------------
+# chrome_connect — Test CDP connection to Chrome
+# Params: port (default 9222)
+# -----------------------------------------------------------------------------
+chrome_connect() {
+  local port="${1:-$DEFAULT_CDP_PORT}"
+
+  # Check if Chrome is reachable via CDP
+  local response
+  response=$(curl -s --connect-timeout 3 "http://127.0.0.1:${port}/json/version" 2>&1) || {
+    echo "{\"success\":false,\"action\":\"chrome-connect\",\"port\":$port,\"error\":\"Cannot connect to Chrome CDP on port $port. Launch Chrome with: open -a 'Google Chrome' --args --remote-debugging-port=$port\"}"
+    return 1
+  }
+
+  local browser
+  browser=$(echo "$response" | jq -r '.Browser // "unknown"' 2>/dev/null || echo "unknown")
+  local ws_url
+  ws_url=$(echo "$response" | jq -r '.webSocketDebuggerUrl // "unknown"' 2>/dev/null || echo "unknown")
+
+  echo "{\"success\":true,\"action\":\"chrome-connect\",\"port\":$port,\"browser\":\"$browser\",\"wsUrl\":\"$ws_url\"}"
+}
+
+# -----------------------------------------------------------------------------
+# chrome_tabs — List open Chrome tabs via CDP
+# Params: port (default 9222)
+# -----------------------------------------------------------------------------
+chrome_tabs() {
+  local port="${1:-$DEFAULT_CDP_PORT}"
+
+  local response
+  response=$(curl -s --connect-timeout 3 "http://127.0.0.1:${port}/json/list" 2>&1) || {
+    echo "{\"success\":false,\"action\":\"chrome-tabs\",\"error\":\"Cannot connect to Chrome CDP on port $port\"}"
+    return 1
+  }
+
+  # Filter to page type only and extract useful fields
+  local tabs
+  tabs=$(echo "$response" | jq '[.[] | select(.type == "page") | {id: .id, title: .title, url: .url}]' 2>/dev/null || echo "[]")
+
+  local count
+  count=$(echo "$tabs" | jq 'length' 2>/dev/null || echo "0")
+
+  echo "{\"success\":true,\"action\":\"chrome-tabs\",\"port\":$port,\"count\":$count,\"tabs\":$tabs}"
+}
+
+# -----------------------------------------------------------------------------
+# chrome_eval — Run JavaScript in a Chrome tab via CDP
+# Params: port, tabIndex, code
+# Uses the REST endpoint for simple evaluations.
+# -----------------------------------------------------------------------------
+chrome_eval() {
+  local port="${1:-$DEFAULT_CDP_PORT}"
+  local tab_index="${2:-0}"
+  local code="$3"
+
+  # Get tab list
+  local tabs_response
+  tabs_response=$(curl -s --connect-timeout 3 "http://127.0.0.1:${port}/json/list" 2>&1) || {
+    echo "{\"success\":false,\"action\":\"chrome-eval\",\"error\":\"Cannot connect to Chrome CDP\"}"
+    return 1
+  }
+
+  # Get the specific tab's webSocketDebuggerUrl
+  local ws_url
+  ws_url=$(echo "$tabs_response" | jq -r ".[$tab_index].webSocketDebuggerUrl // empty" 2>/dev/null)
+
+  if [ -z "$ws_url" ]; then
+    echo "{\"success\":false,\"action\":\"chrome-eval\",\"error\":\"Tab index $tab_index not found\"}"
+    return 1
+  fi
+
+  local tab_id
+  tab_id=$(echo "$tabs_response" | jq -r ".[$tab_index].id // empty" 2>/dev/null)
+
+  # Use CDP REST API to evaluate: activate tab first, then use the evaluate endpoint
+  # Note: For simple evaluations, we use osascript to run JS in Chrome via AppleScript
+  local tab_url
+  tab_url=$(echo "$tabs_response" | jq -r ".[$tab_index].url // empty" 2>/dev/null)
+  local tab_title
+  tab_title=$(echo "$tabs_response" | jq -r ".[$tab_index].title // empty" 2>/dev/null)
+
+  # Use the CDP WebSocket via a simple node script if available
+  if command -v node &>/dev/null; then
+    local result
+    result=$(node -e "
+      const http = require('http');
+      const data = JSON.stringify({
+        id: 1,
+        method: 'Runtime.evaluate',
+        params: { expression: $(echo "$code" | jq -Rs .), returnByValue: true }
+      });
+
+      // Use HTTP endpoint to send CDP command
+      const ws = require('ws');
+      const client = new ws('$ws_url');
+      let timeout = setTimeout(() => {
+        console.log(JSON.stringify({success: false, error: 'Timeout'}));
+        process.exit(1);
+      }, 10000);
+
+      client.on('open', () => {
+        client.send(data);
+      });
+      client.on('message', (msg) => {
+        clearTimeout(timeout);
+        const resp = JSON.parse(msg);
+        if (resp.result && resp.result.result) {
+          console.log(JSON.stringify({
+            success: true,
+            action: 'chrome-eval',
+            tabId: '$tab_id',
+            value: resp.result.result.value,
+            type: resp.result.result.type
+          }));
+        } else if (resp.result && resp.result.exceptionDetails) {
+          console.log(JSON.stringify({
+            success: false,
+            action: 'chrome-eval',
+            error: resp.result.exceptionDetails.text || 'Evaluation error'
+          }));
+        }
+        client.close();
+      });
+      client.on('error', (err) => {
+        clearTimeout(timeout);
+        console.log(JSON.stringify({success: false, error: err.message}));
+        process.exit(1);
+      });
+    " 2>&1) || {
+      # Fallback if ws module not available
+      echo "{\"success\":false,\"action\":\"chrome-eval\",\"error\":\"Node.js 'ws' module required. Install: npm install -g ws\"}"
+      return 1
+    }
+    echo "$result"
+  else
+    echo "{\"success\":false,\"action\":\"chrome-eval\",\"error\":\"Node.js required for chrome-eval. Install Node.js first.\"}"
+    return 1
+  fi
+}