wuying-agentbay-sdk 0.9.0

Python SDK for interacting with the Wuying AgentBay cloud runtime environment

AgentBay SDK for Python

Execute commands, operate files, and run code in cloud environments

📦 Installation

pip install wuying-agentbay-sdk

🚀 Prerequisites

Before using the SDK, you need to:

1. Register an Alibaba Cloud account: https://aliyun.com
2. Get API credentials: AgentBay Console
3. Set environment variable: export AGENTBAY_API_KEY=your_api_key

🚀 Quick Start

from agentbay import AgentBay

# Create session
agent_bay = AgentBay()
result = agent_bay.create()
# Verified: ✓ Client initialized and session created successfully

if result.success:
    session = result.session

    # Execute command
    cmd_result = session.command.execute_command("ls -la")
    print(cmd_result.output)
    # Verified: ✓ Command executed successfully
    # Sample output: "总计 100\ndrwxr-x--- 16 wuying wuying 4096..."

    # File operations
    session.file_system.write_file("/tmp/test.txt", "Hello World")
    content = session.file_system.read_file("/tmp/test.txt")
    print(content.content)
    # Verified: ✓ File written and read successfully
    # Output: "Hello World"

📖 Complete Documentation

🆕 New Users

• 📚 Quick Start Tutorial - Get started in 5 minutes
• 🎯 Core Concepts - Understand cloud environments and sessions

🚀 Experienced Users

Choose Your Cloud Environment:

• 🌐 Browser Use - Web scraping, browser testing, form automation
• 🖥️ Computer Use - Windows desktop automation, UI testing
• 📱 Mobile Use - Android UI testing, mobile app automation
• 💻 CodeSpace - Code execution, development environments

Additional Resources:

• 📖 Feature Guides - Complete feature introduction
• 🔧 Python API Reference - Detailed API documentation
• 💻 Python Examples - Complete example code

🆘 Need Help

🔧 Core Features Quick Reference

Session Management

# Create session
result = agent_bay.create()
if result.success:
    session = result.session
# Verified: ✓ Session created successfully

# List sessions by labels with pagination
from agentbay.session_params import ListSessionParams
params = ListSessionParams(labels={"environment": "production"}, max_results=10)
result = agent_bay.list_by_labels(params)
if result.success:
    sessions = result.sessions
    next_token = result.next_token
# Verified: ✓ Sessions listed successfully with pagination support

# Delete session
delete_result = agent_bay.delete(session)
# Verified: ✓ Session deleted successfully

File Operations

# Read/write files
session.file_system.write_file("/path/file.txt", "content")
content = session.file_system.read_file("/path/file.txt")
# Verified: ✓ File operations work correctly
# content.content contains the file's text content

# List directory
files = session.file_system.list_directory("/path")
# Verified: ✓ Returns list of file/directory information

Command Execution

# Execute command
result = session.command.execute_command("python script.py")
print(result.output)
# Verified: ✓ Command executed successfully
# result.output contains the command's stdout

Data Persistence

# Create context
context = agent_bay.context.get("my-project", create=True).context
# Verified: ✓ Context created or retrieved successfully

# Create session with context
from agentbay.session_params import CreateSessionParams
from agentbay.context_sync import ContextSync, SyncPolicy
context_sync = ContextSync.new(context.id, "/tmp/data", SyncPolicy.default())
session = agent_bay.create(CreateSessionParams(context_syncs=[context_sync])).session
# Verified: ✓ Session created with context synchronization
# Data in /tmp/data will be synchronized to the context

🆘 Get Help

• GitHub Issues
• Documentation

📄 License

This project is licensed under the Apache License 2.0 - see the LICENSE file for details.

Changelog

All notable changes to the Wuying AgentBay SDK will be documented in this file.

[0.9.0] - 2025-10-15

Added

🎯 Platform-Specific Automation Modules

• Computer Module: New dedicated module for desktop/Windows automation across all SDKs
  • Desktop UI interaction APIs: click_mouse(), move_mouse(), drag_mouse(), press_keys(), scroll()
  • Screen information: get_screen_size(), screenshot()
  • Integration with MCP tools for advanced automation
  • Python: session.computer.*, TypeScript: session.computer.*, Golang: session.Computer.*
• Mobile Module: New dedicated module for Android device automation across all SDKs
  • Touch interaction: tap(), swipe(), long_press()
  • Input methods: input_text(), send_key() with KeyCode support
  • UI element detection: get_clickable_ui_elements()
  • Device configuration: configure() for setting device properties
  • Android-only support (mobile_latest image)
  • Python: session.mobile.*, TypeScript: session.mobile.*, Golang: session.Mobile.*

📊 Session Management Enhancement

• Get Session API: Retrieve existing session information by session ID
  • Python: agentbay.get(session_id) returns SessionResult
  • TypeScript: agentBay.get(sessionId) returns SessionResult
  • Golang: agentBay.Get(sessionID) returns *SessionResult
  • Returns session object with VPC configuration, network info, and resource URL
  • Non-throwing error handling: check result.success and result.error_message
• List Sessions API: Retrieve paginated list of sessions with label filtering
  • Python: agentbay.list(labels, page, limit) returns SessionListResult
  • TypeScript: agentBay.list(labels, page, limit) returns SessionListResult
  • Golang: agentBay.List(labels, page, limit) returns *SessionListResult
  • Support for page-based pagination (page numbers start from 1)
  • Label filtering with key-value pairs
  • Returns session IDs, total count, and pagination metadata

🗄️ Data Lifecycle Management

• RecyclePolicy: Control context data retention lifecycle
  • Lifecycle options: 1day, 3days, 5days, 10days, 15days, 30days, 90days, 180days, 360days, forever
  • Path-specific policies: apply different lifecycles to different directories
  • Path validation: wildcard patterns not supported, use exact directory paths
  • Integration with ContextSync for automatic data cleanup
  • Python: RecyclePolicy(lifecycle=Lifecycle.LIFECYCLE_30DAYS, paths=["/data"])
  • TypeScript: new RecyclePolicy(Lifecycle.LIFECYCLE_30DAYS, ["/data"])
  • Golang: &RecyclePolicy{Lifecycle: Lifecycle_30Days, Paths: []string{"/data"}}

🔒 VPC Session Authentication Enhancement

• Token-based Authentication: VPC sessions now support token authentication
  • Automatic token management for secure VPC session access
  • Token included in session creation response
  • Used for MCP tool calls and resource access in VPC environments

🔧 API Schema Validation

• MCP Field Validation: Enhanced MCP tool parameter validation
  • Renamed schema to field_schema to align with MCP standard
  • Better error messages for invalid tool parameters
  • Improved type checking for tool inputs

Changed (Breaking Changes)

⚠️ API Response Structure Changes

• SessionListResult.Sessions Removed: Breaking change in session list response
  • Removed: SessionListResult.Sessions field (contained full Session objects)
  • Use instead: SessionListResult.SessionIds (list of session ID strings)
  • Rationale: Reduce response payload size and improve performance
  • Migration: Use agentbay.get(session_id) to retrieve full Session objects for specific sessions
  • Before: result.Sessions[0].command.execute_command(...)
  • After:

    session_id = result.SessionIds[0]
    session_result = agentbay.get(session_id)
    session_result.session.command.execute_command(...)
    

🔄 Error Handling Consistency

• Unified Error Handling: All APIs now use Result objects instead of raising exceptions
  • context.get() returns ContextResult (no longer raises AgentBayError)
  • context.create() returns ContextResult (no longer raises AgentBayError)
  • Migration Required: Replace try-except AgentBayError with if not result.success pattern
  • All error messages now follow [ErrorCode] Message format
  • Before:

    try:
        result = agentbay.context.get("my-context")
        context = result.context
    except AgentBayError as e:
        print(f"Error: {e}")
    

  • After:

    result = agentbay.context.get("my-context")
    if not result.success:
        print(f"Error: {result.error_message}")
    else:
        context = result.context
    

Deprecated

• UI Module: All methods marked for removal in v2.0.0
  • session.ui.click() → Use session.computer.click_mouse() or session.mobile.tap()
  • session.ui.type() → Use session.computer.press_keys() or session.mobile.input_text()
  • session.ui.mouse_move() → Use session.computer.move_mouse()
  • session.ui.screenshot() → Use session.computer.screenshot() or session.mobile.screenshot()
  • Migration guide: Use platform-specific computer or mobile modules
• Window Module: Some methods deprecated
  • Deprecated methods will be replaced by Computer module equivalents in v2.0.0
• Context Fields:
  • ContextResult.state marked for removal in v2.0.0
  • ContextResult.os_type marked for removal in v2.0.0

Enhanced

• Error Messages: Improved error reporting with structured [Code] Message format across all APIs
• API-level Error Handling: Enhanced error parsing for context.get(), context.list(), and agentbay.create_session()
• ContextResult.error_message: Added for consistent error reporting in context operations
• ContextListResult.error_message: Added for consistent error reporting in list operations

Documentation

• Documentation Restructure: Major documentation organization improvements
  • New Cookbook: Real-world examples and recipes for common scenarios
  • Restructured Guides:
    • Common Features split into Basics, Advanced, and Configuration sections
    • Computer Use guide updated with new Computer module APIs
    • Mobile Use guide updated with new Mobile module APIs and Android-only clarification
    • CodeSpace guide enhanced with code execution examples
  • API Reference Updates: Aligned with actual SDK implementation across all three languages
  • Migration Guides: Added for breaking changes and deprecated APIs
  • Net documentation changes: +993 lines across 28 new files, 16 modified files, 14 deleted files

Fixed

• Documentation Accuracy: Fixed incorrect iOS support claim in Mobile Use guide (Android only)
• API Documentation: Corrected method signatures and return types across all language SDKs
• Example Code: All code examples verified against actual SDK implementation

[0.8.0] - 2025-09-19

Added

• Context Sync with Callback Support: Enhanced context synchronization capabilities
  • Asynchronous Context Sync: Added callback-based asynchronous context sync functionality
  • Synchronous Context Sync: Support for blocking synchronous context sync operations
  • Flexible Sync Options: Two calling modes - with callback for async, without for sync
  • Context Sync Examples: Comprehensive examples demonstrating both sync modes
• Enhanced Logging System: Upgraded to loguru-based logging infrastructure
  • File Logging: Support for logging to files for better debugging and analysis
  • Environment-based Log Levels: Configurable log levels via environment variables
  • Process & Thread Information: Enhanced log output with process and thread details for async operations
  • DEBUG Level Support: More detailed logging information at DEBUG level (default: INFO)
• Data Persistence Examples: Comprehensive data persistence examples across all SDKs
  • Cross-language Examples: Updated examples for Python, TypeScript, and Golang
  • Context Management: Enhanced examples showing context binding and persistence
  • Session Recovery: Documentation and examples for session recovery scenarios
• Browser-Use Documentation: Complete browser automation documentation suite
  • Core Features Guide: Comprehensive documentation for browser context, proxies, stealth mode, extensions, and captcha handling
  • Advanced Features Guide: In-depth coverage of PageUse Agent and AI-powered browser interactions
  • Code Examples: Practical examples demonstrating browser automation workflows
  • Integration Guide: Documentation for seamless integration with community tools and frameworks

Changed

• Session Management: Simplified session interface
  • Removed resourceUrl: Eliminated resourceUrl parameter from session creation for cleaner API
  • Streamlined Session Creation: Simplified session parameters and initialization
• Build System: Modernized Python package management
  • Removed setup.py: Transitioned from setup.py to setup.cfg for cleaner package configuration
  • Poetry Integration: Enhanced CI/CD with Poetry-based publishing workflows
• Example Improvements: Enhanced code quality and consistency across examples
  • Better Error Handling: Improved error handling patterns in SDK examples
  • Parameter Standardization: Consistent parameter setup across all examples
  • Code Cleanup: Improved readability and maintainability of browser examples

Fixed

• Browser Cookie Persistence: Resolved browser cookie persistence issues in examples
  • CDP Session Management: Fixed CDP session variable handling in cookie persistence examples
  • Browser Connection: Improved browser connection stability for persistent sessions
• Unit Test Reliability: Enhanced test stability and coverage
  • Test Case Updates: Updated filesystem test cases for better failure scenario handling
  • Test Consistency: Fixed unit test failures and improved test reliability
• Session Parameter Handling: Fixed session creation parameter issues in automation examples

Documentation

• Comprehensive Documentation Updates: Major improvements across all documentation areas
  • API Key Usage: Updated best practices for API key usage and security
  • Parallel Workflows: Added examples and documentation for parallel workflow execution
  • Automation Guides: Enhanced automation documentation with English translations
  • Application & Window Management: Added comprehensive documentation for application and window operations
  • Session Recovery: New documentation covering session recovery patterns and best practices
  • File Operations: Updated file operations guides with session usage examples
  • Best Practices: Enhanced best practices documentation for API key usage and file search results handling

[0.7.0] - 2025-09-02

Added

• AI Browser Extension: New browser extension capabilities for enhanced automation
  • Python Extension Support: Added extension.py module for browser extension functionality
  • TypeScript Extension Support: Complete extension API implementation with examples
  • Extension Integration: Seamless integration with browser automation workflows
  • Extension Testing: Comprehensive test coverage for extension functionality
• Enhanced File System API: Major improvements to file operations across all SDKs
  • Streamlined API: Updated method signatures for better consistency
  • Session Integration: Better integration with session management for file operations
  • Comprehensive Testing: Expanded test coverage with integration and unit tests
• Documentation & Guides: Comprehensive documentation improvements
  • Large File Handling Guide: Detailed guide for handling large files efficiently
  • File Operations Guide: Updated comprehensive guide with session usage examples
  • API Documentation: Complete API reference updates across all SDKs
  • Usage Examples: Updated examples and documentation for better developer experience

Changed

• File System API: Breaking changes to improve consistency and usability
  • Method Naming: Standardized method names across Python, TypeScript, and Golang SDKs
  • Return Types: Enhanced return types for better type safety and error handling
  • Session Context: Improved integration with session management for file operations
• Documentation Structure: Major documentation reorganization
  • API Reference: Updated API documentation to match actual implementation
  • Command API: Updated method names and return value references across all documentation
  • Context Manager: Enhanced documentation with detailed return object information

Fixed

• Browser Automation: Resolved browser-related issues
  • Page Variables: Fixed support for variables in page_use_act functionality
• Python Package: Resolved Python-specific issues
  • Module Imports: Added missing __init__.py in agentbay models directory
  • API Examples: Fixed incorrect API usage examples in Python README
• Test Infrastructure: Improved test reliability and organization
  • Test Organization: Moved test files to appropriate integration directories
  • Deprecated Tests: Removed outdated integration tests
  • Test Coverage: Enhanced test coverage for new features

Documentation

• Comprehensive Updates: Major documentation improvements across all areas
  • Getting Started: Updated quickstart documentation and first session guides
  • API Reference: Complete API documentation updates for all modules
  • Examples: Updated SDK usage examples and documentation
  • Guides: New and updated guides for file operations and large file handling

[0.6.0] - 2025-08-23

Added

• Browser Proxy Support: New proxy configuration for browser automation across Python and TypeScript
  • BrowserProxy Class: Support for custom and wuying proxy types
    • Custom proxy with server, username, password configuration
    • Wuying proxy with "restricted" and "polling" strategies
    • Configurable pool size for polling strategy
  • Proxy Integration: Seamless integration with browser initialization
    • Automatic proxy configuration during browser setup
    • Support for both authenticated and anonymous proxy connections
• Browser Stealth Mode & Fingerprinting: Enhanced browser automation capabilities
  • Stealth Mode: Browser stealth mode support to avoid detection
  • Browser Fingerprinting: Configurable browser fingerprint options
    • Custom user agent, viewport, timezone, and locale settings
    • Enhanced privacy and anti-detection capabilities
• Context File Management APIs: Complete file operations within contexts across all SDKs
  • File URL Operations: Presigned URL support for secure file access
    • get_file_download_url() / GetFileDownloadUrl() for secure file downloads
    • get_file_upload_url() / GetFileUploadUrl() for secure file uploads
  • File Management: Full CRUD operations for context files
    • list_files() / ListFiles() with pagination support for context file listing
    • delete_file() / DeleteFile() for context file deletion
    • Enhanced error handling and response parsing for all file operations
• Session Management Enhancements: Improved session creation and management
  • Policy Support: Optional policy_id parameter in session creation
  • Session List Response Models: Enhanced session listing with proper response models
• Browser Agent Improvements: Enhanced AI-powered browser interactions
  • Direct ObserveResult Support: PageUse act API can now accept ObserveResult directly
  • TypeScript Browser Agent: Merged browser agent functionality to TypeScript SDK
  • Enhanced Parameter Handling: Improved parameter type conversion and validation
• Development & Testing Infrastructure: Enhanced development experience
  • Pre-commit Hooks: Added secret detection in pre-commit hooks
  • Local Benchmark Testing: Added local benchmark test support for PageUseAgent API
  • Page Task Framework: Initial version of page task framework
  • Auto Publishing: Enhanced CI/CD with auto publishing workflows

Changed

• Browser Configuration: Enhanced browser setup with advanced options
  • Breaking Change: BrowserOption now supports proxy, stealth mode, and fingerprinting
  • Automatic proxy validation and configuration during browser initialization
  • Better error handling for proxy connection and stealth mode issues
• Browser Agent API: Improved browser automation interface
  • Enhanced parameter naming and validation in ExtractOptions, ObserveOptions, and ActOptions
  • Better timeout handling with default MCP tool call timeout for PageUseAgent
  • Improved error handling and response parsing
• Context API Enhancement: Improved context service implementation
  • Enhanced error handling and response parsing across all context operations
  • Better pagination support with ContextListParams for large context lists
  • Improved integration with session creation and context synchronization
• Documentation & Examples: Updated documentation and examples
  • Updated Python examples with session params
  • Aligned TypeScript examples with latest API changes
  • Updated README and examples documentation

Fixed

• Browser VPC Environment: Resolved VPC-specific browser issues
  • Fixed browser endpoint URL population for VPC environment
  • Better CDP endpoint management for VPC and non-VPC sessions
• Browser Agent API: Enhanced browser automation reliability
  • Fixed parameter type conversion in observation API
  • Fixed bad naming in browser agent methods and options
  • Improved error handling for browser agent operations
• PageUseAgent Integration: Resolved PageUseAgent API issues
  • Fixed run_sudoku functionality
  • Aligned examples with latest PageUseAgent API revision
  • Fixed benchmark test integration with PageAgent
• Context File Operations: Enhanced context file management reliability
  • Fixed presigned URL generation and expiration handling
  • Improved file listing pagination and response parsing
  • Better error handling for file upload/download operations
• Cross-Platform Compatibility: Improved SDK consistency
  • Standardized method signatures across Python, TypeScript, and Golang
  • Fixed async/await patterns in TypeScript and Python implementations
  • Better error handling and response structure consistency

[0.5.0] - 2025-08-06

Added

• Browser Automation & AI Browser: Comprehensive browser automation capabilities with AI-powered interactions
  • AIBrowser interface with Playwright integration
  • Browser Context for persistent data across sessions (cookies, local storage, session storage)
  • Browser Agent with natural language operations (Act, Observe, Extract)
  • Support for complex web automation tasks through Agent module integration
• VPC Session Support: Enhanced security and networking capabilities
  • VPC-based session creation with is_vpc parameter
  • Specialized system tools (get_resource, system_screenshot, release_resource)
  • Browser tools availability in VPC sessions (cdp, pageuse-mcp-server, playwright)
  • Network isolation for sensitive operations
• Agent Module: AI-powered task execution framework
  • Natural language task execution with ExecuteTask() method
  • Task status monitoring and management
  • Task termination capabilities
  • Integration with browser automation for complex web operations
• Unified MCP Tool Interface: Standardized tool calling mechanism across all modules
  • CallMcpTool() method for unified tool invocation
  • Support for both VPC and non-VPC tool calling patterns
  • Automatic server discovery for tools
  • Enhanced error handling and debugging capabilities
• Comprehensive Interface Architecture: Complete interface definitions for better modularity
  • FileSystemInterface, SessionInterface, WindowInterface, ApplicationInterface
  • CommandInterface, CodeInterface, UIInterface, OSSInterface
  • AgentBayInterface for main client operations
  • Mock generation support for all interfaces
• Enhanced Context Management: Improved context synchronization and pagination
  • Context list pagination with ListContexts API
  • Enhanced context binding and persistence
  • Better error handling for context operations
• Quality Assurance Infrastructure: Automated quality check scripts for all languages
  • One-click quality check scripts (quality-check.sh) for Python, TypeScript, and Golang
  • Comprehensive linting, formatting, and security scanning
  • Automated unit and integration testing
  • CI/CD integration support
• Documentation & Examples: Comprehensive documentation and example improvements
  • Agent module documentation and examples for all languages
  • VPC session tutorials and API reference
  • Browser automation architecture documentation
  • AI-powered web interactions tutorial
  • Updated API reference with new modules and interfaces

Changed

• Architecture Refactoring: Major structural improvements for better maintainability
  • Interfaces-first design with dependency injection
  • Removal of circular dependencies between modules
  • Unified MCP tool calling across all components
• Session Management: Enhanced session capabilities and VPC support
  • VPC session detection and handling
  • Network interface IP and HTTP port management for VPC sessions
  • Improved session lifecycle management
• Error Handling: Improved error handling and logging across all SDKs
  • Better error messages for VPC configuration issues
  • Enhanced debugging information with request IDs
  • Sanitized error reporting for security
• Testing Infrastructure: Significantly expanded test coverage
  • Comprehensive unit tests for all modules
  • Integration tests for VPC sessions and browser automation
  • API-level comprehensive testing for command and filesystem operations
• Module Separation: Code execution moved from Command to dedicated Code module
  • RunCode method moved from Command module to Code module
  • Clear separation of concerns between shell commands and code execution
  • Improved API consistency across all language implementations

Fixed

• VPC Session Compatibility: Fixed issues with VPC-based tool calling
  • Proper HTTP endpoint construction for VPC sessions
  • Network configuration validation
  • Server discovery for VPC environments
• Browser Context Persistence: Fixed browser data persistence across sessions
  • Cookie synchronization improvements
  • Context cleanup on session termination
  • Resource management for browser instances
• Interface Consistency: Fixed inconsistencies across language implementations
  • Standardized method signatures across Python, TypeScript, and Golang
  • Consistent error handling patterns
  • Unified response structures

Security

• Enhanced Security Scanning: Improved security measures across all SDKs
  • Dependency vulnerability scanning with pip-audit, npm audit, and govulncheck
  • Code security analysis with bandit, snyk, and gosec
  • Secure credential handling for VPC sessions
• Network Isolation: VPC sessions provide enhanced security through network isolation
  • Private network environments for sensitive operations
  • Controlled access policies
  • Secure resource access patterns

[0.4.0] - 2025-07-18

Added

• Enhanced Configuration: Support for setting SDK configuration via three methods (environment variables, config files, code parameters) in Python, Golang, and TypeScript.
• API Response Improvements: All API responses now include a request_id field for better traceability and debugging.
• Session Label Pagination: listByLabels now supports pagination parameters.
• GetLink API: Added support for specifying protocol type and port when retrieving links.
• OSS Persistence: Added support for persistent storage with OSS.
• Ticket Parameter: Some APIs now support a ticket parameter.
• Context Sync & Management: Introduced context manager and context sync APIs and implementations.
• Automated Quality Scripts: Added one-click quality check scripts (lint/format/security scan) and multi-language automated testing.
• Comprehensive Unit & Integration Tests: Significantly expanded and improved tests for TypeScript, Go, and Python SDKs.
• Documentation Restructure: API reference is now split by language, with many new tutorials and examples.
• Type/Interface Enhancements: Many new interfaces and type definitions for better IDE support across Golang, TypeScript, and Python.

Changed

• API Compatibility: Standardized some API parameters and response formats.
• Error Handling: Improved error handling and logging across SDKs.
• Default Timeout: Default timeout changed to 60 seconds.
• Documentation: Major updates to README, Getting Started, API Reference, and Tutorials.
• Code Structure: Refactored directory structure; examples, tests, and scripts are now modularized.

Fixed

• Session Deletion/Management: Fixed issues with session deletion and state management.
• File System: Fixed issues with large file chunking and read/write consistency.
• Unit Tests: Fixed compatibility and edge cases in multi-language unit tests.
• CI/CD: Fixed cross-platform line endings and environment variable loading issues.
• API Responses: Fixed incomplete response structures in some APIs.

[0.3.0] - 2025-06-16

Added

• Session Labels: Added support for organizing and filtering sessions with labels
  • Set and get session labels
  • List sessions by label filters
• Code Execution: Added support for running code in multiple languages (Python, JavaScript, etc.)
• Window Management:
  • Added support for listing, activating, and manipulating windows
  • Window resizing, focusing, and positioning
  • Get window properties and child windows
• OSS Integration: Added Object Storage Service functionality
  • File upload/download to/from OSS buckets
  • Anonymous upload/download via URLs
  • OSS environment initialization
• Context Management:
  • Create, list, and delete contexts
  • Bind sessions to contexts for persistence
  • Get context information
• UI Enhancement:
  • Added support for screenshots
  • UI element detection and interaction
  • Mobile-specific operations (click, swipe, send keys)
• Enhanced Image ID Support: Added ability to specify custom image IDs when creating sessions
• Application Management: Added support for listing, launching, and stopping applications

Changed

• Updated API client to support the latest AgentBay backend features
• Improved error handling and reporting across all SDK components
• Enhanced documentation with examples for new features
• Enhanced TypeScript type definitions for better IDE support
• Standardized response formats across all operations

Fixed

• Various bug fixes and performance improvements
• Type compatibility issues in filesystem operations
• Session management edge cases
• Command execution timeouts
• File reading/writing inconsistencies

[0.1.0] - 2025-05-15

Added

• Core SDK Implementation: Initial implementation for Python, TypeScript, and Golang
• Session Management:
  • Create, list, and delete sessions
  • Get session information
• Command Execution:
  • Execute basic shell commands
• Basic File Operations:
  • Read and write files
  • Create and delete directories
  • List directory contents
• Authentication: API key-based authentication
• Configuration: Environment-based configuration
• Documentation: Initial API reference and examples