project-graph-mcp 2.3.2 → 2.4.1

package/vendor/symbiote-node/engine/packs/ai/lesson-generate.handler.js

@@ -1,343 +0,0 @@
-/**
- * ai/lesson-generate — AI Lesson Generation
- *
- * Generates structured educational lessons from news content using AI.
- * Supports lesson creation, vocabulary generation, daily digest compilation,
- * and content style validation.
- *
- * Ported from Mr-Computer/automations/argentine-spanish-bot/src/services/learning-by-examples.js
- *
- * @module agi-graph/packs/ai/lesson-generate
- */
-
-import { readFile, readdir } from 'node:fs/promises';
-import path from 'node:path';
-
-/**
- * Load educational materials for context
- * @param {string} materialsDir
- * @returns {Promise<Object>}
- */
-async function loadMaterials(materialsDir) {
-  const materials = {};
-  try {
-    const entries = await readdir(materialsDir);
-    for (const entry of entries) {
-      if (!entry.endsWith('.md')) continue;
-      const content = await readFile(path.join(materialsDir, entry), 'utf-8');
-      materials[entry.replace('.md', '')] = content;
-    }
-  } catch { /* no materials dir */ }
-  return materials;
-}
-
-/**
- * Build lesson generation prompt
- * @param {Object} newsItems
- * @param {Object} materials
- * @param {string} focus
- * @param {number} maxExamples
- * @returns {string}
- */
-function buildLessonPrompt(newsItems, materials, focus, maxExamples) {
-  let prompt = `You are an experienced Spanish teacher specializing in Rioplatense Argentine Spanish for A1 level learners.\n\n`;
-
-  prompt += `TASK: Generate a structured lesson based on the following news items.\n\n`;
-
-  // Add news items
-  prompt += `NEWS CONTEXT:\n`;
-  for (const item of newsItems.slice(0, 5)) {
-    prompt += `- ${item.title || 'Untitled'}: ${(item.description || item.content || '').slice(0, 200)}\n`;
-  }
-
-  // Add focus if provided
-  if (focus) {
-    prompt += `\nLESSON FOCUS: ${focus}\n`;
-  }
-
-  // Add educational materials for style reference
-  const materialKeys = Object.keys(materials);
-  if (materialKeys.length > 0) {
-    prompt += `\nSTYLE REFERENCE (learn from these examples):\n`;
-    for (const key of materialKeys.slice(0, 3)) {
-      prompt += `--- ${key} ---\n${materials[key].slice(0, 500)}\n\n`;
-    }
-  }
-
-  prompt += `\nOUTPUT FORMAT: JSON object with these fields:
-{
-  "title_es": "Lesson title in Spanish",
-  "title_ru": "Lesson title in Russian", 
-  "focus": "Grammar/vocabulary focus",
-  "explanation_ru": "2-3 line explanation in Russian about the Spanish construction",
-  "examples": [{"es": "Spanish example", "ru": "Russian translation"}],
-  "note_pron_ru": "Optional pronunciation note in Russian",
-  "vocabulary": [{"es": "word/phrase", "ru": "translation"}],
-  "podcast_script": {
-    "speaker1": "Russian-speaking host lines",
-    "speaker2": "Spanish-speaking guest lines"
-  }
-}
-
-RULES:
-- Maximum ${maxExamples} example pairs
-- Use Rioplatense dialect (vos, Argentine vocabulary)
-- Keep explanations simple for A1 level
-- Examples should relate to the news context
-- Vocabulary: 10 items, nouns with articles (el/la)
-- No English, only Spanish (es-AR) and Russian
-`;
-
-  return prompt;
-}
-
-/**
- * Build digest prompt
- * @param {Object} digestData
- * @returns {string}
- */
-function buildDigestPrompt(digestData) {
-  const { newsItems, categories } = digestData;
-
-  let prompt = `Create a daily educational news digest for A1 Spanish learners.\n\n`;
-
-  if (categories) {
-    prompt += `CATEGORIES:\n`;
-    for (const [cat, items] of Object.entries(categories)) {
-      prompt += `- ${cat}: ${items.length} items\n`;
-    }
-    prompt += '\n';
-  }
-
-  prompt += `TOP NEWS:\n`;
-  for (const item of (newsItems || []).slice(0, 8)) {
-    prompt += `- ${item.title}: ${(item.description || '').slice(0, 150)}\n`;
-  }
-
-  prompt += `\nOUTPUT FORMAT: JSON with fields:
-{
-  "title_es": "Digest title",
-  "title_ru": "Russian title",
-  "sections": [{"category": "Category name", "summary_es": "Spanish summary", "summary_ru": "Russian summary", "vocabulary": [{"es": "word", "ru": "translation"}]}],
-  "lesson": {"focus": "Grammar point", "examples": [{"es": "", "ru": ""}]}
-}
-`;
-
-  return prompt;
-}
-
-/**
- * Parse flexible AI response
- * @param {string} response
- * @returns {Object}
- */
-function parseResponse(response) {
-  const jsonMatch = response.match(/\{[\s\S]*\}/);
-  if (jsonMatch) {
-    try {
-      return JSON.parse(jsonMatch[0]);
-    } catch { /* fallback */ }
-  }
-  return { error: 'Failed to parse AI response', raw: response };
-}
-
-/**
- * Validate lesson segments
- * @param {Object} lesson
- * @param {Array} newsItems
- * @returns {Array<string>}
- */
-function validateLesson(lesson, newsItems) {
-  const violations = [];
-
-  if (!lesson.title_es) violations.push('Missing title_es');
-  if (!lesson.focus) violations.push('Missing focus');
-  if (!Array.isArray(lesson.examples) || lesson.examples.length === 0) {
-    violations.push('Missing or empty examples');
-  }
-  if (lesson.examples) {
-    for (let i = 0; i < lesson.examples.length; i++) {
-      const ex = lesson.examples[i];
-      if (!ex.es || !ex.ru) violations.push(`Example ${i} missing es or ru`);
-    }
-  }
-
-  return violations;
-}
-
-// ─── Handler Definition ────────────────────────────────────────────────
-
-export default {
-  type: 'ai/lesson-generate',
-  category: 'ai',
-  icon: 'school',
-
-  driver: {
-    description: 'AI-powered lesson generation from news content with vocabulary and podcast scripts',
-    inputs: [
-      { name: 'newsItems', type: 'any' },
-    ],
-    outputs: [
-      { name: 'result', type: 'any' },
-      { name: 'error', type: 'string' },
-    ],
-    params: {
-      operation: { type: 'string', default: 'lesson', description: 'Operation: lesson | vocabulary | daily-digest | validate-style' },
-      apiKey: { type: 'string', default: null, description: 'OpenRouter API key (or OPENROUTER_API_KEY env)' },
-      model: { type: 'string', default: 'anthropic/claude-sonnet-4', description: 'AI model to use' },
-      focus: { type: 'string', default: null, description: 'Lesson focus/topic' },
-      maxExamples: { type: 'int', default: 5, description: 'Maximum examples per lesson' },
-      materialsDir: { type: 'string', default: null, description: 'Path to educational materials for style reference' },
-      // daily-digest
-      categories: { type: 'any', default: null, description: 'News items grouped by category' },
-      // validate
-      content: { type: 'string', default: null, description: 'Content to validate' },
-      contentType: { type: 'string', default: 'news', description: 'Content type for validation' },
-    },
-  },
-
-  lifecycle: {
-    validate: (inputs, params) => {
-      if (params.operation === 'validate-style') {
-        return typeof params.content === 'string';
-      }
-      if (!Array.isArray(inputs.newsItems) || inputs.newsItems.length === 0) return false;
-      const apiKey = params.apiKey || process.env.OPENROUTER_API_KEY;
-      if (!apiKey) return false;
-      return true;
-    },
-
-    cacheKey: () => null, // AI output varies
-
-    execute: async (inputs, params) => {
-      const { newsItems } = inputs;
-      const { operation, model, focus, maxExamples } = params;
-      const apiKey = params.apiKey || process.env.OPENROUTER_API_KEY;
-
-      try {
-        switch (operation) {
-          case 'lesson': {
-            const materials = params.materialsDir
-              ? await loadMaterials(params.materialsDir)
-              : {};
-
-            const prompt = buildLessonPrompt(newsItems, materials, focus, maxExamples);
-
-            const response = await fetch('https://openrouter.ai/api/v1/chat/completions', {
-              method: 'POST',
-              headers: {
-                'Content-Type': 'application/json',
-                'Authorization': `Bearer ${apiKey}`,
-              },
-              body: JSON.stringify({
-                model,
-                messages: [{ role: 'user', content: prompt }],
-                temperature: 0.7,
-              }),
-            });
-
-            if (!response.ok) return { error: `API error: HTTP ${response.status}` };
-
-            const data = await response.json();
-            const aiResponse = data.choices?.[0]?.message?.content || '';
-            const lesson = parseResponse(aiResponse);
-            const violations = validateLesson(lesson, newsItems);
-
-            return {
-              result: {
-                lesson,
-                valid: violations.length === 0,
-                violations,
-                newsCount: newsItems.length,
-                model,
-              },
-            };
-          }
-
-          case 'vocabulary': {
-            const prompt = `Extract 10 key vocabulary items from these news headlines for A1 Spanish learners (Rioplatense dialect).\n\nNEWS:\n${newsItems.map(n => `- ${n.title}`).join('\n')}\n\nOUTPUT: JSON array of {"es": "word with article", "ru": "translation"}\nRules: nouns with el/la, no brands, no cognates, prefer regional vocabulary.`;
-
-            const response = await fetch('https://openrouter.ai/api/v1/chat/completions', {
-              method: 'POST',
-              headers: {
-                'Content-Type': 'application/json',
-                'Authorization': `Bearer ${apiKey}`,
-              },
-              body: JSON.stringify({
-                model,
-                messages: [{ role: 'user', content: prompt }],
-                temperature: 0.5,
-              }),
-            });
-
-            if (!response.ok) return { error: `API error: HTTP ${response.status}` };
-
-            const data = await response.json();
-            const aiResponse = data.choices?.[0]?.message?.content || '';
-            const vocabulary = parseResponse(aiResponse);
-
-            return { result: { vocabulary, newsCount: newsItems.length, model } };
-          }
-
-          case 'daily-digest': {
-            const prompt = buildDigestPrompt({
-              newsItems,
-              categories: params.categories,
-            });
-
-            const response = await fetch('https://openrouter.ai/api/v1/chat/completions', {
-              method: 'POST',
-              headers: {
-                'Content-Type': 'application/json',
-                'Authorization': `Bearer ${apiKey}`,
-              },
-              body: JSON.stringify({
-                model,
-                messages: [{ role: 'user', content: prompt }],
-                temperature: 0.7,
-              }),
-            });
-
-            if (!response.ok) return { error: `API error: HTTP ${response.status}` };
-
-            const data = await response.json();
-            const aiResponse = data.choices?.[0]?.message?.content || '';
-            const digest = parseResponse(aiResponse);
-
-            return { result: { digest, newsCount: newsItems.length, model } };
-          }
-
-          case 'validate-style': {
-            const prompt = `Evaluate if the following ${params.contentType} content matches A1 Rioplatense Spanish learning material standards.\n\nCONTENT:\n${params.content}\n\nCheck:\n1. Vocabulary complexity (should be A1)\n2. Rioplatense dialect usage (vos, local terms)\n3. Bilingual coverage (es + ru)\n4. Educational value\n\nOUTPUT: JSON with {score: 0-100, issues: [string], suggestions: [string]}`;
-
-            const response = await fetch('https://openrouter.ai/api/v1/chat/completions', {
-              method: 'POST',
-              headers: {
-                'Content-Type': 'application/json',
-                'Authorization': `Bearer ${apiKey}`,
-              },
-              body: JSON.stringify({
-                model,
-                messages: [{ role: 'user', content: prompt }],
-                temperature: 0.3,
-              }),
-            });
-
-            if (!response.ok) return { error: `API error: HTTP ${response.status}` };
-
-            const data = await response.json();
-            const aiResponse = data.choices?.[0]?.message?.content || '';
-            const validation = parseResponse(aiResponse);
-
-            return { result: { validation, model } };
-          }
-
-          default:
-            return { error: `Unknown operation: ${operation}` };
-        }
-      } catch (err) {
-        return { error: `lesson-generate ${operation} failed: ${err.message}` };
-      }
-    },
-  },
-};

package/vendor/symbiote-node/engine/packs/ai/opencode.handler.js

@@ -1,164 +0,0 @@
-/**
- * ai/opencode — AI inference via OpenCode REST API + OpenRouter
- *
- * Connects to a running OpenCode (Crush) instance, creates a session,
- * sends a prompt, and polls a file for the AI's JSON output.
- * Model-agnostic: works with any model available through OpenRouter
- * (DeepSeek, Claude, Gemini, etc.).
- *
- * Pattern from radio-conversation-service.js:
- *   POST /session → create session
- *   POST /session/:id/message → send prompt (fire & forget)
- *   Poll output file → wait for JSON result
- *
- * @module agi-graph/packs/ai/opencode
- */
-
-import { promises as fs } from 'fs';
-import path from 'path';
-import os from 'os';
-
-export default {
-  type: 'ai/opencode',
-  category: 'ai',
-  icon: 'psychology',
-
-  driver: {
-    description: 'AI inference via OpenCode + OpenRouter (DeepSeek, Claude, Gemini, etc.)',
-    inputs: [
-      { name: 'prompt', type: 'string' },
-      { name: 'context', type: 'any' },
-    ],
-    outputs: [
-      { name: 'result', type: 'any' },
-      { name: 'error', type: 'string' },
-    ],
-    params: {
-      model: { type: 'string', default: 'deepseek/deepseek-v3.2', description: 'OpenRouter model ID' },
-      provider: { type: 'string', default: 'openrouter', description: 'Model provider' },
-      opencodeUrl: { type: 'string', default: 'http://127.0.0.1:4096', description: 'OpenCode API URL' },
-      timeout: { type: 'int', default: 300000, description: 'Max wait time (ms)' },
-      outputDir: { type: 'string', default: '', description: 'Workspace dir for file exchange' },
-    },
-  },
-
-  lifecycle: {
-    validate: (inputs) => {
-      if (!inputs.prompt) return false;
-      return true;
-    },
-
-    cacheKey: (inputs, params) =>
-      `opencode:${params.model}:${inputs.prompt}:${JSON.stringify(inputs.context)}`,
-
-    execute: async (inputs, params) => {
-      const { prompt, context } = inputs;
-      const {
-        model,
-        provider,
-        opencodeUrl,
-        timeout,
-        outputDir,
-      } = params;
-
-      const baseUrl = opencodeUrl || process.env.OPENCODE_URL || 'http://127.0.0.1:4096';
-      const modelConfig = {
-        providerID: provider || process.env.OPENCODE_PROVIDER || 'openrouter',
-        modelID: model || process.env.OPENCODE_MODEL || 'deepseek/deepseek-v3.2',
-      };
-
-      // Workspace for file-based communication
-      const workspace = outputDir || process.env.OPENCODE_WORKSPACE ||
-        path.join(os.tmpdir(), 'agi-graph-opencode');
-      await fs.mkdir(workspace, { recursive: true });
-
-      const taskPath = path.join(workspace, 'task.json');
-      const outputPath = path.join(workspace, 'output.json');
-
-      // Write task file with context
-      await fs.writeFile(taskPath, JSON.stringify({
-        type: 'agi-graph-ai',
-        prompt,
-        context,
-        timestamp: Date.now(),
-      }, null, 2), 'utf8');
-
-      // Clean previous output
-      try { await fs.unlink(outputPath); } catch { /* ignore */ }
-
-      try {
-        // 1. Create session
-        const sessionRes = await fetch(`${baseUrl}/session`, {
-          method: 'POST',
-          headers: { 'Content-Type': 'application/json' },
-          body: JSON.stringify({ title: `agi-graph ${Date.now()}` }),
-        });
-
-        if (!sessionRes.ok) {
-          return { result: null, error: `Session creation failed: ${sessionRes.status}` };
-        }
-
-        const session = await sessionRes.json();
-
-        // 2. Build full prompt with workspace instructions
-        const contextBlock = context
-          ? `\n\n## Context\n\`\`\`json\n${JSON.stringify(context, null, 2)}\n\`\`\``
-          : '';
-
-        const fullPrompt = `${prompt}${contextBlock}
-
-## Workspace: ${workspace}
-
-### Instructions:
-1. Read task from ${taskPath}
-2. Process the request
-3. Write result as JSON to ${outputPath}
-
-Output format: { "result": <your_result> }`;
-
-        // 3. Send message (fire & forget)
-        const msgRes = await fetch(`${baseUrl}/session/${session.id}/message`, {
-          method: 'POST',
-          headers: { 'Content-Type': 'application/json' },
-          body: JSON.stringify({
-            model: modelConfig,
-            parts: [{ type: 'text', text: fullPrompt }],
-          }),
-          signal: AbortSignal.timeout(120000),
-        });
-
-        if (!msgRes.ok) {
-          return { result: null, error: `Message send failed: ${msgRes.status}` };
-        }
-
-        // 4. Poll for output file
-        const startTime = Date.now();
-        const pollInterval = 3000;
-
-        while (Date.now() - startTime < timeout) {
-          try {
-            const content = await fs.readFile(outputPath, 'utf8');
-            const parsed = JSON.parse(content);
-
-            if (parsed.result !== undefined) {
-              return { result: parsed.result, error: null };
-            }
-            // If the file exists but has no result key, return entire content
-            if (Object.keys(parsed).length > 0) {
-              return { result: parsed, error: null };
-            }
-          } catch {
-            // File not ready yet
-          }
-
-          await new Promise(resolve => setTimeout(resolve, pollInterval));
-        }
-
-        return { result: null, error: `Timeout after ${timeout}ms waiting for AI response` };
-
-      } catch (err) {
-        return { result: null, error: err.message };
-      }
-    },
-  },
-};