Allow developers without Docker to bring up shell (#81)

alexheifetz · web-flow · commit 2b46cdd6d52c · 2025-10-31T00:14:25.000-04:00
diff --git a/examples-java/pom.xml b/examples-java/pom.xml
@@ -112,7 +112,7 @@
             </dependencies>
         </profile>
         <profile>
-            <id>enable-shell</id>
+            <id>enable-shell-mcp-client</id>
             <activation>
                 <activeByDefault>true</activeByDefault>
             </activation>
@@ -136,7 +136,7 @@
             </build>
         </profile>
         <profile>
-            <id>enable-shell-mcp-client</id>
+            <id>enable-shell</id>
             <activation>
                 <activeByDefault>false</activeByDefault>
             </activation>
@@ -152,7 +152,7 @@
                         <groupId>org.springframework.boot</groupId>
                         <artifactId>spring-boot-maven-plugin</artifactId>
                         <configuration>
-                            <mainClass>com.embabel.example.JavaAgentShellMcpClientApplication</mainClass>
+                            <mainClass>com.embabel.example.JavaAgentSimpleShellApplication</mainClass>
                         </configuration>
                         <version>${spring-boot.version}</version>
                     </plugin>
diff --git a/examples-java/src/main/java/com/embabel/example/JavaAgentShellApplication.java b/examples-java/src/main/java/com/embabel/example/JavaAgentShellApplication.java
@@ -42,7 +42,7 @@
         }
 )
 @EnableAgents(
-        loggingTheme = LoggingThemes.SEVERANCE,
+        loggingTheme = LoggingThemes.STAR_WARS,
         mcpServers = {McpServers.DOCKER_DESKTOP}
 )
 public class JavaAgentShellApplication {
diff --git a/examples-java/src/main/java/com/embabel/example/JavaAgentSimpleShellApplication.java b/examples-java/src/main/java/com/embabel/example/JavaAgentSimpleShellApplication.java
@@ -17,18 +17,22 @@
 
 import com.embabel.agent.config.annotation.EnableAgents;
 import com.embabel.agent.config.annotation.LoggingThemes;
-import com.embabel.agent.config.annotation.McpServers;
 import org.springframework.boot.SpringApplication;
 import org.springframework.boot.autoconfigure.SpringBootApplication;
 import org.springframework.boot.context.properties.ConfigurationPropertiesScan;
 
 /**
  * Spring Boot application that provides an interactive command-line shell for Embabel agents
- * with Star Wars themed logging and Docker Desktop integration.
+ * with Star Wars themed logging.
+ * <br>
+ * This is a simple example application demonstrating how to set up an Embabel agent
+ * environment with a customized logging theme.
+ * <br>
+ * Docker Tools are not enabled in this example to keep the setup straightforward,
+ * but keep in mind that some examples may require Docker Tools for full functionality.
  *
  * <p>This application runs in interactive shell mode, allowing developers to test and interact
- * with agents through a REPL-like interface. It combines the development-friendly shell
- * environment with fun Star Wars themed logging messages and Docker container capabilities.
+ * with agents through a REPL-like interface.
  *
  * @author Embabel Team
  * @see EnableAgents
@@ -41,20 +45,19 @@
         }
 )
 @EnableAgents(
-        loggingTheme = LoggingThemes.STAR_WARS,
-        mcpServers = {McpServers.DOCKER_DESKTOP}
+        loggingTheme = LoggingThemes.SEVERANCE
 )
-public class JavaAgentShellMcpClientApplication {
+public class JavaAgentSimpleShellApplication {
 
     /**
      * Application entry point.
      *
      * <p>Starts the Spring Boot application with an interactive shell interface,
-     * Star Wars themed logging, and Docker Desktop integration.
+     * Star Wars themed logging.
      *
      * @param args command line arguments passed to the application
      */
     public static void main(String[] args) {
-        SpringApplication.run(JavaAgentShellMcpClientApplication.class, args);
+        SpringApplication.run(JavaAgentSimpleShellApplication.class, args);
     }
 }
diff --git a/examples-kotlin/pom.xml b/examples-kotlin/pom.xml
@@ -99,7 +99,7 @@
             </dependencies>
         </profile>
         <profile>
-            <id>enable-shell</id>
+            <id>enable-shell-mcp-client</id>
             <activation>
                 <activeByDefault>true</activeByDefault>
             </activation>
@@ -123,7 +123,7 @@
             </build>
         </profile>
         <profile>
-            <id>enable-shell-mcp-client</id>
+            <id>enable-shell</id>
             <activation>
                 <activeByDefault>false</activeByDefault>
             </activation>
@@ -139,7 +139,7 @@
                         <groupId>org.springframework.boot</groupId>
                         <artifactId>spring-boot-maven-plugin</artifactId>
                         <configuration>
-                            <mainClass>com.embabel.example.KotlinAgentShellMcpClientApplicationKt</mainClass>
+                            <mainClass>com.embabel.example.KotlinAgentSimpleShellApplicationKt</mainClass>
                         </configuration>
                         <version>${spring-boot.version}</version>
                     </plugin>
diff --git a/examples-kotlin/src/main/kotlin/com/embabel/example/KotlinAgentShellApplication.kt b/examples-kotlin/src/main/kotlin/com/embabel/example/KotlinAgentShellApplication.kt
@@ -17,6 +17,7 @@ package com.embabel.example
 
 import com.embabel.agent.config.annotation.EnableAgents
 import com.embabel.agent.config.annotation.LoggingThemes
+import com.embabel.agent.config.annotation.McpServers
 import org.springframework.boot.autoconfigure.SpringBootApplication
 import org.springframework.boot.context.properties.ConfigurationPropertiesScan
 import org.springframework.boot.runApplication
@@ -43,6 +44,7 @@ import org.springframework.boot.runApplication
 )
 @EnableAgents(
     loggingTheme = LoggingThemes.STAR_WARS,
+    mcpServers = [McpServers.DOCKER_DESKTOP, McpServers.DOCKER],
 )
 class KotlinAgentShellApplication
 
diff --git a/examples-kotlin/src/main/kotlin/com/embabel/example/KotlinAgentSimpleShellApplication.kt b/examples-kotlin/src/main/kotlin/com/embabel/example/KotlinAgentSimpleShellApplication.kt
@@ -17,7 +17,6 @@ package com.embabel.example
 
 import com.embabel.agent.config.annotation.EnableAgents
 import com.embabel.agent.config.annotation.LoggingThemes
-import com.embabel.agent.config.annotation.McpServers
 import org.springframework.boot.autoconfigure.SpringBootApplication
 import org.springframework.boot.context.properties.ConfigurationPropertiesScan
 import org.springframework.boot.runApplication
@@ -44,7 +43,6 @@ import org.springframework.boot.runApplication
 )
 @EnableAgents(
     loggingTheme = LoggingThemes.SEVERANCE,
-    mcpServers = [McpServers.DOCKER_DESKTOP, McpServers.DOCKER],
 )
 class KotlinAgentShellMcpClientApplication
 

Original file line number	Diff line number	Diff line change
`@@ -42,7 +42,7 @@`
`42`	`42`	`}`
`43`	`43`	`)`
`44`	`44`	`@EnableAgents(`
`45`		`- loggingTheme = LoggingThemes.SEVERANCE,`
	`45`	`+ loggingTheme = LoggingThemes.STAR_WARS,`
`46`	`46`	`mcpServers = {McpServers.DOCKER_DESKTOP}`
`47`	`47`	`)`
`48`	`48`	`public class JavaAgentShellApplication {`
Original file line number	Diff line number	Diff line change
`@@ -17,18 +17,22 @@`
`17`	`17`
`18`	`18`	`import com.embabel.agent.config.annotation.EnableAgents;`
`19`	`19`	`import com.embabel.agent.config.annotation.LoggingThemes;`
`20`		`-import com.embabel.agent.config.annotation.McpServers;`
`21`	`20`	`import org.springframework.boot.SpringApplication;`
`22`	`21`	`import org.springframework.boot.autoconfigure.SpringBootApplication;`
`23`	`22`	`import org.springframework.boot.context.properties.ConfigurationPropertiesScan;`
`24`	`23`
`25`	`24`	`/**`
`26`	`25`	`* Spring Boot application that provides an interactive command-line shell for Embabel agents`
`27`		`- * with Star Wars themed logging and Docker Desktop integration.`
	`26`	`+ * with Star Wars themed logging.`
	`27`	`+ * <br>`
	`28`	`+ * This is a simple example application demonstrating how to set up an Embabel agent`
	`29`	`+ * environment with a customized logging theme.`
	`30`	`+ * <br>`
	`31`	`+ * Docker Tools are not enabled in this example to keep the setup straightforward,`
	`32`	`+ * but keep in mind that some examples may require Docker Tools for full functionality.`
`28`	`33`	`*`
`29`	`34`	`* <p>This application runs in interactive shell mode, allowing developers to test and interact`
`30`		`- * with agents through a REPL-like interface. It combines the development-friendly shell`
`31`		`- * environment with fun Star Wars themed logging messages and Docker container capabilities.`
	`35`	`+ * with agents through a REPL-like interface.`
`32`	`36`	`*`
`33`	`37`	`* @author Embabel Team`
`34`	`38`	`* @see EnableAgents`
`@@ -41,20 +45,19 @@`
`41`	`45`	`}`
`42`	`46`	`)`
`43`	`47`	`@EnableAgents(`
`44`		`- loggingTheme = LoggingThemes.STAR_WARS,`
`45`		`- mcpServers = {McpServers.DOCKER_DESKTOP}`
	`48`	`+ loggingTheme = LoggingThemes.SEVERANCE`
`46`	`49`	`)`
`47`		`-public class JavaAgentShellMcpClientApplication {`
	`50`	`+public class JavaAgentSimpleShellApplication {`
`48`	`51`
`49`	`52`	`/**`
`50`	`53`	`* Application entry point.`
`51`	`54`	`*`
`52`	`55`	`* <p>Starts the Spring Boot application with an interactive shell interface,`
`53`		`- * Star Wars themed logging, and Docker Desktop integration.`
	`56`	`+ * Star Wars themed logging.`
`54`	`57`	`*`
`55`	`58`	`* @param args command line arguments passed to the application`
`56`	`59`	`*/`
`57`	`60`	`public static void main(String[] args) {`
`58`		`- SpringApplication.run(JavaAgentShellMcpClientApplication.class, args);`
	`61`	`+ SpringApplication.run(JavaAgentSimpleShellApplication.class, args);`
`59`	`62`	`}`
`60`	`63`	`}`
Original file line number	Diff line number	Diff line change
`@@ -17,6 +17,7 @@ package com.embabel.example`
`17`	`17`
`18`	`18`	`import com.embabel.agent.config.annotation.EnableAgents`
`19`	`19`	`import com.embabel.agent.config.annotation.LoggingThemes`
	`20`	`+import com.embabel.agent.config.annotation.McpServers`
`20`	`21`	`import org.springframework.boot.autoconfigure.SpringBootApplication`
`21`	`22`	`import org.springframework.boot.context.properties.ConfigurationPropertiesScan`
`22`	`23`	`import org.springframework.boot.runApplication`
`@@ -43,6 +44,7 @@ import org.springframework.boot.runApplication`
`43`	`44`	`)`
`44`	`45`	`@EnableAgents(`
`45`	`46`	`loggingTheme = LoggingThemes.STAR_WARS,`
	`47`	`+ mcpServers = [McpServers.DOCKER_DESKTOP, McpServers.DOCKER],`
`46`	`48`	`)`
`47`	`49`	`class KotlinAgentShellApplication`
`48`	`50`
Original file line number	Diff line number	Diff line change
`@@ -17,7 +17,6 @@ package com.embabel.example`
`17`	`17`
`18`	`18`	`import com.embabel.agent.config.annotation.EnableAgents`
`19`	`19`	`import com.embabel.agent.config.annotation.LoggingThemes`
`20`		`-import com.embabel.agent.config.annotation.McpServers`
`21`	`20`	`import org.springframework.boot.autoconfigure.SpringBootApplication`
`22`	`21`	`import org.springframework.boot.context.properties.ConfigurationPropertiesScan`
`23`	`22`	`import org.springframework.boot.runApplication`
`@@ -44,7 +43,6 @@ import org.springframework.boot.runApplication`
`44`	`43`	`)`
`45`	`44`	`@EnableAgents(`
`46`	`45`	`loggingTheme = LoggingThemes.SEVERANCE,`
`47`		`- mcpServers = [McpServers.DOCKER_DESKTOP, McpServers.DOCKER],`
`48`	`46`	`)`
`49`	`47`	`class KotlinAgentShellMcpClientApplication`
`50`	`48`