10 Feb 03:00

f555636

release_v0.10.0 Latest

Latest

Changelog

[0.10.0] - 2026-02-09

This release focuses on API Naming Simplification Phase 2 in the Computer module, the new policy_id parameter for session creation, and OpenClaw examples for Slack, Discord, and Telegram.

Breaking Changes

API Naming Simplification Phase 2 (Computer Module): Interfaces previously flat in session.computer are now organized by sub-module (mouse, keyboard, screen, window, app). The legacy single computer.py has been removed. API mapping:
- session.computer.click_mouse(x, y) → session.computer.mouse.click(x, y)
- session.computer.move_mouse(x, y) → session.computer.mouse.move(x, y)
- session.computer.drag_mouse(x1, y1, x2, y2) → session.computer.mouse.drag(x1, y1, x2, y2)
- session.computer.scroll(x, y, direction, amount) → session.computer.mouse.scroll(x, y, direction, amount)
- session.computer.get_cursor_position() → session.computer.mouse.get_position()
- session.computer.input_text(text) → session.computer.keyboard.type(text)
- session.computer.press_keys(keys) → session.computer.keyboard.press(keys)
- session.computer.release_keys(keys) → session.computer.keyboard.release(keys)
- session.computer.list_root_windows() → session.computer.window.list_root_windows()
- session.computer.get_active_window() → session.computer.window.get_active_window()
- session.computer.activate_window(window_id) → session.computer.window.activate(window_id)
- session.computer.close_window(window_id) → session.computer.window.close(window_id)
- session.computer.maximize_window(window_id) → session.computer.window.maximize(window_id)
- session.computer.minimize_window(window_id) → session.computer.window.minimize(window_id)
- session.computer.restore_window(window_id) → session.computer.window.restore(window_id)
- session.computer.resize_window(window_id, w, h) → session.computer.window.resize(window_id, w, h)
- session.computer.fullscreen_window(window_id) → session.computer.window.fullscreen(window_id)
- session.computer.focus_mode(on=True) → session.computer.window.focus_mode(on=True)
- session.computer.get_installed_apps() → session.computer.app.list_installed()
- session.computer.list_visible_apps() → session.computer.app.get_visible()
- session.computer.start_app(name) → session.computer.app.start(name)
- session.computer.stop_app_by_pname(pname) → session.computer.app.stop_by_pname(pname)
- session.computer.stop_app_by_pid(pid) → session.computer.app.stop_by_pid(pid)
- session.computer.stop_app_by_cmd(stop_cmd) → session.computer.app.stop_by_cmd(stop_cmd)
- session.computer.get_screen_size() → session.computer.screen.get_size()
- session.computer.screenshot() → session.computer.screen.capture()
Implementation aligned with original behavior: unified log operation names, restored return types, and corrected mouse button validation and screen capture return types.

New Features

policy_id: CreateSessionParams adds policy_id; the create-session request supports mcpPolicyId for policy-scoped sessions.
OpenClaw examples: Three example configurations for IM integrations:
- Slack – configuration and usage with OpenClaw
- Discord – configuration and usage with OpenClaw
- Telegram – configuration and usage with OpenClaw (including README mention)

Other Enhancements

API call log level changed from info to debug
aiohttp uses certifi for SSL context (macOS/Windows)
Screenshot examples add retry and better SSL error handling
Screen module: improved result.data parsing for string and dict
App/window error handling improved; get_active_window raises RuntimeError on failure; window JSON errors return None

Bug Fixes

Added missing request_id on AppOperationResult / ApplicationManager
Fixed example indentation and return types (app.start(), screen.capture())
Keyboard combo letter keys normalized to lowercase
Fixed pytest imports (pythonpath, project root, functional_helpers)
Integration test fixes for list_installed, cursor validation, scroll API, and window_operations.py app selection

Documentation, Testing & Chore

Docs auto-generated and aligned with 26 API specification; example formatting and comments updated.
Browser fingerprint and computer integration tests improved; timeout test for 1s minimum; added Playwright connect test.
Website host changed to agb.cloud.

Assets 2

26 Jan 02:47

AgbAccount

v0.9.0

e79ea75

release_v0.9.0

Breaking Changes

API Naming Simplification: Major API renaming for consistency and simplicity:
- session.code.run_code() → session.code.run()
- session.command.execute_command() → session.command.execute()
- session.file_system → session.file (backward compatibility alias maintained)
- session.file.watch() → session.file.watch_dir()
- session.file.get_file_transfer_context_path() → session.file.transfer_path()
- File system methods simplified: read_file() → read(), write_file() → write(), delete_file() → remove(), list_directory() → list(), get_file_info() → info(), create_directory() → mkdir(), move_file() → move(), edit_file() → edit(), read_multiple_files() → read_batch(), search_files() → search()

New Features

Session Metrics: Added session metrics tracking functionality to retrieve resource usage and performance metrics
MCP Tool Calling: Added MCP (Model Context Protocol) tool calling methods to Session class for direct tool invocation
Multiple Results Support: Enhanced code execution to support multiple result types with comprehensive documentation

Enhancements

Error Handling: Improved error handling for file transfer operations:
- Specific handling for httpx.ConnectError (network connection issues)
- Specific handling for httpx.TimeoutException (timeout issues)
- Clearer error messages for network-related failures
File Transfer: Improved error handling in transfer_path() method with better context initialization checks
Documentation:
- Added comprehensive MCP tool calling documentation and examples
- Updated API documentation to reflect new simplified method names
- Added session metrics documentation and examples
- Fixed code execution result field usage in documentation
- Updated MCP guide URLs to v2

Refactoring

Session Class: Removed unnecessary BaseService inheritance from Session class
Test Infrastructure: Optimized session creation in integration tests
Code Cleanup: Removed temporary API rename verification scripts

Testing & CI/CD

Test Coverage: Reached 80% unit test coverage gate
Integration Tests:
- Enhanced integration test infrastructure and reliability
- Added CI skip logic for integration tests
- Fixed false-pass tests and improved test stability
- Added integration test for session metrics retrieval
- Refactored filesystem integration tests
Test Compatibility: Made version_utils tests Python 3.10-compatible
CI Improvements: Improved CI skip logic for browser fingerprint tests

Bug Fixes

Fixed output log source to match result object structure in main.py
Fixed Java result output log variable reference errors
Fixed JavaScript execution result output logic errors
Fixed default image_id value for list_mcp_tools (now uses agb-code-space-1)
Fixed conftest.py being run as a test file
Fixed write_file on deleted session test and integration test issues
Optimized docstring and fixed default value of list_mcp_tools

Assets 2

22 Dec 16:30

AgbAccount

v0.7.1

5ba5522

release_v0.7.1

Full Changelog: v0.7.0...v0.7.1

[0.7.1] - 2025-12-23

Enhancements

Default Parameters: Adjusted default parameter values for improved usability and performance
API Documentation: Updated API documentation to reflect current functionality

Refactoring

Code Cleanup: Removed deprecated session management methods and simplified API surface
Documentation Updates: Cleaned up documentation references to align with current API

Testing & CI/CD

Test Adjustments: Updated test cases to match current API behavior and improve test reliability

Assets 2

22 Dec 15:47

AgbAccount

v0.7.0

83c323a

release_v0.7.0

Full Changelog: v0.6.1...v0.7.0

New Features

Browser Fingerprint Enhancement: Comprehensive browser fingerprint management with persistence, local sync, and advanced configuration options
Computer Automation Module: Full desktop automation capabilities including:
- Screenshot capture support for AGB sessions
- Keyboard input functionality with comprehensive key support
- Mouse operations with button and scroll direction enums
- Window listing and management functionality
- Application operations support
File Transfer Function: Complete file transfer functionality for moving files between local and remote environments
Async Session Deletion: Migrated session deletion API from release_mcp_session to delete_session_async with polling support
Browser Type Configuration: Support for browser type and command arguments settings for enhanced browser control
MCP Access Documentation: Comprehensive guide for MCP (Model Context Protocol) access and configuration

Enhancements

Context Manager: Improved error handling by returning error results instead of raising exceptions in context sync validation
Browser Agent: Enhanced browser agent with improved integration tests and better error handling
API Documentation: Added fingerprint module to API documentation generation
Code Examples: Optimized and improved code examples throughout documentation

Documentation

Added MCP access guide with comprehensive configuration instructions
Added examples for application and window operations
Updated text input examples in documentation
Corrected documentation regarding command execution instructions
Standardized guides structure to match template
Removed example code from ContextManager docstring
Added file transfer guide markdown

Refactoring

Removed unused http_port and token fields from session response models
Improved context sync validation to return error results instead of exceptions
Cleaned up unrelated files and code

Testing & CI/CD

Optimized CI/CD pipeline summary with switch state for better visibility
Enhanced test coverage for computer module, file transfer, and browser fingerprint features
Fixed context manager sync tests to match new validation logic

Assets 2

20 Nov 04:29

AgbAccount

v0.5.0

1e76273

release_v0.5.0

This release includes the following changes:

New Features:
- Context Clear API: Added clear_async, get_clear_status, and synchronous clear
  methods with configurable timeout and state tracking
- SDK Telemetry: Session creation now records SDK version and release status
- Context Sync Enhancements: Introduced UploadMode and lifecycle enums for
  flexible synchronization policies
- Session Parameters: Made image_id optional in CreateSessionParams
- Browser Module: Added variables parameter to ActOptions for parameterized
  automation instructions
- Browser Module: Added use_vision parameter to ObserveOptions and ExtractOptions

API Changes:
- Added ClearContextRequest and ClearContextResponse models
- Enhanced ContextService with clear operations
- Updated ContextSync with new upload modes and lifecycle policies
- Added version_utils and _release modules for SDK versioning

Documentation:
- Updated API reference documentation for all modules
- Enhanced context usage guide and sync policy documentation
- Updated examples and guides to reflect new features
- Fixed documentation formatting issues

Testing:
- Added unit tests for Code, Command, FileSystem, ContextManager modules
- Added integration tests for context clear operations
- Added tests for recycle policy and file archive mode

Files Changed:
- 48 files modified, 1216 insertions(+), 511 deletions(-)
- New files: clear_context_request.py, clear_context_response.py,
  version_utils.py, _release.py, and multiple test files

Assets 3