ohlcv-ai 1.0.8 → 1.1.0

package/dist/index.d.ts

@@ -14,17 +14,19 @@ export declare class AliyunAI {
     /**
      * Simplest method: single conversation
      * @param message - User message
+     * @param i18n - Language restriction for AI response
      * @param options - Chat options
      * @returns AI response
      */
-    chat(message: string, options?: AliYunChatOptions): Promise<string>;
+    chat(message: string, i18n: 'en' | 'cn', options?: AliYunChatOptions): Promise<string>;
     /**
      * Multi-turn conversation
      * @param messages - Message history
+     * @param i18n - Language restriction for AI response
      * @param options - Chat options
      * @returns Complete API response
      */
-    chatCompletion(messages: ChatMessage[], options?: {
+    chatCompletion(messages: ChatMessage[], i18n: 'en' | 'cn', options?: {
         temperature?: number;
         maxTokens?: number;
         stream?: boolean;
@@ -34,13 +36,58 @@ export declare class AliyunAI {
      * Streaming conversation (only supports OpenAI format)
      * @param messages - Message history
      * @param callback - Streaming callback function
+     * @param i18n - Language restriction for AI response
      * @param options - Chat options
      */
-    chatStream(messages: ChatMessage[], callback: AliYunStreamCallback, options?: {
+    chatStream(messages: ChatMessage[], callback: AliYunStreamCallback, i18n: 'en' | 'cn', options?: {
         temperature?: number;
         maxTokens?: number;
         modelType?: AliYunModelType;
     }): Promise<void>;
+    /**
+     * Analyze OHLCV data and return AI analysis results
+     * @param ohlcvArray - OHLCV data array
+     * @param i18n - Language restriction for AI response
+     * @param analysisType - Analysis type (optional, default: "comprehensive")
+     *   - "trend": Trend analysis
+     *   - "volume": Volume analysis
+     *   - "technical": Technical analysis
+     *   - "comprehensive": Comprehensive analysis
+     * @param message - User's subjective request or specific question (optional)
+     * @param options - Chat options
+     * @returns AI analysis result of OHLCV data (text description)
+     */
+    analyzeOHLCV(ohlcvArray: OHLCV[], i18n: 'en' | 'cn', analysisType?: 'trend' | 'volume' | 'technical' | 'comprehensive', message?: string, options?: AliYunChatOptions): Promise<string>;
+    /**
+     * Enhanced version: Analyze OHLCV and return structured results (optional)
+     * @param ohlcvArray - OHLCV data array
+     * @param i18n - Language restriction for AI response
+     * @param analysisType - Analysis type
+     * @param message - User's subjective request or specific question
+     * @param structured - Whether to return structured results (default: false)
+     * @param options - Chat options
+     * @returns AI analysis results
+     */
+    analyzeOHLCVEnhanced(ohlcvArray: OHLCV[], i18n: 'en' | 'cn', analysisType?: 'trend' | 'volume' | 'technical' | 'comprehensive', message?: string, structured?: boolean, options?: AliYunChatOptions): Promise<string | {
+        summary: string;
+        details: string[];
+        recommendations: string[];
+    }>;
+    /**
+     * Specialized method for processing OHLCV arrays
+     * @param ohlcvArray - OHLCV data array
+     * @param i18n - Language restriction for AI response
+     * @param instructions - Processing instructions, supports Chinese and English (optional, default: "Based on these OHLCV data, predict the next period")
+     * @param count - Number of OHLCV data items to return (optional, default: 1)
+     * @param options - Chat options
+     * @returns Predicted OHLCV array
+     */
+    predictingOHLCV(ohlcvArray: OHLCV[], i18n: 'en' | 'cn', instructions?: string, count?: number, options?: AliYunChatOptions): Promise<OHLCV[]>;
+    /**
+     * Parse AI returned OHLCV response
+     * @private
+     */
+    private parseOHLCVResponse;
     /**
      * Switch model
      * @param modelType - New model type
@@ -69,20 +116,6 @@ export declare class AliyunAI {
     private makeRequest;
     private makeStreamRequest;
     private extractContent;
-    /**
-     * Specialized method for processing OHLCV arrays
-     * @param ohlcvArray - OHLCV data array
-     * @param instructions - Processing instructions, supports Chinese and English (optional, default: "Based on these OHLCV data, predict the next period")
-     * @param count - Number of OHLCV data items to return (optional, default: 1)
-     * @param options - Chat options
-     * @returns Predicted OHLCV array
-     */
-    predictingOHLCV(ohlcvArray: OHLCV[], instructions?: string, count?: number, options?: AliYunChatOptions): Promise<OHLCV[]>;
-    /**
-     * Parse AI returned OHLCV response
-     * @private
-     */
-    private parseOHLCVResponse;
 }
 
 export declare interface AliYunChatOptions {
@@ -182,26 +215,79 @@ export declare class DeepSeekAI {
      */
     constructor(config: DeepSeekConfig);
     /**
-     * Simplest method: single conversation
+     * Simplest method: single conversation with i18n support
      * @param message - User message
+     * @param i18n - Language restriction for AI response
      * @param options - Chat options
      * @returns AI response
      */
-    chat(message: string, options?: DeepSeekChatOptions): Promise<string>;
+    chat(message: string, i18n: 'en' | 'cn', options?: DeepSeekChatOptions): Promise<string>;
     /**
-     * Multi-turn conversation
+     * Multi-turn conversation with i18n support
      * @param messages - Message history
+     * @param i18n - Language restriction for AI response
      * @param options - Chat options
      * @returns Complete API response
      */
-    chatCompletion(messages: DeepSeekChatMessage[], options?: DeepSeekChatOptions): Promise<any>;
+    chatCompletion(messages: DeepSeekChatMessage[], i18n: 'en' | 'cn', options?: {
+        temperature?: number;
+        maxTokens?: number;
+        stream?: boolean;
+        modelType?: DeepSeekModelType;
+        topP?: number;
+        frequencyPenalty?: number;
+        presencePenalty?: number;
+        stop?: string[];
+        tools?: any[];
+        toolChoice?: string | object;
+    }): Promise<any>;
     /**
-     * Streaming conversation
+     * Streaming conversation with i18n support
      * @param messages - Message history
      * @param callback - Streaming callback function
+     * @param i18n - Language restriction for AI response
      * @param options - Chat options
      */
-    chatStream(messages: DeepSeekChatMessage[], callback: DeepSeekStreamCallback, options?: DeepSeekChatOptions): Promise<void>;
+    chatStream(messages: DeepSeekChatMessage[], callback: DeepSeekStreamCallback, i18n: 'en' | 'cn', options?: {
+        temperature?: number;
+        maxTokens?: number;
+        modelType?: DeepSeekModelType;
+        topP?: number;
+        frequencyPenalty?: number;
+        presencePenalty?: number;
+        stop?: string[];
+        tools?: any[];
+        toolChoice?: string | object;
+    }): Promise<void>;
+    /**
+     * Analyze OHLCV data and return AI analysis results (text description)
+     * @param ohlcvArray - OHLCV data array
+     * @param i18n - Language restriction for AI response
+     * @param analysisType - Analysis type (optional, default: "comprehensive")
+     *   - "trend": Trend analysis
+     *   - "volume": Volume analysis
+     *   - "technical": Technical analysis
+     *   - "comprehensive": Comprehensive analysis
+     * @param message - User's subjective request or specific question (optional)
+     * @param options - Chat options
+     * @returns AI analysis result of OHLCV data (text description)
+     */
+    analyzeOHLCV(ohlcvArray: OHLCV[], i18n: 'en' | 'cn', analysisType?: 'trend' | 'volume' | 'technical' | 'comprehensive', message?: string, options?: DeepSeekChatOptions): Promise<string>;
+    /**
+     * Enhanced version: Analyze OHLCV and return structured results (optional)
+     * @param ohlcvArray - OHLCV data array
+     * @param i18n - Language restriction for AI response
+     * @param analysisType - Analysis type
+     * @param message - User's subjective request or specific question
+     * @param structured - Whether to return structured results (default: false)
+     * @param options - Chat options
+     * @returns AI analysis results
+     */
+    analyzeOHLCVEnhanced(ohlcvArray: OHLCV[], i18n: 'en' | 'cn', analysisType?: 'trend' | 'volume' | 'technical' | 'comprehensive', message?: string, structured?: boolean, options?: DeepSeekChatOptions): Promise<string | {
+        summary: string;
+        details: string[];
+        recommendations: string[];
+    }>;
     /**
      * Specialized method for processing OHLCV arrays
      * @param ohlcvArray - OHLCV data array
@@ -225,7 +311,7 @@ export declare class DeepSeekAI {
         description?: string;
     };
     /**
-     * Test connection
+     * Test connection with i18n support
      * @returns Connection test result
      */
     testConnection(): Promise<{
@@ -260,6 +346,7 @@ export declare interface DeepSeekChatOptions {
     stop?: string[];
     tools?: any[];
     toolChoice?: string | object;
+    i18n?: 'en' | 'cn';
 }
 
 export declare interface DeepSeekConfig {
@@ -389,19 +476,21 @@ export declare class OpenAI {
      */
     constructor(config: OpenAIConfig);
     /**
-     * Simplest method: single conversation
+     * Simplest method: single conversation with i18n support
      * @param message - User message
+     * @param i18n - Language restriction for AI response
      * @param options - Chat options
      * @returns AI response
      */
-    chat(message: string, options?: OpenAIChatOptions): Promise<string>;
+    chat(message: string, i18n: 'en' | 'cn', options?: OpenAIChatOptions): Promise<string>;
     /**
-     * Multi-turn conversation
+     * Multi-turn conversation with i18n support
      * @param messages - Message history
+     * @param i18n - Language restriction for AI response
      * @param options - Chat options
      * @returns Complete API response
      */
-    chatCompletion(messages: ChatMessage[], options?: {
+    chatCompletion(messages: ChatMessage[], i18n: 'en' | 'cn', options?: {
         temperature?: number;
         maxTokens?: number;
         stream?: boolean;
@@ -412,12 +501,13 @@ export declare class OpenAI {
         stop?: string[];
     }): Promise<any>;
     /**
-     * Streaming conversation
+     * Streaming conversation with i18n support
      * @param messages - Message history
      * @param callback - Streaming callback function
+     * @param i18n - Language restriction for AI response
      * @param options - Chat options
      */
-    chatStream(messages: ChatMessage[], callback: OpenAIStreamCallback, options?: {
+    chatStream(messages: ChatMessage[], callback: OpenAIStreamCallback, i18n: 'en' | 'cn', options?: {
         temperature?: number;
         maxTokens?: number;
         modelType?: OpenAIModelType;
@@ -426,6 +516,44 @@ export declare class OpenAI {
         presencePenalty?: number;
         stop?: string[];
     }): Promise<void>;
+    /**
+     * Analyze OHLCV data and return AI analysis results (text description)
+     * @param ohlcvArray - OHLCV data array
+     * @param i18n - Language restriction for AI response
+     * @param analysisType - Analysis type (optional, default: "comprehensive")
+     *   - "trend": Trend analysis
+     *   - "volume": Volume analysis
+     *   - "technical": Technical analysis
+     *   - "comprehensive": Comprehensive analysis
+     * @param message - User's subjective request or specific question (optional)
+     * @param options - Chat options
+     * @returns AI analysis result of OHLCV data (text description)
+     */
+    analyzeOHLCV(ohlcvArray: OHLCV[], i18n: 'en' | 'cn', analysisType?: 'trend' | 'volume' | 'technical' | 'comprehensive', message?: string, options?: OpenAIChatOptions): Promise<string>;
+    /**
+     * Enhanced version: Analyze OHLCV and return structured results (optional)
+     * @param ohlcvArray - OHLCV data array
+     * @param i18n - Language restriction for AI response
+     * @param analysisType - Analysis type
+     * @param message - User's subjective request or specific question
+     * @param structured - Whether to return structured results (default: false)
+     * @param options - Chat options
+     * @returns AI analysis results
+     */
+    analyzeOHLCVEnhanced(ohlcvArray: OHLCV[], i18n: 'en' | 'cn', analysisType?: 'trend' | 'volume' | 'technical' | 'comprehensive', message?: string, structured?: boolean, options?: OpenAIChatOptions): Promise<string | {
+        summary: string;
+        details: string[];
+        recommendations: string[];
+    }>;
+    /**
+     * Specialized method for processing OHLCV arrays (predict future values)
+     * @param ohlcvArray - OHLCV data array
+     * @param instructions - Processing instructions, supports Chinese and English (optional, default: "Based on these OHLCV data, predict the next period")
+     * @param count - Number of OHLCV data items to return (optional, default: 1)
+     * @param options - Chat options
+     * @returns Predicted OHLCV array
+     */
+    predictingOHLCV(ohlcvArray: OHLCV[], instructions?: string, count?: number, options?: OpenAIChatOptions): Promise<OHLCV[]>;
     /**
      * Generate images using DALL-E
      * @param prompt - Image generation prompt
@@ -498,7 +626,7 @@ export declare class OpenAI {
         description?: string;
     };
     /**
-     * Test connection
+     * Test connection with i18n support
      * @returns Connection test result
      */
     testConnection(): Promise<{
@@ -524,15 +652,6 @@ export declare class OpenAI {
     private makeFormDataRequest;
     private makeStreamRequest;
     private extractContent;
-    /**
-     * Specialized method for processing OHLCV arrays
-     * @param ohlcvArray - OHLCV data array
-     * @param instructions - Processing instructions (optional, default: "Based on these OHLCV data, predict the next period")
-     * @param count - Number of OHLCV data items to return (optional, default: 1)
-     * @param options - Chat options
-     * @returns Predicted OHLCV array
-     */
-    analyzeOHLCV(ohlcvArray: OHLCV[], instructions?: string, count?: number, options?: OpenAIChatOptions): Promise<OHLCV[]>;
     /**
      * Parse AI returned OHLCV response
      * @private
@@ -552,6 +671,7 @@ export declare interface OpenAIChatOptions {
     frequencyPenalty?: number;
     presencePenalty?: number;
     stop?: string[];
+    i18n?: 'en' | 'cn';
 }
 
 export declare interface OpenAIConfig {
@@ -621,6 +741,12 @@ export declare enum OpenAIModelType {
 
 export declare type OpenAIStreamCallback = (chunk: string, isEnd: boolean) => void;
 
+export declare function stringToAliYunModelType(modelString: string): AliYunModelType | null;
+
+export declare function stringToDeepSeekModelType(modelString: string): DeepSeekModelType | null;
+
+export declare function stringToOpenAIModelType(modelString: string): OpenAIModelType | null;
+
 export declare function suggestModel(requirements: {
     taskType: 'chat' | 'completion' | 'embedding' | 'image' | 'audio';
     budget?: number;