jev

package

v0.4.0 Latest Latest Go to latest Published: Sep 24, 2026 License: MIT Imports: 6 Imported by: 0

Details

Package jev defines the typed decision boundary used by lintpal.

This section is empty.

View Source

var ErrInvalidRequest = errors.New("invalid Jev request")

View Source

var ErrInvalidResponse = errors.New("invalid Jev response")

func ValidateRequest(request Request) error

ValidateRequest checks the native contract without exposing state or question text in errors.

func ValidateResponse(request Request, response Response) error

ValidateResponse rejects partial or inconsistent decisions before policy uses them.

type Answer interface {
	// contains filtered or unexported methods
}

type ChoiceAnswer struct {
	Choice        string
	Probabilities map[string]float64
	Confidence    float64
}

type ChoiceQuestion struct {
	Instructions string
	Criteria     map[string]string
}

type NoulAnswer struct {
	Probability float64
}

type NoulCriteria struct {
	True  string
	False string
}

NoulCriteria optionally describes the two ends of a yes/no answer.

type NoulQuestion struct {
	Instructions string
	Criteria     *NoulCriteria
}

type Provider interface {
	Evaluate(context.Context, Request) (Response, error)
}

Provider evaluates typed questions against one state.

type Question interface {
	// contains filtered or unexported methods
}

Question is one of the supported Jev decision primitives.

type Request struct {
	Model     string
	State     any
	Questions map[string]Question
}

Request is independent of the provider's wire format.

type Response struct {
	Model   string
	Answers map[string]Answer
	Usage   Usage
}

Response carries decisions and optional usage metadata.

type ScoreAnswer struct {
	Score         float64
	Legend        map[string]string
	Probabilities map[string]float64
	Confidence    float64
}

type ScoreQuestion struct {
	Instructions string
	Criteria     []string
}

type Usage struct {
	InputTokens  int
	OutputTokens int
	CostUSD      *float64
}