raix 0.8.1 → 0.8.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2de11b289a7c245c49e865735e1abc67ff671f02a9f23fb89d262d3ff83e6157
-  data.tar.gz: f8cd493f6f018ddd6b981f944786635b6800ca9beac4480e0a4c3c08bb7b8392
+  metadata.gz: 04e086a8f8f010507fef64ba8f2a1fa7c4508b34d85b39d8d045088410ba041c
+  data.tar.gz: b6ddc5948d4d71a967321cfe664a6fb2ad6f38833c7067e0915216ce7fc64646
 SHA512:
-  metadata.gz: 4d26f6ffad99abb7eaf6c8ef072393d75625e4762206d0d1f94c811e9d44747fa2e9048d5a8951484ded2861ecd5ebac69ea39bf6163432a411e2f9e427b0533
-  data.tar.gz: 893d062ab1f23b6c6a47dc715a7c98a3886dbe092645642e74bdb97ad80b2b4f637305b95acc6e6a8984cfe6defcdf020410233f5f818cba16bbbd0c5f49b5ed
+  metadata.gz: 1558de827080ea2fb1c0ab0a953ae4d4cb1a9f8ad1aaae0690942f78bfde31275739857948b064721aa83b0f9b963c91c4bcb8dc5be460283e88ee2294e10e64
+  data.tar.gz: 001c63730739473375f0bff5c7e4edb78e4247000825799cff5cd98f9ae56bf6f2a5c436f1334b03e05de3257ef081498e2c456567a70e65417c19b70ab8918b

data/CHANGELOG.md

@@ -1,3 +1,7 @@
+## [0.8.2] - 2025-04-29
+- Extracts function call dispatch into a public `dispatch_tool_function` that can be overridden in subclasses
+- Uses `public_send` instead of `send` for better security and explicitness
+
 ## [0.8.1] - 2025-04-24
 Added ability to filter tool functions (or disable completely) when calling `chat_completion`. Thanks to @parruda for the contribution.
 

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    raix (0.8.1)
+    raix (0.8.2)
       activesupport (>= 6.0)
       faraday-retry (~> 2.0)
       open_router (~> 0.2)

data/README.md

@@ -206,6 +206,28 @@ example.invocations
 # => [:first, :second]
 ```
 
+#### Customizing Function Dispatch
+
+You can customize how function calls are handled by overriding the `dispatch_tool_function` in your class. This is useful if you need to add logging, caching, error handling, or other custom behavior around function calls.
+
+```ruby
+class CustomDispatchExample
+  include Raix::ChatCompletion
+  include Raix::FunctionDispatch
+
+  function :example_tool do |arguments|
+    "Result from example tool"
+  end
+
+  def dispatch_tool_function(function_name, arguments)
+    puts "Calling #{function_name} with #{arguments}"
+    result = super
+    puts "Result: #{result}"
+    result
+  end
+end
+```
+
 #### Manually Stopping a Loop
 
 To loop AI components that don't interact with end users, at least one function block should invoke `stop_looping!` whenever you're ready to stop processing.

data/lib/raix/chat_completion.rb

@@ -132,7 +132,7 @@ module Raix
             function_name = tool_call["function"]["name"]
             raise "Unauthorized function call: #{function_name}" unless self.class.functions.map { |f| f[:name].to_sym }.include?(function_name.to_sym)
 
-            send(function_name, arguments.with_indifferent_access)
+            dispatch_tool_function(function_name, arguments.with_indifferent_access)
           end
         end
 
@@ -189,6 +189,16 @@ module Raix
       @transcript ||= []
     end
 
+    # Dispatches a tool function call with the given function name and arguments.
+    # This method can be overridden in subclasses to customize how function calls are handled.
+    #
+    # @param function_name [String] The name of the function to call
+    # @param arguments [Hash] The arguments to pass to the function
+    # @return [Object] The result of the function call
+    def dispatch_tool_function(function_name, arguments)
+      public_send(function_name, arguments)
+    end
+
     private
 
     def filtered_tools(tool_names)

data/lib/raix/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Raix
-  VERSION = "0.8.1"
+  VERSION = "0.8.2"
 end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: raix
 version: !ruby/object:Gem::Version
-  version: 0.8.1
+  version: 0.8.2
 platform: ruby
 authors:
 - Obie Fernandez
 bindir: exe
 cert_chain: []
-date: 2025-04-25 00:00:00.000000000 Z
+date: 2025-04-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport