viho-llm 0.1.7 → 0.1.8

package/README.md

@@ -99,15 +99,15 @@ import { OpenAIAPI } from 'viho-llm';
 const openai = OpenAIAPI({
   apiKey: 'your-openai-api-key',
   baseURL: 'https://api.openai.com/v1', // or your custom endpoint
-  modelID: 'gpt-4o',
-  modelThinking: 'enabled', // 'enabled' or 'disabled' for reasoning models
 });
 
 // Send a chat message
-const response = await openai.chat(
-  'You are a helpful assistant.', // system prompt
-  'Hello, how are you?', // user prompt
-);
+const response = await openai.chat({
+  modelID: 'gpt-4o',
+  modelThinking: 'enabled', // 'enabled' or 'disabled' for reasoning models
+  systemPrompt: 'You are a helpful assistant.',
+  userPrompt: 'Hello, how are you?',
+});
 
 console.log(response);
 ```
@@ -156,8 +156,12 @@ OpenAI streaming supports thinking/reasoning content for compatible models:
 ```javascript
 // Send a chat message with streaming (supports thinking mode)
 await openai.chatWithStreaming(
-  'You are a helpful assistant.', // system prompt
-  'Explain how neural networks work', // user prompt
+  {
+    modelID: 'deepseek-reasoner',
+    modelThinking: 'enabled',
+    systemPrompt: 'You are a helpful assistant.',
+    userPrompt: 'Explain how neural networks work',
+  },
   {
     beginCallback: () => {
       console.log('Stream started...');
@@ -413,21 +417,22 @@ Creates a new OpenAI client instance supporting OpenAI and compatible APIs.
 - `options` (Object) - Configuration options
   - `apiKey` (string) **required** - Your OpenAI API key or compatible service key
   - `baseURL` (string) **required** - API base URL (e.g., 'https://api.openai.com/v1')
-  - `modelID` (string) **required** - Model identifier (e.g., 'gpt-4o', 'deepseek-reasoner')
-  - `modelThinking` (string) **required** - Thinking mode: 'enabled' or 'disabled'
 
 #### Returns
 
 Returns an OpenAI client object with the following methods:
 
-##### `client.chat(systemPrompt, userPrompt)`
+##### `client.chat(chatOptions)`
 
 Sends a chat request to the OpenAI API.
 
 **Parameters:**
 
-- `systemPrompt` (string) **required** - System instruction/context for the model
-- `userPrompt` (string) **required** - User's message/question
+- `chatOptions` (Object) **required** - Chat configuration
+  - `modelID` (string) **required** - Model identifier (e.g., 'gpt-4o', 'deepseek-reasoner')
+  - `modelThinking` (string) **required** - Thinking mode: 'enabled' or 'disabled'
+  - `systemPrompt` (string) **required** - System instruction/context for the model
+  - `userPrompt` (string) **required** - User's message/question
 
 **Returns:**
 
@@ -436,21 +441,26 @@ Sends a chat request to the OpenAI API.
 **Example:**
 
 ```javascript
-const response = await openai.chat(
-  'You are a helpful coding assistant.',
-  'Write a Python function to reverse a string',
-);
+const response = await openai.chat({
+  modelID: 'gpt-4o',
+  modelThinking: 'disabled',
+  systemPrompt: 'You are a helpful coding assistant.',
+  userPrompt: 'Write a Python function to reverse a string',
+});
 console.log(response.content);
 ```
 
-##### `client.chatWithStreaming(systemPrompt, userPrompt, callbackOptions)`
+##### `client.chatWithStreaming(chatOptions, callbackOptions)`
 
 Sends a chat request to the OpenAI API with streaming response and thinking support.
 
 **Parameters:**
 
-- `systemPrompt` (string) **required** - System instruction/context for the model
-- `userPrompt` (string) **required** - User's message/question
+- `chatOptions` (Object) **required** - Chat configuration
+  - `modelID` (string) **required** - Model identifier (e.g., 'gpt-4o', 'deepseek-reasoner')
+  - `modelThinking` (string) **required** - Thinking mode: 'enabled' or 'disabled'
+  - `systemPrompt` (string) **required** - System instruction/context for the model
+  - `userPrompt` (string) **required** - User's message/question
 
 - `callbackOptions` (Object) **required** - Callback functions for handling stream events
   - `beginCallback` (Function) - Called when the stream begins
@@ -471,17 +481,25 @@ Sends a chat request to the OpenAI API with streaming response and thinking supp
 **Example:**
 
 ```javascript
-await openai.chatWithStreaming('You are a math tutor.', 'Solve: What is 15% of 240?', {
-  thinkingCallback: (thinking) => {
-    console.log('Thinking:', thinking);
-  },
-  contentCallback: (chunk) => {
-    process.stdout.write(chunk);
+await openai.chatWithStreaming(
+  {
+    modelID: 'deepseek-reasoner',
+    modelThinking: 'enabled',
+    systemPrompt: 'You are a math tutor.',
+    userPrompt: 'Solve: What is 15% of 240?',
   },
-  endCallback: () => {
-    console.log('\nDone!');
+  {
+    thinkingCallback: (thinking) => {
+      console.log('Thinking:', thinking);
+    },
+    contentCallback: (chunk) => {
+      process.stdout.write(chunk);
+    },
+    endCallback: () => {
+      console.log('\nDone!');
+    },
   },
-});
+);
 ```
 
 ## License

package/index.js

@@ -370,13 +370,10 @@ const logger$1 = qiao_log_js.Logger('openai-util.js');
 /**
  * chat
  * @param {*} client
- * @param {*} modelID
- * @param {*} modelThinking
- * @param {*} systemPrompt
- * @param {*} userPrompt
+ * @param {*} options
  * @returns
  */
-const chat = async (client, modelID, modelThinking, systemPrompt, userPrompt) => {
+const chat = async (client, options) => {
   const methodName = 'chat';
 
   // check
@@ -384,32 +381,36 @@ const chat = async (client, modelID, modelThinking, systemPrompt, userPrompt) =>
     logger$1.error(methodName, 'need client');
     return;
   }
-  if (!modelID) {
-    logger$1.error(methodName, 'need modelID');
+  if (!options) {
+    logger$1.error(methodName, 'need options');
+    return;
+  }
+  if (!options.modelID) {
+    logger$1.error(methodName, 'need options.modelID');
     return;
   }
-  if (!modelThinking) {
-    logger$1.error(methodName, 'need modelThinking');
+  if (!options.modelThinking) {
+    logger$1.error(methodName, 'need options.modelThinking');
     return;
   }
-  if (!systemPrompt) {
-    logger$1.error(methodName, 'need systemPrompt');
+  if (!options.systemPrompt) {
+    logger$1.error(methodName, 'need options.systemPrompt');
     return;
   }
-  if (!userPrompt) {
-    logger$1.error(methodName, 'need userPrompt');
+  if (!options.userPrompt) {
+    logger$1.error(methodName, 'need options.userPrompt');
     return;
   }
 
   // chat
   const chatOptions = {
-    model: modelID,
+    model: options.modelID,
     messages: [
-      { role: 'system', content: systemPrompt },
-      { role: 'user', content: userPrompt },
+      { role: 'system', content: options.systemPrompt },
+      { role: 'user', content: options.userPrompt },
     ],
     thinking: {
-      type: modelThinking,
+      type: options.modelThinking,
     },
   };
 
@@ -425,14 +426,11 @@ const chat = async (client, modelID, modelThinking, systemPrompt, userPrompt) =>
 /**
  * chatWithStreaming
  * @param {*} client
- * @param {*} modelID
- * @param {*} modelThinking
- * @param {*} systemPrompt
- * @param {*} userPrompt
+ * @param {*} options
  * @param {*} callbackOptions
  * @returns
  */
-const chatWithStreaming = async (client, modelID, modelThinking, systemPrompt, userPrompt, callbackOptions) => {
+const chatWithStreaming = async (client, options, callbackOptions) => {
   const methodName = 'chatWithStreaming';
 
   // check
@@ -440,20 +438,24 @@ const chatWithStreaming = async (client, modelID, modelThinking, systemPrompt, u
     logger$1.error(methodName, 'need client');
     return;
   }
-  if (!modelID) {
-    logger$1.error(methodName, 'need modelID');
+  if (!options) {
+    logger$1.error(methodName, 'need options');
     return;
   }
-  if (!modelThinking) {
-    logger$1.error(methodName, 'need modelThinking');
+  if (!options.modelID) {
+    logger$1.error(methodName, 'need options.modelID');
     return;
   }
-  if (!systemPrompt) {
-    logger$1.error(methodName, 'need systemPrompt');
+  if (!options.modelThinking) {
+    logger$1.error(methodName, 'need options.modelThinking');
     return;
   }
-  if (!userPrompt) {
-    logger$1.error(methodName, 'need userPrompt');
+  if (!options.systemPrompt) {
+    logger$1.error(methodName, 'need options.systemPrompt');
+    return;
+  }
+  if (!options.userPrompt) {
+    logger$1.error(methodName, 'need options.userPrompt');
     return;
   }
   if (!callbackOptions) {
@@ -472,13 +474,13 @@ const chatWithStreaming = async (client, modelID, modelThinking, systemPrompt, u
 
   // chat
   const chatOptions = {
-    model: modelID,
+    model: options.modelID,
     messages: [
-      { role: 'system', content: systemPrompt },
-      { role: 'user', content: userPrompt },
+      { role: 'system', content: options.systemPrompt },
+      { role: 'user', content: options.userPrompt },
     ],
     thinking: {
-      type: modelThinking,
+      type: options.modelThinking,
     },
   };
 
@@ -546,14 +548,6 @@ const OpenAIAPI = (options) => {
     logger.error(methodName, 'need options.baseURL');
     return;
   }
-  if (!options.modelID) {
-    logger.error(methodName, 'need options.modelID');
-    return;
-  }
-  if (!options.modelThinking) {
-    logger.error(methodName, 'need options.modelThinking');
-    return;
-  }
 
   // openai
   const openai = {};
@@ -563,20 +557,13 @@ const OpenAIAPI = (options) => {
   });
 
   // chat
-  openai.chat = async (systemPrompt, userPrompt) => {
-    return await chat(openai.client, options.modelID, options.modelThinking, systemPrompt, userPrompt);
+  openai.chat = async (chatOptions) => {
+    return await chat(openai.client, chatOptions);
   };
 
   // chat with streaming
-  openai.chatWithStreaming = async (systemPrompt, userPrompt, callbakOptions) => {
-    return await chatWithStreaming(
-      openai.client,
-      options.modelID,
-      options.modelThinking,
-      systemPrompt,
-      userPrompt,
-      callbakOptions,
-    );
+  openai.chatWithStreaming = async (chatOptions, callbakOptions) => {
+    return await chatWithStreaming(openai.client, chatOptions, callbakOptions);
   };
 
   //

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "viho-llm",
-  "version": "0.1.7",
+  "version": "0.1.8",
   "description": "Utility library for working with multiple LLM providers (Google Gemini and OpenAI), providing common tools and helpers for AI interactions",
   "keywords": [
     "llm",
@@ -68,5 +68,5 @@
       }
     }
   },
-  "gitHead": "21b7c541435da99dceb5dcf657ac5a528ed792ba"
+  "gitHead": "7d413880dd77b08d2f09ebff758510a357f0f095"
 }

package/src/models/openai-util.js

@@ -5,13 +5,10 @@ const logger = Logger('openai-util.js');
 /**
  * chat
  * @param {*} client
- * @param {*} modelID
- * @param {*} modelThinking
- * @param {*} systemPrompt
- * @param {*} userPrompt
+ * @param {*} options
  * @returns
  */
-export const chat = async (client, modelID, modelThinking, systemPrompt, userPrompt) => {
+export const chat = async (client, options) => {
   const methodName = 'chat';
 
   // check
@@ -19,32 +16,36 @@ export const chat = async (client, modelID, modelThinking, systemPrompt, userPro
     logger.error(methodName, 'need client');
     return;
   }
-  if (!modelID) {
-    logger.error(methodName, 'need modelID');
+  if (!options) {
+    logger.error(methodName, 'need options');
     return;
   }
-  if (!modelThinking) {
-    logger.error(methodName, 'need modelThinking');
+  if (!options.modelID) {
+    logger.error(methodName, 'need options.modelID');
     return;
   }
-  if (!systemPrompt) {
-    logger.error(methodName, 'need systemPrompt');
+  if (!options.modelThinking) {
+    logger.error(methodName, 'need options.modelThinking');
     return;
   }
-  if (!userPrompt) {
-    logger.error(methodName, 'need userPrompt');
+  if (!options.systemPrompt) {
+    logger.error(methodName, 'need options.systemPrompt');
+    return;
+  }
+  if (!options.userPrompt) {
+    logger.error(methodName, 'need options.userPrompt');
     return;
   }
 
   // chat
   const chatOptions = {
-    model: modelID,
+    model: options.modelID,
     messages: [
-      { role: 'system', content: systemPrompt },
-      { role: 'user', content: userPrompt },
+      { role: 'system', content: options.systemPrompt },
+      { role: 'user', content: options.userPrompt },
     ],
     thinking: {
-      type: modelThinking,
+      type: options.modelThinking,
     },
   };
 
@@ -60,14 +61,11 @@ export const chat = async (client, modelID, modelThinking, systemPrompt, userPro
 /**
  * chatWithStreaming
  * @param {*} client
- * @param {*} modelID
- * @param {*} modelThinking
- * @param {*} systemPrompt
- * @param {*} userPrompt
+ * @param {*} options
  * @param {*} callbackOptions
  * @returns
  */
-export const chatWithStreaming = async (client, modelID, modelThinking, systemPrompt, userPrompt, callbackOptions) => {
+export const chatWithStreaming = async (client, options, callbackOptions) => {
   const methodName = 'chatWithStreaming';
 
   // check
@@ -75,20 +73,24 @@ export const chatWithStreaming = async (client, modelID, modelThinking, systemPr
     logger.error(methodName, 'need client');
     return;
   }
-  if (!modelID) {
-    logger.error(methodName, 'need modelID');
+  if (!options) {
+    logger.error(methodName, 'need options');
+    return;
+  }
+  if (!options.modelID) {
+    logger.error(methodName, 'need options.modelID');
     return;
   }
-  if (!modelThinking) {
-    logger.error(methodName, 'need modelThinking');
+  if (!options.modelThinking) {
+    logger.error(methodName, 'need options.modelThinking');
     return;
   }
-  if (!systemPrompt) {
-    logger.error(methodName, 'need systemPrompt');
+  if (!options.systemPrompt) {
+    logger.error(methodName, 'need options.systemPrompt');
     return;
   }
-  if (!userPrompt) {
-    logger.error(methodName, 'need userPrompt');
+  if (!options.userPrompt) {
+    logger.error(methodName, 'need options.userPrompt');
     return;
   }
   if (!callbackOptions) {
@@ -107,13 +109,13 @@ export const chatWithStreaming = async (client, modelID, modelThinking, systemPr
 
   // chat
   const chatOptions = {
-    model: modelID,
+    model: options.modelID,
     messages: [
-      { role: 'system', content: systemPrompt },
-      { role: 'user', content: userPrompt },
+      { role: 'system', content: options.systemPrompt },
+      { role: 'user', content: options.userPrompt },
     ],
     thinking: {
-      type: modelThinking,
+      type: options.modelThinking,
     },
   };
 

package/src/models/openai.js

@@ -29,14 +29,6 @@ export const OpenAIAPI = (options) => {
     logger.error(methodName, 'need options.baseURL');
     return;
   }
-  if (!options.modelID) {
-    logger.error(methodName, 'need options.modelID');
-    return;
-  }
-  if (!options.modelThinking) {
-    logger.error(methodName, 'need options.modelThinking');
-    return;
-  }
 
   // openai
   const openai = {};
@@ -46,20 +38,13 @@ export const OpenAIAPI = (options) => {
   });
 
   // chat
-  openai.chat = async (systemPrompt, userPrompt) => {
-    return await chat(openai.client, options.modelID, options.modelThinking, systemPrompt, userPrompt);
+  openai.chat = async (chatOptions) => {
+    return await chat(openai.client, chatOptions);
   };
 
   // chat with streaming
-  openai.chatWithStreaming = async (systemPrompt, userPrompt, callbakOptions) => {
-    return await chatWithStreaming(
-      openai.client,
-      options.modelID,
-      options.modelThinking,
-      systemPrompt,
-      userPrompt,
-      callbakOptions,
-    );
+  openai.chatWithStreaming = async (chatOptions, callbakOptions) => {
+    return await chatWithStreaming(openai.client, chatOptions, callbakOptions);
   };
 
   //