hopx-ai 0.1.10__tar.gz

hopx_ai-0.1.10/.gitignore

@@ -0,0 +1,45 @@
+# Virtual environment
+venv/
+env/
+ENV/
+
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+.tox/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+.DS_Store
+
+# Test files
+test_live.py
+*.log
+

hopx_ai-0.1.10/CHANGELOG.md

@@ -0,0 +1,92 @@
+# Changelog
+
+All notable changes to the Bunnyshell Python SDK will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.1.10] - 2025-11-09
+
+### Fixed
+- **CRITICAL**: Fixed `template_id` type conversion issue when creating sandboxes from built templates
+  - Template build API returns integer template_id (e.g., `83`)
+  - Sandbox create API expects string template_id (e.g., `"83"`)
+  - SDK now automatically converts `template_id` to string in both `Sandbox.create()` and `AsyncSandbox.create()`
+  - Fixes error: `NotFoundError: The template '83' was not found`
+
+### Technical Details
+- Added `str(template_id)` conversion in `sandbox.py` and `async_sandbox.py`
+- Works with both integer and string `template_id` values
+- Maintains backward compatibility
+
+## [0.1.9] - 2025-11-09
+
+### Added
+- **NEW**: `timeout_seconds` parameter in `Sandbox.create()` - auto-kill sandbox after specified seconds
+- **NEW**: `internet_access` parameter in `Sandbox.create()` - enable/disable internet access (default: True)
+- Support for both parameters in sync (`Sandbox`) and async (`AsyncSandbox`) versions
+
+### Changed
+- **BREAKING**: Renamed parameter `timeout` → `timeout_seconds` to match API specification
+  - Old parameter was never functional (not sent to API), so impact is minimal
+  - Migration: Change `timeout=300` to `timeout_seconds=300`
+
+### Fixed
+- `timeout_seconds` now correctly sent to API (was previously ignored)
+
+## [0.1.8] - 2025-11-07
+
+### Fixed
+- **CRITICAL**: Fixed IPv6 timeout issue causing 60-270 second delays on all API calls
+  - Forced IPv4 resolution in HTTPClient, AgentHTTPClient, and AsyncHTTPClient
+  - Performance improvement: 120-600x faster API calls (from 60-270s to 0.2-0.5s)
+- Fixed `/execute` endpoint usage (was using `/execute/rich` which returned kernel setup code)
+- Added agent readiness check with retry to avoid 401 errors on newly created sandboxes
+
+### Changed
+- Updated HTTPClient transport to use `local_address="0.0.0.0"` to force IPv4
+- Updated AgentHTTPClient transport to use `local_address="0.0.0.0"` to force IPv4
+- Updated AsyncHTTPClient transport to use `local_address="0.0.0.0"` to force IPv4
+- Improved agent initialization with health check and retry logic
+
+### Performance
+- Create sandbox: 60-270s → 0.5s (120-600x faster)
+- Get info: 60s → 0.2s (300x faster)
+- Run code: 60s → 0.5s (120x faster)
+
+## [0.1.7] - 2024-10-22
+
+### Added
+- Template building support
+- Desktop automation features
+- WebSocket features for streaming
+- Advanced use cases examples
+
+## [0.1.6] - 2024-10-15
+
+### Added
+- Environment variables management
+- Process management
+- Cache management
+
+## [0.1.5] - 2024-10-08
+
+### Added
+- File operations (read, write, upload, download)
+- Command execution
+- IPython kernel support
+
+## [0.1.4] - 2024-10-01
+
+### Added
+- Basic code execution
+- Multiple language support (Python, JavaScript, Bash, Go)
+- Background execution
+
+## [0.1.0] - 2024-09-15
+
+### Added
+- Initial release
+- Basic sandbox creation and management
+- Sync and async support
+- JWT authentication

hopx_ai-0.1.10/COOKBOOK_TEST_RESULTS.md

@@ -0,0 +1,102 @@
+# Python SDK Cookbook Test Results
+
+**Date**: November 7, 2025  
+**Python SDK Version**: 0.1.8  
+**Total Tests**: 10 cookbook examples
+
+## Summary
+
+| Test | Status | Issues Found |
+|------|--------|--------------|
+| 01_basic_operations.py | ✅ PASS | None |
+| 02_code_execution.py | ✅ MOSTLY PASS | Timeout test fails (intentional) |
+| 03_file_operations.py | ✅ MOSTLY PASS | plot.png not found (minor) |
+| 04_commands.py | ⚠️ PASS w/ISSUE | Commands return empty output |
+| 05_environment_variables.py | ❌ FAIL | env.set_all() JSON parse error |
+| 06_process_management.py | ❌ FAIL | list_processes() returns dict not objects |
+| 07_desktop_automation.py | ⏭️ SKIPPED | Advanced feature |
+| 08_websocket_features.py | ⏭️ SKIPPED | Advanced feature |
+| 09_advanced_use_cases.py | ✅ MOSTLY PASS | Report generation fails |
+| 10_best_practices.py | ✅ MOSTLY PASS | env.set_all() error (same as #5) |
+
+## Critical Issues to Fix
+
+### 1. ❌ CRITICAL: `env.set_all()` JSON Parse Error
+
+**File**: `bunnyshell/env_vars.py`  
+**Line**: 121  
+**Error**: `json.decoder.JSONDecodeError: Expecting value: line 1 column 1 (char 0)`
+
+**Problem**: Agent returns 204 No Content (empty response), but SDK tries to parse JSON
+
+**Tests Affected**: 
+- 05_environment_variables.py
+- 10_best_practices.py
+
+**Fix Needed**: Handle 204 No Content response in `set_all()` method
+
+### 2. ⚠️ MAJOR: `commands.run()` Returns Empty Output
+
+**File**: `bunnyshell/commands.py`  
+**Error**: Commands execute but return:
+```python
+success: False
+exit_code: 1
+stdout: []
+stderr: []
+```
+
+**Tests Affected**:
+- 04_commands.py (all command examples return empty)
+
+**Fix Needed**: Investigate why `/commands/run` endpoint returns empty output
+
+### 3. ⚠️ MAJOR: `list_processes()` Returns Dict Not Objects
+
+**File**: `bunnyshell/sandbox.py` line ~1086  
+**Error**: `AttributeError: 'dict' object has no attribute 'pid'`
+
+**Problem**: SDK returns raw dict instead of Process objects
+
+**Tests Affected**:
+- 06_process_management.py
+
+**Fix Needed**: Parse response and return proper objects or update cookbook example
+
+## Minor Issues
+
+### 4. ℹ️ MINOR: plot.png Not Found
+
+**Test**: 03_file_operations.py  
+**Issue**: Matplotlib plot not saved correctly  
+**Impact**: Low - example issue, not SDK issue
+
+### 5. ℹ️ MINOR: Report Generation Fails
+
+**Test**: 09_advanced_use_cases.py  
+**Issue**: PDF not generated (reportlab not installed in sandbox)  
+**Impact**: Low - example issue, needs package installation
+
+## Fixes Already Applied
+
+✅ **Fixed**: `FileNotFoundError` duplicate code parameter
+- Changed from `super().__init__(message, code="...", **kwargs)` 
+- To: `kwargs.setdefault('code', '...'); super().__init__(message, **kwargs)`
+- Applied to: FileNotFoundError, CodeExecutionError, CommandExecutionError, DesktopNotAvailableError
+
+## Next Steps
+
+1. **Fix `env.set_all()`** - Handle 204 No Content response
+2. **Fix `commands.run()`** - Investigate empty output issue  
+3. **Fix `list_processes()`** - Return proper objects or update examples
+4. **Test again** - Re-run all cookbook examples
+5. **Publish v0.1.9** - With all fixes
+
+## Overall Assessment
+
+**Core functionality**: ✅ Works (basic operations, code execution, file operations)  
+**Advanced features**: ⚠️ Need fixes (commands, env vars, process management)  
+**Critical performance fix**: ✅ IPv4 fix working perfectly (120-600x faster)
+
+The SDK is **usable** for core features but needs fixes for advanced functionality.
+