Summary

Adds automatic environment variable support for CUA_API_KEY, eliminating the need to explicitly pass the API key to Computer and CloudProvider constructors when the environment variable is set.

Changes

• CloudProvider: Made api_key parameter optional with automatic fallback to CUA_API_KEY environment variable
• Computer: Added automatic fallback to CUA_API_KEY environment variable when api_key is not provided
• Documentation: Updated all Python examples to show simplified usage pattern
• Examples: Updated cloud_api_examples.py to demonstrate the cleaner API

Benefits

• Cleaner API: No need to manually read environment variables in user code
• Better developer experience: Follows common patterns used by other SDKs (OpenAI, Anthropic, etc.)
• Backward compatible: Explicit api_key parameter still works and takes precedence

Usage

Before:

cua_api_key = os.environ.get("CUA_API_KEY")
computer = Computer(
    os_type="windows",
    provider_type="cloud",
    name="s-windows-jxvu65a1",
    api_key=cua_api_key
)

After:

# Just set the environment variable
# export CUA_API_KEY="sk_cua-api01_..."

computer = Computer(
    os_type="windows",
    provider_type="cloud",
    name="s-windows-jxvu65a1",
)

Test plan

• Verify Computer reads from CUA_API_KEY when api_key parameter is not provided
• Verify explicit api_key parameter takes precedence over environment variable
• Verify appropriate error message when neither parameter nor environment variable is set
• Test with existing cloud sandbox examples

🤖 Generated with Claude Code