Struct RuntimeConfig 

pub struct RuntimeConfig {
    pub kind: RuntimeKind,
    pub docker: DockerRuntimeConfig,
    pub shell: Option<String>,
    pub reasoning_enabled: Option<bool>,
    pub reasoning_effort: Option<String>,
}

Runtime adapter configuration ([runtime] section).

Fields

kind: RuntimeKind

Runtime kind: native | docker | cloudflare.

docker: DockerRuntimeConfig

Docker runtime settings (used when kind = "docker").

shell: Option<String>

Shell binary the native runtime uses for command execution.

Applies only to runtime.kind = "native"; other runtimes ignore it. When unset or null, the system default sh is used. The shell is invoked as <shell> -c "<command>", so it must be a POSIX-compatible shell binary.

Accepted forms (Unix):

• a bare command name resolved via PATH (e.g. "bash"), or
• an absolute path (e.g. "/bin/bash", "/usr/bin/zsh").

The value is validated when the native runtime is constructed, so a bad value is reported up front rather than failing on the first shell command. Rejected: empty/whitespace; a relative path with separators (e.g. "./sh", "bin/sh" — use a bare PATH name or an absolute path instead); a bare name not found on PATH; and a path that does not exist or is not executable.

Ignored on Windows and Android (and not validated there): Windows always uses cmd.exe, and Android always uses /system/bin/sh (its shell is not on PATH for spawned processes).

Examples:

[runtime]
shell = "bash" # resolves via PATH
shell = "/bin/zsh" # absolute path

reasoning_enabled: Option<bool>

Global reasoning override for model_providers that expose explicit controls.

• None: model_provider default behavior
• Some(true): request reasoning/thinking when supported
• Some(false): disable reasoning/thinking when supported

reasoning_effort: Option<String>

Optional reasoning effort for model_providers that expose a level control.

Implementations

impl RuntimeConfig

pub fn configurable_prefix() -> &'static str

Returns the #[prefix] value for this Configurable struct.

pub fn secret_fields(&self) -> Vec<SecretFieldInfo>

Returns metadata about all #[secret] fields on this struct and nested children.

pub fn secret_field_terminals() -> Vec<&'static str>

pub fn encrypt_secrets(&mut self, store: &SecretStore) -> Result<(), Error>

Encrypt all secret fields in place using the provided store.

pub fn decrypt_secrets(&mut self, store: &SecretStore) -> Result<(), Error>

Decrypt all secret fields in place using the provided store.

pub fn set_secret(&mut self, name: &str, value: String) -> Result<(), Error>

Set a secret field by its full dotted name, dispatching to nested children.

pub fn prop_fields(&self) -> Vec<PropFieldInfo>

Returns metadata about all property fields on this struct and nested children.

pub fn get_prop(&self, name: &str) -> Result<String, Error>

Get a property value by its full dotted name, returning it as a display string.

pub fn set_prop(&mut self, name: &str, value_str: &str) -> Result<(), Error>

Set a property value by its full dotted name, parsing from string.

pub fn prop_is_secret(name: &str) -> bool

Check if a property name refers to a secret field (static, no instance needed).

pub fn init_defaults(&mut self, prefix: Option<&str>) -> Vec<&'static str>

Instantiate None nested sections whose prefix matches. Returns the prefixes that were initialized.

pub fn map_key_sections() -> Vec<MapKeySection>

Enumerate every map-keyed (HashMap<String, T>) and list-shaped (Vec<T>) section discoverable from this Configurable’s tree. The dashboard / CLI consume this to surface “+ Add” affordances without hardcoding the section list.

pub fn nested_section_help(name: &str) -> Option<&'static str>

Help blurb for a #[nested] field on this struct, sourced from the field-level /// docstring. Returns None for unknown names so callers can fall through to a different lookup.

pub fn nested_section_group(name: &str) -> Option<&'static str>

pub fn get_map_keys(&self, section_path: &str) -> Option<Vec<String>>

Return the current alias keys at section_path, or None if the path doesn’t resolve to a map-keyed section in this tree.

pub fn nested_option_entries(&self) -> Vec<NestedOptionEntry>

pub fn create_map_key( &mut self, section_path: &str, map_key: &str, ) -> Result<bool, String>

pub fn delete_map_key( &mut self, section_path: &str, map_key: &str, ) -> Result<bool, String>

pub fn rename_map_key( &mut self, section_path: &str, map_key: &str, new_key: &str, ) -> Result<bool, String>

Trait Implementations

impl Clone for RuntimeConfig

fn clone(&self) -> RuntimeConfig

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for RuntimeConfig

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl Default for RuntimeConfig

fn default() -> RuntimeConfig

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for RuntimeConfig

fn deserialize<__D>( __deserializer: __D, ) -> Result<RuntimeConfig, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl JsonSchema for RuntimeConfig

fn schema_name() -> Cow<'static, str>

The name of the generated JSON Schema.

fn schema_id() -> Cow<'static, str>

Returns a string that uniquely identifies the schema produced by this type.

fn json_schema(generator: &mut SchemaGenerator) -> Schema

Generates a JSON Schema for this type.

fn inline_schema() -> bool

Whether JSON Schemas generated for this type should be included directly in parent schemas, rather than being re-used where possible using the $ref keyword.

impl MaskSecrets for RuntimeConfig

fn mask_secrets(&mut self)

fn restore_secrets_from(&mut self, current: &RuntimeConfig)

impl Serialize for RuntimeConfig

fn serialize<__S>( &self, __serializer: __S, ) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.