@memberjunction/ai-mistral 2.32.2 → 2.34.0

package/dist/models/mistral.d.ts

@@ -4,7 +4,30 @@ export declare class MistralLLM extends BaseLLM {
     private _client;
     constructor(apiKey: string);
     get Client(): Mistral;
-    ChatCompletion(params: ChatParams): Promise<ChatResult>;
+    /**
+     * Mistral supports streaming
+     */
+    get SupportsStreaming(): boolean;
+    /**
+     * Implementation of non-streaming chat completion for Mistral
+     */
+    protected nonStreamingChatCompletion(params: ChatParams): Promise<ChatResult>;
+    /**
+     * Create a streaming request for Mistral
+     */
+    protected createStreamingRequest(params: ChatParams): Promise<any>;
+    /**
+     * Process a streaming chunk from Mistral
+     */
+    protected processStreamingChunk(chunk: any): {
+        content: string;
+        finishReason?: string;
+        usage?: any;
+    };
+    /**
+     * Create the final response from streaming results for Mistral
+     */
+    protected finalizeStreamingResponse(accumulatedContent: string | null | undefined, lastChunk: any | null | undefined, usage: any | null | undefined): ChatResult;
     SummarizeText(params: SummarizeParams): Promise<SummarizeResult>;
     ClassifyText(params: ClassifyParams): Promise<ClassifyResult>;
 }

package/dist/models/mistral.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mistral.d.ts","sourceRoot":"","sources":["../../src/models/mistral.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,UAAU,EAAoB,cAAc,EAAE,cAAc,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAEzJ,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAG/C,qBACa,UAAW,SAAQ,OAAO;IACnC,OAAO,CAAC,OAAO,CAAU;gBAEb,MAAM,EAAE,MAAM;IAO1B,IAAW,MAAM,IAAI,OAAO,CAAuB;IAEtC,cAAc,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IA4DvD,aAAa,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;IAIhE,YAAY,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;CAG7E;AAED,wBAAgB,cAAc,SAE7B"}
+{"version":3,"file":"mistral.d.ts","sourceRoot":"","sources":["../../src/models/mistral.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,UAAU,EAAoB,cAAc,EAAE,cAAc,EAAE,eAAe,EAAE,eAAe,EAA0B,MAAM,oBAAoB,CAAC;AAEjL,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAG/C,qBACa,UAAW,SAAQ,OAAO;IACnC,OAAO,CAAC,OAAO,CAAU;gBAEb,MAAM,EAAE,MAAM;IAO1B,IAAW,MAAM,IAAI,OAAO,CAAuB;IAEnD;;OAEG;IACH,IAAoB,iBAAiB,IAAI,OAAO,CAE/C;IAED;;OAEG;cACa,0BAA0B,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IA2DnF;;OAEG;cACa,sBAAsB,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC;IAcxE;;OAEG;IACH,SAAS,CAAC,qBAAqB,CAAC,KAAK,EAAE,GAAG,GAAG;QACzC,OAAO,EAAE,MAAM,CAAC;QAChB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,KAAK,CAAC,EAAE,GAAG,CAAC;KACf;IAiCD;;OAEG;IACH,SAAS,CAAC,yBAAyB,CAC/B,kBAAkB,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAC7C,SAAS,EAAE,GAAG,GAAG,IAAI,GAAG,SAAS,EACjC,KAAK,EAAE,GAAG,GAAG,IAAI,GAAG,SAAS,GAC9B,UAAU;IA+BA,aAAa,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;IAIhE,YAAY,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;CAG7E;AAED,wBAAgB,cAAc,SAE7B"}

package/dist/models/mistral.js

@@ -18,7 +18,16 @@ let MistralLLM = class MistralLLM extends ai_1.BaseLLM {
         });
     }
     get Client() { return this._client; }
-    async ChatCompletion(params) {
+    /**
+     * Mistral supports streaming
+     */
+    get SupportsStreaming() {
+        return true;
+    }
+    /**
+     * Implementation of non-streaming chat completion for Mistral
+     */
+    async nonStreamingChatCompletion(params) {
         const startTime = new Date();
         let responseFormat = undefined;
         if (params.responseFormat) {
@@ -69,6 +78,82 @@ let MistralLLM = class MistralLLM extends ai_1.BaseLLM {
             exception: null,
         };
     }
+    /**
+     * Create a streaming request for Mistral
+     */
+    async createStreamingRequest(params) {
+        let responseFormat = undefined;
+        if (params.responseFormat === 'JSON') {
+            responseFormat = { type: "json_object" };
+        }
+        return this.Client.chat.stream({
+            model: params.model,
+            messages: params.messages,
+            maxTokens: params.maxOutputTokens,
+            responseFormat: responseFormat
+        });
+    }
+    /**
+     * Process a streaming chunk from Mistral
+     */
+    processStreamingChunk(chunk) {
+        let content = '';
+        let usage = null;
+        if (chunk?.data?.choices && chunk.data.choices.length > 0) {
+            const choice = chunk.data.choices[0];
+            // Extract content from the choice delta
+            if (choice?.delta?.content) {
+                if (typeof choice.delta.content === 'string') {
+                    content = choice.delta.content;
+                }
+                else if (Array.isArray(choice.delta.content)) {
+                    content = choice.delta.content.join('');
+                }
+            }
+            // Save usage information if available
+            if (chunk?.data?.usage) {
+                usage = {
+                    promptTokens: chunk.data.usage.promptTokens || 0,
+                    completionTokens: chunk.data.usage.completionTokens || 0,
+                    totalTokens: chunk.data.usage.totalTokens || 0
+                };
+            }
+        }
+        return {
+            content,
+            finishReason: chunk?.data?.choices?.[0]?.finishReason,
+            usage
+        };
+    }
+    /**
+     * Create the final response from streaming results for Mistral
+     */
+    finalizeStreamingResponse(accumulatedContent, lastChunk, usage) {
+        // Create dates (will be overridden by base class)
+        const now = new Date();
+        // Create a proper ChatResult instance with constructor params
+        const result = new ai_1.ChatResult(true, now, now);
+        // Set all properties
+        result.data = {
+            choices: [{
+                    message: {
+                        role: 'assistant',
+                        content: accumulatedContent ? accumulatedContent : ''
+                    },
+                    finish_reason: lastChunk?.data?.choices?.[0]?.finishReason || 'stop',
+                    index: 0
+                }],
+            usage: usage || {
+                promptTokens: 0,
+                completionTokens: 0,
+                totalTokens: 0
+            }
+        };
+        result.statusText = 'success';
+        result.errorMessage = null;
+        result.exception = null;
+        return result;
+    }
     async SummarizeText(params) {
         throw new Error("Method not implemented.");
     }

package/dist/models/mistral.js.map

@@ -1 +1 @@
-{"version":3,"file":"mistral.js","sourceRoot":"","sources":["../../src/models/mistral.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"mistral.js","sourceRoot":"","sources":["../../src/models/mistral.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@memberjunction/ai-mistral",
-  "version": "2.32.2",
+  "version": "2.34.0",
   "description": "MemberJunction Wrapper for Mistral AI's AI Models",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -19,8 +19,8 @@
     "typescript": "^5.4.5"
   },
   "dependencies": {
-    "@memberjunction/ai": "2.32.2",
-    "@memberjunction/global": "2.32.2",
+    "@memberjunction/ai": "2.34.0",
+    "@memberjunction/global": "2.34.0",
     "@mistralai/mistralai": "^1.5.0",
     "axios-retry": "4.3.0"
   }

package/readme.md

@@ -1,2 +1,203 @@
-# @memberjunction/ai-gemini
-Simple wrapper class for Mistral AI's AI Models to use with the MemberJunction framework.
+# @memberjunction/ai-mistral
+
+A comprehensive wrapper for Mistral AI's models, enabling seamless integration with the MemberJunction AI framework for natural language processing tasks.
+
+## Features
+
+- **Mistral AI Integration**: Connect to Mistral's powerful language models
+- **Standardized Interface**: Implements MemberJunction's BaseLLM abstract class
+- **Token Usage Tracking**: Automatic tracking of prompt and completion tokens
+- **Response Format Control**: Support for standard text and JSON response formats
+- **Error Handling**: Robust error handling with detailed reporting
+- **Chat Completion**: Full support for chat-based interactions with Mistral models
+
+## Installation
+
+```bash
+npm install @memberjunction/ai-mistral
+```
+
+## Requirements
+
+- Node.js 16+
+- A Mistral AI API key
+- MemberJunction Core libraries
+
+## Usage
+
+### Basic Setup
+
+```typescript
+import { MistralLLM } from '@memberjunction/ai-mistral';
+
+// Initialize with your Mistral API key
+const mistralLLM = new MistralLLM('your-mistral-api-key');
+```
+
+### Chat Completion
+
+```typescript
+import { ChatParams } from '@memberjunction/ai';
+
+// Create chat parameters
+const chatParams: ChatParams = {
+  model: 'mistral-large-latest',  // or other models like 'open-mistral-7b', 'mistral-small-latest'
+  messages: [
+    { role: 'system', content: 'You are a helpful assistant.' },
+    { role: 'user', content: 'What are the main principles of machine learning?' }
+  ],
+  temperature: 0.7,
+  maxOutputTokens: 1000
+};
+
+// Get a response
+try {
+  const response = await mistralLLM.ChatCompletion(chatParams);
+  if (response.success) {
+    console.log('Response:', response.data.choices[0].message.content);
+    console.log('Token Usage:', response.data.usage);
+    console.log('Time Elapsed (ms):', response.timeElapsed);
+  } else {
+    console.error('Error:', response.errorMessage);
+  }
+} catch (error) {
+  console.error('Exception:', error);
+}
+```
+
+### JSON Response Format
+
+```typescript
+// Request a structured JSON response
+const jsonParams: ChatParams = {
+  model: 'mistral-large-latest',
+  messages: [
+    { role: 'system', content: 'You are a helpful assistant.' },
+    { role: 'user', content: 'Give me data about the top 3 machine learning algorithms in JSON format' }
+  ],
+  maxOutputTokens: 1000,
+  responseFormat: 'JSON'  // This will add the appropriate response_format parameter
+};
+
+const jsonResponse = await mistralLLM.ChatCompletion(jsonParams);
+
+// Parse the JSON response
+if (jsonResponse.success) {
+  const structuredData = JSON.parse(jsonResponse.data.choices[0].message.content);
+  console.log('Structured Data:', structuredData);
+}
+```
+
+### Direct Access to Mistral Client
+
+```typescript
+// Access the underlying Mistral client for advanced usage
+const mistralClient = mistralLLM.Client;
+
+// Use the client directly if needed
+const modelList = await mistralClient.listModels();
+console.log('Available models:', modelList);
+```
+
+## Supported Models
+
+Mistral AI offers several models with different capabilities and price points:
+
+- `mistral-large-latest`: Mistral's most powerful model (at the time of writing)
+- `mistral-medium-latest`: Mid-tier model balancing performance and cost
+- `mistral-small-latest`: Smaller, more efficient model
+- `open-mistral-7b`: Open-source 7B parameter model
+- `open-mixtral-8x7b`: Open-source mixture-of-experts model
+
+Check the [Mistral AI documentation](https://docs.mistral.ai/) for the latest list of supported models.
+
+## API Reference
+
+### MistralLLM Class
+
+A class that extends BaseLLM to provide Mistral-specific functionality.
+
+#### Constructor
+
+```typescript
+new MistralLLM(apiKey: string)
+```
+
+#### Properties
+
+- `Client`: (read-only) Returns the underlying Mistral client instance
+
+#### Methods
+
+- `ChatCompletion(params: ChatParams): Promise<ChatResult>` - Perform a chat completion
+- `SummarizeText(params: SummarizeParams): Promise<SummarizeResult>` - Not implemented yet
+- `ClassifyText(params: ClassifyParams): Promise<ClassifyResult>` - Not implemented yet
+
+## Response Format Control
+
+The wrapper supports different response formats:
+
+```typescript
+// For JSON responses
+const params: ChatParams = {
+  // ...other parameters
+  responseFormat: 'JSON'
+};
+
+// For regular text responses (default)
+const textParams: ChatParams = {
+  // ...other parameters
+  // No need to specify responseFormat for regular text
+};
+```
+
+## Error Handling
+
+The wrapper provides detailed error information:
+
+```typescript
+try {
+  const response = await mistralLLM.ChatCompletion(params);
+  if (!response.success) {
+    console.error('Error:', response.errorMessage);
+    console.error('Status:', response.statusText);
+    console.error('Exception:', response.exception);
+  }
+} catch (error) {
+  console.error('Exception occurred:', error);
+}
+```
+
+## Token Usage Tracking
+
+Monitor token usage for billing and quota management:
+
+```typescript
+const response = await mistralLLM.ChatCompletion(params);
+if (response.success) {
+  console.log('Prompt Tokens:', response.data.usage.promptTokens);
+  console.log('Completion Tokens:', response.data.usage.completionTokens);
+  console.log('Total Tokens:', response.data.usage.totalTokens);
+}
+```
+
+## Limitations
+
+Currently, the wrapper implements:
+- Chat completion functionality with token usage tracking
+
+Future implementations may include:
+- `SummarizeText` functionality
+- `ClassifyText` functionality
+- Streaming responses
+
+## Dependencies
+
+- `@mistralai/mistralai`: Official Mistral AI Node.js SDK
+- `@memberjunction/ai`: MemberJunction AI core framework
+- `@memberjunction/global`: MemberJunction global utilities
+- `axios-retry`: Retry mechanism for API calls
+
+## License
+
+ISC