Documentation
¶
Index ¶
- Constants
- func DefaultAgentRoles() []string
- func DefaultAllowedRemoteResources() []string
- func PerRepoDefaultRoles() []string
- func ValidProviders() []string
- func ValidRoles() []string
- func ValidateAgentEntries(agents []AgentEntry, allowlist []string) error
- type AgentEntry
- type AgentEntryBuilder
- type AllowTargets
- type CommentNotificationConfig
- type CreateIssuesConfig
- type DispatchConfig
- type InferenceConfig
- type MergedAgent
- type OrgConfig
- type PerRepoConfig
- type RepoConfig
- type RepoDefaults
- type StatusNotificationConfig
Constants ¶
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 ValidateAgentEntries ¶ added in v0.25.0
func ValidateAgentEntries(agents []AgentEntry, allowlist []string) error
ValidateAgentEntries checks agent entries for structural correctness. Uses urlutil.IsURL, urlutil.ParseIntegrityHash, and urlutil.MatchingAllowedPrefixInList for consistency with runtime resolution (case-insensitive scheme, percent-decoding, dot-segment cleaning).
Types ¶
type AgentEntry ¶
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
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 MergedAgent ¶ added in v0.25.0
type MergedAgent struct {
Name string // canonical agent name
Source string // URL (with #sha256=), local path, or scaffold URL
IsConfig bool // true = from config agents list; false = scaffold default
}
MergedAgent represents an agent in the merged set produced by combining scaffold-discovered agents with config-registered agents. Config entries override scaffold entries with the same name (case-insensitive).
func LookupMergedAgent ¶ added in v0.25.0
func LookupMergedAgent(agents []MergedAgent, name string) *MergedAgent
LookupMergedAgent finds an agent by name (case-insensitive) in the merged set. Returns nil if not found.
func MergedAgents ¶ added in v0.25.0
func MergedAgents(scaffoldNames []string, commitSHA string, configAgents []AgentEntry, builder AgentEntryBuilder) ([]MergedAgent, error)
MergedAgents builds the merged agent set from scaffold defaults and config overlay. Scaffold entries are constructed from scaffoldNames using builder (typically scaffold.HarnessBaseURLWithHash); config entries overlay by DerivedName, replacing scaffold entries with matching names (case-insensitive). The result is sorted by Name.
When builder is nil or commitSHA is empty, scaffold entries are omitted (config-only mode). This mirrors the DefaultAgentEntries nil-builder pattern.
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 ¶
NewOrgConfig creates a new OrgConfig with sensible defaults.
func OrgConfigFromPerRepo ¶ added in v0.28.0
func OrgConfigFromPerRepo(pr *PerRepoConfig) *OrgConfig
OrgConfigFromPerRepo adapts a PerRepoConfig into an OrgConfig so callers that expect OrgConfig can work uniformly with both config formats. Shared fields and Roles (mapped to Defaults.Roles) are copied; OrgConfig-specific fields (Dispatch, Inference, Repos) remain zero-valued.
func ParseOrgConfig ¶
ParseOrgConfig parses YAML bytes into an OrgConfig.
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"`
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 ¶
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.