refactor: Renames AgentProvider to AgentLoader and renames getAgent to loadAgent

This is consistent with the interface in python.
https://github.com/google/adk-python/blob/main/src/google/adk/cli/utils/agent_loader.py

PiperOrigin-RevId: 793964389

Author: Jacksunwei

maven_plugin/README.md

@@ -7,12 +7,12 @@ This Maven plugin provides a convenient way to start the ADK Web Server with you
 ### Basic Usage
 
 ```bash
-mvn google-adk:web -Dagents=com.example.MyAgentProvider.INSTANCE
+mvn google-adk:web -Dagents=com.example.MyAgentLoader.INSTANCE
 ```
 
 ### Parameters
 
-- **`agents`** (required): Full class path to your AgentProvider implementation
+- **`agents`** (required): Full class path to your AgentLoader implementation
 - **`port`** (optional, default: 8000): Port for the web server
 - **`host`** (optional, default: localhost): Host address to bind to
 - **`hotReloading`** (optional, default: true): Whether to enable hot reloading
@@ -21,36 +21,43 @@ mvn google-adk:web -Dagents=com.example.MyAgentProvider.INSTANCE
 
 ```bash
 mvn google-adk:web \
-  -Dagents=com.example.MyAgentProvider.INSTANCE \
+  -Dagents=com.example.MyAgentLoader.INSTANCE \
   -Dhost=0.0.0.0 \
   -Dport=9090 \
   -DhotReloading=false
 ```
 
-## Creating an AgentProvider
+## Creating an AgentLoader
 
-### 1. Implement the AgentProvider Interface
+### 1. Implement the AgentLoader Interface
 
-Create a class that implements `com.google.adk.maven.AgentProvider`:
+Create a class that implements `com.google.adk.maven.AgentLoader`:
 
 ```java
 package com.example;
 
 import com.google.adk.agents.BaseAgent;
 import com.google.adk.agents.LlmAgent;
-import com.google.adk.maven.AgentProvider;
-import java.util.Map;
+import com.google.adk.maven.AgentLoader;
+import com.google.common.collect.ImmutableList;
+import java.util.NoSuchElementException;
 
-public class MyAgentProvider implements AgentProvider {
+public class MyAgentLoader implements AgentLoader {
 
-    public static final MyAgentProvider INSTANCE = new MyAgentProvider();
+    public static final MyAgentLoader INSTANCE = new MyAgentLoader();
 
     @Override
-    public Map<String, BaseAgent> getAgents() {
-        return Map.of(
-            "chat_bot", createChatBot(),
-            "code_assistant", createCodeAssistant()
-        );
+    public ImmutableList<String> listAgents() {
+        return ImmutableList.of("chat_bot", "code_assistant");
+    }
+
+    @Override
+    public BaseAgent loadAgent(String name) {
+        switch (name) {
+            case "chat_bot": return createChatBot();
+            case "code_assistant": return createCodeAssistant();
+            default: throw new NoSuchElementException("Agent not found: " + name);
+        }
     }
 
     private BaseAgent createChatBot() {
@@ -92,19 +99,27 @@ Add the plugin to your `pom.xml`:
 ### 3. Run the Web Server
 
 ```bash
-mvn google-adk:web -Dagents=com.example.MyAgentProvider.INSTANCE
+mvn google-adk:web -Dagents=com.example.MyAgentLoader.INSTANCE
 ```
 
-## Alternative AgentProvider Patterns
+## Alternative AgentLoader Patterns
 
 ### Using Default Constructor
 
 ```java
-public class SimpleAgentProvider implements AgentProvider {
+public class SimpleAgentLoader implements AgentLoader {
     // No static field needed, uses default constructor
     @Override
-    public Map<String, BaseAgent> getAgents() {
-        return Map.of("simple_agent", createSimpleAgent());
+    public ImmutableList<String> listAgents() {
+        return ImmutableList.of("simple_agent");
+    }
+
+    @Override
+    public BaseAgent loadAgent(String name) {
+        if ("simple_agent".equals(name)) {
+            return createSimpleAgent();
+        }
+        throw new NoSuchElementException("Agent not found: " + name);
     }
 
     private BaseAgent createSimpleAgent() {
@@ -119,28 +134,39 @@ public class SimpleAgentProvider implements AgentProvider {
 ```
 
 Usage:
+
 ```bash
-mvn google-adk:web -Dagents=com.example.SimpleAgentProvider
+mvn google-adk:web -Dagents=com.example.SimpleAgentLoader
 ```
 
 ### Using Other Static Fields
 
 ```java
-public class MultipleProviders implements AgentProvider {
-    public static final MultipleProviders DEFAULT = new MultipleProviders();
-    public static final MultipleProviders ADVANCED = new MultipleProviders(true);
+public class MultipleLoaders implements AgentLoader {
+    public static final MultipleLoaders DEFAULT = new MultipleLoaders();
+    public static final MultipleLoaders ADVANCED = new MultipleLoaders(true);
 
     private final boolean advanced;
 
-    public MultipleProviders() { this(false); }
-    public MultipleProviders(boolean advanced) { this.advanced = advanced; }
+    public MultipleLoaders() { this(false); }
+    public MultipleLoaders(boolean advanced) { this.advanced = advanced; }
 
     @Override
-    public Map<String, BaseAgent> getAgents() {
+    public ImmutableList<String> listAgents() {
         if (advanced) {
-            return Map.of("advanced_agent", createAdvancedAgent());
+            return ImmutableList.of("advanced_agent");
+        }
+        return ImmutableList.of("basic_agent");
+    }
+
+    @Override
+    public BaseAgent loadAgent(String name) {
+        if (advanced && "advanced_agent".equals(name)) {
+            return createAdvancedAgent();
+        } else if (!advanced && "basic_agent".equals(name)) {
+            return createBasicAgent();
         }
-        return Map.of("basic_agent", createBasicAgent());
+        throw new NoSuchElementException("Agent not found: " + name);
     }
 
     private BaseAgent createBasicAgent() {
@@ -164,8 +190,9 @@ public class MultipleProviders implements AgentProvider {
 ```
 
 Usage:
+
 ```bash
-mvn google-adk:web -Dagents=com.example.MultipleProviders.ADVANCED
+mvn google-adk:web -Dagents=com.example.MultipleLoaders.ADVANCED
 ```
 
 ## Web UI
@@ -194,7 +221,7 @@ Make sure your project has the necessary ADK dependencies:
         <version>0.2.1-SNAPSHOT</version>
     </dependency>
 
-    <!-- Maven plugin dependency for AgentProvider interface -->
+    <!-- Maven plugin dependency for AgentLoader interface -->
     <dependency>
         <groupId>com.google.adk</groupId>
         <artifactId>google-adk-maven-plugin</artifactId>
@@ -223,15 +250,17 @@ Add the plugin to your `pom.xml` for convenience:
 ```
 
 Then use the short command:
+
 ```bash
-mvn google-adk:web -Dagents=com.example.MyAgentProvider.INSTANCE
+mvn google-adk:web -Dagents=com.example.MyAgentLoader.INSTANCE
 ```
 
 **Option 2: Without plugin declaration (no pom.xml changes)**
 
 Use the full coordinates directly:
+
 ```bash
-mvn com.google.adk:google-adk-maven-plugin:web -Dagents=com.example.MyAgentProvider.INSTANCE
+mvn com.google.adk:google-adk-maven-plugin:web -Dagents=com.example.MyAgentLoader.INSTANCE
 ```
 
 ## Stopping the Server

maven_plugin/examples/simple-agent/README.md

@@ -4,21 +4,23 @@ This example demonstrates how to create and run custom ADK agents using the Mave
 
 ## What's Included
 
-- **SimpleAgentProvider**: An implementation of `AgentProvider` that creates three example agents:
+- **SimpleAgentLoader**: An implementation of `AgentLoader` that creates three example agents:
   - `chat_assistant`: A friendly general-purpose assistant
   - `search_agent`: An agent with Google Search capabilities
   - `code_helper`: A coding assistant
 
 ## How to Run
 
 1. **Compile the project:**
+
    ```bash
    mvn compile
    ```
 
 2. **Start the ADK Web Server:**
+
    ```bash
-   mvn google-adk:web -Dagents=com.example.SimpleAgentProvider.INSTANCE
+   mvn google-adk:web -Dagents=com.example.SimpleAgentLoader.INSTANCE
    ```
 
 3. **Open your browser:**
@@ -31,7 +33,7 @@ This example demonstrates how to create and run custom ADK agents using the Mave
 
 ## Customizing
 
-You can modify `SimpleAgentProvider.java` to:
+You can modify `SimpleAgentLoader.java` to:
 - Add more agents
 - Change agent instructions
 - Add different tools
@@ -41,6 +43,7 @@ You can modify `SimpleAgentProvider.java` to:
 Example modifications:
 
 ### Add a New Agent
+
 ```java
 private BaseAgent createMathTutor() {
   return LlmAgent.builder()
@@ -54,7 +57,8 @@ private BaseAgent createMathTutor() {
 }
 ```
 
-Then add it to the `listAgents()` method and `getAgent()` switch statement:
+Then add it to the `listAgents()` method and `loadAgent()` switch statement:
+
 ```java
 @Override
 @Nonnull
@@ -63,7 +67,7 @@ public ImmutableList<String> listAgents() {
 }
 
 @Override
-public BaseAgent getAgent(String name) {
+public BaseAgent loadAgent(String name) {
   switch (name) {
     case "chat_assistant":
       return createChatAssistant();
@@ -80,8 +84,9 @@ public BaseAgent getAgent(String name) {
 ```
 
 ### Configure Different Ports
+
 ```bash
-mvn google-adk:web -Dagents=com.example.SimpleAgentProvider.INSTANCE -Dport=9090
+mvn google-adk:web -Dagents=com.example.SimpleAgentLoader.INSTANCE -Dport=9090
 ```
 
 ## Next Steps

maven_plugin/examples/simple-agent/src/main/java/com/example/SimpleAgentProvider.java renamed to maven_plugin/examples/simple-agent/src/main/java/com/example/SimpleAgentLoader.java

@@ -18,7 +18,7 @@
 
 import com.google.adk.agents.BaseAgent;
 import com.google.adk.agents.LlmAgent;
-import com.google.adk.maven.AgentProvider;
+import com.google.adk.maven.AgentLoader;
 import com.google.adk.tools.GoogleSearchTool;
 import com.google.common.base.Suppliers;
 import com.google.common.collect.ImmutableList;
@@ -28,15 +28,15 @@
 import javax.annotation.Nonnull;
 import javax.annotation.concurrent.ThreadSafe;
 
-/** Example AgentProvider that creates simple agents for demonstration. */
+/** Example AgentLoader that creates simple agents for demonstration. */
 @ThreadSafe
-public class SimpleAgentProvider implements AgentProvider {
+public class SimpleAgentLoader implements AgentLoader {
 
-  public static final SimpleAgentProvider INSTANCE = new SimpleAgentProvider();
+  public static final SimpleAgentLoader INSTANCE = new SimpleAgentLoader();
 
   private final ImmutableMap<String, Supplier<BaseAgent>> agentSuppliers;
 
-  public SimpleAgentProvider() {
+  public SimpleAgentLoader() {
     this.agentSuppliers =
         ImmutableMap.of(
             "chat_assistant", Suppliers.memoize(this::createChatAssistant),
@@ -51,7 +51,7 @@ public ImmutableList<String> listAgents() {
   }
 
   @Override
-  public BaseAgent getAgent(String name) {
+  public BaseAgent loadAgent(String name) {
     Supplier<BaseAgent> supplier = agentSuppliers.get(name);
     if (supplier == null) {
       throw new NoSuchElementException("Agent not found: " + name);

maven_plugin/src/main/java/com/google/adk/maven/AgentProvider.java renamed to maven_plugin/src/main/java/com/google/adk/maven/AgentLoader.java

@@ -20,7 +20,7 @@
 import javax.annotation.concurrent.ThreadSafe;
 
 /**
- * Interface for providing agents to the ADK Web Server.
+ * Interface for loading agents to the ADK Web Server.
  *
  * <p>Users implement this interface to register their agents with ADK Web Server.
  *
@@ -30,14 +30,14 @@
  * <p>Example usage:
  *
  * <pre>{@code
- * public class MyAgentProvider implements AgentProvider {
+ * public class MyAgentLoader implements AgentLoader {
  *   @Override
  *   public ImmutableList<String> listAgents() {
  *     return ImmutableList.of("chat_bot", "code_assistant");
  *   }
  *
  *   @Override
- *   public BaseAgent getAgent(String name) {
+ *   public BaseAgent loadAgent(String name) {
  *     switch (name) {
  *       case "chat_bot": return createChatBot();
  *       case "code_assistant": return createCodeAssistant();
@@ -50,13 +50,13 @@
  * <p>Then use with Maven plugin:
  *
  * <pre>{@code
- * mvn google-adk:web -Dagents=com.acme.MyAgentProvider
+ * mvn google-adk:web -Dagents=com.acme.MyAgentLoader
  * }</pre>
  *
  * TODO: Add config-based agent registration in the future.
  */
 @ThreadSafe
-public interface AgentProvider {
+public interface AgentLoader {
 
   /**
    * Returns a list of available agent names.
@@ -68,12 +68,12 @@ public interface AgentProvider {
   ImmutableList<String> listAgents();
 
   /**
-   * Returns the BaseAgent instance for the specified agent name.
+   * Loads the BaseAgent instance for the specified agent name.
    *
-   * @param name the name of the agent to retrieve
+   * @param name the name of the agent to load
    * @return BaseAgent instance for the given name
    * @throws java.util.NoSuchElementException if the agent doesn't exist
    * @throws IllegalStateException if the agent exists but fails to load
    */
-  BaseAgent getAgent(String name);
+  BaseAgent loadAgent(String name);
 }