optexity-browser-use 0.9.5__py3-none-any.whl

browser_use/tools/utils.py

@@ -0,0 +1,82 @@
+"""Utility functions for browser tools."""
+
+from browser_use.dom.service import EnhancedDOMTreeNode
+
+
+def get_click_description(node: EnhancedDOMTreeNode) -> str:
+	"""Get a brief description of the clicked element for memory."""
+	parts = []
+
+	# Tag name
+	parts.append(node.tag_name)
+
+	# Add type for inputs
+	if node.tag_name == 'input' and node.attributes.get('type'):
+		input_type = node.attributes['type']
+		parts.append(f'type={input_type}')
+
+		# For checkboxes, include checked state
+		if input_type == 'checkbox':
+			is_checked = node.attributes.get('checked', 'false').lower() in ['true', 'checked', '']
+			# Also check AX node
+			if node.ax_node and node.ax_node.properties:
+				for prop in node.ax_node.properties:
+					if prop.name == 'checked':
+						is_checked = prop.value is True or prop.value == 'true'
+						break
+			state = 'checked' if is_checked else 'unchecked'
+			parts.append(f'checkbox-state={state}')
+
+	# Add role if present
+	if node.attributes.get('role'):
+		role = node.attributes['role']
+		parts.append(f'role={role}')
+
+		# For role=checkbox, include state
+		if role == 'checkbox':
+			aria_checked = node.attributes.get('aria-checked', 'false').lower()
+			is_checked = aria_checked in ['true', 'checked']
+			if node.ax_node and node.ax_node.properties:
+				for prop in node.ax_node.properties:
+					if prop.name == 'checked':
+						is_checked = prop.value is True or prop.value == 'true'
+						break
+			state = 'checked' if is_checked else 'unchecked'
+			parts.append(f'checkbox-state={state}')
+
+	# For labels/spans/divs, check if related to a hidden checkbox
+	if node.tag_name in ['label', 'span', 'div'] and 'type=' not in ' '.join(parts):
+		# Check children for hidden checkbox
+		for child in node.children:
+			if child.tag_name == 'input' and child.attributes.get('type') == 'checkbox':
+				# Check if hidden
+				is_hidden = False
+				if child.snapshot_node and child.snapshot_node.computed_styles:
+					opacity = child.snapshot_node.computed_styles.get('opacity', '1')
+					if opacity == '0' or opacity == '0.0':
+						is_hidden = True
+
+				if is_hidden or not child.is_visible:
+					# Get checkbox state
+					is_checked = child.attributes.get('checked', 'false').lower() in ['true', 'checked', '']
+					if child.ax_node and child.ax_node.properties:
+						for prop in child.ax_node.properties:
+							if prop.name == 'checked':
+								is_checked = prop.value is True or prop.value == 'true'
+								break
+					state = 'checked' if is_checked else 'unchecked'
+					parts.append(f'checkbox-state={state}')
+					break
+
+	# Add short text content if available
+	text = node.get_all_children_text().strip()
+	if text:
+		short_text = text[:30] + ('...' if len(text) > 30 else '')
+		parts.append(f'"{short_text}"')
+
+	# Add key attributes like id, name, aria-label
+	for attr in ['id', 'name', 'aria-label']:
+		if node.attributes.get(attr):
+			parts.append(f'{attr}={node.attributes[attr][:20]}')
+
+	return ' '.join(parts)

browser_use/tools/views.py

@@ -0,0 +1,100 @@
+from typing import Generic, TypeVar
+
+from pydantic import BaseModel, ConfigDict, Field
+
+
+# Action Input Models
+class ExtractAction(BaseModel):
+	query: str
+	extract_links: bool = Field(
+		default=False, description='Set True to true if the query requires links, else false to safe tokens'
+	)
+	start_from_char: int = Field(
+		default=0, description='Use this for long markdowns to start from a specific character (not index in browser_state)'
+	)
+
+
+class SearchAction(BaseModel):
+	query: str
+	engine: str = Field(
+		default='duckduckgo', description='duckduckgo, google, bing (use duckduckgo by default because less captchas)'
+	)
+
+
+# Backward compatibility alias
+SearchAction = SearchAction
+
+
+class NavigateAction(BaseModel):
+	url: str
+	new_tab: bool = Field(default=False)
+
+
+# Backward compatibility alias
+GoToUrlAction = NavigateAction
+
+
+class ClickElementAction(BaseModel):
+	index: int = Field(ge=1, description='from browser_state. All interactive elements work except <select> or file inputs.')
+	# expect_download: bool = Field(default=False, description='set True if expecting a download, False otherwise')  # moved to downloads_watchdog.py
+	# click_count: int = 1  # TODO
+
+
+class InputTextAction(BaseModel):
+	index: int = Field(ge=0, description='from browser_state')
+	text: str
+	clear: bool = Field(default=True, description='1=clear, 0=append')
+
+
+class DoneAction(BaseModel):
+	text: str = Field(description='Final user message in the format the user requested')
+	success: bool = Field(default=True, description='True if user_request completed successfully')
+	files_to_display: list[str] | None = Field(default=[])
+
+
+T = TypeVar('T', bound=BaseModel)
+
+
+class StructuredOutputAction(BaseModel, Generic[T]):
+	success: bool = Field(default=True, description='True if user_request completed successfully')
+	data: T = Field(description='The actual output data matching the requested schema')
+
+
+class SwitchTabAction(BaseModel):
+	tab_id: str = Field(min_length=4, max_length=4, description='4-char id')
+
+
+class CloseTabAction(BaseModel):
+	tab_id: str = Field(min_length=4, max_length=4, description='4-char id')
+
+
+class ScrollAction(BaseModel):
+	down: bool = Field(description='down=True=scroll down, down=False scroll up')
+	pages: float = Field(default=1.0, description='0.5=half page, 1=full page, 10=to bottom/top')
+	index: int | None = Field(default=None, description='Optional element index to scroll within specific container')
+
+
+class SendKeysAction(BaseModel):
+	keys: str = Field(description='keys (Escape, Enter, PageDown) or shortcuts (Control+o)')
+
+
+class UploadFileAction(BaseModel):
+	index: int
+	path: str
+
+
+class ExtractPageContentAction(BaseModel):
+	value: str
+
+
+class NoParamsAction(BaseModel):
+	model_config = ConfigDict(extra='ignore')
+
+
+class GetDropdownOptionsAction(BaseModel):
+	index: int
+
+
+class SelectDropdownOptionAction(BaseModel):
+	index: int
+	text: str = Field(description='exact text/value')