opencode-smart-voice-notify 1.2.0 → 1.2.3

package/package.json

@@ -1,48 +1,52 @@
-{
-  "name": "opencode-smart-voice-notify",
-  "version": "1.2.0",
-  "description": "Smart voice notification plugin for OpenCode with multiple TTS engines (ElevenLabs, Edge TTS, Windows SAPI) and intelligent reminder system",
-  "main": "index.js",
-  "type": "module",
-  "author": "MasuRii",
-  "license": "MIT",
-  "keywords": [
-    "opencode",
-    "opencode-plugins",
-    "plugin",
-    "notification",
-    "tts",
-    "text-to-speech",
-    "elevenlabs",
-    "edge-tts",
-    "sapi",
-    "voice",
-    "alert",
-    "smart"
-  ],
-  "files": [
-    "index.js",
-    "util/",
-    "assets/",
-    "example.config.jsonc"
-  ],
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/MasuRii/opencode-smart-voice-notify.git"
-  },
-  "bugs": {
-    "url": "https://github.com/MasuRii/opencode-smart-voice-notify/issues"
-  },
-  "homepage": "https://github.com/MasuRii/opencode-smart-voice-notify#readme",
-  "engines": {
-    "node": ">=18.0.0",
-    "bun": ">=1.0.0"
-  },
-  "dependencies": {
-    "@elevenlabs/elevenlabs-js": "^2.29.0",
-    "msedge-tts": "^2.0.3"
-  },
-  "peerDependencies": {
-    "@opencode-ai/plugin": "^1.1.4"
-  }
-}
+{
+  "name": "opencode-smart-voice-notify",
+  "version": "1.2.3",
+  "description": "Smart voice notification plugin for OpenCode with multiple TTS engines (ElevenLabs, Edge TTS, Windows SAPI), AI-generated dynamic messages, and intelligent reminder system",
+  "main": "index.js",
+  "type": "module",
+  "author": "MasuRii",
+  "license": "MIT",
+  "keywords": [
+    "opencode",
+    "opencode-plugins",
+    "plugin",
+    "notification",
+    "tts",
+    "text-to-speech",
+    "elevenlabs",
+    "edge-tts",
+    "sapi",
+    "voice",
+    "alert",
+    "smart",
+    "ai",
+    "ai-generated",
+    "ollama",
+    "local-ai"
+  ],
+  "files": [
+    "index.js",
+    "util/",
+    "assets/",
+    "example.config.jsonc"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/MasuRii/opencode-smart-voice-notify.git"
+  },
+  "bugs": {
+    "url": "https://github.com/MasuRii/opencode-smart-voice-notify/issues"
+  },
+  "homepage": "https://github.com/MasuRii/opencode-smart-voice-notify#readme",
+  "engines": {
+    "node": ">=18.0.0",
+    "bun": ">=1.0.0"
+  },
+  "dependencies": {
+    "@elevenlabs/elevenlabs-js": "^2.30.0",
+    "msedge-tts": "^2.0.3"
+  },
+  "peerDependencies": {
+    "@opencode-ai/plugin": "^1.1.8"
+  }
+}

package/util/ai-messages.js

@@ -1,207 +1,205 @@
-/**
- * AI Message Generation Module
- * 
- * Generates dynamic notification messages using OpenAI-compatible AI endpoints.
- * Supports: Ollama, LM Studio, LocalAI, vLLM, llama.cpp, Jan.ai, etc.
- * 
- * Uses native fetch() - no external dependencies required.
- */
-
-import { getTTSConfig } from './tts.js';
-
-/**
- * Generate a message using an OpenAI-compatible AI endpoint
- * @param {string} promptType - The type of prompt ('idle', 'permission', 'question', 'idleReminder', 'permissionReminder', 'questionReminder')
- * @param {object} context - Optional context about the notification (for future use)
- * @returns {Promise<string|null>} Generated message or null if failed
- */
-export async function generateAIMessage(promptType, context = {}) {
-  const config = getTTSConfig();
-  
-  // Check if AI messages are enabled
-  if (!config.enableAIMessages) {
-    return null;
-  }
-  
-  // Get the prompt for this type
-  const prompt = config.aiPrompts?.[promptType];
-  if (!prompt) {
-    console.error(`[AI Messages] No prompt configured for type: ${promptType}`);
-    return null;
-  }
-  
-  try {
-    // Build headers
-    const headers = { 'Content-Type': 'application/json' };
-    if (config.aiApiKey) {
-      headers['Authorization'] = `Bearer ${config.aiApiKey}`;
-    }
-    
-    // Build endpoint URL (ensure it ends with /chat/completions)
-    let endpoint = config.aiEndpoint || 'http://localhost:11434/v1';
-    if (!endpoint.endsWith('/chat/completions')) {
-      endpoint = endpoint.replace(/\/$/, '') + '/chat/completions';
-    }
-    
-    // Create abort controller for timeout
-    const controller = new AbortController();
-    const timeout = setTimeout(() => controller.abort(), config.aiTimeout || 15000);
-    
-    // Make the request
-    const response = await fetch(endpoint, {
-      method: 'POST',
-      headers,
-      signal: controller.signal,
-      body: JSON.stringify({
-        model: config.aiModel || 'llama3',
-        messages: [
-          {
-            role: 'system',
-            content: 'You are a helpful assistant that generates short notification messages. Output only the message text, nothing else. No quotes, no explanations.'
-          },
-          {
-            role: 'user',
-            content: prompt
-          }
-        ],
-        max_tokens: 1000,  // High value to accommodate thinking models (e.g., Gemini 2.5) that use internal reasoning tokens
-        temperature: 0.7
-      })
-    });
-    
-    clearTimeout(timeout);
-    
-    if (!response.ok) {
-      const errorText = await response.text().catch(() => 'Unknown error');
-      console.error(`[AI Messages] API error ${response.status}: ${errorText}`);
-      return null;
-    }
-    
-    const data = await response.json();
-    
-    // Extract the message content
-    const message = data.choices?.[0]?.message?.content?.trim();
-    
-    if (!message) {
-      console.error('[AI Messages] Empty response from AI');
-      return null;
-    }
-    
-    // Clean up the message (remove quotes if AI added them)
-    let cleanMessage = message.replace(/^["']|["']$/g, '').trim();
-    
-    // Validate message length (sanity check)
-    if (cleanMessage.length < 5 || cleanMessage.length > 200) {
-      console.error(`[AI Messages] Message length invalid: ${cleanMessage.length} chars`);
-      return null;
-    }
-    
-    return cleanMessage;
-    
-  } catch (error) {
-    if (error.name === 'AbortError') {
-      console.error(`[AI Messages] Request timed out after ${config.aiTimeout || 15000}ms`);
-    } else {
-      console.error(`[AI Messages] Error: ${error.message}`);
-    }
-    return null;
-  }
-}
-
-/**
- * Get a smart message - tries AI first, falls back to static messages
- * @param {string} eventType - 'idle', 'permission', 'question'
- * @param {boolean} isReminder - Whether this is a reminder message
- * @param {string[]} staticMessages - Array of static fallback messages
- * @param {object} context - Optional context (e.g., { count: 3 } for batched notifications)
- * @returns {Promise<string>} The message to speak
- */
-export async function getSmartMessage(eventType, isReminder, staticMessages, context = {}) {
-  const config = getTTSConfig();
-  
-  // Determine the prompt type
-  const promptType = isReminder ? `${eventType}Reminder` : eventType;
-  
-  // Try AI generation if enabled
-  if (config.enableAIMessages) {
-    try {
-      const aiMessage = await generateAIMessage(promptType, context);
-      if (aiMessage) {
-        // Log success for debugging
-        if (config.debugLog) {
-          console.log(`[AI Messages] Generated: ${aiMessage}`);
-        }
-        return aiMessage;
-      }
-    } catch (error) {
-      console.error(`[AI Messages] Generation failed: ${error.message}`);
-    }
-    
-    // Check if fallback is disabled
-    if (!config.aiFallbackToStatic) {
-      // Return a generic message if fallback disabled and AI failed
-      return 'Notification: Please check your screen.';
-    }
-  }
-  
-  // Fallback to static messages
-  if (!Array.isArray(staticMessages) || staticMessages.length === 0) {
-    return 'Notification';
-  }
-  
-  return staticMessages[Math.floor(Math.random() * staticMessages.length)];
-}
-
-/**
- * Test connectivity to the AI endpoint
- * @returns {Promise<{success: boolean, message: string, model?: string}>}
- */
-export async function testAIConnection() {
-  const config = getTTSConfig();
-  
-  if (!config.enableAIMessages) {
-    return { success: false, message: 'AI messages not enabled' };
-  }
-  
-  try {
-    const headers = { 'Content-Type': 'application/json' };
-    if (config.aiApiKey) {
-      headers['Authorization'] = `Bearer ${config.aiApiKey}`;
-    }
-    
-    // Try to list models (simpler endpoint to test connectivity)
-    let endpoint = config.aiEndpoint || 'http://localhost:11434/v1';
-    endpoint = endpoint.replace(/\/$/, '') + '/models';
-    
-    const controller = new AbortController();
-    const timeout = setTimeout(() => controller.abort(), 5000);
-    
-    const response = await fetch(endpoint, {
-      method: 'GET',
-      headers,
-      signal: controller.signal
-    });
-    
-    clearTimeout(timeout);
-    
-    if (response.ok) {
-      const data = await response.json();
-      const models = data.data?.map(m => m.id) || [];
-      return {
-        success: true,
-        message: `Connected! Available models: ${models.slice(0, 3).join(', ')}${models.length > 3 ? '...' : ''}`,
-        models
-      };
-    } else {
-      return { success: false, message: `HTTP ${response.status}: ${response.statusText}` };
-    }
-    
-  } catch (error) {
-    if (error.name === 'AbortError') {
-      return { success: false, message: 'Connection timed out' };
-    }
-    return { success: false, message: error.message };
-  }
-}
-
-export default { generateAIMessage, getSmartMessage, testAIConnection };
+/**
+ * AI Message Generation Module
+ * 
+ * Generates dynamic notification messages using OpenAI-compatible AI endpoints.
+ * Supports: Ollama, LM Studio, LocalAI, vLLM, llama.cpp, Jan.ai, etc.
+ * 
+ * Uses native fetch() - no external dependencies required.
+ */
+
+import { getTTSConfig } from './tts.js';
+
+/**
+ * Generate a message using an OpenAI-compatible AI endpoint
+ * @param {string} promptType - The type of prompt ('idle', 'permission', 'question', 'idleReminder', 'permissionReminder', 'questionReminder')
+ * @param {object} context - Optional context about the notification (for future use)
+ * @returns {Promise<string|null>} Generated message or null if failed
+ */
+export async function generateAIMessage(promptType, context = {}) {
+  const config = getTTSConfig();
+  
+  // Check if AI messages are enabled
+  if (!config.enableAIMessages) {
+    return null;
+  }
+  
+  // Get the prompt for this type
+  let prompt = config.aiPrompts?.[promptType];
+  if (!prompt) {
+    return null;
+  }
+  
+  // Inject count context if multiple items
+  if (context.count && context.count > 1) {
+    // Use type-specific terminology
+    let itemType = 'items';
+    if (context.type === 'question') {
+      itemType = 'questions';
+    } else if (context.type === 'permission') {
+      itemType = 'permission requests';
+    }
+    prompt = `${prompt} Important: There are ${context.count} ${itemType} (not just one) waiting for the user's attention. Mention the count in your message.`;
+  }
+  
+  try {
+    // Build headers
+    const headers = { 'Content-Type': 'application/json' };
+    if (config.aiApiKey) {
+      headers['Authorization'] = `Bearer ${config.aiApiKey}`;
+    }
+    
+    // Build endpoint URL (ensure it ends with /chat/completions)
+    let endpoint = config.aiEndpoint || 'http://localhost:11434/v1';
+    if (!endpoint.endsWith('/chat/completions')) {
+      endpoint = endpoint.replace(/\/$/, '') + '/chat/completions';
+    }
+    
+    // Create abort controller for timeout
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), config.aiTimeout || 15000);
+    
+    // Make the request
+    const response = await fetch(endpoint, {
+      method: 'POST',
+      headers,
+      signal: controller.signal,
+      body: JSON.stringify({
+        model: config.aiModel || 'llama3',
+        messages: [
+          {
+            role: 'system',
+            content: 'You are a helpful assistant that generates short notification messages. Output only the message text, nothing else. No quotes, no explanations.'
+          },
+          {
+            role: 'user',
+            content: prompt
+          }
+        ],
+        max_tokens: 1000,  // High value to accommodate thinking models (e.g., Gemini 2.5) that use internal reasoning tokens
+        temperature: 0.7
+      })
+    });
+    
+    clearTimeout(timeout);
+    
+    if (!response.ok) {
+      return null;
+    }
+    
+    const data = await response.json();
+    
+    // Extract the message content
+    const message = data.choices?.[0]?.message?.content?.trim();
+    
+    if (!message) {
+      return null;
+    }
+    
+    // Clean up the message (remove quotes if AI added them)
+    let cleanMessage = message.replace(/^["']|["']$/g, '').trim();
+    
+    // Validate message length (sanity check)
+    if (cleanMessage.length < 5 || cleanMessage.length > 200) {
+      return null;
+    }
+    
+    return cleanMessage;
+    
+  } catch (error) {
+    return null;
+  }
+}
+
+/**
+ * Get a smart message - tries AI first, falls back to static messages
+ * @param {string} eventType - 'idle', 'permission', 'question'
+ * @param {boolean} isReminder - Whether this is a reminder message
+ * @param {string[]} staticMessages - Array of static fallback messages
+ * @param {object} context - Optional context (e.g., { count: 3 } for batched notifications)
+ * @returns {Promise<string>} The message to speak
+ */
+export async function getSmartMessage(eventType, isReminder, staticMessages, context = {}) {
+  const config = getTTSConfig();
+  
+  // Determine the prompt type
+  const promptType = isReminder ? `${eventType}Reminder` : eventType;
+  
+  // Try AI generation if enabled
+  if (config.enableAIMessages) {
+    try {
+      const aiMessage = await generateAIMessage(promptType, context);
+      if (aiMessage) {
+        return aiMessage;
+      }
+    } catch (error) {
+      // Silently fall through to fallback
+    }
+    
+    // Check if fallback is disabled
+    if (!config.aiFallbackToStatic) {
+      // Return a generic message if fallback disabled and AI failed
+      return 'Notification: Please check your screen.';
+    }
+  }
+  
+  // Fallback to static messages
+  if (!Array.isArray(staticMessages) || staticMessages.length === 0) {
+    return 'Notification';
+  }
+  
+  return staticMessages[Math.floor(Math.random() * staticMessages.length)];
+}
+
+/**
+ * Test connectivity to the AI endpoint
+ * @returns {Promise<{success: boolean, message: string, model?: string}>}
+ */
+export async function testAIConnection() {
+  const config = getTTSConfig();
+  
+  if (!config.enableAIMessages) {
+    return { success: false, message: 'AI messages not enabled' };
+  }
+  
+  try {
+    const headers = { 'Content-Type': 'application/json' };
+    if (config.aiApiKey) {
+      headers['Authorization'] = `Bearer ${config.aiApiKey}`;
+    }
+    
+    // Try to list models (simpler endpoint to test connectivity)
+    let endpoint = config.aiEndpoint || 'http://localhost:11434/v1';
+    endpoint = endpoint.replace(/\/$/, '') + '/models';
+    
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), 5000);
+    
+    const response = await fetch(endpoint, {
+      method: 'GET',
+      headers,
+      signal: controller.signal
+    });
+    
+    clearTimeout(timeout);
+    
+    if (response.ok) {
+      const data = await response.json();
+      const models = data.data?.map(m => m.id) || [];
+      return {
+        success: true,
+        message: `Connected! Available models: ${models.slice(0, 3).join(', ')}${models.length > 3 ? '...' : ''}`,
+        models
+      };
+    } else {
+      return { success: false, message: `HTTP ${response.status}: ${response.statusText}` };
+    }
+    
+  } catch (error) {
+    if (error.name === 'AbortError') {
+      return { success: false, message: 'Connection timed out' };
+    }
+    return { success: false, message: error.message };
+  }
+}
+
+export default { generateAIMessage, getSmartMessage, testAIConnection };