Method registerInlineEngineDefinition

pkg/workflow/engine_validation.go:267–307

registerInlineEngineDefinition registers an inline engine definition in the session catalog. If the runtime ID already exists in the catalog (e.g. a built-in), the existing display name and description are preserved while provider overrides are applied.

(config *EngineConfig)

// catalog. If the runtime ID already exists in the catalog (e.g. a built-in), the
// existing display name and description are preserved while provider overrides are applied.
func (c *Compiler) registerInlineEngineDefinition(config *EngineConfig) {
	def := &EngineDefinition{
		ID:          config.ID,
		RuntimeID:   config.ID,
		DisplayName: config.ID,
		Description: "Inline engine definition from workflow frontmatter",
	}

	// Preserve display name and description from existing built-in entry if available.
	if existing := c.engineCatalog.Get(config.ID); existing != nil {
		def.DisplayName = existing.DisplayName
		def.Description = existing.Description
		def.Models = existing.Models
		// Copy existing provider/auth as defaults; inline values below fully replace them
		// when present (replacement, not merge).
		def.Provider = existing.Provider
	}

	// Apply inline provider overrides.
	if config.InlineProviderID != "" {
		def.Provider = ProviderSelection{Name: config.InlineProviderID}
	}

	// Prefer the full AuthDefinition over the legacy simple-secret path.
	if config.InlineProviderAuth != nil {
		// Normalise strategy: treat empty strategy as api-key when a secret is set.
		auth := config.InlineProviderAuth
		if auth.Strategy == "" && auth.Secret != "" {
			auth.Strategy = AuthStrategyAPIKey
		}
		def.Provider.Auth = auth
	}

	if config.InlineProviderRequest != nil {
		def.Provider.Request = config.InlineProviderRequest
	}

	engineValidationLog.Printf("Registering inline engine definition in session catalog: id=%s, runtimeID=%s, providerID=%s",
		def.ID, def.RuntimeID, def.Provider.Name)
	c.engineCatalog.Register(def)
}

// validateEngineAuthDefinition validates AuthDefinition fields for an inline engine definition.
// Returns an error describing the first (or all, in non-fail-fast mode) validation problems found.