actionmcp 0.13.0 → 0.14.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: db5dc901e94ecc707a9182889ac8604af07912b8e7361d69758a8122f4572142
-  data.tar.gz: 7363fea49767f889941711fc7da630015774e09b96540bcd3249a0ced0ebcccf
+  metadata.gz: a853f65451f67bb2da8d67e317ed0554d832ecb0660b8adbe9d002c949792d43
+  data.tar.gz: 23212ca96b1538d71ed309a2e1f6b3e5143917ff117827b46306d4384ca0b0f0
 SHA512:
-  metadata.gz: 6b58d65e571daf89731fcc4f82cd5b7d413390fcd34889a01249c29cb799feb34d7bb49d94f69ced069f097f399728e933c6b3fa0a0184a329422b20610fd844
-  data.tar.gz: e32dedcb932a8699461ff16244ebd97ec30bec2246bd88a8aefcea0bacf4661a49776b9195d97dc062e68c7d5b08ab66046e6866e36f6a4f3723bca98f10f553
+  metadata.gz: e4701665f0d8912fe33213d17e0e3d69ff01cc3adac1d69d9d461963c366fca879d09b9be06a2bdfb6579e8bdbcb842eb349bcde45f53316162a58be382f62cb
+  data.tar.gz: 59dfe42ba51f7bae693bbcee84833961eb3f1ea1312e046d105760328a2459842968d85e67289a411c57ddbc9d0bad54aef59ea54e37053fa5bb26360b3c4384

data/README.md

@@ -120,7 +120,7 @@ class AnalyzeCodePrompt < ApplicationMCPPrompt
   # Add validations
   validates :language, inclusion: { in: %w[Ruby C Cobol FORTRAN] }
 
-  def call
+  def perform
     # Implement your prompt logic here
     render(text: "Analyzing #{language} code: #{code}")
   end
@@ -145,7 +145,7 @@ class CalculateSumTool < ApplicationMCPTool
   property :a, type: "number", description: "First number", required: true
   property :b, type: "number", description: "Second number", required: true
   
-  def call
+  def perform
     render(text: a + b)
   end
 end
@@ -176,13 +176,8 @@ analyze_prompt = AnalyzeCodePrompt.new(language: "Ruby", code: "def hello; puts
 # Optionally update attributes later:
 analyze_prompt.code = "def goodbye; puts 'Goodbye!'; end"
 
-# Validate the prompt before calling it
-if analyze_prompt.valid?
-  result = analyze_prompt.call # => #<ActionMCP::Content::Text:0x00000001239398c8 @text="The code you provided is written in Ruby and looks great!", @type="text">
-  puts result.to_h  # => {type: "text", text: "The code you provided is written in Ruby and looks great!"}
-else
-  puts analyze_prompt.errors.full_messages
-end
+result = analyze_prompt.call #=> #<ActionMCP::PromptResponse messages: [{role: "user", content: {type: "text", text: "The code you provided is written in Ruby and looks great!"}}]>
+puts result.to_h #=> {messages: [{role: "user", content: {type: "text", text: "The code you provided is written in Ruby and looks great!"}}]}
 ```
 
 ### Example for a Tool
@@ -195,12 +190,8 @@ sum_tool.a = 15
 sum_tool.b = 20
 
 # Validate the tool before calling it
-if sum_tool.valid?
-  result = sum_tool.call # => #<ActionMCP::Content::Text:0x0000000124cfaba0 @text="35.0", @type="text">
-  puts result.to_h  # => {type: "text", text: "35.0"}
-else
-  puts sum_tool.errors.full_messages
-end
+result = sum_tool.call # => #<ActionMCP::ToolResponse content: [#<ActionMCP::Content::Text:0x000000012bb50f78 @type="text", @text="35.0">], isError: false>
+puts result.to_h  # => {content: [{type: "text", text: "35.0"}]}
 ```
 
 These examples show that both prompts and tools follow a consistent pattern for initialization, validation, and execution, making it easy to integrate them into your application logic.
@@ -251,7 +242,7 @@ class ToolTest < ActiveSupport::TestCase
 
   test "AnalyzeCodePrompt returns the correct analysis" do
     assert_prompt_findable("analyze_code")
-    result = execute_tool("analyze_code", language: "Ruby", code: "def hello; puts 'Hello, world!'; end")
+    result = execute_prompt("analyze_code", language: "Ruby", code: "def hello; puts 'Hello, world!'; end")
     assert_equal "Analyzing Ruby code: def hello; puts 'Hello, world!'; end", assert_prompt_output(result)
   end
 end
@@ -263,8 +254,8 @@ The `TestHelper` module provides the following methods:
 *   `assert_prompt_findable(prompt_name)`: Asserts that a prompt is findable in the `PromptsRegistry`.
 *   `execute_tool(tool_name, args = {})`: Executes a tool with the given name and arguments.
 *   `execute_prompt(prompt_name, args = {})`: Executes a prompt with the given name and arguments.
-*   `assert_tool_output(result, expected_output)`: Asserts that the output of a tool is equal to the expected output.
-*   `assert_prompt_output(result)`: Asserts that the output of a prompt is equal to the expected output.
+*   `assert_tool_output(expected_output, result)`: Asserts that the output of a tool is equal to the expected output.
+*   `assert_prompt_output(expected_output, result)`: Asserts that the output of a prompt is equal to the expected output.
 
 To use the `TestHelper`, you need to require it in your `test_helper.rb` file:
 

data/lib/action_mcp/test_helper.rb

@@ -4,35 +4,48 @@ module ActionMCP
   module TestHelper
     include ActiveSupport::Testing::Assertions
 
+    # Asserts that a tool is findable in the ToolsRegistry.
+    # @param [String] tool_name
     def assert_tool_findable(tool_name)
       assert ActionMCP::ToolsRegistry.tools.key?(tool_name), "Tool #{tool_name} not found in registry"
     end
 
+    # Asserts that a prompt is findable in the PromptsRegistry.
+    # @param [String] prompt_name
     def assert_prompt_findable(prompt_name)
       assert ActionMCP::PromptsRegistry.prompts.key?(prompt_name), "Prompt #{prompt_name} not found in registry"
     end
 
+    # Executes a tool with the given name and arguments.
+    # @param [String] tool_name
+    # @param [Hash] args
     def execute_tool(tool_name, args = {})
       result = ActionMCP::ToolsRegistry.tool_call(tool_name, args)
-      assert_equal false, result[:isError], "Tool #{tool_name} returned an error: #{result[:content].map(&:text).join(', ')}" if result[:isError]
+      assert_not result.is_error, "Tool #{tool_name} returned an error: #{result.to_h[:message]}"
       result
     end
 
+    # Executes a prompt with the given name and arguments.
+    # @param [String] prompt_name
+    # @param [Hash] args
     def execute_prompt(prompt_name, args = {})
       result = ActionMCP::PromptsRegistry.prompt_call(prompt_name, args)
-       assert_equal false, result[:isError], "Prompt #{prompt_name} returned an error: #{result[:content].map(&:text).join(', ')}" if result[:isError]
+      assert_not result.is_error, "Prompt #{prompt_name} returned an error: #{result.to_h[:message]}"
       result
     end
 
-    def assert_tool_output(result, expected_output)
-       assert_equal expected_output, result[:content][0].text
+    # Asserts that the output of a tool is equal to the expected output.
+    # @param [Hash] expected_output
+    # @param [ActionMCP::ToolResponse] result
+    def assert_tool_output(expected_output, result)
+       assert_equal expected_output, result.to_h[:content], "Tool output did not match expected output #{expected_output} != #{result.to_h[:content]}"
     end
 
-    def assert_prompt_output(result)
-      assert_equal "user", result[:messages][0][:role]
-      result[:messages][0][:content]
+    # Asserts that the output of a prompt is equal to the expected output.
+    # @param [Hash] expected_output
+    # @param [ActionMCP::PromptResponse] result
+    def assert_prompt_output(expected_output, result)
+      assert_equal expected_output, result.to_h[:messages], "Prompt output did not match expected output #{expected_output} != #{result.to_h[:messages]}"
     end
-
-    # Add more assertion methods as needed
   end
 end

data/lib/action_mcp/tools_registry.rb

@@ -19,7 +19,7 @@ module ActionMCP
         tool_class = find(tool_name)
         tool = tool_class.new(arguments)
 
-        tool.call.to_h
+        tool.call
       rescue RegistryBase::NotFound
         error_response(:invalid_params, message: "Tool not found: #{tool_name}")
       rescue StandardError => e

data/lib/action_mcp/version.rb

@@ -2,7 +2,7 @@
 
 require_relative "gem_version"
 module ActionMCP
-  VERSION = "0.13.0"
+  VERSION = "0.14.0"
 
   class << self
     alias version gem_version

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: actionmcp
 version: !ruby/object:Gem::Version
-  version: 0.13.0
+  version: 0.14.0
 platform: ruby
 authors:
 - Abdelkader Boudih