minor update of tool spec

add exception and use tool id

Author: alexcheng1982

integration/spring-ai/src/main/kotlin/com/javaaidev/easyllmtools/integration/springai/ToolCallException.java

@@ -0,0 +1,8 @@
+package com.javaaidev.easyllmtools.integration.springai;
+
+public class ToolCallException extends RuntimeException {
+
+  public ToolCallException(String toolId, String message, Throwable cause) {
+    super(String.format("Error when calling the tool: %s, message: %s", toolId, message), cause);
+  }
+}

integration/spring-ai/src/main/kotlin/com/javaaidev/easyllmtools/integration/springai/ToolFunctionCallback.java

@@ -37,7 +37,7 @@ public String call(String functionInput) {
       var result = tool.call(input);
       return objectMapper.writeValueAsString(result);
     } catch (Exception e) {
-      throw new RuntimeException("Failed to call tool", e);
+      throw new ToolCallException(tool.getId(), e.getMessage(), e);
     }
   }
 }

integration/spring-ai/src/main/kotlin/com/javaaidev/easyllmtools/integration/springai/ToolsFunctionCallbackResolver.java

@@ -56,9 +56,9 @@ public FunctionCallback resolve(String name) {
   @Override
   public void setApplicationContext(ApplicationContext applicationContext) throws BeansException {
     var tools = applicationContext.getBeansOfType(Tool.class);
-    LOGGER.info("Found tools: {}", tools.values().stream().map(Tool::getName).toList());
+    LOGGER.info("Found tools: {}", tools.values().stream().map(Tool::getId).toList());
     for (Tool tool : tools.values()) {
-      toolsMap.put(tool.getName(), tool);
+      toolsMap.put(tool.getId(), tool);
     }
   }
 }

llm-tool-spec/src/main/java/com/javaaidev/easyllmtools/llmtoolspec/ToolFactory.java

@@ -1,6 +1,14 @@
 package com.javaaidev.easyllmtools.llmtoolspec;
 
+/**
+ * Factory to create a tool
+ */
 public interface ToolFactory {
 
+  /**
+   * ID of tool created by this factory
+   *
+   * @return tool id
+   */
   String toolId();
 }