chore: import upstream snapshot with attribution

examples/sandbox/example.py

@@ -0,0 +1,63 @@
+"""Example of using sandbox execution with Browser-Use Agent
+
+This example demonstrates how to use the @sandbox decorator to run
+browser automation tasks with the Agent in a sandbox environment.
+
+To run this example:
+1. Set your BROWSER_USE_API_KEY environment variable
+2. Set your LLM API key (OPENAI_API_KEY, ANTHROPIC_API_KEY, etc.)
+3. Run: python examples/sandbox_execution.py
+"""
+
+import asyncio
+import os
+
+from browser_use import Browser, ChatBrowserUse, sandbox
+from browser_use.agent.service import Agent
+
+
+# Example with event callbacks to monitor execution
+def on_browser_ready(data):
+	"""Callback when browser session is created"""
+	print('\n🌐 Browser session created!')
+	print(f'   Session ID: {data.session_id}')
+	print(f'   Live view: {data.live_url}')
+	print('   Click the link above to watch the AI agent work!\n')
+
+
+@sandbox(
+	log_level='INFO',
+	on_browser_created=on_browser_ready,
+	# server_url='http://localhost:8080/sandbox-stream',
+	# cloud_profile_id='21182245-590f-4712-8888-9611651a024c',
+	# cloud_proxy_country_code='us',
+	# cloud_timeout=60,
+)
+async def pydantic_example(browser: Browser):
+	agent = Agent(
+		"""go and check my ip address and the location. return the result in json format""",
+		browser=browser,
+		llm=ChatBrowserUse(model='bu-2-0'),
+	)
+	res = await agent.run()
+
+	return res.final_result()
+
+
+async def main():
+	"""Run examples"""
+	# Check if API keys are set
+	if not os.getenv('BROWSER_USE_API_KEY'):
+		print('❌ Please set BROWSER_USE_API_KEY environment variable')
+		return
+
+	print('\n\n=== Search with AI Agent (with live browser view) ===')
+
+	search_result = await pydantic_example()
+
+	print('\nResults:')
+	print(search_result)
+
+
+if __name__ == '__main__':
+	asyncio.run(main())

examples/sandbox/structured_output.py

@@ -0,0 +1,57 @@
+"""Example of using structured output with sandbox execution
+
+To run:
+    export BROWSER_USE_API_KEY=your_key
+    python examples/sandbox/structured_output.py
+"""
+
+import asyncio
+import os
+
+from pydantic import BaseModel, Field
+
+from browser_use import Agent, Browser, ChatBrowserUse, sandbox
+from browser_use.agent.views import AgentHistoryList
+
+
+class IPLocation(BaseModel):
+	"""Structured output for IP location data"""
+
+	ip_address: str = Field(description='The public IP address')
+	country: str = Field(description='Country name')
+	city: str | None = Field(default=None, description='City name if available')
+	region: str | None = Field(default=None, description='Region/state if available')
+
+
+@sandbox(log_level='INFO')
+async def get_ip_location(browser: Browser) -> AgentHistoryList:
+	"""Get IP location using sandbox"""
+	agent = Agent(
+		task='Go to ipinfo.io and extract my IP address and location details (country, city, region)',
+		browser=browser,
+		llm=ChatBrowserUse(model='bu-2-0'),
+		output_model_schema=IPLocation,
+	)
+	return await agent.run(max_steps=10)
+
+
+async def main():
+	if not os.getenv('BROWSER_USE_API_KEY'):
+		print('❌ Please set BROWSER_USE_API_KEY environment variable')
+		print('   Get a key at: https://cloud.browser-use.com/new-api-key')
+		return
+
+	result = await get_ip_location()
+	location = result.get_structured_output(IPLocation)
+
+	if location:
+		print(f'IP: {location.ip_address}')
+		print(f'Country: {location.country}')
+		print(f'City: {location.city or "N/A"}')
+		print(f'Region: {location.region or "N/A"}')
+	else:
+		print(f'No structured output. Final result: {result.final_result()}')
+
+
+if __name__ == '__main__':
+	asyncio.run(main())