feat: AgentStaticLoader; like an 🧝 Elve, instead of the 🧙 mage (fixes #149)

Author: vorburger

dev/src/main/java/com/google/adk/web/AdkWebServer.java

@@ -125,6 +125,8 @@
 @ComponentScan(basePackages = {"com.google.adk.web", "com.google.adk.web.config"})
 public class AdkWebServer implements WebMvcConfigurer {
 
+  public static AgentLoader AGENT_LOADER;
+
   private static final Logger log = LoggerFactory.getLogger(AdkWebServer.class);
 
   @Value("${adk.web.ui.dir:#{null}}")
@@ -175,6 +177,11 @@ public Map<String, BaseAgent> loadedAgentRegistry(
     }
 
     try {
+      // If AGENT_LOADER is set, us it
+      if (AGENT_LOADER != null) {
+        agents.putAll(AGENT_LOADER.loadAgents());
+      }
+
       // Create and use compiler loader
       AgentCompilerLoader compilerLoader = new AgentCompilerLoader(props);
       Map<String, BaseAgent> compiledAgents = compilerLoader.loadAgents();

dev/src/main/java/com/google/adk/web/AgentLoader.java

@@ -27,6 +27,10 @@
  */
 public interface AgentLoader {
 
+  static AgentLoader from(BaseAgent... agents) {
+    return new AgentStaticLoader(agents);
+  }
+
   /**
    * Loads agents and returns them as a map. This method performs a one-time loading operation and
    * returns all discovered agents.
@@ -69,5 +73,7 @@ default boolean supportsHotReloading() {
    *
    * @return A string description of the loader type
    */
-  String getLoaderType();
+  default String getLoaderType() {
+    return getClass().getSimpleName();
+  }
 }

dev/src/main/java/com/google/adk/web/AgentStaticLoader.java

@@ -0,0 +1,39 @@
+/*
+ * Copyright 2025 Google LLC
+ *
+ * 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
+ *
+ *     http://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 com.google.adk.web;
+
+import autovalue.shaded.com.google.common.collect.ImmutableMap;
+import com.google.adk.agents.BaseAgent;
+import java.io.IOException;
+import java.util.Map;
+
+class AgentStaticLoader implements AgentLoader {
+
+  private final ImmutableMap<String, BaseAgent> agents;
+
+  AgentStaticLoader(BaseAgent... agents) {
+    var builder = ImmutableMap.<String, BaseAgent>builder();
+    for (BaseAgent agent : agents) {
+      builder.put(agent.name(), agent);
+    }
+    this.agents = builder.build();
+  }
+
+  @Override
+  public Map<String, BaseAgent> loadAgents() throws IOException {
+    return agents;
+  }
+}