agentrunner

type ExecFunc = func(ctx context.Context, name string, args ...string) *exec.Cmd

type Options struct {
	// BinaryPath is the infer binary to spawn; defaults to os.Args[0] when empty.
	BinaryPath string
	// Exec overrides command construction (tests); defaults to exec.CommandContext.
	Exec ExecFunc

	SessionID string
	Prompt    string
	Model     string
	Files     []string

	RequireApproval bool
	Remote          bool
	Heartbeat       bool
	// ResultFile, when set, passes --result-file so the agent writes its final
	// assistant message to a JSON file on exit (used by detached/tmux runs).
	ResultFile string
	// ExtraEnv is appended to os.Environ() for the subprocess (e.g. depth guard).
	ExtraEnv []string

	// OnLine is called for each non-empty raw stdout line. Approval-request
	// lines handled internally (see Approval) are not passed to OnLine.
	OnLine func(line []byte)
	// Approval, when set and RequireApproval is true, resolves a tool approval
	// request into a response that is written back to the agent's stdin. It
	// blocks until the decision is made.
	Approval func(domain.ApprovalRequest) domain.ApprovalResponse
}

type Result struct {
	// FinalAssistant is the last non-empty assistant message content seen on
	// stdout - the harvested "answer" of the run.
	FinalAssistant string
	// Stderr is the full captured standard error (also mirrored live to os.Stderr).
	Stderr string
}