config

package

v0.2.1 Latest Latest Go to latest Published: Aug 6, 2026 License: MIT Imports: 11 Imported by: 0

Details

Valid go.mod file
Redistributable license
Tagged version
Stable version
Learn more about best practices

Repository

github.com/SecondStack-AI/SecondBox

Links

Open Source Insights

Documentation ¶

Overview ¶

Package config loads required standalone SecondBox process configuration.

Index ¶

Constants
func CategoryCEnvironmentNames() []string
type ApplicationAuthority
type Config
- func FromEnvironment() (Config, error)
type TuningDefault
- func TuningDefaults() []TuningDefault

Constants ¶

View Source

const (
	DefaultHTTPTimeoutSeconds                          int64 = 30
	DefaultRunnerHeartbeatIntervalMilliseconds         int64 = 5000
	DefaultRunnerHeartbeatTimeoutMilliseconds          int64 = 30000
	DefaultRunnerCommandDeliveryBatchSize              int64 = 16
	DefaultRunnerEventPersistenceBatchSize             int64 = 16
	DefaultRunnerEventPersistenceBatchWaitMilliseconds int64 = 2
	DefaultDataPlaneMaximumSessionBytes                int64 = 67108864
	DefaultIdempotencyRetentionSeconds                 int64 = 86400
	DefaultLifecycleReconcileBatchSize                 int64 = 8
	DefaultLifecycleReconcilePollIntervalMilliseconds  int64 = 250
	DefaultLifecycleReconcileClaimDurationMilliseconds int64 = 30000
	DefaultGarbageCollectionPollIntervalMilliseconds   int64 = 60000
	DefaultAssignmentClaimDurationMilliseconds         int64 = 30000
	DefaultAssignmentDeadlineMilliseconds              int64 = 120000
	DefaultAssignmentRetryLimit                        int64 = 2
	DefaultSchedulerSerializationRetryLimit            int64 = 3
	DefaultObjectStoreRetryMaxAttempts                 int64 = 3
	DefaultObjectStoreHTTPTimeoutMilliseconds          int64 = 30000
	DefaultObjectStoreMaxObjectBytes                   int64 = 10737418240
)

Code-owned tuning defaults. Each corresponding environment variable is an optional, validated override; these literals are the reviewed deployed values.

Variables ¶

This section is empty.

Functions ¶

func CategoryCEnvironmentNames ¶

func CategoryCEnvironmentNames() []string

Types ¶

type ApplicationAuthority ¶

type ApplicationAuthority struct {
	ID            string   `json:"id"`
	Token         string   `json:"token"`
	TenantRef     string   `json:"tenantRef"`
	SubjectRef    string   `json:"subjectRef"`
	Scopes        []string `json:"scopes"`
	ProfileGrants []string `json:"profileGrants"`
}

ApplicationAuthority configures one fixed application identity and its allowed capabilities.

type Config ¶

type Config struct {
	ListenAddress                    string
	PublicBaseURL                    string
	RunnerListenAddress              string
	DatabaseURL                      string
	LogPath                          string
	PlatformToken                    string
	ApplicationAuthorities           []ApplicationAuthority
	HTTPTimeout                      time.Duration
	RunnerServerCertificatePath      string
	RunnerServerPrivateKeyPath       string
	RunnerCACertificatePath          string
	RunnerCredential                 string
	RunnerHeartbeatInterval          time.Duration
	RunnerCommandPollInterval        time.Duration
	RunnerCommandDeliveryBatchSize   int64
	RunnerEventPersistenceBatchSize  int
	RunnerEventPersistenceBatchWait  time.Duration
	DataPlanePollInterval            time.Duration
	DataPlaneRetention               time.Duration
	DataPlaneMaximumSessionBytes     int64
	IdempotencyRetention             time.Duration
	LifecycleReconcileBatchSize      int
	LifecycleReconcilePollInterval   time.Duration
	LifecycleReconcileClaimDuration  time.Duration
	GarbageCollectionPollInterval    time.Duration
	AssignmentClaimDuration          time.Duration
	AssignmentDeadline               time.Duration
	RunnerHeartbeatTimeout           time.Duration
	AssignmentRetryLimit             int64
	SchedulerSerializationRetryLimit int
	SignedAssetCatalogPath           string
	ObjectStoreEndpoint              string
	ObjectStoreRegion                string
	ObjectStoreBucket                string
	ObjectStoreAccessKeyID           string
	ObjectStoreSecretAccessKey       string
	ObjectStoreUsePathStyle          bool
	ObjectStoreRetryMaxAttempts      int
	ObjectStoreHTTPTimeout           time.Duration
	ObjectStoreTempDirectory         string
	ObjectStoreMaxObjectBytes        int64
	RunnerEnabledFeatures            []string
	DefaultSubjectQuota              contracts.QuotaLimits
}

Config contains only explicitly configured control-plane settings.

func FromEnvironment ¶

func FromEnvironment() (Config, error)

FromEnvironment fails when any required setting is absent or invalid.

type TuningDefault ¶

type TuningDefault struct {
	Environment string
	Value       string
}

TuningDefault describes one optional control-plane environment override. TOML field ownership lives in internal/deployconfig; this registry exposes only the process contract and its compiled value.

func TuningDefaults ¶

func TuningDefaults() []TuningDefault

TuningDefaults returns the complete Category C surface in stable order.

Source Files ¶

View all Source files

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