Terminal Access

from hopx_ai import Sandbox

sandbox = Sandbox.create(template="code-interpreter")
terminal = sandbox.terminal  # Lazy-loaded

async terminal.connect(*, timeout=30) -> WebSocketClientProtocol

import asyncio

async def use_terminal():
    ws = await sandbox.terminal.connect()
    # Use terminal...
    await ws.close()

asyncio.run(use_terminal())

async terminal.send_input(ws, data) -> None

await sandbox.terminal.send_input(ws, "echo 'Hello'\n")

async terminal.resize(ws, cols, rows) -> None

await sandbox.terminal.resize(ws, 80, 24)

async terminal.iter_output(ws) -> AsyncIterator[Dict[str, Any]]

async for message in sandbox.terminal.iter_output(ws):
    if message.get('type') == 'stdout':
        print(message.get('data', ''), end='')

import asyncio
from hopx_ai import Sandbox

async def main():
    sandbox = Sandbox.create(template="code-interpreter")
    
    # Connect to terminal
    ws = await sandbox.terminal.connect()
    
    # Send command
    await sandbox.terminal.send_input(ws, "echo 'Hello, Terminal!'\n")
    
    # Read output
    async for message in sandbox.terminal.iter_output(ws):
        if message.get('type') == 'stdout':
            print(message.get('data', ''), end='')
            break  # Exit after first output
    
    await ws.close()
    sandbox.kill()

asyncio.run(main())

import asyncio
from hopx_ai import Sandbox

async def main():
    sandbox = Sandbox.create(template="code-interpreter")
    ws = await sandbox.terminal.connect()
    
    # Resize terminal
    await sandbox.terminal.resize(ws, 120, 40)
    
    # Send multiple commands
    commands = [
        "pwd\n",
        "ls -la\n",
        "echo 'Done'\n"
    ]
    
    for cmd in commands:
        await sandbox.terminal.send_input(ws, cmd)
        # Read output
        async for message in sandbox.terminal.iter_output(ws):
            if message.get('type') == 'stdout':
                print(message.get('data', ''), end='')
            elif message.get('type') == 'done':
                break
    
    await ws.close()
    sandbox.kill()

asyncio.run(main())