agent

May 6, 2026

Changes in this version

type Event

+ Image *llm.ImagePart

type EventKind

+ const EventImage

Apr 29, 2026

Changes in this version

+ const EndReasonCancelled

+ const EndReasonError

+ const EndReasonMaxTurns

+ const EndReasonStop

+ const EndReasonTimeout

+ func Drain(events <-chan Event) ([]llm.Message, error)

+ func RegisterVFSTools(reg *tools.Registry, opts *VFSToolOptions) error

+ type Event struct

+ EndReason string

+ Err error

+ Kind EventKind

+ Text string

+ ToolCall *llm.ToolCall

+ ToolResult *ToolResult

+ Usage *llm.Usage

+ type EventKind string

+ const EventEnd

+ const EventError

+ const EventText

+ const EventThinking

+ const EventToolCall

+ const EventToolResult

+ const EventUsage

+ type History interface

+ Append func(ctx context.Context, sessionID string, msgs ...llm.Message) error

+ Read func(ctx context.Context, sessionID string) ([]llm.Message, error)

+ type LocalLocker struct

+ func NewLocalLocker() *LocalLocker

+ func (l *LocalLocker) Forget(id string)

+ func (l *LocalLocker) Lock(ctx context.Context, sessionID string) (func(), error)

+ type Locker interface

+ Lock func(ctx context.Context, sessionID string) (unlock func(), err error)

+ type Session struct

+ func NewLocalSession(opts *SessionOptions) (*Session, error)

+ func NewSession(opts *SessionOptions) (*Session, error)

+ func (s *Session) Run(ctx context.Context, userText string) (<-chan Event, error)

+ func (s *Session) RunWithMessages(ctx context.Context, history []llm.Message) (<-chan Event, error)

+ type SessionOptions struct

+ Client llm.Client

+ History History

+ ID string

+ LLMCallTimeout time.Duration

+ Locker Locker

+ Logger *slog.Logger

+ MaxTokens int

+ MaxTurns int

+ Model string

+ RunTimeout time.Duration

+ SystemPrompt string

+ Temperature *float32

+ Tools *tools.Registry

+ type ToolResult struct

+ CallID string

+ Content any

+ Error string

+ Name string

+ OK bool

+ type VFSToolOptions struct

+ AllowedExtensions []string

+ HideHiddenPaths bool

+ MaxFileBytes int64

+ ReadOnly bool

+ Storage vfs.Storage