refactoring

Author: rcholic

sentience/__init__.py

@@ -55,7 +55,7 @@
 from .read import read
 from .recorder import Recorder, Trace, TraceStep, record
 from .screenshot import screenshot
-from .sentience_methods import AgentAction, SentienceAction
+from .sentience_methods import AgentAction, SentienceMethod
 from .snapshot import snapshot
 from .text_search import find_text_rect
 from .tracer_factory import SENTIENCE_API_URL, create_tracer
@@ -152,6 +152,6 @@
     # Agent Config (v0.12.0+)
     "AgentConfig",
     # Enums
-    "SentienceAction",
+    "SentienceMethod",
     "AgentAction",
 ]

sentience/actions.py

@@ -9,7 +9,7 @@
 from .browser import AsyncSentienceBrowser, SentienceBrowser
 from .browser_evaluator import BrowserEvaluator
 from .models import ActionResult, BBox, Snapshot
-from .sentience_methods import SentienceAction
+from .sentience_methods import SentienceMethod
 from .snapshot import snapshot, snapshot_async
 
 
@@ -64,21 +64,21 @@ def click(  # noqa: C901
                 # Fallback to JS click if element not found in snapshot
                 try:
                     success = BrowserEvaluator.invoke(
-                        browser.page, SentienceAction.CLICK, element_id
+                        browser.page, SentienceMethod.CLICK, element_id
                     )
                 except Exception:
                     # Navigation might have destroyed context, assume success if URL changed
                     success = True
         except Exception:
             # Fallback to JS click on error
             try:
-                success = BrowserEvaluator.invoke(browser.page, SentienceAction.CLICK, element_id)
+                success = BrowserEvaluator.invoke(browser.page, SentienceMethod.CLICK, element_id)
             except Exception:
                 # Navigation might have destroyed context, assume success if URL changed
                 success = True
     else:
         # Legacy JS-based click
-        success = BrowserEvaluator.invoke(browser.page, SentienceAction.CLICK, element_id)
+        success = BrowserEvaluator.invoke(browser.page, SentienceMethod.CLICK, element_id)
 
     # Wait a bit for navigation/DOM updates
     try:

sentience/snapshot.py

@@ -172,7 +172,7 @@ def _snapshot_via_api(
     if options.screenshot is not False:
         raw_options["screenshot"] = options.screenshot
 
-    raw_result = BrowserEvaluator.invoke(browser.page, SentienceAction.SNAPSHOT, **raw_options)
+    raw_result = BrowserEvaluator.invoke(browser.page, SentienceMethod.SNAPSHOT, **raw_options)
 
     # Save trace if requested (save raw data before API processing)
     if options.save_trace:

sentience/text_search.py

@@ -95,7 +95,7 @@ def find_text_rect(
     BrowserEvaluator.wait_for_extension(browser.page, timeout_ms=5000)
 
     # Verify findTextRect method exists (for older extension versions that don't have it)
-    if not BrowserEvaluator.verify_method_exists(browser.page, SentienceAction.FIND_TEXT_RECT):
+    if not BrowserEvaluator.verify_method_exists(browser.page, SentienceMethod.FIND_TEXT_RECT):
         raise RuntimeError(
             "window.sentience.findTextRect is not available. "
             "Please update the Sentience extension to the latest version."