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
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

core

package

Go to main page

Versions in this module

v0

v0.11.0

May 9, 2026

v0.10.16

May 8, 2026

v0.10.15

May 8, 2026

v0.10.14

May 7, 2026

v0.10.13

May 7, 2026

v0.10.12

May 7, 2026

v0.10.11

May 6, 2026

v0.10.10

May 6, 2026

v0.10.9

May 6, 2026

v0.10.8

May 5, 2026

v0.10.7

May 5, 2026

v0.10.6

May 5, 2026

v0.10.5

May 4, 2026

v0.10.4

May 3, 2026

Changes in this version

type EventType

+ const EventPlanningTurn

type Request

+ PlanningMode bool

v0.10.3

May 2, 2026

v0.10.2

May 2, 2026

v0.10.1

May 2, 2026

v0.10.0

May 2, 2026

v0.9.29

May 2, 2026

v0.9.28

May 1, 2026

v0.9.27

May 1, 2026

v0.9.26

May 1, 2026

Changes in this version

+ const DefaultReasoningByteLimit

+ const DefaultReasoningStallTimeout

+ const DefaultReasoningTailBytes

+ const ProviderCapabilityMissingErrorCode

+ const ReasoningAuto

+ const ReasoningHigh

+ const ReasoningLow

+ const ReasoningMax

+ const ReasoningMedium

+ const ReasoningMinimal

+ const ReasoningOff

+ const ReasoningStallCode

+ const ReasoningXHigh

+ var DefaultPricing = PricingTable

+ var ErrCompactionNoFit = errors.New("agent: compaction could not fit within the effective context window")

+ var ErrCompactionStuck = errors.New(...)

+ var ErrProviderCapabilityMissing = errors.New("agent: provider capability missing")

+ var ErrReasoningOverflow = errors.New(...)

+ var ErrReasoningStall = errors.New(...)

+ var ErrToolCallLoop = errors.New("agent: identical tool calls repeated, aborting loop")

+ func IsContextOverflowError(err error) bool

+ func IsTransientError(err error) bool

+ type AttemptMetadata struct

+ AttemptIndex int

+ Cost *CostAttribution

+ ProviderName string

+ ProviderSystem string

+ RequestedModel string

+ ResolvedModel string

+ ResponseModel string

+ Route string

+ ServerAddress string

+ ServerPort int

+ Timing *TimingBreakdown

+ type CompactionResult struct

+ FileOps map[string]any

+ Summary string

+ TokensAfter int

+ TokensBefore int

+ Warning string

+ type Compactor func(ctx context.Context, messages []Message, provider Provider, ...) ([]Message, *CompactionResult, error)

+ type CostAttribution struct

+ Amount *float64

+ CacheReadAmount *float64

+ CacheWriteAmount *float64

+ Currency string

+ InputAmount *float64

+ OutputAmount *float64

+ PricingRef string

+ Raw json.RawMessage

+ ReasoningAmount *float64

+ Source CostSource

+ type CostSource string

+ const CostSourceConfigured

+ const CostSourceGatewayReported

+ const CostSourceProviderReported

+ const CostSourceUnknown

+ type Event struct

+ Data json.RawMessage

+ Seq int

+ SessionID string

+ Timestamp time.Time

+ Type EventType

+ type EventCallback func(Event)

+ type EventType string

+ const EventCompactionEnd

+ const EventCompactionStart

+ const EventLLMDelta

+ const EventLLMRequest

+ const EventLLMResponse

+ const EventOverride

+ const EventReasoningStall

+ const EventRejectedOverride

+ const EventSessionEnd

+ const EventSessionStart

+ const EventToolCall

+ type Message struct

+ Content string

+ Role Role

+ ToolCallID string

+ ToolCalls []ToolCall

+ type ModelPricing struct

+ CacheReadPerM float64

+ CacheWritePerM float64

+ InputPerMTok float64

+ OutputPerMTok float64

+ type Options struct

+ CachePolicy string

+ MaxTokens int

+ MinP *float64

+ Model string

+ Reasoning Reasoning

+ RepetitionPenalty *float64

+ SamplingSource string

+ Seed int64

+ Stop []string

+ Temperature *float64

+ TopK *int

+ TopP *float64

+ type PricingTable map[string]ModelPricing

+ func LoadCatalogPricing(cat *modelcatalog.Catalog) PricingTable

+ func (pt PricingTable) EstimateCost(model string, inputTokens, outputTokens int) float64

+ type Provider interface

+ Chat func(ctx context.Context, messages []Message, tools []ToolDef, opts Options) (Response, error)

+ type ProviderCapabilityMissingError struct

+ Capability string

+ Cause error

+ Code string

+ ServerMessage string

+ func (e *ProviderCapabilityMissingError) Error() string

+ func (e *ProviderCapabilityMissingError) Is(target error) bool

+ func (e *ProviderCapabilityMissingError) Unwrap() error

+ func (e *ProviderCapabilityMissingError) UnwrapCause() error

+ type Reasoning = reasoning.Reasoning

+ func ReasoningTokens(n int) Reasoning

+ type ReasoningStallError struct

+ Model string

+ PromptID string

+ ReasoningTail string

+ Timeout time.Duration

+ func (e *ReasoningStallError) Code() string

+ func (e *ReasoningStallError) Error() string

+ func (e *ReasoningStallError) Unwrap() error

+ type Request struct

+ CachePolicy string

+ Callback EventCallback

+ Compactor Compactor

+ History []Message

+ MaxIterations int

+ MaxTokens int

+ Metadata map[string]string

+ MinP *float64

+ NoStream bool

+ Prompt string

+ Provider Provider

+ Reasoning Reasoning

+ ReasoningByteLimit int

+ ReasoningStallTimeout time.Duration

+ RepetitionPenalty *float64

+ RequestedModel string

+ RequestedModelRef string

+ ResolvedModel string

+ ResolvedModelRef string

+ SamplingSource string

+ Seed int64

+ SelectedProvider string

+ SelectedRoute string

+ SystemPrompt string

+ Telemetry telemetry.Telemetry

+ Temperature *float64

+ Tools []Tool

+ TopK *int

+ TopP *float64

+ WorkDir string

+ type Response struct

+ Attempt *AttemptMetadata

+ Content string

+ FinishReason string

+ Model string

+ ToolCalls []ToolCall

+ Usage TokenUsage

+ type Result struct

+ AttemptedProviders []string

+ CostUSD float64

+ Duration time.Duration

+ Error error

+ FailoverCount int

+ Messages []Message

+ Model string

+ Output string

+ Reasoning Reasoning

+ RequestedModel string

+ RequestedModelRef string

+ ResolvedModel string

+ ResolvedModelRef string

+ SelectedProvider string

+ SelectedRoute string

+ SessionID string

+ Status Status

+ Tokens TokenUsage

+ ToolCalls []ToolCallLog

+ func Run(ctx context.Context, req Request) (Result, error)

+ type Role string

+ const RoleAssistant

+ const RoleSystem

+ const RoleTool

+ const RoleUser

+ type RoutingReport struct

+ AttemptedProviders []string

+ FailoverCount int

+ SelectedProvider string

+ SelectedRoute string

+ type RoutingReporter interface

+ RoutingReport func() RoutingReport

+ type SeamOptions struct

+ type Status string

+ const StatusCancelled

+ const StatusError

+ const StatusIterationLimit

+ const StatusSuccess

+ type StreamDelta struct

+ ArrivedAt time.Time

+ Attempt *AttemptMetadata

+ Content string

+ Done bool

+ Err error

+ FinishReason string

+ Model string

+ ReasoningContent string

+ ToolCallArgs string

+ ToolCallID string

+ ToolCallName string

+ Usage *TokenUsage

+ type StreamingProvider interface

+ ChatStream func(ctx context.Context, messages []Message, tools []ToolDef, opts Options) (<-chan StreamDelta, error)

+ type TimingBreakdown struct

+ CacheRead *time.Duration

+ CacheWrite *time.Duration

+ FirstToken *time.Duration

+ Generation *time.Duration

+ Prefill *time.Duration

+ Queue *time.Duration

+ type TokenUsage struct

+ CacheRead int

+ CacheWrite int

+ Input int

+ Output int

+ Total int

+ func (u *TokenUsage) Add(other TokenUsage)

+ type Tool interface

+ Description func() string

+ Execute func(ctx context.Context, params json.RawMessage) (string, error)

+ Name func() string

+ Parallel func() bool

+ Schema func() json.RawMessage

+ type ToolCall struct

+ Arguments json.RawMessage

+ ID string

+ Name string

+ type ToolCallLog struct

+ Duration time.Duration

+ Error string

+ Input json.RawMessage

+ Output string

+ Tool string

+ type ToolDef struct

+ Description string

+ Name string

+ Parameters json.RawMessage

v0.9.26-fizeau.1

May 1, 2026