Class: Clacky::Tools::Base

Inherits:
Object
  • Object
show all
Defined in:
lib/clacky/tools/base.rb

Class Attribute Summary collapse

Instance Method Summary collapse

Class Attribute Details

.tool_category ⇒ Object

Returns the value of attribute tool_category.



7
8
9
 
# File 'lib/clacky/tools/base.rb', line 7

def tool_category
  @tool_category
end

.tool_description ⇒ Object

Returns the value of attribute tool_description.



7
8
9
 
# File 'lib/clacky/tools/base.rb', line 7

def tool_description
  @tool_description
end

.tool_name ⇒ Object

Returns the value of attribute tool_name.



7
8
9
 
# File 'lib/clacky/tools/base.rb', line 7

def tool_name
  @tool_name
end

.tool_parameters ⇒ Object

Returns the value of attribute tool_parameters.



7
8
9
 
# File 'lib/clacky/tools/base.rb', line 7

def tool_parameters
  @tool_parameters
end

Instance Method Details

#category ⇒ Object 



22
23
24
 
# File 'lib/clacky/tools/base.rb', line 22

def category
  self.class.tool_category || "general"
end

#description ⇒ Object 



14
15
16
 
# File 'lib/clacky/tools/base.rb', line 14

def description
  self.class.tool_description
end

#execute(**_args) ⇒ Object

Execute the tool - must be implemented by subclasses

Raises:

  • (NotImplementedError) 


27
28
29
 
# File 'lib/clacky/tools/base.rb', line 27

def execute(**_args)
  raise NotImplementedError, "#{self.class.name} must implement #execute"
end

#format_call(args) ⇒ String

Format tool call for display - can be overridden by subclasses

Parameters:

  • args (Hash) —

    The arguments passed to the tool

Returns:

  • (String) —

    Formatted call description (e.g., “Read(file.rb)”)



50
51
52
 
# File 'lib/clacky/tools/base.rb', line 50

def format_call(args)
  "#{name}(...)"
end

#format_result(result) ⇒ String

Format tool result for display - can be overridden by subclasses

Parameters:

  • result (Object) —

    The result returned by execute

Returns:

  • (String) —

    Formatted result summary (e.g., “Read 150 lines”)



57
58
59
60
61
62
63
64
65
 
# File 'lib/clacky/tools/base.rb', line 57

def format_result(result)
  if result.is_a?(Hash) && result[:message]
    result[:message]
  elsif result.is_a?(String)
    result.length > 100 ? "#{result[0..100]}..." : result
  else
    "Done"
  end
end

#name ⇒ Object 



10
11
12
 
# File 'lib/clacky/tools/base.rb', line 10

def name
  self.class.tool_name
end

#parameters ⇒ Object 



18
19
20
 
# File 'lib/clacky/tools/base.rb', line 18

def parameters
  self.class.tool_parameters
end

#to_function_definition ⇒ Object

Convert to OpenAI function calling format



68
69
70
71
72
73
74
75
76
77
 
# File 'lib/clacky/tools/base.rb', line 68

def to_function_definition
  {
    type: "function",
    function: {
      name: name,
      description: description,
      parameters: parameters
    }
  }
end