cmdop 0.1.19__tar.gz → 0.1.21__tar.gz

{cmdop-0.1.19 → cmdop-0.1.21}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cmdop
-Version: 0.1.19
+Version: 0.1.21
 Summary: Python SDK for CMDOP agent interaction
 Project-URL: Homepage, https://cmdop.com
 Project-URL: Documentation, https://cmdop.com
@@ -204,6 +204,26 @@ with client.browser.create_session() as b:
 | `close_modal()` | Close dialogs |
 | `press_key(key, selector)` | Press keyboard key |
 | `get/set_cookies()` | Cookie management |
+| `with_timeout(fn, sec, cleanup)` | Run with timeout, skip if hangs |
+
+**with_timeout() - Smart timeout for long operations:**
+```python
+# Sync
+result, ok = browser.with_timeout(
+    lambda: process_item(browser, item),
+    timeout_sec=60,
+    on_timeout=lambda: browser.press_key('Escape'),
+)
+if not ok:
+    print("Skipped - timed out")
+
+# Async
+result, ok = await browser.with_timeout(
+    process_item(browser, item),  # coroutine
+    timeout_sec=60,
+    on_timeout=lambda: browser.press_key('Escape'),
+)
+```
 
 **scroll() parameters:**
 - `direction`: "up", "down", "left", "right"

{cmdop-0.1.19 → cmdop-0.1.21}/README.md

@@ -163,6 +163,26 @@ with client.browser.create_session() as b:
 | `close_modal()` | Close dialogs |
 | `press_key(key, selector)` | Press keyboard key |
 | `get/set_cookies()` | Cookie management |
+| `with_timeout(fn, sec, cleanup)` | Run with timeout, skip if hangs |
+
+**with_timeout() - Smart timeout for long operations:**
+```python
+# Sync
+result, ok = browser.with_timeout(
+    lambda: process_item(browser, item),
+    timeout_sec=60,
+    on_timeout=lambda: browser.press_key('Escape'),
+)
+if not ok:
+    print("Skipped - timed out")
+
+# Async
+result, ok = await browser.with_timeout(
+    process_item(browser, item),  # coroutine
+    timeout_sec=60,
+    on_timeout=lambda: browser.press_key('Escape'),
+)
+```
 
 **scroll() parameters:**
 - `direction`: "up", "down", "left", "right"

{cmdop-0.1.19 → cmdop-0.1.21}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "cmdop"
-version = "0.1.19"
+version = "0.1.21"
 description = "Python SDK for CMDOP agent interaction"
 readme = "README.md"
 license = { text = "MIT" }

{cmdop-0.1.19 → cmdop-0.1.21}/src/cmdop/__init__.py

@@ -124,7 +124,7 @@ from cmdop.logging import (
     get_log_dir,
 )
 
-__version__ = "0.1.19"
+__version__ = "0.1.21"
 
 __all__ = [
     # Version

cmdop-0.1.21/src/cmdop/_generated/rpc_messages/browser_pb2.py

@@ -0,0 +1,133 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# NO CHECKED-IN PROTOBUF GENCODE
+# source: rpc_messages/browser.proto
+# Protobuf Python Version: 6.31.1
+"""Generated protocol buffer code."""
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import descriptor_pool as _descriptor_pool
+from google.protobuf import runtime_version as _runtime_version
+from google.protobuf import symbol_database as _symbol_database
+from google.protobuf.internal import builder as _builder
+_runtime_version.ValidateProtobufRuntimeVersion(
+    _runtime_version.Domain.PUBLIC,
+    6,
+    31,
+    1,
+    '',
+    'rpc_messages/browser.proto'
+)
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+
+
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n\x1arpc_messages/browser.proto\x12\x08terminal\"\x9b\x01\n\x1b\x42rowserCreateSessionRequest\x12\x12\n\nsession_id\x18\x01 \x01(\t\x12\x10\n\x08provider\x18\x02 \x01(\t\x12\x12\n\nprofile_id\x18\x03 \x01(\t\x12\x11\n\tstart_url\x18\x04 \x01(\t\x12\x10\n\x08headless\x18\x05 \x01(\x08\x12\r\n\x05width\x18\x06 \x01(\x05\x12\x0e\n\x06height\x18\x07 \x01(\x05\"Z\n\x1c\x42rowserCreateSessionResponse\x12\x0f\n\x07success\x18\x01 \x01(\x08\x12\x1a\n\x12\x62rowser_session_id\x18\x02 \x01(\t\x12\r\n\x05\x65rror\x18\x03 \x01(\t\"L\n\x1a\x42rowserCloseSessionRequest\x12\x12\n\nsession_id\x18\x01 \x01(\t\x12\x1a\n\x12\x62rowser_session_id\x18\x02 \x01(\t\"=\n\x1b\x42rowserCloseSessionResponse\x12\x0f\n\x07success\x18\x01 \x01(\x08\x12\r\n\x05\x65rror\x18\x02 \x01(\t\"i\n\x16\x42rowserNavigateRequest\x12\x12\n\nsession_id\x18\x01 \x01(\t\x12\x1a\n\x12\x62rowser_session_id\x18\x02 \x01(\t\x12\x0b\n\x03url\x18\x03 \x01(\t\x12\x12\n\ntimeout_ms\x18\x04 \x01(\x05\"L\n\x17\x42rowserNavigateResponse\x12\x0f\n\x07success\x18\x01 \x01(\x08\x12\x11\n\tfinal_url\x18\x02 \x01(\t\x12\r\n\x05\x65rror\x18\x03 \x01(\t\"\x80\x01\n\x13\x42rowserClickRequest\x12\x12\n\nsession_id\x18\x01 \x01(\t\x12\x1a\n\x12\x62rowser_session_id\x18\x02 \x01(\t\x12\x10\n\x08selector\x18\x03 \x01(\t\x12\x12\n\ntimeout_ms\x18\x04 \x01(\x05\x12\x13\n\x0bmove_cursor\x18\x05 \x01(\x08\"6\n\x14\x42rowserClickResponse\x12\x0f\n\x07success\x18\x01 \x01(\x08\x12\r\n\x05\x65rror\x18\x02 \x01(\t\"\x8d\x01\n\x12\x42rowserTypeRequest\x12\x12\n\nsession_id\x18\x01 \x01(\t\x12\x1a\n\x12\x62rowser_session_id\x18\x02 \x01(\t\x12\x10\n\x08selector\x18\x03 \x01(\t\x12\x0c\n\x04text\x18\x04 \x01(\t\x12\x12\n\nhuman_like\x18\x05 \x01(\x08\x12\x13\n\x0b\x63lear_first\x18\x06 \x01(\x08\"5\n\x13\x42rowserTypeResponse\x12\x0f\n\x07success\x18\x01 \x01(\x08\x12\r\n\x05\x65rror\x18\x02 \x01(\t\"j\n\x12\x42rowserWaitRequest\x12\x12\n\nsession_id\x18\x01 \x01(\t\x12\x1a\n\x12\x62rowser_session_id\x18\x02 \x01(\t\x12\x10\n\x08selector\x18\x03 \x01(\t\x12\x12\n\ntimeout_ms\x18\x04 \x01(\x05\"D\n\x13\x42rowserWaitResponse\x12\x0f\n\x07success\x18\x01 \x01(\x08\x12\r\n\x05\x66ound\x18\x02 \x01(\x08\x12\r\n\x05\x65rror\x18\x03 \x01(\t\"{\n\x15\x42rowserExtractRequest\x12\x12\n\nsession_id\x18\x01 \x01(\t\x12\x1a\n\x12\x62rowser_session_id\x18\x02 \x01(\t\x12\x10\n\x08selector\x18\x03 \x01(\t\x12\x11\n\tattribute\x18\x04 \x01(\t\x12\r\n\x05limit\x18\x05 \x01(\x05\"W\n\x16\x42rowserExtractResponse\x12\x0f\n\x07success\x18\x01 \x01(\x08\x12\x0e\n\x06values\x18\x02 \x03(\t\x12\r\n\x05\x63ount\x18\x03 \x01(\x05\x12\r\n\x05\x65rror\x18\x04 \x01(\t\"\x7f\n\x1a\x42rowserExtractRegexRequest\x12\x12\n\nsession_id\x18\x01 \x01(\t\x12\x1a\n\x12\x62rowser_session_id\x18\x02 \x01(\t\x12\x0f\n\x07pattern\x18\x03 \x01(\t\x12\x11\n\tfrom_html\x18\x04 \x01(\x08\x12\r\n\x05limit\x18\x05 \x01(\x05\"]\n\x1b\x42rowserExtractRegexResponse\x12\x0f\n\x07success\x18\x01 \x01(\x08\x12\x0f\n\x07matches\x18\x02 \x03(\t\x12\r\n\x05\x63ount\x18\x03 \x01(\x05\x12\r\n\x05\x65rror\x18\x04 \x01(\t\"Y\n\x15\x42rowserGetHTMLRequest\x12\x12\n\nsession_id\x18\x01 \x01(\t\x12\x1a\n\x12\x62rowser_session_id\x18\x02 \x01(\t\x12\x10\n\x08selector\x18\x03 \x01(\t\"F\n\x16\x42rowserGetHTMLResponse\x12\x0f\n\x07success\x18\x01 \x01(\x08\x12\x0c\n\x04html\x18\x02 \x01(\t\x12\r\n\x05\x65rror\x18\x03 \x01(\t\"Y\n\x15\x42rowserGetTextRequest\x12\x12\n\nsession_id\x18\x01 \x01(\t\x12\x1a\n\x12\x62rowser_session_id\x18\x02 \x01(\t\x12\x10\n\x08selector\x18\x03 \x01(\t\"F\n\x16\x42rowserGetTextResponse\x12\x0f\n\x07success\x18\x01 \x01(\x08\x12\x0c\n\x04text\x18\x02 \x01(\t\x12\r\n\x05\x65rror\x18\x03 \x01(\t\"]\n\x1b\x42rowserExecuteScriptRequest\x12\x12\n\nsession_id\x18\x01 \x01(\t\x12\x1a\n\x12\x62rowser_session_id\x18\x02 \x01(\t\x12\x0e\n\x06script\x18\x03 \x01(\t\"N\n\x1c\x42rowserExecuteScriptResponse\x12\x0f\n\x07success\x18\x01 \x01(\x08\x12\x0e\n\x06result\x18\x02 \x01(\t\x12\r\n\x05\x65rror\x18\x03 \x01(\t\"~\n\x18\x42rowserScreenshotRequest\x12\x12\n\nsession_id\x18\x01 \x01(\t\x12\x1a\n\x12\x62rowser_session_id\x18\x02 \x01(\t\x12\x11\n\tfull_page\x18\x03 \x01(\x08\x12\x0e\n\x06\x66ormat\x18\x04 \x01(\t\x12\x0f\n\x07quality\x18\x05 \x01(\x05\"I\n\x19\x42rowserScreenshotResponse\x12\x0f\n\x07success\x18\x01 \x01(\x08\x12\x0c\n\x04\x64\x61ta\x18\x02 \x01(\x0c\x12\r\n\x05\x65rror\x18\x03 \x01(\t\"H\n\x16\x42rowserGetStateRequest\x12\x12\n\nsession_id\x18\x01 \x01(\t\x12\x1a\n\x12\x62rowser_session_id\x18\x02 \x01(\t\"U\n\x17\x42rowserGetStateResponse\x12\x0f\n\x07success\x18\x01 \x01(\x08\x12\x0b\n\x03url\x18\x02 \x01(\t\x12\r\n\x05title\x18\x03 \x01(\t\x12\r\n\x05\x65rror\x18\x04 \x01(\t\"K\n\x19\x42rowserGetPageInfoRequest\x12\x12\n\nsession_id\x18\x01 \x01(\t\x12\x1a\n\x12\x62rowser_session_id\x18\x02 \x01(\t\"\xbb\x03\n\x1a\x42rowserGetPageInfoResponse\x12\x0f\n\x07success\x18\x01 \x01(\x08\x12\r\n\x05\x65rror\x18\x02 \x01(\t\x12\x0b\n\x03url\x18\x03 \x01(\t\x12\r\n\x05title\x18\x04 \x01(\t\x12\x13\n\x0bpage_height\x18\x05 \x01(\x05\x12\x17\n\x0fviewport_height\x18\x06 \x01(\x05\x12\x16\n\x0eviewport_width\x18\x07 \x01(\x05\x12\x10\n\x08scroll_x\x18\x08 \x01(\x05\x12\x10\n\x08scroll_y\x18\t \x01(\x05\x12\x0e\n\x06\x61t_top\x18\n \x01(\x08\x12\x11\n\tat_bottom\x18\x0b \x01(\x08\x12\x14\n\x0cload_time_ms\x18\x0c \x01(\x05\x12\x15\n\rcookies_count\x18\r \x01(\x05\x12\x10\n\x08is_https\x18\x0e \x01(\x08\x12\x13\n\x0bhas_iframes\x18\x0f \x01(\x08\x12\x15\n\rdom_nodes_raw\x18\x10 \x01(\x05\x12\x19\n\x11\x64om_nodes_cleaned\x18\x11 \x01(\x05\x12\x17\n\x0ftokens_estimate\x18\x12 \x01(\x05\x12\x1b\n\x13\x63loudflare_detected\x18\x13 \x01(\x08\x12\x18\n\x10\x63\x61ptcha_detected\x18\x14 \x01(\x08\"\x91\x01\n\rBrowserCookie\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t\x12\x0e\n\x06\x64omain\x18\x03 \x01(\t\x12\x0c\n\x04path\x18\x04 \x01(\t\x12\x0e\n\x06secure\x18\x05 \x01(\x08\x12\x11\n\thttp_only\x18\x06 \x01(\x08\x12\x11\n\tsame_site\x18\x07 \x01(\t\x12\x0f\n\x07\x65xpires\x18\x08 \x01(\x03\"t\n\x18\x42rowserSetCookiesRequest\x12\x12\n\nsession_id\x18\x01 \x01(\t\x12\x1a\n\x12\x62rowser_session_id\x18\x02 \x01(\t\x12(\n\x07\x63ookies\x18\x03 \x03(\x0b\x32\x17.terminal.BrowserCookie\";\n\x19\x42rowserSetCookiesResponse\x12\x0f\n\x07success\x18\x01 \x01(\x08\x12\r\n\x05\x65rror\x18\x02 \x01(\t\"Z\n\x18\x42rowserGetCookiesRequest\x12\x12\n\nsession_id\x18\x01 \x01(\t\x12\x1a\n\x12\x62rowser_session_id\x18\x02 \x01(\t\x12\x0e\n\x06\x64omain\x18\x03 \x01(\t\"e\n\x19\x42rowserGetCookiesResponse\x12\x0f\n\x07success\x18\x01 \x01(\x08\x12(\n\x07\x63ookies\x18\x02 \x03(\x0b\x32\x17.terminal.BrowserCookie\x12\r\n\x05\x65rror\x18\x03 \x01(\t\"n\n\x17\x42rowserMouseMoveRequest\x12\x12\n\nsession_id\x18\x01 \x01(\t\x12\x1a\n\x12\x62rowser_session_id\x18\x02 \x01(\t\x12\t\n\x01x\x18\x03 \x01(\x05\x12\t\n\x01y\x18\x04 \x01(\x05\x12\r\n\x05steps\x18\x05 \x01(\x05\":\n\x18\x42rowserMouseMoveResponse\x12\x0f\n\x07success\x18\x01 \x01(\x08\x12\r\n\x05\x65rror\x18\x02 \x01(\t\"k\n\x13\x42rowserHoverRequest\x12\x12\n\nsession_id\x18\x01 \x01(\t\x12\x1a\n\x12\x62rowser_session_id\x18\x02 \x01(\t\x12\x10\n\x08selector\x18\x03 \x01(\t\x12\x12\n\ntimeout_ms\x18\x04 \x01(\x05\"6\n\x14\x42rowserHoverResponse\x12\x0f\n\x07success\x18\x01 \x01(\x08\x12\r\n\x05\x65rror\x18\x02 \x01(\t\"\x9e\x01\n\x14\x42rowserScrollRequest\x12\x12\n\nsession_id\x18\x01 \x01(\t\x12\x1a\n\x12\x62rowser_session_id\x18\x02 \x01(\t\x12\x11\n\tdirection\x18\x03 \x01(\t\x12\x0e\n\x06\x61mount\x18\x04 \x01(\x05\x12\x10\n\x08selector\x18\x05 \x01(\t\x12\x11\n\tcontainer\x18\x06 \x01(\t\x12\x0e\n\x06smooth\x18\x07 \x01(\x08\"\xb1\x01\n\x15\x42rowserScrollResponse\x12\x0f\n\x07success\x18\x01 \x01(\x08\x12\x10\n\x08scroll_x\x18\x02 \x01(\x05\x12\x10\n\x08scroll_y\x18\x03 \x01(\x05\x12\x13\n\x0bscrolled_by\x18\x04 \x01(\x05\x12\x13\n\x0bpage_height\x18\x05 \x01(\x05\x12\x17\n\x0fviewport_height\x18\x06 \x01(\x05\x12\x11\n\tat_bottom\x18\x07 \x01(\x08\x12\r\n\x05\x65rror\x18\x08 \x01(\t\"\xd5\x01\n\x1f\x42rowserValidateSelectorsRequest\x12\x12\n\nsession_id\x18\x01 \x01(\t\x12\x1a\n\x12\x62rowser_session_id\x18\x02 \x01(\t\x12\x0c\n\x04item\x18\x03 \x01(\t\x12\x45\n\x06\x66ields\x18\x04 \x03(\x0b\x32\x35.terminal.BrowserValidateSelectorsRequest.FieldsEntry\x1a-\n\x0b\x46ieldsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\"\xd2\x02\n BrowserValidateSelectorsResponse\x12\x0f\n\x07success\x18\x01 \x01(\x08\x12\r\n\x05valid\x18\x02 \x01(\x08\x12\x46\n\x06\x63ounts\x18\x03 \x03(\x0b\x32\x36.terminal.BrowserValidateSelectorsResponse.CountsEntry\x12H\n\x07samples\x18\x04 \x03(\x0b\x32\x37.terminal.BrowserValidateSelectorsResponse.SamplesEntry\x12\x0e\n\x06\x65rrors\x18\x05 \x03(\t\x12\r\n\x05\x65rror\x18\x06 \x01(\t\x1a-\n\x0b\x43ountsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\x05:\x02\x38\x01\x1a.\n\x0cSamplesEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\"}\n\x19\x42rowserExtractDataRequest\x12\x12\n\nsession_id\x18\x01 \x01(\t\x12\x1a\n\x12\x62rowser_session_id\x18\x02 \x01(\t\x12\x0c\n\x04item\x18\x03 \x01(\t\x12\x13\n\x0b\x66ields_json\x18\x04 \x01(\t\x12\r\n\x05limit\x18\x05 \x01(\x05\"_\n\x1a\x42rowserExtractDataResponse\x12\x0f\n\x07success\x18\x01 \x01(\x08\x12\x12\n\nitems_json\x18\x02 \x01(\t\x12\r\n\x05\x63ount\x18\x03 \x01(\x05\x12\r\n\x05\x65rror\x18\x04 \x01(\tB\x10Z\x0eterminal/protob\x06proto3')
+
+_globals = globals()
+_builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
+_builder.BuildTopDescriptorsAndMessages(DESCRIPTOR, 'rpc_messages.browser_pb2', _globals)
+if not _descriptor._USE_C_DESCRIPTORS:
+  _globals['DESCRIPTOR']._loaded_options = None
+  _globals['DESCRIPTOR']._serialized_options = b'Z\016terminal/proto'
+  _globals['_BROWSERVALIDATESELECTORSREQUEST_FIELDSENTRY']._loaded_options = None
+  _globals['_BROWSERVALIDATESELECTORSREQUEST_FIELDSENTRY']._serialized_options = b'8\001'
+  _globals['_BROWSERVALIDATESELECTORSRESPONSE_COUNTSENTRY']._loaded_options = None
+  _globals['_BROWSERVALIDATESELECTORSRESPONSE_COUNTSENTRY']._serialized_options = b'8\001'
+  _globals['_BROWSERVALIDATESELECTORSRESPONSE_SAMPLESENTRY']._loaded_options = None
+  _globals['_BROWSERVALIDATESELECTORSRESPONSE_SAMPLESENTRY']._serialized_options = b'8\001'
+  _globals['_BROWSERCREATESESSIONREQUEST']._serialized_start=41
+  _globals['_BROWSERCREATESESSIONREQUEST']._serialized_end=196
+  _globals['_BROWSERCREATESESSIONRESPONSE']._serialized_start=198
+  _globals['_BROWSERCREATESESSIONRESPONSE']._serialized_end=288
+  _globals['_BROWSERCLOSESESSIONREQUEST']._serialized_start=290
+  _globals['_BROWSERCLOSESESSIONREQUEST']._serialized_end=366
+  _globals['_BROWSERCLOSESESSIONRESPONSE']._serialized_start=368
+  _globals['_BROWSERCLOSESESSIONRESPONSE']._serialized_end=429
+  _globals['_BROWSERNAVIGATEREQUEST']._serialized_start=431
+  _globals['_BROWSERNAVIGATEREQUEST']._serialized_end=536
+  _globals['_BROWSERNAVIGATERESPONSE']._serialized_start=538
+  _globals['_BROWSERNAVIGATERESPONSE']._serialized_end=614
+  _globals['_BROWSERCLICKREQUEST']._serialized_start=617
+  _globals['_BROWSERCLICKREQUEST']._serialized_end=745
+  _globals['_BROWSERCLICKRESPONSE']._serialized_start=747
+  _globals['_BROWSERCLICKRESPONSE']._serialized_end=801
+  _globals['_BROWSERTYPEREQUEST']._serialized_start=804
+  _globals['_BROWSERTYPEREQUEST']._serialized_end=945
+  _globals['_BROWSERTYPERESPONSE']._serialized_start=947
+  _globals['_BROWSERTYPERESPONSE']._serialized_end=1000
+  _globals['_BROWSERWAITREQUEST']._serialized_start=1002
+  _globals['_BROWSERWAITREQUEST']._serialized_end=1108
+  _globals['_BROWSERWAITRESPONSE']._serialized_start=1110
+  _globals['_BROWSERWAITRESPONSE']._serialized_end=1178
+  _globals['_BROWSEREXTRACTREQUEST']._serialized_start=1180
+  _globals['_BROWSEREXTRACTREQUEST']._serialized_end=1303
+  _globals['_BROWSEREXTRACTRESPONSE']._serialized_start=1305
+  _globals['_BROWSEREXTRACTRESPONSE']._serialized_end=1392
+  _globals['_BROWSEREXTRACTREGEXREQUEST']._serialized_start=1394
+  _globals['_BROWSEREXTRACTREGEXREQUEST']._serialized_end=1521
+  _globals['_BROWSEREXTRACTREGEXRESPONSE']._serialized_start=1523
+  _globals['_BROWSEREXTRACTREGEXRESPONSE']._serialized_end=1616
+  _globals['_BROWSERGETHTMLREQUEST']._serialized_start=1618
+  _globals['_BROWSERGETHTMLREQUEST']._serialized_end=1707
+  _globals['_BROWSERGETHTMLRESPONSE']._serialized_start=1709
+  _globals['_BROWSERGETHTMLRESPONSE']._serialized_end=1779
+  _globals['_BROWSERGETTEXTREQUEST']._serialized_start=1781
+  _globals['_BROWSERGETTEXTREQUEST']._serialized_end=1870
+  _globals['_BROWSERGETTEXTRESPONSE']._serialized_start=1872
+  _globals['_BROWSERGETTEXTRESPONSE']._serialized_end=1942
+  _globals['_BROWSEREXECUTESCRIPTREQUEST']._serialized_start=1944
+  _globals['_BROWSEREXECUTESCRIPTREQUEST']._serialized_end=2037
+  _globals['_BROWSEREXECUTESCRIPTRESPONSE']._serialized_start=2039
+  _globals['_BROWSEREXECUTESCRIPTRESPONSE']._serialized_end=2117
+  _globals['_BROWSERSCREENSHOTREQUEST']._serialized_start=2119
+  _globals['_BROWSERSCREENSHOTREQUEST']._serialized_end=2245
+  _globals['_BROWSERSCREENSHOTRESPONSE']._serialized_start=2247
+  _globals['_BROWSERSCREENSHOTRESPONSE']._serialized_end=2320
+  _globals['_BROWSERGETSTATEREQUEST']._serialized_start=2322
+  _globals['_BROWSERGETSTATEREQUEST']._serialized_end=2394
+  _globals['_BROWSERGETSTATERESPONSE']._serialized_start=2396
+  _globals['_BROWSERGETSTATERESPONSE']._serialized_end=2481
+  _globals['_BROWSERGETPAGEINFOREQUEST']._serialized_start=2483
+  _globals['_BROWSERGETPAGEINFOREQUEST']._serialized_end=2558
+  _globals['_BROWSERGETPAGEINFORESPONSE']._serialized_start=2561
+  _globals['_BROWSERGETPAGEINFORESPONSE']._serialized_end=3004
+  _globals['_BROWSERCOOKIE']._serialized_start=3007
+  _globals['_BROWSERCOOKIE']._serialized_end=3152
+  _globals['_BROWSERSETCOOKIESREQUEST']._serialized_start=3154
+  _globals['_BROWSERSETCOOKIESREQUEST']._serialized_end=3270
+  _globals['_BROWSERSETCOOKIESRESPONSE']._serialized_start=3272
+  _globals['_BROWSERSETCOOKIESRESPONSE']._serialized_end=3331
+  _globals['_BROWSERGETCOOKIESREQUEST']._serialized_start=3333
+  _globals['_BROWSERGETCOOKIESREQUEST']._serialized_end=3423
+  _globals['_BROWSERGETCOOKIESRESPONSE']._serialized_start=3425
+  _globals['_BROWSERGETCOOKIESRESPONSE']._serialized_end=3526
+  _globals['_BROWSERMOUSEMOVEREQUEST']._serialized_start=3528
+  _globals['_BROWSERMOUSEMOVEREQUEST']._serialized_end=3638
+  _globals['_BROWSERMOUSEMOVERESPONSE']._serialized_start=3640
+  _globals['_BROWSERMOUSEMOVERESPONSE']._serialized_end=3698
+  _globals['_BROWSERHOVERREQUEST']._serialized_start=3700
+  _globals['_BROWSERHOVERREQUEST']._serialized_end=3807
+  _globals['_BROWSERHOVERRESPONSE']._serialized_start=3809
+  _globals['_BROWSERHOVERRESPONSE']._serialized_end=3863
+  _globals['_BROWSERSCROLLREQUEST']._serialized_start=3866
+  _globals['_BROWSERSCROLLREQUEST']._serialized_end=4024
+  _globals['_BROWSERSCROLLRESPONSE']._serialized_start=4027
+  _globals['_BROWSERSCROLLRESPONSE']._serialized_end=4204
+  _globals['_BROWSERVALIDATESELECTORSREQUEST']._serialized_start=4207
+  _globals['_BROWSERVALIDATESELECTORSREQUEST']._serialized_end=4420
+  _globals['_BROWSERVALIDATESELECTORSREQUEST_FIELDSENTRY']._serialized_start=4375
+  _globals['_BROWSERVALIDATESELECTORSREQUEST_FIELDSENTRY']._serialized_end=4420
+  _globals['_BROWSERVALIDATESELECTORSRESPONSE']._serialized_start=4423
+  _globals['_BROWSERVALIDATESELECTORSRESPONSE']._serialized_end=4761
+  _globals['_BROWSERVALIDATESELECTORSRESPONSE_COUNTSENTRY']._serialized_start=4668
+  _globals['_BROWSERVALIDATESELECTORSRESPONSE_COUNTSENTRY']._serialized_end=4713
+  _globals['_BROWSERVALIDATESELECTORSRESPONSE_SAMPLESENTRY']._serialized_start=4715
+  _globals['_BROWSERVALIDATESELECTORSRESPONSE_SAMPLESENTRY']._serialized_end=4761
+  _globals['_BROWSEREXTRACTDATAREQUEST']._serialized_start=4763
+  _globals['_BROWSEREXTRACTDATAREQUEST']._serialized_end=4888
+  _globals['_BROWSEREXTRACTDATARESPONSE']._serialized_start=4890
+  _globals['_BROWSEREXTRACTDATARESPONSE']._serialized_end=4985
+# @@protoc_insertion_point(module_scope)

{cmdop-0.1.19 → cmdop-0.1.21}/src/cmdop/_generated/rpc_messages/browser_pb2.pyi

@@ -73,16 +73,18 @@ class BrowserNavigateResponse(_message.Message):
     def __init__(self, success: bool = ..., final_url: _Optional[str] = ..., error: _Optional[str] = ...) -> None: ...
 
 class BrowserClickRequest(_message.Message):
-    __slots__ = ("session_id", "browser_session_id", "selector", "timeout_ms")
+    __slots__ = ("session_id", "browser_session_id", "selector", "timeout_ms", "move_cursor")
     SESSION_ID_FIELD_NUMBER: _ClassVar[int]
     BROWSER_SESSION_ID_FIELD_NUMBER: _ClassVar[int]
     SELECTOR_FIELD_NUMBER: _ClassVar[int]
     TIMEOUT_MS_FIELD_NUMBER: _ClassVar[int]
+    MOVE_CURSOR_FIELD_NUMBER: _ClassVar[int]
     session_id: str
     browser_session_id: str
     selector: str
     timeout_ms: int
-    def __init__(self, session_id: _Optional[str] = ..., browser_session_id: _Optional[str] = ..., selector: _Optional[str] = ..., timeout_ms: _Optional[int] = ...) -> None: ...
+    move_cursor: bool
+    def __init__(self, session_id: _Optional[str] = ..., browser_session_id: _Optional[str] = ..., selector: _Optional[str] = ..., timeout_ms: _Optional[int] = ..., move_cursor: bool = ...) -> None: ...
 
 class BrowserClickResponse(_message.Message):
     __slots__ = ("success", "error")

{cmdop-0.1.19 → cmdop-0.1.21}/src/cmdop/services/browser/aio/service.py

@@ -88,11 +88,16 @@ class AsyncBrowserService(BaseService, BaseServiceMixin):
 
         return response.final_url
 
-    async def click(self, session_id: str, selector: str, timeout_ms: int = 5000) -> None:
+    async def click(
+        self, session_id: str, selector: str, timeout_ms: int = 5000, move_cursor: bool = False
+    ) -> None:
         from cmdop._generated.rpc_messages.browser_pb2 import BrowserClickRequest
 
         request = BrowserClickRequest(
-            browser_session_id=session_id, selector=selector, timeout_ms=timeout_ms
+            browser_session_id=session_id,
+            selector=selector,
+            timeout_ms=timeout_ms,
+            move_cursor=move_cursor,
         )
         response = await self._call_async(self._get_stub.BrowserClick, request)
 

{cmdop-0.1.19 → cmdop-0.1.21}/src/cmdop/services/browser/aio/session.py

@@ -2,10 +2,16 @@
 
 from __future__ import annotations
 
-from typing import TYPE_CHECKING, Any
+from typing import TYPE_CHECKING, Any, Awaitable, Callable, TypeVar
 
 import asyncio
 
+from cmdop.logging import get_logger
+
+_log = get_logger("cmdop.browser")
+
+T = TypeVar("T")
+
 from cmdop.services.browser.base.session import BaseSession
 from cmdop.services.browser.models import (
     BrowserCookie,
@@ -58,9 +64,7 @@ class AsyncBrowserSession(BaseSession):
             timeout_ms: Timeout in milliseconds
             move_cursor: If True, move cursor to element before clicking (human-like)
         """
-        if move_cursor:
-            await self.hover(selector, timeout_ms)
-        await self._service.click(self._session_id, selector, timeout_ms)
+        await self._service.click(self._session_id, selector, timeout_ms, move_cursor)
 
     async def type(
         self,
@@ -295,15 +299,78 @@ class AsyncBrowserSession(BaseSession):
         data = parse_json_result(result) or {}
         return data.get("success", False)
 
-    async def wait_seconds(self, seconds: float) -> None:
-        """Wait for specified seconds."""
-        await asyncio.sleep(seconds)
+    async def wait(self, ms: int, jitter: float = 0.1) -> None:
+        """
+        Wait for specified milliseconds with optional jitter.
+
+        Args:
+            ms: Wait time in milliseconds
+            jitter: Random variation ±jitter (default 10%, so 1000ms becomes 900-1100ms)
+        """
+        import random
+        actual = (ms / 1000) * (1 + random.uniform(-jitter, jitter))
+        await asyncio.sleep(actual)
+
+    async def wait_seconds(self, seconds: float, jitter: float = 0.1) -> None:
+        """
+        Wait for specified seconds with optional jitter.
+
+        Args:
+            seconds: Base wait time in seconds
+            jitter: Random variation ±jitter (default 10%, so 1.0s becomes 0.9-1.1s)
+        """
+        await self.wait(int(seconds * 1000), jitter)
 
     async def wait_random(self, min_sec: float = 0.5, max_sec: float = 1.5) -> None:
         """Wait for random time between min and max seconds."""
         import random
         await asyncio.sleep(min_sec + random.random() * (max_sec - min_sec))
 
+    async def with_timeout(
+        self,
+        coro: Awaitable[T],
+        timeout_sec: float = 60.0,
+        on_timeout: Callable[[], Awaitable[None]] | None = None,
+    ) -> tuple[T | None, bool]:
+        """
+        Run a coroutine with a timeout. Skips if it hangs.
+
+        Args:
+            coro: Coroutine to run
+            timeout_sec: Timeout in seconds (default 60)
+            on_timeout: Optional async cleanup function to call on timeout
+
+        Returns:
+            Tuple of (result, success). If timeout, returns (None, False).
+
+        Example:
+            # Simple usage
+            result, ok = await browser.with_timeout(
+                process_listing(browser, listing),
+                timeout_sec=30,
+            )
+            if not ok:
+                print("Skipped due to timeout")
+
+            # With cleanup
+            result, ok = await browser.with_timeout(
+                enrich_listing(browser, item),
+                timeout_sec=60,
+                on_timeout=lambda: browser.press_key('Escape'),
+            )
+        """
+        try:
+            result = await asyncio.wait_for(coro, timeout=timeout_sec)
+            return result, True
+        except asyncio.TimeoutError:
+            _log.warning("[timeout] Coroutine timed out after %.1fs", timeout_sec)
+            if on_timeout:
+                try:
+                    await on_timeout()
+                except Exception as e:
+                    _log.debug("[timeout] Cleanup failed: %s", e)
+            return None, False
+
     async def click_all_by_text(self, text: str, role: str = "button") -> int:
         """Click all elements containing specific text."""
         js = self._build_click_all_by_text(text, role)

{cmdop-0.1.19 → cmdop-0.1.21}/src/cmdop/services/browser/sync/service.py

@@ -88,11 +88,16 @@ class BrowserService(BaseService, BaseServiceMixin):
 
         return response.final_url
 
-    def click(self, session_id: str, selector: str, timeout_ms: int = 5000) -> None:
+    def click(
+        self, session_id: str, selector: str, timeout_ms: int = 5000, move_cursor: bool = False
+    ) -> None:
         from cmdop._generated.rpc_messages.browser_pb2 import BrowserClickRequest
 
         request = BrowserClickRequest(
-            browser_session_id=session_id, selector=selector, timeout_ms=timeout_ms
+            browser_session_id=session_id,
+            selector=selector,
+            timeout_ms=timeout_ms,
+            move_cursor=move_cursor,
         )
         response = self._call_sync(self._get_stub.BrowserClick, request)
 

{cmdop-0.1.19 → cmdop-0.1.21}/src/cmdop/services/browser/sync/session.py

@@ -3,7 +3,10 @@
 from __future__ import annotations
 
 import time
-from typing import TYPE_CHECKING, Any, Callable
+import threading
+from typing import TYPE_CHECKING, Any, Callable, TypeVar
+
+T = TypeVar("T")
 
 from cmdop.logging import get_logger
 from cmdop.services.browser.base.session import BaseSession
@@ -72,11 +75,8 @@ class BrowserSession(BaseSession):
             timeout_ms: Timeout in milliseconds
             move_cursor: If True, move cursor to element before clicking (human-like)
         """
-        if move_cursor:
-            _log.debug("[click] moving cursor to %s", selector[:60])
-            self.hover(selector, timeout_ms)
-        _log.debug("[click] %s", selector[:60])
-        self._service.click(self._session_id, selector, timeout_ms)
+        _log.debug("[click] %s%s", selector[:60], " (move_cursor)" if move_cursor else "")
+        self._service.click(self._session_id, selector, timeout_ms, move_cursor)
 
     def type(
         self,
@@ -494,15 +494,97 @@ class BrowserSession(BaseSession):
         data = parse_json_result(result) or {}
         return data.get("success", False)
 
-    def wait_seconds(self, seconds: float) -> None:
-        """Wait for specified seconds."""
-        time.sleep(seconds)
+    def wait(self, ms: int, jitter: float = 0.1) -> None:
+        """
+        Wait for specified milliseconds with optional jitter.
+
+        Args:
+            ms: Wait time in milliseconds
+            jitter: Random variation ±jitter (default 10%, so 1000ms becomes 900-1100ms)
+        """
+        import random
+        actual = (ms / 1000) * (1 + random.uniform(-jitter, jitter))
+        time.sleep(actual)
+
+    def wait_seconds(self, seconds: float, jitter: float = 0.1) -> None:
+        """
+        Wait for specified seconds with optional jitter.
+
+        Args:
+            seconds: Base wait time in seconds
+            jitter: Random variation ±jitter (default 10%, so 1.0s becomes 0.9-1.1s)
+        """
+        self.wait(int(seconds * 1000), jitter)
 
     def wait_random(self, min_sec: float = 0.5, max_sec: float = 1.5) -> None:
         """Wait for random time between min and max seconds."""
         import random
         time.sleep(min_sec + random.random() * (max_sec - min_sec))
 
+    def with_timeout(
+        self,
+        fn: Callable[[], T],
+        timeout_sec: float = 60.0,
+        on_timeout: Callable[[], None] | None = None,
+    ) -> tuple[T | None, bool]:
+        """
+        Run a function with a timeout. Skips if it hangs.
+
+        Args:
+            fn: Function to run (no arguments, use lambda/closure for args)
+            timeout_sec: Timeout in seconds (default 60)
+            on_timeout: Optional cleanup function to call on timeout
+
+        Returns:
+            Tuple of (result, success). If timeout, returns (None, False).
+
+        Example:
+            # Simple usage
+            result, ok = browser.with_timeout(
+                lambda: process_listing(browser, listing),
+                timeout_sec=30,
+            )
+            if not ok:
+                print("Skipped due to timeout")
+                continue
+
+            # With cleanup
+            result, ok = browser.with_timeout(
+                lambda: enrich_listing(browser, item),
+                timeout_sec=60,
+                on_timeout=lambda: browser.press_key('Escape'),
+            )
+        """
+        result_container: list[T | None] = [None]
+        exception_container: list[Exception | None] = [None]
+        completed = threading.Event()
+
+        def target() -> None:
+            try:
+                result_container[0] = fn()
+            except Exception as e:
+                exception_container[0] = e
+            finally:
+                completed.set()
+
+        thread = threading.Thread(target=target, daemon=True)
+        thread.start()
+
+        if completed.wait(timeout=timeout_sec):
+            # Completed in time
+            if exception_container[0]:
+                raise exception_container[0]
+            return result_container[0], True
+        else:
+            # Timeout - run cleanup if provided
+            _log.warning("[timeout] Function timed out after %.1fs", timeout_sec)
+            if on_timeout:
+                try:
+                    on_timeout()
+                except Exception as e:
+                    _log.debug("[timeout] Cleanup failed: %s", e)
+            return None, False
+
     def click_all_by_text(self, text: str, role: str = "button") -> int:
         """
         Click all elements containing specific text.