promptr

Jun 27, 2026

Changes in this version

+ func RunToolsStream[T any](ctx context.Context, p Provider, prompt string, tools []Tool, opts Options) (<-chan Partial[T], error)

+ type StreamToolProvider interface

+ StreamTools func(ctx context.Context, messages []Message, tools []ToolDef) (ToolStream, error)

+ type ToolStream struct

+ Deltas <-chan string

+ Reply func() (Reply, error)

Jun 27, 2026

Changes in this version

type Option

+ func ParallelTools() Option

type Options

+ ParallelTools bool

Jun 27, 2026

Changes in this version

+ type Option func(*Options)

+ func OnCheck(fn func(err error)) Option

+ func WithAttempts(n int) Option

+ func WithMaxSteps(n int) Option

+ func WithSystem(s string) Option

type Options

+ Check func(v any) error

+ OnCheck func(err error)

+ Validate func(v any) error

Jun 27, 2026

Changes in this version

+ type AfterFunc func(Outcome)

+ type CallInfo struct

+ Kind CallKind

+ Messages []Message

+ Start time.Time

+ Tools []ToolDef

+ type CallKind string

+ const KindComplete

+ const KindStream

+ const KindTools

type Collector

+ func (c *Collector) Hook() Hook

+ type Hook interface

+ BeforeCall func(ctx context.Context, info CallInfo) AfterFunc

+ func LogHook(logger *slog.Logger) Hook

+ type Outcome struct

+ Calls []ToolCall

+ Duration time.Duration

+ Err error

+ Estimated bool

+ PromptTokens int

+ ReplyTokens int

+ Text string

type Provider

+ func WithHooks(p Provider, hooks ...Hook) Provider

+ type ProviderFunc func(ctx context.Context, messages []Message) (string, error)

+ func (f ProviderFunc) Complete(ctx context.Context, messages []Message) (string, error)

Jun 27, 2026

Changes in this version

+ func RunTools[T any](ctx context.Context, p Provider, prompt string, tools []Tool, opts Options) (T, error)

type Collector

+ func (c *Collector) CollectTools(p ToolProvider) Provider

type Message

+ ToolCallID string

+ ToolCalls []ToolCall

type Options

+ MaxSteps int

+ type Reply struct

+ Calls []ToolCall

+ Text string

+ type Tool struct

+ Def ToolDef

+ Invoke func(ctx context.Context, argsJSON string) (resultJSON string, err error)

+ type ToolCall struct

+ Arguments string

+ ID string

+ Name string

+ type ToolDef struct

+ Description string

+ Name string

+ Params string

+ type ToolProvider interface

+ CompleteTools func(ctx context.Context, messages []Message, tools []ToolDef) (Reply, error)

Jun 27, 2026

Changes in this version

+ type Call struct

+ Duration time.Duration

+ Err error

+ Estimated bool

+ PromptTokens int

+ ReplyTokens int

+ Start time.Time

+ type Collector struct

+ func (c *Collector) Calls() []Call

+ func (c *Collector) Collect(p Provider) Provider

+ func (c *Collector) Reset()

+ func (c *Collector) Stats() Stats

+ type Middleware func(Provider) Provider

type Provider

+ func Chain(p Provider, mws ...Middleware) Provider

+ type Stats struct

+ Calls int

+ Errors int

+ PromptTokens int

+ ReplyTokens int

+ TotalLatency time.Duration

+ func (s Stats) AvgLatency() time.Duration

+ func (s Stats) TotalTokens() int

+ type UsageReporter interface

+ LastUsage func() (prompt, reply int)

Jun 27, 2026

Changes in this version

+ func ExtractStream[T any](ctx context.Context, p Provider, prompt string, opts Options) (<-chan Partial[T], error)

type Message

+ Parts []Part

type Options

+ UserParts []Part

+ type Part struct

+ Data []byte

+ Kind PartKind

+ MIME string

+ Text string

+ URL string

+ func AudioPart(mime string, data []byte) Part

+ func FilePart(mime string, data []byte) Part

+ func ImagePart(mime string, data []byte) Part

+ func ImageURL(url string) Part

+ func TextPart(s string) Part

+ type PartKind uint8

+ const PartAudio

+ const PartFile

+ const PartImage

+ const PartText

+ type Partial struct

+ Complete bool

+ Err error

+ Value T

+ type StreamProvider interface

+ Stream func(ctx context.Context, messages []Message) (<-chan string, error)

Jun 27, 2026

Changes in this version

+ func ExtractUnion[I any](ctx context.Context, p Provider, prompt string, opts Options, u *Union) (I, error)

+ type Union = coerce.Union

+ func NewUnion(samples ...any) *Union

Jun 27, 2026

Changes in this version

+ func Render(tmpl string, ctx map[string]any) (string, error)

type Provider

+ func Fallback(providers ...Provider) Provider

+ func Retry(p Provider, attempts int, backoff time.Duration) Provider

+ func RoundRobin(providers ...Provider) Provider

+ type Registry map[string]Provider

+ func (r Registry) Get(name string) Provider

+ type TemplateError struct

+ Msg string

+ func (e *TemplateError) Error() string

Jun 26, 2026

Changes in this version

+ func Extract[T any](ctx context.Context, p Provider, prompt string, opts Options) (T, error)

+ type Message struct

+ Content string

+ Role string

+ type Options struct

+ Attempts int

+ System string

+ type Provider interface

+ Complete func(ctx context.Context, messages []Message) (string, error)