Documentation
¶
Index ¶
- Constants
- func DefaultSubagentToolWhitelist() []string
- func DefaultToolBlacklist() []string
- func DumpResolvedYAML(basePath string, overlayPaths []string, opts DumpOptions) ([]byte, error)
- func LoadDocument(basePath string, overlayPaths ...string) (manager.Document, error)
- func MergeFromFiles(basePath string, overlayPaths ...string) ([]byte, error)
- func MergeYAML(base, overlay []byte) ([]byte, error)
- func RedactInstances(raw map[string]any)
- func ResolveFiles(basePath string, overlayPaths ...string) ([]byte, error)
- func ResolveYAML(interpDir string, base []byte, overlays ...[]byte) ([]byte, error)
- func ScaffoldToolsFragment(profile ToolProfile, opts ToolsScaffoldOptions) (map[string]any, error)
- func ScaffoldToolsYAML(profile ToolProfile, opts ToolsScaffoldOptions) ([]byte, error)
- func SplitOverlayPaths(spec string) []string
- type DumpOptions
- type ToolProfile
- type ToolsScaffoldOptions
Constants ¶
const ( DefaultBasePath = "config.base.yaml" DefaultOverlayPath = "config.yaml" DefaultRootID = "runner.default" )
Variables ¶
This section is empty.
Functions ¶
func DefaultSubagentToolWhitelist ¶ added in v0.1.11
func DefaultSubagentToolWhitelist() []string
DefaultSubagentToolWhitelist is the explicit in-process subagent tool surface. New tool plugins do not appear here until deliberately added.
func DefaultToolBlacklist ¶ added in v0.1.11
func DefaultToolBlacklist() []string
DefaultToolBlacklist excludes test, scripted, and alternate implementations from the main agent toolset.
func DumpResolvedYAML ¶ added in v0.1.18
func DumpResolvedYAML(basePath string, overlayPaths []string, opts DumpOptions) ([]byte, error)
DumpResolvedYAML loads and renders the effective config graph (merge, extends, prune, interpolate) and returns YAML bytes suitable for inspection.
func LoadDocument ¶
LoadDocument loads L0 base config and optional L1 overlays, prunes unreachable instances, then parses. Overlays apply in order, so a later one wins.
func MergeFromFiles ¶
MergeFromFiles is an alias for ResolveFiles.
func MergeYAML ¶
MergeYAML merges two instance graphs. When overlay changes use, the whole node is replaced; otherwise config and deps are deep-merged into the base node.
func RedactInstances ¶ added in v0.1.18
RedactInstances scrubs resolved config values that look like secrets. Credential refs such as env:OPENAI_API_KEY are kept so dumps stay debuggable.
func ResolveFiles ¶
ResolveFiles merges L0 with each L1 overlay in order and prunes instances unreachable from root. Chaining lets a capability stack live in one preset and a transport swap in another, instead of every preset restating the whole graph.
func ResolveYAML ¶
ResolveYAML merges base with each overlay in order, expands extends, interpolates string values, then prunes unreachable instances.
func ScaffoldToolsFragment ¶ added in v0.1.11
func ScaffoldToolsFragment(profile ToolProfile, opts ToolsScaffoldOptions) (map[string]any, error)
ScaffoldToolsFragment generates a pluginkit instance map for one tools/runtime profile.
func ScaffoldToolsYAML ¶ added in v0.1.11
func ScaffoldToolsYAML(profile ToolProfile, opts ToolsScaffoldOptions) ([]byte, error)
ScaffoldToolsYAML returns a YAML fragment for the given tools/runtime profile.
func SplitOverlayPaths ¶
SplitOverlayPaths parses a comma-separated overlay list, e.g. "presets/autonomous.yaml,presets/daemon.yaml".
Types ¶
type DumpOptions ¶ added in v0.1.18
type DumpOptions struct {
// Redact scrubs interpolated secrets while keeping credential refs (env:, file:).
Redact bool
}
DumpOptions controls resolved config output.
type ToolProfile ¶ added in v0.1.11
type ToolProfile string
ToolProfile selects which tools/runtime instance graph fragment to scaffold.
const ( ToolProfileDefault ToolProfile = "default" ToolProfileSubagent ToolProfile = "subagent" )
type ToolsScaffoldOptions ¶ added in v0.1.11
ToolsScaffoldOptions controls kind filtering when generating tool graphs.
Source Files