config

package
v0.24.0 Latest Latest
Warning

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

Go to latest
Published: Jun 30, 2026 License: Apache-2.0 Imports: 8 Imported by: 0

Documentation

Index

Constants

View Source
const (
	// DefaultUpstreamRepo is the canonical fullsend repository for layered workflow calls.
	DefaultUpstreamRepo = "fullsend-ai/fullsend"
	// DefaultUpstreamRef is the default tag for layered upstream workflow calls.
	DefaultUpstreamRef = "v0"
	// DefaultGHRunner is the default GitHub Actions runner image for scaffold workflows.
	DefaultGHRunner = "ubuntu-24.04"
)

Variables

This section is empty.

Functions

func DefaultAgentRoles

func DefaultAgentRoles() []string

DefaultAgentRoles returns the standard set of agent roles installed when no custom roles are specified. The fix stage reuses the coder app (role: coder) so it does not need a separate app or PEM.

func DefaultAllowedRemoteResources added in v0.24.0

func DefaultAllowedRemoteResources() []string

DefaultAllowedRemoteResources returns the standard allowlist prefixes for base composition and agent registration URLs.

func PerRepoDefaultRoles added in v0.8.0

func PerRepoDefaultRoles() []string

PerRepoDefaultRoles returns agent roles for per-repo installation. The "fullsend" dispatch role is excluded because per-repo mode uses the target repo's shim workflow for dispatch instead of a separate app.

func ValidProviders added in v0.0.3

func ValidProviders() []string

ValidProviders returns the set of recognized inference providers.

func ValidRoles

func ValidRoles() []string

ValidRoles returns the set of recognized agent roles.

Types

type AgentEntry

type AgentEntry struct {
	Name   string `yaml:"name,omitempty"`
	Source string `yaml:"source"`
}

AgentEntry represents a registered agent source in config. It supports both string shorthand (just the source URL/path) and object form (with an explicit name override).

func DefaultAgentEntries added in v0.24.0

func DefaultAgentEntries(harnessNames []string, commitSHA string, builder AgentEntryBuilder) ([]AgentEntry, error)

DefaultAgentEntries returns agent entries for the given harness names, using builder to compute each URL. When builder is nil, it returns nil (for callers that don't have access to the scaffold package). Called by install/scaffold in Phase 2 (ADR 0058); defined here in Phase 1 so the type and validation are co-located.

func (AgentEntry) DerivedName added in v0.24.0

func (a AgentEntry) DerivedName() string

DerivedName returns the explicit Name if set, otherwise derives one from the Source filename (e.g. "triage.yaml" → "triage").

func (*AgentEntry) UnmarshalYAML added in v0.24.0

func (a *AgentEntry) UnmarshalYAML(value *yaml.Node) error

UnmarshalYAML implements yaml.Unmarshaler so that a plain string is treated as a source-only entry, while a mapping decodes normally. Old-format entries (role/name/slug identity tuples from pre-ADR-0058 config) are detected and rejected with a clear error message.

type AgentEntryBuilder added in v0.24.0

type AgentEntryBuilder func(harnessName, commitSHA string) (string, error)

DefaultAgentEntries computes default agent URL entries for the given harness names at a specific commit SHA. Each entry is a pinned raw.githubusercontent.com URL with an integrity hash.

type AllowTargets added in v0.18.0

type AllowTargets struct {
	Orgs  []string `yaml:"orgs,omitempty"`
	Repos []string `yaml:"repos,omitempty"`
}

AllowTargets defines which orgs and repos agents may create issues in.

type CommentNotificationConfig added in v0.15.0

type CommentNotificationConfig struct {
	Start      string `yaml:"start,omitempty"`
	Completion string `yaml:"completion,omitempty"`
}

CommentNotificationConfig controls start/completion comments. Valid values: "enabled" (default when parent is set), "disabled".

type CreateIssuesConfig added in v0.18.0

type CreateIssuesConfig struct {
	AllowTargets AllowTargets `yaml:"allow_targets"`
}

CreateIssuesConfig controls cross-repo issue creation by agents.

type DispatchConfig

type DispatchConfig struct {
	Platform string `yaml:"platform"`
	Mode     string `yaml:"mode,omitempty"`     // "oidc-mint"
	MintURL  string `yaml:"mint_url,omitempty"` // informational, set when mode=oidc-mint
}

DispatchConfig configures how agent work is dispatched.

type InferenceConfig added in v0.0.3

type InferenceConfig struct {
	Provider string `yaml:"provider"`
}

InferenceConfig configures the inference provider used by agents.

type OrgConfig

type OrgConfig struct {
	Version                string                `yaml:"version"`
	KillSwitch             bool                  `yaml:"kill_switch,omitempty"`
	Dispatch               DispatchConfig        `yaml:"dispatch"`
	Inference              InferenceConfig       `yaml:"inference,omitempty"`
	Defaults               RepoDefaults          `yaml:"defaults"`
	Repos                  map[string]RepoConfig `yaml:"repos"`
	Agents                 []AgentEntry          `yaml:"agents,omitempty"`
	AllowedRemoteResources []string              `yaml:"allowed_remote_resources,omitempty"`
	CreateIssues           *CreateIssuesConfig   `yaml:"create_issues,omitempty"`
}

OrgConfig is the top-level configuration for a fullsend organization.

func NewOrgConfig

func NewOrgConfig(allRepos, enabledRepos, roles []string, inferenceProvider, org string) *OrgConfig

NewOrgConfig creates a new OrgConfig with sensible defaults.

func ParseOrgConfig

func ParseOrgConfig(data []byte) (*OrgConfig, error)

ParseOrgConfig parses YAML bytes into an OrgConfig.

func (*OrgConfig) DefaultRoles

func (c *OrgConfig) DefaultRoles() []string

DefaultRoles returns the default roles configured for the organization.

func (*OrgConfig) DisabledRepos added in v0.0.3

func (c *OrgConfig) DisabledRepos() []string

DisabledRepos returns a sorted list of repo names where Enabled is false.

func (*OrgConfig) EnabledRepos

func (c *OrgConfig) EnabledRepos() []string

EnabledRepos returns a sorted list of repo names where Enabled is true.

func (*OrgConfig) Marshal

func (c *OrgConfig) Marshal() ([]byte, error)

Marshal serializes the OrgConfig to YAML with a descriptive header comment.

func (*OrgConfig) Validate

func (c *OrgConfig) Validate() error

Validate checks the OrgConfig for structural correctness.

type PerRepoConfig added in v0.8.0

type PerRepoConfig struct {
	Version                string              `yaml:"version"`
	KillSwitch             bool                `yaml:"kill_switch,omitempty"`
	Roles                  []string            `yaml:"roles,omitempty"`
	Agents                 []AgentEntry        `yaml:"agents,omitempty"`
	AllowedRemoteResources []string            `yaml:"allowed_remote_resources,omitempty"`
	CreateIssues           *CreateIssuesConfig `yaml:"create_issues,omitempty"`
}

PerRepoConfig holds configuration for per-repo installation mode. Stored in .fullsend/config.yaml within the target repository.

func NewPerRepoConfig added in v0.8.0

func NewPerRepoConfig(roles []string, targetRepo string) *PerRepoConfig

NewPerRepoConfig creates a new PerRepoConfig with the given roles.

func ParsePerRepoConfig added in v0.8.0

func ParsePerRepoConfig(data []byte) (*PerRepoConfig, error)

ParsePerRepoConfig parses YAML bytes into a PerRepoConfig.

func (*PerRepoConfig) Marshal added in v0.8.0

func (c *PerRepoConfig) Marshal() ([]byte, error)

Marshal serializes the PerRepoConfig to YAML with a descriptive header.

func (*PerRepoConfig) Validate added in v0.8.0

func (c *PerRepoConfig) Validate() error

Validate checks the PerRepoConfig for structural correctness.

type RepoConfig

type RepoConfig struct {
	Roles   []string `yaml:"roles,omitempty"`
	Enabled bool     `yaml:"enabled"`
}

RepoConfig holds per-repo configuration. StatusNotifications is intentionally absent here — notification style is an org-wide UX decision (consistent appearance across all repos), unlike roles and auto_merge which are operationally per-repo.

type RepoDefaults

type RepoDefaults struct {
	Roles                    []string                  `yaml:"roles"`
	MaxImplementationRetries int                       `yaml:"max_implementation_retries"`
	AutoMerge                bool                      `yaml:"auto_merge"`
	StatusNotifications      *StatusNotificationConfig `yaml:"status_notifications,omitempty"`
}

RepoDefaults holds default settings applied to all repos.

type StatusNotificationConfig added in v0.15.0

type StatusNotificationConfig struct {
	Comment CommentNotificationConfig `yaml:"comment,omitempty"`
}

StatusNotificationConfig controls status comments posted on issues/PRs when agents start and complete.

Jump to

Keyboard shortcuts

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