deprecating safeMode in favour of safePrompt

src/client.d.ts

@@ -101,7 +101,11 @@ declare module '@mistralai/mistralai' {
             topP?: number,
             randomSeed?: number,
             stream?: boolean,
-            safeMode?: boolean
+            /**
+             * @deprecated use safePrompt instead
+             */
+            safeMode?: boolean,
+            safePrompt?: boolean
         ): object;
 
         listModels(): Promise<ListModelsResponse>;
@@ -113,7 +117,11 @@ declare module '@mistralai/mistralai' {
             maxTokens?: number;
             topP?: number;
             randomSeed?: number;
+            /**
+             * @deprecated use safePrompt instead
+             */
             safeMode?: boolean;
+            safePrompt?: boolean;
         }): Promise<ChatCompletionResponse>;
 
         chatStream(options: {
@@ -123,7 +131,11 @@ declare module '@mistralai/mistralai' {
             maxTokens?: number;
             topP?: number;
             randomSeed?: number;
+            /**
+             * @deprecated use safePrompt instead
+             */
             safeMode?: boolean;
+            safePrompt?: boolean;
         }): AsyncGenerator<ChatCompletionResponseChunk, void, unknown>;
 
         embeddings(options: {

src/client.js

@@ -153,7 +153,8 @@ class MistralClient {
    * @param {*} topP
    * @param {*} randomSeed
    * @param {*} stream
-   * @param {*} safeMode
+   * @param {*} safeMode deprecated use safePrompt instead
+   * @param {*} safePrompt
    * @return {Promise<Object>}
    */
   _makeChatCompletionRequest = function(
@@ -165,6 +166,7 @@ class MistralClient {
     randomSeed,
     stream,
     safeMode,
+    safePrompt,
   ) {
     return {
       model: model,
@@ -174,7 +176,7 @@ class MistralClient {
       top_p: topP ?? undefined,
       random_seed: randomSeed ?? undefined,
       stream: stream ?? undefined,
-      safe_prompt: safeMode ?? undefined,
+      safe_prompt: (safeMode || safePrompt) ?? undefined,
     };
   };
 
@@ -196,7 +198,8 @@ class MistralClient {
    * @param {*} maxTokens the maximum number of tokens to generate, e.g. 100
    * @param {*} topP the cumulative probability of tokens to generate, e.g. 0.9
    * @param {*} randomSeed the random seed to use for sampling, e.g. 42
-   * @param {*} safeMode whether to use safe mode, e.g. true
+   * @param {*} safeMode deprecated use safePrompt instead
+   * @param {*} safePrompt whether to use safe mode, e.g. true
    * @return {Promise<Object>}
    */
   chat = async function({
@@ -207,6 +210,7 @@ class MistralClient {
     topP,
     randomSeed,
     safeMode,
+    safePrompt,
   }) {
     const request = this._makeChatCompletionRequest(
       model,
@@ -217,6 +221,7 @@ class MistralClient {
       randomSeed,
       false,
       safeMode,
+      safePrompt,
     );
     const response = await this._request(
       'post',
@@ -235,7 +240,8 @@ class MistralClient {
    * @param {*} maxTokens the maximum number of tokens to generate, e.g. 100
    * @param {*} topP the cumulative probability of tokens to generate, e.g. 0.9
    * @param {*} randomSeed the random seed to use for sampling, e.g. 42
-   * @param {*} safeMode whether to use safe mode, e.g. true
+   * @param {*} safeMode deprecated use safePrompt instead
+   * @param {*} safePrompt whether to use safe mode, e.g. true
    * @return {Promise<Object>}
    */
   chatStream = async function* ({
@@ -246,6 +252,7 @@ class MistralClient {
     topP,
     randomSeed,
     safeMode,
+    safePrompt,
   }) {
     const request = this._makeChatCompletionRequest(
       model,
@@ -256,6 +263,7 @@ class MistralClient {
       randomSeed,
       true,
       safeMode,
+      safePrompt,
     );
     const response = await this._request(
       'post',

tests/client.test.js

@@ -33,6 +33,42 @@ describe('Mistral Client', () => {
       });
       expect(response).toEqual(mockResponse);
     });
+
+    it('should return a chat response object if safeMode is set', async() => {
+      // Mock the fetch function
+      const mockResponse = mockChatResponsePayload();
+      globalThis.fetch = mockFetch(200, mockResponse);
+
+      const response = await client.chat({
+        model: 'mistral-small',
+        messages: [
+          {
+            role: 'user',
+            content: 'What is the best French cheese?',
+          },
+        ],
+        safeMode: true,
+      });
+      expect(response).toEqual(mockResponse);
+    });
+
+    it('should return a chat response object if safePrompt is set', async() => {
+      // Mock the fetch function
+      const mockResponse = mockChatResponsePayload();
+      globalThis.fetch = mockFetch(200, mockResponse);
+
+      const response = await client.chat({
+        model: 'mistral-small',
+        messages: [
+          {
+            role: 'user',
+            content: 'What is the best French cheese?',
+          },
+        ],
+        safePrompt: true,
+      });
+      expect(response).toEqual(mockResponse);
+    });
   });
 
   describe('chatStream()', () => {
@@ -58,6 +94,54 @@ describe('Mistral Client', () => {
 
       expect(parsedResponse.length).toEqual(11);
     });
+
+    it('should return parsed, streamed response with safeMode', async() => {
+      // Mock the fetch function
+      const mockResponse = mockChatResponseStreamingPayload();
+      globalThis.fetch = mockFetchStream(200, mockResponse);
+
+      const response = await client.chatStream({
+        model: 'mistral-small',
+        messages: [
+          {
+            role: 'user',
+            content: 'What is the best French cheese?',
+          },
+        ],
+        safeMode: true,
+      });
+
+      const parsedResponse = [];
+      for await (const r of response) {
+        parsedResponse.push(r);
+      }
+
+      expect(parsedResponse.length).toEqual(11);
+    });
+
+    it('should return parsed, streamed response with safePrompt', async() => {
+      // Mock the fetch function
+      const mockResponse = mockChatResponseStreamingPayload();
+      globalThis.fetch = mockFetchStream(200, mockResponse);
+
+      const response = await client.chatStream({
+        model: 'mistral-small',
+        messages: [
+          {
+            role: 'user',
+            content: 'What is the best French cheese?',
+          },
+        ],
+        safePrompt: true,
+      });
+
+      const parsedResponse = [];
+      for await (const r of response) {
+        parsedResponse.push(r);
+      }
+
+      expect(parsedResponse.length).toEqual(11);
+    });
   });
 
   describe('embeddings()', () => {