Scale computer-use 2.0 with open-source drivers, cross-OS sandboxes, and benchmarks for training, evaluation, and data generation.
Rust agentai-agentapplecomputer-usecomputer-use-agentcontainerizationcuadesktop-automationhacktoberfestlumemacosmanusoperatorswiftvirtualizationvirtualization-frameworkwindowswindows-sandbox
docs: update imports and install commands to use cua metapackage (#1228)
ddupont547752b6faf4
diff --git a/.github/workflows/claude-auto-fix.yml b/.github/workflows/claude-auto-fix.ymlindex eb436939a5..f978d156fb 100644--- a/.github/workflows/claude-auto-fix.yml+++ b/.github/workflows/claude-auto-fix.yml@@ -222,7 +222,7 @@ jobs:if: steps.context.outputs.has_failed_run == 'true'run: |cat > /tmp/claude-prompt.txt << 'PROMPT_EOF'- You are Claude, an AI assistant that fixes CI failures in the CUA (Computer Use Agent) monorepo.+ You are Claude, an AI assistant that fixes CI failures in the Cua (Computer Use Agent) monorepo.CONTEXT:- Repository: ${{ github.repository }}diff --git a/README.md b/README.mdindex fecad86c1a..cb2b416a8e 100644--- a/README.md+++ b/README.md@@ -73,11 +73,15 @@Build agents that see screens, click buttons, and complete tasks autonomously. One API for any VM or container image — cloud or local.+```sh+pip install cua+```+<!-- <img src="img/cua-architecture.png" alt="Cua Architecture" width="100%"> -->```python-# Requires Python 3.12 or 3.13-from cua_sandbox import Sandbox, Image+# Requires Python 3.11 or later+from cua import Sandbox, Image# Same API regardless of OS or runtimeasync with Sandbox.ephemeral(Image.linux()) as sb: # or .macos() .windows() .android()diff --git a/docs/content/docs/cua/examples/ai-models/gemini-complex-ui-navigation.mdx b/docs/content/docs/cua/examples/ai-models/gemini-complex-ui-navigation.mdxindex 2699287647..853e968113 100644--- a/docs/content/docs/cua/examples/ai-models/gemini-complex-ui-navigation.mdx+++ b/docs/content/docs/cua/examples/ai-models/gemini-complex-ui-navigation.mdx@@ -95,8 +95,7 @@ Install the required packages for OmniParser and Gemini 3:Create a `requirements.txt` file:```text-cua-agent-cua-sandbox+cuacua-som # OmniParser for GUI element detectionlitellm>=1.0.0python-dotenv>=1.0.0@@ -152,8 +151,7 @@ import osimport signalimport traceback-from agent import ComputerAgent-from cua_sandbox import Sandbox, Image+from cua import ComputerAgent, Sandbox, Imagefrom dotenv import load_dotenvlogging.basicConfig(level=logging.INFO)@@ -298,8 +296,7 @@ import osimport signalimport traceback-from agent import ComputerAgent-from cua_sandbox import Sandbox, Image+from cua import ComputerAgent, Sandbox, Imagefrom dotenv import load_dotenvlogging.basicConfig(level=logging.INFO)@@ -421,8 +418,7 @@ import osimport signalimport traceback-from agent import ComputerAgent-from cua_sandbox import Sandbox, Image+from cua import ComputerAgent, Sandbox, Imagefrom dotenv import load_dotenvlogging.basicConfig(level=logging.INFO)diff --git a/docs/content/docs/cua/examples/automation/form-filling.mdx b/docs/content/docs/cua/examples/automation/form-filling.mdxindex 1efce19cc2..7bc49c966c 100644--- a/docs/content/docs/cua/examples/automation/form-filling.mdx+++ b/docs/content/docs/cua/examples/automation/form-filling.mdx@@ -25,8 +25,7 @@ First, install the required dependencies:Create a `requirements.txt` file:```text-cua-agent-cua-sandbox+cuapython-dotenv>=1.0.0```@@ -67,8 +66,7 @@ import osimport signalimport traceback-from agent import ComputerAgent-from cua_sandbox import Sandbox, Image+from cua import ComputerAgent, Sandbox, Imagefrom dotenv import load_dotenvlogging.basicConfig(level=logging.INFO)@@ -173,8 +171,7 @@ import osimport signalimport traceback-from agent import ComputerAgent-from cua_sandbox import Sandbox, Image+from cua import ComputerAgent, Sandbox, Imagefrom dotenv import load_dotenvlogging.basicConfig(level=logging.INFO)@@ -272,8 +269,7 @@ import osimport signalimport traceback-from agent import ComputerAgent-from cua_sandbox import Sandbox, Image+from cua import ComputerAgent, Sandbox, Imagefrom dotenv import load_dotenvlogging.basicConfig(level=logging.INFO)@@ -372,8 +368,7 @@ import osimport signalimport traceback-from agent import ComputerAgent-from cua_sandbox import Sandbox, Image+from cua import ComputerAgent, Sandbox, Imagefrom dotenv import load_dotenvlogging.basicConfig(level=logging.INFO)diff --git a/docs/content/docs/cua/examples/automation/post-event-contact-export.mdx b/docs/content/docs/cua/examples/automation/post-event-contact-export.mdxindex 1d198c31a8..ea5493e595 100644--- a/docs/content/docs/cua/examples/automation/post-event-contact-export.mdx+++ b/docs/content/docs/cua/examples/automation/post-event-contact-export.mdx@@ -61,8 +61,7 @@ First, install the required dependencies:Create a `requirements.txt` file:```text-cua-agent-cua-sandbox+cuapython-dotenv>=1.0.0```@@ -134,8 +133,7 @@ import signalimport tracebackfrom datetime import datetime-from agent import ComputerAgent-from cua_sandbox import Sandbox, Image+from cua import ComputerAgent, Sandbox, Imagefrom dotenv import load_dotenvlogging.basicConfig(level=logging.INFO)diff --git a/docs/content/docs/cua/examples/platform-specific/windows-app-behind-vpn.mdx b/docs/content/docs/cua/examples/platform-specific/windows-app-behind-vpn.mdxindex 693f53718a..956242141b 100644--- a/docs/content/docs/cua/examples/platform-specific/windows-app-behind-vpn.mdx+++ b/docs/content/docs/cua/examples/platform-specific/windows-app-behind-vpn.mdx@@ -60,8 +60,7 @@ Install the required dependencies:Create a `requirements.txt` file:```text-cua-agent-cua-sandbox+cuapython-dotenv>=1.0.0```@@ -151,8 +150,7 @@ Create a Python file (e.g., `hr_automation.py`):import asyncioimport loggingimport os-from agent import ComputerAgent-from cua_sandbox import Sandbox, Image+from cua import ComputerAgent, Sandbox, Imagefrom dotenv import load_dotenvlogging.basicConfig(level=logging.INFO)@@ -263,8 +261,7 @@ if __name__ == "__main__":import asyncioimport loggingimport os-from agent import ComputerAgent-from cua_sandbox import Sandbox, Image+from cua import ComputerAgent, Sandbox, Imagefrom dotenv import load_dotenvlogging.basicConfig(level=logging.INFO)@@ -342,8 +339,7 @@ if __name__ == "__main__":import asyncioimport loggingimport os-from agent import ComputerAgent-from cua_sandbox import Sandbox, Image+from cua import ComputerAgent, Sandbox, Imagefrom dotenv import load_dotenvlogging.basicConfig(level=logging.INFO)diff --git a/docs/content/docs/cua/examples/sandboxes/android.mdx b/docs/content/docs/cua/examples/sandboxes/android.mdxindex ccf8298bef..b7dd4e9dd5 100644--- a/docs/content/docs/cua/examples/sandboxes/android.mdx+++ b/docs/content/docs/cua/examples/sandboxes/android.mdx@@ -19,7 +19,7 @@ Android sandboxes expose the `sb.mobile` interface for touch input, gestures, an```python# source: examples/sandboxes/test_android_cloud_vm.pyimport asyncio-from cua_sandbox import Image, Sandbox+from cua import Image, Sandboxasync def main():@@ -49,7 +49,7 @@ asyncio.run(main())```python# source: examples/sandboxes/test_android_local_vm.pyimport asyncio-from cua_sandbox import Image, Sandbox+from cua import Image, Sandboxasync def main():diff --git a/docs/content/docs/cua/examples/sandboxes/custom-images.mdx b/docs/content/docs/cua/examples/sandboxes/custom-images.mdxindex 54d8938280..5062e68e7b 100644--- a/docs/content/docs/cua/examples/sandboxes/custom-images.mdx+++ b/docs/content/docs/cua/examples/sandboxes/custom-images.mdx@@ -22,8 +22,8 @@ Pull a Linux OCI VM image from `ghcr.io` and run it locally with `TartRuntime`.```python# source: examples/sandboxes/test_linux_local_registry_vm.pyimport asyncio-from cua_sandbox import Image, Sandbox-from cua_sandbox.runtime import TartRuntime+from cua import Image, Sandbox+from cua.runtime import TartRuntimeasync def main():@@ -53,7 +53,7 @@ Pull a macOS OCI image. The SDK reads the OCI manifest to auto-select Lume as th```python# source: examples/sandboxes/test_macos_local_registry_vm.pyimport asyncio-from cua_sandbox import Image, Sandbox+from cua import Image, Sandboxasync def main():@@ -81,7 +81,7 @@ Run any local disk image directly. Supported formats: `.qcow2`, `.vhdx`, `.raw`,```pythonimport asyncio-from cua_sandbox import Image, Sandbox+from cua import Image, Sandboxasync def main():async with Sandbox.ephemeral(@@ -113,8 +113,8 @@ Run the standard [OSWorld](https://os-world.github.io/) Ubuntu image using the O```python# source: examples/sandboxes/test_linux_local_osworld_vm.pyimport asyncio-from cua_sandbox import Image, Sandbox-from cua_sandbox.runtime import QEMURuntime+from cua import Image, Sandbox+from cua.runtime import QEMURuntimeOSWORLD_IMAGE = ("https://huggingface.co/datasets/xlangai/ubuntu_osworld/resolve/main/Ubuntu.qcow2.zip"diff --git a/docs/content/docs/cua/examples/sandboxes/linux.mdx b/docs/content/docs/cua/examples/sandboxes/linux.mdxindex 54d6cf9c79..76ecaad986 100644--- a/docs/content/docs/cua/examples/sandboxes/linux.mdx+++ b/docs/content/docs/cua/examples/sandboxes/linux.mdx@@ -29,7 +29,7 @@ Linux is available as either a lightweight **container** (Docker-backed, fast st```python# source: examples/sandboxes/test_linux_cloud_container.pyimport asyncio-from cua_sandbox import Image, Sandbox+from cua import Image, Sandboxasync def main():@@ -55,7 +55,7 @@ asyncio.run(main())```python# source: examples/sandboxes/test_linux_cloud_vm.pyimport asyncio-from cua_sandbox import Image, Sandbox+from cua import Image, Sandboxasync def main():@@ -81,7 +81,7 @@ asyncio.run(main())```python# source: examples/sandboxes/test_linux_local_container.pyimport asyncio-from cua_sandbox import Image, Sandbox+from cua import Image, Sandboxasync def main():@@ -108,7 +108,7 @@ asyncio.run(main())```python# source: examples/sandboxes/test_linux_local_vm.pyimport asyncio-from cua_sandbox import Image, Sandbox+from cua import Image, Sandboxasync def main():diff --git a/docs/content/docs/cua/examples/sandboxes/macos.mdx b/docs/content/docs/cua/examples/sandboxes/macos.mdxindex 062fe271a4..832db7b8d1 100644--- a/docs/content/docs/cua/examples/sandboxes/macos.mdx+++ b/docs/content/docs/cua/examples/sandboxes/macos.mdx@@ -22,7 +22,7 @@ macOS sandboxes are always VMs — either on Cua Cloud or locally via [Lume](htt```python# source: examples/sandboxes/test_macos_cloud_vm.pyimport asyncio-from cua_sandbox import Image, Sandbox+from cua import Image, Sandboxasync def main():@@ -48,7 +48,7 @@ asyncio.run(main())```python# source: examples/sandboxes/test_macos_local_vm.pyimport asyncio-from cua_sandbox import Image, Sandbox+from cua import Image, Sandboxasync def main():@@ -77,7 +77,7 @@ Pull a macOS image directly from the `ghcr.io/trycua` registry. The SDK reads th```python# source: examples/sandboxes/test_macos_local_registry_vm.pyimport asyncio-from cua_sandbox import Image, Sandbox+from cua import Image, Sandboxasync def main():diff --git a/docs/content/docs/cua/examples/sandboxes/windows.mdx b/docs/content/docs/cua/examples/sandboxes/windows.mdxindex 34f7231891..8147e6f113 100644--- a/docs/content/docs/cua/examples/sandboxes/windows.mdx+++ b/docs/content/docs/cua/examples/sandboxes/windows.mdx@@ -19,7 +19,7 @@ Windows sandboxes run as full VMs. Cloud Windows works on any host OS. Local Win```python# source: examples/sandboxes/test_windows_cloud_vm.pyimport asyncio-from cua_sandbox import Image, Sandbox+from cua import Image, Sandboxasync def main():@@ -47,7 +47,7 @@ The SDK automatically selects Hyper-V on Windows hosts with Hyper-V available, o```python# source: examples/sandboxes/test_windows_local_vm.pyimport asyncio-from cua_sandbox import Image, Sandbox+from cua import Image, Sandboxasync def main():diff --git a/docs/content/docs/cua/guide/advanced/chat-history.mdx b/docs/content/docs/cua/guide/advanced/chat-history.mdxindex d5f77fd5e2..0ec4a84daf 100644--- a/docs/content/docs/cua/guide/advanced/chat-history.mdx+++ b/docs/content/docs/cua/guide/advanced/chat-history.mdx@@ -10,8 +10,7 @@ description: Managing conversation history for multi-turn agent interactionsPass a message history to continue from previous context:```python-from cua_sandbox import Sandbox, Image-from agent import ComputerAgent+from cua import Sandbox, Image, ComputerAgentasync with Sandbox.ephemeral(Image.linux()) as computer:agent = ComputerAgent(diff --git a/docs/content/docs/cua/guide/advanced/composed-models.mdx b/docs/content/docs/cua/guide/advanced/composed-models.mdxindex 094ecef84e..b389a0be06 100644--- a/docs/content/docs/cua/guide/advanced/composed-models.mdx+++ b/docs/content/docs/cua/guide/advanced/composed-models.mdx@@ -10,8 +10,7 @@ Some models excel at **grounding** (finding UI elements) but can't reason aboutUse the `+` syntax to combine a grounding model with a planning model:```python-from cua_sandbox import Sandbox, Image-from agent import ComputerAgent+from cua import Sandbox, Image, ComputerAgentasync with Sandbox.ephemeral(Image.linux()) as computer:# Format: grounding_model+planning_modeldiff --git a/docs/content/docs/cua/guide/advanced/custom-tools.mdx b/docs/content/docs/cua/guide/advanced/custom-tools.mdxindex e9530a01da..2b58aa0e5f 100644--- a/docs/content/docs/cua/guide/advanced/custom-tools.mdx+++ b/docs/content/docs/cua/guide/advanced/custom-tools.mdx@@ -47,7 +47,7 @@ General models like Claude work with any tools you provide - no auto-wrapping ocThe easiest way to add a tool is to pass a function with a docstring:```python-from agent import ComputerAgent+from cua import ComputerAgentdef calculate(a: int, b: int) -> int:"""Calculate the sum of two integers"""@@ -73,7 +73,7 @@ The agent can now call `calculate` and `get_weather` alongside computer actions.For tools that should run inside the sandbox rather than on your host machine, use the `@sandboxed` decorator:```python-from cua_sandbox.helpers import sandboxed+from cua import sandboxed@sandboxed()def read_file(path: str) -> str:@@ -105,7 +105,7 @@ See [Sandboxed Python](/cua/guide/advanced/sandboxed-python) for more details.For more control over tool schema and behavior, extend `BaseTool`:```python-from agent.tools import BaseTool, register_tool+from cua.tools import BaseTool, register_toolfrom typing import Union@register_tool("database_query")@@ -202,9 +202,9 @@ Sync functions are automatically run in a thread pool to avoid blocking.Pass multiple tools of different types:```python-from agent import ComputerAgent-from agent.tools import BrowserTool-from cua_sandbox.helpers import sandboxed+from cua import ComputerAgent+from cua.tools import BrowserTool+from cua import sandboxed# Built-in toolbrowser = BrowserTool(interface=computer)@@ -235,7 +235,7 @@ The agent decides which tool to use based on the task.Tools can raise exceptions, which are passed back to the model:```python-from agent.tools import ToolError+from cua.tools import ToolErrordef divide(a: float, b: float) -> float:"""Divide a by b"""@@ -251,8 +251,7 @@ The model sees the error message and can adjust its approach.Here's a complete example with file management tools:```python-from agent import ComputerAgent-from cua_sandbox.helpers import sandboxed+from cua import ComputerAgent, sandboxed@sandboxed()def list_files(directory: str = ".") -> list:diff --git a/docs/content/docs/cua/guide/advanced/demonstration-guided-skills.mdx b/docs/content/docs/cua/guide/advanced/demonstration-guided-skills.mdxindex c49156bb85..983b66e721 100644--- a/docs/content/docs/cua/guide/advanced/demonstration-guided-skills.mdx+++ b/docs/content/docs/cua/guide/advanced/demonstration-guided-skills.mdx@@ -43,7 +43,7 @@ Read the SKILL.md file and prefix it to your prompt:```pythonfrom pathlib import Path-from agent import ComputerAgent+from cua import ComputerAgent# Load the skill prompt from SKILL.mdskill_path = Path.home() / ".cua/skills/flight-booking/SKILL.md"diff --git a/docs/content/docs/cua/guide/advanced/human-in-the-loop.mdx b/docs/content/docs/cua/guide/advanced/human-in-the-loop.mdxindex 0f120eccb3..43815eeff1 100644--- a/docs/content/docs/cua/guide/advanced/human-in-the-loop.mdx+++ b/docs/content/docs/cua/guide/advanced/human-in-the-loop.mdx@@ -20,8 +20,7 @@ This opens a UI that shows pending completions. Select a completion to take contUse `human/human` as the model:```python-from cua_sandbox import Sandbox, Image-from agent import ComputerAgent+from cua import Sandbox, Image, ComputerAgentasync with Sandbox.ephemeral(Image.linux()) as computer:agent = ComputerAgent(diff --git a/docs/content/docs/cua/guide/advanced/interactive-shell.mdx b/docs/content/docs/cua/guide/advanced/interactive-shell.mdxindex 190216370c..b7dc2b0844 100644--- a/docs/content/docs/cua/guide/advanced/interactive-shell.mdx+++ b/docs/content/docs/cua/guide/advanced/interactive-shell.mdx@@ -29,7 +29,7 @@ The shell is fully interactive — arrow keys, tab completion, and `Ctrl+C` all## Python SDK```python-from cua_sandbox import Sandbox, Image+from cua import Sandbox, Imageasync with Sandbox.create(provider_type="docker", name="my-container") as c:handle = await c.pty.create(diff --git a/docs/content/docs/cua/guide/advanced/local-computer-server.mdx b/docs/content/docs/cua/guide/advanced/local-computer-server.mdxindex 6ec7248522..bd9efb0fd5 100644--- a/docs/content/docs/cua/guide/advanced/local-computer-server.mdx+++ b/docs/content/docs/cua/guide/advanced/local-computer-server.mdx@@ -24,7 +24,7 @@ Or install dependencies manually:```bashpip install uvicorn fastapi-pip install cua-sandbox+pip install cua```## Starting the Server@@ -54,7 +54,7 @@ The server exposes endpoints for screenshots, mouse/keyboard input, and other coUse `use_host_computer_server=True` to connect to a running computer server:```python-from cua_sandbox import Sandbox, Image+from cua import Sandbox, Image# Connect to local computer serverasync with Sandbox.create(use_host_computer_server=True) as computer:@@ -82,8 +82,7 @@ async with Sandbox.create(Run agents against your desktop:```python-from cua_sandbox import Sandbox, Image-from agent import ComputerAgent+from cua import Sandbox, Image, ComputerAgentasync with Sandbox.create(use_host_computer_server=True) as computer:agent = ComputerAgent(diff --git a/docs/content/docs/cua/guide/advanced/prompt-caching.mdx b/docs/content/docs/cua/guide/advanced/prompt-caching.mdxindex a8dd0c2b79..d21607f780 100644--- a/docs/content/docs/cua/guide/advanced/prompt-caching.mdx+++ b/docs/content/docs/cua/guide/advanced/prompt-caching.mdx@@ -10,8 +10,7 @@ description: Reduce costs and latency with provider-specific prompt cachingSet `use_prompt_caching=True` when creating your agent:```python-from cua_sandbox import Sandbox, Image-from agent import ComputerAgent+from cua import Sandbox, Image, ComputerAgentasync with Sandbox.ephemeral(Image.linux()) as computer:diff --git a/docs/content/docs/cua/guide/advanced/sandboxed-python.mdx b/docs/content/docs/cua/guide/advanced/sandboxed-python.mdxindex 9d98cec6b6..7b10703bfc 100644--- a/docs/content/docs/cua/guide/advanced/sandboxed-python.mdx+++ b/docs/content/docs/cua/guide/advanced/sandboxed-python.mdx@@ -17,7 +17,7 @@ Sometimes you don't want to rely on UI automation or shell commands—you just wHere's the basic pattern:```python-from cua_sandbox import Sandbox, Image+from cua import Sandbox, Imageasync with Sandbox.ephemeral(Image.linux()) as computer:# First, install any packages you need@@ -70,8 +70,7 @@ result = await computer.venv_cmd("data_env", "python /path/to/script.py")For cleaner code, use the decorator to mark functions for remote execution:```python-from cua_sandbox import Sandbox, Image-from cua_sandbox.helpers import sandboxed+from cua import Sandbox, Image, sandboxedasync with Sandbox.ephemeral(Image.linux()) as computer:await computer.venv_install("api_env", ["requests"])diff --git a/docs/content/docs/cua/guide/advanced/telemetry.mdx b/docs/content/docs/cua/guide/advanced/telemetry.mdxindex fd1cc665f6..11e06ad389 100644--- a/docs/content/docs/cua/guide/advanced/telemetry.mdx+++ b/docs/content/docs/cua/guide/advanced/telemetry.mdx@@ -47,8 +47,7 @@ export CUA_TELEMETRY_ENABLED=falseDisable on individual objects:```python-from cua_sandbox import Sandbox, Image-from agent import ComputerAgent+from cua import Sandbox, Image, ComputerAgent# Disable for Computerasync with Sandbox.ephemeral(Image.linux(), telemetry_enabled=False) as computer:diff --git a/docs/content/docs/cua/guide/advanced/tracing.mdx b/docs/content/docs/cua/guide/advanced/tracing.mdxindex 835c128c9f..01daa6ea44 100644--- a/docs/content/docs/cua/guide/advanced/tracing.mdx+++ b/docs/content/docs/cua/guide/advanced/tracing.mdx@@ -10,7 +10,7 @@ The **Tracing API** records everything that happens on a Computer—screenshots,Start and stop tracing around any computer operations:```python-from cua_sandbox import Sandbox, Image+from cua import Sandbox, Imageasync with Sandbox.ephemeral(Image.linux()) as computer:# Start tracing@@ -147,8 +147,7 @@ Metadata appears in the trace alongside events, making it easy to correlate actiTracing works alongside ComputerAgent—you get both agent-level information and detailed computer interaction logs:```python-from cua_sandbox import Sandbox, Image-from agent import ComputerAgent+from cua import Sandbox, Image, ComputerAgentasync with Sandbox.ephemeral(Image.linux()) as computer:# Start tracing before agent runsdiff --git a/docs/content/docs/cua/guide/advanced/trajectories.mdx b/docs/content/docs/cua/guide/advanced/trajectories.mdxindex 261f200399..bca5f664cc 100644--- a/docs/content/docs/cua/guide/advanced/trajectories.mdx+++ b/docs/content/docs/cua/guide/advanced/trajectories.mdx@@ -10,7 +10,7 @@ description: Save and analyze agent execution for debugging and trainingEnable trajectory saving with the `trajectory_dir` parameter:```python-from agent import ComputerAgent+from cua import ComputerAgentagent = ComputerAgent(model="anthropic/claude-sonnet-4-5-20250929",@@ -163,7 +163,7 @@ Common issues trajectories help identify:## Example: Saving and Analyzing```python-from agent import ComputerAgent+from cua import ComputerAgentfrom pathlib import Pathimport jsondiff --git a/docs/content/docs/cua/guide/fundamentals/agent-loops.mdx b/docs/content/docs/cua/guide/fundamentals/agent-loops.mdxindex 382e219337..0fa73fb6d6 100644--- a/docs/content/docs/cua/guide/fundamentals/agent-loops.mdx+++ b/docs/content/docs/cua/guide/fundamentals/agent-loops.mdx@@ -17,9 +17,9 @@ An **agent loop** runs iteratively until a task is complete:To run an agent loop simply do:```python-from agent import ComputerAgent+from cua import ComputerAgentimport asyncio-from cua_sandbox import Sandbox, Image+from cua import Sandbox, Imageasync def take_screenshot():diff --git a/docs/content/docs/cua/guide/fundamentals/browser-tool.mdx b/docs/content/docs/cua/guide/fundamentals/browser-tool.mdxindex 6243dbc844..9b3a9382fa 100644--- a/docs/content/docs/cua/guide/fundamentals/browser-tool.mdx+++ b/docs/content/docs/cua/guide/fundamentals/browser-tool.mdx@@ -24,9 +24,8 @@ Use the standard Computer tool when:The Browser Tool uses Playwright under the hood to control the browser:```python-from cua_sandbox import Sandbox, Image-from agent import ComputerAgent-from agent.tools import BrowserTool+from cua import Sandbox, Image, ComputerAgent+from cua.tools import BrowserTool# Create a computer instanceasync with Sandbox.ephemeral(Image.linux()) as computer:@@ -85,7 +84,7 @@ await agent.run("Go back to the previous page")You can also call Browser Tool actions programmatically without an agent:```python-from agent.tools import BrowserTool+from cua.tools import BrowserToolbrowser = BrowserTool(interface=computer)@@ -140,9 +139,8 @@ The `pause_and_memorize_fact` action lets the agent store information for laterHere's a complete example automating a web form:```python-from cua_sandbox import Sandbox, Image-from agent import ComputerAgent-from agent.tools import BrowserTool+from cua import Sandbox, Image, ComputerAgent+from cua.tools import BrowserToolasync with Sandbox.ephemeral(Image.linux()) as computer:browser = BrowserTool(interface=computer)diff --git a/docs/content/docs/cua/guide/fundamentals/callbacks.mdx b/docs/content/docs/cua/guide/fundamentals/callbacks.mdxindex e267a6db73..13bc488858 100644--- a/docs/content/docs/cua/guide/fundamentals/callbacks.mdx+++ b/docs/content/docs/cua/guide/fundamentals/callbacks.mdx@@ -10,8 +10,8 @@ description: Hook into agent lifecycle events for logging, cost tracking, and moPass callbacks when creating your agent:```python-from agent import ComputerAgent-from agent.callbacks import LoggingCallback, BudgetManagerCallback+from cua import ComputerAgent+from cua.callbacks import LoggingCallback, BudgetManagerCallbackimport loggingagent = ComputerAgent(@@ -45,7 +45,7 @@ agent = ComputerAgent(Logs agent lifecycle events with configurable verbosity:```python-from agent.callbacks import LoggingCallback+from cua.callbacks import LoggingCallbackimport loggingagent = ComputerAgent(@@ -69,7 +69,7 @@ Logs include API calls, computer actions, text responses, and usage statistics.Tracks costs and stops execution when a budget limit is reached:```python-from agent.callbacks import BudgetManagerCallback+from cua.callbacks import BudgetManagerCallbackagent = ComputerAgent(model="...",@@ -96,7 +96,7 @@ When `raise_error=True`, the agent raises `BudgetExceededError` instead of stoppLimits how many screenshots are kept in the message history to prevent context overflow:```python-from agent.callbacks import ImageRetentionCallback+from cua.callbacks import ImageRetentionCallbackagent = ComputerAgent(model="...",@@ -119,7 +119,7 @@ Older screenshots are removed along with their associated computer call items.Saves complete agent conversations for debugging and analysis:```python-from agent.callbacks import TrajectorySaverCallback+from cua.callbacks import TrajectorySaverCallbackagent = ComputerAgent(model="...",@@ -146,7 +146,7 @@ See [Trajectories](/cua/guide/advanced/trajectories) for details on the saved foPrepends custom instructions to every LLM call:```python-from agent.callbacks import PromptInstructionsCallback+from cua.callbacks import PromptInstructionsCallbackagent = ComputerAgent(model="...",diff --git a/docs/content/docs/cua/guide/fundamentals/cua-vlm-router.mdx b/docs/content/docs/cua/guide/fundamentals/cua-vlm-router.mdxindex 3dabad5596..6da44f92b9 100644--- a/docs/content/docs/cua/guide/fundamentals/cua-vlm-router.mdx+++ b/docs/content/docs/cua/guide/fundamentals/cua-vlm-router.mdx@@ -8,8 +8,7 @@ Instead of deploying and managing computer-use vision language models yourself o## Setup```python-from cua_sandbox import Sandbox, Image-from agent import ComputerAgent+from cua import Sandbox, Image, ComputerAgentasync with Sandbox.ephemeral(Image.linux()) as computer:agent = ComputerAgent(diff --git a/docs/content/docs/cua/guide/fundamentals/vlms.mdx b/docs/content/docs/cua/guide/fundamentals/vlms.mdxindex 13402036c2..6788bf2efd 100644--- a/docs/content/docs/cua/guide/fundamentals/vlms.mdx+++ b/docs/content/docs/cua/guide/fundamentals/vlms.mdx@@ -10,8 +10,7 @@ A **Vision Language Model (VLM)** is the AI that powers your computer-use agent.Specify the model when creating your agent:```python-from cua_sandbox import Sandbox, Image-from agent import ComputerAgent+from cua import Sandbox, Image, ComputerAgentasync with Sandbox.ephemeral(Image.linux()) as computer:agent = ComputerAgent(@@ -64,7 +63,7 @@ export OPENAI_API_KEY="your-key"Gemini 2.5 Computer-Use is optimized for **browser automation** rather than full desktop control. Use it with the [Browser Tool](/cua/guide/fundamentals/browser-tool) for web-based tasks:```python-from agent.tools import BrowserTool+from cua.tools import BrowserTool# Use with BrowserTool for web automationagent = ComputerAgent(model="gemini-2.5-computer-use-preview-10-2025", tools=[browser])@@ -81,7 +80,7 @@ For full desktop computer-use, consider Anthropic Claude or OpenAI instead.Fara is Microsoft's browser automation model, available via Azure ML. Like Gemini 2.5, it's designed for web tasks and works with the [Browser Tool](/cua/guide/fundamentals/browser-tool):```python-from agent.tools import BrowserTool+from cua.tools import BrowserToolagent = ComputerAgent(model="azure_ml/Fara-7B",diff --git a/docs/content/docs/cua/guide/get-started/migrating-from-computer-sdk.mdx b/docs/content/docs/cua/guide/get-started/migrating-from-computer-sdk.mdxindex 3ba81bbdf4..0c79ef23bb 100644--- a/docs/content/docs/cua/guide/get-started/migrating-from-computer-sdk.mdx+++ b/docs/content/docs/cua/guide/get-started/migrating-from-computer-sdk.mdx@@ -22,7 +22,7 @@ The new Sandbox SDK (`cua-sandbox`) unifies everything: one package creates thepip install cua-computer# After-pip install cua-sandbox+pip install cua```## Import and instantiation@@ -43,7 +43,7 @@ await computer.run()**After:**```python-from cua_sandbox import Sandbox, Image+from cua import Sandbox, Image# Ephemeral (create + destroy automatically)async with Sandbox.ephemeral(Image.linux()) as sb:@@ -84,7 +84,7 @@ The old SDK used a `provider_type` string to select the runtime. The new SDK use| `"docker"` with QEMU Android | `Sandbox.ephemeral(Image.android(), local=True)` || `"lume"` | `Sandbox.ephemeral(Image.macos(), local=True)` || `"windows_sandbox"` | `Sandbox.ephemeral(Image.windows(), local=True)` |-| `use_host_computer_server=True` | `from cua_sandbox import Localhost; Localhost.connect()` |+| `use_host_computer_server=True` | `from cua import Localhost; Localhost.connect()` |## Before and after — full example@@ -116,7 +116,7 @@ asyncio.run(main())```pythonimport asyncio-from cua_sandbox import Sandbox, Image+from cua import Sandbox, Imageasync def main():async with Sandbox.ephemeral(Image.linux(), local=True) as sb:diff --git a/docs/content/docs/cua/guide/get-started/quickstart.mdx b/docs/content/docs/cua/guide/get-started/quickstart.mdxindex 3629be418a..192d4d8a84 100644--- a/docs/content/docs/cua/guide/get-started/quickstart.mdx+++ b/docs/content/docs/cua/guide/get-started/quickstart.mdx@@ -17,7 +17,7 @@ This guide gets you from zero to a working computer-use agent.## 1. Install```bash-pip install cua-sandbox "cua-agent[all]"+pip install cua```## 2. Hello World@@ -26,7 +26,7 @@ Create `hello.py`:```pythonimport asyncio-from cua_sandbox import Sandbox, Image+from cua import Sandbox, Imageasync def main():# local=True uses Docker — no API key needed@@ -62,8 +62,7 @@ Then create `agent.py`:```pythonimport asyncio-from cua_sandbox import Sandbox, Image-from agent import ComputerAgent+from cua import Sandbox, Image, ComputerAgentasync def main():async with Sandbox.ephemeral(Image.linux()) as sb:@@ -90,8 +89,7 @@ Call `get_display_url(share=True)` to get a shareable browser link to the live d```pythonimport asyncio-from cua_sandbox import Sandbox, Image-from agent import ComputerAgent+from cua import Sandbox, Image, ComputerAgentasync def main():async with Sandbox.ephemeral(Image.linux()) as sb:diff --git a/docs/content/docs/cua/guide/get-started/using-agent-sdk.mdx b/docs/content/docs/cua/guide/get-started/using-agent-sdk.mdxindex ea4645552c..ffa619bec8 100644--- a/docs/content/docs/cua/guide/get-started/using-agent-sdk.mdx+++ b/docs/content/docs/cua/guide/get-started/using-agent-sdk.mdx@@ -20,12 +20,12 @@ Cua Agent Framework provides:<Tab value="Python">**Using uv (recommended):**```bash- uv pip install "cua-agent[all]"+ uv pip install cua```**Or with pip:**```bash- pip install "cua-agent[all]"+ pip install cua```</Tab>@@ -49,8 +49,7 @@ Use Cua's inference API to access multiple model providers with a single API key```pythonimport osimport asyncio-from cua_sandbox import Sandbox, Image-from agent import ComputerAgent+from cua import Sandbox, Image, ComputerAgentos.environ["CUA_API_KEY"] = "sk_cua-api01_..."@@ -100,8 +99,7 @@ Use your own API keys from model providers like Anthropic, OpenAI, or others.```pythonimport asyncio-from cua_sandbox import Sandbox, Image-from agent import ComputerAgent+from cua import Sandbox, Image, ComputerAgent# Set your provider API keyimport osdiff --git a/docs/content/docs/cua/guide/get-started/using-sandbox-sdk.mdx b/docs/content/docs/cua/guide/get-started/using-sandbox-sdk.mdxindex 18178a9794..562589d05d 100644--- a/docs/content/docs/cua/guide/get-started/using-sandbox-sdk.mdx+++ b/docs/content/docs/cua/guide/get-started/using-sandbox-sdk.mdx@@ -15,13 +15,13 @@ The Sandbox SDK (`cua-sandbox`) lets you create and control sandboxes — take s## Installation```bash-pip install cua-sandbox+pip install cua```Or with uv:```bash-uv pip install cua-sandbox+uv pip install cua```## Create a Sandbox@@ -30,7 +30,7 @@ uv pip install cua-sandbox<Tab value="Cloud Linux Container">```pythonimport asyncio- from cua_sandbox import Sandbox, Image+ from cua import Sandbox, Imageasync def main():async with Sandbox.ephemeral(Image.linux()) as sb:@@ -48,7 +48,7 @@ uv pip install cua-sandbox<Tab value="Cloud Linux VM">```pythonimport asyncio- from cua_sandbox import Sandbox, Image+ from cua import Sandbox, Imageasync def main():async with Sandbox.ephemeral(Image.linux(kind="vm")) as sb:@@ -63,10 +63,46 @@ uv pip install cua-sandbox```Requires `CUA_API_KEY` environment variable.</Tab>+ <Tab value="Cloud macOS">+ ```python+ import asyncio+ from cua import Sandbox, Image++ async def main():+ async with Sandbox.ephemeral(Image.macos()) as sb:+ result = await sb.shell.run("sw_vers")+ print(result.stdout)++ screenshot = await sb.screenshot()+ with open("screenshot.png", "wb") as f:+ f.write(screenshot)++ asyncio.run(main())+ ```+ Requires `CUA_API_KEY` environment variable. Works on any host OS — no Mac needed.+ </Tab>+ <Tab value="Cloud Windows">+ ```python+ import asyncio+ from cua import Sandbox, Image++ async def main():+ async with Sandbox.ephemeral(Image.windows()) as sb:+ result = await sb.shell.run("ver")+ print(result.stdout)++ screenshot = await sb.screenshot()+ with open("screenshot.png", "wb") as f:+ f.write(screenshot)++ asyncio.run(main())+ ```+ Requires `CUA_API_KEY` environment variable.+ </Tab><Tab value="Local Linux">```pythonimport asyncio- from cua_sandbox import Sandbox, Image+ from cua import Sandbox, Imageasync def main():async with Sandbox.ephemeral(Image.linux(), local=True) as sb:@@ -84,7 +120,7 @@ uv pip install cua-sandbox<Tab value="Local macOS (Lume)">```pythonimport asyncio- from cua_sandbox import Sandbox, Image+ from cua import Sandbox, Imageasync def main():async with Sandbox.ephemeral(Image.macos(), local=True) as sb:@@ -102,7 +138,7 @@ uv pip install cua-sandbox<Tab value="Local Windows">```pythonimport asyncio- from cua_sandbox import Sandbox, Image+ from cua import Sandbox, Imageasync def main():async with Sandbox.ephemeral(Image.windows(), local=True) as sb:@@ -120,7 +156,7 @@ uv pip install cua-sandbox<Tab value="Local Android">```pythonimport asyncio- from cua_sandbox import Sandbox, Image+ from cua import Sandbox, Imageasync def main():async with Sandbox.ephemeral(Image.android(), local=True) as sb:@@ -181,7 +217,7 @@ For long-running workflows, create a named sandbox instead of ephemeral:# → {"name": "my-sandbox-name", "status": "ready"}# Connect from Python-from cua_sandbox import Sandbox+from cua import Sandboxasync with Sandbox.connect("my-sandbox-name", local=True) as sb:await sb.shell.run("echo connected")@@ -190,7 +226,7 @@ async with Sandbox.connect("my-sandbox-name", local=True) as sb:Or manage the full lifecycle in Python:```python-from cua_sandbox import Sandbox, Image+from cua import Sandbox, Image# Create and keep runningsb = await Sandbox.create(Image.linux(), local=True)diff --git a/docs/content/docs/cua/guide/get-started/what-is-cua.mdx b/docs/content/docs/cua/guide/get-started/what-is-cua.mdxindex be2532209f..c351fc1894 100644--- a/docs/content/docs/cua/guide/get-started/what-is-cua.mdx+++ b/docs/content/docs/cua/guide/get-started/what-is-cua.mdx@@ -7,8 +7,7 @@ Cua lets you spin up isolated desktop environments — Linux, macOS, Windows, An```pythonimport asyncio-from cua_sandbox import Sandbox, Image-from agent import ComputerAgent+from cua import Sandbox, Image, ComputerAgentasync def main():async with Sandbox.ephemeral(Image.linux(), local=True) as sb:@@ -30,7 +29,7 @@ asyncio.run(main())## Install```bash-pip install cua-sandbox "cua-agent[all]"+pip install cua```No account needed to run locally with Docker. For cloud sandboxes and hosted models, get a free API key at [cua.ai](https://cua.ai/signin).diff --git a/docs/content/docs/cua/guide/integrations/benchmarks/index.mdx b/docs/content/docs/cua/guide/integrations/benchmarks/index.mdxindex 1c9f6ba12a..8502b9ebed 100644--- a/docs/content/docs/cua/guide/integrations/benchmarks/index.mdx+++ b/docs/content/docs/cua/guide/integrations/benchmarks/index.mdx@@ -22,7 +22,7 @@ git clone https://github.com/trycua/cuacd libs/python/agent/benchmarks# Install dependencies-pip install "cua-agent[all]"+pip install cua# Run a benchmarkpython ss-v2.pydiff --git a/docs/content/docs/cua/guide/integrations/hud.mdx b/docs/content/docs/cua/guide/integrations/hud.mdxindex 021dac9748..54dd48bfba 100644--- a/docs/content/docs/cua/guide/integrations/hud.mdx+++ b/docs/content/docs/cua/guide/integrations/hud.mdx@@ -14,7 +14,7 @@ The HUD integration allows an agent to be benchmarked using the [HUD framework](First, install the required package:```bash-pip install "cua-agent[hud]"+pip install "cua[hud]"## or install hud-python directly# pip install hud-python==0.4.12```diff --git a/docs/content/docs/cua/guide/integrations/laminar.mdx b/docs/content/docs/cua/guide/integrations/laminar.mdxindex 0b3f6ac757..d877636bd1 100644--- a/docs/content/docs/cua/guide/integrations/laminar.mdx+++ b/docs/content/docs/cua/guide/integrations/laminar.mdx@@ -23,8 +23,7 @@ import osimport litellm-from agent import ComputerAgent-from cua_sandbox import Sandbox, Image+from cua import ComputerAgent, Sandbox, Imagefrom lmnr import Laminar, LaminarLiteLLMCallback # [!code highlight]Laminar.initialize() # [!code highlight]diff --git a/docs/content/docs/cua/guide/sandbox/images.mdx b/docs/content/docs/cua/guide/sandbox/images.mdxindex 7385191614..5142d113d1 100644--- a/docs/content/docs/cua/guide/sandbox/images.mdx+++ b/docs/content/docs/cua/guide/sandbox/images.mdx@@ -10,7 +10,7 @@ An `Image` describes the operating system and software environment your sandbox## Built-in images```python-from cua_sandbox import Image+from cua import ImageImage.linux() # Ubuntu 24.04 container (default)Image.linux(kind="vm") # Ubuntu 24.04 full VMdiff --git a/docs/content/docs/cua/guide/sandbox/interactive-shell.mdx b/docs/content/docs/cua/guide/sandbox/interactive-shell.mdxindex 190216370c..b7dc2b0844 100644--- a/docs/content/docs/cua/guide/sandbox/interactive-shell.mdx+++ b/docs/content/docs/cua/guide/sandbox/interactive-shell.mdx@@ -29,7 +29,7 @@ The shell is fully interactive — arrow keys, tab completion, and `Ctrl+C` all## Python SDK```python-from cua_sandbox import Sandbox, Image+from cua import Sandbox, Imageasync with Sandbox.create(provider_type="docker", name="my-container") as c:handle = await c.pty.create(diff --git a/docs/content/docs/cua/guide/sandbox/lifecycle.mdx b/docs/content/docs/cua/guide/sandbox/lifecycle.mdxindex accc171459..888c51fc6c 100644--- a/docs/content/docs/cua/guide/sandbox/lifecycle.mdx+++ b/docs/content/docs/cua/guide/sandbox/lifecycle.mdx@@ -30,7 +30,7 @@ Use this for scripts, CI jobs, and any task where you want the sandbox to disapp```pythonimport asyncio-from cua_sandbox import Sandbox, Image+from cua import Sandbox, Imageasync def main():async with Sandbox.ephemeral(Image.linux()) as sb:@@ -51,7 +51,7 @@ Use this when you need the sandbox to outlive your Python process, or when you w```pythonimport asyncio-from cua_sandbox import Sandbox, Image+from cua import Sandbox, Imageasync def main():# Create and get back a handle — sandbox keeps running after this script exitsdiff --git a/docs/content/docs/cua/guide/sandbox/scale-out.mdx b/docs/content/docs/cua/guide/sandbox/scale-out.mdxindex 41cc8ea059..8d66adbab0 100644--- a/docs/content/docs/cua/guide/sandbox/scale-out.mdx+++ b/docs/content/docs/cua/guide/sandbox/scale-out.mdx@@ -13,7 +13,7 @@ Because `Sandbox.ephemeral` and `Sandbox.create` are async, you can run many san```pythonimport asyncio-from cua_sandbox import Sandbox, Image+from cua import Sandbox, Imageasync def run_task(task: str) -> str:async with Sandbox.ephemeral(Image.linux()) as sb:@@ -34,7 +34,7 @@ If you have a large batch, use a semaphore to cap the number of sandboxes runnin```pythonimport asyncio-from cua_sandbox import Sandbox, Image+from cua import Sandbox, ImageMAX_CONCURRENT = 5@@ -59,7 +59,7 @@ For dynamic workloads where tasks arrive at runtime, use `asyncio.Queue`:```pythonimport asyncio-from cua_sandbox import Sandbox, Image+from cua import Sandbox, Imageasync def worker(queue: asyncio.Queue, worker_id: int):while True:@@ -97,7 +97,7 @@ A common pattern for visual testing — take screenshots across multiple environ```pythonimport asyncio-from cua_sandbox import Sandbox, Image+from cua import Sandbox, Imageasync def screenshot_env(image: Image, label: str) -> tuple[str, bytes]:async with Sandbox.ephemeral(image) as sb:@@ -127,8 +127,7 @@ Run the same task across multiple sandboxes to compare model outputs or increase```pythonimport asyncio-from cua_sandbox import Sandbox, Image-from agent import ComputerAgent+from cua import Sandbox, Image, ComputerAgentasync def run_agent(task: str, run_id: int) -> dict:async with Sandbox.ephemeral(Image.linux()) as sb:diff --git a/docs/content/docs/cua/guide/sandbox/secrets.mdx b/docs/content/docs/cua/guide/sandbox/secrets.mdxindex e7d4673138..7771174362 100644--- a/docs/content/docs/cua/guide/sandbox/secrets.mdx+++ b/docs/content/docs/cua/guide/sandbox/secrets.mdx@@ -26,7 +26,7 @@ CUA_API_KEY=sk_cua-...from dotenv import load_dotenvload_dotenv()-from cua_sandbox import Sandbox, Image+from cua import Sandbox, Image```You can also pass the key explicitly if you manage it programmatically:@@ -45,7 +45,7 @@ The recommended pattern is to read secrets from the host environment and inject```pythonimport osimport asyncio-from cua_sandbox import Sandbox, Image+from cua import Sandbox, Imageasync def main():db_url = os.environ["DATABASE_URL"] # read from host@@ -78,7 +78,7 @@ result = await sb.shell.run(script)Use `.env()` on the `Image` builder for configuration that isn't sensitive — feature flags, log levels, app settings:```python-from cua_sandbox import Image+from cua import Imageimg = (Image.linux()diff --git a/docs/content/docs/cua/guide/sandbox/tunneling.mdx b/docs/content/docs/cua/guide/sandbox/tunneling.mdxindex b067e6582d..d2694ed3d5 100644--- a/docs/content/docs/cua/guide/sandbox/tunneling.mdx+++ b/docs/content/docs/cua/guide/sandbox/tunneling.mdx@@ -10,7 +10,7 @@ import { Callout } from 'fumadocs-ui/components/callout';## Basic usage```python-from cua_sandbox import Sandbox, Image+from cua import Sandbox, Imageasync with Sandbox.ephemeral(Image.linux()) as sb:# Start something inside the sandbox@@ -73,7 +73,7 @@ async with sb.tunnel.forward("chrome_devtools_remote") as t:Forward the DevTools port from a sandbox browser to use CDP tools locally:```python-from cua_sandbox import Sandbox, Image+from cua import Sandbox, Imageasync with Sandbox.ephemeral(Image.linux()) as sb:await sb.shell.run("google-chrome --remote-debugging-port=9222 --headless &")diff --git a/docs/content/docs/cua/reference/agent-sdk/changelog.mdx b/docs/content/docs/cua/reference/agent-sdk/changelog.mdxindex 7a4019b688..ac90a87067 100644--- a/docs/content/docs/cua/reference/agent-sdk/changelog.mdx+++ b/docs/content/docs/cua/reference/agent-sdk/changelog.mdx@@ -188,7 +188,7 @@ New Contributors**Dependencies:** cua-computer: latest, cua-som: latest- Stream MCP responses instead of buffering by @YeIIcw in https://github.com/trycua/cua/pull/427-- Add support for Gemini CUA model by @ddupont808 in https://github.com/trycua/cua/pull/472+- Add support for Gemini Cua model by @ddupont808 in https://github.com/trycua/cua/pull/472- Add support for Claude Haiku 4.5 by @ddupont808 in https://github.com/trycua/cua/pull/474- Add bump2version configuration for all Python packages by @r33drichards in https://github.com/trycua/cua/pull/463diff --git a/docs/content/docs/cua/reference/agent-sdk/v0.3/api.mdx b/docs/content/docs/cua/reference/agent-sdk/v0.3/api.mdxindex 9dcc6f85bf..f507faa81f 100644--- a/docs/content/docs/cua/reference/agent-sdk/v0.3/api.mdx+++ b/docs/content/docs/cua/reference/agent-sdk/v0.3/api.mdx@@ -23,7 +23,7 @@ import { Callout } from 'fumadocs-ui/components/callout';<span className="text-sm text-fd-muted-foreground">pip install cua-agent==0.3.2</span></div>-CUA (Computer Use) Agent for AI-driven computer interaction.+Cua (Computer Use) Agent for AI-driven computer interaction.## Classesdiff --git a/docs/content/docs/cua/reference/agent-sdk/v0.6/api.mdx b/docs/content/docs/cua/reference/agent-sdk/v0.6/api.mdxindex d28c71bf7e..871a4d41d2 100644--- a/docs/content/docs/cua/reference/agent-sdk/v0.6/api.mdx+++ b/docs/content/docs/cua/reference/agent-sdk/v0.6/api.mdx@@ -91,7 +91,7 @@ def open(self, port: Optional[int] = None)Start the playground server and open it in the browser.This method starts a local HTTP server that exposes the /responses endpoint-and automatically opens the CUA playground interface in the default browser.+and automatically opens the Cua playground interface in the default browser.Args:port: Port to run the server on. If None, finds an available port automatically.diff --git a/docs/content/docs/cua/reference/cli/index.mdx b/docs/content/docs/cua/reference/cli/index.mdxindex f7fa87bf0b..06fb35b9f4 100644--- a/docs/content/docs/cua/reference/cli/index.mdx+++ b/docs/content/docs/cua/reference/cli/index.mdx@@ -21,13 +21,13 @@ import { VersionHeader } from '@/components/version-selector';packageName="cua-cli"/>-CUA CLI - Unified command-line interface for Computer-Use Agents.+Cua CLI - Unified command-line interface for Computer-Use Agents.---## main-Main entry point for CUA CLI.+Main entry point for Cua CLI.### print_error@@ -57,7 +57,7 @@ Main entry point for the CLI.## auth-Authentication module for CUA CLI.+Authentication module for Cua CLI.---@@ -172,7 +172,7 @@ Save an API key to the credential store.## utils-Utility modules for CUA CLI.+Utility modules for Cua CLI.### run_asyncdiff --git a/docs/content/docs/cua/reference/computer-sdk/v0.3/api.mdx b/docs/content/docs/cua/reference/computer-sdk/v0.3/api.mdxindex b4f1973cfe..eb129dc5da 100644--- a/docs/content/docs/cua/reference/computer-sdk/v0.3/api.mdx+++ b/docs/content/docs/cua/reference/computer-sdk/v0.3/api.mdx@@ -23,7 +23,7 @@ import { Callout } from 'fumadocs-ui/components/callout';<span className="text-sm text-fd-muted-foreground">pip install cua-computer==0.3.7</span></div>-CUA Computer Interface for cross-platform computer control.+Cua Computer Interface for cross-platform computer control.## Classesdiff --git a/docs/content/docs/cua/reference/computer-sdk/v0.4/api.mdx b/docs/content/docs/cua/reference/computer-sdk/v0.4/api.mdxindex 9a865a16d4..a32d7d2f8d 100644--- a/docs/content/docs/cua/reference/computer-sdk/v0.4/api.mdx+++ b/docs/content/docs/cua/reference/computer-sdk/v0.4/api.mdx@@ -23,7 +23,7 @@ import { Callout } from 'fumadocs-ui/components/callout';<span className="text-sm text-fd-muted-foreground">pip install cua-computer==0.4.19</span></div>-CUA Computer Interface for cross-platform computer control.+Cua Computer Interface for cross-platform computer control.## Classesdiff --git a/docs/content/docs/cua/reference/sandbox-sdk/index.mdx b/docs/content/docs/cua/reference/sandbox-sdk/index.mdxindex 4f8f39af93..47d1d30dfc 100644--- a/docs/content/docs/cua/reference/sandbox-sdk/index.mdx+++ b/docs/content/docs/cua/reference/sandbox-sdk/index.mdx@@ -25,7 +25,7 @@ cua-sandbox — ephemeral and persistent sandboxed computer environments.Usage::- import cua_sandbox as cua+ import cua# Configure API accesscua.configure(api_key="sk-...")@@ -46,15 +46,15 @@ Usage::| [`Localhost`](#localhost) | Direct host control via cua_auto — no sandboxing. || [`Sandbox`](#sandbox) | A sandboxed computer environment. || [`SandboxInfo`](#sandboxinfo) | Metadata for a local or cloud sandbox. |-| [`CloudTransport`](#cloudtransport) | Transport that provisions / connects to a CUA cloud VM. |+| [`CloudTransport`](#cloudtransport) | Transport that provisions / connects to a Cua cloud VM. |## Functions| Function | Description ||----------|-------------|-| [`login`](#login) | Open the CUA login page in a browser and store credentials. |+| [`login`](#login) | Open the Cua login page in a browser and store credentials. || [`whoami`](#whoami) | Return info about the authenticated user. |-| [`configure`](#configure) | Set global configuration for the CUA SDK. |+| [`configure`](#configure) | Set global configuration for the Cua SDK. |---@@ -499,7 +499,7 @@ automatically.|------|------|-------------|| `image` | `Any` | Image to run (e.g. ``Image.desktop("ubuntu")``). || `name` | `Any` | Optional name to assign to the sandbox. |-| `api_key` | `Any` | CUA API key for cloud sandboxes. |+| `api_key` | `Any` | Cua API key for cloud sandboxes. || `local` | `Any` | Use a local runtime instead of cloud. || `runtime` | `Any` | Explicit runtime backend (DockerRuntime, QEMURuntime, etc.). || `cpu` | `Any` | Number of CPUs for the cloud sandbox. |@@ -532,7 +532,7 @@ manager, ``disconnect()`` is called on exit — the sandbox keeps running.| Name | Type | Description ||------|------|-------------|| `name` | `Any` | Name of the existing sandbox. |-| `api_key` | `Any` | CUA API key for cloud sandboxes. |+| `api_key` | `Any` | Cua API key for cloud sandboxes. || `ws_url` | `Any` | WebSocket URL for a remote computer-server. || `http_url` | `Any` | HTTP base URL for a remote computer-server. || `container_name` | `Any` | Container name for cloud auth (HTTP transport). |@@ -565,7 +565,7 @@ Create an ephemeral sandbox that is automatically destroyed on exit.|------|------|-------------|| `image` | `Any` | Image to run (e.g. ``Image.desktop("ubuntu")``). || `name` | `Any` | Optional name to assign to the sandbox. |-| `api_key` | `Any` | CUA API key for cloud sandboxes. |+| `api_key` | `Any` | Cua API key for cloud sandboxes. || `local` | `Any` | Use a local runtime instead of cloud. || `runtime` | `Any` | Explicit runtime backend (DockerRuntime, QEMURuntime, etc.). || `cpu` | `Any` | Number of CPUs for the cloud sandbox. |@@ -594,7 +594,7 @@ List running and suspended sandboxes.| Name | Type | Description ||------|------|-------------|| `local` | `Any` | If True, list local sandboxes (Lume, Docker, QEMU). If False, list cloud sandboxes. |-| `api_key` | `Any` | CUA API key for cloud sandboxes. |+| `api_key` | `Any` | Cua API key for cloud sandboxes. |#### Sandbox.get_info@@ -610,7 +610,7 @@ Get metadata for a specific sandbox.|------|------|-------------|| `name` | `Any` | Sandbox name. || `local` | `Any` | If True, look up in local runtimes. |-| `api_key` | `Any` | CUA API key for cloud. |+| `api_key` | `Any` | Cua API key for cloud. |#### Sandbox.suspend@@ -631,7 +631,7 @@ For cloud: calls POST /v1/vms/\{name\}/stop.|------|------|-------------|| `name` | `Any` | Sandbox name. || `local` | `Any` | If True, operate on a local sandbox. |-| `api_key` | `Any` | CUA API key for cloud. |+| `api_key` | `Any` | Cua API key for cloud. |#### Sandbox.resume@@ -647,7 +647,7 @@ Resume a suspended sandbox and return a connected Sandbox.|------|------|-------------|| `name` | `Any` | Sandbox name. || `local` | `Any` | If True, resume a local sandbox. |-| `api_key` | `Any` | CUA API key for cloud. |+| `api_key` | `Any` | Cua API key for cloud. |**Returns:** A connected Sandbox ready to use.@@ -665,7 +665,7 @@ Restart a sandbox (suspend then resume) and return a connected Sandbox.|------|------|-------------|| `name` | `Any` | Sandbox name. || `local` | `Any` | If True, restart a local sandbox. |-| `api_key` | `Any` | CUA API key for cloud. |+| `api_key` | `Any` | Cua API key for cloud. |**Returns:** A connected Sandbox ready to use.@@ -686,7 +686,7 @@ For cloud sandboxes, calls DELETE /v1/vms/\{name\}.|------|------|-------------|| `name` | `Any` | Sandbox name. || `local` | `Any` | If True, delete a local sandbox. |-| `api_key` | `Any` | CUA API key for cloud. |+| `api_key` | `Any` | Cua API key for cloud. |---@@ -719,7 +719,7 @@ SandboxInfo(self, name: str, status: str, source: str, os_type: Optional[str] =*Inherits from: Transport*-Transport that provisions / connects to a CUA cloud VM.+Transport that provisions / connects to a Cua cloud VM.### Constructor@@ -815,7 +815,7 @@ async def get_display_url(self, share: bool = False) -> strdef login(base_url: Optional[str] = None) -> None```-Open the CUA login page in a browser and store credentials.+Open the Cua login page in a browser and store credentials.This initiates a Clerk-based browser authentication flow.The user completes login in their browser, and the resulting@@ -829,7 +829,7 @@ def whoami(api_key: Optional[str] = None) -> Dict[str, Any]Return info about the authenticated user.-**Returns:** Dict with user info (id, email, etc.) from the CUA API.+**Returns:** Dict with user info (id, email, etc.) from the Cua API.## configure@@ -837,14 +837,14 @@ Return info about the authenticated user.def configure(api_key: Optional[str] = None, base_url: Optional[str] = None) -> None```-Set global configuration for the CUA SDK.+Set global configuration for the Cua SDK.**Parameters:**| Name | Type | Description ||------|------|-------------|| `api_key` | `Any` | API key for cloud sandboxes. |-| `base_url` | `Any` | Base URL for the CUA cloud API. |+| `base_url` | `Any` | Base URL for the Cua cloud API. |---@@ -856,7 +856,7 @@ All cua_auto calls are sync; async wrappers use asyncio.to_thread().Usage::- from cua_sandbox import localhost+ from cua import localhostasync with localhost() as host:await host.mouse.click(100, 200)@@ -1011,7 +1011,7 @@ as interface objects backed by a Transport.Usage::- from cua_sandbox import Sandbox, Image+ from cua import Sandbox, Image# Provision a new persistent sandboxsb = await Sandbox.create(Image.desktop("ubuntu"))@@ -1372,7 +1372,7 @@ Return a URL to view this sandbox's display.*Inherits from: Transport*-Transport that provisions / connects to a CUA cloud VM.+Transport that provisions / connects to a Cua cloud VM.### Constructor@@ -1812,7 +1812,7 @@ automatically.|------|------|-------------|| `image` | `Any` | Image to run (e.g. ``Image.desktop("ubuntu")``). || `name` | `Any` | Optional name to assign to the sandbox. |-| `api_key` | `Any` | CUA API key for cloud sandboxes. |+| `api_key` | `Any` | Cua API key for cloud sandboxes. || `local` | `Any` | Use a local runtime instead of cloud. || `runtime` | `Any` | Explicit runtime backend (DockerRuntime, QEMURuntime, etc.). || `cpu` | `Any` | Number of CPUs for the cloud sandbox. |@@ -1845,7 +1845,7 @@ manager, ``disconnect()`` is called on exit — the sandbox keeps running.| Name | Type | Description ||------|------|-------------|| `name` | `Any` | Name of the existing sandbox. |-| `api_key` | `Any` | CUA API key for cloud sandboxes. |+| `api_key` | `Any` | Cua API key for cloud sandboxes. || `ws_url` | `Any` | WebSocket URL for a remote computer-server. || `http_url` | `Any` | HTTP base URL for a remote computer-server. || `container_name` | `Any` | Container name for cloud auth (HTTP transport). |@@ -1878,7 +1878,7 @@ Create an ephemeral sandbox that is automatically destroyed on exit.|------|------|-------------|| `image` | `Any` | Image to run (e.g. ``Image.desktop("ubuntu")``). || `name` | `Any` | Optional name to assign to the sandbox. |-| `api_key` | `Any` | CUA API key for cloud sandboxes. |+| `api_key` | `Any` | Cua API key for cloud sandboxes. || `local` | `Any` | Use a local runtime instead of cloud. || `runtime` | `Any` | Explicit runtime backend (DockerRuntime, QEMURuntime, etc.). || `cpu` | `Any` | Number of CPUs for the cloud sandbox. |@@ -1907,7 +1907,7 @@ List running and suspended sandboxes.| Name | Type | Description ||------|------|-------------|| `local` | `Any` | If True, list local sandboxes (Lume, Docker, QEMU). If False, list cloud sandboxes. |-| `api_key` | `Any` | CUA API key for cloud sandboxes. |+| `api_key` | `Any` | Cua API key for cloud sandboxes. |#### Sandbox.get_info@@ -1923,7 +1923,7 @@ Get metadata for a specific sandbox.|------|------|-------------|| `name` | `Any` | Sandbox name. || `local` | `Any` | If True, look up in local runtimes. |-| `api_key` | `Any` | CUA API key for cloud. |+| `api_key` | `Any` | Cua API key for cloud. |#### Sandbox.suspend@@ -1944,7 +1944,7 @@ For cloud: calls POST /v1/vms/\{name\}/stop.|------|------|-------------|| `name` | `Any` | Sandbox name. || `local` | `Any` | If True, operate on a local sandbox. |-| `api_key` | `Any` | CUA API key for cloud. |+| `api_key` | `Any` | Cua API key for cloud. |#### Sandbox.resume@@ -1960,7 +1960,7 @@ Resume a suspended sandbox and return a connected Sandbox.|------|------|-------------|| `name` | `Any` | Sandbox name. || `local` | `Any` | If True, resume a local sandbox. |-| `api_key` | `Any` | CUA API key for cloud. |+| `api_key` | `Any` | Cua API key for cloud. |**Returns:** A connected Sandbox ready to use.@@ -1978,7 +1978,7 @@ Restart a sandbox (suspend then resume) and return a connected Sandbox.|------|------|-------------|| `name` | `Any` | Sandbox name. || `local` | `Any` | If True, restart a local sandbox. |-| `api_key` | `Any` | CUA API key for cloud. |+| `api_key` | `Any` | Cua API key for cloud. |**Returns:** A connected Sandbox ready to use.@@ -1999,7 +1999,7 @@ For cloud sandboxes, calls DELETE /v1/vms/\{name\}.|------|------|-------------|| `name` | `Any` | Sandbox name. || `local` | `Any` | If True, delete a local sandbox. |-| `api_key` | `Any` | CUA API key for cloud. |+| `api_key` | `Any` | Cua API key for cloud. |### sandbox@@ -2024,7 +2024,7 @@ for cloud API or cloud-init consumption.Usage::- from cua_sandbox import Image+ from cua import Imageimg = (Image.linux("ubuntu", "24.04")diff --git a/docs/content/docs/cua/reference/sandbox-sdk/interfaces.mdx b/docs/content/docs/cua/reference/sandbox-sdk/interfaces.mdxindex c975eebc8c..584b7e0a42 100644--- a/docs/content/docs/cua/reference/sandbox-sdk/interfaces.mdx+++ b/docs/content/docs/cua/reference/sandbox-sdk/interfaces.mdx@@ -292,7 +292,7 @@ await sb.window.close()`Localhost` gives you the same interface as `Sandbox` but operates directly on the machine running Python, with no sandbox involved. Useful for local automation or testing.```python-from cua_sandbox import Localhost+from cua import Localhostasync with Localhost.connect() as host:result = await host.shell.run("echo hello")diff --git a/docs/content/docs/cua/vibe-coding-mcp.mdx b/docs/content/docs/cua/vibe-coding-mcp.mdxindex 55db779904..e4e06a74d9 100644--- a/docs/content/docs/cua/vibe-coding-mcp.mdx+++ b/docs/content/docs/cua/vibe-coding-mcp.mdx@@ -1,14 +1,14 @@---title: Vibe Coding MCP-description: Connect your AI agents to CUA documentation and source code+description: Connect your AI agents to Cua documentation and source code----The CUA MCP server equips AI coding agents with deep knowledge about CUA's APIs, patterns, source code, and best practices. When connected to your development environment, it enables AI assistants to:+The Cua MCP server equips AI coding agents with deep knowledge about Cua's APIs, patterns, source code, and best practices. When connected to your development environment, it enables AI assistants to:- **Search documentation** with full-text and semantic search- **Explore source code** across all versions and components- **Generate accurate code** with context from the actual codebase-- **Understand CUA internals** by querying versioned implementations+- **Understand Cua internals** by querying versioned implementations## Server URL@@ -41,12 +41,12 @@ The MCP server exposes four read-only query tools:1. Press `Shift+Command+J` (Mac) or `Shift+Ctrl+J` (Windows/Linux) to open settings2. Find "MCP Tools" in the left sidebar3. Click "Add Custom MCP" to open `mcp.json`-4. Add the CUA MCP server configuration:+4. Add the Cua MCP server configuration:```json{"mcpServers": {- "CUA MCP": {+ "Cua MCP": {"url": "https://vk-mcp.cua.ai/mcp"}}@@ -89,7 +89,7 @@ claude mcp remove cua-mcp -s local1. Go to **Settings** > **Connectors**2. Click **Add custom connector**3. Enter the following:- - **Name**: `CUA MCP`+ - **Name**: `Cua MCP`- **URL**: `https://vk-mcp.cua.ai/mcp`4. Click **Add**@@ -112,7 +112,7 @@ Configuration file location:3. Select **MCP Servers**4. Click **Remote Servers** tab5. Enter:- - **Server Name**: `CUA MCP`+ - **Server Name**: `Cua MCP`- **Server URL**: `https://vk-mcp.cua.ai/mcp`6. Click **Add Server**@@ -124,7 +124,7 @@ Configuration file location:```json{"servers": {- "CUA MCP": {+ "Cua MCP": {"url": "https://vk-mcp.cua.ai/mcp"}}@@ -146,7 +146,7 @@ https://vk-mcp.cua.ai/mcp```json{"servers": {- "CUA MCP": {+ "Cua MCP": {"url": "https://vk-mcp.cua.ai/mcp"}}diff --git a/docs/content/docs/cuabench/guide/fundamentals/agent-traces.mdx b/docs/content/docs/cuabench/guide/fundamentals/agent-traces.mdxindex 70ca0d2924..037f8fdca5 100644--- a/docs/content/docs/cuabench/guide/fundamentals/agent-traces.mdx+++ b/docs/content/docs/cuabench/guide/fundamentals/agent-traces.mdx@@ -12,7 +12,7 @@ After running a task with an agent, traces are saved to `~/.local/share/cua-benc```~/.local/share/cua-bench/runs/96d41b51/slack_env_v0/├── run.log # Execution logs-├── task_0_agent_logs/ # CUA Agent SDK trajectories (if using cua-agent)+├── task_0_agent_logs/ # Cua Agent SDK trajectories (if using cua-agent)│ └── trajectories/│ └── 2026-01-07_claudesonnet4_210819_2a23/│ ├── metadata.json # Agent turns, model responses, usagediff --git a/docs/content/docs/cuabench/guide/getting-started/installation.mdx b/docs/content/docs/cuabench/guide/getting-started/installation.mdxindex 4c7e3b0281..06a0939625 100644--- a/docs/content/docs/cuabench/guide/getting-started/installation.mdx+++ b/docs/content/docs/cuabench/guide/getting-started/installation.mdx@@ -84,7 +84,7 @@ Commands:trace View and manage trace datasetsdataset Manage datasets and build from outputsprune Clean up cua-bench data, images, and Docker resources- login Authenticate with CUA Cloud to get API token+ login Authenticate with Cua Cloud to get API tokenOptions:-h, --help Show this help message and exitdiff --git a/docs/content/docs/cuabench/reference/api.mdx b/docs/content/docs/cuabench/reference/api.mdxindex 4258fd13bd..0814b9caed 100644--- a/docs/content/docs/cuabench/reference/api.mdx+++ b/docs/content/docs/cuabench/reference/api.mdx@@ -3795,7 +3795,7 @@ Failure mode for agent execution.*Inherits from: BaseAgent*-Agent implementation using the CUA Computer Agent SDK.+Agent implementation using the Cua Computer Agent SDK.### Constructor@@ -3824,7 +3824,7 @@ def name() -> strasync def perform_task(self, task_description: str, session: DesktopSession, logging_dir: Path | None = None, tracer = None) -> AgentResult```-Perform a task using the CUA Computer Agent.+Perform a task using the Cua Computer Agent.**Parameters:**@@ -4127,7 +4127,7 @@ Sessions module for async container management.*Inherits from: ABC*-Base class for session providers (Docker, CUA Cloud, etc.).+Base class for session providers (Docker, Cua Cloud, etc.).### Methods@@ -4226,7 +4226,7 @@ Create a session provider for the specified provider.| Name | Type | Description ||------|------|-------------|-| `provider_name` | `Any` | Name of the provider: - "local": Run locally using Docker (webtop) or QEMU/KVM (winarena) - "cloud": Run on CUA Cloud (GCP Batch for webtop, Azure Batch for winarena) - "docker": (legacy) Alias for "local" |+| `provider_name` | `Any` | Name of the provider: - "local": Run locally using Docker (webtop) or QEMU/KVM (winarena) - "cloud": Run on Cua Cloud (GCP Batch for webtop, Azure Batch for winarena) - "docker": (legacy) Alias for "local" || `env_type` | `Any` | Optional environment type hint ("webtop" or "winarena"). Used by local provider to select appropriate backend. |**Returns:** SessionProvider instance@@ -4721,7 +4721,7 @@ Telemetry module for cua-bench.This module provides analytics for tracking feature usage, user workflows,and system performance. All telemetry is routed through cua-core's PostHog-infrastructure for consistency across the CUA ecosystem.+infrastructure for consistency across the Cua ecosystem.Events tracked:- Tier 1 (Core): command_invoked, task_execution_started, task_evaluation_completed, batch_job_starteddiff --git a/docs/content/docs/lume/reference/changelog.mdx b/docs/content/docs/lume/reference/changelog.mdxindex abfec79aa1..21af0b5d85 100644--- a/docs/content/docs/lume/reference/changelog.mdx+++ b/docs/content/docs/lume/reference/changelog.mdx@@ -210,10 +210,10 @@ Maintenance release.### v0.2.23 (2025-12-23)- Update README badges with sky/emerald colors and larger logo by @f-trycua in https://github.com/trycua/cua/pull/641-- Add QEMU Ubuntu 22.04 template with CUA computer-server support by @synacktraa in https://github.com/trycua/cua/pull/622-- Add QEMU Windows 11 template with CUA computer-server support by @synacktraa in https://github.com/trycua/cua/pull/551+- Add QEMU Ubuntu 22.04 template with Cua computer-server support by @synacktraa in https://github.com/trycua/cua/pull/622+- Add QEMU Windows 11 template with Cua computer-server support by @synacktraa in https://github.com/trycua/cua/pull/551- docs: update intro page with hero image and Geist font by @f-trycua in https://github.com/trycua/cua/pull/642-- docs: expand CUA description with screenshot-VLM-action loop by @f-trycua in https://github.com/trycua/cua/pull/643+- docs: expand Cua description with screenshot-VLM-action loop by @f-trycua in https://github.com/trycua/cua/pull/643- F trycua/docs hero image by @f-trycua in https://github.com/trycua/cua/pull/644- Introduce cua-bench-ui submodules (webview API, configurable ports, improved python RPC) by @ddupont808 in https://github.com/trycua/cua/pull/645- Replace PyQt6 with PySide6 by @ddupont808 in https://github.com/trycua/cua/pull/646diff --git a/libs/python/cua/cua/callbacks.py b/libs/python/cua/cua/callbacks.pynew file mode 100644index 0000000000..660b701d1a--- /dev/null+++ b/libs/python/cua/cua/callbacks.py@@ -0,0 +1,32 @@+"""cua.callbacks — agent lifecycle callback handlers.++Usage::++ from cua.callbacks import LoggingCallback, BudgetManagerCallback+"""++from agent.callbacks import (+ AsyncCallbackHandler,+ BudgetManagerCallback,+ ImageRetentionCallback,+ LoggingCallback,+ OperatorNormalizerCallback,+ OtelCallback,+ OtelErrorCallback,+ PromptInstructionsCallback,+ TelemetryCallback,+ TrajectorySaverCallback,+)++__all__ = [+ "AsyncCallbackHandler",+ "ImageRetentionCallback",+ "LoggingCallback",+ "TrajectorySaverCallback",+ "BudgetManagerCallback",+ "TelemetryCallback",+ "OtelCallback",+ "OtelErrorCallback",+ "OperatorNormalizerCallback",+ "PromptInstructionsCallback",+]diff --git a/libs/python/cua/cua/runtime.py b/libs/python/cua/cua/runtime.pynew file mode 100644index 0000000000..7b21a6c1a8--- /dev/null+++ b/libs/python/cua/cua/runtime.py@@ -0,0 +1,34 @@+"""cua.runtime — sandbox runtime backends.++Usage::++ from cua.runtime import QEMURuntime, TartRuntime+"""++from cua_sandbox.runtime import (+ AndroidEmulatorRuntime,+ DockerRuntime,+ HyperVRuntime,+ LumeRuntime,+ QEMUBaremetalRuntime,+ QEMUDockerRuntime,+ QEMURuntime,+ QEMUWSL2Runtime,+ Runtime,+ RuntimeInfo,+ TartRuntime,+)++__all__ = [+ "Runtime",+ "RuntimeInfo",+ "DockerRuntime",+ "QEMURuntime",+ "QEMUDockerRuntime",+ "QEMUBaremetalRuntime",+ "QEMUWSL2Runtime",+ "LumeRuntime",+ "HyperVRuntime",+ "AndroidEmulatorRuntime",+ "TartRuntime",+]diff --git a/libs/python/cua/cua/tools.py b/libs/python/cua/cua/tools.pynew file mode 100644index 0000000000..bf4b4b22ad--- /dev/null+++ b/libs/python/cua/cua/tools.py@@ -0,0 +1,29 @@+"""cua.tools — agent tool classes and registry.++Usage::++ from cua.tools import BrowserTool, BaseTool, register_tool+"""++from agent.tools import (+ TOOL_REGISTRY,+ BaseComputerTool,+ BaseTool,+ BrowserTool,+ get_registered_tools,+ get_tool,+ register_tool,+)+from agent.types import IllegalArgumentError, ToolError++__all__ = [+ "BaseTool",+ "BaseComputerTool",+ "register_tool",+ "get_registered_tools",+ "get_tool",+ "TOOL_REGISTRY",+ "BrowserTool",+ "ToolError",+ "IllegalArgumentError",+]