session

Jun 13, 2026

Changes in this version

type ToolPart

+ Outcome string

Apr 29, 2026

Changes in this version

+ const BaseRetryDelay

+ const CharsPerToken

+ const CompactionPrompt

+ const CompactionTriggerPrompt

+ const DefaultCompactionSystemPrompt

+ const DoomLoopThreshold

+ const FileTokenEstimate

+ const ImageTokenEstimate

+ const MaxRetryAttempts

+ const MaxRetryDelay

+ const OutputTokenMax

+ const PruneMinimum

+ const PruneProtect

+ var ErrBusy = errors.New("session is busy")

+ func AskDoomLoopPermission(ctx context.Context, sessionID, toolName string) error

+ func DefaultPrunedMessage(info PrunedInfo) string

+ func EstimateMessagesTokens(msgs []Message) int

+ func EstimateTokens(s string) int

+ func MessageToGoAI(msg Message) []goai.Message

+ func MessagesToGoAI(msgs []Message) []goai.Message

+ func RetryDelay(attempt int, resp *http.Response) time.Duration

+ func RetryableError(err error) string

+ type CompactOptions struct

+ MaxOutputTokens int

+ ProviderOptions map[string]any

+ type CompactionAgent interface

+ Model func() string

+ SystemPrompt func() string

+ type CompactionConfig struct

+ Agent CompactionAgent

+ Auto bool

+ Prune bool

+ PrunedMessage func(info PrunedInfo) string

+ func DefaultCompactionConfig() CompactionConfig

+ type DoomLoopDetector struct

+ func NewDoomLoopDetector() *DoomLoopDetector

+ func (d *DoomLoopDetector) LastToolName() string

+ func (d *DoomLoopDetector) RecordCall(name string, input json.RawMessage) bool

+ func (d *DoomLoopDetector) Reset()

+ type FilePart struct

+ Data string

+ Filename string

+ MimeType string

+ Source string

+ type ImagePart struct

+ Image string

+ MimeType string

+ Source string

+ type MemoryStore struct

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

+ func (MemoryStore) Compact(context.Context, []Message, int) error

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

+ type Message struct

+ Compacted bool

+ Content string

+ ID string

+ ParentID string

+ Parts []Part

+ Role string

+ Summary bool

+ Tokens Tokens

+ func FromGoAIMessage(m goai.Message) Message

+ func FromGoAIMessages(msgs []goai.Message) []Message

+ type ModelLimits struct

+ Context int

+ Input int

+ Output int

+ type Part struct

+ Compacted bool

+ File *FilePart

+ ID string

+ Image *ImagePart

+ Text string

+ Tool *ToolPart

+ Type string

+ type PrunedInfo struct

+ Filename string

+ MimeType string

+ Source string

+ Type string

+ type RetryStatus struct

+ Attempt int

+ Message string

+ Next time.Time

+ Type string

+ func NewRetryStatus() RetryStatus

+ func (rs *RetryStatus) IsBusy() bool

+ func (rs *RetryStatus) IsRetrying() bool

+ func (rs *RetryStatus) SetBusy()

+ func (rs *RetryStatus) SetIdle()

+ func (rs *RetryStatus) SetRetrying(attempt int, message string, next time.Time)

+ type Session struct

+ AgentName string

+ CompactionConfig CompactionConfig

+ ID string

+ Messages []Message

+ ModelID string

+ ModelLimits ModelLimits

+ Tokens Tokens

+ func New(id, agentName, modelID string, limits ModelLimits) *Session

+ func NewWithOptions(opts SessionOptions) *Session

+ func (s *Session) AddMessage(msg Message)

+ func (s *Session) Cancel()

+ func (s *Session) Compact(ctx context.Context, model stream.Model, conversationMessages []goai.Message, ...) (string, error)

+ func (s *Session) CompactAndContinue(ctx context.Context, model stream.Model, conversationMessages []goai.Message, ...) error

+ func (s *Session) Context() context.Context

+ func (s *Session) FilterCompacted() []Message

+ func (s *Session) GetMessages() []Message

+ func (s *Session) IsOverflow() bool

+ func (s *Session) Prune() int

+ func (s *Session) PublishUpdate()

+ func (s *Session) ToGoAIMessages() []goai.Message

+ func (s *Session) UpdateTokens(usage stream.Usage)

+ type SessionOptions struct

+ AgentName string

+ Bus *bus.Bus

+ CompactionConfig *CompactionConfig

+ ID string

+ Limits ModelLimits

+ ModelID string

+ type SessionStore interface

+ Append func(ctx context.Context, msgs []Message) error

+ Compact func(ctx context.Context, summary []Message, tokensFreed int) error

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

+ type SimpleCompactionAgent struct

+ func NewCompactionAgent(systemPrompt, model string) *SimpleCompactionAgent

+ func (a *SimpleCompactionAgent) Model() string

+ func (a *SimpleCompactionAgent) SystemPrompt() string

+ type Tokens struct

+ Cache struct{ ... }

+ Input int

+ Output int

+ Reasoning int

+ type ToolCallRecord struct

+ Input string

+ Name string

+ type ToolPart struct

+ CallID string

+ Compacted bool

+ Input string

+ Name string

+ Output string

+ Status string