nacelle

package module

Go to main page

Versions in this module

v0

v0.4.2

Aug 24, 2026

v0.4.1

Aug 24, 2026

Changes in this version

+ const SubAgentToolName

+ type SubAgentOptions struct

+ Approve Approve

+ Description string

+ MaxIterations int

+ Name string

+ System string

+ Usage func(Usage)

type Tool

+ func NewSubAgentTool(cfg Config, opts SubAgentOptions) (Tool, error)

v0.4.0

Aug 23, 2026

v0.3.1

Aug 23, 2026

v0.3.0

Aug 23, 2026

Changes in this version

+ const MaxInject

type Config

+ Hooks map[HookPoint][]Hook

+ type Hook func(ctx context.Context, ev HookEvent) HookResult

+ func Async(h Hook) Hook

+ func WithTimeout(d time.Duration, h Hook) Hook

+ type HookEvent struct

+ Err error

+ Input string

+ Point HookPoint

+ Result string

+ Retry bool

+ Tool string

+ type HookPoint string

+ const AfterToolCall

+ const BeforeToolCall

+ type HookResult struct

+ Deny string

+ Inject string

type Request

+ Hooks map[HookPoint][]Hook

type ToolSink

+ Hooks map[HookPoint][]Hook

v0.2.3

Aug 23, 2026

v0.2.2

Aug 23, 2026

Changes in this version

type Capabilities

+ MinBudget int64

v0.2.1

Aug 23, 2026

v0.2.0

Aug 23, 2026

Changes in this version

type Effort

+ const EffortMinimal

+ const EffortNone

+ type Thinking struct

+ Budget int64

+ Effort Effort

+ Show bool

v0.1.0

Aug 21, 2026

Changes in this version

+ const DefaultMaxTokens

+ const DefaultRetryAttempts

+ const DefaultRetryBase

+ const DefaultRetryMax

+ var ErrNoBackend = errors.New("nacelle: a backend is required")

+ var ErrNoSystemPrompt = errors.New("nacelle: a system prompt is required")

+ var ErrRetryBudget = errors.New("nacelle: the retry budget ran out")

+ func Attempt(err error) int

+ func Retryable(err error) bool

+ func RunTool(ctx context.Context, tool Tool, call Invocation, input json.RawMessage, ...) (string, error)

+ func ToolsByName(tools []Tool) map[string]Tool

+ func Transient(err error) error

+ type Agent struct

+ func New(cfg Config) (*Agent, error)

+ func (a *Agent) Backend() Backend

+ func (a *Agent) CountTokens(ctx context.Context, conversation []Message) (int64, error)

+ func (a *Agent) Stream(ctx context.Context, conversation []Message) iter.Seq2[Event, error]

+ type Approve func(ctx context.Context, name string, input json.RawMessage) bool

+ type Backend interface

+ Capabilities func() Capabilities

+ CountTokens func(ctx context.Context, request Request) (int64, error)

+ Name func() string

+ Stream func(ctx context.Context, request Request) iter.Seq2[Event, error]

+ func Retry(backend Backend, options RetryOptions) Backend

+ type Capabilities struct

+ Cost bool

+ Effort bool

+ MCP bool

+ Thinking bool

+ TokenCounting bool

+ type Config struct

+ Approve Approve

+ Backend Backend

+ Effort Effort

+ Logger *slog.Logger

+ MCP []mcp.Server

+ MaxIterations int

+ MaxTokens int64

+ System string

+ Thinking bool

+ Tools []Tool

+ type Effort string

+ const EffortHigh

+ const EffortLow

+ const EffortMax

+ const EffortMedium

+ const EffortXHigh

+ type Event struct

+ Kind Kind

+ Stop Stop

+ Text string

+ Tool *ToolEvent

+ Usage Usage

+ type Finish struct

+ Stop Stop

+ type Invocation struct

+ ID string

+ Index int

+ type Kind string

+ const KindDone

+ const KindText

+ const KindThinking

+ const KindToolCall

+ const KindToolResult

+ const KindTurn

+ type Message struct

+ Parts []Part

+ Role Role

+ func AssistantText(text string) Message

+ func Trim(conversation []Message, keep int) (kept []Message, dropped int)

+ func UserText(text string) Message

+ type Part interface

+ type Reasoning struct

+ Text string

+ type Request struct

+ Approve Approve

+ Effort Effort

+ MCP []mcp.Server

+ MaxIterations int

+ MaxTokens int64

+ Messages []Message

+ System string

+ Thinking bool

+ Tools []Tool

+ type RetryOptions struct

+ Attempts int

+ Base time.Duration

+ Budget time.Duration

+ Logger *slog.Logger

+ Max time.Duration

+ type Role string

+ const RoleAssistant

+ const RoleUser

+ type Stop string

+ const StopContext

+ const StopEnd

+ const StopIterations

+ const StopMaxTokens

+ const StopOther

+ const StopRefusal

+ const StopTools

+ func (s Stop) Complete() bool

+ type Text struct

+ Text string

+ type Tool interface

+ Description func() string

+ Name func() string

+ Run func(ctx context.Context, input json.RawMessage) (string, error)

+ Schema func() map[string]any

+ func NewTool[In any](name, description string, run func(ctx context.Context, in In) (string, error)) (Tool, error)

+ type ToolCall struct

+ Finished bool

+ ID string

+ Input json.RawMessage

+ Name string

+ type ToolEvent struct

+ Discarded bool

+ Duration time.Duration

+ Err error

+ ID string

+ Index int

+ Input string

+ Name string

+ Refused bool

+ Result string

+ type ToolResult struct

+ Failed bool

+ ID string

+ Name string

+ Result string

+ type ToolSink struct

+ Approve Approve

+ func (s *ToolSink) Drain() []Event

+ func (s *ToolSink) Report(event Event)

+ type Unsupported struct

+ Backend string

+ Feature string

+ func (e *Unsupported) Error() string

+ type Usage struct

+ CacheCreationTokens int64

+ CacheReadTokens int64

+ Cost float64

+ InputTokens int64

+ OutputTokens int64

+ func (u Usage) Add(other Usage) Usage

+ func (u Usage) CacheHitRate() float64

+ func (u Usage) Total() int64

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