add support Cohere API wrapper

- implement CohereAIWrapper.
- update the configurations to support Cohere requirements.
- implement supporting classes like unit testing and response handler.
- Rename old files to become more flexible with multi model vision.
- clean API string.

Author: Barqawiz

core/com.intellijava.core/src/main/java/com/intellijava/core/model/CohereTextResponse.java renamed to core/com.intellijava.core/src/main/java/com/intellijava/core/model/CohereLanguageResponse.java

@@ -9,10 +9,9 @@
  * @author github.com/Barqawiz
  *
  */
-public class CohereTextResponse {
+public class CohereLanguageResponse extends BaseRemoteModel{
 
 	/** A unique identifier for the response.*/
-	private String id;
     private List<Generation> generations;
     private String prompt;
 
@@ -57,24 +56,6 @@ public void setText(String text) {
         }
     }
 
-    /**
-     * Get the unique identifier for the response.
-     *
-     * @return the unique identifier for the response.
-     */
-    public String getId() {
-        return id;
-    }
-
-    /**
-     * Sets the unique identifier for the response.
-     *
-     * @param id the unique identifier for the response.
-     */
-    public void setId(String id) {
-        this.id = id;
-    }
-
     /**
      * Get the list of generated texts.
      *

core/com.intellijava.core/src/main/java/com/intellijava/core/model/input/LanguageModelInput.java

@@ -4,6 +4,10 @@
  * 
  * LanguageModelInput handle the input parameters for the majority of the remote language models.
  * 
+ * Language models documentations:
+ * - Openai : https://beta.openai.com/docs/api-reference/completions.
+ * - Cohere : https://docs.cohere.ai/reference/generate
+ * 
  * @author github.com/Barqawiz
  *
  */
@@ -45,7 +49,11 @@ public Builder(String prompt) {
 
         /**
          *  Setter for model.
-         * @param model the model name. The largest OpenAI model is text-davinci-002.
+         * @param model the model name. 
+         * 
+         * The largest OpenAI model is text-davinci-003.
+         * The largest cohere model is xlarge.
+         * 
          * @return instance of Builder
          */
         public Builder setModel(String model) {

core/com.intellijava.core/src/main/java/com/intellijava/core/wrappers/CohereAIWrapper.java

@@ -0,0 +1,77 @@
+package com.intellijava.core.wrappers;
+
+import java.io.IOException;
+import java.io.OutputStream;
+import java.net.HttpURLConnection;
+import java.net.URL;
+import java.nio.charset.StandardCharsets;
+import java.util.Map;
+
+import com.intellijava.core.model.BaseRemoteModel;
+import com.intellijava.core.model.CohereLanguageResponse;
+import com.intellijava.core.model.OpenaiLanguageResponse;
+import com.intellijava.core.utils.Config2;
+import com.intellijava.core.utils.ConnHelper;
+
+/**
+ * 
+ * 
+ * @author github.com/Barqawiz
+ *
+ */
+public class CohereAIWrapper implements LanguageModelInterface{
+
+	private final String API_BASE_URL = Config2.getInstance().getProperty("url.cohere.base");
+	private final String COHERE_VERSION = Config2.getInstance().getProperty("url.cohere.version");
+    private String API_KEY;
+
+    /**
+     * CohereAIWrapper constructor with the API key
+     * 
+     * @param apiKey cohere API key, generate if from your account.
+     */
+    public CohereAIWrapper(String apiKey) {
+    	this.API_KEY = apiKey;
+    }
+
+    /**
+	 * 
+	 * Generate text from remote large language model based on the received prompt.
+	 * 
+	 * @param params key and value for the API parameters
+	 * 			model the model name, either medium or xlarge.
+	 * 			prompt text of the required action or the question.
+	 * 			temperature higher values means more risks and creativity.
+	 * 			max_tokens maximum size of the model input and output.
+	 * @return BaseRemoteModel for model response
+	 * @throws IOException if there is an error when connecting to the OpenAI API.
+	 */
+	@Override
+	public BaseRemoteModel generateText(Map<String, Object> params) throws IOException {
+		
+		String url = API_BASE_URL + Config2.getInstance().getProperty("url.cohere.completions");
+
+        String json = ConnHelper.convertMaptToJson(params);
+
+        HttpURLConnection connection = (HttpURLConnection) new URL(url).openConnection();
+        connection.setRequestMethod("POST");
+        connection.setRequestProperty("Content-Type", "application/json");
+        connection.setRequestProperty("Authorization", "Bearer " + API_KEY);
+        connection.setRequestProperty("Cohere-Version", COHERE_VERSION);
+        connection.setDoOutput(true);
+
+        try (OutputStream outputStream = connection.getOutputStream()) {
+            outputStream.write(json.getBytes(StandardCharsets.UTF_8));
+        }
+
+        if (connection.getResponseCode() != HttpURLConnection.HTTP_OK) {
+        	String errorMessage = ConnHelper.getErrorMessage(connection);
+            throw new IOException(errorMessage);
+        }
+
+        // get the response and convert to model 
+        CohereLanguageResponse resModel = ConnHelper.convertSteamToModel(connection.getInputStream(), CohereLanguageResponse.class);
+        return resModel;
+	}
+    
+}

core/com.intellijava.core/src/main/resources/config.properties

@@ -5,4 +5,4 @@ url.openai.testkey=
 url.cohere.base=https://api.cohere.ai
 url.cohere.completions=/generate
 url.cohere.version=2022-12-06
-url.cohere.testkey=SWcvjpq7tCetHIuNaQL35CWXBOr4WIkaOR7EfmZ8
+url.cohere.testkey=

core/com.intellijava.core/src/test/java/com/intellijava/core/CohereModelConnectionTest.java

@@ -0,0 +1,85 @@
+package com.intellijava.core;
+
+import static org.junit.Assert.fail;
+
+import java.io.IOException;
+import java.util.HashMap;
+import java.util.List;
+import java.util.Map;
+import org.junit.Test;
+import com.intellijava.core.model.CohereLanguageResponse;
+import com.intellijava.core.model.CohereLanguageResponse.Generation;
+import com.intellijava.core.utils.Config2;
+import com.intellijava.core.wrappers.CohereAIWrapper;
+
+public class CohereModelConnectionTest {
+	
+	/**
+	 * coherKey - change the coherKey 
+	 */
+	private final String coherKey = Config2.getInstance().getProperty("url.cohere.testkey");
+
+	
+	@Test
+	public void testLanguageWrapper() {
+		
+		// prepare the object
+		CohereAIWrapper cohereWrapper = new CohereAIWrapper(coherKey);
+		
+		// prepare the prompt with training data
+		String targetIndustryIdea = "electric cars";
+		String prompt = "This program generates startup idea and name given the industry." +
+				"\n\nIndustry: Workplace" +
+				"\nStartup Idea: A platform that generates slide deck contents automatically based on a given outline" +
+				"\nStartup Name: Deckerize" +
+				"\n--" +
+				"\nIndustry: Home Decor" +
+				"\nStartup Idea: An app that calculates the best position of your indoor plants for your apartment" +
+				"\nStartup Name: Planteasy" +
+				"\n--" +
+				"\nIndustry: Healthcare" +
+				"\nStartup Idea: A hearing aid for the elderly that automatically adjusts its levels and with a battery lasting a whole week" +
+				"\nStartup Name: Hearspan" +
+				"\n\n--" +
+				"\nIndustry: Education" +
+				"\nStartup Idea: An online school that lets students mix and match their own curriculum based on their interests and goals" +
+				"\nStartup Name: Prime Age" +
+				"\n\n--" +
+				"\nIndustry: {industry}".replace("{industry}", targetIndustryIdea);
+		
+		// prepare the input parameters
+		Map<String, Object> params = new HashMap<>();
+        params.put("prompt", prompt);
+        params.put("model", "xlarge");
+        params.put("max_tokens", 40);
+        params.put("truncate", "END");
+        params.put("return_likelihoods", "NONE");
+        
+        
+        
+        // call the API
+        try {
+        	if (coherKey.isBlank()) return;
+        	
+        	CohereLanguageResponse resModel = (CohereLanguageResponse) cohereWrapper.generateText(params);
+        	
+        	List<Generation> responses = resModel.getGenerations();
+        	
+        	
+        	assert responses.size() > 0;
+        	
+        	for (Generation data: responses) {
+        		System.out.println(data.getText().toString());
+        	}
+        	
+        	
+		} catch (IOException e) {
+			if (coherKey.isBlank()) {
+				System.out.print("testLanguageWrapper: set the API key to run the test case.");
+			} else {
+				fail("testLanguageWrapper failed with exception: " + e.getMessage());
+			}
+		}
+	}
+	
+}

core/com.intellijava.core/src/test/java/com/intellijava/core/RemoteModelConnectionTest.java renamed to core/com.intellijava.core/src/test/java/com/intellijava/core/OpenaiModelConnectionTest.java

@@ -36,7 +36,7 @@
 /**
  * Unit test for Remote Language Model
  */
-public class RemoteModelConnectionTest {
+public class OpenaiModelConnectionTest {
 
 	/**
 	 * openaiKey - change the openaiKey 

core/com.intellijava.core/target/classes/config.properties

@@ -5,4 +5,4 @@ url.openai.testkey=
 url.cohere.base=https://api.cohere.ai
 url.cohere.completions=/generate
 url.cohere.version=2022-12-06
-url.cohere.testkey=SWcvjpq7tCetHIuNaQL35CWXBOr4WIkaOR7EfmZ8
+url.cohere.testkey=