core

package

Go to main page

Versions in this module

v0

v0.34.2

Aug 30, 2026

v0.34.1

Aug 30, 2026

Changes in this version

+ const CacheOff

v0.34.0

Aug 29, 2026

Changes in this version

+ func GetCompactAt(cfg MoaConfig) int

+ func ResolveCompactAt(sessionCompactAt, globalCompactAt int) int

type CompactionSettings

+ DefaultCompactAt int

+ func CompactionWithDefault(globalCompactAt int) *CompactionSettings

type MoaConfig

+ CompactAt int

v0.33.0

Aug 29, 2026

Changes in this version

+ const MaxImageBase64Bytes

+ func CanonicalModelID(id string) string

+ func PromptCacheKey(sessionID string) string

+ func SubagentPromptCacheKey(parentKey, jobID string) string

type Pricing

+ CacheWrite1h float64

type PricingTier

+ CacheWrite1h float64

type StreamOptions

+ PromptCacheKey string

type Usage

+ CacheWrite1h int

v0.32.0

Aug 28, 2026

v0.31.0

Aug 22, 2026

v0.30.1

Aug 18, 2026

v0.30.0

Aug 17, 2026

Changes in this version

+ func AllowedModelAliases(allowedIDs []string) []string

+ func ExtractAssistantText(msg AgentMessage) string

+ func IsModelAllowed(model Model, allowedIDs []string) bool

+ func ModelAliases() []string

+ func SuggestAliasFrom(spec string, aliases []string) string

+ func SuggestModelAlias(spec string) string

type MoaConfig

+ SubagentAllowedModels []string

type Tool

+ SpecFunc func() ToolSpec

v0.29.0

Aug 14, 2026

Changes in this version

+ func SameModelIdentity(requested, effective string) bool

type Message

+ RequestedModel string

v0.28.0

Aug 11, 2026

Changes in this version

type SteerItem

+ Custom map[string]any

v0.27.0

Aug 6, 2026

Changes in this version

+ func ValidateAuxiliaryModelConfig(cfg MoaConfig) error

+ func ValidateAuxiliaryModelSpec(spec string) error

+ type AuxiliaryModelAvailable func(provider string) bool

type MoaConfig

+ AutoTitleModel string

+ SessionBriefModel string

type Model

+ func ResolveAuxiliaryModel(spec string, available AuxiliaryModelAvailable) (Model, bool, error)

v0.26.0

Aug 4, 2026

Changes in this version

+ var ErrWaitInterruptedBySteer = errors.New("wait interrupted by user steer")

+ func EffectiveThinkingLevel(model Model, level string) (string, error)

+ func ThinkingLevelsForModel(model Model) []string

+ func UpdatePinnedModels(models []string, id string, pinned bool) []string

v0.25.1

Aug 3, 2026

v0.25.0

Aug 3, 2026

Changes in this version

+ func AcquireFileLock(path string) (io.Closer, error)

+ func CodebaseKey(dir string) string

+ func RepoCodebaseKey(dir string) (string, bool)

v0.24.1

Aug 2, 2026

v0.24.0

Aug 2, 2026

Changes in this version

+ func AddProjectAllowPattern(workspaceRoot, pattern string) error

+ func ConfigDir() string

+ func ConfigSubdir(parts ...string) string

+ func ImportLegacyProjectVeto(cwd string) error

+ func ProjectHash(workspaceRoot string) string

+ func ProjectStateDir(workspaceRoot string) string

+ func SetProjectMCPServerDisabled(workspaceRoot, server string, disabled bool) error

+ func UpdateProjectState(workspaceRoot string, update func(*ProjectState)) error

+ type ProjectState struct

+ Config *MoaConfig

+ DisabledMCPServers []string

+ LegacyVetoImported bool

+ PermissionAllow []string

+ func LoadProjectState(workspaceRoot string) (ProjectState, error)

v0.23.0

Aug 1, 2026

Changes in this version

+ func CloneArgs(m map[string]any) map[string]any

v0.22.0

Jul 31, 2026

Changes in this version

+ func CorrectImageMime(b64, declared string) string

+ func ImageMimeFromBytes(data []byte) string

v0.21.1

Jul 31, 2026

v0.21.0

Jul 31, 2026

Changes in this version

+ const AgentEventUserMessage

v0.20.0

Jul 31, 2026

Changes in this version

+ func ValidateMCPServers(servers map[string]MCPServer) error

type MCPServer

+ Headers map[string]string

+ URL string

+ func (s MCPServer) IsRemote() bool

+ func (s MCPServer) Validate() error

v0.19.0

Jul 31, 2026

Changes in this version

+ const AgentEventCompactionEnd

+ const AgentEventCompactionStart

+ const AgentEventEnd

+ const AgentEventError

+ const AgentEventMessageEnd

+ const AgentEventMessageStart

+ const AgentEventMessageUpdate

+ const AgentEventStart

+ const AgentEventSteer

+ const AgentEventSteersCanceled

+ const AgentEventToolExecEnd

+ const AgentEventToolExecStart

+ const AgentEventToolExecUpdate

+ const AgentEventTurnEnd

+ const AgentEventTurnStart

+ const DefaultMaxOutputTokens

+ const DefaultSTTModel

+ const MaxImageDimension

+ const ProviderEventDone

+ const ProviderEventError

+ const ProviderEventRateLimit

+ const ProviderEventStart

+ const ProviderEventTextDelta

+ const ProviderEventTextEnd

+ const ProviderEventTextStart

+ const ProviderEventThinkingDelta

+ const ProviderEventThinkingEnd

+ const ProviderEventThinkingStart

+ const ProviderEventToolCallDelta

+ const ProviderEventToolCallEnd

+ const ProviderEventToolCallStart

+ const ToolCallDecisionKindPermission

+ const ToolCallDecisionKindPolicy

+ var DefaultCompactionSettings = CompactionSettings

+ var ErrEmptyResponse = &EmptyResponseError

+ var ErrQuotaExceeded = &QuotaExceededError

+ var ThinkingLevels = []string

+ func AgentIDFromContext(ctx context.Context) string

+ func BuildSTTPrompt(vocabulary []string) string

+ func CacheTTLDuration(cfg MoaConfig) time.Duration

+ func CanonicalOrRaw(path string) string

+ func CanonicalizePath(path string) (string, error)

+ func EstimateOutputTokens(m Message) int

+ func EstimateTokens(m Message) int

+ func ExtractFinalAssistantText(msgs []AgentMessage) string

+ func GetCacheTTL(cfg MoaConfig) string

+ func GetMaxRunDuration(cfg MoaConfig) time.Duration

+ func GetSTTLanguage(cfg MoaConfig) string

+ func GetSTTModel(cfg MoaConfig) string

+ func GetSubagentMaxRunDuration(cfg MoaConfig) time.Duration

+ func ImageDimensions(data []byte) (width, height int)

+ func ImageExceedsMaxDimension(b64 string) (width, height int, exceeds bool)

+ func IsAutoVerifyEnabled(cfg MoaConfig) bool

+ func IsMCPPathTrusted(cfg MoaConfig, path string) bool

+ func IsMemoryEnabled(cfg MoaConfig) bool

+ func IsPersistentShellEnabled(cfg MoaConfig) bool

+ func IsProjectPathTrusted(cfg MoaConfig, path string) bool

+ func IsUpdateCheckEnabled(cfg MoaConfig) bool

+ func IsValidThinkingLevel(level string) bool

+ func LoadMCPFile(path string) (map[string]MCPServer, error)

+ func MergeMCPServers(maps ...map[string]MCPServer) map[string]MCPServer

+ func NativeDocBytes(content []Content) int64

+ func NewMsgID() string

+ func NewSteerID() string

+ func ProviderSupportsDocuments(p Provider) bool

+ func RegisterOrLog(reg *Registry, t Tool)

+ func ReservedToolName(name string) bool

+ func ResolveMaxOutputTokens(model Model, requested *int) int

+ func ResolvePathScope(pathScope string, disableSandbox bool, permMode string) string

+ func SaveGlobalConfig(update func(*MoaConfig)) error

+ func SaveProjectConfig(cwd string, update func(*MoaConfig)) error

+ func SetMCPServerDisabled(cfg *MoaConfig, name string, disabled bool)

+ func ShouldCompact(contextTokens, contextWindow int, settings CompactionSettings) bool

+ func ThinkingLevelOptions() string

+ func ToolCallIDFromContext(ctx context.Context) string

+ func ValidateModelSpec(spec string) error

+ func WithAgentID(ctx context.Context, id string) context.Context

+ func WithToolCallID(ctx context.Context, id string) context.Context

+ type AgentEvent struct

+ Args map[string]any

+ AssistantEvent *AssistantEvent

+ AttachmentIDs []string

+ Compaction *CompactionPayload

+ Error error

+ IsError bool

+ Message AgentMessage

+ Messages []AgentMessage

+ MsgID string

+ Rejected bool

+ Result *Result

+ SteerID string

+ Text string

+ ToolCallID string

+ ToolName string

+ Type string

+ type AgentMessage struct

+ Custom map[string]any

+ func WrapMessage(m Message) AgentMessage

+ func (m AgentMessage) IsLLMMessage() bool

+ type AssistantEvent struct

+ ContentIndex int

+ Delta string

+ Error error

+ Message *Message

+ Partial *Message

+ PartialArgs map[string]any

+ RateLimit *RateLimit

+ ToolCallID string

+ ToolName string

+ Type string

+ func (e AssistantEvent) IsTerminal() bool

+ type CompactionPayload struct

+ FirstKeptMsgID string

+ ModifiedFiles []string

+ ReadFiles []string

+ Summary string

+ SummaryMsgID string

+ TokensAfter int

+ TokensBefore int

+ Usage *Usage

+ type CompactionSettings struct

+ CompactAt int

+ Enabled bool

+ KeepRecent int

+ ReserveTokens int

+ func (s CompactionSettings) EffectiveWindow(maxInput int) int

+ func (s CompactionSettings) MinCompactAt() int

+ type Content struct

+ Arguments map[string]any

+ AttachmentID string

+ AttachmentSize int64

+ Data string

+ Filename string

+ MimeType string

+ Redacted bool

+ Text string

+ TextSignature string

+ Thinking string

+ ThinkingSignature string

+ ToolCallID string

+ ToolCallItemID string

+ ToolName string

+ Type string

+ func CloneContent(in []Content) []Content

+ func DocumentContent(data, mime, filename string) Content

+ func ImageContent(data, mime string) Content

+ func TextContent(text string) Content

+ func ThinkingContent(text string) Content

+ func ToolCallContent(id, name string, args map[string]any) Content

+ func (c Content) Clone() Content

+ type ContextEstimate struct

+ OverheadTokens int

+ Tokens int

+ TrailingTokens int

+ UsageTokens int

+ func EstimateContextTokens(msgs []AgentMessage, systemPrompt string, toolSpecs []ToolSpec, ...) ContextEstimate

+ type DocumentCapableProvider interface

+ SupportsDocuments func() bool

+ type EmptyResponseError struct

+ Provider string

+ Usage *Usage

+ func (e *EmptyResponseError) Error() string

+ func (e *EmptyResponseError) Is(target error) bool

+ type ExecuteFunc func(ctx context.Context, params map[string]any, onUpdate func(Result)) (Result, error)

+ type LoadedMoaConfig struct

+ Config MoaConfig

+ MCPDisabled MCPDisableSources

+ func LoadMoaConfigResolved(cwd string) LoadedMoaConfig

+ type LockKeyFunc func(args map[string]any) string

+ type MCPDisablePolicy struct

+ Global map[string]struct{}

+ Project map[string]struct{}

+ Session map[string]struct{}

+ func NewMCPDisablePolicy(sources MCPDisableSources) MCPDisablePolicy

+ func (p MCPDisablePolicy) DisabledSet() map[string]bool

+ type MCPDisableResolution struct

+ Disabled bool

+ Scopes []MCPDisableScope

+ func ResolveMCPDisabled(name string, p MCPDisablePolicy) MCPDisableResolution

+ type MCPDisableScope string

+ const MCPScopeGlobal

+ const MCPScopeProject

+ const MCPScopeSession

+ type MCPDisableSources struct

+ Global []string

+ Project []string

+ ProjectTrusted bool

+ type MCPServer struct

+ Args []string

+ Command string

+ Env map[string]string

+ type Message struct

+ Content []Content

+ ErrorMessage string

+ IsError bool

+ Model string

+ MsgID string

+ Provider string

+ Role string

+ StopReason string

+ Timestamp int64

+ ToolCallID string

+ ToolName string

+ Usage *Usage

+ func NewToolResultMessage(toolCallID, toolName string, content []Content, isError bool) Message

+ func NewUserMessage(text string) Message

+ func NewUserMessageWithContent(content []Content) Message

+ func (m *Message) EnsureMsgID()

+ type MoaConfig struct

+ AllowedPaths []string

+ AutoVerify *bool

+ BraveAPIKey string

+ CacheTTL string

+ CodeReviewModel string

+ CodeReviewThinking string

+ DisableSandbox bool

+ DisabledMCPServers []string

+ MCPServers map[string]MCPServer

+ MaxBudget float64

+ MaxRunDurationStr string

+ MaxToolCallsPerTurn int

+ MaxTurns int

+ MemoryEnabled *bool

+ PathScope string

+ Permissions PermissionsConfig

+ PersistentShell *bool

+ PinnedModels []string

+ PlanReviewModel string

+ PlanReviewThinking string

+ STTLanguage string

+ STTModel string

+ STTVocabulary []string

+ SubagentMaxConcurrent int

+ SubagentMaxRunDuration string

+ SubagentMaxTurns int

+ TrustedMCPPaths []string

+ TrustedProjectPaths []string

+ UpdateCheck *bool

+ func LoadGlobalConfig() MoaConfig

+ func LoadMoaConfig(cwd string) MoaConfig

+ type Model struct

+ API string

+ ID string

+ MaxInput int

+ MaxOutput int

+ Name string

+ Pricing *Pricing

+ Provider string

+ func ResolveModel(spec string) (Model, bool)

+ type ModelEntry struct

+ Alias string

+ Model Model

+ func ListModels() []ModelEntry

+ type PermissionsConfig struct

+ Allow []string

+ Deny []string

+ Mode string

+ Model string

+ Rules []string

+ type Pricing struct

+ CacheRead float64

+ CacheWrite float64

+ Input float64

+ Output float64

+ Tiers []PricingTier

+ func (p *Pricing) Cost(u Usage) float64

+ type PricingTier struct

+ CacheRead float64

+ CacheWrite float64

+ Input float64

+ Output float64

+ Threshold int

+ type Provider interface

+ Stream func(ctx context.Context, req Request) (<-chan AssistantEvent, error)

+ type ProviderUnwrapper interface

+ Unwrap func() Provider

+ type QuotaExceededError struct

+ Message string

+ PlanType string

+ Provider string

+ ResetsAt time.Time

+ ResetsIn time.Duration

+ Window string

+ func AsQuotaExceeded(err error) (*QuotaExceededError, bool)

+ func (e *QuotaExceededError) Error() string

+ func (e *QuotaExceededError) Is(target error) bool

+ type RateLimit struct

+ FiveHourUtil float64

+ OverageStatus string

+ OverageUtil float64

+ RepresentativeClaim string

+ SevenDayUtil float64

+ Status string

+ func (r RateLimit) OnOverage() bool

+ type Registry struct

+ func NewRegistry() *Registry

+ func (r *Registry) All() []Tool

+ func (r *Registry) Count() int

+ func (r *Registry) Get(name string) (Tool, bool)

+ func (r *Registry) Register(t Tool) error

+ func (r *Registry) Specs() []ToolSpec

+ func (r *Registry) Unregister(name string)

+ func (r *Registry) WithInternalTools(internal ...Tool) (*Registry, error)

+ type Request struct

+ Messages []Message

+ Model Model

+ Options StreamOptions

+ System string

+ Tools []ToolSpec

+ type Result struct

+ Content []Content

+ Custom map[string]any

+ IsError bool

+ func ErrorResult(msg string) Result

+ func TextResult(text string) Result

+ type SteerItem struct

+ Command string

+ Content []Content

+ ID string

+ Internal bool

+ Text string

+ func (it SteerItem) IsBarrier() bool

+ type StreamOptions struct

+ APIKey string

+ CacheRetention string

+ MaxTokens *int

+ Temperature *float64

+ ThinkingLevel string

+ type Tool struct

+ Description string

+ Effect ToolEffect

+ Execute ExecuteFunc

+ Label string

+ LockKey LockKeyFunc

+ Name string

+ Parameters json.RawMessage

+ func (t Tool) Spec() ToolSpec

+ type ToolCallDecision struct

+ Block bool

+ Kind string

+ Reason string

+ type ToolEffect int

+ const EffectInteractive

+ const EffectReadOnly

+ const EffectShell

+ const EffectUnknown

+ const EffectWritePath

+ type ToolSpec struct

+ Description string

+ Name string

+ Parameters json.RawMessage

+ type TranscribeOptions struct

+ Language string

+ Model string

+ Prompt string

+ type Transcriber interface

+ Transcribe func(ctx context.Context, audio io.Reader, filename string, opts TranscribeOptions) (string, error)

+ type Usage struct

+ CacheRead int

+ CacheWrite int

+ Input int

+ Output int

+ TotalTokens int

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