Function ParseModelIdentifier

pkg/workflow/model_identifier.go:162–226

ParseModelIdentifier parses a model identifier string into its components. The identifier format follows the ABNF grammar in Section 4.1 of the spec. Returns a non-nil *ParsedModelIdentifier on success. Returns an error (satisfying V-MAF-001 and V-MAF-006) on syntax violations.

(s string)

// Returns a non-nil *ParsedModelIdentifier on success.
// Returns an error (satisfying V-MAF-001 and V-MAF-006) on syntax violations.
func ParseModelIdentifier(s string) (*ParsedModelIdentifier, error) {
	modelIdentifierLog.Printf("Parsing model identifier: %q", s)
	if s == "" {
		return nil, errors.New("model identifier must not be empty")
	}

	// Split on the first "?" to separate base from query string.
	base, rawQuery, _ := strings.Cut(s, "?")

	p := &ParsedModelIdentifier{
		Raw:    s,
		Base:   base,
		Params: map[string]string{},
	}

	// ── Validate base identifier ─────────────────────────────────────────────
	if strings.Contains(base, "/") {
		// Provider-scoped or glob pattern.
		provider, modelPart, _ := strings.Cut(base, "/")

		if err := validateProviderToken(provider); err != nil {
			modelIdentifierLog.Printf("Invalid provider token %q: %v", provider, err)
			return nil, err
		}

		p.Provider = provider

		if strings.Contains(modelPart, "*") {
			// Glob pattern.
			modelIdentifierLog.Printf("Parsing as glob pattern: provider=%q model-glob=%q", provider, modelPart)
			if err := validateModelGlobToken(modelPart); err != nil {
				return nil, err
			}
			p.ModelToken = modelPart
			p.IsGlob = true
		} else {
			// Exact provider-scoped name.
			modelIdentifierLog.Printf("Parsing as provider-scoped: provider=%q model=%q", provider, modelPart)
			if err := validateModelToken(modelPart); err != nil {
				return nil, err
			}
			p.ModelToken = modelPart
		}
	} else {
		// Bare name.
		modelIdentifierLog.Printf("Parsing as bare name: %q", base)
		if err := validateBareName(base); err != nil {
			return nil, err
		}
	}

	// ── Parse and validate query string ─────────────────────────────────────
	if rawQuery != "" {
		modelIdentifierLog.Printf("Parsing query string: %q", rawQuery)
		params, err := parseQueryString(rawQuery)
		if err != nil {
			return nil, err
		}