harness

type Cost struct {
	Input, Output         float64
	CacheRead, CacheWrite *float64
	// LongContext prices long-context requests, when the provider tiers them.
	LongContext *Cost
}

type Detection struct {
	Name      string
	Path      string
	Installed bool
	Version   string
}

type Execer interface {
	LookPath(file string) (string, error)
	Exec(cmd *exec.Cmd) error
}

type Harness interface {
	// Name is the --harness value.
	Name() string
	// Detect finds the harness executable and its settings file in configDir,
	// or in the harness's native configuration directory when configDir is empty.
	Detect(ctx context.Context, execer Execer, configDir string) (Detection, error)
	// Prepare plans setup of the settings file at path. The plan keeps the
	// file's current credential; ApplyPlans inserts the real one.
	Prepare(path string, routes []Route, selection Selection, endpoint string) ([]*Plan, error)
	// Inspect reports the integration state of the detected settings file.
	Inspect(d Detection) (Status, error)
	// Teardown plans removal of the integration settings at path.
	Teardown(path string) ([]*Plan, error)
	// BackgroundRoute is the route for lightweight background tasks, or "" if
	// the harness has no such setting.
	BackgroundRoute(selection Selection) string
	// Credential returns the routes API key setup wrote to the settings file at
	// path, or "" if there is none.
	Credential(path string) (string, error)
	// Routes returns the routes the harness can call, in order.
	Routes(routes []Route) []Route
}

type Plan struct {
	Harness  string
	Path     string
	Keys     []string
	Replaced []string
	Managed  bool
	Changed  bool
	// contains filtered or unexported fields
}

type Route struct {
	Name        string
	DisplayName string
	// Target is the route's upstream provider, such as TargetAnthropic, which
	// decides the API a harness calls the route with.
	Target          string
	ContextWindow   int
	OutputLimit     int
	InputModalities []string
	Tools           bool
	ReasoningLevels []string
	ParallelTools   bool
	// Messages and Responses report whether the route serves the Anthropic
	// Messages API and the OpenAI Responses API.
	Messages  bool
	Responses bool
	// Cost is the provider's list price, or nil if unknown.
	Cost *Cost
}

type Selection struct {
	Primary    string
	Background string
	Subagent   string
	Fallback   string
}

type Status struct {
	Detection
	State           string
	DefaultRoute    string
	BackgroundRoute string
	Routes          []Route
	// Managed lists the integration settings present in the file.
	Managed []string
}