agentloop

type Budget struct {
	MaxSteps  int
	MaxTokens int
	WallClock time.Duration
}

type Config struct {
	// Runtime + ModelRef select the model ("provider/model"). Provider,
	// when non-nil, bypasses the runtime (tests, custom providers) and
	// Model names the model to request from it.
	Runtime  *runtime.Runtime
	ModelRef string
	Provider chat.Provider
	Model    string

	// WorkDir is the directory the toolset is jailed to and gate
	// commands run in.
	WorkDir string

	// SystemTmpl is a text/template rendered with PromptData. Empty
	// selects DefaultSystemTemplate.
	SystemTmpl string
	// Mission is the task statement, injected into the first user message.
	Mission string
	// ExtraRules is free-form guidance appended to the rendered prompt.
	ExtraRules string

	// PreloadFiles are read from WorkDir and included in the initial
	// context (the eval_loop "preload everything" strategy). Missing
	// files are skipped with a log line.
	PreloadFiles []string

	// Notes, when non-nil, is loaded into the initial context and
	// exposed to the model via a write_note tool.
	Notes NotesStore

	// Gate is the quality gate. An empty command list disables gating.
	Gate GateConfig
	// Preflight commands run before the loop; their output is injected
	// as ground truth (toolchain versions, go fix -diff, ...).
	Preflight []GateCommand

	Budget Budget

	// ReadOnly registers only read/grep/find (planner/analysis missions).
	ReadOnly bool
	// ProtectPaths, when non-nil, blocks write/edit on matching paths
	// (relative, as the model supplies them) with an in-band refusal —
	// an environmental constraint where a prompt rule would be advisory
	// (e.g. a TDD fix stage protecting the committed repro tests).
	ProtectPaths func(path string) bool
	// Extra tools are merged into the toolset after the built-ins.
	Extra core.ToolSet

	Logger *slog.Logger
}

type FileNotesStore struct{ Path string }

type GateCommand struct {
	Name          string
	Argv          []string
	ExpectFailure bool
}

type GateConfig struct {
	Commands []GateCommand
	// MaxConsecutiveFailures parks the run after N failing gate cycles
	// in a row. Zero means the default of 5.
	MaxConsecutiveFailures int
}

type NotesStore interface {
	Load(ctx context.Context) (string, error)
	Append(ctx context.Context, entry string) error
}

type PromptData struct {
	WorkDir      string
	GateCommands []string // human-readable command lines, in gate order
	ExtraRules   string
	ReadOnly     bool
}

type Result struct {
	Status     Status   `json:"status"`
	StopReason string   `json:"stop_reason"`
	Changes    []string `json:"changes,omitempty"` // files written/edited, in first-touch order
	Iterations int      `json:"iterations"`
	TokensUsed int      `json:"tokens_used"`
	Summary    string   `json:"summary,omitempty"` // from the finish tool
	Detail     string   `json:"detail,omitempty"`  // last gate failure / park explanation
}

type Status string