agent

package

Go to main page

Versions in this module

v0

v0.5.0

Aug 14, 2026

Changes in this version

+ func NewID() string

type Session

+ OnToolCalls func([]llm.ToolCall) []llm.ToolCall

v0.4.0

Aug 4, 2026

v0.3.0

Jul 29, 2026

Changes in this version

+ const SlotSystemNote

+ func DefaultContextBuilderFormat(ctx context.Context, store Store, sessionID, system string, format ToolFormat) ([]llm.Message, error)

+ func NeutralizeSpecialTokens(s string) string

+ type DocFinder interface

+ Find func(ctx context.Context, texts []string) ([]DocHit, error)

+ type DocHit struct

+ DocID string

+ Line string

+ Score float64

+ Title string

type Entry

+ Parts []llm.ContentPart

+ Usage *EntryUsage

+ func ExpandEntries(entries []Entry) []Entry

+ type EntryUsage struct

+ Cached int

+ Generated int

+ LatencyMS int64

+ Processed int

+ type FinderOpts struct

+ Kinds []EntryKind

+ MaxHits int

+ MinScore float64

+ Now func() int64

+ Render func(DocHit) string

+ Tag string

+ Timeout time.Duration

type NotificationPreparer

+ func FinderPreparer(store Store, finder DocFinder, opts FinderOpts) NotificationPreparer

type Session

+ EncodeToolResult func(raw string) string

+ MaxRepeatedExchanges int

+ MaxRepetitionRetries int

+ MaxToolResultChars int

+ OmitSlotInstructions bool

+ ToolFormat ToolFormat

type Shaper

+ func (sh *Shaper) Compact(ctx context.Context, sessionID string) (CompactionInfo, bool, error)

type ShaperPolicy

+ AlwaysLOD bool

+ ToolFormat ToolFormat

+ VerbatimToolResults bool

type TokenUsage

+ Cached int

+ Generated int

+ Processed int

+ Turns int

+ type ToolFormat string

+ const ToolFormatHeredoc

+ const ToolFormatNative

v0.2.0

Jul 4, 2026

Changes in this version

+ type CompactionInfo struct

+ SubsumedCount int

+ Summary string

+ TokensAfter int

+ TokensBefore int

type Session

+ Estimate TokenEstimator

+ OnCompaction func(CompactionInfo)

+ OnUsage func(TokenUsage)

type ShaperPolicy

+ LODHeadroomTokens int

+ type TokenUsage struct

+ Active int

+ Total int

+ type TurnResult struct

+ Compactions []CompactionInfo

+ Reply string

+ Usage TokenUsage

v0.1.0

Jul 4, 2026

Changes in this version

+ var ErrSessionClosed = errors.New("agent: session closed by terminal tool")

+ func Budget(contextTokens, reservePct int) int

+ func DefaultContextBuilder(ctx context.Context, store Store, sessionID, system string) ([]llm.Message, error)

+ func IsResolvedTruth(result string) bool

+ func PendingResult(correlationID, toolCallID string, ttlSeconds int) string

+ type CharsByFour struct

+ func (CharsByFour) Estimate(s string) int

+ type ClearRequest struct

+ Clear bool

+ GroupBy string

+ Key string

+ func ParseClearRequest(result string) (ClearRequest, bool)

+ type Compaction struct

+ Marker Entry

+ Subsumes []Entry

+ type ContextBuilder func(ctx context.Context, sessionID string, system string) ([]llm.Message, error)

+ type Entry struct

+ Content string

+ CreatedAt int64

+ ID string

+ Kind EntryKind

+ Origin string

+ Tag string

+ ToolCallID string

+ ToolName string

+ type EntryKind string

+ const KindAssistant

+ const KindCompaction

+ const KindNotification

+ const KindToolCall

+ const KindToolResult

+ const KindUser

+ type LLMRunner interface

+ ChatStream func(ctx context.Context, messages []llm.Message, tools []llm.ToolDef, ...) (<-chan llm.StreamChunk, error)

+ type LiftRequest struct

+ CorrelationID string

+ Pending bool

+ TTLSeconds int

+ func ParseLiftRequest(result string) (LiftRequest, bool)

+ type NotificationPreparer interface

+ PrepareNotifications func(ctx context.Context, sessionID string) error

+ func MCPPreparer(store RevalidateStore, rv Revalidator) NotificationPreparer

+ type PendingNotice struct

+ GroupBy string

+ Key string

+ type PreparerFunc func(ctx context.Context, sessionID string) error

+ func (f PreparerFunc) PrepareNotifications(ctx context.Context, sessionID string) error

+ type RevalidateStore interface

+ Clear func(ctx context.Context, sessionID, groupBy, key string) error

+ PendingNotices func(ctx context.Context, sessionID string) ([]PendingNotice, error)

+ type Revalidator interface

+ Revalidate func(ctx context.Context, groupBy, key string) (result string, ok bool, err error)

+ type SchemaValidator struct

+ func NewSchemaValidator(tools []llm.ToolDef) *SchemaValidator

+ func (sv *SchemaValidator) ValidateArgs(toolName, argsJSON string) error

+ type Session struct

+ Build ContextBuilder

+ ChatOpts *llm.ChatOpts

+ Dispatch ToolDispatcher

+ ForcedTerminalTool string

+ MaxTurns int

+ Now func() int64

+ OnAssistantToken func(string)

+ Preparer NotificationPreparer

+ Runner LLMRunner

+ SessionID string

+ SpanPrefix string

+ Store Store

+ System string

+ ThreadID string

+ Tools []llm.ToolDef

+ Tracer Tracer

+ func (s *Session) Inject(ctx context.Context, e Entry) error

+ func (s *Session) Turn(ctx context.Context) (lastReplyOut string, err error)

+ type Shaper struct

+ Estimate TokenEstimator

+ Policy ShaperPolicy

+ Runner LLMRunner

+ SpanPrefix string

+ Store Store

+ Tracer Tracer

+ func (sh *Shaper) Build(ctx context.Context, sessionID, system string) (msgs []llm.Message, err error)

+ type ShaperPolicy struct

+ BudgetTokens int

+ LODTruncateAboveChars int

+ PreserveLastMessages int

+ PreserveLastToolCalls int

+ type Span interface

+ End func()

+ EndError func(err error)

+ Set func(key string, value any) Span

+ type Store interface

+ Append func(ctx context.Context, sessionID string, e Entry) error

+ ClaimPending func(ctx context.Context, sessionID string, at int64) (int, error)

+ Compact func(ctx context.Context, sessionID string, c Compaction) error

+ Context func(ctx context.Context, sessionID string) ([]Entry, error)

+ type TokenEstimator interface

+ Estimate func(s string) int

+ func Default() TokenEstimator

+ type ToolDispatcher func(ctx context.Context, tc llm.ToolCall) (string, error)

+ func ValidatingDispatcher(inner ToolDispatcher, v Validator) ToolDispatcher

+ type Tracer interface

+ Start func(ctx context.Context, name string) (Span, context.Context)

+ type Validator interface

+ ValidateArgs func(toolName, argsJSON string) error

+ type ValidatorFunc func(toolName, argsJSON string) error

+ func (f ValidatorFunc) ValidateArgs(toolName, argsJSON string) error

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