agent

Nov 8, 2026

Changes in this version

type Session

+ OnIdle func(ctx context.Context, rounds, asks int) string

Nov 7, 2026

Changes in this version

+ func WithShapeHint(ctx context.Context, h ShapeHint) context.Context

+ type ShapeHint struct

+ Scale float64

+ Window int

Nov 6, 2026

Changes in this version

+ const AudioTokensPerSecond

+ const ImageTokenEstimate

+ const PDFPageTextTokens

+ const PDFPageTokenEstimate

+ const VideoTokensPerSecond

+ const VideoURLTokenEstimate

type TurnEndReason

+ const TurnToolLoop

Oct 30, 2026

Changes in this version

+ const DefaultSummarySystem

+ const SessionDocFold

+ const SessionDocRecap

+ const SessionSearchName

+ const SummaryMaxTokens

+ const SummaryMinTokens

+ func DefaultSummaryPrompt(task string, budget int) string

+ func DefaultSummaryTokens(folded, kept, target int) int

+ func PutSpan(ctx context.Context, idx SessionIndex, kind, key, name, summary string, ...) error

+ func SessionSearchTool(idx SessionIndex) (llm.ToolDef, func(ctx context.Context, args string) string)

+ func SummaryCap(budget int) int

type CompactionInfo

+ IndexErr error

+ type SessionDoc struct

+ Body string

+ Key string

+ Kind string

+ Name string

+ Summary string

+ type SessionHit struct

+ Key string

+ Name string

+ Score float64

+ Snippet string

+ type SessionIndex interface

+ Close func(ctx context.Context) error

+ Put func(ctx context.Context, d SessionDoc) error

+ Search func(ctx context.Context, q string, n int) ([]SessionHit, error)

type Shaper

+ Index SessionIndex

+ SummaryOpts *llm.ChatOpts

+ SummaryPrompt func(task string, budget int) string

+ SummarySystem string

+ SummaryTokens func(folded, kept, target int) int

+ TaskFunc func() string

Oct 21, 2026

Changes in this version

+ const DefaultLODTruncateAboveChars

+ const DefaultMaxToolResultChars

+ const DefaultOutputReservePct

+ const DefaultPreserveLastMessages

+ const DefaultPreserveLastToolCalls

+ const ReasoningEstimated

+ const ReasoningReported

+ func LiveCallID(entries []Entry) string

+ type CharsByThree struct

+ func (CharsByThree) Estimate(s string) int

type Entry

+ Reasoning string

type EntryKind

+ const KindRecap

type EntryUsage

+ CacheN int

+ DraftN int

+ DraftNAccepted int

+ PredictedMS float64

+ PredictedN int

+ PromptMS float64

+ PromptN int

+ Reasoning int

+ ReasoningSource string

+ type LODKeep string

+ const LODEnds

+ const LODHead

+ const LODTail

+ type RecapSink interface

+ Store func(entries []Entry) (name string, err error)

+ type RecapSpan struct

+ Anchor *Entry

+ Chars int

+ Kept []Entry

+ KeptCalls []string

+ Subsumes []Entry

+ Unmatched []string

+ func PlanRecap(entries []Entry, from string, keep []string) (RecapSpan, error)

+ func (sp RecapSpan) Report(summary, userEdit, where string) string

type Shaper

+ Rehead func(ctx context.Context, sessionID string) (changed bool)

+ Task string

+ ToolLOD map[string]LODKeep

type ShaperPolicy

+ LODStep int

+ MaxToolResultChars int

+ PinFirstUser bool

+ func PolicyFor(window int) ShaperPolicy

type TokenUsage

+ Reasoning int

+ ReasoningEstimated int

+ ReasoningReported int

Sep 1, 2026

Changes in this version

+ const OverflowTag

type CompactionInfo

+ Duration time.Duration

+ type CompactionStart struct

+ At time.Time

+ SessionID string

+ Subsuming int

+ Target int

+ TokensBefore int

+ type Overflow struct

+ Attempt int

+ Generated int

+ PromptTokens int

+ TruncatedToolCalls []string

+ func (o Overflow) InToolCall() bool

+ func (o Overflow) String() string

+ type OverflowDecision struct

+ Note string

+ Retry bool

type Session

+ MaxOverflowRetries int

+ OnCompactionComplete func(CompactionInfo)

+ OnCompactionStart func(CompactionStart)

+ OnOverflow func(context.Context, Overflow) OverflowDecision

+ OnTurnEnd func(TurnEnd)

+ OnTurnStart func(TurnStart)

type Shaper

+ Pause func() (resume func())

+ type TurnEnd struct

+ Duration time.Duration

+ Err error

+ Reason TurnEndReason

+ Rounds int

+ ServerOverheadMS int64

+ ServerTimingSeen bool

+ SessionID string

+ ThreadID string

+ Usage TokenUsage

+ type TurnEndReason string

+ const TurnCanceled

+ const TurnError

+ const TurnMaxTurns

+ const TurnOverflow

+ const TurnRepetition

+ const TurnReply

+ const TurnTerminalTool

+ func (r TurnEndReason) Failed() bool

+ type TurnStart struct

+ At time.Time

+ SessionID string

+ ThreadID string

Aug 14, 2026

Changes in this version

+ func NewID() string

type Session

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

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

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

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