Python SDKAPI ReferenceComponents

BashServerToolConfig - Python SDK

BashServerToolConfig method reference

The Python SDK and docs are currently in beta. Report issues on GitHub.

Configuration for the openrouter:bash server tool

Fields

FieldTypeRequiredDescriptionExample
engineOptional[components.BashServerToolEngine]➖Which bash engine to use. “openrouter” runs commands server-side in the OpenRouter sandbox. “auto” (default) and “native” use native passthrough, returning the tool call to your application to run client-side; OpenRouter does not execute the commands.auto
environmentOptional[components.BashServerToolEnvironment]➖Execution environment for the bash server tool.{"type": "container_auto"}
sleep_after_secondsOptional[int]➖How long (in seconds) the container stays warm after its last command before sleeping, freeing its capacity slot. Idle-based: each command renews the timer. Defaults to 900 (15 minutes); capped at 2592000 (30 days).900