Function ParseExternalAgentRef

pkg/config/resolve.go:278–300

ParseExternalAgentRef parses an external agent reference that may include an explicit name prefix. The syntax is "name:reference" where name is a simple identifier (no slashes) and reference is an OCI reference or URL. If no explicit name is provided, the base name is derived from the reference: -

(input string)

//	ParseExternalAgentRef("docker.io/myorg/myagent:v1") → ("myagent", "docker.io/myorg/myagent:v1")
//	ParseExternalAgentRef("https://example.com/agent.yaml") → ("agent", "https://example.com/agent.yaml")
func ParseExternalAgentRef(input string) (agentName, ref string) {
	// If the whole input is already a valid external reference, derive the name
	// from it without trying to split on ":".
	if isExternalRef(input) {
		return externalRefBaseName(input), input
	}

	// Check for explicit "name:reference" syntax.
	// A name prefix is identified by not containing "/" (distinguishing it from
	// OCI references or URLs which always contain slashes).
	if i := strings.Index(input, ":"); i > 0 {
		candidate := input[:i]
		if !strings.Contains(candidate, "/") {
			remainder := input[i+1:]
			if isExternalRef(remainder) {
				return candidate, remainder
			}
		}
	}

	// Fallback: return input as both name and ref (for local agent names).
	return input, input
}

// isExternalRef is the core check for whether a string is an external reference.
// It is used by both IsExternalReference and ParseExternalAgentRef to avoid