agent

Aug 21, 2026

Changes in this version

type AgentEventType

+ const StepEnd

+ const StepStart

type LoopConfig

+ PrepareNextStep func(StepCtx) *StepUpdate

+ ShouldStopAfterStep func(StepCtx) bool

type Options

+ PrepareNextStep func(StepCtx) *StepUpdate

+ ShouldStopAfterStep func(StepCtx) bool

+ type StepCtx struct

+ Context Context

+ Message llm.AssistantMessage

+ NewMessages []AgentMessage

+ ToolResults []llm.ToolResultMessage

+ type StepUpdate struct

+ Context *Context

+ Model *llm.Model

+ ThinkingLevel *llm.ModelThinkingLevel

Aug 16, 2026

Changes in this version

type AgentEventType

+ const FollowUpStart

Jul 30, 2026

Changes in this version

type AfterToolCallResult

+ Outcome *ToolOutcome

type Agent

+ func (a *Agent) CancelQueued(handle QueueHandle) bool

type AgentEvent

+ Progress ToolProgress

type BeforeToolCallCtx

+ RunContext context.Context

+ type QueueHandle struct

+ func QueueHandleOf(message AgentMessage) (QueueHandle, bool)

+ type ToolOutcome struct

+ Data any

+ ErrorCode string

+ ExitCode *int

+ Status ToolOutcomeStatus

+ func (o ToolOutcome) Failed() bool

+ type ToolOutcomeStatus string

+ const ToolOutcomeCancelled

+ const ToolOutcomeFailed

+ const ToolOutcomeSuccess

+ const ToolOutcomeTimeout

+ type ToolProgress struct

+ Content []llm.ToolResultContent

+ Data any

type ToolResult

+ Outcome ToolOutcome

Jul 3, 2026

Changes in this version

type Agent

+ func (a *Agent) SetMessages(messages []AgentMessage)

Jun 28, 2026

Changes in this version

+ func ToLLM(m AgentMessage) (llm.Message, bool)

Jun 23, 2026

Changes in this version

type Agent

+ func (a *Agent) SetModel(model llm.Model)

+ func (a *Agent) SetSystemPrompt(prompt string)

+ func (a *Agent) SetThinkingLevel(level llm.ModelThinkingLevel)

+ func (a *Agent) SetToolExecution(mode ExecutionMode)

+ func (a *Agent) SetTools(tools []AgentTool)

Jun 23, 2026

Changes in this version

type AgentMessage

+ func UserMessage(text string, images ...llm.ImageContent) AgentMessage

type Options

+ StreamOptions llm.StreamOptions

type State

+ PendingToolCalls []string

+ StreamingMessage AgentMessage

Jun 22, 2026

Changes in this version

+ func RunLoop(ctx context.Context, prompts []AgentMessage, base Context, cfg LoopConfig) <-chan AgentEvent

+ type AfterToolCallCtx struct

+ Args any

+ AssistantMessage llm.AssistantMessage

+ Context Context

+ IsError bool

+ Result ToolResult

+ ToolCall llm.ToolCall

+ type AfterToolCallResult struct

+ Content []llm.ToolResultContent

+ Details any

+ IsError *bool

+ Terminate *bool

+ type Agent struct

+ func New(opts Options) *Agent

+ func (a *Agent) Abort()

+ func (a *Agent) ClearFollowUpQueue()

+ func (a *Agent) ClearQueues()

+ func (a *Agent) ClearSteeringQueue()

+ func (a *Agent) Continue(ctx context.Context) error

+ func (a *Agent) FollowUp(message AgentMessage)

+ func (a *Agent) HasQueuedMessages() bool

+ func (a *Agent) Prompt(ctx context.Context, input any) error

+ func (a *Agent) Reset()

+ func (a *Agent) Snapshot() State

+ func (a *Agent) Steer(message AgentMessage)

+ func (a *Agent) Subscribe(listener func(AgentEvent)) (unsubscribe func())

+ type AgentEvent struct

+ Args any

+ IsError bool

+ LLMEvent *llm.Event

+ Message AgentMessage

+ Messages []AgentMessage

+ Result any

+ ToolCallID string

+ ToolName string

+ ToolResults []llm.ToolResultMessage

+ Type AgentEventType

+ type AgentEventType string

+ const AgentEnd

+ const AgentStart

+ const MessageEnd

+ const MessageStart

+ const MessageUpdate

+ const ToolEnd

+ const ToolStart

+ const ToolUpdate

+ const TurnEnd

+ const TurnStart

+ type AgentMessage interface

+ func FromLLM(m llm.Message) AgentMessage

+ type AgentTool struct

+ Definition llm.ToolDefinition

+ Execute func(ctx context.Context, callID string, args json.RawMessage, ...) (ToolResult, error)

+ ExecutionMode ExecutionMode

+ Label string

+ PrepareArguments func(arguments map[string]any) map[string]any

+ type BeforeToolCallCtx struct

+ Args any

+ AssistantMessage llm.AssistantMessage

+ Context Context

+ ToolCall llm.ToolCall

+ type Context struct

+ Messages []AgentMessage

+ SystemPrompt string

+ Tools []AgentTool

+ type Custom struct

+ type ExecutionMode string

+ const ExecutionParallel

+ const ExecutionSequential

+ type LoopConfig struct

+ AfterToolCall func(AfterToolCallCtx) *AfterToolCallResult

+ BeforeToolCall func(BeforeToolCallCtx) (block bool, reason string)

+ ConvertToLLM func([]AgentMessage) []llm.Message

+ GetAPIKey func(provider string) string

+ GetFollowUpMessages func() []AgentMessage

+ GetSteeringMessages func() []AgentMessage

+ Model llm.Model

+ PrepareNextTurn func(TurnCtx) *TurnUpdate

+ ShouldStopAfterTurn func(TurnCtx) bool

+ StreamFn StreamFn

+ StreamOptions llm.StreamOptions

+ ToolExecution ExecutionMode

+ TransformContext func([]AgentMessage) []AgentMessage

+ type Options struct

+ AfterToolCall func(AfterToolCallCtx) *AfterToolCallResult

+ BeforeToolCall func(BeforeToolCallCtx) (block bool, reason string)

+ ConvertToLLM func([]AgentMessage) []llm.Message

+ FollowUpMode QueueMode

+ GetAPIKey func(provider string) string

+ Messages []AgentMessage

+ Model llm.Model

+ PrepareNextTurn func(TurnCtx) *TurnUpdate

+ ShouldStopAfterTurn func(TurnCtx) bool

+ SteeringMode QueueMode

+ StreamFn StreamFn

+ SystemPrompt string

+ ThinkingLevel llm.ModelThinkingLevel

+ ToolExecution ExecutionMode

+ Tools []AgentTool

+ TransformContext func([]AgentMessage) []AgentMessage

+ type QueueMode string

+ const QueueAll

+ const QueueOneAtATime

+ type State struct

+ ErrorMessage string

+ IsStreaming bool

+ Messages []AgentMessage

+ Model llm.Model

+ SystemPrompt string

+ ThinkingLevel llm.ModelThinkingLevel

+ Tools []AgentTool

+ type StreamFn func(ctx context.Context, model llm.Model, input llm.Context, ...) (<-chan llm.Event, error)

+ type ToolResult struct

+ Content []llm.ToolResultContent

+ Details any

+ Terminate bool

+ type TurnCtx struct

+ Context Context

+ Message llm.AssistantMessage

+ NewMessages []AgentMessage

+ ToolResults []llm.ToolResultMessage

+ type TurnUpdate struct

+ Context *Context

+ Model *llm.Model

+ ThinkingLevel *llm.ModelThinkingLevel