Skip to contents

Agent Driver R6 Class

Source: R/driver.R
AgentDriver.Rd

Abstract base class for CLI-based LLM drivers.

Value

An `AgentDriver` R6 object.

Public fields

id

String. Unique identifier for the driver.

provider

String. Provider name (e.g., "google", "ollama").

model_name

String. The specific model identifier.

supported_opts

Character vector. Allowed CLI option names.

validation_mode

String. Either "warning" or "strict".

working_dir

String. Optional path to the working directory/worktree.

repo_root

String. Path to the main repository root (for root-locked CLIs).

Methods

Public methods

Method new()

Initialize AgentDriver

Usage

AgentDriver$new(
  id,
  provider = "unknown",
  model_name = "unknown",
  validation_mode = "warning",
  working_dir = NULL,
  repo_root = NULL
)

Arguments

id

Unique identifier.

provider

String. Provider name.

model_name

String. Model identifier.

validation_mode

String. "warning" or "strict".

working_dir

String. Optional working directory.

repo_root

String. Path to the main repository root. Get Driver Capabilities

Method get_capabilities()

Usage

AgentDriver$get_capabilities()

Returns

List of logicals. Execute Command in Working Directory

Method exec_in_dir()

Safely executes a system command within the specified 'working_dir' using 'withr::with_dir' to ensure the original CWD is restored.

Usage

AgentDriver$exec_in_dir(command, args, ...)

Arguments

command

String. The command to run.

args

Character vector. Command arguments.

...

Additional arguments passed to system2.

Returns

Result of system2 call. Filter CLI Noise from LLM Output

Method filter_llm_noise()

Removes common CLI-injected headers, keychain warnings, or MCP status messages that can corrupt the generated model content.

Usage

AgentDriver$filter_llm_noise(text)

Arguments

text

String or Character Vector. Raw output from the CLI.

Returns

Character vector of cleaned lines. Call the LLM

Method call()

Usage

AgentDriver$call(
  prompt,
  model = NULL,
  system_prompt = NULL,
  cli_opts = list(),
  ...
)

Arguments

prompt

String. The prompt to send.

model

String. Optional model override.

system_prompt

String. Optional system prompt.

cli_opts

List. Named list of CLI options.

...

Additional arguments.

Returns

String. Cleaned response from the LLM. Validate No Command Injection

Method validate_no_injection()

Portably prevents command injection by rejecting inputs with shell metacharacters.

Usage

AgentDriver$validate_no_injection(x)

Arguments

x

String or character vector.

Returns

The original string invisibly, or throws an error. Validate CLI Options

Method validate_cli_opts()

Usage

AgentDriver$validate_cli_opts(cli_opts)

Arguments

cli_opts

List. Named list to validate.

Returns

Invisible TRUE if valid. Format CLI Options

Method format_cli_opts()

Usage

AgentDriver$format_cli_opts(cli_opts = list())

Arguments

cli_opts

List. Named list to format.

Returns

Character vector of CLI flags.

Method clone()

The objects of this class are cloneable with this method.

Usage

AgentDriver$clone(deep = FALSE)

Arguments

deep

Whether to make a deep clone.

Examples

if (FALSE) { # \dontrun{
driver <- AgentDriver$new(id = "test", provider = "mock")
} # }