agentruntime

package

v1.0.0 Latest Latest Go to latest Published: May 19, 2026 License: MIT Imports: 5 Imported by: 0

Details

View Source

const (
	HarnessCodex    = "codex"
	HarnessClaude   = "claude"
	HarnessAuggie   = "auggie"
	HarnessPi       = "pi"
	HarnessOpencode = "opencode"
)

View Source

var ErrPromptImagesUnsupported = errors.New("prompt images are unsupported for this agent harness")

func DisplayName(harness string) string

DisplayName returns the user-facing harness label.

func SupportedHarnesses() []string

SupportedHarnesses returns supported harness names in stable order.

func SupportedPromptImageHarnesses() []string

SupportedPromptImageHarnesses returns the harnesses that accept prompt images.

func SupportsPromptImages(harness string) bool

SupportsPromptImages reports whether the selected harness accepts prompt image attachments.

func UnsupportedPromptImagesError(harness string) error

UnsupportedPromptImagesError returns a stable error for unsupported image attachments.

type RunOptions struct {
	SkipGitRepoCheck bool
	ImagePaths       []string
	WritableDirs     []string
}

RunOptions controls provider-specific execution behavior.

type Runtime struct {
	Harness    string
	Command    string
	NPMPackage string
}

Runtime describes one executable LLM harness runtime.

func Default() Runtime

Default returns the default runtime selection.

func Resolve(harness, commandOverride string) (Runtime, error)

Resolve validates harness selection and applies defaults.

func (r Runtime) BuildCommand(targetDir, prompt string, opts RunOptions) (execx.Command, error)

BuildCommand builds an execution command for this runtime.

func (r Runtime) PreflightCommand() execx.Command

PreflightCommand returns the command used to verify CLI availability.

func (r Runtime) RequirementName() string

RequirementName returns the boot diagnostic requirement key for this runtime.