cmdop 0.1.20__tar.gz → 0.1.22__tar.gz

{cmdop-0.1.20 → cmdop-0.1.22}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cmdop
-Version: 0.1.20
+Version: 0.1.22
 Summary: Python SDK for CMDOP agent interaction
 Project-URL: Homepage, https://cmdop.com
 Project-URL: Documentation, https://cmdop.com
@@ -145,71 +145,100 @@ health: Health = result.output  # Typed!
 
 ## Browser
 
+Capability-based API for browser automation.
+
 ```python
-with client.browser.create_session() as b:
-    b.navigate("https://shop.com/products")
-    b.close_modal()  # Close popups
+with client.browser.create_session() as s:
+    s.navigate("https://shop.com/products")
+    s.dom.close_modal()  # Close popups
 
     # BeautifulSoup parsing
-    soup = b.soup()  # SoupWrapper with chainable API
+    soup = s.dom.soup()  # SoupWrapper with chainable API
     for item in soup.select(".product"):
         title = item.select_one("h2").text()
         price = item.attr("data-price")
 
     # Scrolling with random delays
     for _ in range(10):
-        soup = b.soup(".listings")
-        # ... parse ...
-        b.scroll("down", 700)
-        b.wait_random(0.8, 1.5)  # Random delay
+        soup = s.dom.soup(".listings")
+        s.scroll.js("down", 700)
+        s.timing.random(0.8, 1.5)
 
-    # Click with cursor movement (human-like)
-    b.click("button.buy", move_cursor=True)  # Moves cursor before clicking
+    # Click with cursor movement
+    s.click("button.buy", move_cursor=True)
 
     # Click all "See more" buttons
-    b.click_all_by_text("See more")
+    s.input.click_all("See more")
 
-    # Native mouse operations
-    b.mouse_move(500, 300)  # Smooth cursor movement
-    b.hover(".tooltip-trigger")  # Hover to reveal tooltip
+    # Mouse operations
+    s.input.mouse_move(500, 300)
+    s.input.hover(".tooltip-trigger")
 
     # JS fetch (bypass CORS, inherit cookies)
-    data = b.fetch_json("https://api.site.com/v1/items")
+    data = s.fetch.json("/api/items")
 ```
 
+### Core Methods (on session)
+
 | Method | Description |
 |--------|-------------|
 | `navigate(url)` | Go to URL |
-| `click(selector, move_cursor)` | Click element (optionally move cursor first) |
-| `click_all_by_text(text, role)` | Click all matching elements |
+| `click(selector, move_cursor)` | Click element |
 | `type(selector, text)` | Type text |
-| `wait_for(selector, ms)` | Wait for element |
-| `wait_seconds(n)` | Sleep |
-| `wait_random(min, max)` | Random sleep |
-| `extract(selector, attr)` | Get text/attr |
-| `get_html(selector)` | Get HTML |
-| `soup(selector)` | → SoupWrapper |
-| `parse_html(html)` | → BeautifulSoup |
-| `fetch_json(url)` | JS fetch → dict |
-| `fetch_all(urls)` | Parallel fetch |
-| `execute_js(code)` | Run async JS |
+| `wait_for(selector)` | Wait for element |
+| `execute_script(js)` | Run JavaScript |
 | `screenshot()` | PNG bytes |
-| `scroll(dir, amount, ...)` | Native scroll page |
-| `scroll_to(selector)` | Scroll element into view |
-| `get_scroll_info()` | Position + page size |
-| `get_page_info()` | Comprehensive page info |
-| `mouse_move(x, y, steps)` | Move cursor to coordinates |
-| `hover(selector)` | Hover over element |
+| `get_state()` | URL + title |
+| `get_page_info()` | Full page info |
+| `get/set_cookies()` | Cookie management |
+
+### Capabilities
+
+**`session.scroll`** - Scrolling
+| Method | Description |
+|--------|-------------|
+| `js(dir, amount)` | JS scroll (works on complex sites) |
+| `native(dir, amount)` | Browser API scroll |
+| `to_bottom()` | Scroll to page bottom |
+| `to_element(selector)` | Scroll element into view |
+| `info()` | Get scroll position |
+| `infinite(extract_fn)` | Smart infinite scroll with extraction |
+
+**`session.input`** - Input operations
+| Method | Description |
+|--------|-------------|
+| `click_js(selector)` | JS click (reliable) |
+| `click_all(text, role)` | Click all matching elements |
+| `key(key, selector)` | Press keyboard key |
+| `hover(selector)` | Hover over element (native) |
+| `hover_js(selector)` | Hover via JS |
+| `mouse_move(x, y)` | Move cursor to coordinates |
+
+**`session.timing`** - Delays
+| Method | Description |
+|--------|-------------|
+| `wait(ms)` | Wait milliseconds |
+| `seconds(n)` | Wait seconds |
+| `random(min, max)` | Random delay |
+| `timeout(fn, sec, cleanup)` | Run with timeout |
+
+**`session.dom`** - DOM operations
+| Method | Description |
+|--------|-------------|
+| `html(selector)` | Get HTML |
+| `text(selector)` | Get text content |
+| `soup(selector)` | → SoupWrapper |
+| `parse(html)` | → BeautifulSoup |
+| `extract(selector, attr)` | Get text/attr list |
 | `select(selector, value)` | Dropdown select |
 | `close_modal()` | Close dialogs |
-| `press_key(key, selector)` | Press keyboard key |
-| `get/set_cookies()` | Cookie management |
 
-**scroll() parameters:**
-- `direction`: "up", "down", "left", "right"
-- `amount`: pixels to scroll
-- `smooth`: animate scroll (default True)
-- `selector`: scroll element into view (alternative to direction/amount)
+**`session.fetch`** - HTTP from browser context
+| Method | Description |
+|--------|-------------|
+| `json(url)` | Fetch JSON |
+| `all(requests)` | Parallel fetch |
+| `execute(method, url, ...)` | Custom request |
 
 ## SDKBaseModel
 

{cmdop-0.1.20 → cmdop-0.1.22}/README.md

@@ -104,71 +104,100 @@ health: Health = result.output  # Typed!
 
 ## Browser
 
+Capability-based API for browser automation.
+
 ```python
-with client.browser.create_session() as b:
-    b.navigate("https://shop.com/products")
-    b.close_modal()  # Close popups
+with client.browser.create_session() as s:
+    s.navigate("https://shop.com/products")
+    s.dom.close_modal()  # Close popups
 
     # BeautifulSoup parsing
-    soup = b.soup()  # SoupWrapper with chainable API
+    soup = s.dom.soup()  # SoupWrapper with chainable API
     for item in soup.select(".product"):
         title = item.select_one("h2").text()
         price = item.attr("data-price")
 
     # Scrolling with random delays
     for _ in range(10):
-        soup = b.soup(".listings")
-        # ... parse ...
-        b.scroll("down", 700)
-        b.wait_random(0.8, 1.5)  # Random delay
+        soup = s.dom.soup(".listings")
+        s.scroll.js("down", 700)
+        s.timing.random(0.8, 1.5)
 
-    # Click with cursor movement (human-like)
-    b.click("button.buy", move_cursor=True)  # Moves cursor before clicking
+    # Click with cursor movement
+    s.click("button.buy", move_cursor=True)
 
     # Click all "See more" buttons
-    b.click_all_by_text("See more")
+    s.input.click_all("See more")
 
-    # Native mouse operations
-    b.mouse_move(500, 300)  # Smooth cursor movement
-    b.hover(".tooltip-trigger")  # Hover to reveal tooltip
+    # Mouse operations
+    s.input.mouse_move(500, 300)
+    s.input.hover(".tooltip-trigger")
 
     # JS fetch (bypass CORS, inherit cookies)
-    data = b.fetch_json("https://api.site.com/v1/items")
+    data = s.fetch.json("/api/items")
 ```
 
+### Core Methods (on session)
+
 | Method | Description |
 |--------|-------------|
 | `navigate(url)` | Go to URL |
-| `click(selector, move_cursor)` | Click element (optionally move cursor first) |
-| `click_all_by_text(text, role)` | Click all matching elements |
+| `click(selector, move_cursor)` | Click element |
 | `type(selector, text)` | Type text |
-| `wait_for(selector, ms)` | Wait for element |
-| `wait_seconds(n)` | Sleep |
-| `wait_random(min, max)` | Random sleep |
-| `extract(selector, attr)` | Get text/attr |
-| `get_html(selector)` | Get HTML |
-| `soup(selector)` | → SoupWrapper |
-| `parse_html(html)` | → BeautifulSoup |
-| `fetch_json(url)` | JS fetch → dict |
-| `fetch_all(urls)` | Parallel fetch |
-| `execute_js(code)` | Run async JS |
+| `wait_for(selector)` | Wait for element |
+| `execute_script(js)` | Run JavaScript |
 | `screenshot()` | PNG bytes |
-| `scroll(dir, amount, ...)` | Native scroll page |
-| `scroll_to(selector)` | Scroll element into view |
-| `get_scroll_info()` | Position + page size |
-| `get_page_info()` | Comprehensive page info |
-| `mouse_move(x, y, steps)` | Move cursor to coordinates |
-| `hover(selector)` | Hover over element |
+| `get_state()` | URL + title |
+| `get_page_info()` | Full page info |
+| `get/set_cookies()` | Cookie management |
+
+### Capabilities
+
+**`session.scroll`** - Scrolling
+| Method | Description |
+|--------|-------------|
+| `js(dir, amount)` | JS scroll (works on complex sites) |
+| `native(dir, amount)` | Browser API scroll |
+| `to_bottom()` | Scroll to page bottom |
+| `to_element(selector)` | Scroll element into view |
+| `info()` | Get scroll position |
+| `infinite(extract_fn)` | Smart infinite scroll with extraction |
+
+**`session.input`** - Input operations
+| Method | Description |
+|--------|-------------|
+| `click_js(selector)` | JS click (reliable) |
+| `click_all(text, role)` | Click all matching elements |
+| `key(key, selector)` | Press keyboard key |
+| `hover(selector)` | Hover over element (native) |
+| `hover_js(selector)` | Hover via JS |
+| `mouse_move(x, y)` | Move cursor to coordinates |
+
+**`session.timing`** - Delays
+| Method | Description |
+|--------|-------------|
+| `wait(ms)` | Wait milliseconds |
+| `seconds(n)` | Wait seconds |
+| `random(min, max)` | Random delay |
+| `timeout(fn, sec, cleanup)` | Run with timeout |
+
+**`session.dom`** - DOM operations
+| Method | Description |
+|--------|-------------|
+| `html(selector)` | Get HTML |
+| `text(selector)` | Get text content |
+| `soup(selector)` | → SoupWrapper |
+| `parse(html)` | → BeautifulSoup |
+| `extract(selector, attr)` | Get text/attr list |
 | `select(selector, value)` | Dropdown select |
 | `close_modal()` | Close dialogs |
-| `press_key(key, selector)` | Press keyboard key |
-| `get/set_cookies()` | Cookie management |
 
-**scroll() parameters:**
-- `direction`: "up", "down", "left", "right"
-- `amount`: pixels to scroll
-- `smooth`: animate scroll (default True)
-- `selector`: scroll element into view (alternative to direction/amount)
+**`session.fetch`** - HTTP from browser context
+| Method | Description |
+|--------|-------------|
+| `json(url)` | Fetch JSON |
+| `all(requests)` | Parallel fetch |
+| `execute(method, url, ...)` | Custom request |
 
 ## SDKBaseModel
 

{cmdop-0.1.20 → cmdop-0.1.22}/pyproject.toml

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

{cmdop-0.1.20 → cmdop-0.1.22}/src/cmdop/__init__.py

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

cmdop-0.1.22/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.20 → cmdop-0.1.22}/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.20 → cmdop-0.1.22}/src/cmdop/client.py

@@ -439,15 +439,9 @@ class AsyncCMDOPClient:
     @property
     def browser(self) -> AsyncBrowserService:
         """
-        Async browser service for direct programmatic control.
+        Async browser service (stub - not implemented).
 
-        Provides: create_session, navigate, click, type, extract, etc.
-
-        Example:
-            >>> async with client.browser.create_session() as session:
-            ...     await session.navigate("https://google.com")
-            ...     await session.type("input[name='q']", "Python")
-            ...     results = await session.extract(".result-title")
+        Use sync CMDOPClient.browser instead.
         """
         if self._browser is None:
             self._browser = AsyncBrowserService(self._transport)

cmdop-0.1.22/src/cmdop/services/browser/__init__.py

@@ -0,0 +1,59 @@
+"""Browser SDK with capability-based API.
+
+Usage:
+    from cmdop.services.browser import BrowserSession
+
+    with service.create_session() as session:
+        session.navigate("https://example.com")
+
+        # Capabilities
+        session.scroll.js("down", 500)
+        session.scroll.to_bottom()
+
+        session.input.click_js(".button")
+        session.input.key("Escape")
+
+        session.timing.wait(1000)
+
+        soup = session.dom.soup()
+        data = session.fetch.json("/api/data")
+"""
+
+from .session import BrowserSession
+from .service.sync import BrowserService
+from .service.aio import AsyncBrowserService
+from .models import (
+    BrowserCookie,
+    BrowserState,
+    PageInfo,
+    ScrollResult,
+    ScrollInfo,
+    InfiniteScrollResult,
+)
+from .capabilities import (
+    ScrollCapability,
+    InputCapability,
+    TimingCapability,
+    DOMCapability,
+    FetchCapability,
+)
+
+__all__ = [
+    # Session & Service
+    "BrowserSession",
+    "BrowserService",
+    "AsyncBrowserService",
+    # Models
+    "BrowserCookie",
+    "BrowserState",
+    "PageInfo",
+    "ScrollResult",
+    "ScrollInfo",
+    "InfiniteScrollResult",
+    # Capabilities
+    "ScrollCapability",
+    "InputCapability",
+    "TimingCapability",
+    "DOMCapability",
+    "FetchCapability",
+]

cmdop-0.1.22/src/cmdop/services/browser/capabilities/__init__.py

@@ -0,0 +1,15 @@
+"""Browser capabilities."""
+
+from .scroll import ScrollCapability
+from .input import InputCapability
+from .timing import TimingCapability
+from .dom import DOMCapability
+from .fetch import FetchCapability
+
+__all__ = [
+    "ScrollCapability",
+    "InputCapability",
+    "TimingCapability",
+    "DOMCapability",
+    "FetchCapability",
+]

cmdop-0.1.22/src/cmdop/services/browser/capabilities/_base.py

@@ -0,0 +1,28 @@
+"""Base capability class."""
+
+from __future__ import annotations
+from typing import TYPE_CHECKING, Any
+
+if TYPE_CHECKING:
+    from ..session import BrowserSession
+
+
+class BaseCapability:
+    """Base class for all capabilities.
+
+    Capabilities group related browser operations and delegate
+    actual execution to the session.
+    """
+
+    __slots__ = ("_s",)
+
+    def __init__(self, session: "BrowserSession") -> None:
+        self._s = session
+
+    def _js(self, script: str) -> str:
+        """Execute JS via session."""
+        return self._s.execute_script(script)
+
+    def _call(self, method: str, *args: Any, **kwargs: Any) -> Any:
+        """Call service method via session."""
+        return self._s._call_service(method, *args, **kwargs)

cmdop-0.1.22/src/cmdop/services/browser/capabilities/_helpers.py

@@ -0,0 +1,16 @@
+"""Shared parsing helpers for capabilities."""
+
+from typing import Any
+from cmdop.services.browser.js import parse_json_result
+
+
+def to_dict(raw: str) -> dict[str, Any]:
+    """Parse JS result to dict, default empty."""
+    result = parse_json_result(raw)
+    return result if isinstance(result, dict) else {}
+
+
+def to_list(raw: str) -> list[Any]:
+    """Parse JS result to list, default empty."""
+    result = parse_json_result(raw)
+    return result if isinstance(result, list) else []