helicone-rb 0.2.0 → 0.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5102ee7eb685c57698bb42b3a1818b1690b634a1f04fe1a2d5689c7d8b24c423
-  data.tar.gz: 0a37bb68ba76a4b51c8472d96d01cde87fd98df5e35d21b1d6519cb6b3991a9d
+  metadata.gz: ac034e0153e6ec01bbe008066b48c58c754a103b56461fdc24c4e0d1bc05d4d4
+  data.tar.gz: c95390c56a649b16fde96f7be81a1ef537671a19a129039d23d272ea391cfdaf
 SHA512:
-  metadata.gz: 8a801ebeb724ee8428a7c6ab73900a7dddabf1ad7524efe19391e431fc2bdb4bffe91bc9053c08c31f1e7e6398371cdcdd97437994cd4c9fec1532982e2d2f13
-  data.tar.gz: 2abcda0fcc478de60f6192967f9465f815d68476495b6c5988145bcbc7361b0f4dfcf8ef97a3924e09302c48c058f556bd848111eda8e8fe977ffec01dfee9f9
+  metadata.gz: a4726d935f0db71a01ece1db9f29d758f2c4f47e04b79cb62ed986f1180abf6415576ccfa94e1de6e6d73671d21448c8067b1c74b6b55052195548c67533f64b
+  data.tar.gz: 1b1b93d6cffe0e19a41dbbefec03ab019bda992c4eb7a0dfc7770c60852f7dfde8d879d634aeeec10ca75837e799919be2ecc14f9f601efbb4b63636922b43ec

data/lib/helicone/agent.rb

@@ -30,13 +30,13 @@ module Helicone
       end
     end
 
-    # Run the agent with a prompt, executing tools until done
+    # Run the agent with an optional prompt, executing tools until done
     #
-    # @param prompt [String] User prompt to start with
+    # @param prompt [String, nil] User prompt to add (nil to use existing messages)
     # @param max_iterations [Integer] Maximum tool execution loops
     # @return [AgentResult]
-    def run(prompt, max_iterations: MAX_ITERATIONS)
-      @messages << Message.user_text(prompt)
+    def run(prompt = nil, max_iterations: MAX_ITERATIONS)
+      @messages << Message.user_text(prompt) if prompt
 
       iterations = 0
       while iterations < max_iterations
@@ -121,16 +121,17 @@ module Helicone
     end
 
     def execute_tool(tool_call)
-      tool_class = find_tool_class(tool_call.name)
+      tool = find_tool(tool_call.name)
 
-      unless tool_class
+      unless tool
         logger.warn("[Helicone::Agent] Unknown tool: #{tool_call.name}")
         return { error: "Unknown tool: #{tool_call.name}" }
       end
 
       logger.info("[Helicone::Agent] Executing tool: #{tool_call.name} with #{tool_call.arguments}")
 
-      tool_instance = tool_class.new(@context)
+      # Support both tool classes and tool instances
+      tool_instance = tool.is_a?(Class) ? tool.new(@context) : tool
       result = tool_instance.execute(**tool_call.arguments)
 
       result_preview = result.inspect
@@ -143,7 +144,7 @@ module Helicone
       { error: e.message }
     end
 
-    def find_tool_class(name)
+    def find_tool(name)
       @tools.find { |t| t.function_name == name }
     end
 

data/lib/helicone/client.rb

@@ -13,7 +13,7 @@ module Helicone
     def initialize(session_id: nil, session_name: nil, account_id: nil, account_name: nil)
       @client = OpenAI::Client.new(
         access_token: ENV["HELICONE_API_KEY"],
-        uri_base: Helicone::URI_BASE
+        uri_base: Helicone.configuration.base_url
       )
 
       # Add Helicone session headers if provided

data/lib/helicone/configuration.rb

@@ -3,16 +3,17 @@
 require "logger"
 
 module Helicone
-  URI_BASE = "https://ai-gateway.helicone.ai/v1"
+  DEFAULT_BASE_URL = "https://ai-gateway.helicone.ai/v1"
 
   class Configuration
-    attr_accessor :logger, :default_model
+    attr_accessor :logger, :default_model, :base_url
 
     # Initialize configuration with defaults
     #
     # @return [Configuration]
     def initialize
       @default_model = "gpt-4o"
+      @base_url = DEFAULT_BASE_URL
       @logger = Logger.new($stdout, level: Logger::INFO)
     end
   end

data/lib/helicone/message.rb

@@ -113,9 +113,11 @@ module Helicone
     #
     # @return [Hash] Message formatted for the API
     def to_h
-      # If this is a raw message (assistant with tool_calls), return it as-is
       if @raw_message
-        @raw_message
+        # Select only the fields needed for the API
+        hash = { role: @raw_message[:role], content: @raw_message[:content] }
+        hash[:tool_calls] = @raw_message[:tool_calls] if @raw_message[:tool_calls]
+        hash
       else
         hash = { role: role, content: content }
         hash[:tool_call_id] = tool_call_id if tool_call_id

data/lib/helicone/tool.rb

@@ -98,5 +98,19 @@ module Helicone
     def execute(**args)
       raise NotImplementedError, "Subclasses must implement #execute"
     end
+
+    # Delegate to class method for instances
+    #
+    # @return [Hash] Tool definition formatted for OpenAI API
+    def to_openai_tool
+      self.class.to_openai_tool
+    end
+
+    # Delegate to class method for instances
+    #
+    # @return [String] The function name
+    def function_name
+      self.class.function_name
+    end
   end
 end

data/lib/helicone/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Helicone
-  VERSION = "0.2.0"
+  VERSION = "0.2.1"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: helicone-rb
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.2.1
 platform: ruby
 authors:
 - Genevere