Function ResolveSources

pkg/config/resolve.go:61–80

ResolveSources resolves an agent file reference (local file, URL, or OCI image) to sources. If envProvider is non-nil, it will be used to look up GITHUB_TOKEN for authentication when fetching from GitHub URLs. For OCI references, always checks remote for updates but falls back to local cache if offl

(agentsPath string, envProvider environment.Provider)

// when fetching from GitHub URLs.
// For OCI references, always checks remote for updates but falls back to local cache if offline.
func ResolveSources(agentsPath string, envProvider environment.Provider) (Sources, error) {
	resolvedPath, err := resolve(agentsPath)
	if err != nil {
		// resolve() only fails for non-OCI, non-URL, non-builtin references
		// that can't be made absolute. Try OCI as last resort.
		if IsOCIReference(agentsPath) {
			return singleSource(reference.OciRefToFilename(agentsPath), NewOCISource(agentsPath)), nil
		}
		return nil, err
	}

	// Only directories need special handling to enumerate YAML files.
	if dirExists(resolvedPath) {
		return resolveDirectory(resolvedPath, envProvider)
	}

	// For all other reference types, delegate to resolveOne.
	key, source := resolveOne(resolvedPath, envProvider)
	return singleSource(key, source), nil
}

// Resolve resolves an agent file reference (local file, URL, or OCI image) to a source.
// If envProvider is non-nil, it will be used to look up GITHUB_TOKEN for authentication