Skip to content

0.8.0 — Command-Only Execution

Choose a tag to compare

@vijit-lark vijit-lark released this 12 Apr 00:45
· 57 commits to main since this release
1f0e720

What's New

execute_commands() — Run shell commands in the sandbox without invoking the agent. Returns per-command exit codes with the same streaming, cancellation, timeout, secret redaction, and artifact upload support as query().

result = await client.execute_commands(
    commands=[
        CommandInterface(command="mkdir -p /app/output"),
        CommandInterface(command="echo 'sandbox is ready' > /app/output/status.txt"),
    ],
    options=ExecuteCommandsOptions(
        on_assistant_message=on_assistant,
    ),
)

Wire Protocol

  • New command_execution_message (client → runtime) to request command-only execution
  • New command_execution_result_message (runtime → client) with per-command exit codes

New Python Client Types

ExecuteCommandsOptions, CommandExecutionResult, CommandResultItem, CommandExecutionMessage

Breaking Changes

None. This is a purely additive release.