appx

type AIer ¶

type AIer interface {
	AI(ctx context.Context, prompt string, opts ...ai.Option) (*ai.Response, error)
}

AIer is the single structured call seam. The options and the response keep the SDK `ai` package's shapes, which codeaf speaks everywhere it talks to a model.

type App ¶

type App interface {
	Harnesser
	AIer
	Noter
}

App is the union the orchestrator is written against.

type HarnessOptions ¶

type HarnessOptions struct {
	Cwd   string
	Label string
}

HarnessOptions is what one agent session is told about where it works.

Cwd is the checkout under review, which the session reads; an empty Cwd is a call that needs no file, and codeaf's session still reads only the run's checkout. Label names the session on the review's page ("review dimension", "evidence"); it changes nothing about the run.

type HarnessResult ¶

type HarnessResult struct {
	Result       string
	Parsed       any
	IsError      bool
	ErrorMessage string
	NumTurns     int
	DurationMS   int64
	CostUSD      *float64
}

HarnessResult is the outcome of one agent session, carrying the fields the review reads off it.

A session that HAPPENED and failed is reported with IsError and ErrorMessage and a nil Go error; a Go error means the session could not be made at all. Parsed is the dest pointer once it holds a schema-valid object, nil when nothing validated. CostUSD is a pointer because "no cost reported" is not "free".

type Harnesser ¶

type Harnesser interface {
	Harness(ctx context.Context, prompt string, schema map[string]any, dest any, opts HarnessOptions) (*HarnessResult, error)
}

Harnesser is the agent-session seam.

type Noter ¶

type Noter interface {
	Note(ctx context.Context, message string, tags ...string)
}

Noter is a progress line for whoever is watching the review, never something the pipeline reads back.