feat: 8 AI providers, rich text editor, agent notifications, UI contrast & font settings

- Add DeepSeek, OpenRouter, Mistral, Z.AI, LM Studio as AI providers
  with editable model names via Combobox in admin settings
- Fix OpenRouter broken by normalizeProvider bug in config.ts
- Convert agent-created notes from Markdown to HTML (TipTap rich text)
- Add Notification model + in-app notifications for agent results
- Agent notification click opens the created note directly
- Add note count display on notebook and inbox headers
- Fix checklist toggle in card view (persist state via localCheckItems)
- Add checklist creation option in tabs/list view (dropdown on + button)
- Fix image description ENOENT error with HTTP fallback
- Improve UI contrast across all themes (input, border, checkbox visibility)
- Add font family setting (Inter vs System Default) in Appearance settings
- Fix CSS font-sans variable conflict (removed dead Geist references)
- Update README with new features and 8 providers

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

memento-note/lib/ai/factory.ts

@@ -3,7 +3,36 @@ import { OllamaProvider } from './providers/ollama';
 import { CustomOpenAIProvider } from './providers/custom-openai';
 import { AIProvider } from './types';
 
-type ProviderType = 'ollama' | 'openai' | 'custom' | 'deepseek' | 'openrouter';
+type ProviderType = 'ollama' | 'openai' | 'custom' | 'deepseek' | 'openrouter' | 'mistral' | 'zai' | 'lmstudio';
+
+// --- Provider defaults ---
+const PROVIDER_DEFAULTS: Record<string, { baseUrl: string; model: string; embeddingModel: string }> = {
+  deepseek: {
+    baseUrl: 'https://api.deepseek.com/v1',
+    model: 'deepseek-chat',
+    embeddingModel: '',
+  },
+  openrouter: {
+    baseUrl: 'https://openrouter.ai/api/v1',
+    model: 'openai/gpt-4o-mini',
+    embeddingModel: 'openai/text-embedding-3-small',
+  },
+  mistral: {
+    baseUrl: 'https://api.mistral.ai/v1',
+    model: 'mistral-small-latest',
+    embeddingModel: 'mistral-embed',
+  },
+  zai: {
+    baseUrl: 'https://api.zukijourney.com/v1',
+    model: 'gpt-4o-mini',
+    embeddingModel: 'text-embedding-3-small',
+  },
+  lmstudio: {
+    baseUrl: 'http://localhost:1234/v1',
+    model: '',
+    embeddingModel: '',
+  },
+};
 
 function createOllamaProvider(config: Record<string, string>, modelName: string, embeddingModelName: string, baseUrlOverride?: string): OllamaProvider {
   let baseUrl = baseUrlOverride || config?.OLLAMA_BASE_URL || process.env.OLLAMA_BASE_URL
@@ -19,7 +48,7 @@ function createOllamaProvider(config: Record<string, string>, modelName: string,
 
   // Ensure baseUrl doesn't end with /api, we'll add it in OllamaProvider
   if (baseUrl.endsWith('/api')) {
-    baseUrl = baseUrl.slice(0, -4); // Remove /api
+    baseUrl = baseUrl.slice(0, -4);
   }
 
   return new OllamaProvider(baseUrl, modelName, embeddingModelName);
@@ -51,15 +80,39 @@ function createCustomOpenAIProvider(config: Record<string, string>, modelName: s
 }
 
 function createDeepSeekProvider(config: Record<string, string>, modelName: string, embeddingModelName: string): CustomOpenAIProvider {
-  const apiKey = config?.DEEPSEEK_API_KEY || config?.CUSTOM_OPENAI_API_KEY || process.env.DEEPSEEK_API_KEY || process.env.CUSTOM_OPENAI_API_KEY || '';
+  const apiKey = config?.DEEPSEEK_API_KEY || process.env.DEEPSEEK_API_KEY || '';
   if (!apiKey) throw new Error('DEEPSEEK_API_KEY is required when using DeepSeek provider');
-  return new CustomOpenAIProvider(apiKey, 'https://api.deepseek.com/v1', modelName, embeddingModelName);
+  const defaults = PROVIDER_DEFAULTS.deepseek;
+  return new CustomOpenAIProvider(apiKey, defaults.baseUrl, modelName || defaults.model, embeddingModelName || defaults.embeddingModel);
 }
 
 function createOpenRouterProvider(config: Record<string, string>, modelName: string, embeddingModelName: string): CustomOpenAIProvider {
-  const apiKey = config?.OPENROUTER_API_KEY || config?.CUSTOM_OPENAI_API_KEY || process.env.OPENROUTER_API_KEY || process.env.CUSTOM_OPENAI_API_KEY || '';
+  const apiKey = config?.OPENROUTER_API_KEY || process.env.OPENROUTER_API_KEY || '';
   if (!apiKey) throw new Error('OPENROUTER_API_KEY is required when using OpenRouter provider');
-  return new CustomOpenAIProvider(apiKey, 'https://openrouter.ai/api/v1', modelName, embeddingModelName);
+  const defaults = PROVIDER_DEFAULTS.openrouter;
+  return new CustomOpenAIProvider(apiKey, defaults.baseUrl, modelName || defaults.model, embeddingModelName || defaults.embeddingModel);
+}
+
+function createMistralProvider(config: Record<string, string>, modelName: string, embeddingModelName: string): CustomOpenAIProvider {
+  const apiKey = config?.MISTRAL_API_KEY || process.env.MISTRAL_API_KEY || '';
+  if (!apiKey) throw new Error('MISTRAL_API_KEY is required when using Mistral provider');
+  const defaults = PROVIDER_DEFAULTS.mistral;
+  return new CustomOpenAIProvider(apiKey, defaults.baseUrl, modelName || defaults.model, embeddingModelName || defaults.embeddingModel);
+}
+
+function createZAIProvider(config: Record<string, string>, modelName: string, embeddingModelName: string): CustomOpenAIProvider {
+  const apiKey = config?.ZAI_API_KEY || process.env.ZAI_API_KEY || '';
+  if (!apiKey) throw new Error('ZAI_API_KEY is required when using Z.AI provider');
+  const defaults = PROVIDER_DEFAULTS.zai;
+  return new CustomOpenAIProvider(apiKey, defaults.baseUrl, modelName || defaults.model, embeddingModelName || defaults.embeddingModel);
+}
+
+function createLMStudioProvider(config: Record<string, string>, modelName: string, embeddingModelName: string): CustomOpenAIProvider {
+  const baseUrl = config?.LMSTUDIO_BASE_URL || process.env.LMSTUDIO_BASE_URL || PROVIDER_DEFAULTS.lmstudio.baseUrl;
+  // LM Studio doesn't require an API key, but the CustomOpenAI provider needs one
+  // Use a dummy key if not provided
+  const apiKey = config?.LMSTUDIO_API_KEY || process.env.LMSTUDIO_API_KEY || 'lm-studio';
+  return new CustomOpenAIProvider(apiKey, baseUrl, modelName, embeddingModelName);
 }
 
 function getProviderInstance(providerType: ProviderType, config: Record<string, string>, modelName: string, embeddingModelName: string, ollamaBaseUrl?: string): AIProvider {
@@ -74,28 +127,47 @@ function getProviderInstance(providerType: ProviderType, config: Record<string,
       return createDeepSeekProvider(config, modelName, embeddingModelName);
     case 'openrouter':
       return createOpenRouterProvider(config, modelName, embeddingModelName);
+    case 'mistral':
+      return createMistralProvider(config, modelName, embeddingModelName);
+    case 'zai':
+      return createZAIProvider(config, modelName, embeddingModelName);
+    case 'lmstudio':
+      return createLMStudioProvider(config, modelName, embeddingModelName);
     default:
       return createOllamaProvider(config, modelName, embeddingModelName, ollamaBaseUrl);
   }
 }
 
+// Resolve the effective provider type and config keys for a given provider
+// Returns { providerType, apiKeyConfigKey, baseUrlConfigKey }
+function getProviderConfigKeys(providerType: string): { apiKeyConfigKey: string; baseUrlConfigKey: string } {
+  switch (providerType) {
+    case 'deepseek':   return { apiKeyConfigKey: 'DEEPSEEK_API_KEY', baseUrlConfigKey: '' };
+    case 'openrouter': return { apiKeyConfigKey: 'OPENROUTER_API_KEY', baseUrlConfigKey: '' };
+    case 'mistral':    return { apiKeyConfigKey: 'MISTRAL_API_KEY', baseUrlConfigKey: '' };
+    case 'zai':        return { apiKeyConfigKey: 'ZAI_API_KEY', baseUrlConfigKey: '' };
+    case 'lmstudio':   return { apiKeyConfigKey: 'LMSTUDIO_API_KEY', baseUrlConfigKey: 'LMSTUDIO_BASE_URL' };
+    case 'openai':     return { apiKeyConfigKey: 'OPENAI_API_KEY', baseUrlConfigKey: '' };
+    case 'custom':     return { apiKeyConfigKey: 'CUSTOM_OPENAI_API_KEY', baseUrlConfigKey: 'CUSTOM_OPENAI_BASE_URL' };
+    default:           return { apiKeyConfigKey: '', baseUrlConfigKey: 'OLLAMA_BASE_URL' };
+  }
+}
+
 export function getTagsProvider(config?: Record<string, string>): AIProvider {
-  // Check database config first, then environment variables
   const providerType = (
-    config?.AI_PROVIDER_TAGS || 
-    config?.AI_PROVIDER_EMBEDDING || 
+    config?.AI_PROVIDER_TAGS ||
+    config?.AI_PROVIDER_EMBEDDING ||
     config?.AI_PROVIDER ||
     process.env.AI_PROVIDER_TAGS ||
     process.env.AI_PROVIDER_EMBEDDING ||
     process.env.AI_PROVIDER
   );
 
-  // If no provider is configured, throw a clear error
   if (!providerType) {
     console.error('[getTagsProvider] FATAL: No provider configured. Config received:', config);
     throw new Error(
       'AI_PROVIDER_TAGS is not configured. Please set it in the admin settings or environment variables. ' +
-      'Options: ollama, openai, custom'
+      'Options: ollama, openai, deepseek, openrouter, mistral, zai, lmstudio, custom'
     );
   }
 
@@ -108,22 +180,20 @@ export function getTagsProvider(config?: Record<string, string>): AIProvider {
 }
 
 export function getEmbeddingsProvider(config?: Record<string, string>): AIProvider {
-  // Check database config first, then environment variables
   const providerType = (
-    config?.AI_PROVIDER_EMBEDDING || 
-    config?.AI_PROVIDER_TAGS || 
+    config?.AI_PROVIDER_EMBEDDING ||
+    config?.AI_PROVIDER_TAGS ||
     config?.AI_PROVIDER ||
     process.env.AI_PROVIDER_EMBEDDING ||
     process.env.AI_PROVIDER_TAGS ||
     process.env.AI_PROVIDER
   );
 
-  // If no provider is configured, throw a clear error
   if (!providerType) {
     console.error('[getEmbeddingsProvider] FATAL: No provider configured. Config received:', config);
     throw new Error(
       'AI_PROVIDER_EMBEDDING is not configured. Please set it in the admin settings or environment variables. ' +
-      'Options: ollama, openai, custom'
+      'Options: ollama, openai, deepseek, openrouter, mistral, zai, lmstudio, custom'
     );
   }
 
@@ -140,8 +210,6 @@ export function getAIProvider(config?: Record<string, string>): AIProvider {
 }
 
 export function getChatProvider(config?: Record<string, string>): AIProvider {
-  // Check database config first, then environment variables
-  // Fallback cascade: chat -> tags -> embeddings
   const providerType = (
     config?.AI_PROVIDER_CHAT ||
     config?.AI_PROVIDER_TAGS ||
@@ -153,12 +221,11 @@ export function getChatProvider(config?: Record<string, string>): AIProvider {
     process.env.AI_PROVIDER
   );
 
-  // If no provider is configured, throw a clear error
   if (!providerType) {
     console.error('[getChatProvider] FATAL: No provider configured. Config received:', config);
     throw new Error(
       'AI_PROVIDER_CHAT is not configured. Please set it in the admin settings or environment variables. ' +
-      'Options: ollama, openai, custom'
+      'Options: ollama, openai, deepseek, openrouter, mistral, zai, lmstudio, custom'
     );
   }
 
@@ -173,3 +240,6 @@ export function getChatProvider(config?: Record<string, string>): AIProvider {
 
   return getProviderInstance(provider, config || {}, modelName, embeddingModelName, ollamaBaseUrl);
 }
+
+// Export for use by admin settings form and deploy scripts
+export { PROVIDER_DEFAULTS, getProviderConfigKeys };