Documentation
¶
Overview ¶
Package compose orchestrates one composition end to end so the CLI stays a thin rendering layer over the same path the tests exercise.
Index ¶
- Constants
- func IsExternalOnlyError(err error) bool
- type Options
- type Result
- func Run(requestPath, outDir string) (*Result, error)
- func RunRoots(req *schema.Request, roots []RootSource, outDir string, opts Options) (*Result, error)
- func RunRootsWithMissing(req *schema.Request, roots []RootSource, missing []schema.MissingSource, ...) (*Result, error)
- func RunWithOptions(requestPath, outDir string, opts Options) (*Result, error)
- type RootSource
Constants ¶
const OmitReason = "the role's MCP scope omits the server this skill documents"
OmitReason is the trace wording for a skill dropped through OmitSkills.
Variables ¶
This section is empty.
Functions ¶
func IsExternalOnlyError ¶
IsExternalOnlyError reports whether composition failed after resolving an external-only policy. Launchers use it to prohibit unsafe fallback.
Types ¶
type Options ¶
type Options struct {
PersonPolicy string
PersonSource string
PersonalityLibraries []string
// OperatingBase is the host doctrine that leads the bundle's instructions,
// so a projected role no longer depends on a host-owned load point.
OperatingBase string
// OperatingAppendix is the configured tail, kept out of OperatingBase so the
// roster-card rewrite cannot reach it. agent-compose#6987.
OperatingAppendix string
}
type Result ¶
type Result struct {
Resolution *resolver.Resolution
Bundle *bundle.Result
ExternalOnly bool
}
func RunRoots ¶
func RunRoots( req *schema.Request, roots []RootSource, outDir string, opts Options, ) (*Result, error)
RunRoots composes trusted absolute provider roots selected by a host launcher without weakening the portable KDL path rules.
func RunRootsWithMissing ¶
func RunRootsWithMissing( req *schema.Request, roots []RootSource, missing []schema.MissingSource, outDir string, opts Options, ) (*Result, error)
RunRootsWithMissing preserves explicit provider exclusions in the resolver trace while composing the trusted roots that remain available.
type RootSource ¶
type RootSource struct {
ID string
Root string
Reason string
Scope string
Skills []string
BindingSkills []string
// Catalogue reads Root as a bare skills directory rather than a provider
// tree, which is what an org grant expands to.
Catalogue bool
// OmitSkills names ordinary skills to drop after selection, such as the
// tool reference of an MCP server the launch does not mount.
OmitSkills []string
}
RootSource names one trusted provider root selected by a host launcher.
func OrgRoots ¶
func OrgRoots( role string, sources []*schema.Source, set *catalogset.Set, ) ([]RootSource, error)
OrgRoots expands every org a role uses into one root per contributing catalogue, bounded by the org's selectors. See docs/skill-selectors.md.
Source Files