agent

package

Go to main page

Versions in this module

v0

v0.3.1

Aug 2, 2026

Changes in this version

+ const MinCompactableResultTokens

+ func ClearedToolResultMessage(_ string, original agentcore.Message) string

+ func CompactionBlocks(strategy string) bool

type BuildDeps

+ Middlewares []agentcore.ToolMiddleware

type Session

+ func (s *Session) SetRewriteProgress(fn func(strategy string) func())

+ func (s *Session) ToolOutputDir() string

type SessionConfig

+ ToolMicrocompact *agentctx.ToolResultMicrocompactStrategy

+ ToolOutputRoot string

v0.3.0

Jul 31, 2026

Changes in this version

+ func BuildSystemBlocks(identity, instructions, gitSnapshot, dynamic string) []agentcore.SystemBlock

type AgentDefinition

+ Isolation string

type BuildDeps

+ SessionID string

+ WorkspaceFS tools.WorkspaceFS

type RuntimeReminderKind

+ const ReminderDateChange

type Session

+ func (s *Session) AvailableThinkingLevels() []string

+ func (s *Session) AvailableThinkingLevelsFor(prov, modelName string) []string

+ func (s *Session) EnqueueBackgroundResult(msg agentcore.AgentMessage)

+ func (s *Session) IdentitySystemBlock() []agentcore.SystemBlock

+ func (s *Session) RetargetWorkspace(cwd string)

+ func (s *Session) SetIdleHook(fn func())

+ func (s *Session) WaitForIdle()

type SessionConfig

+ LocalTools []config.ToolInfo

+ TelemetryTracer *telemetry.Tracer

type SessionEventType

+ const SEReasoningEffortChanged

type Snapshotter

+ RebindWorkspace func(gitDir, workTree, statePath string)

v0.2.2

Jun 14, 2026

Changes in this version

+ func SubagentHubObserver(hub *TeammateEventHub) func(meta subagent.RunMeta, ev agentcore.Event)

type RuntimeReminderKind

+ const ReminderGoal

type Session

+ func (s *Session) AppendGoalState(entry storage.GoalStateEntry) error

+ func (s *Session) CurrentSnapshot() (storage.ContextSnapshot, error)

+ func (s *Session) HandleGoalChange(change goal.Change)

+ func (s *Session) SetGoalSignal(fn func() goal.Signal)

+ func (s *Session) SetGoalUsageLimitHandler(fn func(string) (goal.State, error))

type SessionEvent

+ Goal goal.State

+ GoalPrevious goal.State

type SessionEventType

+ const SEGoalCleared

+ const SEGoalUpdated

v0.2.0

Jun 5, 2026

Changes in this version

+ func TeammateSpawner(reg *team.Registry, rt *task.Runtime, extraTools []agentcore.Tool, ...) subagent.TeamSpawner

+ type AgentInfo struct

+ Active bool

+ Name string

+ type LeaderInboxPump struct

+ func NewLeaderInboxPump(reg *team.Registry, ag MessageInjector, waitInterval time.Duration) *LeaderInboxPump

+ func (p *LeaderInboxPump) Run(ctx context.Context)

+ type MessageInjector interface

+ Inject func(agentcore.AgentMessage) (agentcore.InjectResult, error)

+ type PresenceEvent struct

+ AgentName string

+ Started bool

type RuntimeReminderKind

+ const ReminderHookContext

type Session

+ func (s *Session) Diff() (string, error)

+ func (s *Session) DynamicSystemBlock() *agentcore.SystemBlock

+ func (s *Session) Redo() (changed []string, ok bool, err error)

+ func (s *Session) SnapshotEnabled() bool

+ func (s *Session) Undo() (changed []string, ok bool, err error)

type SessionConfig

+ InitialDynamic string

+ Snapshotter Snapshotter

+ type Snapshotter interface

+ Close func()

+ DiffTop func() (string, error)

+ Rebind func(statePath string)

+ Redo func() (changed []string, ok bool, err error)

+ Track func() (changed bool, err error)

+ Undo func() (changed []string, ok bool, err error)

+ type TeammateEventHub struct

+ func NewTeammateEventHub() *TeammateEventHub

+ func (h *TeammateEventHub) ActiveAgents() []string

+ func (h *TeammateEventHub) IsActive(agentName string) bool

+ func (h *TeammateEventHub) KnownAgents() []AgentInfo

+ func (h *TeammateEventHub) MarkStopped(agentName string)

+ func (h *TeammateEventHub) Publish(agentName string, ev agentcore.Event)

+ func (h *TeammateEventHub) Subscribe(agentName string) ([]agentcore.Event, <-chan agentcore.Event, func())

+ func (h *TeammateEventHub) SubscribePresence() (<-chan PresenceEvent, func())

+ type TeammatePersist struct

+ Roster *storage.RosterStore

+ Transcripts *storage.TranscriptStore

+ type TeammateWaker struct

+ func NewTeammateWaker(spawner subagent.TeamSpawner, ...) *TeammateWaker

+ func (w *TeammateWaker) Wake(ctx context.Context, name, prompt string) (bool, error)

v0.1.3

May 24, 2026

Changes in this version

+ func BuildToolPool(cwd string, mainTools []agentcore.Tool) []agentcore.Tool

+ func FilterToolsForAgent(in []agentcore.Tool, opts FilterOpts) []agentcore.Tool

+ type AgentDefinition struct

+ Background bool

+ BaseDir string

+ Description string

+ DisallowedTools []string

+ Filename string

+ MaxTurns int

+ Model string

+ Name string

+ Source AgentSource

+ SystemPrompt string

+ Tools []string

+ func BuiltinDefinitions(cwd string) []AgentDefinition

+ func LoadAgentsDir(dir string, source AgentSource) (defs []AgentDefinition, errs []error)

+ func MergeAgents(groups ...[]AgentDefinition) []AgentDefinition

+ func (d *AgentDefinition) BuildConfig(deps BuildDeps, ctxFactory func(agentcore.ChatModel) agentcore.ContextManager) (subagent.Config, error)

+ func (d *AgentDefinition) Validate() error

+ type AgentSource string

+ const SourceBuiltin

+ const SourceProject

+ const SourceUser

+ func (s AgentSource) IsBuiltIn() bool

+ type BuildDeps struct

+ ContextWindow int

+ Cwd string

+ DefaultModel agentcore.ChatModel

+ MainTools []agentcore.Tool

+ ResolveModel func(name string) (agentcore.ChatModel, error)

+ type CacheStats struct

+ HitRate float64

+ Input int

+ ReadTokens int

+ SavedUSD float64

+ WriteTokens int

type ErrorSnapshot

+ Category diag.Category

+ type FilterOpts struct

+ AllowMCP bool

+ ExtraDisallowed []string

+ IsAsync bool

+ IsBuiltIn bool

+ type PlanModeSignal struct

+ Active bool

+ JustCancelled bool

+ PlanFilePath string

type RuntimeMetricsSnapshot

+ ErrorByCategory map[diag.Category]int

type RuntimeReminderKind

+ const ReminderPlanMode

type Session

+ func (s *Session) CacheStats() CacheStats

+ func (s *Session) SetPlanModeSignal(fn func() PlanModeSignal)

type SessionConfig

+ FileReadState *agenttools.FileReadState

+ FrozenIdentity string

+ FrozenInstructions string

+ InitialMCPOverlay string

v0.1.2

Apr 23, 2026

v0.1.1

Apr 17, 2026

Changes in this version

+ func SessionMemorySeedFn(cwd string) func() (string, error)

type Session

+ func (s *Session) OverlayPrompt(key, text string)

+ func (s *Session) Reset() error

+ type SessionMemory struct

+ Content string

+ UpdatedAt time.Time

v0.1.0

Apr 8, 2026

Changes in this version

+ func CodebotToolClassifier(name string) bool

+ type CompactionKind string

+ const CompactionKindFull

+ const CompactionKindMicro

+ const CompactionKindPrune

+ const CompactionKindTrim

type CompactionResult

+ CompactedCount int

+ KeptCount int

+ SplitTurn bool

+ Strategy string

+ type CompactionSnapshot struct

+ Changed bool

+ CompactedCount int

+ KeptCount int

+ Kind CompactionKind

+ Reason string

+ SplitTurn bool

+ Strategy string

+ Timestamp time.Time

+ TokensAfter int

+ TokensBefore int

+ type ContextBreakdown struct

+ AssistantText int

+ ContextWindow int

+ Images int

+ Summaries int

+ ToolCalls int

+ ToolResults int

+ TopTools []ToolTokenUsage

+ Total int

+ UserText int

+ type ContextSuggestion struct

+ Message string

+ Savings int

+ Severity string

+ type ErrorSnapshot struct

+ Detail string

+ Kind apperr.Kind

+ Message string

+ Timestamp time.Time

+ type ReminderSnapshot struct

+ Kind RuntimeReminderKind

+ Mode string

+ Timestamp time.Time

+ type RuntimeMetricsSnapshot struct

+ CompactionByKind map[CompactionKind]int

+ CompactionChanged int

+ CompactionSaved int

+ CompactionSavedByKind map[CompactionKind]int

+ CompactionTotal int

+ ErrorByKind map[apperr.Kind]int

+ ErrorTotal int

+ ReminderByKind map[RuntimeReminderKind]int

+ ReminderTotal int

+ type RuntimeReminderKind string

+ const ReminderPostStopValidation

+ const ReminderRepeatToolCall

+ const ReminderSkillPaths

+ const ReminderTaskManagement

type Session

+ func (s *Session) ApplySkillDelta(name string, delta skill.Delta) error

+ func (s *Session) ApplySkillInvocation(result *skill.InvocationResult) error

+ func (s *Session) ClearApprovedPlanPrompt()

+ func (s *Session) ClearPlanModePrompt()

+ func (s *Session) ContextBreakdown() ContextBreakdown

+ func (s *Session) ContextSnapshot() (*agentcore.ContextSnapshot, bool)

+ func (s *Session) ContextSuggestions() []ContextSuggestion

+ func (s *Session) HandleOverflowRewrite(info agentctx.RewriteEvent)

+ func (s *Session) HandleProjectedRewrite(info agentctx.RewriteEvent)

+ func (s *Session) LastCompaction() (CompactionSnapshot, bool)

+ func (s *Session) LastReminder() (ReminderSnapshot, bool)

+ func (s *Session) LastRunSummary() (agentcore.RunSummary, bool)

+ func (s *Session) LastTurnOutcome() TurnOutcomeSnapshot

+ func (s *Session) PostSummaryRecoveryHook() agentctx.PostSummaryHook

+ func (s *Session) RecentErrors(limit int) []ErrorSnapshot

+ func (s *Session) RecentToolCalls(limit int) []ToolCallSnapshot

+ func (s *Session) ReplaceMCPTools(tools []agentcore.Tool)

+ func (s *Session) ResetTaskList() error

+ func (s *Session) RuntimeMetrics() RuntimeMetricsSnapshot

+ func (s *Session) SetApprovedPlanPrompt(text string)

+ func (s *Session) SetMCPInstructions(text string)

+ func (s *Session) SetPlanModePrompt(text string)

+ func (s *Session) SetSkillCatalog(catalog *skill.Catalog)

+ func (s *Session) SetTaskNotifyFn(fn localtools.TaskNotifyFn)

+ func (s *Session) SkillCatalog() *skill.Catalog

+ func (s *Session) TaskSnapshot() localtools.TaskSnapshot

type SessionConfig

+ ContextManager agentcore.ContextManager

+ SkillAllowsSetter func([]string)

+ SkillCatalog *skill.Catalog

+ SkillUsage *skill.UsageTracker

+ TaskStore *localtools.TaskStore

type SessionEvent

+ CompactedCount int

+ CompactionKind CompactionKind

+ CompactionStrategy string

+ KeptCount int

+ Reminder string

+ ReminderKind RuntimeReminderKind

+ SplitTurn bool

type SessionEventType

+ const SERuntimeReminder

+ type ToolCallSnapshot struct

+ ArgsHash string

+ Success bool

+ Timestamp time.Time

+ Tool string

+ type ToolTokenUsage struct

+ CallTokens int

+ Name string

+ ResultTokens int

+ Total int

+ type TurnOutcomeSnapshot struct

+ AssistantResponded bool

+ CodeEditToolCalls int

+ ReadOnlyToolCalls int

+ TaskMutations int

+ WriteLikeToolCalls int

v0.0.4

Mar 25, 2026

Changes in this version

type Session

+ func (s *Session) GenerateSuggestion(ctx context.Context) (string, error)

+ func (s *Session) SessionID() string

+ func (s *Session) SideQuestion(ctx context.Context, question string) (string, error)

v0.0.3

Mar 17, 2026

v0.0.2

Mar 14, 2026

Changes in this version

+ type CompactionResult struct

+ Changed bool

+ Reason string

+ TokensAfter int

+ TokensBefore int

type Session

+ func (s *Session) Messages() []agentcore.AgentMessage

type SessionConfig

+ ChatModel agentcore.ChatModel

+ DeferredToolsPreamble string

+ HookRunner *hooks.Runner

+ PreambleInjected bool

+ Reminders []string

type SessionEvent

+ CompactionChanged bool

+ TokensAfter int

+ TokensBefore int

v0.0.1

Mar 5, 2026

Changes in this version

+ type ModelFactory func(prov, model, apiKey, baseURL string) (agentcore.ChatModel, error)

+ type Session struct

+ func NewSession(cfg SessionConfig) *Session

+ func (s *Session) APIKey() string

+ func (s *Session) Abort()

+ func (s *Session) AbortSilent()

+ func (s *Session) BaseURL() string

+ func (s *Session) ClearConversation()

+ func (s *Session) Close()

+ func (s *Session) Compact() error

+ func (s *Session) ContextUsage() *agentcore.ContextUsage

+ func (s *Session) CostEstimate() (inputTokens, outputTokens int, cost float64)

+ func (s *Session) CurrentSessionInfo() (storage.SessionInfo, error)

+ func (s *Session) IsRunning() bool

+ func (s *Session) LastAssistantText() string

+ func (s *Session) ListSessions() ([]storage.SessionInfo, error)

+ func (s *Session) ModelName() string

+ func (s *Session) NewSession() error

+ func (s *Session) Prompt(text string) error

+ func (s *Session) PromptWithBlocks(blocks []agentcore.ContentBlock) error

+ func (s *Session) Provider() string

+ func (s *Session) Registry() *provider.ModelRegistry

+ func (s *Session) Reload()

+ func (s *Session) ReplaceAllTools(tools []agentcore.Tool)

+ func (s *Session) ResolveAndSetModel(pattern string) (string, error)

+ func (s *Session) RestoreAllTools(extra ...agentcore.Tool)

+ func (s *Session) SetBeforePrompt(fn func())

+ func (s *Session) SetModel(prov, model string) error

+ func (s *Session) SetSystemSuffix(suffix string)

+ func (s *Session) SetThinkingLevel(level agentcore.ThinkingLevel)

+ func (s *Session) SetTools(tools ...agentcore.Tool)

+ func (s *Session) Settings() config.Resolved

+ func (s *Session) Skills() []config.Skill

+ func (s *Session) Steer(text string)

+ func (s *Session) Subscribe(fn func(SessionEvent)) func()

+ func (s *Session) SwitchSession(id string) error

+ func (s *Session) ToolsByName(names ...string) []agentcore.Tool

+ func (s *Session) TotalTokens() int

+ type SessionConfig struct

+ Agent *agentcore.Agent

+ ContextFiles config.ContextFiles

+ CreateModel ModelFactory

+ Cwd string

+ LazyPersist bool

+ Manager *storage.Manager

+ Registry *provider.ModelRegistry

+ Settings config.Resolved

+ Skills []config.Skill

+ Store *storage.Store

+ Tools []agentcore.Tool

+ type SessionEvent struct

+ AgentEvent *agentcore.Event

+ CompactionReason string

+ Error error

+ Level agentcore.ThinkingLevel

+ ModelName string

+ Provider string

+ RetryAttempt int

+ RetryDelay time.Duration

+ RetryMax int

+ RetrySuccess bool

+ SessionID string

+ Type SessionEventType

+ type SessionEventType string

+ const SEAgentEvent

+ const SEAutoCompactionEnd

+ const SEAutoCompactionStart

+ const SEAutoRetryEnd

+ const SEAutoRetryStart

+ const SEError

+ const SEModelChanged

+ const SESessionSwitched

+ const SEThinkingChanged

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