@fullstackcraftllc/codevideo-mcp 1.0.0 → 1.0.2

package/dist/index.js

@@ -3,17 +3,17 @@ import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { z } from 'zod';
 import { AllActionStrings, isRepeatableAction, isValidAction } from '@fullstackcraftllc/codevideo-types';
-import { VirtualIDE } from '@fullstackcraftllc/codevideo-virtual-ide';
 import Database from 'better-sqlite3';
-import path, { join } from 'path';
-import os, { platform, arch } from 'os';
-import fs, { existsSync } from 'fs';
-import { buildFileStructureFromRootFolder } from '@fullstackcraftllc/codevideo-adapters';
+import path from 'path';
+import os from 'os';
+import fs from 'fs';
+import { VirtualIDE } from '@fullstackcraftllc/codevideo-virtual-ide';
+import { buildFileStructureFromRootFolder, buildFileStructureFromGitHub } from '@fullstackcraftllc/codevideo-adapters';
 import { GoogleGenAI } from '@google/genai';
 import { generateMarkdownStringFromActions, generateHtmlStringFromActions } from '@fullstackcraftllc/codevideo-exporters';
 import { spawn } from 'child_process';
 
-var version = "1.0.0";
+var version = "1.0.2";
 
 // this prompt describes how to create a course lesson using the CodeVideo framework
 const instructionsToCreateACourse = (additionalContext) => {
@@ -61,7 +61,7 @@ const instructionsToCreateACourse = (additionalContext) => {
     1. Create the initial course object using the MCP tool \`codevideo_create_course_with_initial_metadata\`
     2. Plan out the number of lessons needed and what they will be about
     3. For each lesson, create a unique identifier, name, and description
-    4. Create the initial empty lesson snapshot for the first lesson using the MCP tool \`codevideo_get_empty_lesson_snapshot\`. In the case of lessons beyond the first, copy the final lesson snapshot of the previous lesson and use that as the initial lesson snapshot.
+    4. Create the initial empty lesson snapshot for the first lesson using the MCP tool \`codevideo_get_empty_lesson_snapshot\`. In the case of any lesson beyond the first lesson, generate the final lesson snapshot and copy it as the initial lesson snapshot.
     5. Create actions for the lesson using the MCP tool \`codevideo_instructions_to_create_lesson_actions\`
     6. Add actions to the lesson using the MCP tool \`codevideo_add_actions_to_lesson\`
     7. Create the final lesson snapshot using the MCP tool \`codevideo_get_final_lesson_snapshot\`
@@ -114,18 +114,47 @@ const instructionsToCreateLessonActions = (additionalContext) => {
     ];
     \`\`\`
 
-    When in doubt with these names, feel free to use the MCP tool \`codevideo_get_action_names\` to get the most updated list of all the actions available. You can also use the MCP tool \`codevideo_get_example_lesson\` to get verified, accurate, and correct lessons created by humans.
+    Use the MCP tool \`codevideo_get_action_names\` to get the most updated list of all the actions available. You can also use the MCP tool \`codevideo_get_example_actions_array_by_keyword\`  \`codevideo_get_example_lessons_by_keyword\` to get verified, accurate, and correct lessons created by humans.
     
     Also VERY IMPORTANT to note, while most 'value' properties are corresponding strings, things like \`editor-enter\` are considered "Repeatable" properties, which MUST have a string number as the 'value' property, which is 99% of the time the string "1", but can be any positive integer, representing the number of times to repeat. An action can be checked for repeatability with the MCP tool \`codevideo_is_repeatable_action\`. To be stressed again: the "value" property of any codevideo action CANNOT be left empty!
 
-    WORKFLOW TIP: After creating actions, you can store them using \`codevideo_set_current_actions\` and then use other tools like \`codevideo_validate_actions\`, \`codevideo_make_video\`, \`codevideo_make_blog_post\`, etc. without needing to re-specify the actions each time. These tools will automatically retrieve the stored actions if no actions parameter is provided.
+    WORKFLOW TIP: After creating actions, you can store them using \`codevideo_set_current_actions\` and then use other tools like \`codevideo_validate_actions\`, \`codevideo_make_video_from_actions\`, \`codevideo_make_blog_post\`, etc. without needing to re-specify the actions each time. These tools will automatically retrieve the stored actions if no actions parameter is provided.
+
+    LESSON MANAGEMENT: You can also store complete lesson objects using \`codevideo_set_current_lesson\` and retrieve them with \`codevideo_get_current_lesson\`. This is useful for the FULL LESSON OBJECT approach where you need to manage complete lessons with snapshots.
+
+    ACTIONS vs FULL LESSON OBJECTS:
+    You have two approaches for creating lessons:
+    
+    1. **ACTIONS-ONLY APPROACH**: Use when creating simple tutorials that start from a clean slate or when you only need to demonstrate specific coding steps. Use \`codevideo_make_video_from_actions\` for this approach.
+    
+    2. **FULL LESSON OBJECT APPROACH**: Use when you need to:
+       - Start from an existing codebase (use \`codevideo_get_initial_lesson_state_from_local_repo\` or \`codevideo_get_initial_lesson_state_from_github_repo\`)
+       - Continue from a previous lesson's ending state (use \`codevideo_get_final_lesson_snapshot\` from a previous lesson)
+       - Have complete control over the initial and final snapshots
+       - Use \`codevideo_make_video_from_lesson\` for this approach
 
     RECOMMENDED WORKFLOW:
-    1. Create your actions array
-    2. Call \`codevideo_set_current_actions\` once with the actions
-    3. Call \`codevideo_validate_actions\` WITHOUT the actions parameter - it will use the stored actions automatically - if issues are found, fix them in the actions array and call \`codevideo_set_current_actions\` again
-    4. Call any other tools (make_video, make_blog_post, etc.) WITHOUT the actions parameter - they will use the stored actions automatically
-    5. Use \`codevideo_get_current_actions\` at any later time to inspect what's currently stored if needed
+    1. **DECIDE YOUR APPROACH**: 
+       - For simple tutorials starting from scratch: Use ACTIONS-ONLY approach
+       - For tutorials starting from existing code or continuing from previous lessons: Use FULL LESSON OBJECT approach
+    
+    2. Call the \`codevideo_get_example_lesson\` tool to examine example lessons to get a feel for the codevideo actions and composition.
+    3. Use the \`codevideo_get_action_names\` tool to get the complete and most up-to-date list of actions.
+    
+    4. **IF USING FULL LESSON OBJECT APPROACH**:
+       4a. If starting from an existing codebase, use \`codevideo_get_initial_lesson_state_from_local_repo\` or \`codevideo_get_initial_lesson_state_from_github_repo\`
+       4b. If continuing from a previous lesson, use \`codevideo_get_final_lesson_snapshot\` from the previous lesson's actions
+       4c. Create your actions array and build the complete lesson object with initial/final snapshots
+       4d. Optionally store the lesson using \`codevideo_set_current_lesson\` for later retrieval
+       4e. Use \`codevideo_make_video_from_lesson\` with the complete lesson object
+    
+    5. **IF USING ACTIONS-ONLY APPROACH**:
+       5a. Create the actions array
+       5b. Call \`codevideo_set_current_actions\` once with the actions
+       5c. Call \`codevideo_validate_actions\` WITHOUT the actions parameter - it will use the stored actions automatically
+       5d. Call \`codevideo_make_video_from_actions\` WITHOUT the actions parameter - it will use the stored actions automatically
+    
+    6. Use \`codevideo_get_current_actions\` or \`codevideo_get_current_lesson\` at any later time to inspect what's currently stored if needed
 
     With all this in mind, you are to create a lesson about the following:
 
@@ -180,11 +209,36 @@ const instructionsToCreateLessonVideo = (additionalContext) => {
     
     Also VERY IMPORTANT to note, while most 'value' properties are corresponding strings, things like \`editor-enter\` are considered "Repeatable" properties, which MUST have a string number as the 'value' property, which is 99% of the time the string "1", but can be any positive integer, representing the number of times to repeat. An action can be checked for repeatability with the MCP tool \`codevideo_is_repeatable_action\`. To be stressed again: the "value" property of any codevideo action CANNOT be left empty!
 
+    LESSON MANAGEMENT: You can store complete lesson objects using \`codevideo_set_current_lesson\` and retrieve them with \`codevideo_get_current_lesson\`. This is particularly useful for the FULL LESSON OBJECT approach where you need to manage complete lessons with snapshots.
+
+    ACTIONS vs FULL LESSON OBJECTS - CHOOSE YOUR APPROACH:
+    You have two approaches for creating video lessons:
+    
+    1. **ACTIONS-ONLY APPROACH**: Use when creating simple tutorials that start from a clean slate or when you only need to demonstrate specific coding steps. Use \`codevideo_make_video_from_actions\` for this approach.
+    
+    2. **FULL LESSON OBJECT APPROACH**: Use when you need to:
+       - Start from an existing codebase (use \`codevideo_get_initial_lesson_state_from_local_repo\` or \`codevideo_get_initial_lesson_state_from_github_repo\`)
+       - Continue from a previous lesson's ending state (use \`codevideo_get_final_lesson_snapshot\` from a previous lesson)
+       - Have complete control over the initial and final snapshots
+       - Use \`codevideo_make_video_from_lesson\` for this approach
+
     RECOMMENDED WORKFLOW:
-    1. Create your actions array
-    2. Call \`codevideo_set_current_actions\` once with the actions
-    3. Call \`codevideo_validate_actions\` WITHOUT the actions parameter - it will use the stored actions automatically - if issues are found, fix them in the actions array and call \`codevideo_set_current_actions\` again
-    4. Call \`codevideo_make_video\` WITHOUT the actions parameter - it will use the stored actions automatically
+    1. **DECIDE YOUR APPROACH**: 
+       - For simple tutorials starting from scratch: Use ACTIONS-ONLY approach
+       - For tutorials starting from existing code or continuing from previous lessons: Use FULL LESSON OBJECT approach
+    
+    2. **IF USING ACTIONS-ONLY APPROACH**:
+       2a. Create your actions array
+       2b. Call \`codevideo_set_current_actions\` once with the actions
+       2c. Call \`codevideo_validate_actions\` WITHOUT the actions parameter - it will use the stored actions automatically - if issues are found, fix them in the actions array and call \`codevideo_set_current_actions\` again
+       2d. Call \`codevideo_make_video_from_actions\` WITHOUT the actions parameter - it will use the stored actions automatically
+    
+    3. **IF USING FULL LESSON OBJECT APPROACH**:
+       3a. If starting from an existing codebase, use \`codevideo_get_initial_lesson_state_from_local_repo\` or \`codevideo_get_initial_lesson_state_from_github_repo\`
+       3b. If continuing from a previous lesson, use \`codevideo_get_final_lesson_snapshot\` from the previous lesson's actions
+       3c. Create your actions array and build the complete lesson object with initial/final snapshots
+       3d. Optionally store the lesson using \`codevideo_set_current_lesson\` for later retrieval
+       3e. Use \`codevideo_make_video_from_lesson\` with the complete lesson object
 
     With all this in mind, you are to create a lesson about the following:
 
@@ -194,6 +248,10 @@ const instructionsToCreateLessonVideo = (additionalContext) => {
     `;
 };
 
+// Database key constants for the CodeVideo MCP key-value store
+const CURRENT_ACTIONS_KEY = 'current_actions';
+const CURRENT_LESSON_KEY = 'current_lesson';
+
 // retrieves the current actions from the key value sqlite database
 const getCurrentActions = () => {
     try {
@@ -219,7 +277,7 @@ const getCurrentActions = () => {
             SELECT value FROM key_value_store 
             WHERE key = ?
         `);
-        const result = stmt.get('current_actions');
+        const result = stmt.get(CURRENT_ACTIONS_KEY);
         db.close();
         if (!result) {
             return null;
@@ -242,6 +300,174 @@ const getCurrentActionsOrThrow = () => {
     return actions;
 };
 
+const instructionsToTranslateActions = (actionsToTranslation, targetLanguage) => {
+    let actionsToUse;
+    if (actionsToTranslation && actionsToTranslation.length > 0) {
+        // Use provided actions
+        actionsToUse = actionsToTranslation;
+    }
+    else {
+        // Try to get from storage
+        const storedActions = getCurrentActions();
+        if (!storedActions || storedActions.length === 0) {
+            return "No actions provided and no actions found in storage. Either pass actionsToTranslation parameter or use codevideo_set_current_actions first to store actions.";
+        }
+        actionsToUse = storedActions;
+    }
+    return `## 📝 Translation Instructions for CodeVideo Action Scripts
+
+### 📌 Objective
+
+You are given a JSON array representing an instructional CodeVideo script. Your task is to translate all relevant text **within the \`"value"\` fields** into the specified target language **while preserving CodeVideo execution logic**.
+
+**WORKFLOW TIP**: Use \`codevideo_set_current_actions\` to store actions first, then call this tool without the actionsToTranslation parameter. This allows you to work with the same actions across multiple translation operations or other CodeVideo tools like \`codevideo_validate_actions\`, \`codevideo_make_video_from_actions\`, etc.
+
+**VALIDATION TIP**: After translation, you can validate the translated actions using \`codevideo_validate_actions\` to ensure the CodeVideo structure remains intact.
+
+---
+
+### ✅ What to Translate
+Translate the following, only if found within the \`"value"\` fields:
+
+1. **All narration steps:**
+   - \`"name": "author-speak-before"\` or \`"author-speak-after"\`  
+     → Fully translate narration into fluent, natural speech in the target language.
+
+2. **Code comments:**
+   - Lines starting with \`#\` or \`//\` or between \`/* ... */\`  
+     → Translate the comment portion only, preserving syntax markers.
+
+3. **String literals inside code:**
+   - e.g., \`print("Hello, World!")\`  
+     → Translate the string inside the quotes, preserving quote marks and code structure.
+
+4. **Terminal outputs:**
+   - \`"name": "terminal-set-output"\`  
+     → Translate printed outputs line by line.
+
+---
+
+### 🚫 What NOT to Translate
+Do **not** translate the following:
+
+- \`"name"\` field values (e.g., \`"author-speak-before"\`, \`"editor-type"\`, etc.)  
+  → These are CodeVideo internal commands.
+
+- File names, identifiers, variables, or function names (e.g., \`main.py\`, \`range\`, \`print\`, \`for i in range(...)\`)  
+  → Keep code functional and consistent.
+
+- Keywords or syntax in programming code  
+  → Only translate *comments* and *strings*.
+
+---
+
+### 💡 Examples
+
+#### Code Comment
+
+\`\`\`json
+{ "name": "editor-type", "value": "# Print 'Hello, World!' five times" }
+\`\`\`
+
+➡ becomes:
+
+\`\`\`json
+{ "name": "editor-type", "value": "# Imprime '¡Hola, Mundo!' cinco veces" }
+\`\`\`
+
+#### Narration
+\`\`\`json
+{ "name": "author-speak-before", "value": "Let's open a terminal and run the script." }
+\`\`\`
+➡ becomes:
+\`\`\`json
+{ "name": "author-speak-before", "value": "Vamos a abrir una terminal y ejecutar el script." }
+\`\`\`
+
+#### Terminal Output
+\`\`\`json
+{ "name": "terminal-set-output", "value": "Hello, World!\nHello, World!" }
+\`\`\`
+➡ becomes:
+\`\`\`json
+{ "name": "terminal-set-output", "value": "¡Hola, Mundo!\n¡Hola, Mundo!" }
+\`\`\`
+
+---
+
+### 🌍 Target Language
+
+The target language will be specified separately. Use fluent, natural phrasing appropriate to that language's tone and style of instruction.
+
+---
+
+### 🧠 Tips
+
+- Match tone to the original narration (enthusiastic, beginner-friendly).
+- Avoid overly literal translations — clarity is more important.
+- Maintain line breaks, indentation, and special characters exactly as they appear in code or outputs.
+
+---
+
+### ✅ Output Format
+
+Return the translated JSON with only the \`value\` fields updated. The JSON structure must remain valid and unchanged otherwise.
+
+\`\`\`json
+{ "name": "editor-type", "value": "# Print 'Hello, World!' five times" }
+\`\`\`
+➡ becomes:
+\`\`\`json
+{ "name": "editor-type", "value": "# Imprime '¡Hola, Mundo!' cinco veces" }
+\`\`\`
+
+#### Narration
+\`\`\`json
+{ "name": "author-speak-before", "value": "Let's open a terminal and run the script." }
+\`\`\`
+➡ becomes:
+\`\`\`json
+{ "name": "author-speak-before", "value": "Vamos a abrir una terminal y ejecutar el script." }
+\`\`\`
+
+#### Terminal Output
+\`\`\`json
+{ "name": "terminal-set-output", "value": "Hello, World!\nHello, World!" }
+\`\`\`
+➡ becomes:
+\`\`\`json
+{ "name": "terminal-set-output", "value": "¡Hola, Mundo!\n¡Hola, Mundo!" }
+\`\`\`
+
+---
+
+### 🌍 Target Language
+
+The target language will be specified below. Use fluent, natural phrasing appropriate to that language's tone and style of instruction.
+
+---
+
+### 🧠 Tips
+
+- Match tone to the original narration (enthusiastic, beginner-friendly).
+- Avoid overly literal translations — clarity is more important.
+- Maintain line breaks, indentation, and special characters exactly as they appear in code or outputs.
+
+---
+
+### ✅ Output Format
+Return the translated JSON with only the \`"value"\` fields updated. The JSON structure must remain valid and unchanged otherwise.
+
+
+Considering all these instructions, please translate the following actions into ${targetLanguage}:
+
+\`\`\`json
+${JSON.stringify(actionsToUse, null, 4)}
+\`\`\`
+
+`;
+};
+
 const getFinalLessonSnapshot = (actions) => {
     // Use provided actions or retrieve from storage
     const actionsToUse = actions || getCurrentActionsOrThrow();
@@ -257,7 +483,74 @@ const getFinalLessonSnapshot = (actions) => {
 
 const getInitialLessonStateFromLocalCodebase = async (repoLocation) => {
     // build file structure from files and content from the file system adapter
-    const fileStructure = await buildFileStructureFromRootFolder(repoLocation);
+    const { fileStructure } = await buildFileStructureFromRootFolder(repoLocation);
+    // build the project using the file structure
+    const project = {
+        id: "",
+        name: "",
+        description: "",
+        actions: [],
+        initialSnapshot: {
+            isUnsavedChangesDialogOpen: false,
+            unsavedFileName: '',
+            fileExplorerSnapshot: {
+                isFileExplorerContextMenuOpen: false,
+                isFileContextMenuOpen: false,
+                isFolderContextMenuOpen: false,
+                isNewFileInputVisible: false,
+                isNewFolderInputVisible: false,
+                isRenameFileInputVisible: false,
+                isRenameFolderInputVisible: false,
+                newFileInputValue: '',
+                newFolderInputValue: '',
+                renameFileInputValue: '',
+                renameFolderInputValue: '',
+                originalFileBeingRenamed: '',
+                originalFolderBeingRenamed: '',
+                newFileParentPath: '',
+                newFolderParentPath: '',
+                fileStructure,
+            },
+            editorSnapshot: {
+                isEditorContextMenuOpen: false,
+                editors: []
+            },
+            terminalSnapshot: {
+                terminals: []
+            },
+            mouseSnapshot: {
+                location: 'editor',
+                currentHoveredFileName: '',
+                currentHoveredFolderName: '',
+                currentHoveredEditorTabFileName: '',
+                x: 0,
+                y: 0,
+                timestamp: 0,
+                type: 'move',
+                buttonStates: {
+                    left: false,
+                    right: false,
+                    middle: false,
+                },
+                scrollPosition: {
+                    x: 0,
+                    y: 0
+                },
+            },
+            authorSnapshot: {
+                authors: [
+                    { currentSpeechCaption: '' }
+                ]
+            }
+        }
+    };
+    // return the project as a string
+    return JSON.stringify(project);
+};
+
+const getInitialLessonStateFromGitHubRepo = async (repoUrl) => {
+    // build file structure from files and content from the file system adapter
+    const fileStructure = await buildFileStructureFromGitHub(repoUrl);
     // build the project using the file structure
     const project = {
         id: "",
@@ -546,7 +839,7 @@ const setCurrentActions = (actions) => {
         `);
         // Convert actions to JSON string and store
         const actionsJson = JSON.stringify(actions);
-        stmt.run('current_actions', actionsJson);
+        stmt.run(CURRENT_ACTIONS_KEY, actionsJson);
         db.close();
         return `Successfully stored ${actions.length} actions in local database at ${dbPath}`;
     }
@@ -555,6 +848,90 @@ const setCurrentActions = (actions) => {
     }
 };
 
+// sets the current lesson to the key value sqlite database
+const setCurrentLesson = (lesson) => {
+    try {
+        // Create database directory if it doesn't exist
+        const homeDir = os.homedir();
+        const dbDir = path.join(homeDir, '.codevideo');
+        if (!fs.existsSync(dbDir)) {
+            fs.mkdirSync(dbDir, { recursive: true });
+        }
+        const dbPath = path.join(dbDir, 'codevideo.db');
+        // Open or create database
+        const db = new Database(dbPath);
+        // Create table if it doesn't exist
+        db.exec(`
+            CREATE TABLE IF NOT EXISTS key_value_store (
+                key TEXT PRIMARY KEY,
+                value TEXT NOT NULL,
+                updated_at DATETIME DEFAULT CURRENT_TIMESTAMP
+            )
+        `);
+        // Prepare statement to insert or replace the current_lesson
+        const stmt = db.prepare(`
+            INSERT OR REPLACE INTO key_value_store (key, value, updated_at) 
+            VALUES (?, ?, CURRENT_TIMESTAMP)
+        `);
+        // Convert lesson to JSON string and store
+        const lessonJson = JSON.stringify(lesson);
+        stmt.run(CURRENT_LESSON_KEY, lessonJson);
+        db.close();
+        return `Successfully stored lesson "${lesson.name}" (ID: ${lesson.id}) in local database at ${dbPath}`;
+    }
+    catch (error) {
+        return `Error storing lesson: ${error.message}`;
+    }
+};
+
+// retrieves the current lesson from the key value sqlite database
+const getCurrentLesson = () => {
+    try {
+        const homeDir = os.homedir();
+        const dbPath = path.join(homeDir, '.codevideo', 'codevideo.db');
+        // Check if database file exists
+        if (!fs.existsSync(dbPath)) {
+            return null;
+        }
+        // Open database
+        const db = new Database(dbPath);
+        // Check if table exists
+        const tableExists = db.prepare(`
+            SELECT name FROM sqlite_master 
+            WHERE type='table' AND name='key_value_store'
+        `).get();
+        if (!tableExists) {
+            db.close();
+            return null;
+        }
+        // Retrieve current_lesson
+        const stmt = db.prepare(`
+            SELECT value FROM key_value_store 
+            WHERE key = ?
+        `);
+        const result = stmt.get(CURRENT_LESSON_KEY);
+        db.close();
+        if (!result) {
+            return null;
+        }
+        // Parse JSON back to lesson object
+        const lesson = JSON.parse(result.value);
+        return lesson;
+    }
+    catch (error) {
+        console.error('Error retrieving lesson:', error);
+        return null;
+    }
+};
+// Helper function that returns lesson or throws descriptive error
+const getCurrentLessonOrThrow = () => {
+    const lesson = getCurrentLesson();
+    if (!lesson) {
+        throw new Error('No lesson found in storage. Please use codevideo_set_current_lesson first to store a lesson, then try again.');
+    }
+    return lesson;
+};
+
 // calls the markdown generator from the codevideo-exporters package
 const makeBlogPost = (actions) => {
     // Use provided actions or retrieve from storage
@@ -585,32 +962,63 @@ const makeHTMLWebPage = async (actions) => {
     return htmlContent;
 };
 
-function getBinaryPath() {
-    const platformMap = {
-        'darwin': 'darwin',
-        'linux': 'linux',
-        'win32': 'win32'
-    };
-    const archMap = {
-        'x64': 'x64',
-        'arm64': 'arm64'
-    };
-    const targetPlatform = platformMap[platform()];
-    const targetArch = archMap[arch()];
-    if (!targetPlatform || !targetArch) {
-        throw new Error(`Unsupported platform: ${platform()}-${arch()}`);
-    }
-    const binaryName = platform() === 'win32' ? 'codevideo-cli.exe' : 'codevideo-cli';
-    const binaryPath = join(__dirname, '..', 'bin', `${targetPlatform}-${targetArch}`, binaryName);
-    if (!existsSync(binaryPath)) {
-        throw new Error(`Binary not found for ${targetPlatform}-${targetArch} at ${binaryPath}`);
-    }
-    return binaryPath;
-}
-
-const makeVideo = async (actions) => {
+const makeVideoFromActions = async (actions) => {
+    // attempt to read CLI path from env varaible PATH_TO_CODEVIDEO_CLI - if PATH_TO_CODEVIDEO_CLI is not set return error message
+    // const cliExePath = process.env.PATH_TO_CODEVIDEO_CLI;
+    // hardcoded now for demo
+    const cliExePath = "/Users/chris/enterprise/codevideo/codevideo-cli/codevideo";
+    // TODO: reactivate getBinaryPath from the go binaries that are downloaded from releases github and packaged here
+    // we will likely have signing issues on macOS, so we will need to sign the binary ourselves
+    // const cliExePath = getBinaryPath();
+    // if (!cliExePath) {
+    //     return {
+    //         outputPath: '',
+    //         stdout: '',
+    //         stderr: '',
+    //         error: new Error('PATH_TO_CODEVIDEO_CLI environment variable is not set. Please set it to the path of the codevideo-cli executable.')
+    //     };
+    // }
+    // // if it is set, check if it exists
+    // if (!path.isAbsolute(cliExePath)) {
+    //     return {
+    //         outputPath: '',
+    //         stdout: '',
+    //         stderr: '',
+    //         error: new Error('PATH_TO_CODEVIDEO_CLI environment variable is not an absolute path. Please set it to the absolute path of the codevideo-cli executable.')
+    //     };
+    // }
+    // // check if the path exists
+    // if (!fs.existsSync(cliExePath)) {
+    //     return {
+    //         outputPath: '',
+    //         stdout: '',
+    //         stderr: '',
+    //         error: new Error(`PATH_TO_CODEVIDEO_CLI environment variable is set to a path that does not exist: ${cliExePath}. Please set it to the path of the codevideo-cli executable.`)
+    //     };
+    // }
+    // // check if the path is a file
+    // if (!fs.statSync(cliExePath).isFile()) {
+    //     return {
+    //         outputPath: '',
+    //         stdout: '',
+    //         stderr: '',
+    //         error: new Error(`PATH_TO_CODEVIDEO_CLI environment variable is set to a path that is not a file: ${cliExePath}. Please set it to the path of the codevideo-cli executable.`)
+    //     };
+    // }
+    // // check if the path is executable
+    // try {
+    //     fs.accessSync(cliExePath, fs.constants.F_OK | fs.constants.X_OK);
+    // } catch (error) {
+    //     return {
+    //         outputPath: '',
+    //         stdout: '',
+    //         stderr: '',     
+    //         error: new Error(`PATH_TO_CODEVIDEO_CLI environment variable is set to a path that is not executable: ${cliExePath}. Please set it to the path of the codevideo-cli executable.`)
+    //     };
+    // }
+    // derive the directory path from the executable path
+    const cliDirPath = path.dirname(cliExePath);
     try {
-        const binaryPath = getBinaryPath(); // Use bundled binary instead of PATH_TO_CODEVIDEO_CLI
         // Use provided actions or retrieve from storage
         const actionsToUse = actions || getCurrentActionsOrThrow();
         // Create JSON string directly
@@ -621,16 +1029,109 @@ const makeVideo = async (actions) => {
         const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
         const outputFile = path.join(desktopDir, `codevideo-${timestamp}.mp4`);
         // Fire-and-forget: Start the video generation process in the background
-        const child = spawn(binaryPath, ['make-video'], {
-            stdio: ['pipe', 'pipe', 'pipe'],
-            cwd: process.cwd()
+        const child = spawn(cliExePath, ['run', '.', '-p', actionsJson, '-o', outputFile, '--open'], {
+            cwd: cliDirPath,
+            detached: true,
+            stdio: 'ignore' // Detach stdio streams from parent
+        });
+        // Unreference the child process, allowing the parent to exit independently
+        child.unref();
+        // Return immediately with status message
+        return {
+            outputPath: outputFile,
+            stdout: `Video generation job with ${actionsToUse.length} actions has started in the background via the codevideo-cli command. MP4 file path: ${outputFile}. It should open automatically as soon as it is done being rendered - this could take a while depending on how many actions there are.`,
+            stderr: ''
+        };
+    }
+    catch (error) {
+        console.error('Error starting video generation:', error);
+        return {
+            outputPath: '',
+            stdout: '',
+            stderr: `Failed to start video generation: ${error.message}`,
+            error
+        };
+    }
+};
+
+const makeVideoFromLesson = async (lesson) => {
+    // attempt to read CLI path from env varaible PATH_TO_CODEVIDEO_CLI - if PATH_TO_CODEVIDEO_CLI is not set return error message
+    // const cliExePath = process.env.PATH_TO_CODEVIDEO_CLI;
+    // hardcoded now for demo
+    const cliExePath = "/Users/chris/enterprise/codevideo/codevideo-cli/codevideo";
+    // TODO: reactivate getBinaryPath from the go binaries that are downloaded from releases github and packaged here
+    // we will likely have signing issues on macOS, so we will need to sign the binary ourselves
+    // const cliExePath = getBinaryPath();
+    // if (!cliExePath) {
+    //     return {
+    //         outputPath: '',
+    //         stdout: '',
+    //         stderr: '',
+    //         error: new Error('PATH_TO_CODEVIDEO_CLI environment variable is not set. Please set it to the path of the codevideo-cli executable.')
+    //     };
+    // }
+    // // if it is set, check if it exists
+    // if (!path.isAbsolute(cliExePath)) {
+    //     return {
+    //         outputPath: '',
+    //         stdout: '',
+    //         stderr: '',
+    //         error: new Error('PATH_TO_CODEVIDEO_CLI environment variable is not an absolute path. Please set it to the absolute path of the codevideo-cli executable.')
+    //     };
+    // }
+    // // check if the path exists
+    // if (!fs.existsSync(cliExePath)) {
+    //     return {
+    //         outputPath: '',
+    //         stdout: '',
+    //         stderr: '',
+    //         error: new Error(`PATH_TO_CODEVIDEO_CLI environment variable is set to a path that does not exist: ${cliExePath}. Please set it to the path of the codevideo-cli executable.`)
+    //     };
+    // }
+    // // check if the path is a file
+    // if (!fs.statSync(cliExePath).isFile()) {
+    //     return {
+    //         outputPath: '',
+    //         stdout: '',
+    //         stderr: '',
+    //         error: new Error(`PATH_TO_CODEVIDEO_CLI environment variable is set to a path that is not a file: ${cliExePath}. Please set it to the path of the codevideo-cli executable.`)
+    //     };
+    // }
+    // // check if the path is executable
+    // try {
+    //     fs.accessSync(cliExePath, fs.constants.F_OK | fs.constants.X_OK);
+    // } catch (error) {
+    //     return {
+    //         outputPath: '',
+    //         stdout: '',
+    //         stderr: '',     
+    //         error: new Error(`PATH_TO_CODEVIDEO_CLI environment variable is set to a path that is not executable: ${cliExePath}. Please set it to the path of the codevideo-cli executable.`)
+    //     };
+    // }
+    // derive the directory path from the executable path
+    const cliDirPath = path.dirname(cliExePath);
+    try {
+        // Use provided lesson or retrieve from storage
+        const lessonToUse = lesson || getCurrentLessonOrThrow();
+        // Create JSON string directly
+        const lessonJson = JSON.stringify(lessonToUse);
+        // Create output file on desktop with timestamp
+        const homeDir = os.homedir();
+        const desktopDir = path.join(homeDir, 'Desktop');
+        const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
+        const outputFile = path.join(desktopDir, `codevideo-${timestamp}.mp4`);
+        // Fire-and-forget: Start the video generation process in the background
+        const child = spawn(cliExePath, ['run', '.', '-p', lessonJson, '-o', outputFile, '--open'], {
+            cwd: cliDirPath,
+            detached: true,
+            stdio: 'ignore' // Detach stdio streams from parent
         });
         // Unreference the child process, allowing the parent to exit independently
         child.unref();
         // Return immediately with status message
         return {
             outputPath: outputFile,
-            stdout: `Video generation job with ${actionsToUse.length} actions started in the background via the codevideo-cli command. MP4 file path: ${outputFile}. It should open automatically as soon as it is done being rendered.`,
+            stdout: `Video generation job with lesson has started in the background via the codevideo-cli command. MP4 file path: ${outputFile}. It should open automatically as soon as it is done being rendered - this could take a while depending on the complexity of the lesson.`,
             stderr: ''
         };
     }
@@ -674,7 +1175,7 @@ const getActionNames = () => {
     return AllActionStrings.join(", ");
 };
 
-const keywordsToExampleMap = [
+const keywordsToExampleActionsMap = [
     {
         keywords: ["console log", "javascript", "js", "log"],
         actions: [
@@ -997,19 +1498,19 @@ const keywordsToExampleMap = [
 ];
 // returns a JSON representation of an example lesson based on keywords
 // the LLM can use this to learn real example lessons created by humans
-const getExampleLesson = (keyword) => {
+const getExampleActionsArrayByKeyword = (keyword) => {
     const exampleJSONs = [];
     if (Array.isArray(keyword)) {
         // if the keyword is an array, loop over all keywords and get the example lesson for each one
         for (var i = 0; i < keyword.length; i++) {
-            const exampleJSON = getExampleLesson(keyword[i]);
+            const exampleJSON = getExampleActionsArrayByKeyword(keyword[i]);
             exampleJSONs.push(exampleJSON);
         }
         return exampleJSONs.join(", ");
     }
     else {
         // if the keyword is a string, get the example lesson for that keyword
-        const exampleJSON = getSingleExampleLesson(keyword);
+        const exampleJSON = getSingleExampleActionsArray(keyword);
         if (exampleJSON) {
             return exampleJSON;
         }
@@ -1017,10 +1518,10 @@ const getExampleLesson = (keyword) => {
     // if no keywords match, return an empty string
     return "";
 };
-const getSingleExampleLesson = (keyword) => {
+const getSingleExampleActionsArray = (keyword) => {
     // loop over all keywords and find the first one that matches
-    for (var i = 0; i < keywordsToExampleMap.length; i++) {
-        const keywordMap = keywordsToExampleMap[i];
+    for (var i = 0; i < keywordsToExampleActionsMap.length; i++) {
+        const keywordMap = keywordsToExampleActionsMap[i];
         if (keywordMap.keywords.includes(keyword)) {
             return JSON.stringify(keywordMap.actions);
         }
@@ -1029,344 +1530,816 @@ const getSingleExampleLesson = (keyword) => {
     return "";
 };
 
-// Load environment variables from .env file
-dotenv.config();
-const ActionSchema = z.object({
-    name: z.string(),
-    value: z.string()
-});
-const CourseSnapshotSchema = z.object({});
-const LessonSchema = z.object({
-    id: z.string(),
-    name: z.string(),
-    description: z.string(),
-    actions: z.array(ActionSchema),
-    initialSnapshot: CourseSnapshotSchema,
-    finalSnapshot: CourseSnapshotSchema
-});
-const CourseSchema = z.object({
-    id: z.string(),
-    name: z.string(),
-    description: z.string(),
-    primaryLanguage: z.string(),
-    lessons: z.array(LessonSchema)
-});
-const server = new McpServer({
-    name: "codevideo-mcp",
-    version: version,
-    env: {
-        // preserve existing environment variables
-        ...Object.fromEntries(Object.entries(process.env)
-            .filter(([, value]) => value !== undefined)
-            .map(([key, value]) => [key, value])),
-        MCP_TIMEOUT: String(1200000), // 20 min - needed for video creation waiting
-    }
-});
-// Commenting out prompts and resources that aren't showing up 
-// - does Claude just use them internally?
-/*
-// add prompts
-server.prompt(
-    "codevideo_create_lesson",
-    { additionalContext: z.string() },
-    ({ additionalContext }) => ({
-        messages: [{
-            role: "user",
-            content: {
-                type: "text",
-                text: createLesson(additionalContext)
+const keywordsToExampleLessonsMap = [
+    {
+        keywords: ["go", "golang", "explore codebase", "existing codebase", "go cli tool"],
+        lesson: {
+            "id": "",
+            "name": "",
+            "description": "",
+            "actions": [
+                {
+                    "name": "author-speak-before",
+                    "value": "Hi there! Let's explore this interesting Golang repository that helps track GitLab contributions. This tool analyzes user activity across different time periods and produces contribution statistics."
+                },
+                {
+                    "name": "mouse-move-file-explorer",
+                    "value": "1"
+                },
+                {
+                    "name": "mouse-move-file-explorer-file",
+                    "value": "main.go"
+                },
+                {
+                    "name": "mouse-left-click",
+                    "value": "1"
+                },
+                {
+                    "name": "author-speak-before",
+                    "value": "The main.go file is the entry point for the application. It defines the core functionality for tracking GitLab contributions."
+                },
+                {
+                    "name": "mouse-move-to-coordinates-percent",
+                    "value": "50,20"
+                },
+                {
+                    "name": "author-speak-before",
+                    "value": "This struct stores contribution statistics for a user - tracking both commits and merge requests across different time periods."
+                },
+                {
+                    "name": "author-speak-before",
+                    "value": "The main function initializes the application by loading environment variables, getting the GitLab token, and reading usernames from a file."
+                },
+                {
+                    "name": "mouse-move-file-explorer-file",
+                    "value": "usernames.txt"
+                },
+                {
+                    "name": "mouse-left-click",
+                    "value": "1"
+                },
+                {
+                    "name": "author-speak-before",
+                    "value": "The usernames.txt file contains the list of GitLab users whose contributions we want to track."
+                },
+                {
+                    "name": "mouse-move-file-explorer-file",
+                    "value": "main.go"
+                },
+                {
+                    "name": "mouse-left-click",
+                    "value": "1"
+                },
+                {
+                    "name": "file-explorer-open-file",
+                    "value": "main.go"
+                },
+                {
+                    "name": "author-speak-before",
+                    "value": "This function calculates contribution statistics for a single user. It defines time windows for different periods - daily, weekly, monthly, and yearly."
+                },
+                {
+                    "name": "author-speak-before",
+                    "value": "The GetUserActivity function connects to the GitLab API to fetch user events within a specified time period."
+                },
+                {
+                    "name": "author-speak-before",
+                    "value": "The printResults function formats and displays the contribution statistics, including calculating metrics like average commits per merge request."
+                },
+                {
+                    "name": "mouse-move-file-explorer",
+                    "value": "1"
+                },
+                {
+                    "name": "mouse-move-file-explorer-folder",
+                    "value": "http_helper"
+                },
+                {
+                    "name": "mouse-left-click",
+                    "value": "1"
+                },
+                {
+                    "name": "file-explorer-expand-folder",
+                    "value": "http_helper"
+                },
+                {
+                    "name": "mouse-move-file-explorer-file",
+                    "value": "http_helper/http_helper.go"
+                },
+                {
+                    "name": "mouse-left-click",
+                    "value": "1"
+                },
+                {
+                    "name": "file-explorer-open-file",
+                    "value": "http_helper/http_helper.go"
+                },
+                {
+                    "name": "author-speak-before",
+                    "value": "The project has a dedicated HTTP helper module that handles API requests to GitLab."
+                },
+                {
+                    "name": "editor-highlight-code",
+                    "value": "func MakeHTTPRequest(fullUrl string, httpMethod string, headers map[string]string, queryParameters url.Values, body io.Reader) ([]byte, error) {"
+                },
+                {
+                    "name": "author-speak-before",
+                    "value": "This function handles standard HTTP requests, while the function below uses generics for typed responses."
+                },
+                {
+                    "name": "editor-highlight-code",
+                    "value": "func MakeHTTPRequestGeneric[T any](fullUrl string, httpMethod string, headers map[string]string, queryParameters url.Values, body io.Reader, responseType T) (T, error) {"
+                },
+                {
+                    "name": "author-speak-before",
+                    "value": "MakeHTTPRequestGeneric is a modern Go function using generics to handle typed API responses, making it easier to work with the GitLab API."
+                },
+                {
+                    "name": "mouse-move-file-explorer-file",
+                    "value": "main_test.go"
+                },
+                {
+                    "name": "mouse-left-click",
+                    "value": "1"
+                },
+                {
+                    "name": "file-explorer-open-file",
+                    "value": "main_test.go"
+                },
+                {
+                    "name": "author-speak-before",
+                    "value": "The project also includes tests to verify the functionality of the GitLab API interactions."
+                },
+                {
+                    "name": "mouse-move-file-explorer-file",
+                    "value": ".env"
+                },
+                {
+                    "name": "mouse-left-click",
+                    "value": "1"
+                },
+                {
+                    "name": "file-explorer-open-file",
+                    "value": ".env"
+                },
+                {
+                    "name": "author-speak-before",
+                    "value": "The .env file stores the GitLab token needed to authenticate with the API."
+                },
+                {
+                    "name": "mouse-move-file-explorer-file",
+                    "value": "go.mod"
+                },
+                {
+                    "name": "mouse-left-click",
+                    "value": "1"
+                },
+                {
+                    "name": "file-explorer-open-file",
+                    "value": "go.mod"
+                },
+                {
+                    "name": "author-speak-before",
+                    "value": "The go.mod file lists the project dependencies, including the go-gitlab library for API interaction and godotenv for environment variable loading."
+                },
+                {
+                    "name": "mouse-move-file-explorer-file",
+                    "value": "main.go"
+                },
+                {
+                    "name": "mouse-left-click",
+                    "value": "1"
+                },
+                {
+                    "name": "file-explorer-open-file",
+                    "value": "main.go"
+                },
+                {
+                    "name": "author-speak-after",
+                    "value": "To summarize, this Go repository is a GitLab contribution analyzer that fetches user activity data from GitLab's API. It tracks commits and merge requests across multiple time periods, calculates stats, and outputs nicely formatted results with progress bars. It's designed to help track team productivity and identify top contributors. The code is well-structured with separate modules for HTTP requests and includes proper error handling and testing."
+                }
+            ],
+            "initialSnapshot": {
+                "isUnsavedChangesDialogOpen": false,
+                "unsavedFileName": "",
+                "fileExplorerSnapshot": {
+                    "isFileExplorerContextMenuOpen": false,
+                    "isFileContextMenuOpen": false,
+                    "isFolderContextMenuOpen": false,
+                    "isNewFileInputVisible": false,
+                    "isNewFolderInputVisible": false,
+                    "isRenameFileInputVisible": false,
+                    "isRenameFolderInputVisible": false,
+                    "newFileInputValue": "",
+                    "newFolderInputValue": "",
+                    "renameFileInputValue": "",
+                    "renameFolderInputValue": "",
+                    "originalFileBeingRenamed": "",
+                    "originalFolderBeingRenamed": "",
+                    "newFileParentPath": "",
+                    "newFolderParentPath": "",
+                    "fileStructure": {
+                        ".env": {
+                            "type": "file",
+                            "content": "GITLAB_TOKEN=glpat-uShSYUHwpUcDxfkGcoNL",
+                            "language": "plaintext",
+                            "caretPosition": {
+                                "row": 0,
+                                "col": 0
+                            }
+                        },
+                        ".gitignore": {
+                            "type": "file",
+                            "content": ".env",
+                            "language": "plaintext",
+                            "caretPosition": {
+                                "row": 0,
+                                "col": 0
+                            }
+                        },
+                        "go.mod": {
+                            "type": "file",
+                            "content": "module solve.ch/solvers\n\ngo 1.23.0\n\nrequire github.com/xanzy/go-gitlab v0.115.0\n\nrequire (\n\tgithub.com/golang/protobuf v1.5.3 // indirect\n\tgithub.com/google/go-querystring v1.1.0 // indirect\n\tgithub.com/hashicorp/go-cleanhttp v0.5.2 // indirect\n\tgithub.com/hashicorp/go-retryablehttp v0.7.7 // indirect\n\tgithub.com/joho/godotenv v1.5.1\n\tgitlab.com/gitlab-org/api/client-go v0.120.0\n\tgolang.org/x/net v0.8.0 // indirect\n\tgolang.org/x/oauth2 v0.24.0 // indirect\n\tgolang.org/x/time v0.8.0 // indirect\n\tgoogle.golang.org/appengine v1.6.7 // indirect\n\tgoogle.golang.org/protobuf v1.29.1 // indirect\n)\n",
+                            "language": "plaintext",
+                            "caretPosition": {
+                                "row": 0,
+                                "col": 0
+                            }
+                        },
+                        "go.sum": {
+                            "type": "file",
+                            "content": "github.com/golang/protobuf v1.3.1/go.mod h1:6lQm79b+lXiMfvg/cZm0SGofjICqVBUtrP5yJMmIC1U=\ngithub.com/golang/protobuf v1.5.0/go.mod h1:FsONVRAS9T7sI+LIUmWTfcYkHO4aIWwzhcaSAoJOfIk=\ngithub.com/golang/protobuf v1.5.3 h1:KhyjKVUg7Usr/dYsdSqoFveMYd5ko72D+zANwlG1mmg=\ngithub.com/golang/protobuf v1.5.3/go.mod h1:XVQd3VNwM+JqD3oG2Ue2ip4fOMUkwXdXDdiuN0vRsmY=\ngithub.com/google/go-cmp v0.5.2/go.mod h1:v8dTdLbMG2kIc/vJvl+f65V22dbkXbowE6jgT/gNBxE=\ngithub.com/google/go-cmp v0.5.5/go.mod h1:v8dTdLbMG2kIc/vJvl+f65V22dbkXbowE6jgT/gNBxE=\ngithub.com/google/go-querystring v1.1.0 h1:AnCroh3fv4ZBgVIf1Iwtovgjaw/GiKJo8M8yD/fhyJ8=\ngithub.com/google/go-querystring v1.1.0/go.mod h1:Kcdr2DB4koayq7X8pmAG4sNG59So17icRSOU623lUBU=\ngithub.com/hashicorp/go-cleanhttp v0.5.2 h1:035FKYIWjmULyFRBKPs8TBQoi0x6d9G4xc9neXJWAZQ=\ngithub.com/hashicorp/go-cleanhttp v0.5.2/go.mod h1:kO/YDlP8L1346E6Sodw+PrpBSV4/SoxCXGY6BqNFT48=\ngithub.com/hashicorp/go-retryablehttp v0.7.7 h1:C8hUCYzor8PIfXHa4UrZkU4VvK8o9ISHxT2Q8+VepXU=\ngithub.com/hashicorp/go-retryablehttp v0.7.7/go.mod h1:pkQpWZeYWskR+D1tR2O5OcBFOxfA7DoAO6xtkuQnHTk=\ngithub.com/joho/godotenv v1.5.1 h1:7eLL/+HRGLY0ldzfGMeQkb7vMd0as4CfYvUVzLqw0N0=\ngithub.com/joho/godotenv v1.5.1/go.mod h1:f4LDr5Voq0i2e/R5DDNOoa2zzDfwtkZa6DnEwAbqwq4=\ngithub.com/xanzy/go-gitlab v0.115.0 h1:6DmtItNcVe+At/liXSgfE/DZNZrGfalQmBRmOcJjOn8=\ngithub.com/xanzy/go-gitlab v0.115.0/go.mod h1:5XCDtM7AM6WMKmfDdOiEpyRWUqui2iS9ILfvCZ2gJ5M=\ngitlab.com/gitlab-org/api/client-go v0.120.0 h1:geCJjojDXxWVmUcTxPcOUCenAWElWB5dVfX3HJGeAMc=\ngitlab.com/gitlab-org/api/client-go v0.120.0/go.mod h1:ygHmS3AU3TpvK+AC6DYO1QuAxLlv6yxYK+/Votr/WFQ=\ngolang.org/x/crypto v0.0.0-20190308221718-c2843e01d9a2/go.mod h1:djNgcEr1/C05ACkg1iLfiJU5Ep61QUkGW8qpdssI0+w=\ngolang.org/x/net v0.0.0-20190603091049-60506f45cf65/go.mod h1:HSz+uSET+XFnRR8LxR5pz3Of3rY3CfYBVs4xY44aLks=\ngolang.org/x/net v0.8.0 h1:Zrh2ngAOFYneWTAIAPethzeaQLuHwhuBkuV6ZiRnUaQ=\ngolang.org/x/net v0.8.0/go.mod h1:QVkue5JL9kW//ek3r6jTKnTFis1tRmNAW2P1shuFdJc=\ngolang.org/x/oauth2 v0.6.0 h1:Lh8GPgSKBfWSwFvtuWOfeI3aAAnbXTSutYxJiOJFgIw=\ngolang.org/x/oauth2 v0.6.0/go.mod h1:ycmewcwgD4Rpr3eZJLSB4Kyyljb3qDh40vJ8STE5HKw=\ngolang.org/x/oauth2 v0.24.0 h1:KTBBxWqUa0ykRPLtV69rRto9TLXcqYkeswu48x/gvNE=\ngolang.org/x/oauth2 v0.24.0/go.mod h1:XYTD2NtWslqkgxebSiOHnXEap4TF09sJSc7H1sXbhtI=\ngolang.org/x/sys v0.0.0-20190215142949-d0b11bdaac8a/go.mod h1:STP8DvDyc/dI5b8T5hshtkjS+E42TnysNCUPdjciGhY=\ngolang.org/x/text v0.3.0/go.mod h1:NqM8EUOU14njkJ3fqMW+pc6Ldnwhi/IjpwHt7yyuwOQ=\ngolang.org/x/text v0.3.2/go.mod h1:bEr9sfX3Q8Zfm5fL9x+3itogRgK3+ptLWKqgva+5dAk=\ngolang.org/x/time v0.3.0 h1:rg5rLMjNzMS1RkNLzCG38eapWhnYLFYXDXj2gOlr8j4=\ngolang.org/x/time v0.3.0/go.mod h1:tRJNPiyCQ0inRvYxbN9jk5I+vvW/OXSQhTDSoE431IQ=\ngolang.org/x/time v0.8.0 h1:9i3RxcPv3PZnitoVGMPDKZSq1xW1gK1Xy3ArNOGZfEg=\ngolang.org/x/time v0.8.0/go.mod h1:3BpzKBy/shNhVucY/MWOyx10tF3SFh9QdLuxbVysPQM=\ngolang.org/x/tools v0.0.0-20180917221912-90fa682c2a6e/go.mod h1:n7NCudcB/nEzxVGmLbDWY5pfWTLqBcC2KZ6jyYvM4mQ=\ngolang.org/x/xerrors v0.0.0-20191204190536-9bdfabe68543/go.mod h1:I/5z698sn9Ka8TeJc9MKroUUfqBBauWjQqLJ2OPfmY0=\ngoogle.golang.org/appengine v1.6.7 h1:FZR1q0exgwxzPzp/aF+VccGrSfxfPpkBqjIIEq3ru6c=\ngoogle.golang.org/appengine v1.6.7/go.mod h1:8WjMMxjGQR8xUklV/ARdw2HLXBOI7O7uCIDZVag1xfc=\ngoogle.golang.org/protobuf v1.26.0-rc.1/go.mod h1:jlhhOSvTdKEhbULTjvd4ARK9grFBp09yW+WbY/TyQbw=\ngoogle.golang.org/protobuf v1.26.0/go.mod h1:9q0QmTI4eRPtz6boOQmLYwt+qCgq0jsYwAQnmE0givc=\ngoogle.golang.org/protobuf v1.29.1 h1:7QBf+IK2gx70Ap/hDsOmam3GE0v9HicjfEdAxE62UoM=\ngoogle.golang.org/protobuf v1.29.1/go.mod h1:HV8QOd/L58Z+nl8r43ehVNZIU/HEI6OcFqwMG9pJV4I=\n",
+                            "language": "plaintext",
+                            "caretPosition": {
+                                "row": 0,
+                                "col": 0
+                            }
+                        },
+                        "http_helper": {
+                            "type": "directory",
+                            "content": "",
+                            "collapsed": false,
+                            "children": {
+                                "http_helper.go": {
+                                    "type": "file",
+                                    "content": "package http_helper\n\nimport (\n\t\"encoding/json\"\n\t\"fmt\"\n\t\"io\"\n\t\"log\"\n\t\"net/http\"\n\t\"net/url\"\n\t\"strings\"\n)\n\n// in the case of GET, the parameter queryParameters is transferred to the URL as query parameters\n// in the case of POST, the parameter body, an io.Reader, is used\nfunc MakeHTTPRequest(fullUrl string, httpMethod string, headers map[string]string, queryParameters url.Values, body io.Reader) ([]byte, error) {\n\tclient := http.Client{}\n\tu, err := url.Parse(fullUrl)\n\tif err != nil {\n\t\treturn nil, err\n\t}\n\n\t// if it's a GET, we need to append the query parameters.\n\tif httpMethod == \"GET\" {\n\t\tq := u.Query()\n\n\t\tfor k, v := range queryParameters {\n\t\t\t// this depends on the type of api, you may need to do it for each of v\n\t\t\tq.Set(k, strings.Join(v, \",\"))\n\t\t}\n\t\t// set the query to the encoded parameters\n\t\tu.RawQuery = q.Encode()\n\t}\n\n\t// regardless of GET or POST, we can safely add the body\n\treq, err := http.NewRequest(httpMethod, u.String(), body)\n\tif err != nil {\n\t\treturn nil, err\n\t}\n\n\t// for each header passed, add the header value to the request\n\tfor k, v := range headers {\n\t\treq.Header.Set(k, v)\n\t}\n\n\t// optional: log the request for easier stack tracing\n\tlog.Printf(\"%s %s\\n\", httpMethod, req.URL.String())\n\n\t// finally, do the request\n\tres, err := client.Do(req)\n\tif err != nil {\n\t\treturn nil, err\n\t}\n\n\tif res == nil {\n\t\treturn nil, fmt.Errorf(\"error: calling %s returned empty response\", u.String())\n\t}\n\n\tresponseData, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\treturn nil, err\n\t}\n\n\tdefer res.Body.Close()\n\n\tif res.StatusCode != http.StatusOK {\n\t\treturn nil, fmt.Errorf(\"error calling %s:\\nstatus: %s\\nresponseData: %s\", u.String(), res.Status, responseData)\n\t}\n\n\treturn responseData, nil\n}\n\nfunc MakeHTTPRequestGeneric[T any](fullUrl string, httpMethod string, headers map[string]string, queryParameters url.Values, body io.Reader, responseType T) (T, error) {\n\tclient := http.Client{}\n\tu, err := url.Parse(fullUrl)\n\tif err != nil {\n\t\treturn responseType, err\n\t}\n\n\t// if it's a GET, we need to append the query parameters.\n\tif httpMethod == \"GET\" {\n\t\tq := u.Query()\n\n\t\tfor k, v := range queryParameters {\n\t\t\t// this depends on the type of api, you may need to do it for each of v\n\t\t\tq.Set(k, strings.Join(v, \",\"))\n\t\t}\n\t\t// set the query to the encoded parameters\n\t\tu.RawQuery = q.Encode()\n\t}\n\n\t// regardless of GET or POST, we can safely add the body\n\treq, err := http.NewRequest(httpMethod, u.String(), body)\n\tif err != nil {\n\t\treturn responseType, err\n\t}\n\n\t// for each header passed, add the header value to the request\n\tfor k, v := range headers {\n\t\treq.Header.Set(k, v)\n\t}\n\n\t// optional: log the request for easier stack tracing\n\tlog.Printf(\"%s %s\\n\", httpMethod, req.URL.String())\n\n\t// finally, do the request\n\tres, err := client.Do(req)\n\tif err != nil {\n\t\treturn responseType, err\n\t}\n\n\tif res == nil {\n\t\treturn responseType, fmt.Errorf(\"error: calling %s returned empty response\", u.String())\n\t}\n\n\tresponseData, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\treturn responseType, err\n\t}\n\n\tdefer res.Body.Close()\n\n\tif res.StatusCode != http.StatusOK {\n\t\treturn responseType, fmt.Errorf(\"error calling %s:\\nstatus: %s\\nresponseData: %s\", u.String(), res.Status, responseData)\n\t}\n\n\tvar responseObject T\n\terr = json.Unmarshal(responseData, &responseObject)\n\n\tif err != nil {\n\t\tlog.Printf(\"error unmarshaling response: %+v\", err)\n\t\treturn responseType, err\n\t}\n\n\treturn responseObject, nil\n}\n",
+                                    "language": "Go",
+                                    "caretPosition": {
+                                        "row": 0,
+                                        "col": 0
+                                    }
+                                }
+                            }
+                        },
+                        "main.go": {
+                            "type": "file",
+                            "content": "package main\n\nimport (\n\t\"bufio\"\n\t\"fmt\"\n\t\"log\"\n\t\"os\"\n\t\"sort\"\n\t\"strings\"\n\t\"time\"\n\n\t\"github.com/joho/godotenv\"\n\t\"solve.ch/solvers/http_helper\"\n)\n\ntype ContributionStats struct {\n\tUsername       string\n\tDailyCommits   int\n\tWeeklyCommits  int\n\tMonthlyCommits int\n\tYearlyCommits  int\n\tDailyMRs       int\n\tWeeklyMRs      int\n\tMonthlyMRs     int\n\tYearlyMRs      int\n\t// New field to store total pages fetched from GitLab\n\tPagesFetched int\n}\n\ntype TimePeriod struct {\n\tStart time.Time\n\tEnd   time.Time\n}\n\ntype GitLabAuthor struct {\n\tID        int    `json:\"id\"`\n\tUsername  string `json:\"username\"`\n\tName      string `json:\"name\"`\n\tState     string `json:\"state\"`\n\tAvatarURL string `json:\"avatar_url\"`\n\tWebURL    string `json:\"web_url\"`\n}\n\ntype GitLabPushData struct {\n\tCommitCount int    `json:\"commit_count\"`\n\tAction      string `json:\"action\"`\n\tRefType     string `json:\"ref_type\"`\n\tCommitFrom  string `json:\"commit_from\"`\n\tCommitTo    string `json:\"commit_to\"`\n\tRef         string `json:\"ref\"`\n\tCommitTitle string `json:\"commit_title\"`\n\tRefCount    *int   `json:\"ref_count\"`\n}\n\ntype GitLabEvent struct {\n\tID          int             `json:\"id\"`\n\tProjectID   int             `json:\"project_id\"`\n\tActionName  string          `json:\"action_name\"`\n\tTargetID    *int            `json:\"target_id\"`\n\tTargetIID   *int            `json:\"target_iid\"`\n\tTargetType  *string         `json:\"target_type\"`\n\tAuthorID    int             `json:\"author_id\"`\n\tTargetTitle *string         `json:\"target_title\"`\n\tCreatedAt   time.Time       `json:\"created_at\"`\n\tAuthor      GitLabAuthor    `json:\"author\"`\n\tPushData    *GitLabPushData `json:\"push_data\"`\n}\n\nfunc main() {\n\t// Load .env file\n\terr := godotenv.Load()\n\tif err != nil {\n\t\tlog.Println(\"Warning: Error loading .env file:\", err)\n\t}\n\n\t// Replace with your GitLab token\n\ttoken := os.Getenv(\"GITLAB_TOKEN\")\n\tif token == \"\" {\n\t\tlog.Fatal(\"GITLAB_TOKEN environment variable not set\")\n\t}\n\n\t// Read usernames from file\n\tusernames, err := readUsernames(\"usernames.txt\")\n\tif err != nil {\n\t\tlog.Fatalf(\"Failed to read usernames: %v\", err)\n\t}\n\n\t// Get contribution stats for each user\n\tstats := make([]ContributionStats, 0)\n\tfor _, username := range usernames {\n\t\tstat, err := getContributionStats(token, username)\n\t\tif err != nil {\n\t\t\tlog.Printf(\"Warning: Failed to get stats for %s: %v\", username, err)\n\t\t\tcontinue\n\t\t}\n\t\tstats = append(stats, stat)\n\t}\n\n\t// Sort by yearly commits (could be modified to use different metrics)\n\tsort.Slice(stats, func(i, j int) bool {\n\t\treturn stats[i].YearlyCommits > stats[j].YearlyCommits\n\t})\n\n\t// Print results with normalized bars\n\tprintResults(stats)\n}\n\nfunc readUsernames(filename string) ([]string, error) {\n\tfile, err := os.Open(filename)\n\tif err != nil {\n\t\treturn nil, err\n\t}\n\tdefer file.Close()\n\n\tvar usernames []string\n\tscanner := bufio.NewScanner(file)\n\tfor scanner.Scan() {\n\t\tusername := strings.TrimSpace(scanner.Text())\n\t\tif username != \"\" {\n\t\t\tusernames = append(usernames, username)\n\t\t}\n\t}\n\treturn usernames, scanner.Err()\n}\n\nfunc getContributionStats(token, username string) (ContributionStats, error) {\n\tstats := ContributionStats{Username: username}\n\n\t// Define time windows for daily, weekly, monthly, yearly\n\ttodayStart := time.Now().Truncate(24 * time.Hour)\n\ttodayEnd := todayStart.Add(24 * time.Hour)\n\n\t// last 7 days (including today)\n\tweekStart := todayStart.AddDate(0, 0, -6)\n\tweekEnd := todayEnd\n\n\t// last 1 month\n\tmonthStart := todayStart.AddDate(0, -1, 0)\n\tmonthEnd := todayEnd\n\n\t// last 1 year\n\tyearStart := todayStart.AddDate(-1, 0, 0)\n\tyearEnd := todayEnd\n\n\tperiods := map[string]TimePeriod{\n\t\t\"daily\": {\n\t\t\tStart: todayStart,\n\t\t\tEnd:   todayEnd,\n\t\t},\n\t\t\"weekly\": {\n\t\t\tStart: weekStart,\n\t\t\tEnd:   weekEnd,\n\t\t},\n\t\t\"monthly\": {\n\t\t\tStart: monthStart,\n\t\t\tEnd:   monthEnd,\n\t\t},\n\t\t\"yearly\": {\n\t\t\tStart: yearStart,\n\t\t\tEnd:   yearEnd,\n\t\t},\n\t}\n\n\t// We'll track how many pages we fetched total for each user\n\ttotalPages := 0\n\n\t// Get user's events for each time period\n\tfor period, timeRange := range periods {\n\t\tcommits, mrs, pages, err := GetUserActivity(token, username, timeRange.Start, timeRange.End)\n\t\tif err != nil {\n\t\t\treturn stats, err\n\t\t}\n\t\t// Accumulate total page count\n\t\ttotalPages += pages\n\n\t\tswitch period {\n\t\tcase \"daily\":\n\t\t\tstats.DailyCommits = commits\n\t\t\tstats.DailyMRs = mrs\n\t\tcase \"weekly\":\n\t\t\tstats.WeeklyCommits = commits\n\t\t\tstats.WeeklyMRs = mrs\n\t\tcase \"monthly\":\n\t\t\tstats.MonthlyCommits = commits\n\t\t\tstats.MonthlyMRs = mrs\n\t\tcase \"yearly\":\n\t\t\tstats.YearlyCommits = commits\n\t\t\tstats.YearlyMRs = mrs\n\t\t}\n\t}\n\n\t// Store the total pages fetched in stats\n\tstats.PagesFetched = totalPages\n\n\treturn stats, nil\n}\n\n// GetUserActivity returns the total commits, MRs, and the number of pages fetched\nfunc GetUserActivity(token, username string, start, end time.Time) (commits int, mrs int, totalPages int, err error) {\n\tbaseURL := \"https://git.solve.ch/api/v4/users\"\n\t// We will iterate over pages, so exclude &page from the base URL:\n\tfullURL := fmt.Sprintf(\n\t\t\"%s/%s/events?after=%s&before=%s&per_page=100\",\n\t\tbaseURL,\n\t\tusername,\n\t\tstart.Format(\"2006-01-02\"),\n\t\tend.Format(\"2006-01-02\"),\n\t)\n\n\theaders := map[string]string{\n\t\t\"PRIVATE-TOKEN\": token,\n\t}\n\n\tvar allEvents []GitLabEvent\n\tpage := 1\n\n\tfor {\n\t\t// Construct URL for the current page\n\t\tpagedURL := fmt.Sprintf(\"%s&page=%d\", fullURL, page)\n\n\t\tvar tempEvents []GitLabEvent\n\t\ttempEvents, err = http_helper.MakeHTTPRequestGeneric(\n\t\t\tpagedURL,\n\t\t\t\"GET\",\n\t\t\theaders,\n\t\t\tnil,\n\t\t\tnil,\n\t\t\ttempEvents,\n\t\t)\n\t\tif err != nil {\n\t\t\treturn 0, 0, 0, fmt.Errorf(\"failed to get user events (page %d): %v\", page, err)\n\t\t}\n\n\t\t// If no events, we've reached the end\n\t\tif len(tempEvents) == 0 {\n\t\t\tbreak\n\t\t}\n\n\t\t// Accumulate events\n\t\tallEvents = append(allEvents, tempEvents...)\n\t\tpage++\n\t}\n\n\t// The page - 1 is how many pages we actually fetched\n\ttotalPages = page - 1\n\n\t// Count commits and MRs\n\tfor _, event := range allEvents {\n\t\tswitch {\n\t\tcase event.ActionName == \"pushed to\" || event.ActionName == \"pushed new\":\n\t\t\tif event.PushData != nil {\n\t\t\t\tcommits += event.PushData.CommitCount\n\t\t\t}\n\t\tcase event.ActionName == \"accepted\" && event.TargetType != nil && *event.TargetType == \"MergeRequest\":\n\t\t\tmrs++\n\t\tcase event.ActionName == \"opened\" && event.TargetType != nil && *event.TargetType == \"MergeRequest\":\n\t\t\tmrs++\n\t\tdefault:\n\t\t\t// TODO: define a 'miscellaneous' category for other types of events\n\t\t\tcommits++\n\t\t}\n\t}\n\n\treturn commits, mrs, totalPages, nil\n}\n\nfunc printResults(stats []ContributionStats) {\n\n\t// loop over stats to get the average number of commits per merge request\n\tvar totalMRs, totalCommits int\n\tfor _, stat := range stats {\n\t\ttotalMRs += stat.YearlyMRs\n\t\ttotalCommits += stat.YearlyCommits\n\t}\n\n\taverageCommitsPerMR := int(float64(totalCommits) / float64(totalMRs))\n\n\t// Find maximum values for normalization\n\tvar maxDaily, maxWeekly, maxMonthly, maxYearly int\n\tfor _, stat := range stats {\n\t\tmaxDaily = max(maxDaily, stat.DailyCommits+(stat.DailyMRs*averageCommitsPerMR))\n\t\tmaxWeekly = max(maxWeekly, stat.WeeklyCommits+(stat.WeeklyMRs*averageCommitsPerMR))\n\t\tmaxMonthly = max(maxMonthly, stat.MonthlyCommits+(stat.MonthlyMRs*averageCommitsPerMR))\n\t\tmaxYearly = max(maxYearly, stat.YearlyCommits+(stat.YearlyMRs*averageCommitsPerMR))\n\t}\n\n\tvar maxDailyCommits, maxWeeklyCommits, maxMonthlyCommits, maxYearlyCommits int\n\tfor _, stat := range stats {\n\t\tmaxDailyCommits = max(maxDailyCommits, stat.DailyCommits)\n\t\tmaxWeeklyCommits = max(maxWeeklyCommits, stat.WeeklyCommits)\n\t\tmaxMonthlyCommits = max(maxMonthlyCommits, stat.MonthlyCommits)\n\t\tmaxYearlyCommits = max(maxYearlyCommits, stat.YearlyCommits)\n\t}\n\n\tvar maxDailyMRs, maxWeeklyMRs, maxMonthlyMRs, maxYearlyMRs int\n\tfor _, stat := range stats {\n\t\tmaxDailyMRs = max(maxDailyMRs, stat.DailyMRs)\n\t\tmaxWeeklyMRs = max(maxWeeklyMRs, stat.WeeklyMRs)\n\t\tmaxMonthlyMRs = max(maxMonthlyMRs, stat.MonthlyMRs)\n\t\tmaxYearlyMRs = max(maxYearlyMRs, stat.YearlyMRs)\n\t}\n\n\t// sort stats by scaled contributions (commts + scaled MRs)\n\tsort.Slice(stats, func(i, j int) bool {\n\t\treturn (stats[i].YearlyCommits + stats[i].YearlyMRs*averageCommitsPerMR) > (stats[j].YearlyCommits + stats[j].YearlyMRs*averageCommitsPerMR)\n\t})\n\n\tfmt.Println(\"\\n🏆 Top Contributors Overall\\n\")\n\tfmt.Printf(\"(MRs scaled by %dx, the global average commits per MR across Solve)\\n\", averageCommitsPerMR)\n\tfmt.Println(\"========================\")\n\n\temojisByRank := []string{\"🥇\", \"🥈\", \"🥉\"}\n\n\tfor index, stat := range stats {\n\t\t// Use the index to get the corresponding emoji - if we are less than three, use the list\n\t\temoji := \"👨‍💻\"\n\t\tif index < len(emojisByRank) {\n\t\t\temoji = emojisByRank[index]\n\t\t}\n\t\tfmt.Printf(\"\\n%s %s\\n\", emoji, stat.Username)\n\t\tfmt.Printf(\"   (Fetched %d pages from GitLab)\\n\", stat.PagesFetched)\n\n\t\t// Print daily, weekly, monthly, yearly bars\n\t\tprintBar(\"Today    \", stat.DailyCommits+(stat.DailyMRs*averageCommitsPerMR), maxDaily)\n\t\tprintBar(\"Week     \", stat.WeeklyCommits+(stat.WeeklyMRs*averageCommitsPerMR), maxWeekly)\n\t\tprintBar(\"Month    \", stat.MonthlyCommits+(stat.MonthlyMRs*averageCommitsPerMR), maxMonthly)\n\t\tprintBar(\"Year     \", stat.YearlyCommits+(stat.YearlyMRs*averageCommitsPerMR), maxYearly)\n\n\t\tfmt.Printf(\"Details: %d commits, %d MRs in the past year. Total Score: %d\\n\",\n\t\t\tstat.YearlyCommits, stat.YearlyMRs, stat.YearlyCommits+(stat.YearlyMRs*averageCommitsPerMR))\n\t}\n\n\t// sort stats by commits now\n\tsort.Slice(stats, func(i, j int) bool {\n\t\treturn stats[i].YearlyCommits > stats[j].YearlyCommits\n\t})\n\n\tfmt.Println(\"\\n🏆 Top Committers\")\n\tfmt.Println(\"========================\")\n\n\tfor index, stat := range stats {\n\t\t// Use the index to get the corresponding emoji - if we are less than three, use the list\n\t\temoji := \"👨‍💻\"\n\t\tif index < len(emojisByRank) {\n\t\t\temoji = emojisByRank[index]\n\t\t}\n\t\tfmt.Printf(\"\\n%s %s\\n\", emoji, stat.Username)\n\t\tfmt.Printf(\"   (Fetched %d pages from GitLab)\\n\", stat.PagesFetched)\n\n\t\t// Print daily, weekly, monthly, yearly bars\n\t\tprintBar(\"Today    \", stat.DailyCommits, maxDailyCommits)\n\t\tprintBar(\"Week     \", stat.WeeklyCommits, maxWeeklyCommits)\n\t\tprintBar(\"Month    \", stat.MonthlyCommits, maxMonthlyCommits)\n\t\tprintBar(\"Year     \", stat.YearlyCommits, maxYearlyCommits)\n\n\t\tfmt.Printf(\"Details: %d commits in the past year\\n\",\n\t\t\tstat.YearlyCommits)\n\t}\n\n\t// sort stats by MRs now\n\tsort.Slice(stats, func(i, j int) bool {\n\t\treturn stats[i].YearlyMRs > stats[j].YearlyMRs\n\t})\n\n\tfmt.Println(\"\\n🏆 Top Merge Requesters\")\n\tfmt.Println(\"========================\")\n\n\tfor index, stat := range stats {\n\t\t// Use the index to get the corresponding emoji - if we are less than three, use the list\n\t\temoji := \"👨‍💻\"\n\t\tif index < len(emojisByRank) {\n\t\t\temoji = emojisByRank[index]\n\t\t}\n\t\tfmt.Printf(\"\\n%s %s\\n\", emoji, stat.Username)\n\t\tfmt.Printf(\"   (Fetched %d pages from GitLab)\\n\", stat.PagesFetched)\n\n\t\t// Print daily, weekly, monthly, yearly bars\n\t\tprintBar(\"Today    \", stat.DailyMRs, maxDailyMRs)\n\t\tprintBar(\"Week     \", stat.WeeklyMRs, maxWeeklyMRs)\n\t\tprintBar(\"Month    \", stat.MonthlyMRs, maxMonthlyMRs)\n\t\tprintBar(\"Year     \", stat.YearlyMRs, maxYearlyMRs)\n\n\t\tfmt.Printf(\"Details: %d MRs in the past year\\n\",\n\t\t\tstat.YearlyMRs)\n\t}\n}\n\nfunc printBar(label string, value, maxValue int) {\n\tconst barWidth = 30\n\tvar percentage float64\n\tif maxValue > 0 {\n\t\tpercentage = float64(value) / float64(maxValue) * 100\n\t}\n\n\tfilledWidth := int(float64(barWidth) * percentage / 100)\n\tbar := strings.Repeat(\"█\", filledWidth) + strings.Repeat(\"░\", barWidth-filledWidth)\n\n\tfmt.Printf(\"%s [%s] %.1f%% (%d)\\n\", label, bar, percentage, value)\n}\n\nfunc max(a, b int) int {\n\tif a > b {\n\t\treturn a\n\t}\n\treturn b\n}\n",
+                            "language": "Go",
+                            "caretPosition": {
+                                "row": 0,
+                                "col": 0
+                            }
+                        },
+                        "main_test.go": {
+                            "type": "file",
+                            "content": "package main\n\nimport (\n\t\"log\"\n\t\"os\"\n\t\"testing\"\n\t\"time\"\n\n\t\"github.com/joho/godotenv\"\n\t\"solve.ch/solvers/http_helper\"\n)\n\nfunc TestGetUserActivity(t *testing.T) {\n\t// Load .env file\n\terr := godotenv.Load()\n\tif err != nil {\n\t\tlog.Println(\"Warning: Error loading .env file:\", err)\n\t}\n\n\t// Get GitLab token from environment\n\ttoken := os.Getenv(\"GITLAB_TOKEN\")\n\tif token == \"\" {\n\t\tt.Fatal(\"GITLAB_TOKEN environment variable not set\")\n\t}\n\n\t// Set up time range for last 7 days\n\tnow := time.Now()\n\tsevenDaysAgo := now.AddDate(0, 0, -7)\n\n\t// Test GetUserActivity function\n\tcommits, mrs, err := GetUserActivity(token, \"cfrewin\", sevenDaysAgo, now)\n\tif err != nil {\n\t\tt.Fatalf(\"GetUserActivity failed: %v\", err)\n\t}\n\n\t// Log the results\n\tt.Logf(\"Activity for user 'cfrewin' in the last 7 days:\")\n\tt.Logf(\"Commits: %d\", commits)\n\tt.Logf(\"Merge Requests: %d\", mrs)\n\n\t// From the sample JSON, we can see several commits and MRs\n\t// Let's add some basic assertions\n\tif commits == 0 {\n\t\tt.Log(\"Warning: No commits found in the last 7 days\")\n\t}\n\tif mrs < 0 {\n\t\tt.Error(\"Number of merge requests should not be negative\")\n\t}\n\n\t// Add detailed logging of commits by looking at the raw response\n\tresponseData, err := http_helper.MakeHTTPRequest(\n\t\t\"https://git.solve.ch/api/v4/users/cfrewin/events\",\n\t\t\"GET\",\n\t\tmap[string]string{\"PRIVATE-TOKEN\": token},\n\t\tnil,\n\t\tnil,\n\t)\n\tif err != nil {\n\t\tt.Logf(\"Failed to get raw events: %v\", err)\n\t} else {\n\t\tt.Logf(\"Raw response: %s\", string(responseData))\n\t}\n}\n",
+                            "language": "Go",
+                            "caretPosition": {
+                                "row": 0,
+                                "col": 0
+                            }
+                        },
+                        "usernames.txt": {
+                            "type": "file",
+                            "content": "cfrewin\nsgacond\nthuber\nsgulas\nvkamberi\nurust\nsreber\nsrupp\nmsobotka\ndavid.ritter\nrlauber\nmkohler\nakati\nmhemmi\njheron",
+                            "language": "Plain Text",
+                            "caretPosition": {
+                                "row": 0,
+                                "col": 0
+                            }
+                        }
+                    }
+                },
+                "editorSnapshot": {
+                    "isEditorContextMenuOpen": false,
+                    "editors": []
+                },
+                "terminalSnapshot": {
+                    "terminals": []
+                },
+                "mouseSnapshot": {
+                    "location": "editor",
+                    "currentHoveredFileName": "",
+                    "currentHoveredFolderName": "",
+                    "currentHoveredEditorTabFileName": "",
+                    "x": 0,
+                    "y": 0,
+                    "timestamp": 0,
+                    "type": "move",
+                    "buttonStates": {
+                        "left": false,
+                        "right": false,
+                        "middle": false
+                    },
+                    "scrollPosition": {
+                        "x": 0,
+                        "y": 0
+                    }
+                },
+                "authorSnapshot": {
+                    "authors": [
+                        {
+                            "currentSpeechCaption": ""
+                        }
+                    ]
+                }
             }
-        }]
-    })
-);
-
-// add resources
-server.resource(
-    "codevideo_get_action_names",
-    "codevideo_get_action_names://codevideo_get_action_names",
-    (uri) => ({
-        contents: [{
-            uri: uri.href,
-            text: getActionNames()
-        }]
-    })
-);
-
-server.resource(
-    "codevideo_get_example_lesson",
-    new ResourceTemplate("codevideo_get_example_lesson://{keyword}", { list: undefined }),
-    async (uri, { keyword }) => ({
-        contents: [{
-            uri: uri.href,
-            text: getExampleLesson(keyword)
-        }]
-    })
-);
-*/
-server.tool("codevideo_instructions_to_create_a_course", {
-    additionalContext: z.string()
-}, async ({ additionalContext }) => {
-    return {
-        content: [{
-                type: "text",
-                text: instructionsToCreateACourse(additionalContext)
-            }]
-    };
-});
-server.tool("codevideo_instructions_to_create_lesson_actions", {
-    additionalContext: z.string()
-}, async ({ additionalContext }) => {
-    return {
-        content: [{
-                type: "text",
-                text: instructionsToCreateLessonActions(additionalContext)
-            }]
-    };
-});
-server.tool("codevideo_instructions_to_create_lesson_video", {
-    additionalContext: z.string()
-}, async ({ additionalContext }) => {
-    return {
-        content: [{
-                type: "text",
-                text: instructionsToCreateLessonVideo(additionalContext)
-            }]
-    };
-});
-server.tool("codevideo_get_empty_lesson_snapshot", {}, async () => {
-    return {
-        content: [{
-                type: "text",
-                text: getEmptyLessonSnapshot()
-            }]
-    };
+        }
+    }
+];
+// returns a JSON representation of an example lesson based on keywords
+// the LLM can use this to learn real example lessons created by humans
+const getExampleLessonByKeyword = (keyword) => {
+    const exampleJSONs = [];
+    if (Array.isArray(keyword)) {
+        // if the keyword is an array, loop over all keywords and get the example lesson for each one
+        for (var i = 0; i < keyword.length; i++) {
+            const exampleJSON = getExampleLessonByKeyword(keyword[i]);
+            exampleJSONs.push(exampleJSON);
+        }
+        return exampleJSONs.join(", ");
+    }
+    else {
+        // if the keyword is a string, get the example lesson for that keyword
+        const exampleJSON = getSingleExampleLesson(keyword);
+        if (exampleJSON) {
+            return exampleJSON;
+        }
+    }
+    // if no keywords match, return an empty string
+    return "";
+};
+const getSingleExampleLesson = (keyword) => {
+    // loop over all keywords and find the first one that matches
+    for (var i = 0; i < keywordsToExampleLessonsMap.length; i++) {
+        const keywordMap = keywordsToExampleLessonsMap[i];
+        if (keywordMap.keywords.includes(keyword)) {
+            return JSON.stringify(keywordMap.lesson, null, 2);
+        }
+    }
+    // if no keywords match, return an empty string
+    return "";
+};
+
+// Load environment variables from .env file
+dotenv.config();
+const ActionSchema = z.object({
+    name: z.string(),
+    value: z.string()
 });
-server.tool("codevideo_create_course_with_initial_metadata", {
+const CourseSnapshotSchema = z.object({});
+const LessonSchema = z.object({
     id: z.string(),
     name: z.string(),
     description: z.string(),
-    primaryLanguage: z.string()
-}, async ({ id, name, description, primaryLanguage }) => {
-    return {
-        content: [{
-                type: "text",
-                text: createCourseWithInitialMetadata(id, name, description, primaryLanguage)
-            }]
-    };
-});
-server.tool("codevideo_add_actions_to_lesson", {
-    lesson: LessonSchema,
-    actions: z.array(ActionSchema)
-}, async ({ lesson, actions }) => {
-    // Cast the lesson to ILesson
-    const typedLesson = lesson;
-    // Cast the actions to IAction
-    const typedActions = actions;
-    return {
-        content: [{
-                type: "text",
-                text: addActionsToLesson(typedLesson, typedActions)
-            }]
-    };
-});
-server.tool("codevideo_get_final_lesson_snapshot", "Get the final state snapshot after applying CodeVideo actions. Pass actions array OR use previously stored actions from codevideo_set_current_actions (recommended workflow).", {
-    actions: z.array(ActionSchema).optional().describe("Array of CodeVideo actions to apply. Optional if actions were previously stored with codevideo_set_current_actions")
-}, async ({ actions }) => {
-    // Cast the actions to IAction if provided
-    const typedActions = actions;
-    return {
-        content: [{
-                type: "text",
-                text: getFinalLessonSnapshot(typedActions)
-            }]
-    };
+    actions: z.array(ActionSchema),
+    initialSnapshot: CourseSnapshotSchema,
+    finalSnapshot: CourseSnapshotSchema
 });
-server.tool("codevideo_add_lesson_to_course", {
-    course: CourseSchema,
+const CourseSchema = z.object({
     id: z.string(),
     name: z.string(),
-    description: z.string()
-}, async ({ course, id, name, description }) => {
-    // Cast the course to ICourse
-    const typedCourse = course;
-    return {
-        content: [{
-                type: "text",
-                text: addLessonToCourse(typedCourse, id, name, description)
-            }]
-    };
+    description: z.string(),
+    primaryLanguage: z.string(),
+    lessons: z.array(LessonSchema)
 });
-server.tool("codevideo_get_action_names", {}, async () => {
-    return {
-        content: [{
-                type: "text",
+function createMcpServer() {
+    const server = new McpServer({
+        name: "codevideo-mcp",
+        version: version,
+        env: {
+            // preserve existing environment variables
+            ...Object.fromEntries(Object.entries(process.env)
+                .filter(([, value]) => value !== undefined)
+                .map(([key, value]) => [key, value])),
+            MCP_TIMEOUT: String(1200000), // 20 min - needed for video creation waiting
+        }
+    });
+    setupMcpServerTools(server);
+    return server;
+}
+function setupMcpServerTools(server) {
+    // Commenting out prompts and resources that aren't showing up 
+    // - does Claude just use them internally?
+    /*
+    // add prompts
+    server.prompt(
+        "codevideo_create_lesson",
+        { additionalContext: z.string() },
+        ({ additionalContext }) => ({
+            messages: [{
+                role: "user",
+                content: {
+                    type: "text",
+                    text: createLesson(additionalContext)
+                }
+            }]
+        })
+    );
+    
+    // add resources
+    server.resource(
+        "codevideo_get_action_names",
+        "codevideo_get_action_names://codevideo_get_action_names",
+        (uri) => ({
+            contents: [{
+                uri: uri.href,
                 text: getActionNames()
             }]
-    };
-});
-server.tool("codevideo_get_example_lesson", {
-    keyword: z.string()
-}, async ({ keyword }) => {
-    return {
-        content: [{
-                type: "text",
+        })
+    );
+    
+    server.resource(
+        "codevideo_get_example_lesson",
+        new ResourceTemplate("codevideo_get_example_lesson://{keyword}", { list: undefined }),
+        async (uri, { keyword }) => ({
+            contents: [{
+                uri: uri.href,
                 text: getExampleLesson(keyword)
             }]
-    };
-});
-server.tool("codevideo_get_initial_lesson_state_from_local_repo", {
-    repoLocation: z.string()
-}, async ({ repoLocation }) => {
-    return {
-        content: [{
-                type: "text",
-                text: await getInitialLessonStateFromLocalCodebase(repoLocation)
-            }]
-    };
-});
-server.tool("codevideo_make_blog_post", "Generate a markdown blog post from CodeVideo actions. Pass actions array OR use previously stored actions from codevideo_set_current_actions (recommended workflow).", {
-    actions: z.array(ActionSchema).optional().describe("Array of CodeVideo actions. Optional if actions were previously stored with codevideo_set_current_actions")
-}, async ({ actions }) => {
-    // Cast the actions to IAction if provided
-    const typedActions = actions;
-    return {
-        content: [{
-                type: "text",
-                text: makeBlogPost(typedActions)
-            }]
-    };
-});
-server.tool("codevideo_make_html_web_page", "Generate an HTML web page from CodeVideo actions. Pass actions array OR use previously stored actions from codevideo_set_current_actions (recommended workflow).", {
-    actions: z.array(ActionSchema).optional().describe("Array of CodeVideo actions. Optional if actions were previously stored with codevideo_set_current_actions")
-}, async ({ actions }) => {
-    // Cast the actions to IAction if provided
-    const typedActions = actions;
-    return {
-        content: [{
-                type: "text",
-                text: await makeHTMLWebPage(typedActions)
-            }]
-    };
-});
-server.tool("codevideo_make_video", "Generate a video from CodeVideo actions. Pass actions array OR use previously stored actions from codevideo_set_current_actions (recommended workflow).", {
-    actions: z.array(ActionSchema).optional().describe("Array of CodeVideo actions. Optional if actions were previously stored with codevideo_set_current_actions")
-}, async ({ actions }) => {
-    // Cast the actions to IAction if provided
-    const typedActions = actions;
-    try {
-        const result = await makeVideo(typedActions);
+        })
+    );
+    */
+    server.tool("codevideo_instructions_to_create_a_course", {
+        additionalContext: z.string()
+    }, async ({ additionalContext }) => {
         return {
             content: [{
                     type: "text",
-                    text: JSON.stringify({
-                        outputPath: result.outputPath,
-                        stdout: result.stdout,
-                        stderr: result.stderr
-                    }, null, 2)
+                    text: instructionsToCreateACourse(additionalContext)
                 }]
         };
-    }
-    catch (error) {
-        console.error('Error making video:', error);
-        // If the error has the VideoResult structure
-        if (error && typeof error === 'object' && 'stdout' in error && 'stderr' in error) {
+    });
+    server.tool("codevideo_instructions_to_create_lesson_actions", {
+        additionalContext: z.string()
+    }, async ({ additionalContext }) => {
+        return {
+            content: [{
+                    type: "text",
+                    text: instructionsToCreateLessonActions(additionalContext)
+                }]
+        };
+    });
+    server.tool("codevideo_instructions_to_create_lesson_video", {
+        additionalContext: z.string()
+    }, async ({ additionalContext }) => {
+        return {
+            content: [{
+                    type: "text",
+                    text: instructionsToCreateLessonVideo(additionalContext)
+                }]
+        };
+    });
+    server.tool("codevideo_instructions_to_translate_actions", "Generate translation instructions for CodeVideo actions. Pass actions array OR use previously stored actions from codevideo_set_current_actions (recommended workflow).", {
+        actionsToTranslation: z.array(ActionSchema).optional().describe("Array of CodeVideo actions to translate. Optional if actions were previously stored with codevideo_set_current_actions"),
+        targetLanguage: z.string().describe("Target language for translation (e.g., 'Spanish', 'French', 'German')")
+    }, async ({ actionsToTranslation, targetLanguage }) => {
+        // Cast the actions to IAction if provided
+        const typedActions = actionsToTranslation;
+        return {
+            content: [{
+                    type: "text",
+                    text: instructionsToTranslateActions(typedActions, targetLanguage)
+                }]
+        };
+    });
+    server.tool("codevideo_get_empty_lesson_snapshot", {}, async () => {
+        return {
+            content: [{
+                    type: "text",
+                    text: getEmptyLessonSnapshot()
+                }]
+        };
+    });
+    server.tool("codevideo_create_course_with_initial_metadata", {
+        id: z.string(),
+        name: z.string(),
+        description: z.string(),
+        primaryLanguage: z.string()
+    }, async ({ id, name, description, primaryLanguage }) => {
+        return {
+            content: [{
+                    type: "text",
+                    text: createCourseWithInitialMetadata(id, name, description, primaryLanguage)
+                }]
+        };
+    });
+    server.tool("codevideo_add_actions_to_lesson", {
+        lesson: LessonSchema,
+        actions: z.array(ActionSchema)
+    }, async ({ lesson, actions }) => {
+        // Cast the lesson to ILesson
+        const typedLesson = lesson;
+        // Cast the actions to IAction
+        const typedActions = actions;
+        return {
+            content: [{
+                    type: "text",
+                    text: addActionsToLesson(typedLesson, typedActions)
+                }]
+        };
+    });
+    server.tool("codevideo_get_final_lesson_snapshot", "Get the final state snapshot after applying CodeVideo actions. Pass actions array OR use previously stored actions from codevideo_set_current_actions (recommended workflow).", {
+        actions: z.array(ActionSchema).optional().describe("Array of CodeVideo actions to apply. Optional if actions were previously stored with codevideo_set_current_actions")
+    }, async ({ actions }) => {
+        // Cast the actions to IAction if provided
+        const typedActions = actions;
+        return {
+            content: [{
+                    type: "text",
+                    text: getFinalLessonSnapshot(typedActions)
+                }]
+        };
+    });
+    server.tool("codevideo_add_lesson_to_course", {
+        course: CourseSchema,
+        id: z.string(),
+        name: z.string(),
+        description: z.string()
+    }, async ({ course, id, name, description }) => {
+        // Cast the course to ICourse
+        const typedCourse = course;
+        return {
+            content: [{
+                    type: "text",
+                    text: addLessonToCourse(typedCourse, id, name, description)
+                }]
+        };
+    });
+    server.tool("codevideo_get_action_names", {}, async () => {
+        return {
+            content: [{
+                    type: "text",
+                    text: getActionNames()
+                }]
+        };
+    });
+    server.tool("codevideo_get_example_actions_array_by_keyword", {
+        keyword: z.string()
+    }, async ({ keyword }) => {
+        return {
+            content: [{
+                    type: "text",
+                    text: getExampleActionsArrayByKeyword(keyword)
+                }]
+        };
+    });
+    server.tool("codevideo_get_example_lesson_by_keyword", {
+        keyword: z.string()
+    }, async ({ keyword }) => {
+        return {
+            content: [{
+                    type: "text",
+                    text: getExampleLessonByKeyword(keyword)
+                }]
+        };
+    });
+    server.tool("codevideo_get_initial_lesson_state_from_local_repo", "Create an initial lesson state snapshot from a local repository/codebase directory. This captures the file structure and creates an empty lesson template ready for action recording.", {
+        repoLocation: z.string().describe("Local file system path to the repository/codebase directory")
+    }, async ({ repoLocation }) => {
+        return {
+            content: [{
+                    type: "text",
+                    text: await getInitialLessonStateFromLocalCodebase(repoLocation)
+                }]
+        };
+    });
+    server.tool("codevideo_get_initial_lesson_state_from_github_repo", "Create an initial lesson state snapshot from a GitHub repository URL. This fetches the repository content, captures the file structure, and creates an empty lesson template ready for action recording.", {
+        repoUrl: z.string().describe("GitHub repository URL (e.g., https://github.com/user/repo)")
+    }, async ({ repoUrl }) => {
+        return {
+            content: [{
+                    type: "text",
+                    text: await getInitialLessonStateFromGitHubRepo(repoUrl)
+                }]
+        };
+    });
+    server.tool("codevideo_make_blog_post", "Generate a markdown blog post from CodeVideo actions. Pass actions array OR use previously stored actions from codevideo_set_current_actions (recommended workflow).", {
+        actions: z.array(ActionSchema).optional().describe("Array of CodeVideo actions. Optional if actions were previously stored with codevideo_set_current_actions")
+    }, async ({ actions }) => {
+        // Cast the actions to IAction if provided
+        const typedActions = actions;
+        return {
+            content: [{
+                    type: "text",
+                    text: makeBlogPost(typedActions)
+                }]
+        };
+    });
+    server.tool("codevideo_make_html_web_page", "Generate an HTML web page from CodeVideo actions. Pass actions array OR use previously stored actions from codevideo_set_current_actions (recommended workflow).", {
+        actions: z.array(ActionSchema).optional().describe("Array of CodeVideo actions. Optional if actions were previously stored with codevideo_set_current_actions")
+    }, async ({ actions }) => {
+        // Cast the actions to IAction if provided
+        const typedActions = actions;
+        return {
+            content: [{
+                    type: "text",
+                    text: await makeHTMLWebPage(typedActions)
+                }]
+        };
+    });
+    server.tool("codevideo_make_video_from_actions", "Generate a video from CodeVideo actions. Pass actions array OR use previously stored actions from codevideo_set_current_actions (recommended workflow).", {
+        actions: z.array(ActionSchema).optional().describe("Array of CodeVideo actions. Optional if actions were previously stored with codevideo_set_current_actions")
+    }, async ({ actions }) => {
+        // Cast the actions to IAction if provided
+        const typedActions = actions;
+        try {
+            const result = await makeVideoFromActions(typedActions);
             return {
                 content: [{
                         type: "text",
-                        text: `Error creating video: ${error.error?.message || String(error.error)}\nstdout: ${error.stdout}\nstderr: ${error.stderr}`
+                        text: JSON.stringify({
+                            outputPath: result.outputPath,
+                            stdout: result.stdout,
+                            stderr: result.stderr
+                        }, null, 2)
                     }]
             };
         }
-        // Fall back to simple error message
+        catch (error) {
+            console.error('Error making video:', error);
+            // If the error has the VideoResult structure
+            if (error && typeof error === 'object' && 'stdout' in error && 'stderr' in error) {
+                return {
+                    content: [{
+                            type: "text",
+                            text: `Error creating video: ${error.error?.message || String(error.error)}\nstdout: ${error.stdout}\nstderr: ${error.stderr}`
+                        }]
+                };
+            }
+            // Fall back to simple error message
+            return {
+                content: [{
+                        type: "text",
+                        text: `Error creating video: ${error?.message || String(error)}`
+                    }]
+            };
+        }
+    });
+    server.tool("codevideo_make_video_from_lesson", "Generate a video from a complete lesson object. Pass a lesson object OR use previously stored lesson from lesson management tools. This is useful when you have a full lesson with snapshots rather than just actions.", {
+        lesson: LessonSchema.optional().describe("Complete lesson object with snapshots. Optional if lesson was previously stored with lesson management tools")
+    }, async ({ lesson }) => {
+        // Cast the lesson to ILesson if provided
+        const typedLesson = lesson;
+        try {
+            const result = await makeVideoFromLesson(typedLesson);
+            return {
+                content: [{
+                        type: "text",
+                        text: JSON.stringify({
+                            outputPath: result.outputPath,
+                            stdout: result.stdout,
+                            stderr: result.stderr
+                        }, null, 2)
+                    }]
+            };
+        }
+        catch (error) {
+            console.error('Error making video from lesson:', error);
+            // If the error has the VideoResult structure
+            if (error && typeof error === 'object' && 'stdout' in error && 'stderr' in error) {
+                return {
+                    content: [{
+                            type: "text",
+                            text: `Error creating video from lesson: ${error.error?.message || String(error.error)}\nstdout: ${error.stdout}\nstderr: ${error.stderr}`
+                        }]
+                };
+            }
+            // Fall back to simple error message
+            return {
+                content: [{
+                        type: "text",
+                        text: `Error creating video from lesson: ${error?.message || String(error)}`
+                    }]
+            };
+        }
+    });
+    server.tool("codevideo_validate_actions", {
+        actions: z.array(ActionSchema).optional()
+    }, async ({ actions }) => {
+        // Cast the actions to IAction if provided
+        const typedActions = actions;
         return {
             content: [{
                     type: "text",
-                    text: `Error creating video: ${error?.message || String(error)}`
+                    text: validateActions(typedActions)
                 }]
         };
-    }
-});
-server.tool("codevideo_validate_actions", {
-    actions: z.array(ActionSchema).optional()
-}, async ({ actions }) => {
-    // Cast the actions to IAction if provided
-    const typedActions = actions;
-    return {
-        content: [{
-                type: "text",
-                text: validateActions(typedActions)
-            }]
-    };
-});
-server.tool("codevideo_is_repeatable_action", {
-    action: ActionSchema
-}, async ({ action }) => {
-    // Cast the action to IAction
-    const typedAction = action;
-    return {
-        content: [{
-                type: "text",
-                text: isRepeatable(typedAction)
-            }]
-    };
-});
-server.tool("codevideo_critique_video_using_gemini", "Critique a generated video using Google Gemini AI. Pass actions array OR use previously stored actions from codevideo_set_current_actions (recommended workflow).", {
-    videoPath: z.string().describe("Path to the video file to critique"),
-    actions: z.array(ActionSchema).optional().describe("Array of CodeVideo actions used to generate the video. Optional if actions were previously stored with codevideo_set_current_actions")
-}, async ({ videoPath, actions }) => {
-    // Cast the actions to IAction if provided
-    const typedActions = actions;
-    try {
-        const critique = await critiqueVideoUsingGemini(videoPath, typedActions);
+    });
+    server.tool("codevideo_is_repeatable_action", {
+        action: ActionSchema
+    }, async ({ action }) => {
+        // Cast the action to IAction
+        const typedAction = action;
         return {
             content: [{
                     type: "text",
-                    text: critique
+                    text: isRepeatable(typedAction)
                 }]
         };
-    }
-    catch (error) {
-        const errorMessage = error instanceof Error ? error.message : String(error);
-        console.error("Error critiquing video:", errorMessage);
+    });
+    server.tool("codevideo_critique_video_using_gemini", "Critique a generated video using Google Gemini AI. Pass actions array OR use previously stored actions from codevideo_set_current_actions (recommended workflow).", {
+        videoPath: z.string().describe("Path to the video file to critique"),
+        actions: z.array(ActionSchema).optional().describe("Array of CodeVideo actions used to generate the video. Optional if actions were previously stored with codevideo_set_current_actions")
+    }, async ({ videoPath, actions }) => {
+        // Cast the actions to IAction if provided
+        const typedActions = actions;
+        try {
+            const critique = await critiqueVideoUsingGemini(videoPath, typedActions);
+            return {
+                content: [{
+                        type: "text",
+                        text: critique
+                    }]
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            console.error("Error critiquing video:", errorMessage);
+            return {
+                content: [{
+                        type: "text",
+                        text: `Error critiquing video: ${errorMessage}`
+                    }]
+            };
+        }
+    });
+    server.tool("codevideo_set_current_actions", "Store actions in local SQLite database for reuse across multiple tool calls. Once set, other tools can be called without re-specifying actions.", {
+        actions: z.array(ActionSchema).describe("Array of CodeVideo actions to store for later use")
+    }, async ({ actions }) => {
+        // Cast the actions to IAction
+        const typedActions = actions;
         return {
             content: [{
                     type: "text",
-                    text: `Error critiquing video: ${errorMessage}`
+                    text: setCurrentActions(typedActions)
                 }]
         };
-    }
-});
-server.tool("codevideo_set_current_actions", "Store actions in local SQLite database for reuse across multiple tool calls. Once set, other tools can be called without re-specifying actions.", {
-    actions: z.array(ActionSchema).describe("Array of CodeVideo actions to store for later use")
-}, async ({ actions }) => {
-    // Cast the actions to IAction
-    const typedActions = actions;
-    return {
-        content: [{
-                type: "text",
-                text: setCurrentActions(typedActions)
-            }]
-    };
-});
-server.tool("codevideo_get_current_actions", "Retrieve the currently stored actions from local database. Use this to inspect what actions were previously set with codevideo_set_current_actions.", {}, async () => {
-    const actions = getCurrentActions();
-    if (!actions) {
+    });
+    server.tool("codevideo_get_current_actions", "Retrieve the currently stored actions from local database. Use this to inspect what actions were previously set with codevideo_set_current_actions.", {}, async () => {
+        const actions = getCurrentActions();
+        if (!actions) {
+            return {
+                content: [{
+                        type: "text",
+                        text: "No actions found in storage. Use codevideo_set_current_actions first to store actions."
+                    }]
+            };
+        }
         return {
             content: [{
                     type: "text",
-                    text: "No actions found in storage. Use codevideo_set_current_actions first to store actions."
+                    text: JSON.stringify(actions, null, 2)
                 }]
         };
-    }
-    return {
-        content: [{
-                type: "text",
-                text: JSON.stringify(actions, null, 2)
-            }]
-    };
-});
-// start the server
-const transport = new StdioServerTransport();
-(async () => {
-    await server.connect(transport);
-})();
+    });
+    server.tool("codevideo_set_current_lesson", "Store a complete lesson object in local SQLite database for reuse across multiple tool calls. Once set, other tools can be called without re-specifying the lesson.", {
+        lesson: LessonSchema.describe("Complete lesson object to store for later use")
+    }, async ({ lesson }) => {
+        // Cast the lesson to ILesson
+        const typedLesson = lesson;
+        return {
+            content: [{
+                    type: "text",
+                    text: setCurrentLesson(typedLesson)
+                }]
+        };
+    });
+    server.tool("codevideo_get_current_lesson", "Retrieve the currently stored lesson from local database. Use this to inspect what lesson was previously set with codevideo_set_current_lesson.", {}, async () => {
+        const lesson = getCurrentLesson();
+        if (!lesson) {
+            return {
+                content: [{
+                        type: "text",
+                        text: "No lesson found in storage. Use codevideo_set_current_lesson first to store a lesson."
+                    }]
+            };
+        }
+        return {
+            content: [{
+                    type: "text",
+                    text: JSON.stringify(lesson, null, 2)
+                }]
+        };
+    });
+}
+// start the server when running directly
+if (import.meta.url === `file://${process.argv[1]}`) {
+    const server = createMcpServer();
+    const transport = new StdioServerTransport();
+    (async () => {
+        await server.connect(transport);
+    })();
+}
+
+export { createMcpServer };