tool

Mar 25, 2026

Changes in this version

+ var ErrNoHandler = fmt.Errorf("no handler for tool")

+ func SafeCall(fn func(), errPtr *error)

+ func SafeHandle(ctx context.Context, h Handler, call Call) (output any, err error)

+ type Args = map[string]any

+ type AsyncDispatcher struct

+ Handlers Handlers

+ func (d *AsyncDispatcher) Dispatch(ctx context.Context, toolCalls ...Call) ([]Result, error)

+ type BoundToolSpec struct

+ func Handle[In, Out any](spec *Spec[In], fn func(ctx context.Context, in In) (*Out, error)) *BoundToolSpec[In, Out]

+ func (b *BoundToolSpec[In, Out]) Definition() Definition

+ func (b *BoundToolSpec[In, Out]) Handle(ctx context.Context, call Call) (any, error)

+ func (b *BoundToolSpec[In, Out]) ToolName() string

+ type Call interface

+ MarshalJSON func() ([]byte, error)

+ ToolArgs func() Args

+ ToolCallID func() string

+ ToolName func() string

+ UnmarshalJSON func([]byte) error

+ Validate func() error

+ func NewToolCall(id, name string, args Args) Call

+ type Definition struct

+ Description string

+ Name string

+ Parameters map[string]any

+ func DefinitionFor[T any](name, description string) Definition

+ func (t Definition) Validate() error

+ type DefinitionProvider interface

+ ToolDefinitions func() []Definition

+ type Dispatcher interface

+ Dispatch func(ctx context.Context, toolCalls ...Call) (results []Result, err error)

+ func NewSyncDispatcher(h Handler) Dispatcher

+ type DispatcherType int

+ const DispatchTypeAsync

+ const DispatchTypeSync

+ type Exchange interface

+ type Handler interface

+ Handle func(ctx context.Context, call Call) (any, error)

+ type Handlers map[string]Handler

+ func NewHandlers(handlers ...NamedHandler) Handlers

+ func (m Handlers) Append(handlers ...NamedHandler)

+ func (m Handlers) Handle(ctx context.Context, call Call) (res any, err error)

+ type NamedHandler interface

+ ToolName func() string

+ func NewHandler[In, Out any](name string, fn func(ctx context.Context, in In) (*Out, error)) NamedHandler

+ type ParsedToolCall interface

+ ToolCallID func() string

+ ToolName func() string

+ type Result interface

+ IsError func() bool

+ MarshalJSON func() ([]byte, error)

+ ToolCallID func() string

+ ToolOutput func() any

+ UnmarshalJSON func([]byte) error

+ func NewResult(id string, output any, isError bool) Result

+ type Set struct

+ func NewToolSet(tools ...toolRegistration) *Set

+ func (ts *Set) Definitions() []Definition

+ func (ts *Set) Parse(calls []Call) ([]ParsedToolCall, error)

+ type Spec struct

+ func NewSpec[T any](name, description string) *Spec[T]

+ func (s *Spec[T]) Definition() Definition

+ type TypedToolCall struct

+ ID string

+ Name string

+ Params T

+ func (c *TypedToolCall[T]) ToolCallID() string

+ func (c *TypedToolCall[T]) ToolName() string