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

gotato

package module

Go to main page

Versions in this module

v0

v0.2.0

Oct 29, 2026

v0.1.1

Oct 15, 2026

retracted

v0.1.0

Oct 10, 2026

retracted

Changes in this version

+ const ActivationToolName

+ const PanelTag

+ func IsCode(err error, code ErrorCode) bool

+ func RenderBlocks(blocks []Block) string

+ func TextOf(m Message) string

+ type AdvisoryExtension interface

+ Advisory func() bool

+ type Agent interface

+ Close func(context.Context) error

+ Prompt func(context.Context, Message) (RunResult, error)

+ type AgentID string

+ type AgentLifecycle interface

+ Done func() <-chan struct{}

+ Status func() AgentStatus

+ type AgentStatus string

+ const AgentBusy

+ const AgentClosed

+ const AgentClosing

+ const AgentCreated

+ const AgentIdle

+ type Block struct

+ Attrs map[string]string

+ Tag string

+ Text string

+ type CacheAnchor string

+ const CacheAfterMessage

+ const CacheAfterSystem

+ const CacheAfterTools

+ type CacheBreakpoint struct

+ After CacheAnchor

+ Index int

+ type ContentKind string

+ const ContentImage

+ const ContentJSON

+ const ContentReasoning

+ const ContentText

+ type ContentPart struct

+ Data []byte

+ Kind ContentKind

+ MIMEType string

+ Metadata map[string]string

+ Signature []byte

+ Text string

+ type ContextBuilder interface

+ Build func(context.Context, ContextSnapshot) (ModelContext, error)

+ func FullHistoryContext() ContextBuilder

+ type ContextBuilderFunc func(context.Context, ContextSnapshot) (ModelContext, error)

+ func (f ContextBuilderFunc) Build(ctx context.Context, snapshot ContextSnapshot) (ModelContext, error)

+ type ContextSnapshot struct

+ AgentID AgentID

+ Messages []Message

+ RunID RunID

+ SystemInstructions string

+ Turn TurnNumber

+ type ContextTransformer interface

+ Transform func(context.Context, ContextSnapshot) ([]Message, error)

+ type ControllableAgent interface

+ Abort func()

+ Continue func(context.Context) (RunResult, error)

+ FollowUp func(Message) error

+ Steer func(Message) error

+ type CoreLimits struct

+ MaxActiveToolSets uint32

+ MaxFollowUpMessages uint32

+ MaxMessageBytes uint64

+ MaxMessages uint32

+ MaxParallelTools uint32

+ MaxSteerMessages uint32

+ MaxToolCalls uint32

+ MaxToolProgressBytes uint64

+ MaxToolProgressUpdates uint32

+ MaxToolResultBytes uint64

+ MaxTranscriptBytes uint64

+ MaxTurns uint32

+ ModelCallDeadline time.Duration

+ RunDeadline time.Duration

+ ToolCallDeadline time.Duration

+ func DefaultLimits() CoreLimits

+ type ErrorCode string

+ const ErrAgentClosed

+ const ErrAgentClosing

+ const ErrBusy

+ const ErrCancelled

+ const ErrDeadlineExceeded

+ const ErrExtensionFailure

+ const ErrInternalInvariant

+ const ErrInvalidArgument

+ const ErrInvalidState

+ const ErrLimitExceeded

+ const ErrModelFailure

+ const ErrModelProtocolFailure

+ const ErrNotSupported

+ const ErrToolArgumentFailure

+ const ErrToolExecutionFailure

+ const ErrToolResolutionFailure

+ type Event struct

+ AgentID AgentID

+ Class EventClass

+ Kind EventKind

+ MessageID MessageID

+ Payload map[string]any

+ RunID RunID

+ Sequence uint64

+ Timestamp time.Time

+ ToolCallID ToolCallID

+ Turn TurnNumber

+ type EventAgent interface

+ Subscribe func(context.Context) (EventStream, error)

+ type EventClass string

+ const EventCoalescable

+ const EventProtected

+ type EventKind string

+ const EventAgentEnd

+ const EventAgentStart

+ const EventContextBuilt

+ const EventMessageEnd

+ const EventMessageStart

+ const EventMessageUpdate

+ const EventSessionCompacted

+ const EventToolExecutionEnd

+ const EventToolExecutionStart

+ const EventToolExecutionUpdate

+ const EventToolResultCommitted

+ const EventToolSetActivated

+ const EventTurnEnd

+ const EventTurnStart

+ type EventObserver interface

+ Observe func(context.Context, Event) error

+ type EventSource interface

+ Subscribe func(context.Context) (EventStream, error)

+ type EventStream interface

+ Close func() error

+ Next func(context.Context) (Event, error)

+ type IdleWaiter interface

+ WaitForIdle func(context.Context) error

+ type LifecycleAgent interface

+ SubscribeLifecycle func(context.Context) (LifecycleStream, error)

+ type LifecycleEvent struct

+ AgentID AgentID

+ Kind LifecycleKind

+ Reason string

+ Timestamp time.Time

+ type LifecycleKind string

+ const LifecycleAgentClosed

+ const LifecycleAgentClosing

+ const LifecycleAgentCreated

+ type LifecycleSource interface

+ SubscribeLifecycle func(context.Context) (LifecycleStream, error)

+ type LifecycleStream interface

+ Close func() error

+ Next func(context.Context) (LifecycleEvent, error)

+ type Message struct

+ ID MessageID

+ Parts []ContentPart

+ Role Role

+ StopReason StopReason

+ ToolCalls []ToolCall

+ ToolResult *ToolResult

+ Usage Usage

+ func AssistantMessage(text string) Message

+ func ForModel(messages []Message) []Message

+ func UserMessage(text string) Message

+ func (m Message) Clone() Message

+ type MessageConverter interface

+ Convert func(context.Context, []Message) ([]Message, error)

+ type MessageID string

+ type Model interface

+ Stream func(context.Context, ModelRequest) (ModelStream, error)

+ type ModelContext struct

+ Messages []Message

+ Metadata map[string]string

+ Panel []Block

+ System []Block

+ SystemInstructions string

+ func (c ModelContext) Clone() ModelContext

+ func (c ModelContext) RenderPanel() string

+ func (c ModelContext) RenderSystem() string

+ type ModelEvent struct

+ Kind ModelEventKind

+ ReasoningArtifact []byte

+ StopReason StopReason

+ Text string

+ ToolCall *ToolCall

+ Usage Usage

+ type ModelEventKind string

+ const ModelDone

+ const ModelReasoningDelta

+ const ModelReasoningDone

+ const ModelTextDelta

+ const ModelToolCall

+ const ModelUsage

+ type ModelOptions struct

+ MaxTokens uint32

+ ReasoningEffort string

+ ReasoningSummary string

+ Temperature *float64

+ type ModelRequest struct

+ CacheBreakpoints []CacheBreakpoint

+ Messages []Message

+ Options ModelOptions

+ SystemInstructions string

+ Tools []ToolSpec

+ func AssembleRequest(built ModelContext, tools []ToolSpec) (ModelRequest, string)

+ type ModelStream interface

+ Close func() error

+ Recv func(context.Context) (ModelEvent, error)

+ type Option func(*agentConfig) error

+ func WithActiveToolSet(set ToolSet) Option

+ func WithContextBuilder(builder ContextBuilder) Option

+ func WithDeadlines(run, model, tool time.Duration) Option

+ func WithExtension(extension any) Option

+ func WithExtensions(extensions ...any) Option

+ func WithFunc[In any, Out any](name, description string, fn func(context.Context, In) (Out, error)) Option

+ func WithInstruction(instruction string) Option

+ func WithLimits(limits CoreLimits) Option

+ func WithModel(model Model) Option

+ func WithModelOptions(options ModelOptions) Option

+ func WithRootNamespace(namespace string) Option

+ func WithTool(tool Tool) Option

+ func WithToolSet(set ToolSet) Option

+ func WithToolSource(source ToolSource) Option

+ func WithTools(tools ...Tool) Option

+ func WithTranscript(transcript Transcript) Option

+ type PostToolUse interface

+ After func(context.Context, ToolResult) (ToolResult, error)

+ type PreToolDecision struct

+ Block bool

+ Reason string

+ Result *ToolResult

+ type PreToolUse interface

+ Before func(context.Context, ToolUse) (PreToolDecision, error)

+ type Role string

+ const RoleAssistant

+ const RoleToolResult

+ const RoleUser

+ type RunCanceler interface

+ CancelRun func(context.Context, RunID) error

+ type RunID string

+ type RunMetrics struct

+ ElapsedMS int64

+ ReasoningBytes uint64

+ TextBytes uint64

+ ToolCalls uint32

+ Turns uint32

+ type RunPreparer interface

+ PrepareRun func(context.Context, Transcript) error

+ type RunResult struct

+ Error *RuntimeError

+ FinalMessage *Message

+ Metrics RunMetrics

+ RunID RunID

+ Status RunStatus

+ Usage Usage

+ func (r RunResult) Clone() RunResult

+ type RunStatus string

+ const RunCanceled

+ const RunCompleted

+ const RunDeadlineExceeded

+ const RunFailed

+ const RunRunning

+ type RuntimeAgent interface

+ Transcript func() Transcript

+ func NewAgent(options ...Option) (RuntimeAgent, error)

+ type RuntimeError struct

+ Cause error

+ Code ErrorCode

+ Details map[string]string

+ Message string

+ Operation string

+ Retryable bool

+ func ErrorOf(code ErrorCode, message string) *RuntimeError

+ func (e *RuntimeError) Error() string

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

+ func (e *RuntimeError) Unwrap() error

+ type StopDecision struct

+ Reason string

+ Stop bool

+ type StopReason string

+ const StopCanceled

+ const StopEndTurn

+ const StopError

+ const StopMaxTokens

+ const StopNone

+ const StopToolCalls

+ type Tool interface

+ Execute func(context.Context, ToolUse, ToolProgress) (ToolResult, error)

+ Spec func() ToolSpec

+ func NewFuncToolWithProgress[In any, Out any](name, description string, ...) (Tool, error)

+ func NewFuncTool[In any, Out any](name, description string, fn func(context.Context, In) (Out, error)) (Tool, error)

+ func ToolWithEffect(tool Tool, effect ToolEffect) Tool

+ type ToolCall struct

+ Arguments []byte

+ ID ToolCallID

+ ToolID string

+ type ToolCallID string

+ type ToolEffect string

+ const EffectDestructive

+ const EffectRead

+ const EffectUnspecified

+ const EffectWriteExternal

+ const EffectWriteLocal

+ func (e ToolEffect) Rank() int

+ func (e ToolEffect) Valid() bool

+ func (e ToolEffect) Within(ceiling ToolEffect) bool

+ type ToolInspector interface

+ Tools func() []ToolSpec

+ type ToolProgress func(string)

+ type ToolResult struct

+ CallID ToolCallID

+ Content []ContentPart

+ Executed bool

+ Metadata map[string]string

+ SafeError string

+ Status ToolResultStatus

+ func (r ToolResult) Clone() ToolResult

+ type ToolResultStatus string

+ const ToolResultBlocked

+ const ToolResultCanceled

+ const ToolResultFailed

+ const ToolResultOK

+ type ToolSet interface

+ Spec func() ToolSetSpec

+ Tools func(context.Context) ([]Tool, error)

+ type ToolSetSpec struct

+ Description string

+ Metadata map[string]string

+ Name string

+ type ToolSource interface

+ Tools func() []Tool

+ type ToolSpec struct

+ Description string

+ Effect ToolEffect

+ ID string

+ InputSchema []byte

+ Metadata map[string]string

+ Name string

+ OutputSchema []byte

+ Sequential bool

+ type ToolUse struct

+ ArgumentsJSON []byte

+ CallID ToolCallID

+ Effect ToolEffect

+ Executed bool

+ QualifiedID string

+ Result *ToolResult

+ RunID RunID

+ SourceIndex uint32

+ Turn TurnNumber

+ type Transcript interface

+ Append func(Message) error

+ Len func() int

+ Messages func() []Message

+ type TurnNumber uint32

+ type TurnSnapshot struct

+ AgentID AgentID

+ Assistant Message

+ RunID RunID

+ StopReason StopReason

+ ToolResults []ToolResult

+ Turn TurnNumber

+ type TurnStopper interface

+ Stop func(context.Context, TurnSnapshot) (StopDecision, error)

+ type Usage struct

+ CacheReadTokens uint64

+ CacheWriteTokens uint64

+ InputTokens uint64

+ OutputTokens uint64

+ TotalTokens uint64