smelt.reasoning¶

Tier: Host - Available in every runtime, including headless mode.

Visibility: Public - Stable Lua API intended for user config and plugins.

This namespace mixes Host and UiHost functions; each function below lists its exact tier.

Reasoning-effort selector. smelt.reasoning.current() reads the active effort, smelt.reasoning.set(v) sets it in a TUI session, and smelt.reasoning.cycle_list() lists the configured cycle.

smelt.reasoning.current¶

fun(): smelt.reasoning.Effort

Types: smelt.reasoning.Effort

Tier: Host - Available in every runtime, including headless mode.

Return the active reasoning effort.

smelt.reasoning.cycle¶

fun(): nil

Tier: UiHost - Requires a terminal UI; calling these from headless mode raises.

Advance the active reasoning effort to the next entry in smelt.reasoning.cycle_list(), wrapping at the end. No-op when the cycle is empty.

smelt.reasoning.cycle_list¶

fun(): smelt.reasoning.Effort[]

Types: smelt.reasoning.Effort

Tier: Host - Available in every runtime, including headless mode.

Return the configured reasoning-effort cycle.

smelt.reasoning.set¶

fun(effort: smelt.reasoning.Effort): nil

Types: smelt.reasoning.Effort

Tier: UiHost - Requires a terminal UI; calling these from headless mode raises.

Set the active reasoning effort. The change is applied immediately to the UI and persisted according to the active remember policy.