Clean up Spring AI samples PR for merge

- Remove committed build/ directories and add them to .gitignore.
- Gate includeBuild('../sdk-java') on sibling checkout existence so the
  build works out-of-the-box when the springai samples are not being
  touched (and will resolve cleanly once temporal-spring-ai publishes).
- core: pin io.grpc:grpc-util version explicitly and switch the SSL sample
  to AdvancedTlsX509KeyManager.updateIdentityCredentials (non-deprecated
  API) to fix compilation under -Werror with the composite-build grpc.
- springai-multimodel: fix doc mismatch on model names, route unprefixed
  input to the "default" model, drop hard-coded model-version hints from
  system prompts.
- springai-rag: correct Javadoc to match actual code (no EmbeddingModelActivity),
  accept bare "ask" as a usage-prompt trigger, normalize text block indentation.
- springai-mcp: fix advisor name comment, normalize text block indentation.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: donald-pinckney

.gitignore

@@ -9,6 +9,10 @@ target
 /core/build
 /springboot/build
 /springboot-basic/build
+/springai/build
+/springai-mcp/build
+/springai-multimodel/build
+/springai-rag/build
 /out
 /core/out
 /springboot/out

core/build.gradle

@@ -7,8 +7,10 @@ dependencies {
     // Environment configuration
     implementation "io.temporal:temporal-envconfig:$javaSDKVersion"
 
-    // Needed for SSL sample (AdvancedTlsX509KeyManager)
-    implementation "io.grpc:grpc-util"
+    // AdvancedTlsX509KeyManager used by the SSL sample. Pinned explicitly so this
+    // module resolves it regardless of the SDK's transitive grpc version (needed
+    // in particular when substituting the SDK via composite build).
+    implementation "io.grpc:grpc-util:1.75.0"
 
     // Needed for SDK related functionality
     implementation(platform("com.fasterxml.jackson:jackson-bom:2.17.2"))

core/src/main/java/io/temporal/samples/ssl/Starter.java

@@ -50,14 +50,12 @@ public static void main(String[] args) throws Exception {
     if (refreshPeriod > 0) {
       AdvancedTlsX509KeyManager clientKeyManager = new AdvancedTlsX509KeyManager();
       // Reload credentials every minute
-      @SuppressWarnings("InlineMeInliner")
-      var unused =
-          clientKeyManager.updateIdentityCredentialsFromFile(
-              clientKeyFile,
-              clientCertFile,
-              refreshPeriod,
-              TimeUnit.MINUTES,
-              Executors.newScheduledThreadPool(1));
+      clientKeyManager.updateIdentityCredentials(
+          clientCertFile,
+          clientKeyFile,
+          refreshPeriod,
+          TimeUnit.MINUTES,
+          Executors.newScheduledThreadPool(1));
       sslContext =
           GrpcSslContexts.configure(SslContextBuilder.forClient().keyManager(clientKeyManager))
               .build();

settings.gradle

@@ -8,16 +8,20 @@ include 'springboot'
 include 'springboot-basic'
 
 // Include local sdk-java build for temporal-spring-ai (until published to Maven Central).
-// temporal-spring-ai requires the plugin API (SimplePlugin) which is not yet in a released SDK,
-// so we substitute all SDK modules from the local build.
-includeBuild('../sdk-java') {
-    dependencySubstitution {
-        substitute module('io.temporal:temporal-spring-ai') using project(':temporal-spring-ai')
-        substitute module('io.temporal:temporal-sdk') using project(':temporal-sdk')
-        substitute module('io.temporal:temporal-serviceclient') using project(':temporal-serviceclient')
-        substitute module('io.temporal:temporal-spring-boot-autoconfigure') using project(':temporal-spring-boot-autoconfigure')
-        substitute module('io.temporal:temporal-spring-boot-starter') using project(':temporal-spring-boot-starter')
-        substitute module('io.temporal:temporal-testing') using project(':temporal-testing')
-        substitute module('io.temporal:temporal-opentracing') using project(':temporal-opentracing')
+// temporal-spring-ai is not yet in a released SDK, so we substitute all SDK modules from the
+// local build when the sibling ../sdk-java checkout is available. Without the checkout, the
+// springai* modules will fail to resolve io.temporal:temporal-spring-ai — that's expected
+// until the artifact is published.
+if (file('../sdk-java').exists()) {
+    includeBuild('../sdk-java') {
+        dependencySubstitution {
+            substitute module('io.temporal:temporal-spring-ai') using project(':temporal-spring-ai')
+            substitute module('io.temporal:temporal-sdk') using project(':temporal-sdk')
+            substitute module('io.temporal:temporal-serviceclient') using project(':temporal-serviceclient')
+            substitute module('io.temporal:temporal-spring-boot-autoconfigure') using project(':temporal-spring-boot-autoconfigure')
+            substitute module('io.temporal:temporal-spring-boot-starter') using project(':temporal-spring-boot-starter')
+            substitute module('io.temporal:temporal-testing') using project(':temporal-testing')
+            substitute module('io.temporal:temporal-opentracing') using project(':temporal-opentracing')
+        }
     }
 }