module RubyLLM::Providers::OpenAI::Tools

# File lib/ruby_llm/providers/openai/tools.rb, line 105
def build_tool_choice(tool_choice)
  case tool_choice
  when :auto, :none, :required
    tool_choice
  else
    {
      type: 'function',
      function: {
        name: tool_choice
      }
    }
  end
end

# File lib/ruby_llm/providers/openai/tools.rb, line 119
def extract_tool_call_thought_signature(tool_call)
  tool_call.dig('extra_content', 'google', 'thought_signature')
end

# File lib/ruby_llm/providers/openai/tools.rb, line 54
def format_tool_calls(tool_calls)
  return nil unless tool_calls&.any?

  tool_calls.map do |_, tc|
    call = {
      id: tc.id,
      type: 'function',
      function: {
        name: tc.name,
        arguments: JSON.generate(tc.arguments)
      }
    }
    if tc.thought_signature
      call[:extra_content] = {
        google: { thought_signature: tc.thought_signature }
      }
    end
    call
  end
end

# File lib/ruby_llm/providers/openai/tools.rb, line 47
def param_schema(param)
  {
    type: param.type,
    description: param.description
  }.compact
end

# File lib/ruby_llm/providers/openai/tools.rb, line 20
def parameters_schema_for(tool)
  tool.params_schema ||
    schema_from_parameters(tool.parameters)
end

# File lib/ruby_llm/providers/openai/tools.rb, line 75
def parse_tool_call_arguments(tool_call)
  arguments = tool_call.dig('function', 'arguments')

  if arguments.nil? || arguments.empty?
    {}
  else
    JSON.parse(arguments)
  end
end

# File lib/ruby_llm/providers/openai/tools.rb, line 85
def parse_tool_calls(tool_calls, parse_arguments: true)
  return nil unless tool_calls&.any?

  tool_calls.to_h do |tc|
    [
      tc['id'],
      ToolCall.new(
        id: tc['id'],
        name: tc.dig('function', 'name'),
        arguments: if parse_arguments
                     parse_tool_call_arguments(tc)
                   else
                     tc.dig('function', 'arguments')
                   end,
        thought_signature: extract_tool_call_thought_signature(tc)
      )
    ]
  end
end

# File lib/ruby_llm/providers/openai/tools.rb, line 25
def schema_from_parameters(parameters)
  schema_definition = RubyLLM::Tool::SchemaDefinition.from_parameters(parameters)
  schema_definition&.json_schema || EMPTY_PARAMETERS_SCHEMA
end

# File lib/ruby_llm/providers/openai/tools.rb, line 30
def tool_for(tool)
  parameters_schema = parameters_schema_for(tool)

  definition = {
    type: 'function',
    function: {
      name: tool.name,
      description: tool.description,
      parameters: parameters_schema
    }
  }

  return definition if tool.provider_params.empty?

  RubyLLM::Utils.deep_merge(definition, tool.provider_params)
end