simplex 1.0.0__py3-none-any.whl → 1.0.8__py3-none-any.whl

simplex-1.0.8.dist-info/METADATA

@@ -0,0 +1,408 @@
+Metadata-Version: 2.4
+Name: simplex
+Version: 1.0.8
+Summary: Official Python SDK for the Simplex API
+Home-page: https://github.com/yourusername/simplex-python-sdk
+Author: Simplex
+Author-email: Simplex <support@simplex.sh>
+License: MIT
+Project-URL: Homepage, https://github.com/yourusername/simplex-python-sdk
+Project-URL: Documentation, https://docs.simplex.sh
+Project-URL: Repository, https://github.com/yourusername/simplex-python-sdk
+Project-URL: Bug Tracker, https://github.com/yourusername/simplex-python-sdk/issues
+Keywords: simplex,api,sdk,workflow,automation,browser
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.25.0
+Requires-Dist: urllib3>=1.26.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-cov>=3.0.0; extra == "dev"
+Requires-Dist: black>=22.0.0; extra == "dev"
+Requires-Dist: flake8>=4.0.0; extra == "dev"
+Requires-Dist: mypy>=0.950; extra == "dev"
+Requires-Dist: python-dotenv>=0.19.0; extra == "dev"
+Dynamic: author
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-python
+
+# Simplex Python SDK
+
+Official Python SDK for the [Simplex API](https://simplex.sh) - A powerful workflow automation platform for browser-based tasks.
+
+[![Python Version](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+## Features
+
+- 🚀 Simple and intuitive API
+- 🔄 Automatic retry logic with exponential backoff
+- 🎯 Type hints for better IDE support
+- 🔐 Built-in error handling
+- 📦 Context manager support for automatic cleanup
+- 🤖 Support for agentic workflows and named agents
+- 📁 File download capabilities
+- 🔑 2FA configuration management
+
+## Installation
+
+Install the Simplex SDK using pip:
+
+```bash
+pip install simplex
+```
+
+## Quick Start
+
+```python
+from simplex import SimplexClient
+
+# Initialize the client
+client = SimplexClient(api_key='your-api-key')
+
+# Run a workflow with variables
+result = client.workflows.run(
+    'workflow-id',
+    variables={'username': 'user@example.com'}
+)
+
+print(f"Workflow started: {result['session_id']}")
+```
+
+## Usage Examples
+
+### Creating a Workflow Session
+
+Use workflow sessions for more control over browser automation:
+
+```python
+from simplex import SimplexClient
+
+client = SimplexClient(api_key='your-api-key')
+
+# Using context manager for automatic cleanup
+with client.create_workflow_session(
+    name='my-workflow',
+    url='https://example.com'
+) as session:
+    print(f'Session ID: {session.session_id}')
+    print(f'Livestream URL: {session.livestream_url}')
+    
+    # Navigate to a page
+    session.goto('https://example.com/login')
+    
+    # Run a named agent
+    session.run_agent('Login Agent', variables={
+        'username': 'user@example.com',
+        'password': 'secret'
+    })
+    
+    # Execute an agentic task
+    session.agentic('Click the submit button and wait for confirmation')
+    
+    # Session automatically closes when exiting the with block
+```
+
+### Running a Workflow
+
+Execute pre-built workflows with variables:
+
+```python
+from simplex import SimplexClient, WorkflowError
+
+client = SimplexClient(api_key='your-api-key')
+
+try:
+    # Run workflow with variables
+    result = client.workflows.run(
+        'workflow-id',
+        variables={
+            'email': 'user@example.com',
+            'product_id': '12345'
+        },
+        metadata='Order processing workflow'
+    )
+    
+    print(f"Success: {result['succeeded']}")
+    print(f"Session ID: {result['session_id']}")
+    
+    # Check workflow status
+    status = client.workflows.get_status(result['session_id'])
+    print(f"Completed: {status['completed']}")
+    print(f"Total actions: {status['total_actions']}")
+    
+except WorkflowError as e:
+    print(f"Workflow failed: {e.message}")
+```
+
+### Using Agentic Tasks
+
+Execute natural language instructions:
+
+```python
+# Within a workflow session
+session.agentic(
+    'Navigate to the invoices page and download the latest invoice',
+    max_steps=10
+)
+
+# Or using the workflows resource
+client.workflows.agentic(
+    task='Find and click the login button',
+    session_id='session-id',
+    max_steps=5
+)
+```
+
+### Downloading Session Files
+
+Download files created during workflow execution:
+
+```python
+from simplex import SimplexClient
+
+client = SimplexClient(api_key='your-api-key')
+
+# Download all files as a zip
+zip_data = client.download_session_files('session-id')
+with open('session_files.zip', 'wb') as f:
+    f.write(zip_data)
+
+# Download a specific file
+file_data = client.download_session_files('session-id', filename='report.pdf')
+with open('report.pdf', 'wb') as f:
+    f.write(file_data)
+```
+
+### Adding 2FA Configuration
+
+Configure automatic 2FA handling:
+
+```python
+from simplex import SimplexClient
+
+client = SimplexClient(api_key='your-api-key')
+
+result = client.add_2fa_config(
+    seed='JBSWY3DPEHPK3PXP',
+    name='My Service',
+    partial_url='example.com'
+)
+
+print(f"Total configs: {result['total_configs']}")
+```
+
+### Error Handling
+
+The SDK provides specific exception types for different error scenarios:
+
+```python
+from simplex import (
+    SimplexClient,
+    SimplexError,
+    WorkflowError,
+    AuthenticationError,
+    RateLimitError,
+    NetworkError
+)
+
+client = SimplexClient(api_key='your-api-key')
+
+try:
+    result = client.workflows.run('workflow-id')
+except AuthenticationError as e:
+    print(f"Authentication failed: {e.message}")
+except RateLimitError as e:
+    print(f"Rate limit exceeded. Retry after {e.retry_after} seconds")
+except WorkflowError as e:
+    print(f"Workflow error: {e.message}")
+    print(f"Workflow ID: {e.workflow_id}")
+    print(f"Session ID: {e.session_id}")
+except NetworkError as e:
+    print(f"Network error: {e.message}")
+except SimplexError as e:
+    print(f"General error: {e.message}")
+```
+
+## Configuration
+
+### Environment Variables
+
+You can use environment variables for configuration:
+
+```python
+import os
+from simplex import SimplexClient
+
+api_key = os.getenv('SIMPLEX_API_KEY')
+client = SimplexClient(api_key=api_key)
+```
+
+Example `.env` file:
+
+```bash
+SIMPLEX_API_KEY=your-api-key
+WORKFLOW_ID=your-workflow-id
+```
+
+### Client Options
+
+Customize client behavior with initialization parameters:
+
+```python
+from simplex import SimplexClient
+
+client = SimplexClient(
+    api_key='your-api-key',
+    timeout=60,           # Request timeout in seconds
+    max_retries=5,        # Maximum retry attempts
+    retry_delay=2,        # Delay between retries in seconds
+    base_url='https://api.simplex.sh'  # API base URL
+)
+```
+
+## API Reference
+
+### SimplexClient
+
+Main client class for interacting with the Simplex API.
+
+**Methods:**
+- `create_workflow_session(name, url, proxies=False, session_data=None)` - Create a new workflow session
+- `get_session_store(session_id)` - Retrieve session store data
+- `download_session_files(session_id, filename=None)` - Download files from a session
+- `add_2fa_config(seed, name=None, partial_url=None)` - Add 2FA configuration
+- `update_api_key(api_key)` - Update the API key
+- `set_custom_header(key, value)` - Set a custom header
+- `remove_custom_header(key)` - Remove a custom header
+
+### Workflow Resource
+
+Access via `client.workflows`
+
+**Methods:**
+- `run(workflow_id, variables=None, metadata=None, webhook_url=None)` - Execute a workflow
+- `get_status(session_id)` - Get workflow execution status
+- `create_workflow_session(workflow_name, url, proxies=False, session_data=None)` - Create a session
+- `agentic(task, session_id, max_steps=None, actions_to_exclude=None, variables=None)` - Run agentic task
+- `run_agent(agent_name, session_id, variables=None)` - Run a named agent
+- `start_segment(workflow_id, segment_name)` - Start a workflow segment
+- `finish_segment(workflow_id)` - Finish the current segment
+- `start_capture(session_id)` - Start capture mode
+- `stop_capture(session_id)` - Stop capture mode
+- `close_workflow_session(session_id)` - Close a session
+
+### WorkflowSession
+
+Created via `client.create_workflow_session()`. Supports context manager protocol.
+
+**Properties:**
+- `session_id` - Unique session identifier
+- `workflow_id` - Associated workflow ID
+- `livestream_url` - URL to view live browser session
+- `connect_url` - Connection URL
+- `vnc_url` - VNC access URL
+- `is_closed` - Whether the session is closed
+
+**Methods:**
+- `goto(url)` - Navigate to a URL
+- `agentic(task, max_steps=None, actions_to_exclude=None, variables=None)` - Execute agentic task
+- `run_agent(agent_name, variables=None)` - Run a named agent
+- `start_capture()` - Start capture mode
+- `stop_capture()` - Stop capture mode
+- `close()` - Close the session
+
+## Development
+
+### Setup Development Environment
+
+```bash
+# Create a virtual environment
+python -m venv venv
+source venv/bin/activate  # On Windows: venv\Scripts\activate
+
+# Install the package
+pip install simplex
+```
+
+### Running Tests
+
+```bash
+pytest tests/
+```
+
+### Code Formatting
+
+```bash
+black simplex/
+flake8 simplex/
+mypy simplex/
+```
+
+## Examples
+
+Check out the [examples](./examples) directory for more usage examples:
+
+- `login_example.py` - Basic login workflow
+- `create_workflow.py` - Creating and controlling sessions
+- `run_workflow.py` - Running workflows with variables
+- `download_file.py` - Downloading session files
+- `add_2fa_config.py` - Adding 2FA configuration
+
+## Requirements
+
+- Python 3.8 or higher
+- `requests>=2.25.0`
+- `urllib3>=1.26.0`
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+1. Fork the repository
+2. Create your feature branch (`git checkout -b feature/amazing-feature`)
+3. Commit your changes (`git commit -m 'Add some amazing feature'`)
+4. Push to the branch (`git push origin feature/amazing-feature`)
+5. Open a Pull Request
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+## Support
+
+- Documentation: [https://docs.simplex.sh](https://docs.simplex.sh)
+- Email: support@simplex.sh
+- GitHub Issues: [https://github.com/yourusername/simplex-python-sdk/issues](https://github.com/yourusername/simplex-python-sdk/issues)
+
+## Changelog
+
+### Version 1.0.0 (2024)
+
+- Initial release
+- Full feature parity with TypeScript SDK
+- Support for workflow execution and session management
+- Agentic task execution
+- Named agent support
+- File download capabilities
+- 2FA configuration management
+- Comprehensive error handling
+- Type hints throughout
+- Context manager support
+
+---
+
+Made with ❤️ by [Simplex](https://simplex.sh)

simplex-1.0.8.dist-info/RECORD

@@ -0,0 +1,13 @@
+simplex/__init__.py,sha256=brGWID41NoRNE_bquA7G_Neij4zbY826ZdNmOgrnnPY,802
+simplex/client.py,sha256=SqxjcAZ1dpXUmj-DawGxRdx61Wxrhd-tT1pd84iuEcM,11956
+simplex/errors.py,sha256=_IHJhhvFWWPFywjzXNxbVr2S8WOqThkhc2KzCZiN6i8,4653
+simplex/http_client.py,sha256=-khQqgIenG71oTV73chsbu-uY16NQCgbidiiTVLdIRk,12440
+simplex/types.py,sha256=8pPLJyQPDLuLFuCPRlYJajuJLZbvitE6v27zPkmV6IU,7546
+simplex/resources/__init__.py,sha256=yx_Ubd2LBrXbTwFrhhPgpu3jIy4JqUtb7BJvLnbkGwg,277
+simplex/resources/workflow.py,sha256=FP1c9uTXTgzaggZ485QIhktPKZQW9sOg6d2nbNrywPw,16250
+simplex/resources/workflow_session.py,sha256=3zjwQ55SI1sEP_VncE7w0_jyPrxthMYPJm5O3Uya8p8,10981
+simplex-1.0.8.dist-info/licenses/LICENSE,sha256=TyxVTRp5rBigFCL8EDC9Bv7AZfb4JBMVUZUeCs4Pk6Y,1063
+simplex-1.0.8.dist-info/METADATA,sha256=aB5s0VycncILa2q4shPlJl0FKm-APkjPrQPYjK3NMYY,11161
+simplex-1.0.8.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+simplex-1.0.8.dist-info/top_level.txt,sha256=cbMH1bYpN0A3gP-ecibPRHasHoqB-01T_2BUFS8p0CE,8
+simplex-1.0.8.dist-info/RECORD,,

{simplex-1.0.0.dist-info → simplex-1.0.8.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (75.7.0)
+Generator: setuptools (80.9.0)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

{simplex-1.0.0.dist-info → simplex-1.0.8.dist-info/licenses}/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2024 Simplex Labs, Inc.
+Copyright (c) 2024 Simplex
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
@@ -18,4 +18,4 @@ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE. 
+SOFTWARE.

simplex/constants.py

@@ -1 +0,0 @@
-BASE_URL = "https://u3mvtbirxf.us-east-1.awsapprunner.com"

simplex/simplex.py

@@ -1,187 +0,0 @@
-from playwright.sync_api import Page, sync_playwright
-from PIL import Image
-import requests
-from typing import List
-import io
-
-from .utils import center_bbox, screenshot_to_image
-
-BASE_URL = "https://u3mvtbirxf.us-east-1.awsapprunner.com"
-
-class Simplex:
-    def __init__(self, api_key: str, driver: Page = None):
-        """
-        Initialize Simplex instance
-        
-        Args:
-            api_key (str): API key for authentication
-            driver (playwright.sync_api.Page, optional): Playwright page object. If not provided, 
-                                                       a new headless browser instance will be created.
-        """
-        self.api_key = api_key
-        
-        if driver is None:
-            self.playwright = sync_playwright().start()
-            self.browser = self.playwright.chromium.launch(headless=True)
-            self.driver = self.browser.new_page()
-        else:
-            self.driver = driver
-            self.browser = None
-            self.playwright = None
-
-    def __del__(self):
-        """Cleanup Playwright resources"""
-        if self.browser:
-            self.browser.close()
-        if self.playwright:
-            self.playwright.stop()
-
-    def find_element(self, element_description: str, state: Image.Image | None = None) -> List[int]:
-        """
-        Find an element in the screenshot using the element description
-
-        Args:
-            element_description (str): Description of the element to find
-            screenshot (PIL.Image.Image): Screenshot of the page
-        
-        Returns:
-            bounding_box (tuple): [x1, y1, x2, y2] bounding box of the found element
-        """
-        if state is None:
-            state = self.take_stable_screenshot()
-
-        endpoint = f"{BASE_URL}/find-element"
-        
-        # Convert PIL Image to bytes
-        img_byte_arr = io.BytesIO()
-        state.save(img_byte_arr, format='PNG')
-        img_byte_arr = img_byte_arr.getvalue()
-        
-        # Prepare multipart form data
-        files = {
-            'image_data': ('screenshot.png', img_byte_arr, 'image/png'),
-            'element_description': (None, element_description),
-            'api_key': (None, self.api_key)
-        }        
-        # Make the request
-        response = requests.post(
-            endpoint,
-            files=files
-        )
-
-        # Print the results
-        print(f"Status Code: {response.status_code}")
-        if response.status_code == 200:
-            res = response.json()
-            bbox = [int(res['x1']), int(res['y1']), int(res['x2']), int(res['y2'])]
-            return bbox 
-        else:
-            print("Error:", response.text)
-
-    def step_to_action(self, step_description: str, state: Image.Image | None = None) -> List[List[str]]:
-        """
-        Convert a step description to an action
-
-        Args:
-            step_description (str): Description of the step to convert to action
-            screenshot (PIL.Image.Image): Screenshot of the page
-        
-        Returns:
-            action (List[List[str, str]]): List of actions to perform
-        """
-        if state is None:
-            state = self.take_stable_screenshot()
-
-        endpoint = f"{BASE_URL}/step_to_action"
-        
-        # Convert PIL Image to bytes
-        img_byte_arr = io.BytesIO()
-        state.save(img_byte_arr, format='PNG')
-        img_byte_arr = img_byte_arr.getvalue()
-        
-        # Prepare form data
-        files = {
-            'image_data': ('screenshot.png', img_byte_arr, 'image/png'),
-            'step': (None, step_description),
-            'api_key': (None, self.api_key)
-        }
-        
-        # Make the request
-        response = requests.post(
-            endpoint,
-            files=files
-        )
-        
-        # Handle response
-        if response.status_code == 200:
-            res = response.json()
-            actions = res.split('\n')
-            actions = [action.split(',') for action in actions]
-            actions = [[action.strip() for action in action_pair] for action_pair in actions]
-            return actions
-        else:
-            print(f"Error: {response.status_code}")
-            print(response.text)
-            return []
-        
-    def goto(self, url: str) -> None:
-        """
-        Navigate to a URL
-        """
-        self.driver.goto(url)
-
-    def execute_action(self, action: List[List[str]], state: Image.Image | None = None) -> None:
-        """
-        Execute an action with playwright driver
-
-        Args:
-            action (List[List[str]]): List of actions to perform
-        """
-        action_type, description = action
-        if state is None:
-            state = self.take_stable_screenshot()
-
-        try:
-            if action_type == "CLICK":
-                bbox = self.find_element(description, state)
-                center_x, center_y = center_bbox(bbox)
-                self.driver.mouse.click(center_x, center_y)
-
-            elif action_type == "HOVER":
-                bbox = self.find_element(description, state)
-                center_x, center_y = center_bbox(bbox)
-                self.driver.mouse.move(center_x, center_y)
-
-            elif action_type == "TYPE":
-                self.driver.keyboard.type(description)
-
-            elif action_type == "SCROLL":
-                self.driver.mouse.wheel(0, int(description))
-
-            elif action_type == "WAIT":
-                self.driver.wait_for_timeout(int(description))
-
-        except Exception as e:
-            print(f"Error executing action: {e}")
-            return None
-        
-    def do(self, step_description: str) -> None:
-        """
-        Execute a step description
-        """
-        state = self.take_stable_screenshot()
-        actions = self.step_to_action(step_description, state)
-        for action in actions:
-            self.execute_action(action)
-            
-    def take_stable_screenshot(self) -> Image.Image:
-        """
-        Take a screenshot after ensuring the page is in a stable state.
-        
-        Returns:
-            PIL.Image.Image: Screenshot of the current page
-        """
-        self.driver.wait_for_load_state('networkidle')
-        return screenshot_to_image(self.driver.screenshot())
-            
-       

simplex/utils.py

@@ -1,12 +0,0 @@
-from typing import List
-from PIL import Image
-import io
-def center_bbox(bbox: List[int]) -> List[int]:
-    """
-    Calculate the center coordinates of a bounding box
-    """
-    return [(bbox[0] + bbox[2]) // 2, (bbox[1] + bbox[3]) // 2]
-
-
-def screenshot_to_image(screenshot: bytes) -> Image:
-    return Image.open(io.BytesIO(screenshot))

simplex-1.0.0.dist-info/METADATA

@@ -1,29 +0,0 @@
-Metadata-Version: 2.1
-Name: simplex
-Version: 1.0.0
-Summary: Official Python SDK for Simplex API
-Home-page: https://github.com/shreyka/simplex-python
-Author: Simplex Labs, Inc.
-Author-email: founders@simplex.sh
-Classifier: Programming Language :: Python :: 3
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Operating System :: OS Independent
-Classifier: Development Status :: 4 - Beta
-Classifier: Intended Audience :: Developers
-Requires-Python: >=3.6
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: openai>=1.0.0
-Requires-Dist: python-dotenv>=0.19.0
-Requires-Dist: tiktoken>=0.5.0
-Requires-Dist: click>=8.0.0
-Requires-Dist: rich>=13.0.0
-Requires-Dist: prompt_toolkit>=3.0.0
-Requires-Dist: playwright>=1.0.0
-Requires-Dist: Pillow>=9.0.0
-
-# Simplex AI Python SDK
-
-A Python SDK for Simplex AI that enables browser automation using natural language commands.
-
-## Installation 

simplex-1.0.0.dist-info/RECORD

@@ -1,10 +0,0 @@
-simplex/__init__.py,sha256=1mbM4XUk0FNW161WOkM4ayC1s_QSsaBEls6PZ0iBScY,74
-simplex/constants.py,sha256=nIXF2oVNNNknXweXAlmE-KBM9QjJtYw9osXVYjvloN0,59
-simplex/simplex.py,sha256=p3dGJFdyQReW2qHX-yFn9Vi6Bm8-QJ_x6RK66s1KkM8,6246
-simplex/utils.py,sha256=UrD4Ena3yk0POmxxyiqMszzPbTscTCJpMP4xZFDAuOc,339
-simplex-1.0.0.dist-info/LICENSE,sha256=Xh0SJjYZfNI71pCNMB40aKlBLLuOB0blx5xkTtufFNQ,1075
-simplex-1.0.0.dist-info/METADATA,sha256=4BL_hKn_yaVMoCpGSsUxTdVwwb2trncuwu7QyEFyE_M,917
-simplex-1.0.0.dist-info/WHEEL,sha256=A3WOREP4zgxI0fKrHUG8DC8013e3dK3n7a6HDbcEIwE,91
-simplex-1.0.0.dist-info/entry_points.txt,sha256=3veL2w3c5vxb3dm8I_M8Fs-370n1ZnvD8uu1nSsL7z8,45
-simplex-1.0.0.dist-info/top_level.txt,sha256=cbMH1bYpN0A3gP-ecibPRHasHoqB-01T_2BUFS8p0CE,8
-simplex-1.0.0.dist-info/RECORD,,

simplex-1.0.0.dist-info/entry_points.txt

@@ -1,2 +0,0 @@
-[console_scripts]
-simplex = simplex.cli:main