helicone-rb 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5102ee7eb685c57698bb42b3a1818b1690b634a1f04fe1a2d5689c7d8b24c423
-  data.tar.gz: 0a37bb68ba76a4b51c8472d96d01cde87fd98df5e35d21b1d6519cb6b3991a9d
+  metadata.gz: a118f742137f788207fb3e4b724ec2420884ef5610776d1437385cd2fa963649
+  data.tar.gz: 44b4d16c5295b974afa28d2b9f694bf0c2b0cb95ba810826eaa5a72b141cd1e1
 SHA512:
-  metadata.gz: 8a801ebeb724ee8428a7c6ab73900a7dddabf1ad7524efe19391e431fc2bdb4bffe91bc9053c08c31f1e7e6398371cdcdd97437994cd4c9fec1532982e2d2f13
-  data.tar.gz: 2abcda0fcc478de60f6192967f9465f815d68476495b6c5988145bcbc7361b0f4dfcf8ef97a3924e09302c48c058f556bd848111eda8e8fe977ffec01dfee9f9
+  metadata.gz: b689d259dbc4f8b583a62d5b95e84053aa58f41d594cf03fb5b681dc10d180e4d3ab5d86844d9875821c3d6b8c3270ff7e5faf5660c89501a8e72e8e7bf9d1b0
+  data.tar.gz: 6aa3ef6dda08bccd058deb550c23a0059693f759476b8394fa0d0c5f24497475decd2beb81a7f5818c6a58e243b8d8484bda22e405fcd965ae602bd789451904

data/lib/helicone/agent.rb

@@ -4,7 +4,7 @@ module Helicone
   class Agent
     MAX_ITERATIONS = 10
 
-    attr_reader :client, :tools, :messages, :context, :turn_model, :response_model
+    attr_reader :client, :tools, :messages, :context, :model
 
     # Create an agent with tools and optional context
     #
@@ -14,14 +14,12 @@ module Helicone
     # @param context [Object] Context object passed to tool#initialize
     # @param system_prompt [String] System prompt
     # @param messages [Array<Helicone::Message>] Initial messages (for continuing conversations)
-    # @param turn_model [String] Model for tool-calling turns (defaults to Helicone.configuration.default_model)
-    # @param response_model [String] Model for final response (defaults to turn_model)
-    def initialize(client: nil, session: nil, tools: [], context: nil, system_prompt: nil, messages: [], turn_model: nil, response_model: nil)
+    # @param model [String] Model to use (defaults to Helicone.configuration.default_model)
+    def initialize(client: nil, session: nil, tools: [], context: nil, system_prompt: nil, messages: [], model: nil)
       @client = client || build_client(session: session)
       @tools = tools
       @context = context
-      @turn_model = turn_model
-      @response_model = response_model || turn_model
+      @model = model
       @messages = messages.dup
 
       # Add system message at the start if provided and not already present
@@ -30,17 +28,17 @@ 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
-        response = call_llm(model: @turn_model)
+        response = call_llm
 
         tool_calls = response.tool_calls
         if tool_calls && !tool_calls.empty?
@@ -59,17 +57,7 @@ module Helicone
 
           iterations += 1
         else
-          # No tool calls - if response_model differs, make final call with it
-          if @response_model && @response_model != @turn_model
-            final_response = @client.chat(messages: @messages, model: @response_model)
-            return AgentResult.new(
-              content: final_response.content,
-              messages: @messages,
-              iterations: iterations,
-              response: final_response
-            )
-          end
-
+          # No tool calls - we're done
           return AgentResult.new(
             content: response.content,
             messages: @messages,
@@ -80,7 +68,7 @@ module Helicone
       end
 
       # Max iterations reached - make one final call without tools to get a response
-      final_response = @client.chat(messages: @messages, model: @response_model)
+      final_response = @client.chat(messages: @messages, model: @model)
 
       AgentResult.new(
         content: final_response.content,
@@ -106,10 +94,10 @@ module Helicone
       Helicone.configuration.logger
     end
 
-    def call_llm(model: nil)
+    def call_llm
       @client.chat(
         messages: @messages,
-        model: model,
+        model: @model,
         tools: tools_for_api,
         tool_choice: "auto"
       )
@@ -121,16 +109,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 +132,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.3.0"
 end

metadata

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