Documentation
¶
Index ¶
- func DefaultAgentRoles() []string
- func PerRepoDefaultRoles() []string
- func ValidProviders() []string
- func ValidRoles() []string
- type AgentEntry
- type AllowTargets
- type CommentNotificationConfig
- type CreateIssuesConfig
- type DispatchConfig
- type InferenceConfig
- type OrgConfig
- type PerRepoConfig
- type RepoConfig
- type RepoDefaults
- type StatusNotificationConfig
Constants ¶
This section is empty.
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 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.
Types ¶
type AgentEntry ¶
type AgentEntry struct {
Role string `yaml:"role"`
Name string `yaml:"name"`
Slug string `yaml:"slug"`
}
AgentEntry represents a configured agent with its role and app identity.
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"`
Agents []AgentEntry `yaml:"agents"`
Repos map[string]RepoConfig `yaml:"repos"`
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, agents []AgentEntry, inferenceProvider, org string) *OrgConfig
NewOrgConfig creates a new OrgConfig with sensible defaults.
func ParseOrgConfig ¶
ParseOrgConfig parses YAML bytes into an OrgConfig.
func (*OrgConfig) AgentSlugs ¶
AgentSlugs returns a map of role to slug from the configured agents.
func (*OrgConfig) DefaultRoles ¶
DefaultRoles returns the default roles configured for the organization.
func (*OrgConfig) DisabledRepos ¶ added in v0.0.3
DisabledRepos returns a sorted list of repo names where Enabled is false.
func (*OrgConfig) EnabledRepos ¶
EnabledRepos returns a sorted list of repo names where Enabled is true.
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"`
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 ¶
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.