Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security
  
  How Go can help keep you secure by default
Learn
Docs
- Effective Go
  
  Tips for writing clear, performant, and idiomatic Go code
- Go User Manual
  
  A complete introduction to building software with Go
- Standard library
  
  Reference documentation for Go's standard library
- Release Notes
  
  Learn what's new in each Go release
- API
  
  Reference documentation for the pkg.go.dev API
Packages
Community
- Recorded Talks
  
  Videos from prior events
- Meetups
  
  Meet other local Go developers
- Conferences
  
  Learn and network with Go developers from around the world
- Go blog
  
  The Go project's official blog.
- Go project
  
  Get help and stay informed from Go
- Get connected

eval

package module

Go to main page

Versions in this module

v0

v0.2.1

Aug 25, 2026

v0.2.0

Aug 14, 2026

Changes in this version

+ const MaxActionNameBytes

+ const MaxAssessmentEvidence

+ const MaxAssessmentFindings

+ const MaxAssessmentMeasurements

+ const MaxAttributeValueBytes

+ const MaxDescriptionBytes

+ const MaxDescriptorRequires

+ const MaxExcerptBytes

+ const MaxExpectedToolCalls

+ const MaxFactBytes

+ const MaxFindingMessageBytes

+ const MaxForbiddenActions

+ const MaxHashBytes

+ const MaxIDBytes

+ const MaxLabelValueBytes

+ const MaxNameBytes

+ const MaxOperationAttributes

+ const MaxReferenceAnswerBytes

+ const MaxReferenceAnswers

+ const MaxReportIDBytes

+ const MaxRequiredFacts

+ const MaxRevisionBytes

+ const MaxScenarioInputMessages

+ const MaxScenarioLabels

+ const MaxTrials

+ type ActionName string

+ func (a ActionName) Validate() error

+ type Assessment struct

+ Duration time.Duration

+ Evaluator Name

+ Evidence []Evidence

+ Findings []Finding

+ Measurements []Measurement

+ Revision Revision

+ Status AssessmentStatus

+ func Errored(desc Descriptor, findings ...Finding) Assessment

+ func Fail(desc Descriptor, findings ...Finding) Assessment

+ func Pass(desc Descriptor, measurements ...Measurement) Assessment

+ func Skipped(desc Descriptor) Assessment

+ func Unverified(desc Descriptor, findings ...Finding) Assessment

+ func (a Assessment) Validate() error

+ type AssessmentStatus string

+ const StatusError

+ const StatusFail

+ const StatusPass

+ const StatusSkipped

+ const StatusUnverified

+ func (s AssessmentStatus) Validate() error

+ type Attribute struct

+ Key Name

+ Value string

+ func (a Attribute) Validate() error

+ type ContentHash string

+ func (h ContentHash) Validate() error

+ type ConversationExcerpt struct

+ Hash ContentHash

+ MessageIndex int

+ Redacted RedactedExcerpt

+ Role content.Role

+ type Descriptor struct

+ Description string

+ Method Method

+ Name Name

+ Requires []EvidenceKind

+ Revision Revision

+ func (d Descriptor) CheckRequires(s Sample) (Assessment, bool)

+ func (d Descriptor) Validate() error

+ type DiagnosticEvidence struct

+ Code Name

+ Message RedactedExcerpt

+ Severity Severity

+ type DuplicateEvaluatorNameError struct

+ func (e *DuplicateEvaluatorNameError) Error() string

+ type DuplicateEvidenceError struct

+ func (e *DuplicateEvidenceError) Error() string

+ type DuplicateEvidenceKindError struct

+ func (e *DuplicateEvidenceKindError) Error() string

+ type DuplicateFindingError struct

+ func (e *DuplicateFindingError) Error() string

+ type DuplicateLabelError struct

+ func (e *DuplicateLabelError) Error() string

+ type DuplicateMeasurementError struct

+ func (e *DuplicateMeasurementError) Error() string

+ type DuplicateScenarioError struct

+ func (e *DuplicateScenarioError) Error() string

+ type ErrorClass string

+ const ErrorCancelled

+ const ErrorInternal

+ const ErrorInvalidInput

+ const ErrorRateLimited

+ const ErrorTimeout

+ const ErrorUnavailable

+ func (c ErrorClass) Validate() error

+ type Evaluator interface

+ Descriptor func() Descriptor

+ Evaluate func(context.Context, Sample) (Assessment, error)

+ type EvaluatorRevision struct

+ Name Name

+ Revision Revision

+ type Evidence struct

+ ConversationExcerpt *ConversationExcerpt

+ Diagnostic *DiagnosticEvidence

+ ID EvidenceID

+ Kind EvidenceKind

+ MessageIndex *MessageIndexRef

+ StructuredError *StructuredOutputError

+ StructuredOutput *StructuredOutput

+ Timing *TimingEvidence

+ ToolOperation *ToolOperationEvidence

+ Usage *UsageEvidence

+ func (e Evidence) Validate() error

+ type EvidenceID string

+ func (id EvidenceID) Validate() error

+ type EvidenceKind string

+ const EvidenceConversationExcerpt

+ const EvidenceDiagnostic

+ const EvidenceMessageIndex

+ const EvidenceStructuredError

+ const EvidenceStructuredOutput

+ const EvidenceTiming

+ const EvidenceToolOperation

+ const EvidenceUsage

+ func (k EvidenceKind) Validate() error

+ type EvidencePayloadError struct

+ Reason string

+ func (e *EvidencePayloadError) Error() string

+ type EvidenceRef struct

+ Evidence EvidenceID

+ MessageIndex *int

+ type Expectation struct

+ ExpectedToolCalls []ToolCallExpectation

+ ForbiddenActions []ActionName

+ PolicyRef Revision

+ ReferenceAnswers []ReferenceAnswer

+ RequiredFacts []Fact

+ StructuredOutput *StructuredOutputExpectation

+ func (e *Expectation) Validate() error

+ type Fact string

+ func (f Fact) Validate() error

+ type Finding struct

+ Code FindingCode

+ Evidence []EvidenceRef

+ Message string

+ Severity Severity

+ type FindingCode string

+ const FindingEvaluatorError

+ const FindingEvaluatorIdentityMismatch

+ const FindingEvaluatorInvalidAssessment

+ const FindingMissingRequiredEvidence

+ func (c FindingCode) Validate() error

+ type IndexRangeError struct

+ Field string

+ Index int

+ Len int

+ func (e *IndexRangeError) Error() string

+ type InvalidEnumError struct

+ Enum string

+ Value string

+ func (e *InvalidEnumError) Error() string

+ type Label struct

+ Key Name

+ Value string

+ func (l Label) Validate() error

+ type Measurement struct

+ Name Name

+ Unit Unit

+ Value float64

+ func (m Measurement) Validate() error

+ type MessageIndexRef struct

+ Index int

+ type MessageRange struct

+ Len int

+ Start int

+ type Method uint8

+ const MethodComposite

+ const MethodModel

+ const MethodProgrammatic

+ func (m Method) Validate() error

+ type Name string

+ func (n Name) Validate() error

+ type NilEvaluatorError struct

+ func (e *NilEvaluatorError) Error() string

+ type NilTargetError struct

+ func (e *NilTargetError) Error() string

+ type Observation struct

+ Conversation content.AgenticMessages

+ Expectation *Expectation

+ Scope Scope

+ Subject Subject

+ Trace Trace

+ func (o Observation) Validate() error

+ type Operation struct

+ Attributes []Attribute

+ EndedAt time.Time

+ ErrorClass ErrorClass

+ Evidence []EvidenceRef

+ ID string

+ Kind OperationKind

+ ParentID string

+ StartedAt time.Time

+ Status OperationStatus

+ func (o Operation) Validate() error

+ type OperationKind string

+ const OperationInference

+ const OperationNetwork

+ const OperationProcess

+ const OperationSandbox

+ const OperationStep

+ const OperationTool

+ func (k OperationKind) Validate() error

+ type OperationStatus string

+ const OperationCancelled

+ const OperationFailed

+ const OperationOK

+ const OperationTimedOut

+ func (s OperationStatus) Validate() error

+ type Provenance struct

+ Evaluators []EvaluatorRevision

+ Suite Revision

+ Target Revision

+ type RedactedExcerpt string

+ func (x RedactedExcerpt) Validate() error

+ type ReferenceAnswer string

+ func (r ReferenceAnswer) Validate() error

+ type Report struct

+ EndedAt time.Time

+ ID string

+ Provenance Provenance

+ Samples []SampleReport

+ StartedAt time.Time

+ Suite Revision

+ Summary Summary

+ Target Revision

+ func Run(ctx context.Context, cfg RunConfig, suite Suite, target Target, ...) (Report, error)

+ func (r Report) Validate() error

+ type ReportValidationError struct

+ Reason string

+ func (e *ReportValidationError) Error() string

+ type Revision string

+ func (r Revision) Validate() error

+ type RunConfig struct

+ Concurrency int

+ EvaluatorTimeout time.Duration

+ TargetTimeout time.Duration

+ Trials int

+ func (c RunConfig) Validate() error

+ type Sample struct

+ Observation Observation

+ Scenario *Scenario

+ func (s Sample) Validate() error

+ type SampleReport struct

+ Assessments []Assessment

+ Observation Observation

+ ScenarioID string

+ TargetErr *TargetError

+ TrialIndex int

+ type SampleSubjectMismatchError struct

+ func (e *SampleSubjectMismatchError) Error() string

+ type Scenario struct

+ Expectation *Expectation

+ ID string

+ Input content.AgenticMessages

+ Labels []Label

+ Name Name

+ Revision Revision

+ func (s Scenario) Validate() error

+ type Scope uint8

+ const ScopeCase

+ const ScopeRun

+ const ScopeSession

+ const ScopeTurn

+ func (s Scope) Validate() error

+ type Severity string

+ const SeverityCritical

+ const SeverityHigh

+ const SeverityInfo

+ const SeverityLow

+ const SeverityMedium

+ func (s Severity) Validate() error

+ type Sink interface

+ WriteReport func(context.Context, Report) error

+ type StatusConsistencyError struct

+ Reason string

+ Status AssessmentStatus

+ func (e *StatusConsistencyError) Error() string

+ type StructuredErrorReason string

+ const StructuredErrorEmptyOutput

+ const StructuredErrorInvalidJSON

+ const StructuredErrorMissingField

+ const StructuredErrorOutOfRange

+ const StructuredErrorSchemaMismatch

+ func (r StructuredErrorReason) Validate() error

+ type StructuredOutput struct

+ SchemaName Name

+ SchemaRevision Revision

+ type StructuredOutputError struct

+ DetailHash ContentHash

+ Reason StructuredErrorReason

+ Schema Revision

+ type StructuredOutputExpectation struct

+ Schema Revision

+ Strict bool

+ func (s StructuredOutputExpectation) Validate() error

+ type Subject struct

+ ID string

+ Kind SubjectKind

+ Name Name

+ Revision Revision

+ func (s Subject) Validate() error

+ type SubjectKind string

+ const SubjectAgent

+ const SubjectHTTPEndpoint

+ const SubjectModel

+ const SubjectProcess

+ const SubjectPrompt

+ func (k SubjectKind) Validate() error

+ type Suite struct

+ Name Name

+ Revision Revision

+ Scenarios []Scenario

+ func (s Suite) Validate() error

+ type Summary struct

+ Assessments map[AssessmentStatus]int

+ Samples int

+ TargetErrors int

+ type Target interface

+ Name func() string

+ Observe func(context.Context, Scenario) (Observation, error)

+ type TargetError struct

+ Cause error

+ func (e *TargetError) Error() string

+ func (e *TargetError) Unwrap() error

+ type TimingEvidence struct

+ Duration time.Duration

+ Label Name

+ type ToolCallExpectation struct

+ MaxCount *int

+ MinCount int

+ Tool Name

+ func (t ToolCallExpectation) Validate() error

+ type ToolOperationEvidence struct

+ ArgsBytes int

+ ArgsHash ContentHash

+ IsError bool

+ ResultBytes int

+ ToolName Name

+ ToolUseID string

+ type Trace struct

+ EndedAt time.Time

+ Evidence []Evidence

+ MessageRanges []MessageRange

+ Model Revision

+ Operations []Operation

+ Prompt Revision

+ SessionID string

+ StartedAt time.Time

+ TraceID string

+ TurnID string

+ type Unit string

+ const UnitByte

+ const UnitCount

+ const UnitRatio

+ const UnitSecond

+ const UnitToken

+ func (u Unit) Validate() error

+ type UnknownEvidenceError struct

+ func (e *UnknownEvidenceError) Error() string

+ type UsageEvidence struct

+ Model Revision

+ Usage content.Usage

+ type ValidationError struct

+ Field string

+ Reason string

+ func (e *ValidationError) Error() string

v0.1.3

Aug 12, 2026

v0.1.2

Aug 11, 2026

v0.1.1

Aug 11, 2026

v0.1.0

Jul 23, 2026