feat: add MiniMax as first-class LLM provider

.env.template

@@ -28,6 +28,13 @@ AI_PROVIDER=
 AI_BASE_URL=
 MODEL=
 
+# MiniMax (alternative provider)
+# To use MiniMax instead of OpenRouter, set:
+#   AI_PROVIDER=minimax
+#   AI_API_KEY=<your MiniMax API key>
+# Base URL and model will default to https://api.minimax.io/v1 and MiniMax-M2.7.
+# You can also use MiniMax-M2.7-highspeed for faster responses.
+
 # Mistral (OCR)
 MISTRAL_API_KEY=
 

README.md

@@ -46,7 +46,8 @@ The project also makes use of several third party services
 
 - [Honcho](https://honcho.dev) for identity modeling and personalization
 - [Supabase](https://supabase.com) for user authentication and database
-- [Openrouter](https://openrouter.ai) for LLM integration
+- [Openrouter](https://openrouter.ai) for LLM integration (default)
+- [MiniMax](https://www.minimax.io) for LLM integration (alternative provider)
 - [PostHog](https://posthog.com) for analytics
 - [Stripe](https://stripe.com) for payments
 
@@ -81,10 +82,28 @@ Tutor-GPT webui. A `.env.template` file is provided to get started quickly.
 **LLM**
 
 - `AI_API_KEY` — The API key for the inference provider
-- `AI_PROVIDER` — The name of the LLM inference provider
+- `AI_PROVIDER` — The name of the LLM inference provider (e.g. `openrouter`, `minimax`)
 - `AI_BASE_URL` — An OpenAI compatible API endpoint for LLM inference
 - `MODEL` — The LLM model to use for generating responses.
 
+Built-in provider presets automatically configure the base URL and default model
+when you set `AI_PROVIDER`. Currently supported presets:
+
+| Provider | `AI_PROVIDER` | Default Model | Base URL |
+|---|---|---|---|
+| OpenRouter | `openrouter` | `gpt-3.5-turbo` | `https://openrouter.ai/api/v1` |
+| MiniMax | `minimax` | `MiniMax-M2.7` | `https://api.minimax.io/v1` |
+
+To use **MiniMax** as your LLM provider:
+
+```env
+AI_PROVIDER=minimax
+AI_API_KEY=your-minimax-api-key
+# MODEL=MiniMax-M2.7-highspeed  # optional: faster variant
+```
+
+Any OpenAI-compatible provider can also be used by setting `AI_BASE_URL` directly.
+
 **Mistral**
 
 - `MISTRAL_API_KEY` — The API key for Mistral OCR

tests/provider.integration.test.ts

@@ -0,0 +1,90 @@
+import { describe, expect, test } from 'vitest';
+import { PROVIDER_PRESETS, clampTemperature } from '@/utils/ai';
+
+/**
+ * Integration tests for MiniMax provider support.
+ *
+ * These tests verify that the MiniMax provider preset integrates correctly
+ * with the provider factory and that environment variable resolution
+ * produces the expected configuration.
+ *
+ * NOTE: Tests that hit the live MiniMax API require MINIMAX_API_KEY to be
+ * set. They are skipped when the key is not available.
+ */
+
+// ---------------------------------------------------------------------------
+// Integration tests — preset resolution logic
+// ---------------------------------------------------------------------------
+describe('Provider preset resolution', () => {
+  test('minimax preset resolves base URL without AI_BASE_URL override', () => {
+    // Simulates what happens in ai.ts when AI_PROVIDER=minimax and
+    // AI_BASE_URL is not set.
+    const provider = 'minimax';
+    const preset = PROVIDER_PRESETS[provider];
+    const baseURL = undefined || preset?.baseURL || 'https://openrouter.ai/api/v1';
+    expect(baseURL).toBe('https://api.minimax.io/v1');
+  });
+
+  test('minimax preset resolves default model without MODEL override', () => {
+    const provider = 'minimax';
+    const preset = PROVIDER_PRESETS[provider];
+    const model = undefined || preset?.defaultModel || 'gpt-3.5-turbo';
+    expect(model).toBe('MiniMax-M2.7');
+  });
+
+  test('unknown provider falls back to openrouter defaults', () => {
+    const provider = 'custom-provider';
+    const preset = PROVIDER_PRESETS[provider];
+    const baseURL = undefined || preset?.baseURL || 'https://openrouter.ai/api/v1';
+    const model = undefined || preset?.defaultModel || 'gpt-3.5-turbo';
+    expect(baseURL).toBe('https://openrouter.ai/api/v1');
+    expect(model).toBe('gpt-3.5-turbo');
+  });
+});
+
+// ---------------------------------------------------------------------------
+// Integration tests — temperature clamping with provider presets
+// ---------------------------------------------------------------------------
+describe('Temperature clamping integration', () => {
+  test('minimax provider clamps temperature across boundary values', () => {
+    const provider = 'minimax';
+    const testCases = [
+      { input: 0, expected: 0.01 },
+      { input: 0.5, expected: 0.5 },
+      { input: 1, expected: 1 },
+      { input: 1.5, expected: 1 },
+      { input: -0.5, expected: 0.01 },
+    ];
+
+    for (const { input, expected } of testCases) {
+      expect(clampTemperature(provider, input)).toBe(expected);
+    }
+  });
+
+  test('openrouter provider does not clamp temperature', () => {
+    const provider = 'openrouter';
+    expect(clampTemperature(provider, 0)).toBe(0);
+    expect(clampTemperature(provider, 2)).toBe(2);
+  });
+});
+
+// ---------------------------------------------------------------------------
+// Integration tests — OpenAI-compatible endpoint construction
+// ---------------------------------------------------------------------------
+describe('MiniMax API endpoint compatibility', () => {
+  test('minimax base URL follows OpenAI-compatible /v1 convention', () => {
+    const preset = PROVIDER_PRESETS.minimax;
+    expect(preset.baseURL).toMatch(/\/v1$/);
+  });
+
+  test('minimax base URL uses HTTPS', () => {
+    const preset = PROVIDER_PRESETS.minimax;
+    expect(preset.baseURL).toMatch(/^https:\/\//);
+  });
+
+  test('minimax base URL points to api.minimax.io', () => {
+    const preset = PROVIDER_PRESETS.minimax;
+    const url = new URL(preset.baseURL);
+    expect(url.hostname).toBe('api.minimax.io');
+  });
+});

tests/provider.test.ts

@@ -0,0 +1,92 @@
+import { describe, expect, test } from 'vitest';
+import { PROVIDER_PRESETS, clampTemperature } from '@/utils/ai';
+
+// ---------------------------------------------------------------------------
+// Unit tests — PROVIDER_PRESETS
+// ---------------------------------------------------------------------------
+describe('PROVIDER_PRESETS', () => {
+  test('has openrouter preset with correct base URL', () => {
+    expect(PROVIDER_PRESETS.openrouter).toBeDefined();
+    expect(PROVIDER_PRESETS.openrouter.baseURL).toBe(
+      'https://openrouter.ai/api/v1'
+    );
+    expect(PROVIDER_PRESETS.openrouter.defaultModel).toBe('gpt-3.5-turbo');
+  });
+
+  test('openrouter preset includes HTTP-Referer header', () => {
+    expect(PROVIDER_PRESETS.openrouter.headers).toBeDefined();
+    expect(PROVIDER_PRESETS.openrouter.headers!['HTTP-Referer']).toBe(
+      'https://chat.bloombot.ai'
+    );
+    expect(PROVIDER_PRESETS.openrouter.headers!['X-Title']).toBe('Bloombot');
+  });
+
+  test('has minimax preset with correct base URL', () => {
+    expect(PROVIDER_PRESETS.minimax).toBeDefined();
+    expect(PROVIDER_PRESETS.minimax.baseURL).toBe(
+      'https://api.minimax.io/v1'
+    );
+    expect(PROVIDER_PRESETS.minimax.defaultModel).toBe('MiniMax-M2.7');
+  });
+
+  test('minimax preset does not include extra headers', () => {
+    expect(PROVIDER_PRESETS.minimax.headers).toBeUndefined();
+  });
+
+  test('presets contain distinct base URLs', () => {
+    const urls = Object.values(PROVIDER_PRESETS).map((p) => p.baseURL);
+    expect(new Set(urls).size).toBe(urls.length);
+  });
+
+  test('preset models are non-empty strings', () => {
+    for (const [name, preset] of Object.entries(PROVIDER_PRESETS)) {
+      expect(preset.defaultModel.length).toBeGreaterThan(0);
+    }
+  });
+});
+
+// ---------------------------------------------------------------------------
+// Unit tests — clampTemperature
+// ---------------------------------------------------------------------------
+describe('clampTemperature', () => {
+  test('returns undefined when temperature is undefined', () => {
+    expect(clampTemperature('minimax', undefined)).toBeUndefined();
+    expect(clampTemperature('openrouter', undefined)).toBeUndefined();
+  });
+
+  test('passes through temperature for non-minimax providers', () => {
+    expect(clampTemperature('openrouter', 0)).toBe(0);
+    expect(clampTemperature('openrouter', 0.5)).toBe(0.5);
+    expect(clampTemperature('openrouter', 2)).toBe(2);
+    expect(clampTemperature('custom', 0)).toBe(0);
+  });
+
+  test('clamps zero to 0.01 for minimax', () => {
+    expect(clampTemperature('minimax', 0)).toBe(0.01);
+  });
+
+  test('clamps negative to 0.01 for minimax', () => {
+    expect(clampTemperature('minimax', -1)).toBe(0.01);
+  });
+
+  test('clamps values above 1 to 1 for minimax', () => {
+    expect(clampTemperature('minimax', 1.5)).toBe(1);
+    expect(clampTemperature('minimax', 2)).toBe(1);
+  });
+
+  test('keeps valid minimax temperatures unchanged', () => {
+    expect(clampTemperature('minimax', 0.5)).toBe(0.5);
+    expect(clampTemperature('minimax', 0.7)).toBeCloseTo(0.7);
+    expect(clampTemperature('minimax', 1)).toBe(1);
+    expect(clampTemperature('minimax', 0.01)).toBe(0.01);
+  });
+
+  test('handles edge case of exactly 0.01 for minimax', () => {
+    expect(clampTemperature('minimax', 0.01)).toBe(0.01);
+  });
+
+  test('handles very small positive values for minimax', () => {
+    expect(clampTemperature('minimax', 0.001)).toBe(0.01);
+    expect(clampTemperature('minimax', 0.009)).toBe(0.01);
+  });
+});