feat: add a new genai locator module (#298)

* chore: support the new genai endpoint format

* feat: add a new genai locator module

* chore: adding tests to mock out calls to config endpoin

* chore: correct the parameter passing of properties

Author: garethjevans

build.gradle

@@ -2,6 +2,7 @@ buildscript {
     ext {
         jmockitVersion = "1.49"
         springBootVersion = "3.4.3"
+        springAiVersion = "1.0.0"
     }
 }
 

gradle.properties

@@ -1,6 +1,6 @@
 org.gradle.parallel=true
 
 group=io.pivotal.cfenv
-version=3.4.0-SNAPSHOT
+version=3.5.0-SNAPSHOT
 onlyShowStandardStreamsOnTestFailure=false
 

java-cfenv-boot-tanzu-genai/README.md

@@ -0,0 +1,21 @@
+# Tanzu GenAI support
+
+This library is for use when accessing a Tanzu GenAI tile (version >= 10.2) configured plan with CF.  This library uses the `VCAP_SERVICES` environment data to set properties that will enable a GenAILocator.
+
+## Spring Applications
+
+Spring Applications can use this library to auto-configure a GenAILocator that can be used to determine which models/mcp servers are available, what capabilities they support and a method of accessing them.
+
+This service provides the following properties to your spring application:
+
+| Property Name            | Value                           |
+|--------------------------|---------------------------------|
+| genai.locator.config-url | config_url (from VCAP_SERVICES) |
+| genai.locator.api-base   | api_base (from VCAP_SERVICES)   |
+| genai.locator.api-key    | api_key (from VCAP_SERVICES)    |
+
+Please see the Sample Apps below for more information.
+
+### Sample Apps
+
+Sample apps using this library are available at TODO.

java-cfenv-boot-tanzu-genai/build.gradle

@@ -0,0 +1,25 @@
+plugins {
+    id 'io.pivotal.cfenv.java-conventions'
+}
+
+description = 'Java CF Env Tanzu GenAI'
+
+dependencies {
+    api project(':java-cfenv-boot')
+    api "org.springframework.ai:spring-ai-openai:${springAiVersion}"
+    implementation("org.springframework.boot:spring-boot-autoconfigure:${springBootVersion}")
+
+    testImplementation project(':java-cfenv-test-support')
+    testImplementation "junit:junit"
+    testImplementation "org.jmockit:jmockit:${jmockitVersion}"
+
+    testRuntimeOnly('org.junit.vintage:junit-vintage-engine') {
+        exclude group: 'org.hamcrest', module: 'hamcrest-core'
+    }
+}
+
+tasks.named('jar') {
+    manifest {
+        attributes 'Automatic-Module-Name': 'io.pivotal.cfenv.boot.genai'
+    }
+}

java-cfenv-boot-tanzu-genai/src/main/java/io/pivotal/cfenv/boot/genai/CfGenaiProcessor.java

@@ -0,0 +1,55 @@
+/*
+ * Copyright 2025 the original author or authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package io.pivotal.cfenv.boot.genai;
+
+import java.util.Map;
+
+import io.pivotal.cfenv.core.CfCredentials;
+import io.pivotal.cfenv.core.CfService;
+import io.pivotal.cfenv.spring.boot.CfEnvProcessor;
+import io.pivotal.cfenv.spring.boot.CfEnvProcessorProperties;
+
+/**
+ * Retrieve GenAI on Tanzu Platform properties from {@link CfCredentials} and
+ * set {@literal genai.locator.*} Boot properties.
+ *
+ * @author Gareth Evans
+ **/
+public class CfGenaiProcessor implements CfEnvProcessor {
+
+    @Override
+    public boolean accept(CfService service) {
+        boolean isGenAIService = service.existsByTagIgnoreCase("genai") || service.existsByLabelStartsWith("genai");
+        // we only want to process service instances that are generated from Tanzu Platform 10.2 or later
+        return (isGenAIService && service.getCredentials().getMap().containsKey("endpoint"));
+    }
+
+    @Override
+    public void process(CfCredentials cfCredentials, Map<String, Object> properties) {
+        Map<String, Object> endpoint = (Map<String, Object>)cfCredentials.getMap().get("endpoint");
+
+        properties.put("genai.locator.config-url", endpoint.get("config_url"));
+        properties.put("genai.locator.api-key", endpoint.get("api_key"));
+        properties.put("genai.locator.api-base", endpoint.get( "api_base"));
+    }
+
+    @Override
+    public CfEnvProcessorProperties getProperties() {
+        return CfEnvProcessorProperties.builder()
+                .propertyPrefixes("genai.locator")
+                .serviceName("Tanzu GenAI Locator").build();
+    }
+}