sentienceapi 0.90.16__py3-none-any.whl → 0.92.2__py3-none-any.whl

sentience/wait.py

@@ -1,13 +1,16 @@
+from typing import Optional
+
 """
 Wait functionality - wait_for element matching selector
 """
 
+import asyncio
 import time
 
-from .browser import SentienceBrowser
+from .browser import AsyncSentienceBrowser, SentienceBrowser
 from .models import SnapshotOptions, WaitResult
 from .query import find
-from .snapshot import snapshot
+from .snapshot import snapshot, snapshot_async
 
 
 def wait_for(
@@ -71,3 +74,66 @@ def wait_for(
         duration_ms=duration_ms,
         timeout=True,
     )
+
+
+async def wait_for_async(
+    browser: AsyncSentienceBrowser,
+    selector: str | dict,
+    timeout: float = 10.0,
+    interval: float | None = None,
+    use_api: bool | None = None,
+) -> WaitResult:
+    """
+    Wait for element matching selector to appear (async)
+
+    Args:
+        browser: AsyncSentienceBrowser instance
+        selector: String DSL or dict query
+        timeout: Maximum time to wait (seconds)
+        interval: Polling interval (seconds). If None, auto-detects:
+                  - 0.25s for local extension (use_api=False, fast)
+                  - 1.5s for remote API (use_api=True or default, network latency)
+        use_api: Force use of server-side API if True, local extension if False.
+                 If None, uses API if api_key is set, otherwise uses local extension.
+
+    Returns:
+        WaitResult
+    """
+    # Auto-detect optimal interval based on API usage
+    if interval is None:
+        # Determine if using API
+        will_use_api = use_api if use_api is not None else (browser.api_key is not None)
+        if will_use_api:
+            interval = 1.5  # Longer interval for API calls (network latency)
+        else:
+            interval = 0.25  # Shorter interval for local extension (fast)
+
+    start_time = time.time()
+
+    while time.time() - start_time < timeout:
+        # Take snapshot (may be local extension or remote API)
+        snap = await snapshot_async(browser, SnapshotOptions(use_api=use_api))
+
+        # Try to find element
+        element = find(snap, selector)
+
+        if element:
+            duration_ms = int((time.time() - start_time) * 1000)
+            return WaitResult(
+                found=True,
+                element=element,
+                duration_ms=duration_ms,
+                timeout=False,
+            )
+
+        # Wait before next poll
+        await asyncio.sleep(interval)
+
+    # Timeout
+    duration_ms = int((time.time() - start_time) * 1000)
+    return WaitResult(
+        found=False,
+        element=None,
+        duration_ms=duration_ms,
+        timeout=True,
+    )

{sentienceapi-0.90.16.dist-info → sentienceapi-0.92.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sentienceapi
-Version: 0.90.16
+Version: 0.92.2
 Summary: Python SDK for Sentience AI Agent Browser Automation
 Author: Sentience Team
 License: MIT OR Apache-2.0
@@ -23,6 +23,7 @@ Requires-Dist: playwright>=1.40.0
 Requires-Dist: pydantic>=2.0.0
 Requires-Dist: jsonschema>=4.0.0
 Requires-Dist: requests>=2.31.0
+Requires-Dist: httpx>=0.25.0
 Requires-Dist: playwright-stealth>=1.0.6
 Requires-Dist: markdownify>=0.11.6
 Provides-Extra: dev

sentienceapi-0.92.2.dist-info/RECORD

@@ -0,0 +1,65 @@
+sentience/__init__.py,sha256=eK71E6tu9I-968WeBciAJgPCnhDx_WAOly6WKW_8vnU,3796
+sentience/_extension_loader.py,sha256=bnZgVE5eZnUk18i2Wm8gplsVekq-fB31DNWOZt5iWpw,1356
+sentience/action_executor.py,sha256=CQmLYgxc_jUQhFrT4-MfyMFOUsAZhAACEux-ApToUbY,8108
+sentience/actions.py,sha256=03x9MwLxTrdpCSMctuTirPffdzrOr1cvYt9nZnymHhg,24175
+sentience/agent.py,sha256=b7yXfP33NmJOjtY2Dk5g4jdsO4pFKZ9QFPhKsYQNQLU,48941
+sentience/agent_config.py,sha256=n6HohW5j4VK3kT23xW7x2Vfz7HvEheb9g4AZ3VWfPpg,1588
+sentience/async_api.py,sha256=3KEt34mqpuRDEaxGphpdkopUje1X8pDB4ESgHP1SAZM,3981
+sentience/base_agent.py,sha256=5yVXe0S72I7GV4NPYySTvHfUAFvHBD4VjsNKSTo8MFo,5786
+sentience/browser.py,sha256=ZdYt9VjeyQ7pkUtk0piDnIekxxYGPMVYcY-RFbqhRrc,43747
+sentience/browser_evaluator.py,sha256=CRiMsutM68dZWHnMIrFzpVzrkUwxVsXpjBplSIWCkso,9772
+sentience/cli.py,sha256=R95DgCSJmezuymAdfL6fzUdB1HpCF3iMWcLO73KJ8eY,3851
+sentience/cloud_tracing.py,sha256=2dpxGXOCEJGLga_LcjMeyrSIKO_1moaEmJIhEaPTXO0,31038
+sentience/conversational_agent.py,sha256=v3FXczfNZdizQA7ejfgEbhGq_zaOboGb3__UaW7Alpo,18551
+sentience/element_filter.py,sha256=aVFrbTDkH-gtMZt07QfBZH3Oq8_KzwQMz17PD1uQ1h0,4021
+sentience/expect.py,sha256=JIhHJ_UGiPvKWbX5SOmX1irOZlko5N5hhhX6d2Ymem0,6177
+sentience/formatting.py,sha256=rptVpktftZZa5YJu4H2-K5dL8pzdIaPO9ONlEGSWnQw,483
+sentience/generator.py,sha256=Wj--yn6bVo02nABBzrAIKPMmU8TRQm3JHAOER9XXT4Y,8035
+sentience/inspector.py,sha256=D4q_GqXUCV3nUJv8uDv2novDbgnkboHOc9ahGeSYw9Q,14562
+sentience/llm_interaction_handler.py,sha256=elvNtmGwIvoRcdra_fvijSONWzhztgdDmuPFJF2Whkw,7218
+sentience/llm_provider.py,sha256=_AFohCMNgvwrfpFJfdoDx98jQ8wwupxTdkGQaxd_wYA,21261
+sentience/llm_provider_utils.py,sha256=Hkr30MzZ5AvROJxEZHW97FINklzU9xoV8lITUQRoFls,3854
+sentience/llm_response_builder.py,sha256=9lKJcfvD2EY7XcJtTYWTLYkxMVv_6nvlKTcGCO1nB2Q,4935
+sentience/models.py,sha256=HSvznc4o7aYn3j23vOMJD5I20rPW100tCAuCvsSkbeI,14737
+sentience/overlay.py,sha256=awphkU0ZvkQrxSwQz7S8rvc3gQIqrDhztcQzzjEnR2c,7738
+sentience/protocols.py,sha256=jXAa-RTxdIlMgISxTlIC8P79JqoD4i5T-cjbtgLjuUk,5667
+sentience/query.py,sha256=TkghEgTkEePxVVtdF9s-Ymzwt-qjzoN0SM5Qk8n-uP8,10484
+sentience/read.py,sha256=W0VSh9aBaIOMfUBcmjFubN1Ax1TmpCF1E74SLensy-g,7109
+sentience/recorder.py,sha256=6cJVmjTT7HpRaet6KvdpTFAPVwFmD30eXHtbAKdwoUw,20636
+sentience/screenshot.py,sha256=BJTPsIeE8irP1bhj4Vti2ohsZn5RkkGFTaZJOB855Pk,3147
+sentience/sentience_methods.py,sha256=NmWmf_xfDt8t6RJs5Gf317EDBDrLcOUmHjDhrGpr4ws,2552
+sentience/snapshot.py,sha256=4oDutMRKQn4ZZl-8eefJrb8tcE0vr9aKzD4nu2Z-9cY,18709
+sentience/snapshot_diff.py,sha256=2ob9MY7aNT4JAVWH89JD5DH16wGvb836V_ukkAl7smM,4757
+sentience/text_search.py,sha256=pnkj93L0bc8pp_QK3zPXec-obEPTUXRwDGGwIHVpIlg,10550
+sentience/trace_event_builder.py,sha256=RkvGnLZ9t15IQIlviZwtheteELjc-HIgA7u618anSFA,4152
+sentience/trace_file_manager.py,sha256=JxvCx-Hzfyy0wP0DHo9JPnrmFNGtLvdCrPfk0mGiqmE,6311
+sentience/tracer_factory.py,sha256=vTyZeixoyxwXdpZNPbKs02wxL5EdBAtq_a02jLB66wc,12911
+sentience/tracing.py,sha256=48J-vmtfhXjrJ4UB3i_oHbBmcKs5UsJ8ixfK3MrMt_Q,13885
+sentience/utils.py,sha256=bM2JwwsxwXb5qzNZicfhlKqnofy-kJT1HFllAuDcglk,8126
+sentience/visual_agent.py,sha256=uoVgn6jAHZepbcJ0x9L8_zNd652l1TDvaoGRtOCClJo,83016
+sentience/wait.py,sha256=sx-87AN1TO_f8UbNP9np8zA0t27zQzQg2c2TltOn2h0,4373
+sentience/extension/background.js,sha256=Om-Wsu-DP0gjKILWjysW7le_BOCKm5YugUuuTMuic14,3754
+sentience/extension/content.js,sha256=gyR-71h84RslnSyV08ioOvVow-lmDPaDlfg3GSGAU_M,7765
+sentience/extension/injected_api.js,sha256=5wCvkNJEnVuFPPSI_ktAh3sQXm24dA6C-SU4KowHknI,51603
+sentience/extension/manifest.json,sha256=3p6EsH4etOF6QI4x3p8c6kSSavM8oNjbKMrP5XVIa3o,897
+sentience/extension/release.json,sha256=e3FqrUFqbgr8dWnMRJPim43KlQKOxB4xAAZIp7pxYok,6141
+sentience/extension/pkg/sentience_core.d.ts,sha256=qrTEIR2WPkk1MmaSQzEpRyagbE9VirHowzZpbj41qeQ,1981
+sentience/extension/pkg/sentience_core.js,sha256=Jzr2TF9xORVQ4ihHEoZXgPqvUje_7j2r-HF88LcPeAY,14210
+sentience/extension/pkg/sentience_core_bg.wasm,sha256=UDkkNT-GJwMSe1iRM-bZNNBNpVXAQJL_d_DGvQM_Chw,103409
+sentience/extension/pkg/sentience_core_bg.wasm.d.ts,sha256=O3c3HaUqmB6Aob6Pt0n3GEtTxM4VGeaClaA_-z2m2J4,517
+sentience/schemas/trace_v1.json,sha256=nN0B9T62glUpRoUMXDTHAh2uskKrIdKcrDmDNtjatKg,11730
+sentience/trace_indexing/__init__.py,sha256=urjLuqqXCQE8pnwpYBqoMKnzZSqFJkM1SHmFve9RVE8,499
+sentience/trace_indexing/index_schema.py,sha256=4ovMC_4t55DUkclq8NnBEEnKUZGfIieSkwMU_aBExKA,6262
+sentience/trace_indexing/indexer.py,sha256=ulJKM7YxvJInMkWRPxyZGGSs4K298b6ZrxikCmDz--0,15629
+sentience/utils/__init__.py,sha256=h8vjeonoe9LF6TeeoJuJ9g6BdsCUP24lhmME7T9jhok,1125
+sentience/utils/browser.py,sha256=pcDlAMgvmkjG13lNXe_LXiHmQs2QRQQBliTZiP7f1wA,1313
+sentience/utils/element.py,sha256=S8AL9T-wqrbSJvJE-qr_Qv2FVk_gRiy6nx30hdRXy4E,6962
+sentience/utils/formatting.py,sha256=IQ-3kLZu1k5ae4rlQ_AxnIkVPeLR9aa8J2NE-dj_eos,1829
+sentienceapi-0.92.2.dist-info/licenses/LICENSE,sha256=jePeclQKwKdmz3jc0Oec6-jQuzwxIcGWPhMfxVII34Q,924
+sentienceapi-0.92.2.dist-info/licenses/LICENSE-APACHE,sha256=YIflUygmGOc0hS_1f6EacrQUrH73G3j8VBQbDoqmY6A,11352
+sentienceapi-0.92.2.dist-info/licenses/LICENSE-MIT,sha256=KiWwku3f8ikn6c8a6t0IdelVEu5GBLLr4tUKdGNNgJ8,1082
+sentienceapi-0.92.2.dist-info/METADATA,sha256=OfEnaVxcxA0txNs2-rFKPXK86-QDnAMfbvO8aNxHYD0,27314
+sentienceapi-0.92.2.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+sentienceapi-0.92.2.dist-info/entry_points.txt,sha256=HdW1BvgRJm3ZAbbqrwTvDWE2KbmVz-Ue0wllW-mLmvA,49
+sentienceapi-0.92.2.dist-info/top_level.txt,sha256=A9IKao--8PsFFz5vDfBIXWHgN6oh3HkMQSiQWgUTUBQ,10
+sentienceapi-0.92.2.dist-info/RECORD,,

sentience/extension/test-content.js

@@ -1,4 +0,0 @@
-// test-content.js - Simple test script
-console.log('TEST: Extension content script is loading!');
-window.testExtension = true;
-alert('Extension loaded!');

sentienceapi-0.90.16.dist-info/RECORD

@@ -1,50 +0,0 @@
-sentience/__init__.py,sha256=SFq6-EcrT4HxKerSK3eaZynY703myzFq-fOi5K3YJ3A,3410
-sentience/_extension_loader.py,sha256=bnZgVE5eZnUk18i2Wm8gplsVekq-fB31DNWOZt5iWpw,1356
-sentience/actions.py,sha256=RT8AoR_CNyp6bMCYhkToWH1WB8cyB8dcFJZMhfskTeo,13239
-sentience/agent.py,sha256=IKSxDDCyMyGx8mMvIT4kq3HXtKNaK7BiHNGXnxHCkZc,23844
-sentience/agent_config.py,sha256=blyCUh2pjMOI6YQGLWP8mSi6GTnpzWLWem4nwYg3ngA,1489
-sentience/async_api.py,sha256=NSAM8XO9_ZjqVdOjMEwkeih2BKCXVgUHe7S2T5n8slg,38721
-sentience/base_agent.py,sha256=861XkIJeig9nqdt7f2wfFKyxanGZtDhnrgsMDdXtkFM,2979
-sentience/browser.py,sha256=Mnok-PZPbZVZUAEX9FVIANyaRrjIxaXA7fk6BBegFDo,24388
-sentience/cli.py,sha256=R95DgCSJmezuymAdfL6fzUdB1HpCF3iMWcLO73KJ8eY,3851
-sentience/cloud_tracing.py,sha256=zQv42I7GOoBXMhH5f_RUx8DT_r5IXv2kQOCeAXcMCYQ,13495
-sentience/conversational_agent.py,sha256=8o2bvdaxoqgK-hHM1AVOywwKWyZturp1oLFcl6JtqCw,17258
-sentience/expect.py,sha256=BFSRocNJr6ZAusb6fy4OgfDNCukGfu5jto760bFN12E,2851
-sentience/formatting.py,sha256=0_UklIUd94a4W32gTorjxoXNE03qdffR-omfTA5eHF0,1828
-sentience/generator.py,sha256=Wj--yn6bVo02nABBzrAIKPMmU8TRQm3JHAOER9XXT4Y,8035
-sentience/inspector.py,sha256=TvLi0DIjeFcWdBVqroCMMtN98SX11fLmjg5Tg5dlSdU,7244
-sentience/llm_provider.py,sha256=ylDMUYYbk83Nh9kW6jNvmtg_vS44AersDrii39_Y6m4,20566
-sentience/models.py,sha256=Y-EF7DN5f1PyYp6z9vlYqjEKusjiKzxCqitzPrIJ--w,13242
-sentience/overlay.py,sha256=lPCqLhLGPnBk5X-W4oAaLGI54Pl_VLCS8P1b7PFUdlo,3857
-sentience/query.py,sha256=P9Hs3otwESNncaArUwaw73mNNRFeOgpjy-fOTDQiCOI,10474
-sentience/read.py,sha256=qoSbahcNumvb0mUe-WcWrKrkKCEqya6Ac7wqXFe3SRI,3490
-sentience/recorder.py,sha256=RWzkJP6LWiFAJUfbXQS3aAnRgl7aDrWuKw3slp-gR1Y,12496
-sentience/screenshot.py,sha256=1UJjRvPxPpiL3w1_MBvO_UPMAsmt-uyRujTYA50jim0,1607
-sentience/snapshot.py,sha256=_tR6LTH5Hvam80zEVW3zzvHV4xu5BwALNle4hq12IZU,9266
-sentience/text_search.py,sha256=UF7-Dlo69Stx_vkfcu5ss3dKCVgyWODrafJoJXU9NCw,5753
-sentience/tracer_factory.py,sha256=Fc_kb8ffJVGdy91cnxpxU2xjFZUyS2OiaI2pqtvl2lk,7643
-sentience/tracing.py,sha256=ciYSW3QXcO0BYDtjeKQLfpAysObBIKQKCAlviwU74AQ,7240
-sentience/utils.py,sha256=ryxiDVE_sUPHYmYnWYXADuyciD_ZawmsITDZNUeDVJg,8116
-sentience/wait.py,sha256=BYPK96YU0iza6tjPD-hS01ud48j3ECHgM9TmnemRA5k,2229
-sentience/extension/background.js,sha256=hnK32hVtHJrLtzBeXt2beRmMzr1l0U82r8zZEXyOibk,8954
-sentience/extension/content.js,sha256=UIuFCDTVTkXdaiXB8LMf0OP8SB_WMrMoaav5ZBXmeIo,10442
-sentience/extension/injected_api.js,sha256=Pr5j9MGJTInPOKfKKNuaMDjOJSK3ygM-HlmWAUUS-Yg,63790
-sentience/extension/manifest.json,sha256=MfkfsS5zVxb-scqJllN8aubrRN9vsznQ3-Aw69pZ47c,897
-sentience/extension/release.json,sha256=SnuTzbdXcwAsP4dhp9fMfzlf0wDsaj8Wyn_PpCsOThM,6437
-sentience/extension/test-content.js,sha256=RX6A42W-5pjP-avqGwrRq_GVp5yX2NqBDlDLc-SWL5g,156
-sentience/extension/pkg/sentience_core.d.ts,sha256=qrTEIR2WPkk1MmaSQzEpRyagbE9VirHowzZpbj41qeQ,1981
-sentience/extension/pkg/sentience_core.js,sha256=zldlOubec0pbNYhquwDzoQKuBF4SUVcIeXW_qLx0dVA,17904
-sentience/extension/pkg/sentience_core_bg.wasm,sha256=HtzBY8z4XgRgHHUqHQGm84EEQJirpf25wSVTXg-iJ1g,102522
-sentience/extension/pkg/sentience_core_bg.wasm.d.ts,sha256=O3c3HaUqmB6Aob6Pt0n3GEtTxM4VGeaClaA_-z2m2J4,517
-sentience/schemas/trace_v1.json,sha256=XpByPqRH1xzHmD7YeuaDE5ZaEb3L5fz762djcwXqPV8,7593
-sentience/trace_indexing/__init__.py,sha256=urjLuqqXCQE8pnwpYBqoMKnzZSqFJkM1SHmFve9RVE8,499
-sentience/trace_indexing/index_schema.py,sha256=Hz9igHFrHATTZOqKNiLhESjnGbDPTyRTejMGT1AKC8g,2180
-sentience/trace_indexing/indexer.py,sha256=m-p57Va0cFlCpuMWkXNSHqODpGzpESZzoOkt3OiejlM,10811
-sentienceapi-0.90.16.dist-info/licenses/LICENSE,sha256=jePeclQKwKdmz3jc0Oec6-jQuzwxIcGWPhMfxVII34Q,924
-sentienceapi-0.90.16.dist-info/licenses/LICENSE-APACHE,sha256=YIflUygmGOc0hS_1f6EacrQUrH73G3j8VBQbDoqmY6A,11352
-sentienceapi-0.90.16.dist-info/licenses/LICENSE-MIT,sha256=KiWwku3f8ikn6c8a6t0IdelVEu5GBLLr4tUKdGNNgJ8,1082
-sentienceapi-0.90.16.dist-info/METADATA,sha256=Nlotvwvkv5WMtT5avm1aqoyCRbT1qgqL0kKZL2d8pfQ,27286
-sentienceapi-0.90.16.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-sentienceapi-0.90.16.dist-info/entry_points.txt,sha256=HdW1BvgRJm3ZAbbqrwTvDWE2KbmVz-Ue0wllW-mLmvA,49
-sentienceapi-0.90.16.dist-info/top_level.txt,sha256=A9IKao--8PsFFz5vDfBIXWHgN6oh3HkMQSiQWgUTUBQ,10
-sentienceapi-0.90.16.dist-info/RECORD,,