Function Plan

internal/tools/configwriter.go:27–59

Plan resolves all placeholders and returns the ordered list of writes without touching disk. Used by --dry-run and Apply alike.

(tool Tool, endpoint providers.Endpoint, endpointName, model, apiKey string)

// Plan resolves all placeholders and returns the ordered list of writes
// without touching disk. Used by --dry-run and Apply alike.
func Plan(tool Tool, endpoint providers.Endpoint, endpointName, model, apiKey string) ([]PlannedWrite, error) {
	if tool.ConfigTarget == nil {
		return nil, nil
	}
	ct := tool.ConfigTarget

	out := make([]PlannedWrite, 0, len(ct.Upsert)+len(ct.Remove))

	// Upserts.
	for rawKey, rawValue := range ct.Upsert {
		// Never clobber an existing credential with a blank value: when a value
		// template is the API-key placeholder but no key is configured, skip the
		// write entirely so the agent's config keeps whatever token it already
		// has (writing "" would wipe a working key/token).
		if strings.Contains(rawValue, "{api_key}") && strings.TrimSpace(apiKey) == "" {
			continue
		}
		key := expandConfigPlaceholders(rawKey, endpoint, endpointName, model, apiKey)
		value := expandConfigPlaceholders(rawValue, endpoint, endpointName, model, apiKey)
		out = append(out, PlannedWrite{KeyPath: key, Value: coerceScalar(value), Op: "upsert"})
	}

	// Removes.
	for _, rawKey := range ct.Remove {
		key := expandConfigPlaceholders(rawKey, endpoint, endpointName, model, apiKey)
		out = append(out, PlannedWrite{KeyPath: key, Value: nil, Op: "remove"})
	}

	sort.Slice(out, func(i, j int) bool {
		return out[i].KeyPath < out[j].KeyPath
	})
	return out, nil
}

// expandConfigPlaceholders substitutes the five recognised placeholders. It
// is a superset of expandPlaceholders in launch.go (adds {endpoint_name} and