Documentation
¶
Overview ¶
Package config loads Peen's deployment configuration from PEEN_ variables.
Index ¶
Constants ¶
This section is empty.
Variables ¶
View Source
var ( // ErrInvalidConfig reports invalid deployment configuration. ErrInvalidConfig = errors.New("invalid Peen configuration") // ErrInvalidUpstream reports malformed named LLM provider configuration. ErrInvalidUpstream = errors.New("invalid Peen upstream") )
Functions ¶
This section is empty.
Types ¶
type CompactionMode ¶
type CompactionMode string
CompactionMode determines how Peen handles an over-budget transcript.
const ( CompactionModeDropOldest CompactionMode = "drop-oldest" CompactionModeSummarize CompactionMode = "summarize" )
type Config ¶
type Config struct {
ConfigDirectory string `env:"PEEN_CONFIG_DIR,required"`
WorkingDirectory string
Agent string `default:"default" env:"PEEN_AGENT"`
UpstreamsJSON string `env:"PEEN_UPSTREAMS,required"`
DefaultModel string `env:"PEEN_DEFAULT_MODEL,required"`
CompactionModel string `env:"PEEN_COMPACTION_MODEL"`
MaxContextTokens int `default:"32768" env:"PEEN_MAX_CONTEXT_TOKENS"` //nolint:lll // Immutable env tag.
CompactionMode CompactionMode `default:"drop-oldest" env:"PEEN_COMPACTION_MODE"` //nolint:lll // Immutable env tag.
CompactionOutputTokens int `default:"2048" env:"PEEN_COMPACTION_MAX_OUTPUT_TOKENS"` //nolint:lll // Immutable env tag.
CompactionTimeout time.Duration `default:"2m" env:"PEEN_COMPACTION_TIMEOUT"` //nolint:lll // Immutable env tag.
TurnTimeout time.Duration `default:"10m" env:"PEEN_TURN_TIMEOUT"` //nolint:lll // Immutable env tag.
// MaxConcurrentTurns bounds how many turns may run at once across every
// session in this process, unlike MaxConcurrentAgentRunsPerSession, which
// only bounds one session's child-agent runs.
MaxConcurrentTurns int `default:"16" env:"PEEN_MAX_CONCURRENT_TURNS"` //nolint:lll // Immutable env tag.
// MaxQueuedUserMessages bounds messages accepted while a session has a
// running turn. They are delivered at an eligible provider round boundary.
MaxQueuedUserMessages int `default:"16" env:"PEEN_MAX_QUEUED_USER_MESSAGES"` //nolint:lll // Immutable env tag.
// MaxMessageBytes bounds the caller-supplied "message" field in a
// message.send event. MaxSystemPromptBytes bounds its optional
// "systemPrompt.content" field. MaxStoredMessageBytes bounds any single
// message row, of any role, before it is written to the durable
// transcript, since a stored assistant or tool message is not otherwise
// bounded by a caller-facing setting.
MaxMessageBytes int `default:"262144" env:"PEEN_MAX_MESSAGE_BYTES"` //nolint:lll // Immutable env tag.
MaxSystemPromptBytes int `default:"65536" env:"PEEN_MAX_SYSTEM_PROMPT_BYTES"` //nolint:lll // Immutable env tag.
MaxStoredMessageBytes int `default:"1048576" env:"PEEN_MAX_STORED_MESSAGE_BYTES"` //nolint:lll // Immutable env tag.
MaxToolRounds int `default:"32" env:"PEEN_MAX_TOOL_ROUNDS"` //nolint:lll // Immutable env tag.
MaxConcurrentTools int `default:"4" env:"PEEN_MAX_CONCURRENT_TOOLS"` //nolint:lll // Immutable env tag.
ToolTimeout time.Duration `default:"15m" env:"PEEN_TOOL_TIMEOUT"` //nolint:lll // Immutable env tag.
MaxToolResultTokens int `default:"8192" env:"PEEN_MAX_TOOL_RESULT_TOKENS"` //nolint:lll // Immutable env tag.
EnableWorkspaceHooks bool `default:"false" env:"PEEN_ENABLE_WORKSPACE_HOOKS"` //nolint:lll // Immutable env tag.
HookCommandTimeout time.Duration `default:"30s" env:"PEEN_HOOK_COMMAND_TIMEOUT"` //nolint:lll // Immutable env tag.
MaxHookCommandOutput int `default:"65536" env:"PEEN_MAX_HOOK_COMMAND_OUTPUT"` //nolint:lll // Immutable env tag.
ToolMaxListEntries int `default:"1000" env:"PEEN_TOOL_MAX_LIST_ENTRIES"` //nolint:lll // Immutable env tag.
ToolMaxListDepth int `default:"16" env:"PEEN_TOOL_MAX_LIST_DEPTH"` //nolint:lll // Immutable env tag.
ToolMaxSearchMatches int `default:"200" env:"PEEN_TOOL_MAX_SEARCH_MATCHES"` //nolint:lll // Immutable env tag.
ToolMaxSearchFileBytes int64 `default:"2097152" env:"PEEN_TOOL_MAX_SEARCH_FILE_BYTES"` //nolint:lll // Immutable env tag.
ToolMaxReadBytes int `default:"262144" env:"PEEN_TOOL_MAX_READ_BYTES"` //nolint:lll // Immutable env tag.
ToolMaxReadLines int `default:"2000" env:"PEEN_TOOL_MAX_READ_LINES"` //nolint:lll // Immutable env tag.
ToolMaxWriteBytes int `default:"4194304" env:"PEEN_TOOL_MAX_WRITE_BYTES"` //nolint:lll // Immutable env tag.
ToolMaxEdits int `default:"64" env:"PEEN_TOOL_MAX_EDITS"` //nolint:lll // Immutable env tag.
ToolMaxDiffBytes int `default:"65536" env:"PEEN_TOOL_MAX_DIFF_BYTES"` //nolint:lll // Immutable env tag.
ToolMaxRemoveEntries int `default:"20000" env:"PEEN_TOOL_MAX_REMOVE_ENTRIES"` //nolint:lll // Immutable env tag.
ToolMaxCommandOutputBytes int `default:"65536" env:"PEEN_TOOL_MAX_COMMAND_OUTPUT_BYTES"` //nolint:lll // Immutable env tag.
ToolCommandTimeout time.Duration `default:"2m" env:"PEEN_TOOL_COMMAND_TIMEOUT"` //nolint:lll // Immutable env tag.
ToolMaxCommandTimeout time.Duration `default:"15m" env:"PEEN_TOOL_MAX_COMMAND_TIMEOUT"` //nolint:lll // Immutable env tag.
MaxPendingEvents int `default:"256" env:"PEEN_MAX_PENDING_EVENTS"` //nolint:lll // Immutable env tag.
MaxEventSummaryBytes int `default:"4096" env:"PEEN_MAX_EVENT_SUMMARY_BYTES"` //nolint:lll // Immutable env tag.
MaxEventDataBytes int `default:"65536" env:"PEEN_MAX_EVENT_DATA_BYTES"` //nolint:lll // Immutable env tag.
MaxEventWakesPerHour int `default:"60" env:"PEEN_MAX_EVENT_WAKES_PER_HOUR"` //nolint:lll // Immutable env tag.
MaxChildAgentDepth int `default:"3" env:"PEEN_MAX_CHILD_AGENT_DEPTH"` //nolint:lll // Immutable env tag.
MaxChildAgentTurns int `default:"16" env:"PEEN_MAX_CHILD_AGENT_TURNS"` //nolint:lll // Immutable env tag.
MaxConcurrentAgentRunsPerSession int `default:"4" env:"PEEN_MAX_CONCURRENT_AGENT_RUNS"` //nolint:lll // Immutable env tag.
MaxAgentRunEventCount int `default:"2000" env:"PEEN_MAX_AGENT_RUN_EVENT_COUNT"` //nolint:lll // Immutable env tag.
MaxAgentRunEventBytes int `default:"65536" env:"PEEN_MAX_AGENT_RUN_EVENT_BYTES"` //nolint:lll // Immutable env tag.
MaxAdHocAgentInstructionBytes int `default:"65536" env:"PEEN_MAX_ADHOC_AGENT_INSTRUCTION_BYTES"` //nolint:lll // Immutable env tag.
HTTPListenAddress string `default:":8080" env:"PEEN_HTTP_LISTEN_ADDRESS"` //nolint:lll // Immutable env tag.
MetricsListenAddress string `default:"127.0.0.1:9090" env:"PEEN_METRICS_LISTEN_ADDRESS"` //nolint:lll // Immutable env tag.
APIToken string `env:"PEEN_API_TOKEN"`
}
Config is the deployment-owned configuration. Provider credentials stay in individually named environment variables, never inside PEEN_UPSTREAMS.
type ProviderType ¶
type ProviderType string
ProviderType selects an Elelem driver implementation.
const ( ProviderTypeOpenAI ProviderType = "openai" ProviderTypeAnthropic ProviderType = "anthropic" ProviderTypeZAICoding ProviderType = "zai-coding" )
type Upstream ¶
type Upstream struct {
Name string `json:"name"`
Provider ProviderType `json:"provider"`
BaseURL string `json:"baseUrl"`
APIKeyEnv string `json:"apiKeyEnv"`
}
Upstream configures one deployment-owned named provider. The name is Peen's stable prefix in qualified model references such as aigate/model-name.
Click to show internal directories.
Click to hide internal directories.