Struct CliSpec 

pub struct CliSpec {

    pub command: String,
    pub command_env: Option<String>,
    pub args: Vec<String>,
    pub prompt_delivery: PromptDelivery,
    pub prompt_flag: String,
    pub model_flag: String,
    pub default_model: String,
    pub output_format_flag: String,
    pub output_format_value: String,
    pub system_prompt_flag: String,
    pub output_mode: OutputMode,
    pub result_json_paths: JsonPaths,
    pub ndjson_match: LineMatchers,
    pub extra_args: Vec<String>,
    pub timeout: Option<Duration>,
    pub env_remove: Vec<String>,
}

Everything needed to call one agent CLI once.

Built by CliSpec::resolve from a preset plus [llm.cli]; pure data, so CliSpec::invocation is testable without spawning anything.

Fields

command: String

Binary name or path.

command_env: Option<String>

Environment variable that overrides command when config does not.

args: Vec<String>

Fixed arguments before every generated flag.

prompt_delivery: PromptDelivery

How the prompt reaches the process.

prompt_flag: String

Flag carrying the prompt under PromptDelivery::Flag.

model_flag: String

Flag selecting the model; empty omits it.

default_model: String

Model used when the config names none.

output_format_flag: String

Flag selecting the output format; empty omits it.

output_format_value: String

Value for output_format_flag; empty passes the flag alone.

system_prompt_flag: String

Flag carrying the system prompt; empty prepends it to the message.

output_mode: OutputMode

Shape of the CLI’s stdout.

result_json_paths: JsonPaths

Candidate paths to the answer inside JSON output; empty means stdout is the answer.

ndjson_match: LineMatchers

Predicates selecting the answer’s line under OutputMode::Ndjson.

extra_args: Vec<String>

Arguments after the generated flags.

timeout: Option<Duration>

Per-call limit; None waits forever.

env_remove: Vec<String>

Variables unset before spawning.

Implementations

impl CliSpec

pub fn preset(preset: CliPreset) -> Self

Defaults for a known CLI.

Verified on live calls against the installed binaries: claude 2.1.x, grok (JSON envelope confirmed) and codex 0.146.x (NDJSON stream confirmed). gemini 0.27.x is flags-only — its success field could not be checked without auth, so that preset tries several and falls back to stdout. See the provider table in the README.

pub fn resolve( provider: &Provider, section: &CliSection, ) -> Result<Self, RecallError>

Resolve the spec for a provider: its preset, then [llm.cli] on top.

Fails for the HTTP providers, which have no CLI to spawn, and for a spec left unusable — no command, or flag delivery with no flag.

pub fn resolve_command(&self) -> String

The binary to spawn: config first, then the preset’s environment override, then the preset default.

pub fn resolve_model(&self, configured: &str) -> String

The model this spec uses, given what the config asked for.

pub fn invocation( &self, model: &str, system_prompt: &str, user_message: &str, ) -> Invocation

Build the exact argv and stdin payload for one completion.

pub fn argv_preview(&self, model: &str) -> String

A human-readable, single-line argv for config show, with the prompts as placeholders.

Trait Implementations

impl Clone for CliSpec

fn clone(&self) -> CliSpec

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CliSpec

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

Formats the value using the given formatter.

impl Eq for CliSpec

impl PartialEq for CliSpec

fn eq(&self, other: &CliSpec) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for CliSpec