Python SDKAPI ReferenceComponents

ShellServerToolConfig - Python SDK

ShellServerToolConfig method reference

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

Configuration for the openrouter:shell server tool

Fields

FieldTypeRequiredDescriptionExample
engineOptional[components.ShellServerToolEngine]➖Which shell engine to use. “openrouter” runs commands server-side in the OpenRouter sandbox. “auto” (default) keeps the provider’s native hosted shell when available (OpenAI); on other providers the call is routed to the OpenRouter sandbox.openrouter
environmentOptional[components.ShellServerToolEnvironment]➖Server-side execution environment for the shell tool. Only container-backed environments are supported; “local” shells are not.{"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