config

package
v0.107.6-beta.2 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Oct 7, 2026 License: Apache-2.0 Imports: 22 Imported by: 0

Documentation

Index

Constants

View Source
const DefaultCompactModel = "model1"
View Source
const DefaultCompactPct = 50
View Source
const DefaultGoalMaxRounds = 100
View Source
const SecretCmdTimeout = 5 * time.Second
View Source
const SystemSeed = `` /* 5631-byte string literal not displayed */

Variables

This section is empty.

Functions

func BrainInstructions added in v0.103.0

func BrainInstructions() string

func BrainPath added in v0.103.0

func BrainPath() string

func Dir

func Dir() (string, error)

func Exists

func Exists() bool

func ExpandTemplate

func ExpandTemplate(v string) (string, error)

func IsWholeRef

func IsWholeRef(v string) bool

func LoadCatalogs

func LoadCatalogs() map[string]Catalog

func LogEvent

func LogEvent(op, detail string)

func MarkSetupDone

func MarkSetupDone()

func MigrateProjectDir added in v0.107.0

func MigrateProjectDir(project string) error

func Path added in v0.107.0

func Path() (string, error)

Path returns the default configuration file path.

func ProjectDir added in v0.107.0

func ProjectDir(project string) string

func ProjectGoalMaxRounds

func ProjectGoalMaxRounds(dir string) int

func ProjectID added in v0.103.0

func ProjectID(dir string) string

func ReadJSON

func ReadJSON(name string, v any) error

func ResolveEnvMap

func ResolveEnvMap(env map[string]string) (map[string]string, error)

func ResolveEnvMapContext added in v0.103.0

func ResolveEnvMapContext(ctx context.Context, env map[string]string) (map[string]string, error)

func ResolveHeader

func ResolveHeader(v string) (string, error)

func ResolveHeaderContext added in v0.103.0

func ResolveHeaderContext(ctx context.Context, v string) (string, error)

func ResolveSecret

func ResolveSecret(v string) (string, error)

func ResolveSecretContext added in v0.103.0

func ResolveSecretContext(ctx context.Context, v string) (string, error)

func SaveCatalogs

func SaveCatalogs(cats map[string]Catalog) error

func SetProjectGoalMaxRounds

func SetProjectGoalMaxRounds(dir string, n int) error

func SetupDone

func SetupDone() bool

func SystemInstructions added in v0.106.0

func SystemInstructions() string

func SystemPath added in v0.106.0

func SystemPath() string

func Trust

func Trust(dir string) error

func Trusted

func Trusted(dir string) bool

func TrustedPath added in v0.103.0

func TrustedPath() (string, error)

func UserDir added in v0.107.0

func UserDir() (string, error)

func WriteJSON

func WriteJSON(name string, v any) error

Types

type BrowserConfig

type BrowserConfig struct {
	Mode string `json:"mode,omitempty"`

	CDPURL string `json:"cdpUrl,omitempty"`

	AllowPrivateURLs bool `json:"allowPrivateUrls,omitempty"`

	Enabled *bool `json:"enabled,omitempty"`
}

type Catalog

type Catalog struct {
	FetchedAt time.Time       `json:"fetchedAt"`
	BaseURL   string          `json:"baseUrl"`
	Models    []ModelInfoLite `json:"models"`
}

func (Catalog) ContextLength

func (c Catalog) ContextLength(id string) int

func (Catalog) Efforts

func (c Catalog) Efforts(id string) []string

func (Catalog) Find

func (c Catalog) Find(id string) *ModelInfoLite

func (Catalog) MaxCompletionTokens

func (c Catalog) MaxCompletionTokens(id string) int

func (Catalog) Pricing

func (c Catalog) Pricing(id string) (ai.TokenRates, bool)

func (Catalog) Stale

func (c Catalog) Stale() bool

func (Catalog) SupportsVision

func (c Catalog) SupportsVision(id string) (vision, found bool)

type ComputerConfig

type ComputerConfig struct {
	Backend        string   `json:"backend,omitempty"`
	Command        []string `json:"command,omitempty"`
	ApprovalPolicy string   `json:"approvalPolicy,omitempty"`

	Allow []string `json:"allow,omitempty"`

	Deny []string `json:"deny,omitempty"`

	DefaultDeny *bool `json:"defaultDeny,omitempty"`

	Enabled *bool `json:"enabled,omitempty"`
}

type Config

type Config struct {
	Language        string `json:"language,omitempty"`
	DefaultModel    string `json:"defaultModel"`
	DefaultProvider string `json:"defaultProvider,omitempty"`
	DefaultEffort   string `json:"defaultEffort,omitempty"`
	CompactModel    string `json:"compactModel,omitempty"`
	CompactProvider string `json:"compactProvider,omitempty"`
	CompactPct      int    `json:"compactPct,omitempty"`
	TaskModel       string `json:"taskModel,omitempty"`
	TaskProvider    string `json:"taskProvider,omitempty"`
	Theme           string `json:"theme,omitempty"`
	Mouse           *bool  `json:"mouse,omitempty"`
	Thinking        *bool  `json:"thinking,omitempty"`
	CollapsePaste   *bool  `json:"collapsePaste,omitempty"`
	GoalMaxRounds   int    `json:"goalMaxRounds,omitempty"`

	WorktreeSubagents *bool `json:"worktreeSubagents,omitempty"`
	MaxRetries        int   `json:"maxRetries,omitempty"`

	Experimental []string            `json:"experimental,omitempty"`
	Providers    map[string]Provider `json:"providers"`

	Models map[string]Model `json:"-"`

	MCPServers map[string]MCPServer `json:"mcp,omitempty"`

	LSPServers map[string]LSPServer `json:"lsp,omitempty"`

	Browser BrowserConfig `json:"browser,omitzero"`

	Computer ComputerConfig    `json:"computer,omitzero"`
	Sandbox  SandboxConfig     `json:"sandbox,omitzero"`
	Hooks    map[string][]Hook `json:"hooks,omitempty"`
	// contains filtered or unexported fields
}

func Default

func Default() *Config

func Load

func Load() (*Config, error)

func LoadFile added in v0.107.0

func LoadFile(path string) (*Config, error)

LoadFile reads a configuration without changing the user's default file.

func (*Config) RemoveProvider

func (c *Config) RemoveProvider(name string)

func (*Config) Resolve

func (c *Config) Resolve(model, provider string) (Provider, Model, string, error)

func (*Config) Save

func (c *Config) Save() error

func (*Config) SaveFile added in v0.107.0

func (c *Config) SaveFile(filename string) error

SaveFile atomically replaces the explicit backend configuration, including an empty catalog.

func (*Config) Snapshot

func (c *Config) Snapshot() *Config

type CustomHeader added in v0.107.0

type CustomHeader struct {
	Key   string `json:"key"`
	Value string `json:"value"`
}

type Hook added in v0.103.0

type Hook struct {
	Command string `json:"command"`
	Shell   string `json:"shell,omitempty"`
	Timeout int    `json:"timeout,omitempty"`
}

type LSPServer

type LSPServer struct {
	Command     []string          `json:"command,omitempty"`
	Extensions  []string          `json:"extensions,omitempty"`
	RootMarkers []string          `json:"rootMarkers,omitempty"`
	Env         map[string]string `json:"env,omitempty"`
	Enabled     *bool             `json:"enabled,omitempty"`
}

type MCPServer

type MCPServer struct {
	Command        []string          `json:"command,omitempty"`
	Env            map[string]string `json:"env,omitempty"`
	Cwd            string            `json:"cwd,omitempty"`
	URL            string            `json:"url,omitempty"`
	Headers        map[string]string `json:"headers,omitempty"`
	Enabled        *bool             `json:"enabled,omitempty"`
	Note           string            `json:"note,omitempty"`
	StartupTimeout int               `json:"startupTimeout,omitempty"`
	ToolTimeout    int               `json:"toolTimeout,omitempty"`
}

type Model

type Model struct {
	Name            string   `json:"name,omitempty"`
	DisplayName     string   `json:"displayName,omitempty"`
	OwnedBy         string   `json:"ownedBy,omitempty"`
	LimitsSource    string   `json:"limitsSource,omitempty"`
	InputModalities []string `json:"inputModalities,omitempty"`
	Providers       []string `json:"providers"`
	ID              string   `json:"id,omitempty"`

	Context int `json:"context,omitempty"`

	MaxOut int `json:"maxOut,omitempty"`

	Vision bool `json:"vision,omitempty"`

	SamplingParams *SamplingParams `json:"samplingParams,omitempty"`
}

func (Model) ContextWindow

func (m Model) ContextWindow() int

type ModelInfoLite

type ModelInfoLite struct {
	ID                  string         `json:"id"`
	ContextLength       int            `json:"contextLength,omitempty"`
	MaxCompletionTokens int            `json:"maxCompletionTokens,omitempty"`
	ReasoningEfforts    []string       `json:"reasoningEfforts,omitempty"`
	Pricing             *ai.TokenRates `json:"pricing,omitempty"`
	InputModalities     []string       `json:"inputModalities,omitempty"`
}

type PiModel

type PiModel struct {
	ID              string          `json:"id"`
	Name            string          `json:"name,omitempty"`
	DisplayName     string          `json:"displayName,omitempty"`
	OwnedBy         string          `json:"ownedBy,omitempty"`
	LimitsSource    string          `json:"limitsSource,omitempty"`
	InputModalities []string        `json:"inputModalities,omitempty"`
	API             string          `json:"api,omitempty"`
	Reasoning       bool            `json:"reasoning,omitempty"`
	Input           []string        `json:"input,omitempty"`
	ContextWindow   int             `json:"contextWindow,omitempty"`
	MaxTokens       int             `json:"maxTokens,omitempty"`
	SamplingParams  *SamplingParams `json:"samplingParams,omitempty"`
}

type PromptFile added in v0.106.0

type PromptFile struct {
	Scope string
	Path  string
	Text  string
}

func ProjectPromptFiles added in v0.106.0

func ProjectPromptFiles(wd string) []PromptFile

type Provider

type Provider struct {
	Name                   string         `json:"name,omitempty"`
	Type                   string         `json:"type,omitempty"`
	BaseURL                string         `json:"baseUrl"`
	IsFullURL              bool           `json:"isFullUrl,omitempty"`
	ModelsURL              string         `json:"modelsUrl,omitempty"`
	API                    string         `json:"api"`
	APIKey                 string         `json:"apiKey"`
	CustomHeaders          []CustomHeader `json:"customHeaders,omitempty"`
	ActiveModels           []string       `json:"activeModels"`
	ModelOrder             []string       `json:"modelOrder,omitempty"`
	RequestFormat          string         `json:"requestFormat,omitempty"`
	Reasoning              string         `json:"reasoning,omitempty"`
	PromptCacheHintMode    string         `json:"promptCacheHintMode,omitempty"`
	NativeWebSearchEnabled bool           `json:"nativeWebSearchEnabled,omitempty"`
	UseSystemProxy         bool           `json:"useSystemProxy,omitempty"`
	Metadata               map[string]any `json:"metadata,omitempty"`
	PromptCachingEnabled   *bool          `json:"promptCachingEnabled,omitempty"`
	PromptCacheRetention   string         `json:"promptCacheRetention,omitempty"`
	RetryPolicy            map[string]any `json:"retryPolicy,omitempty"`
	UsageQuery             map[string]any `json:"usageQuery,omitempty"`
	CacheSessionAffinity   *bool          `json:"cacheSessionAffinity,omitempty"`
	CacheControlFormat     string         `json:"cacheControlFormat,omitempty"`

	Models []PiModel `json:"models"`
}

func (Provider) Key

func (p Provider) Key() string

func (Provider) ModelActive added in v0.107.0

func (p Provider) ModelActive(id string) bool

func (Provider) ResolveKey

func (p Provider) ResolveKey() (string, error)

func (Provider) ResolveKeyContext added in v0.103.0

func (p Provider) ResolveKeyContext(ctx context.Context) (string, error)

type SamplingParams

type SamplingParams struct {
	Temperature *float64 `json:"temperature,omitempty"`
	TopP        *float64 `json:"top_p,omitempty"`
}

type SandboxConfig added in v0.103.0

type SandboxConfig struct {
	Mode     string   `json:"mode,omitempty"`
	Backend  string   `json:"backend,omitempty"`
	Network  *bool    `json:"network,omitempty"`
	Writable []string `json:"writable,omitempty"`
	ReadOnly []string `json:"readOnly,omitempty"`
}

func (SandboxConfig) Policy added in v0.103.0

func (s SandboxConfig) Policy(root string) *sandbox.Policy

type UnknownModelError

type UnknownModelError struct {
	Model string
	// contains filtered or unexported fields
}

func (*UnknownModelError) Error

func (e *UnknownModelError) Error() string

Jump to

Keyboard shortcuts

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