smah.runner

class smah.runner.Runner(args, settings)

Bases: object

MAX_PIPE_LENGTH = 2048

PIPE_HEAD_LENGTH = 1024

static copy_to_clipboard(text: str) → bool

Best-effort clipboard copy.

Returns False whenever the optional pyperclip dependency is unavailable or the copy fails; callers must treat clipboard as a nice-to-have only.

Parameters:

text (str) – The text to copy.

Returns:

True if the text was copied, False otherwise.

Return type:

bool

inference_model(task: str) → Model | None

static log_mode(mode: str, level: int = 20, show: bool = False) → None

static log_pipe_plan(plan: dict, level: int = 10, show: bool = False)

static log_query_plan(plan: dict, level: int = 10, show: bool = False)

pipe(query: str, pipe: str) → str | None

pipe_plan(query: str, pipe: str) → Tuple[bool, dict] | None

static planner_response(response: Completion) → Tuple[bool, dict] | None

static print_message(message: dict, format: bool = False, strip_cot=True, styles: dict | None = None)

provider_for(model: Model) → Provider

Resolve the configured provider implementation for a model (exits 3 on unknown keys).

query(query: str) → str | None

query_plan(query: str) → Tuple[bool, dict] | None

static replace_exec_tags(content: str)

resume(id: int, title: str, plan: dict, pipe: str, messages: list) → None

run(model: Model, thread: list, response_format: dict | _Unset = UNSET, tools: dict | _Unset = UNSET, options: dict | None = None, show: bool = False) → Completion

static show_suggested_commands(commands: list[dict]) → None

Print suggested commands for the user to review and run themselves.

SMAH never executes commands; this presentation is print-only by design. Each command is rendered in a clearly delimited panel with the model’s title/purpose (its explanation of what the command does and its impact), the command itself in a copy-friendly code block, and an explicit notice that SMAH does not run commands.

Parameters:

commands (list[dict]) – Commands extracted from the model response (dicts with title/purpose/command/shell keys).

Modules

prompts
response_parser
runner