bond

package module

Go to main page

Versions in this module

v0

v0.11.1

Jul 26, 2026

v0.11.0

Jul 18, 2026

Changes in this version

+ type ContextPlugin interface

+ InitContext func(ctx context.Context) context.Context

type ToolResultBlock

+ Name string

v0.10.1

Jul 17, 2026

v0.10.0

Jul 16, 2026

v0.9.0

Jul 13, 2026

Changes in this version

+ func WithHookRegistry(ctx context.Context, registry *HookRegistry) context.Context

type AfterHookEvent

+ AfterHookEvent func()

type AfterMessageAppendedHook

+ func (*AfterMessageAppendedHook) AfterHookEvent()

+ func (*AfterMessageAppendedHook) HookEvent()

type AfterModelInvokeHook

+ func (*AfterModelInvokeHook) AfterHookEvent()

+ func (*AfterModelInvokeHook) HookEvent()

type AfterStreamHook

+ func (*AfterStreamHook) AfterHookEvent()

+ func (*AfterStreamHook) HookEvent()

type AfterToolCallHook

+ func (*AfterToolCallHook) AfterHookEvent()

+ func (*AfterToolCallHook) HookEvent()

type AfterToolCycleHook

+ func (*AfterToolCycleHook) AfterHookEvent()

+ func (*AfterToolCycleHook) HookEvent()

type AgentOptions

+ RetryPolicy RetryPolicy

type BeforeHookEvent

+ BeforeHookEvent func()

type BeforeModelInvokeHook

+ Attempt int

+ func (*BeforeModelInvokeHook) BeforeHookEvent()

+ func (*BeforeModelInvokeHook) HookEvent()

type BeforeStreamEventHook

+ func (*BeforeStreamEventHook) BeforeHookEvent()

+ func (*BeforeStreamEventHook) HookEvent()

type BeforeStreamHook

+ func (*BeforeStreamHook) BeforeHookEvent()

+ func (*BeforeStreamHook) HookEvent()

type BeforeToolCallHook

+ func (*BeforeToolCallHook) BeforeHookEvent()

+ func (*BeforeToolCallHook) HookEvent()

type BeforeToolCycleHook

+ func (*BeforeToolCycleHook) BeforeHookEvent()

+ func (*BeforeToolCycleHook) HookEvent()

+ type ExponentialBackoff struct

+ BaseDelay time.Duration

+ Jitter bool

+ MaxAttempts int

+ MaxDelay time.Duration

+ ShouldRetryFunc func(err error) bool

+ func NewExponentialBackoff() *ExponentialBackoff

+ func (e *ExponentialBackoff) ShouldRetry(err error, attempt int) (time.Duration, bool)

type HookEvent

+ HookEvent func()

type HookRegistry

+ func HookRegistryFromContext(ctx context.Context) *HookRegistry

+ type RetryPolicy interface

+ ShouldRetry func(err error, attempt int) (backoff time.Duration, retry bool)

v0.8.0

Jul 13, 2026

Changes in this version

+ var ErrContextOverflow = errors.New("bond: context overflow")

v0.7.1

Jul 12, 2026

v0.7.0

Jul 12, 2026

v0.6.0

Jul 12, 2026

v0.5.0

Jul 12, 2026

v0.4.0

Jul 12, 2026

v0.3.0

Jul 12, 2026

v0.2.0

Jul 11, 2026

Changes in this version

+ func OnAfter[T AfterHookEvent](r *HookRegistry, hook AfterHookFunc[T])

+ func OnBefore[T BeforeHookEvent](r *HookRegistry, hook BeforeHookFunc[T])

+ type AfterHookEvent interface

+ type AfterHookFunc func(context.Context, T)

+ func (fn AfterHookFunc[T]) NotifyHookEvent(ctx context.Context, event HookEvent) error

+ type AfterMessageAppendedHook struct

+ Message Message

+ type BeforeHookEvent interface

+ type BeforeHookFunc func(context.Context, T) error

+ func (fn BeforeHookFunc[T]) NotifyHookEvent(ctx context.Context, event HookEvent) error

+ type BeforeStreamEventHook struct

+ Event StreamEvent

type Plugin

+ func NewToolConfirmationPlugin(provider ToolConfirmationProvider) Plugin

+ type ToolConfirmationFunc func(ctx context.Context, toolUse *ToolUseBlock) (bool, error)

+ func (f ToolConfirmationFunc) ConfirmToolUse(ctx context.Context, toolUse *ToolUseBlock) (bool, error)

+ type ToolConfirmationProvider interface

+ ConfirmToolUse func(ctx context.Context, toolUse *ToolUseBlock) (bool, error)

v0.1.0

Jul 10, 2026

v0.0.2

Jul 10, 2026

v0.0.1

Jul 10, 2026

Changes in this version

+ var ErrAbort = errors.New("bond: operation aborted by hook")

+ func On[T HookEvent](r *HookRegistry, hook HookFunc[T])

+ func Stream(ctx context.Context, agent Agent, messages []Message, opts AgentOptions) iter.Seq2[StreamEvent, error]

+ type AfterModelInvokeHook struct

+ Blocks []Block

+ StopReason StopReason

+ type AfterStreamHook struct

+ Messages []Message

+ type AfterToolCallHook struct

+ Result *ToolResultBlock

+ ToolUse *ToolUseBlock

+ type AfterToolCycleHook struct

+ Results []*ToolResultBlock

+ type Agent interface

+ Stream func(ctx context.Context, messages []Message) iter.Seq2[StreamEvent, error]

+ type AgentOptions struct

+ MaxTurns int

+ Plugins []Plugin

+ Tools []Tool

+ type BeforeModelInvokeHook struct

+ Messages []Message

+ type BeforeStreamHook struct

+ Messages []Message

+ type BeforeToolCallHook struct

+ ToolUse *ToolUseBlock

+ type BeforeToolCycleHook struct

+ ToolCalls []*ToolUseBlock

+ type Block interface

+ type BlockType string

+ const BlockTypeMedia

+ const BlockTypeText

+ const BlockTypeToolResult

+ const BlockTypeToolUse

+ type FuncTool struct

+ func (ft FuncTool) Description() string

+ func (ft FuncTool) InputSchema() json.Marshaler

+ func (ft FuncTool) Name() string

+ func (ft FuncTool) OutputSchema() json.Marshaler

+ func (ft FuncTool) Run(ctx context.Context, input json.RawMessage) ([]Block, error)

+ type FuncToolOptions struct

+ Description string

+ InputSchema json.Marshaler

+ Name string

+ OutputSchema json.Marshaler

+ type Hook interface

+ NotifyHookEvent func(ctx context.Context, event HookEvent) error

+ type HookEvent interface

+ type HookFunc func(context.Context, T) error

+ func (fn HookFunc[T]) NotifyHookEvent(ctx context.Context, event HookEvent) error

+ type HookRegistry struct

+ func (r *HookRegistry) Notify(ctx context.Context, event HookEvent) error

+ type InvokeResponse struct

+ Media []Media

+ StopReason StopReason

+ Text string

+ func Invoke(ctx context.Context, agent Agent, messages []Message, opts AgentOptions) (*InvokeResponse, error)

+ type JSONMarshaler = func(any) ([]byte, error)

+ type LoggingPlugin struct

+ Level slog.Level

+ Logger *slog.Logger

+ func (p *LoggingPlugin) Init(registry *HookRegistry)

+ func (p *LoggingPlugin) Name() string

+ func (p *LoggingPlugin) Tools() []Tool

+ type Media struct

+ Data []byte

+ MIMEType string

+ type MediaBlock struct

+ MIMEType string

+ Source io.Reader

+ SourceURI string

+ Type MediaType

+ type MediaDelta struct

+ Data []byte

+ MIMEType string

+ type MediaType string

+ const MediaTypeAudio

+ const MediaTypeDocument

+ const MediaTypeImage

+ const MediaTypeVideo

+ type Message struct

+ Content []Block

+ Metadata map[string]any

+ Role Role

+ func Conversation(turns ...string) []Message

+ func ImagePrompt(text, imageURI, mimeType string) []Message

+ func MultiBlockPrompt(blocks ...Block) []Message

+ func TextPrompt(text string) []Message

+ type OnMessageAppendedHook struct

+ Message Message

+ type OnStreamEventHook struct

+ Event StreamEvent

+ type Plugin interface

+ Init func(registry *HookRegistry)

+ Name func() string

+ Tools func() []Tool

+ func NewHooksPlugin(name string, onInit func(*HookRegistry)) Plugin

+ func NewToolsPlugin(name string, tools ...Tool) Plugin

+ type Role string

+ const RoleAssistant

+ const RoleUser

+ type StopReason string

+ const StopReasonEnd

+ const StopReasonLength

+ const StopReasonToolUse

+ type StreamEvent struct

+ MediaDelta *MediaDelta

+ Metadata map[string]any

+ StopReason StopReason

+ TextDelta string

+ ToolUse *ToolUseBlock

+ Type StreamEventType

+ type StreamEventType string

+ const StreamEventMediaDelta

+ const StreamEventStart

+ const StreamEventStop

+ const StreamEventTextDelta

+ const StreamEventToolUse

+ type TextBlock struct

+ Text string

+ type Tool interface

+ Description func() string

+ InputSchema func() json.Marshaler

+ Name func() string

+ Run func(ctx context.Context, input json.RawMessage) ([]Block, error)

+ func NewFuncTool[In, Out any](fn func(context.Context, In) (Out, error), options FuncToolOptions) (Tool, error)

+ func ToolsFromContext(ctx context.Context) []Tool

+ type ToolResultBlock struct

+ Content []Block

+ IsError bool

+ ToolUseID string

+ type ToolUseBlock struct

+ ID string

+ Input json.RawMessage

+ Name string

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL