@fullstackcraftllc/codevideo-mcp 1.0.0 → 1.1.0

package/dist/index.js

@@ -1,23 +1,22 @@
-import dotenv from 'dotenv';
-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 { GoogleGenAI } from '@google/genai';
-import { generateMarkdownStringFromActions, generateHtmlStringFromActions } from '@fullstackcraftllc/codevideo-exporters';
-import { spawn } from 'child_process';
-
-var version = "1.0.0";
-
-// this prompt describes how to create a course lesson using the CodeVideo framework
-const instructionsToCreateACourse = (additionalContext) => {
-    return `You are an expert senior software engineer and educator, and skilled in describing software concepts in a way that is easy for students to understand. You are going to create a course using the CodeVideo framework, a framework that uses simple JSON to generate software courses and lessons in a variety of formats (video, markdown, pdf, and more).
+#!/usr/bin/env node
+
+// src/index.ts
+import dotenv from "dotenv";
+import fs9 from "node:fs";
+import { fileURLToPath } from "node:url";
+
+// package.json
+var version = "1.1.0";
+
+// src/index.ts
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z as z2 } from "zod";
+import { AllActionStrings, isRepeatableAction as isRepeatableAction2 } from "@fullstackcraftllc/codevideo-types";
+
+// src/prompts/instructions_to_create_a_course.ts
+var instructionsToCreateACourse = (additionalContext) => {
+  return `You are an expert senior software engineer and educator, and skilled in describing software concepts in a way that is easy for students to understand. You are going to create a course using the CodeVideo framework, a framework that uses simple JSON to generate software courses and lessons in a variety of formats (video, markdown, pdf, and more).
 
     There are a few rules to uphold when making a CodeVideo course:
 
@@ -61,7 +60,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\`
@@ -73,9 +72,36 @@ const instructionsToCreateACourse = (additionalContext) => {
     Good luck, and enjoy creating your course!`;
 };
 
-// this prompt describes how to make lesson actions in the CodeVideo framework
-const instructionsToCreateLessonActions = (additionalContext) => {
-    return `You are an expert senior software engineer and educator, and skilled in describing software concepts in a way that is easy for students to understand. You are going to create lesson actions using the CodeVideo framework, a framework that uses simple JSON to generate tutorials in a variety of formats (video, markdown, pdf, and more). This JSON array is always an array of simple \`IAction\`:
+// src/prompts/actionReference.ts
+import { AllActionDescriptions } from "@fullstackcraftllc/codevideo-types";
+var actionReference = () => AllActionDescriptions.map((action) => `${action.name}: ${action.description} Value: ${action.valueDescription}`).join("\n");
+
+// src/prompts/authoringRules.ts
+var AUTHORING_RULES = `ACTION STYLE AND PACING (this is what makes lessons clear):
+- This JSON array is always an array of simple IAction objects: { name: AllActions, value: string }. codevideo_get_action_names lists every action with what it does and what its value takes, so check the rows for the actions you use; codevideo_get_example_actions_array_by_keyword / codevideo_get_example_lessons_by_keyword give verified human-made examples.
+- The "value" of any action is NEVER empty. Repeatable actions (e.g. editor-enter) take a numeric STRING value, usually "1"; check with codevideo_is_repeatable_action.
+- Interleave speech with typing \u2014 no long silent blocks of code. Narrate the WHY before you write, and keep individual speak actions to 2-3 sentences; break longer narration into multiple author-speak-before actions.
+- Mind the flow of time: speak about saving BEFORE the editor-save; speak about opening a terminal BEFORE terminal-open. REGARDLESS OF ORDER, only ever use the author-speak-before speaking action.
+- Show every new file being made, one of two ways:
+  - The mouse (the default): mouse-move-file-explorer "1" -> mouse-right-click "1" -> mouse-move-file-explorer-context-menu-new-file "1" -> mouse-left-click "1" -> file-explorer-type-new-file-input "<filename>" -> file-explorer-enter-new-file-input "1". For a file inside a folder, start with mouse-move-file-explorer-folder "<folder>" and use mouse-move-file-explorer-folder-context-menu-new-file instead.
+  - The terminal, for more technical lessons: terminal-open "1" (if the terminal isn't open yet) -> terminal-type "touch <path>" -> terminal-enter "1".
+  Folders the same way: mouse-move-file-explorer-context-menu-new-folder with file-explorer-type-new-folder-input / file-explorer-enter-new-folder-input, or terminal-type "mkdir <path>".
+- Never use file-explorer-create-file, file-explorer-create-folder or file-explorer-set-file-contents: they change files with nothing on screen causing it, so things just appear. Don't use the composite-* actions or editor-highlight-code either: they aren't supported yet and do nothing. codevideo_validate_course rejects lessons that use any of these.
+- A file you just created with the mouse is ALREADY open in the editor \u2014 type into it immediately with editor-type; do NOT reopen it. A file made with touch is not open yet: open it as below. When a lesson continues from the previous one, the file you last edited is already the active editor.
+- To open a DIFFERENT existing file: mouse-move-file-explorer-file "<filename>" -> file-explorer-open-file "<filename>". IMPORTANT: file-explorer-open-file's value is the FILENAME, not "1" \u2014 using "1" opens a stray editor and your typing is lost.
+- Save with editor-save once a file's typing is done (narrating it first): compile checks and file reads see saved contents only.
+- editor-type's value is the literal text to insert (including newlines).
+
+NARRATION:
+- Every lesson opens with an author-speak-before (codevideo_validate_course checks this). The first lesson frames what the course builds. Every lesson after the first opens with one sentence recapping the previous lesson (codevideo_add_lesson returns its name and description), e.g. "In the last lesson, we built an add function." Vary the wording from lesson to lesson. If the lesson starts something new, bridge instead: "Last time we built X; now we start Y."
+- After the recap sentence you may show what it refers to: at most two stops, each an action followed by the sentence about what's now on screen. Bring an open file forward with mouse-move-editor-tab "<path>" + mouse-left-click, or open one with mouse-move-file-explorer-file "<path>" + file-explorer-open-file "<path>"; codevideo_add_lesson lists the previous lesson's files and whether they're open. Pick what this lesson builds on. Don't select code in a recap: the next editor-type would replace the selection.
+- Use the inclusive "we" for what happens on screen: "Now we export the function." Switch to "you" for options, advice, caveats and things to try: "You can also write this as an arrow function." Never "I".
+- End each lesson with a short summary, after its final save.
+- Write file and code names as they appear on screen (math.ts, useState): captions show your exact words.`;
+
+// src/prompts/instructions_to_create_lesson_actions.ts
+var instructionsToCreateLessonActions = (additionalContext) => {
+  return `You are an expert senior software engineer and educator, and skilled in describing software concepts in a way that is easy for students to understand. You are going to create lesson actions using the CodeVideo framework, a framework that uses simple JSON to generate tutorials in a variety of formats (video, markdown, pdf, and more). This JSON array is always an array of simple \`IAction\`:
 
     \`\`\`typescript
     export interface IAction {
@@ -106,26 +132,53 @@ const instructionsToCreateLessonActions = (additionalContext) => {
     | ExternalActions;
     \`\`\`
 
-    Here are all the action types you have to choose from:
+    Here is every action you can choose from, with what it does and what its value takes:
 
-    \`\`\`typescript
-    export const AllActionStrings = [
-        ${AllActionStrings.map((action) => `"${action}"`).join(",\n        ")}
-    ];
+    \`\`\`
+${actionReference()}
     \`\`\`
 
-    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!
+    ${AUTHORING_RULES}
+
+    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_markdown_from_actions\`, etc. without needing to re-specify the actions each time. These tools will automatically retrieve the stored actions if no actions parameter is provided. Videos render as background jobs: the video tools return a jobId at once, and \`codevideo_get_render_job\` reports progress and the saved file. For a course of several lessons, use \`codevideo_instructions_to_build_course_from_scratch\` and the course tools instead of this single shared slot.
+
+    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.
 
-    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.
+    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:
 
@@ -135,9 +188,9 @@ const instructionsToCreateLessonActions = (additionalContext) => {
     `;
 };
 
-// this prompt describes how to make lesson actions in the CodeVideo framework
-const instructionsToCreateLessonVideo = (additionalContext) => {
-    return `You are an expert senior software engineer and educator, and skilled in describing software concepts in a way that is easy for students to understand. You are going to create a video lesson using the CodeVideo framework, a framework that uses simple JSON to generate tutorials in a variety of formats (video, markdown, pdf, and more). The JSON array used to create video is always an array of simple type \`IAction\`:
+// src/prompts/instructions_to_create_lesson_video.ts
+var instructionsToCreateLessonVideo = (additionalContext) => {
+  return `You are an expert senior software engineer and educator, and skilled in describing software concepts in a way that is easy for students to understand. You are going to create a video lesson using the CodeVideo framework, a framework that uses simple JSON to generate tutorials in a variety of formats (video, markdown, pdf, and more). The JSON array used to create video is always an array of simple type \`IAction\`:
 
     \`\`\`typescript
     export interface IAction {
@@ -168,23 +221,46 @@ const instructionsToCreateLessonVideo = (additionalContext) => {
     | ExternalActions;
     \`\`\`
 
-    Here are all the action types you have to choose from:
+    Here is every action you can choose from, with what it does and what its value takes:
 
-    \`\`\`typescript
-    export const AllActionStrings = [
-        ${AllActionStrings.map((action) => `"${action}"`).join(",\n        ")}
-    ];
+    \`\`\`
+${actionReference()}
     \`\`\`
 
     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.
     
-    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!
+    ${AUTHORING_RULES}
+
+    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,1179 +270,3511 @@ const instructionsToCreateLessonVideo = (additionalContext) => {
     `;
 };
 
-// retrieves the current actions from the key value sqlite database
-const getCurrentActions = () => {
+// src/constants/Constants.ts
+var CURRENT_ACTIONS_KEY = "current_actions";
+var CURRENT_LESSON_KEY = "current_lesson";
+
+// src/store/db.ts
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { createRequire } from "node:module";
+var codevideoHome = () => {
+  const dir = path.join(os.homedir(), ".codevideo");
+  fs.mkdirSync(dir, { recursive: true });
+  return dir;
+};
+var databasePath = () => path.join(codevideoHome(), "codevideo.db");
+var sqlite;
+var loadSqlite = () => {
+  if (!sqlite) {
+    const emitWarning = process.emitWarning;
+    process.emitWarning = ((warning, ...rest) => {
+      const message = typeof warning === "string" ? warning : warning.message;
+      if (/SQLite/.test(message)) return;
+      return emitWarning.call(process, warning, ...rest);
+    });
     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_actions
-        const stmt = db.prepare(`
-            SELECT value FROM key_value_store 
-            WHERE key = ?
-        `);
-        const result = stmt.get('current_actions');
-        db.close();
-        if (!result) {
-            return null;
-        }
-        // Parse JSON back to actions array
-        const actions = JSON.parse(result.value);
-        return actions;
-    }
-    catch (error) {
-        console.error('Error retrieving actions:', error);
-        return null;
+      sqlite = createRequire(import.meta.url)("node:sqlite");
+    } finally {
+      process.emitWarning = emitWarning;
     }
+  }
+  return sqlite;
+};
+var openDatabase = () => {
+  const db = new (loadSqlite()).DatabaseSync(databasePath());
+  db.exec("PRAGMA busy_timeout = 5000; PRAGMA journal_mode = WAL;");
+  return db;
+};
+var withDatabase = (fn) => {
+  const db = openDatabase();
+  try {
+    return fn(db);
+  } finally {
+    db.close();
+  }
+};
+var transaction = (db, fn) => {
+  db.exec("BEGIN IMMEDIATE");
+  try {
+    const result = fn();
+    db.exec("COMMIT");
+    return result;
+  } catch (error) {
+    db.exec("ROLLBACK");
+    throw error;
+  }
+};
+
+// src/store/keyValueStore.ts
+var SCHEMA = `
+    CREATE TABLE IF NOT EXISTS key_value_store (
+        key TEXT PRIMARY KEY,
+        value TEXT NOT NULL,
+        updated_at DATETIME DEFAULT CURRENT_TIMESTAMP
+    )
+`;
+var setStoredValue = (key, value) => withDatabase((db) => {
+  db.exec(SCHEMA);
+  db.prepare(`INSERT OR REPLACE INTO key_value_store (key, value, updated_at) VALUES (?, ?, CURRENT_TIMESTAMP)`).run(key, value);
+  return databasePath();
+});
+var getStoredValue = (key) => withDatabase((db) => {
+  db.exec(SCHEMA);
+  const row = db.prepare(`SELECT value FROM key_value_store WHERE key = ?`).get(key);
+  return row ? row.value : null;
+});
+
+// src/tools/get_current_actions.ts
+var getCurrentActions = () => {
+  try {
+    const value = getStoredValue(CURRENT_ACTIONS_KEY);
+    return value ? JSON.parse(value) : null;
+  } catch (error) {
+    console.error("Error retrieving actions:", error);
+    return null;
+  }
+};
+var getCurrentActionsOrThrow = () => {
+  const actions = getCurrentActions();
+  if (!actions) {
+    throw new Error("No actions found in storage. Please use codevideo_set_current_actions first to store actions, then try again.");
+  }
+  return actions;
 };
-// Helper function that returns actions or throws descriptive error
-const getCurrentActionsOrThrow = () => {
-    const actions = getCurrentActions();
-    if (!actions) {
-        throw new Error('No actions found in storage. Please use codevideo_set_current_actions first to store actions, then try again.');
+
+// src/prompts/instructions_to_translate_actions.ts
+var instructionsToTranslateActions = (actionsToTranslation, targetLanguage) => {
+  let actionsToUse;
+  if (actionsToTranslation && actionsToTranslation.length > 0) {
+    actionsToUse = actionsToTranslation;
+  } else {
+    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.";
     }
-    return actions;
-};
-
-const getFinalLessonSnapshot = (actions) => {
-    // Use provided actions or retrieve from storage
-    const actionsToUse = actions || getCurrentActionsOrThrow();
-    // create a new instance of codevideo virtual ide
-    const virtualIDE = new VirtualIDE();
-    // apply all actions to the virtual IDE
-    virtualIDE.applyActions(actionsToUse);
-    // get the final snapshot of the virtual IDE
-    const finalSnapshot = virtualIDE.getCourseSnapshot();
-    // return the final snapshot as a string
-    return JSON.stringify(finalSnapshot, null, 2);
-};
-
-const getInitialLessonStateFromLocalCodebase = async (repoLocation) => {
-    // build file structure from files and content from the file system adapter
-    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);
+    actionsToUse = storedActions;
+  }
+  return `## \u{1F4DD} Translation Instructions for CodeVideo Action Scripts
+
+### \u{1F4CC} 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.
+
+---
+
+### \u2705 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"\`  
+     \u2192 Fully translate narration into fluent, natural speech in the target language.
+
+2. **Code comments:**
+   - Lines starting with \`#\` or \`//\` or between \`/* ... */\`  
+     \u2192 Translate the comment portion only, preserving syntax markers.
+
+3. **String literals inside code:**
+   - e.g., \`print("Hello, World!")\`  
+     \u2192 Translate the string inside the quotes, preserving quote marks and code structure.
+
+4. **Terminal outputs:**
+   - \`"name": "terminal-set-output"\`  
+     \u2192 Translate printed outputs line by line.
+
+---
+
+### \u{1F6AB} What NOT to Translate
+Do **not** translate the following:
+
+- \`"name"\` field values (e.g., \`"author-speak-before"\`, \`"editor-type"\`, etc.)  
+  \u2192 These are CodeVideo internal commands.
+
+- File names, identifiers, variables, or function names (e.g., \`main.py\`, \`range\`, \`print\`, \`for i in range(...)\`)  
+  \u2192 Keep code functional and consistent.
+
+- Keywords or syntax in programming code  
+  \u2192 Only translate *comments* and *strings*.
+
+---
+
+### \u{1F4A1} Examples
+
+#### Code Comment
+
+\`\`\`json
+{ "name": "editor-type", "value": "# Print 'Hello, World!' five times" }
+\`\`\`
+
+\u27A1 becomes:
+
+\`\`\`json
+{ "name": "editor-type", "value": "# Imprime '\xA1Hola, Mundo!' cinco veces" }
+\`\`\`
+
+#### Narration
+\`\`\`json
+{ "name": "author-speak-before", "value": "Let's open a terminal and run the script." }
+\`\`\`
+\u27A1 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!
+Hello, World!" }
+\`\`\`
+\u27A1 becomes:
+\`\`\`json
+{ "name": "terminal-set-output", "value": "\xA1Hola, Mundo!
+\xA1Hola, Mundo!" }
+\`\`\`
+
+---
+
+### \u{1F30D} Target Language
+
+The target language will be specified separately. Use fluent, natural phrasing appropriate to that language's tone and style of instruction.
+
+---
+
+### \u{1F9E0} Tips
+
+- Match tone to the original narration (enthusiastic, beginner-friendly).
+- Avoid overly literal translations \u2014 clarity is more important.
+- Maintain line breaks, indentation, and special characters exactly as they appear in code or outputs.
+
+---
+
+### \u2705 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" }
+\`\`\`
+\u27A1 becomes:
+\`\`\`json
+{ "name": "editor-type", "value": "# Imprime '\xA1Hola, Mundo!' cinco veces" }
+\`\`\`
+
+#### Narration
+\`\`\`json
+{ "name": "author-speak-before", "value": "Let's open a terminal and run the script." }
+\`\`\`
+\u27A1 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!
+Hello, World!" }
+\`\`\`
+\u27A1 becomes:
+\`\`\`json
+{ "name": "terminal-set-output", "value": "\xA1Hola, Mundo!
+\xA1Hola, Mundo!" }
+\`\`\`
+
+---
+
+### \u{1F30D} Target Language
+
+The target language will be specified below. Use fluent, natural phrasing appropriate to that language's tone and style of instruction.
+
+---
+
+### \u{1F9E0} Tips
+
+- Match tone to the original narration (enthusiastic, beginner-friendly).
+- Avoid overly literal translations \u2014 clarity is more important.
+- Maintain line breaks, indentation, and special characters exactly as they appear in code or outputs.
+
+---
+
+### \u2705 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 isRepeatable = (action) => {
-    return isRepeatableAction(action) ? "true" : "false";
+// src/prompts/instructions_to_build_course_from_scratch.ts
+var instructionsToBuildCourseFromScratch = (additionalContext) => {
+  return `You are an expert senior software engineer and educator building a COMPLETE, multi-lesson software course with the CodeVideo MCP, in the clear, small-step style of a polished screencast series: one concept per lesson, narrate before and while you type, and make sure the code actually builds at the end of every lesson that is meant to build.
+
+CRITICAL ARCHITECTURE RULE \u2014 keep snapshots OUT of your context:
+The course lives server-side, keyed by id. You author and read only ACTIONS, compile errors, and small targeted file reads. Do NOT fetch or pass whole snapshots or whole course/lesson objects around \u2014 that is what used to make full courses fail. Use the course store tools below; they chain each lesson's ending state into the next for you, server-side.
+
+THE LOOP:
+1. Outline the course first: a numbered list of lessons, each teaching ONE concept, ordered so the code grows naturally from nothing to a working result.
+2. codevideo_create_course(name, description, primaryLanguage) -> returns courseId. Hold onto it.
+3. For each lesson, in order:
+   a. codevideo_add_lesson(courseId, { name, description, mustCompile, continuesFromPrevious: true }).
+      - description is required: one sentence on what the lesson teaches. The next lesson's opening recap is written from it, and the reply gives you the previous lesson's.
+      - Set mustCompile: false for pure slideshow/discussion lessons or deliberate half-refactors where the code is NOT expected to compile yet.
+      - Set mustCompile: true (the default) for any lesson that ends with working code.
+      - The FINAL lesson must be mustCompile: true \u2014 all code must work by the end of the course.
+   b. Author the actions array for this lesson. Build on the previous lesson's ending state (it is already the starting state of this lesson \u2014 you don't pass it in). If you need to know what exists, use codevideo_get_lesson_file_tree, and codevideo_get_lesson_file for a specific file's current contents \u2014 never dump everything.
+   c. codevideo_set_lesson_actions(courseId, lessonId, actions). The server recomputes the lesson's final state.
+   d. If this lesson is mustCompile, codevideo_compile_lesson(courseId, lessonId). If there are errors, fix just the actions involved with codevideo_edit_lesson_actions (find indices with codevideo_get_lesson_actions; don't re-send the whole lesson) and repeat (d) until it compiles clean. (If the compile tool reports "pending", continue \u2014 compilation will be enforced once available.)
+4. When all lessons are authored: codevideo_validate_course(courseId). It returns "done": true only when every lesson's actions are valid, every lesson follows cleanly from the last, every mustCompile lesson compiles, and the final lesson compiles clean. If "done" is false, read "reasons" and the per-lesson results, fix, and re-validate.
+5. Use codevideo_get_course_status(courseId) at any time to see what's authored without pulling snapshots.
+
+HARD RULE \u2014 NO VIDEO DURING AUTHORING:
+For a full course, do NOT generate any video until codevideo_validate_course returns done: true. Rendering is the expensive final step. After validation passes, previews (codevideo_generate_course_previews: an HTML page per lesson) and the final videos (codevideo_render_course_videos: background render jobs, one lesson at a time; follow them with codevideo_list_render_jobs) are a separate, human-approved step \u2014 do not interleave them with authoring.
+
+${AUTHORING_RULES}
+
+Now build the course described here:
+
+${additionalContext}
+`;
 };
 
-const createCourseWithInitialMetadata = (id, name, description, primaryLanguage) => {
-    const course = {
-        id,
-        name,
-        description,
-        primaryLanguage,
-        lessons: []
-    };
-    return JSON.stringify(course, null, 2);
-};
-
-const addLessonToCourse = (course, id, name, description) => {
-    const lesson = {
-        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: '' }
-                ]
-            }
-        }
-    };
-    // Add the lesson to the course
-    course.lessons.push(lesson);
-    // Return the updated course object
-    return JSON.stringify(course, null, 2);
-};
-
-const addActionsToLesson = (lesson, actions) => {
-    lesson.actions = actions;
-    return JSON.stringify(lesson, null, 2);
-};
-
-const getEmptyLessonSnapshot = () => {
-    const snapshot = {
-        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: []
+// src/tools/get_final_lesson_snapshot.ts
+import { VirtualIDE } from "@fullstackcraftllc/codevideo-virtual-ide";
+var getFinalLessonSnapshot = (actions) => {
+  const actionsToUse = actions || getCurrentActionsOrThrow();
+  const virtualIDE = new VirtualIDE();
+  virtualIDE.applyActions(actionsToUse);
+  const finalSnapshot = virtualIDE.getCourseSnapshot();
+  return JSON.stringify(finalSnapshot, null, 2);
+};
+
+// src/tools/get_initial_lesson_state_from_local_repo.ts
+import { buildFileStructureFromRootFolder } from "@fullstackcraftllc/codevideo-adapters";
+var getInitialLessonStateFromLocalCodebase = async (repoLocation) => {
+  const { fileStructure } = await buildFileStructureFromRootFolder(repoLocation);
+  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
         },
-        terminalSnapshot: {
-            terminals: []
+        scrollPosition: {
+          x: 0,
+          y: 0
+        }
+      },
+      authorSnapshot: {
+        authors: [
+          { currentSpeechCaption: "" }
+        ]
+      }
+    }
+  };
+  return JSON.stringify(project);
+};
+
+// src/tools/get_initial_lesson_state_from_github_repo.ts
+import { buildFileStructureFromGitHub } from "@fullstackcraftllc/codevideo-adapters";
+var getInitialLessonStateFromGitHubRepo = async (repoUrl) => {
+  const fileStructure = await buildFileStructureFromGitHub(repoUrl);
+  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
         },
-        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
-            },
+        scrollPosition: {
+          x: 0,
+          y: 0
+        }
+      },
+      authorSnapshot: {
+        authors: [
+          { currentSpeechCaption: "" }
+        ]
+      }
+    }
+  };
+  return JSON.stringify(project);
+};
+
+// src/tools/is_repeatable_action.ts
+import { isRepeatableAction } from "@fullstackcraftllc/codevideo-types";
+var isRepeatable = (action) => {
+  return isRepeatableAction(action) ? "true" : "false";
+};
+
+// src/tools/create_course_with_initial_metadata.ts
+var createCourseWithInitialMetadata = (id, name, description, primaryLanguage) => {
+  const course = {
+    id,
+    name,
+    description,
+    primaryLanguage,
+    lessons: []
+  };
+  return JSON.stringify(course, null, 2);
+};
+
+// src/tools/add_lesson_to_course.ts
+var addLessonToCourse = (course, id, name, description) => {
+  const lesson = {
+    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
         },
-        authorSnapshot: {
-            authors: [
-                { currentSpeechCaption: '' }
-            ]
+        scrollPosition: {
+          x: 0,
+          y: 0
         }
-    };
-    // return the snapshot as a string
-    return JSON.stringify(snapshot, null, 2);
+      },
+      authorSnapshot: {
+        authors: [
+          { currentSpeechCaption: "" }
+        ]
+      }
+    }
+  };
+  course.lessons.push(lesson);
+  return JSON.stringify(course, null, 2);
+};
+
+// src/tools/add_actions_to_lesson.ts
+var addActionsToLesson = (lesson, actions) => {
+  lesson.actions = actions;
+  return JSON.stringify(lesson, null, 2);
 };
 
-const critiqueVideoUsingGemini = async (videoPath, actions) => {
-    // Use provided actions or retrieve from storage
-    const actionsToUse = actions || getCurrentActionsOrThrow();
-    // Check if GEMINI_API_KEY is set in the environment
-    const GEMINI_API_KEY = process.env.GEMINI_API_KEY;
-    if (!GEMINI_API_KEY) {
-        throw new Error('GEMINI_API_KEY environment variable is not set');
+// src/tools/get_empty_lesson_snapshot.ts
+var getEmptyLessonSnapshot = () => {
+  const snapshot = {
+    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: "" }
+      ]
     }
-    // Initialize the Gemini API client
-    const ai = new GoogleGenAI({ apiKey: GEMINI_API_KEY });
-    const prompt = `You are an expert senior software engineer and educator, and skilled in describing software concepts in a way that is easy for students to understand. You are going to critique a procedurally generated software video lesson for clarity, accuracy, and correctness. The video and the lesson actions are attached. Your tasks:
+  };
+  return JSON.stringify(snapshot, null, 2);
+};
+
+// src/tools/critique_video_using_gemini.ts
+import { GoogleGenAI } from "@google/genai";
+import fs2 from "fs";
+var critiqueVideoUsingGemini = async (videoPath, actions) => {
+  const actionsToUse = actions || getCurrentActionsOrThrow();
+  const GEMINI_API_KEY = process.env.GEMINI_API_KEY;
+  if (!GEMINI_API_KEY) {
+    throw new Error("GEMINI_API_KEY environment variable is not set");
+  }
+  const ai = new GoogleGenAI({ apiKey: GEMINI_API_KEY });
+  const prompt = `You are an expert senior software engineer and educator, and skilled in describing software concepts in a way that is easy for students to understand. You are going to critique a procedurally generated software video lesson for clarity, accuracy, and correctness. The video and the lesson actions are attached. Your tasks:
     
     1. Watch the video and read the lesson actions.
     2. Critique the video for clarity, accuracy, and correctness. Of particular note is any audio artifacts or strange wordings. Do not suggest any new material, only critique the existing material.
     3. Provide a summary of your critique, including any errors or inaccuracies you found, and at what action they occur at.`;
-    try {
-        // Read the video file as a binary blob for the API
-        const videoBuffer = fs.readFileSync(videoPath);
-        const videoBase64 = videoBuffer.toString('base64');
-        // Convert actions array to JSON string
-        const actionsJson = JSON.stringify(actionsToUse, null, 2);
-        // Prepare the request with content parts including text and file data
-        const response = await ai.models.generateContent({
-            model: 'gemini-2.5-pro-preview-05-06',
-            contents: [
-                {
-                    role: 'user',
-                    parts: [
-                        { text: prompt },
-                        {
-                            fileData: {
-                                mimeType: 'video/mp4',
-                                fileUri: `data:video/mp4;base64,${videoBase64}`
-                            }
-                        },
-                        {
-                            text: `Here are the lesson actions in JSON format:\n\n${actionsJson}`
-                        }
-                    ]
-                }
-            ]
-        });
-        // Get the response text
-        const result = response.text;
-        return result || "No critique was generated";
-    }
-    catch (error) {
-        console.error('Error during Gemini API call:', error);
-        const errorMessage = error instanceof Error ? error.message : String(error);
-        throw new Error(`Failed to critique video using Gemini: ${errorMessage}`);
-    }
-};
+  try {
+    const videoBuffer = fs2.readFileSync(videoPath);
+    const videoBase64 = videoBuffer.toString("base64");
+    const actionsJson = JSON.stringify(actionsToUse, null, 2);
+    const response = await ai.models.generateContent({
+      model: "gemini-2.5-pro-preview-05-06",
+      contents: [
+        {
+          role: "user",
+          parts: [
+            { text: prompt },
+            {
+              fileData: {
+                mimeType: "video/mp4",
+                fileUri: `data:video/mp4;base64,${videoBase64}`
+              }
+            },
+            {
+              text: `Here are the lesson actions in JSON format:
 
-// sets the current actions to the key value sqlite database
-const setCurrentActions = (actions) => {
-    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 });
+${actionsJson}`
+            }
+          ]
         }
-        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_actions
-        const stmt = db.prepare(`
-            INSERT OR REPLACE INTO key_value_store (key, value, updated_at) 
-            VALUES (?, ?, CURRENT_TIMESTAMP)
-        `);
-        // Convert actions to JSON string and store
-        const actionsJson = JSON.stringify(actions);
-        stmt.run('current_actions', actionsJson);
-        db.close();
-        return `Successfully stored ${actions.length} actions in local database at ${dbPath}`;
-    }
-    catch (error) {
-        return `Error storing actions: ${error.message}`;
-    }
+      ]
+    });
+    const result = response.text;
+    return result || "No critique was generated";
+  } catch (error) {
+    console.error("Error during Gemini API call:", error);
+    const errorMessage = error instanceof Error ? error.message : String(error);
+    throw new Error(`Failed to critique video using Gemini: ${errorMessage}`);
+  }
 };
 
-// calls the markdown generator from the codevideo-exporters package
-const makeBlogPost = (actions) => {
-    // Use provided actions or retrieve from storage
-    const actionsToUse = actions || getCurrentActionsOrThrow();
-    return generateMarkdownStringFromActions(actionsToUse);
-};
-
-// calls the HTML generator from the codevideo-exporters package
-const makeHTMLWebPage = async (actions) => {
-    // Use provided actions or retrieve from storage
-    const actionsToUse = actions || getCurrentActionsOrThrow();
-    // Generate the HTML content
-    const htmlContent = await generateHtmlStringFromActions(actionsToUse);
-    // 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}.html`);
-    // Write HTML to file
-    fs.writeFileSync(outputFile, htmlContent, 'utf8');
-    // Open the HTML file in the default browser
-    const openChild = spawn('open', [outputFile], {
-        detached: true,
-        stdio: 'ignore'
-    });
-    openChild.unref();
-    // Return the HTML content
-    return htmlContent;
+// src/tools/set_current_actions.ts
+var setCurrentActions = (actions) => {
+  try {
+    const dbPath = setStoredValue(CURRENT_ACTIONS_KEY, JSON.stringify(actions));
+    return `Successfully stored ${actions.length} actions in local database at ${dbPath}`;
+  } catch (error) {
+    return `Error storing actions: ${error.message}`;
+  }
 };
 
-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}`);
+// src/tools/set_current_lesson.ts
+var setCurrentLesson = (lesson) => {
+  try {
+    const dbPath = setStoredValue(CURRENT_LESSON_KEY, JSON.stringify(lesson));
+    return `Successfully stored lesson "${lesson.name}" (ID: ${lesson.id}) in local database at ${dbPath}`;
+  } catch (error) {
+    return `Error storing lesson: ${error.message}`;
+  }
+};
+
+// src/tools/get_current_lesson.ts
+var getCurrentLesson = () => {
+  try {
+    const value = getStoredValue(CURRENT_LESSON_KEY);
+    return value ? JSON.parse(value) : null;
+  } catch (error) {
+    console.error("Error retrieving lesson:", error);
+    return null;
+  }
+};
+var 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;
+};
+
+// src/tools/make_markdown_from_actions.ts
+import { generateMarkdownStringFromActions } from "@fullstackcraftllc/codevideo-exporters";
+var makeMarkdownFromActions = (actions) => {
+  const actionsToUse = actions || getCurrentActionsOrThrow();
+  return generateMarkdownStringFromActions(actionsToUse);
+};
+
+// src/tools/make_markdown_from_lesson.ts
+import { generateMarkdownStringFromActions as generateMarkdownStringFromActions2 } from "@fullstackcraftllc/codevideo-exporters";
+var makeMarkdownFromLesson = (lesson) => {
+  const lessonToUse = lesson || getCurrentLesson();
+  if (!lessonToUse) {
+    throw new Error("No lesson provided and no current lesson found in storage");
+  }
+  return generateMarkdownStringFromActions2(lessonToUse.actions);
+};
+
+// src/tools/make_html_web_page.ts
+import os2 from "os";
+import path2 from "path";
+import fs3 from "fs";
+import { spawn } from "child_process";
+import { generateHtmlStringFromActions } from "@fullstackcraftllc/codevideo-exporters";
+var makeHTMLWebPage = async (actions) => {
+  const actionsToUse = actions || getCurrentActionsOrThrow();
+  const htmlContent = await generateHtmlStringFromActions(actionsToUse, {});
+  const homeDir = os2.homedir();
+  const desktopDir = path2.join(homeDir, "Desktop");
+  const timestamp2 = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-");
+  const outputFile = path2.join(desktopDir, `codevideo-${timestamp2}.html`);
+  fs3.writeFileSync(outputFile, htmlContent, "utf8");
+  const openChild = spawn("open", [outputFile], {
+    detached: true,
+    stdio: "ignore"
+  });
+  openChild.unref();
+  return htmlContent;
+};
+
+// src/render/queue.ts
+import fs6 from "node:fs";
+import os3 from "node:os";
+import path6 from "node:path";
+import { estimateVideoDurationInSeconds } from "@fullstackcraftllc/codevideo-types";
+
+// src/render/jobs.ts
+import fs4 from "node:fs";
+import path4 from "node:path";
+import { randomUUID } from "node:crypto";
+
+// src/render/cli.ts
+import path3 from "node:path";
+
+// src/render/options.ts
+import { z } from "zod";
+var RenderOptionsSchema = z.object({
+  orientation: z.enum(["landscape", "portrait"]).optional().describe("Video orientation; portrait renders 1080x1920. For portrait, usually also set isFileExplorerVisible, isEditorTabsVisible, isMinimapVisible and isMouseVisible to false."),
+  theme: z.enum(["light", "dark"]).optional(),
+  withCaptions: z.boolean().optional(),
+  fontSizePx: z.number().positive().optional(),
+  fileExplorerWidth: z.number().positive().optional(),
+  terminalHeight: z.number().positive().optional(),
+  mouseColor: z.string().min(1).optional(),
+  isFileExplorerVisible: z.boolean().optional(),
+  isTerminalVisible: z.boolean().optional(),
+  isEditorTabsVisible: z.boolean().optional(),
+  isMinimapVisible: z.boolean().optional(),
+  isMouseVisible: z.boolean().optional().describe("Draw the mouse cursor. Mouse actions keep their timing and effects when it's hidden."),
+  wordWrap: z.enum(["on", "off"]).optional(),
+  keyboardTypingPauseMs: z.number().int().positive().optional(),
+  standardPauseMs: z.number().int().positive().optional(),
+  longPauseMs: z.number().int().positive().optional(),
+  defaultLanguage: z.string().min(1).optional(),
+  voiceId: z.string().min(1).optional().describe("ElevenLabs voice ID for the narration."),
+  ttsProvider: z.enum(["elevenlabs", "kokoro"]).optional(),
+  renderMode: z.enum(["realtime", "deterministic"]).optional().describe("realtime (default) records the browser as it plays; deterministic renders frame by frame."),
+  renderSeed: z.string().min(1).optional().describe("Deterministic renders only: a seed for reproducible output."),
+  renderWorkers: z.number().int().min(1).max(32).optional().describe("Deterministic renders only: browser workers, 1-32.")
+}).strict().refine((o) => o.renderSeed === void 0 && o.renderWorkers === void 0 || o.renderMode === "deterministic", {
+  message: 'renderSeed and renderWorkers need renderMode: "deterministic"'
+});
+var IDE_PROP_KEYS = [
+  "theme",
+  "withCaptions",
+  "fontSizePx",
+  "fileExplorerWidth",
+  "terminalHeight",
+  "mouseColor",
+  "isFileExplorerVisible",
+  "isTerminalVisible",
+  "isEditorTabsVisible",
+  "isMinimapVisible",
+  "isMouseVisible",
+  "wordWrap",
+  "keyboardTypingPauseMs",
+  "standardPauseMs",
+  "longPauseMs",
+  "defaultLanguage"
+];
+var RENDER_PAGE_PAUSES = { keyboardTypingPauseMs: 40, standardPauseMs: 200 };
+var estimatePauses = (options = {}) => ({
+  keyboardTypingPauseMs: options.keyboardTypingPauseMs ?? RENDER_PAGE_PAUSES.keyboardTypingPauseMs,
+  standardPauseMs: options.standardPauseMs ?? RENDER_PAGE_PAUSES.standardPauseMs
+});
+
+// src/render/cli.ts
+var maxProjectArgumentBytes = (platform = process.platform) => platform === "win32" ? 3e4 : 120 * 1024;
+var ideConfigFor = (options, defaultLanguage) => {
+  const props = {};
+  for (const key of IDE_PROP_KEYS) {
+    if (options[key] !== void 0) props[key] = options[key];
+  }
+  if (Object.keys(props).length === 0) return null;
+  return { theme: "dark", defaultLanguage, withCaptions: true, ...props };
+};
+var cliArgs = (input) => {
+  const args = ["-p", input.projectJson, "-o", input.outputPath];
+  if (input.configPath) args.push("-c", input.configPath);
+  if (input.options.orientation === "portrait") args.push("-n", "portrait");
+  if (input.options.renderMode) args.push("--render-mode", input.options.renderMode);
+  if (input.options.renderSeed) args.push("--render-seed", input.options.renderSeed);
+  if (input.options.renderWorkers) args.push("--render-workers", String(input.options.renderWorkers));
+  if (input.open) args.push("--open");
+  return args;
+};
+var cliEnv = (base, options, nodePath = process.execPath) => {
+  const env = { ...base };
+  const pathKey = Object.keys(env).find((key) => key.toUpperCase() === "PATH") ?? "PATH";
+  env[pathKey] = [path3.dirname(nodePath), env[pathKey]].filter(Boolean).join(path3.delimiter);
+  if (options.voiceId) env.ELEVEN_LABS_VOICE_ID = options.voiceId;
+  if (options.ttsProvider) env.CODEVIDEO_TTS_PROVIDER = options.ttsProvider;
+  return env;
+};
+var PROGRESS = /^\[\s*\d+%\] /;
+var ERROR = /^error: (.+)$/;
+var SAVED = /^✅ CodeVideo successfully generated and saved to (.+)$/;
+var parseCliLine = (line) => {
+  const text = line.trimEnd();
+  if (PROGRESS.test(text)) return { kind: "progress", text };
+  const error = ERROR.exec(text);
+  if (error) return { kind: "error", text: error[1] };
+  const saved = SAVED.exec(text);
+  if (saved) return { kind: "saved", path: saved[1] };
+  return { kind: "other" };
+};
+
+// src/render/jobs.ts
+var SCHEMA2 = `
+    CREATE TABLE IF NOT EXISTS render_jobs (
+        id TEXT PRIMARY KEY,
+        kind TEXT NOT NULL,
+        course_id TEXT,
+        lesson_id TEXT,
+        label TEXT NOT NULL DEFAULT '',
+        output_path TEXT NOT NULL,
+        options TEXT NOT NULL DEFAULT '{}',
+        open INTEGER NOT NULL DEFAULT 0,
+        status TEXT NOT NULL,
+        pid INTEGER,
+        progress TEXT,
+        error TEXT,
+        cancel_requested INTEGER NOT NULL DEFAULT 0,
+        created_at TEXT NOT NULL,
+        started_at TEXT,
+        finished_at TEXT
+    );
+    CREATE INDEX IF NOT EXISTS idx_render_jobs_status ON render_jobs(status);
+    CREATE TABLE IF NOT EXISTS render_worker (
+        id INTEGER PRIMARY KEY CHECK (id = 1),
+        pid INTEGER NOT NULL,
+        heartbeat_at INTEGER NOT NULL
+    );
+`;
+var WORKER_STALE_MS = 1e4;
+var withJobs = (fn) => withDatabase((db) => {
+  db.exec(SCHEMA2);
+  return fn(db);
+});
+var jobDir = (id) => path4.join(codevideoHome(), "jobs", id);
+var toJob = (row) => ({
+  id: row.id,
+  kind: row.kind,
+  courseId: row.course_id,
+  lessonId: row.lesson_id,
+  label: row.label,
+  outputPath: row.output_path,
+  options: JSON.parse(row.options),
+  open: row.open === 1,
+  status: row.status,
+  pid: row.pid,
+  progress: row.progress,
+  error: row.error,
+  cancelRequested: row.cancel_requested === 1,
+  createdAt: row.created_at,
+  startedAt: row.started_at,
+  finishedAt: row.finished_at
+});
+var now = () => (/* @__PURE__ */ new Date()).toISOString();
+var enqueueJobs = (specs) => {
+  const prepared = specs.map((spec) => {
+    const projectJson = JSON.stringify(spec.project);
+    const bytes = Buffer.byteLength(projectJson);
+    if (bytes > maxProjectArgumentBytes()) {
+      throw new Error(
+        `"${spec.label}" is ${Math.ceil(bytes / 1024)} KiB as JSON, more than the ${Math.floor(maxProjectArgumentBytes() / 1024)} KiB the CLI can take on its command line here. Split it into smaller lessons.`
+      );
     }
-    return binaryPath;
+    return { spec, projectJson, id: randomUUID() };
+  });
+  for (const { spec, projectJson, id } of prepared) {
+    const dir = jobDir(id);
+    fs4.mkdirSync(dir, { recursive: true });
+    fs4.writeFileSync(path4.join(dir, "project.json"), projectJson);
+    const config = ideConfigFor(spec.options, spec.defaultLanguage);
+    if (config) fs4.writeFileSync(path4.join(dir, "config.json"), JSON.stringify(config, null, 2));
+  }
+  return withJobs(
+    (db) => transaction(db, () => {
+      const insert = db.prepare(`
+                INSERT INTO render_jobs (id, kind, course_id, lesson_id, label, output_path, options, open, status, created_at)
+                VALUES (?, ?, ?, ?, ?, ?, ?, ?, 'queued', ?)
+            `);
+      return prepared.map(({ spec, id }) => {
+        insert.run(id, spec.kind, spec.courseId ?? null, spec.lessonId ?? null, spec.label, spec.outputPath, JSON.stringify(spec.options), spec.open ? 1 : 0, now());
+        return toJob(db.prepare(`SELECT * FROM render_jobs WHERE id = ?`).get(id));
+      });
+    })
+  );
+};
+var getJob = (id) => withJobs((db) => {
+  const row = db.prepare(`SELECT * FROM render_jobs WHERE id = ?`).get(id);
+  return row ? toJob(row) : null;
+});
+var listJobs = (filter = {}) => withJobs((db) => {
+  const where = [];
+  const params = [];
+  if (filter.courseId) {
+    where.push("course_id = ?");
+    params.push(filter.courseId);
+  }
+  if (filter.status) {
+    where.push("status = ?");
+    params.push(filter.status);
+  }
+  const sql = `SELECT * FROM render_jobs ${where.length ? `WHERE ${where.join(" AND ")}` : ""} ORDER BY rowid DESC LIMIT ?`;
+  return db.prepare(sql).all(...params, filter.limit ?? 20).map(toJob);
+});
+var queuePosition = (id) => withJobs((db) => {
+  const row = db.prepare(`SELECT rowid AS seq, status FROM render_jobs WHERE id = ?`).get(id);
+  if (!row || row.status !== "queued") return null;
+  const ahead = db.prepare(`SELECT COUNT(*) AS n FROM render_jobs WHERE status = 'queued' AND rowid < ?`).get(row.seq);
+  return ahead.n;
+});
+var requestCancel = (target) => withJobs(
+  (db) => transaction(db, () => {
+    const [column, value] = target.jobId ? ["id", target.jobId] : ["course_id", target.courseId ?? ""];
+    const cancelled = db.prepare(`UPDATE render_jobs SET status = 'cancelled', finished_at = ? WHERE ${column} = ? AND status = 'queued'`).run(now(), value).changes;
+    const stopping = db.prepare(`UPDATE render_jobs SET cancel_requested = 1 WHERE ${column} = ? AND status = 'running'`).run(value).changes;
+    return { cancelled: Number(cancelled), stopping: Number(stopping) };
+  })
+);
+var claimNextJob = () => withJobs(
+  (db) => transaction(db, () => {
+    const row = db.prepare(`SELECT * FROM render_jobs WHERE status = 'queued' ORDER BY rowid LIMIT 1`).get();
+    if (!row) return null;
+    db.prepare(`UPDATE render_jobs SET status = 'running', started_at = ? WHERE id = ?`).run(now(), row.id);
+    return toJob({ ...row, status: "running" });
+  })
+);
+var hasQueuedJobs = () => withJobs((db) => !!db.prepare(`SELECT 1 FROM render_jobs WHERE status = 'queued' LIMIT 1`).get());
+var setJobPid = (id, pid) => withJobs((db) => {
+  db.prepare(`UPDATE render_jobs SET pid = ? WHERE id = ?`).run(pid, id);
+});
+var setJobProgress = (id, progress) => withJobs((db) => {
+  db.prepare(`UPDATE render_jobs SET progress = ? WHERE id = ?`).run(progress, id);
+});
+var isCancelRequested = (id) => withJobs((db) => !!db.prepare(`SELECT 1 FROM render_jobs WHERE id = ? AND cancel_requested = 1`).get(id));
+var finishJob = (id, status, error) => withJobs((db) => {
+  db.prepare(`UPDATE render_jobs SET status = ?, error = ?, finished_at = ? WHERE id = ?`).run(status, error, now(), id);
+});
+var isProcessAlive = (pid) => {
+  try {
+    process.kill(pid, 0);
+    return true;
+  } catch (error) {
+    return error.code === "EPERM";
+  }
+};
+var liveWorker = () => withJobs((db) => {
+  const row = db.prepare(`SELECT pid, heartbeat_at FROM render_worker WHERE id = 1`).get();
+  if (!row || Date.now() - row.heartbeat_at > WORKER_STALE_MS || !isProcessAlive(row.pid)) return null;
+  return { pid: row.pid };
+});
+var acquireWorkerLock = (pid) => withJobs(
+  (db) => transaction(db, () => {
+    const row = db.prepare(`SELECT pid, heartbeat_at FROM render_worker WHERE id = 1`).get();
+    if (row && row.pid !== pid && Date.now() - row.heartbeat_at <= WORKER_STALE_MS && isProcessAlive(row.pid)) return false;
+    db.prepare(`INSERT OR REPLACE INTO render_worker (id, pid, heartbeat_at) VALUES (1, ?, ?)`).run(pid, Date.now());
+    return true;
+  })
+);
+var workerHeartbeat = (pid) => withJobs((db) => {
+  db.prepare(`UPDATE render_worker SET heartbeat_at = ? WHERE id = 1 AND pid = ?`).run(Date.now(), pid);
+});
+var releaseWorkerLock = (pid) => withJobs((db) => {
+  db.prepare(`DELETE FROM render_worker WHERE id = 1 AND pid = ?`).run(pid);
+});
+var markOrphanedJobsInterrupted = () => withJobs(
+  (db) => Number(
+    db.prepare(`UPDATE render_jobs SET status = 'interrupted', error = 'The render worker stopped before this job finished.', finished_at = ? WHERE status = 'running'`).run(now()).changes
+  )
+);
+
+// src/render/worker.ts
+import fs5 from "node:fs";
+import path5 from "node:path";
+import { spawn as spawn2, spawnSync } from "node:child_process";
+
+// src/utils/getBinaryPath.ts
+import {
+  resolveCodeVideoCliRuntime
+} from "@fullstackcraftllc/codevideo-cli";
+function getCodeVideoCliRuntime() {
+  return resolveCodeVideoCliRuntime();
 }
 
-const makeVideo = async (actions) => {
+// src/render/worker.ts
+var HEARTBEAT_MS = 2e3;
+var CANCEL_POLL_MS = 500;
+var KILL_GRACE_MS = 1e4;
+var log = (message) => {
+  try {
+    fs5.appendFileSync(path5.join(codevideoHome(), "jobs", "worker.log"), `${(/* @__PURE__ */ new Date()).toISOString()} [${process.pid}] ${message}
+`);
+  } catch {
+  }
+};
+var quietly = (what, fn) => {
+  try {
+    fn();
+  } catch (error) {
+    log(`${what} failed: ${error.message}`);
+  }
+};
+var ensureWorker = () => {
+  if (liveWorker()) return;
+  const orphaned = markOrphanedJobsInterrupted();
+  if (orphaned > 0) log(`marked ${orphaned} job(s) left by a stopped worker as interrupted`);
+  const entry = process.argv[1];
+  if (!entry) throw new Error("Can't start the render worker: the MCP's entry script is unknown.");
+  const child = spawn2(process.execPath, [...process.execArgv, entry, "--render-worker"], {
+    detached: true,
+    stdio: "ignore",
+    windowsHide: true,
+    env: process.env
+  });
+  child.unref();
+};
+var runWorker = async () => {
+  fs5.mkdirSync(path5.join(codevideoHome(), "jobs"), { recursive: true });
+  while (acquireWorkerLock(process.pid)) {
+    log("worker started");
+    const heartbeat = setInterval(() => quietly("heartbeat", () => workerHeartbeat(process.pid)), HEARTBEAT_MS);
     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
-        const actionsJson = JSON.stringify(actionsToUse);
-        // 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(binaryPath, ['make-video'], {
-            stdio: ['pipe', 'pipe', 'pipe'],
-            cwd: process.cwd()
-        });
-        // 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.`,
-            stderr: ''
-        };
-    }
-    catch (error) {
-        console.error('Error starting video generation:', error);
-        return {
-            outputPath: '',
-            stdout: '',
-            stderr: `Failed to start video generation: ${error.message}`,
-            error
-        };
+      for (let job = claimNextJob(); job; job = claimNextJob()) {
+        await runJob(job);
+      }
+    } finally {
+      clearInterval(heartbeat);
+      releaseWorkerLock(process.pid);
     }
+    if (!hasQueuedJobs()) break;
+  }
+  log("worker exiting: queue empty");
 };
-
-/**
- * Validates the actions so the LLM can correct any mistakes it makes
- *
- */
-const validateActions = (actions) => {
-    // Use provided actions or retrieve from storage
-    const actionsToUse = actions || getCurrentActionsOrThrow();
-    // loop over all actions and call the isValidAction function from the types package
-    const errorMessages = [];
-    for (var i = 0; i < actionsToUse.length; i++) {
-        const action = actionsToUse[i];
-        // codevideo-types package should cover all action types - normal and repeatable!
-        if (!isValidAction(action)) {
-            errorMessages.push(`Invalid action at action index ${i}: ${JSON.stringify(action)}. Hint: if this action 'name' is a repeatable action, the 'value' property must be a number. To repeat once, simply use the string "1".`);
-        }
+var sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+var groupAlive = (pgid) => {
+  try {
+    process.kill(-pgid, 0);
+    return true;
+  } catch (error) {
+    return error.code === "EPERM";
+  }
+};
+var stopTree = async (child) => {
+  if (!child.pid) return;
+  if (process.platform === "win32") {
+    spawnSync("taskkill", ["/PID", String(child.pid), "/T", "/F"], { windowsHide: true });
+    return;
+  }
+  const group = child.pid;
+  const signal = (name) => {
+    try {
+      process.kill(-group, name);
+    } catch {
     }
-    if (errorMessages.length > 0) {
-        return JSON.stringify({ isError: true, errorMessages });
+  };
+  signal("SIGINT");
+  for (const deadline = Date.now() + KILL_GRACE_MS; groupAlive(group) && Date.now() < deadline; ) await sleep(200);
+  if (groupAlive(group)) {
+    log(`process group ${group} outlived SIGINT by ${KILL_GRACE_MS / 1e3}s; killing it`);
+    signal("SIGKILL");
+  }
+};
+var followLines = (stream, file, onLine) => {
+  let pending = "";
+  stream.on("data", (chunk) => {
+    file.write(chunk);
+    pending += chunk.toString("utf8");
+    const lines = pending.split("\n");
+    pending = lines.pop() ?? "";
+    lines.forEach((line) => onLine(line.replace(/\r$/, "")));
+  });
+  stream.on("end", () => {
+    if (pending) onLine(pending);
+    file.end();
+  });
+};
+var runJob = async (job) => {
+  const dir = jobDir(job.id);
+  try {
+    const runtime = getCodeVideoCliRuntime();
+    const configPath = path5.join(dir, "config.json");
+    const args = cliArgs({
+      projectJson: fs5.readFileSync(path5.join(dir, "project.json"), "utf8"),
+      outputPath: job.outputPath,
+      configPath: fs5.existsSync(configPath) ? configPath : void 0,
+      options: job.options,
+      open: job.open
+    });
+    fs5.mkdirSync(path5.dirname(job.outputPath), { recursive: true });
+    log(`job ${job.id} (${job.label}) starting`);
+    const [command, commandArgs] = /\.[cm]?js$/i.test(runtime.binaryPath) ? [process.execPath, [runtime.binaryPath, ...args]] : [runtime.binaryPath, args];
+    const child = spawn2(command, commandArgs, {
+      cwd: dir,
+      env: cliEnv(runtime.env, job.options),
+      // Its own process group on Unix, so a cancel can stop Chrome too.
+      detached: process.platform !== "win32",
+      windowsHide: true,
+      stdio: ["ignore", "pipe", "pipe"]
+    });
+    if (child.pid) setJobPid(job.id, child.pid);
+    let lastError = null;
+    let lastProgress = null;
+    const onLine = (line) => {
+      const parsed = parseCliLine(line);
+      if (parsed.kind === "progress" && parsed.text !== lastProgress) {
+        lastProgress = parsed.text;
+        quietly("progress update", () => setJobProgress(job.id, parsed.text));
+      } else if (parsed.kind === "error") {
+        lastError = parsed.text;
+      }
+    };
+    followLines(child.stdout, fs5.createWriteStream(path5.join(dir, "stdout.log")), onLine);
+    followLines(child.stderr, fs5.createWriteStream(path5.join(dir, "stderr.log")), onLine);
+    let stopping;
+    const cancelPoll = setInterval(() => quietly("cancel check", () => {
+      if (!stopping && isCancelRequested(job.id)) {
+        log(`job ${job.id} cancelling`);
+        stopping = stopTree(child);
+      }
+    }), CANCEL_POLL_MS);
+    const exit = await new Promise((resolve) => {
+      child.once("error", (spawnError) => resolve({ code: null, signal: null, spawnError }));
+      child.once("close", (code, signal) => resolve({ code, signal }));
+    });
+    clearInterval(cancelPoll);
+    if (stopping) {
+      await stopping;
+      fs5.rmSync(job.outputPath, { force: true });
+      finishJob(job.id, "cancelled", null);
+    } else if (exit.spawnError) {
+      finishJob(job.id, "failed", `Couldn't start codevideo-cli: ${exit.spawnError.message}`);
+    } else if (exit.code === 0 && fs5.existsSync(job.outputPath) && fs5.statSync(job.outputPath).size > 0) {
+      finishJob(job.id, "succeeded", null);
+    } else {
+      const how = exit.code === 0 ? "exited without writing the video" : exit.code !== null ? `exited with code ${exit.code}` : `was stopped by ${exit.signal}`;
+      finishJob(job.id, "failed", lastError ?? `codevideo-cli ${how}; see ${path5.join(dir, "stderr.log")}`);
     }
-    return JSON.stringify({ isError: false, errorMessages: [] });
+    log(`job ${job.id} finished`);
+  } catch (error) {
+    finishJob(job.id, "failed", error.message);
+    log(`job ${job.id} failed in the worker: ${error.stack ?? error}`);
+  }
 };
 
-/**
- * Returns all action names exported by the codevideo-types package, joined by commas.
- */
-const getActionNames = () => {
-    return AllActionStrings.join(", ");
+// src/render/queue.ts
+var outputDirectory = () => process.env.CODEVIDEO_OUTPUT_DIR || path6.join(os3.homedir(), "Desktop");
+var timestamp = () => (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-");
+var newVideoPath = (name) => {
+  const safe = (name ?? "").replace(/[^a-z0-9-_]+/gi, "_").slice(0, 40);
+  return path6.join(outputDirectory(), safe ? `codevideo-${safe}-${timestamp()}.mp4` : `codevideo-${timestamp()}.mp4`);
+};
+var estimatedSeconds = (actions, options) => Math.round(estimateVideoDurationInSeconds(actions, estimatePauses(options)));
+var queueRenders = (specs) => {
+  const jobs = enqueueJobs(specs);
+  ensureWorker();
+  return jobs;
+};
+var lastLines = (file, count) => {
+  try {
+    return fs6.readFileSync(file, "utf8").split("\n").map((line) => line.trimEnd()).filter(Boolean).slice(-count);
+  } catch {
+    return [];
+  }
+};
+var describeJob = (job, withLog = false) => {
+  const position = job.status === "queued" ? queuePosition(job.id) : null;
+  return {
+    jobId: job.id,
+    label: job.label,
+    status: job.status,
+    ...position !== null ? { jobsAhead: position } : {},
+    outputPath: job.outputPath,
+    ...job.status === "succeeded" ? { saved: true } : {},
+    ...job.progress ? { progress: job.progress } : {},
+    ...job.error ? { error: job.error } : {},
+    createdAt: job.createdAt,
+    ...job.startedAt ? { startedAt: job.startedAt } : {},
+    ...job.finishedAt ? { finishedAt: job.finishedAt } : {},
+    ...withLog ? { logTail: lastLines(path6.join(jobDir(job.id), "stderr.log"), 8), logs: jobDir(job.id) } : {}
+  };
+};
+var describeJobById = (jobId, withLog = false) => {
+  const job = getJob(jobId);
+  return job ? describeJob(job, withLog) : null;
 };
 
-const keywordsToExampleMap = [
-    {
-        keywords: ["console log", "javascript", "js", "log"],
-        actions: [
-            {
-                name: "author-speak-before",
-                value: "Today we're going to learn about console.log in JavaScript. Console.log is a function that allows you to print messages to the console, which is useful for debugging and understanding your code better.",
-            },
-            {
-                name: "author-speak-before",
-                value: "Let's first create an index.js file where we will write our code.",
-            },
-            {
-                name: "mouse-move-file-explorer",
-                value: "1",
-            },
-            {
-                name: "mouse-right-click",
-                value: "1",
-            },
-            {
-                name: "mouse-move-file-explorer-context-menu-new-file",
-                value: "1",
-            },
-            {
-                name: "mouse-left-click",
-                value: "1",
-            }
-        ]
+// src/tools/make_video_from_actions.ts
+var queueVideoFromActions = (actions, options = {}, open = true) => {
+  const actionsToUse = actions || getCurrentActionsOrThrow();
+  const [job] = queueRenders([{
+    kind: "actions",
+    label: `${actionsToUse.length} actions`,
+    project: actionsToUse,
+    outputPath: newVideoPath(),
+    options,
+    open,
+    defaultLanguage: options.defaultLanguage ?? "typescript"
+  }]);
+  return { job, estimatedSeconds: estimatedSeconds(actionsToUse, options) };
+};
+
+// src/tools/make_video_from_lesson.ts
+var queueVideoFromLesson = (lesson, options = {}, open = true) => {
+  const lessonToUse = lesson || getCurrentLessonOrThrow();
+  const [job] = queueRenders([{
+    kind: "lesson",
+    label: lessonToUse.name || "lesson",
+    project: lessonToUse,
+    outputPath: newVideoPath(lessonToUse.name),
+    options,
+    open,
+    defaultLanguage: options.defaultLanguage ?? "typescript"
+  }]);
+  return { job, estimatedSeconds: estimatedSeconds(lessonToUse.actions, options) };
+};
+
+// src/tools/validate_actions.ts
+import { isValidAction } from "@fullstackcraftllc/codevideo-types";
+
+// src/validation/rejectedActions.ts
+import { AllActionDescriptions as AllActionDescriptions2 } from "@fullstackcraftllc/codevideo-types";
+var REJECTED_ACTIONS = /* @__PURE__ */ new Map([
+  ["file-explorer-create-file", "make the file with the mouse (right-click, New File) or touch in the terminal"],
+  ["file-explorer-create-folder", "make the folder with the mouse (right-click, New Folder) or mkdir in the terminal"],
+  ["file-explorer-set-file-contents", "type the contents with editor-type"],
+  ["editor-highlight-code", "not supported yet; to point at code, bring its file forward with mouse-move-editor-tab and talk about it"],
+  ["composite-create-file-with-mouse", "not supported yet; make the file with the mouse steps (right-click, New File)"],
+  ["composite-create-file-with-terminal", "not supported yet; type touch <path> with terminal-type, then terminal-enter"],
+  ["composite-create-folder-with-mouse", "not supported yet; make the folder with the mouse steps (right-click, New Folder)"],
+  ["composite-create-folder-with-terminal", "not supported yet; type mkdir <path> with terminal-type, then terminal-enter"],
+  ["composite-close-all-editors-with-mouse", "not supported yet; close editors one at a time with mouse-move-editor-tab-close and mouse-left-click"],
+  ["composite-close-all-editors-with-keyboard", "not supported yet; close editors one at a time with mouse-move-editor-tab-close and mouse-left-click"]
+]);
+var rejectedActionsIn = (actions) => actions.flatMap((action, index) => REJECTED_ACTIONS.has(action.name) ? [{ index, name: action.name }] : []);
+var describeRejected = (rejected) => rejected.map((action) => `action ${action.index} is ${action.name}: ${REJECTED_ACTIONS.get(action.name)}`).join("; ");
+var valueHint = (name) => AllActionDescriptions2.find((action) => action.name === name)?.valueDescription;
+
+// src/tools/validate_actions.ts
+var validateActions = (actions) => {
+  const actionsToUse = actions || getCurrentActionsOrThrow();
+  const errorMessages = [];
+  for (var i = 0; i < actionsToUse.length; i++) {
+    const action = actionsToUse[i];
+    const hint = valueHint(action.name);
+    if (!isValidAction(action)) {
+      errorMessages.push(hint ? `Invalid action at action index ${i}: ${JSON.stringify(action)}. Its value should be: ${hint}` : `Invalid action at action index ${i}: ${JSON.stringify(action)}. Unknown action name; codevideo_get_action_names lists them all.`);
+    }
+  }
+  const rejected = rejectedActionsIn(actionsToUse);
+  if (rejected.length > 0) {
+    errorMessages.push(`Actions lessons can't use: ${describeRejected(rejected)}.`);
+  }
+  if (errorMessages.length > 0) {
+    return JSON.stringify({ isError: true, errorMessages });
+  }
+  return JSON.stringify({ isError: false, errorMessages: [] });
+};
+
+// src/tools/courseTools.ts
+import fs7 from "node:fs";
+import path7 from "node:path";
+import { isValidAction as isValidAction2 } from "@fullstackcraftllc/codevideo-types";
+
+// src/store/courseStore.ts
+import { randomUUID as randomUUID2 } from "node:crypto";
+import { VirtualIDE as VirtualIDE2 } from "@fullstackcraftllc/codevideo-virtual-ide";
+
+// src/utils/emptyCourseSnapshot.ts
+var emptyCourseSnapshot = () => ({
+  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
     },
-    {
-        keywords: ["golang", "go", "golang console log", "golang log"],
-        actions: [
-            {
-                "name": "author-speak-before",
-                "value": "Let's learn how to use the fmt.Println function in Go!"
-            },
-            {
-                "name": "author-speak-before",
-                "value": "Let's first make a main.go file."
-            },
-            {
-                "name": "mouse-move-file-explorer",
-                "value": "1"
-            },
-            {
-                "name": "mouse-right-click",
-                "value": "1"
-            },
-            {
-                "name": "mouse-move-file-explorer-context-menu-new-file",
-                "value": "1"
-            },
-            {
-                "name": "mouse-left-click",
-                "value": "1"
-            },
-            {
-                "name": "file-explorer-type-new-file-input",
-                "value": "main.go"
-            },
-            {
-                "name": "file-explorer-enter-new-file-input",
-                "value": "1"
-            },
-            {
-                "name": "author-speak-before",
-                "value": "First, we'll need to declare the main package, and then the main function."
-            },
-            {
-                "name": "editor-type",
-                "value": "package main"
-            },
-            {
-                "name": "editor-enter",
-                "value": "2"
-            },
-            {
-                "name": "author-speak-before",
-                "value": "And we'll need the fmt package to use the Println function."
-            },
-            {
-                "name": "editor-type",
-                "value": 'import "fmt"'
-            },
-            {
-                "name": "editor-enter",
-                "value": "1"
-            },
-            {
-                "name": "editor-type",
-                "value": "func main() {"
-            },
-            {
-                "name": "editor-enter",
-                "value": "1"
-            },
-            {
-                "name": "author-speak-before",
-                "value": "and let's just print 'Hello world!' to the console."
-            },
-            {
-                "name": "editor-type",
-                "value": '    fmt.Println("Hello, world!")'
-            },
-            {
-                "name": "editor-enter",
-                "value": "1"
-            },
-            {
-                "name": "editor-type",
-                "value": "}"
-            },
-            {
-                "name": "editor-arrow-up",
-                "value": "1"
-            },
-            {
-                "name": "editor-command-right",
-                "value": "1"
-            },
-            {
-                "name": "author-speak-before",
-                "value": "and if I wanted to write the value of some variable to the console, I could do that like so:"
-            },
-            {
-                "name": "editor-backspace",
-                "value": "32"
-            },
-            {
-                "name": "editor-type",
-                "value": "    myVariable := 5"
-            },
-            {
-                "name": "editor-enter",
-                "value": "1"
-            },
-            {
-                "name": "editor-type",
-                "value": "    fmt.Println(myVariable)"
-            },
-            {
-                "name": "author-speak-before",
-                "value": "Now, when I run this code, I would expect the value of 'myVariable' to be printed to the console. Something like:"
-            },
-            {
-                "name": "editor-enter",
-                "value": "1"
-            },
-            {
-                "name": "editor-type",
-                "value": "    // 5"
-            },
-            {
-                "name": "author-speak-before",
-                "value": "Console logging is simple, yet powerful and very useful!"
+    scrollPosition: {
+      x: 0,
+      y: 0
+    }
+  },
+  authorSnapshot: {
+    authors: [
+      { currentSpeechCaption: "" }
+    ]
+  }
+});
+
+// src/store/courseStore.ts
+var COURSE_SCHEMA = `
+        CREATE TABLE IF NOT EXISTS courses (
+            id TEXT PRIMARY KEY,
+            name TEXT NOT NULL,
+            description TEXT NOT NULL DEFAULT '',
+            primary_language TEXT NOT NULL DEFAULT '',
+            lesson_order TEXT NOT NULL DEFAULT '[]',
+            created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+            updated_at DATETIME DEFAULT CURRENT_TIMESTAMP
+        );
+        CREATE TABLE IF NOT EXISTS lessons (
+            id TEXT PRIMARY KEY,
+            course_id TEXT NOT NULL,
+            name TEXT NOT NULL,
+            description TEXT NOT NULL DEFAULT '',
+            must_compile INTEGER NOT NULL DEFAULT 1,
+            continues_from_previous INTEGER NOT NULL DEFAULT 1,
+            actions TEXT NOT NULL DEFAULT '[]',
+            initial_snapshot TEXT NOT NULL,
+            final_snapshot TEXT NOT NULL,
+            created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+            updated_at DATETIME DEFAULT CURRENT_TIMESTAMP
+        );
+        CREATE INDEX IF NOT EXISTS idx_lessons_course ON lessons(course_id);
+`;
+var withDb = (fn) => withDatabase((db) => {
+  db.exec(COURSE_SCHEMA);
+  return fn(db);
+});
+var asRow = (row) => row;
+var replay = (initial, actions) => {
+  const virtualIDE = new VirtualIDE2();
+  virtualIDE.applyCourseSnapshot(initial);
+  if (actions.length > 0) {
+    virtualIDE.applyActions(actions);
+  }
+  return virtualIDE.getCourseSnapshot();
+};
+var replayBreaks = (initial, actions) => {
+  try {
+    replay(initial, actions);
+    return false;
+  } catch {
+    return true;
+  }
+};
+var replayError = (initial, actions, error) => {
+  if (replayBreaks(initial, [])) return new Error(`The lesson's starting state can't be loaded: ${error.message}`);
+  let works = 0;
+  let breaks = actions.length;
+  while (breaks - works > 1) {
+    const mid = works + breaks >> 1;
+    if (replayBreaks(initial, actions.slice(0, mid))) breaks = mid;
+    else works = mid;
+  }
+  const index = breaks - 1;
+  const action = actions[index];
+  const pathHint = `names something that exists at that point, by path (e.g. "src/index.ts")`;
+  const moveIndex = /click/.test(action.name) ? actions.slice(0, index).map((a) => a.name.startsWith("mouse-move")).lastIndexOf(true) : -1;
+  if (moveIndex >= 0) {
+    const move = actions[moveIndex];
+    return new Error(
+      `Action ${index} (${action.name}) clicks what action ${moveIndex} (${move.name} ${JSON.stringify(move.value)}) points at, and that breaks the replay: ${error.message}. Check that action ${moveIndex}'s value ${pathHint}.`
+    );
+  }
+  return new Error(`Action ${index} (${action.name} ${JSON.stringify(action.value)}) breaks the replay: ${error.message}. Check that its value ${pathHint}.`);
+};
+var snapshotFromActions = (initial, actions) => {
+  try {
+    return replay(initial, actions);
+  } catch (error) {
+    throw replayError(initial, actions, error);
+  }
+};
+var fileEntriesFromSnapshot = (snapshot) => {
+  const virtualIDE = new VirtualIDE2();
+  virtualIDE.applyCourseSnapshot(snapshot);
+  return virtualIDE.getFullFilePathsAndContents();
+};
+var rowToLesson = (row) => ({
+  id: row.id,
+  courseId: row.course_id,
+  name: row.name,
+  description: row.description,
+  mustCompile: row.must_compile === 1,
+  continuesFromPrevious: row.continues_from_previous === 1,
+  actions: JSON.parse(row.actions),
+  initialSnapshot: JSON.parse(row.initial_snapshot),
+  finalSnapshot: JSON.parse(row.final_snapshot)
+});
+var getLessonOrder = (db, courseId) => {
+  const row = asRow(db.prepare(`SELECT lesson_order FROM courses WHERE id = ?`).get(courseId));
+  if (!row) throw new Error(`Course not found: ${courseId}`);
+  return JSON.parse(row.lesson_order);
+};
+var getLessonsOrdered = (db, courseId) => {
+  const order = getLessonOrder(db, courseId);
+  const get = db.prepare(`SELECT * FROM lessons WHERE id = ?`);
+  return order.map((id) => asRow(get.get(id))).filter((r) => !!r).map(rowToLesson);
+};
+var recomputeChain = (db, courseId) => {
+  const order = getLessonOrder(db, courseId);
+  const getRow = db.prepare(`SELECT * FROM lessons WHERE id = ?`);
+  const update = db.prepare(`UPDATE lessons SET initial_snapshot = ?, final_snapshot = ?, updated_at = CURRENT_TIMESTAMP WHERE id = ?`);
+  let previousFinal = null;
+  for (const lessonId of order) {
+    const row = asRow(getRow.get(lessonId));
+    if (!row) continue;
+    const lesson = rowToLesson(row);
+    const initial = lesson.continuesFromPrevious && previousFinal ? previousFinal : lesson.initialSnapshot;
+    let final;
+    try {
+      final = snapshotFromActions(initial, lesson.actions);
+    } catch (error) {
+      throw new Error(`Lesson "${lesson.name}": ${error.message}`);
+    }
+    update.run(JSON.stringify(initial), JSON.stringify(final), lessonId);
+    previousFinal = final;
+  }
+};
+var createCourse = (input) => withDb((db) => {
+  const id = input.id && input.id.trim().length > 0 ? input.id.trim() : randomUUID2();
+  db.prepare(`
+            INSERT INTO courses (id, name, description, primary_language, lesson_order)
+            VALUES (?, ?, ?, ?, '[]')
+        `).run(id, input.name, input.description ?? "", input.primaryLanguage ?? "");
+  return id;
+});
+var addLesson = (courseId, input) => withDb((db) => {
+  const order = getLessonOrder(db, courseId);
+  const continuesFromPrevious = input.continuesFromPrevious ?? order.length > 0;
+  let initial;
+  if (continuesFromPrevious && order.length > 0) {
+    const prev = asRow(db.prepare(`SELECT final_snapshot FROM lessons WHERE id = ?`).get(order[order.length - 1]));
+    initial = prev ? JSON.parse(prev.final_snapshot) : emptyCourseSnapshot();
+  } else {
+    initial = input.initialSnapshot ?? emptyCourseSnapshot();
+  }
+  const lessonId = randomUUID2();
+  transaction(db, () => {
+    db.prepare(`
+                INSERT INTO lessons (id, course_id, name, description, must_compile, continues_from_previous, actions, initial_snapshot, final_snapshot)
+                VALUES (?, ?, ?, ?, ?, ?, '[]', ?, ?)
+            `).run(
+      lessonId,
+      courseId,
+      input.name,
+      input.description ?? "",
+      input.mustCompile ?? true ? 1 : 0,
+      continuesFromPrevious ? 1 : 0,
+      JSON.stringify(initial),
+      JSON.stringify(initial)
+      // no actions yet => final == initial
+    );
+    order.push(lessonId);
+    db.prepare(`UPDATE courses SET lesson_order = ?, updated_at = CURRENT_TIMESTAMP WHERE id = ?`).run(JSON.stringify(order), courseId);
+  });
+  return lessonId;
+});
+var setLessonActions = (courseId, lessonId, actions) => withDb(
+  (db) => transaction(db, () => {
+    const exists = db.prepare(`SELECT 1 FROM lessons WHERE id = ? AND course_id = ?`).get(lessonId, courseId);
+    if (!exists) throw new Error(`Lesson not found: ${lessonId} in course ${courseId}`);
+    db.prepare(`UPDATE lessons SET actions = ?, updated_at = CURRENT_TIMESTAMP WHERE id = ?`).run(JSON.stringify(actions), lessonId);
+    recomputeChain(db, courseId);
+    return { actionCount: actions.length };
+  })
+);
+var editLessonActions = (courseId, lessonId, edits) => withDb(
+  (db) => transaction(db, () => {
+    const row = asRow(db.prepare(`SELECT actions FROM lessons WHERE id = ? AND course_id = ?`).get(lessonId, courseId));
+    if (!row) throw new Error(`Lesson not found: ${lessonId} in course ${courseId}`);
+    const actions = JSON.parse(row.actions);
+    edits.forEach((edit, i) => {
+      if (!Number.isInteger(edit.start) || edit.start < 0 || edit.start > actions.length) {
+        throw new Error(`Edit ${i}: start ${edit.start} is outside 0..${actions.length}`);
+      }
+      if (!Number.isInteger(edit.deleteCount) || edit.deleteCount < 0 || edit.start + edit.deleteCount > actions.length) {
+        throw new Error(`Edit ${i}: deleting ${edit.deleteCount} from ${edit.start} runs past the last action (${actions.length})`);
+      }
+      actions.splice(edit.start, edit.deleteCount, ...edit.insert);
+    });
+    db.prepare(`UPDATE lessons SET actions = ?, updated_at = CURRENT_TIMESTAMP WHERE id = ?`).run(JSON.stringify(actions), lessonId);
+    recomputeChain(db, courseId);
+    return { actionCount: actions.length };
+  })
+);
+var getLessonActions = (courseId, lessonId, start = 0, limit = 50) => {
+  const lesson = getLesson(courseId, lessonId);
+  const from = Math.max(0, Math.min(start, lesson.actions.length));
+  return {
+    total: lesson.actions.length,
+    start: from,
+    actions: lesson.actions.slice(from, from + Math.max(0, limit)).map((a, i) => ({ index: from + i, name: a.name, value: a.value }))
+  };
+};
+var getLesson = (courseId, lessonId) => withDb((db) => {
+  const row = asRow(db.prepare(`SELECT * FROM lessons WHERE id = ? AND course_id = ?`).get(lessonId, courseId));
+  if (!row) throw new Error(`Lesson not found: ${lessonId} in course ${courseId}`);
+  return rowToLesson(row);
+});
+var listLessons = (courseId) => withDb((db) => getLessonsOrdered(db, courseId));
+var getCourse = (courseId) => withDb((db) => {
+  const c = asRow(
+    db.prepare(`SELECT id, name, description, primary_language FROM courses WHERE id = ?`).get(courseId)
+  );
+  if (!c) throw new Error(`Course not found: ${courseId}`);
+  return {
+    id: c.id,
+    name: c.name,
+    description: c.description,
+    primaryLanguage: c.primary_language,
+    lessons: getLessonsOrdered(db, courseId)
+  };
+});
+var exportCourse = (courseId) => {
+  const course = getCourse(courseId);
+  const lessons = course.lessons.map((l) => ({
+    id: l.id,
+    name: l.name,
+    description: l.description,
+    actions: l.actions,
+    initialSnapshot: l.initialSnapshot,
+    finalSnapshot: l.finalSnapshot
+  }));
+  return {
+    id: course.id,
+    name: course.name,
+    description: course.description,
+    primaryLanguage: course.primaryLanguage,
+    lessons
+  };
+};
+var getLessonFileTree = (courseId, lessonId) => {
+  const lesson = getLesson(courseId, lessonId);
+  return fileEntriesFromSnapshot(lesson.finalSnapshot).map((f) => f.path).sort();
+};
+var samePath = (a, b) => a.replace(/^\.?\/+/, "") === b.replace(/^\.?\/+/, "");
+var getLessonFile = (courseId, lessonId, filePath) => {
+  const lesson = getLesson(courseId, lessonId);
+  const entry = fileEntriesFromSnapshot(lesson.finalSnapshot).find((f) => samePath(f.path, filePath));
+  return entry ? entry.content : null;
+};
+var getLessonFiles = (courseId, lessonId) => {
+  const lesson = getLesson(courseId, lessonId);
+  return fileEntriesFromSnapshot(lesson.finalSnapshot);
+};
+
+// src/tools/compileCheck.ts
+import { createRequire as createRequire2 } from "node:module";
+var cachedCompileProject = null;
+var getCompileProject = () => {
+  if (!cachedCompileProject) {
+    const require2 = createRequire2(import.meta.url);
+    cachedCompileProject = require2("@fullstackcraftllc/codevideo-dynamic-ast").compileProject;
+  }
+  return cachedCompileProject;
+};
+var compileFiles = async (files) => {
+  if (files.length === 0) {
+    return { status: "ok", projects: [], message: "No files to compile." };
+  }
+  try {
+    const compileProject = getCompileProject();
+    const result = await compileProject(files);
+    const projects = result.projects.map((p) => ({
+      language: p.language,
+      errors: p.errors
+    }));
+    const hasErrors = projects.some((p) => p.errors.length > 0);
+    return { status: hasErrors ? "errors" : "ok", projects };
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    return {
+      status: "errors",
+      projects: [{ language: "unknown", errors: [{ file: "unknown", line: 0, message: `Compile check failed to run: ${message}` }] }]
+    };
+  }
+};
+
+// src/tools/courseTools.ts
+var ok = (data) => JSON.stringify(data, null, 2);
+var createCourseTool = (input) => {
+  const courseId = createCourse(input);
+  return ok({ courseId, message: `Created course "${input.name}". Add lessons with codevideo_add_lesson(courseId).` });
+};
+var filesChangedBy = (lesson) => {
+  const before = new Map(fileEntriesFromSnapshot(lesson.initialSnapshot).map((f) => [f.path, f.content]));
+  const open = new Set((lesson.finalSnapshot.editorSnapshot?.editors ?? []).map((e) => e.filename));
+  return fileEntriesFromSnapshot(lesson.finalSnapshot).filter((f) => before.get(f.path) !== f.content).slice(0, 10).map((f) => {
+    const path9 = f.path.replace(/^\/+/, "");
+    return { path: path9, change: before.has(f.path) ? "changed" : "created", open: open.has(path9) };
+  });
+};
+var addLessonTool = (courseId, input) => {
+  const lessonId = addLesson(courseId, input);
+  const lessons = listLessons(courseId);
+  const index = lessons.findIndex((l) => l.id === lessonId);
+  const lesson = lessons[index];
+  const previous = index > 0 ? lessons[index - 1] : void 0;
+  return ok({
+    lessonId,
+    continuesFromPrevious: lesson.continuesFromPrevious,
+    mustCompile: lesson.mustCompile,
+    // What the opening recap is written from, without loading that lesson.
+    ...previous ? { previousLesson: { name: previous.name, description: previous.description, files: filesChangedBy(previous) } } : {},
+    message: `Added lesson "${input.name}". ` + (lesson.continuesFromPrevious ? "Its initial state is the previous lesson's final state (chained server-side)." : "Its initial state is empty (from scratch).") + " Author its actions, then call codevideo_set_lesson_actions(courseId, lessonId, actions)."
+  });
+};
+var problemsWith = (actions) => {
+  const rejected = rejectedActionsIn(actions);
+  return rejected.length === 0 ? {} : { problems: `Stored, but codevideo_validate_course rejects this lesson until these are replaced: ${describeRejected(rejected)}. codevideo_edit_lesson_actions can swap just those actions.` };
+};
+var setLessonActionsTool = (courseId, lessonId, actions) => {
+  const { actionCount } = setLessonActions(courseId, lessonId, actions);
+  return ok({
+    ok: true,
+    actionCount,
+    message: `Stored ${actionCount} actions. Final snapshot recomputed server-side. Use codevideo_compile_lesson to check it builds.`,
+    ...problemsWith(actions)
+  });
+};
+var editLessonActionsTool = (courseId, lessonId, edits) => {
+  const { actionCount } = editLessonActions(courseId, lessonId, edits);
+  return ok({
+    ok: true,
+    actionCount,
+    message: `Applied ${edits.length} edit(s); the lesson now has ${actionCount} actions. Snapshots recomputed server-side.`,
+    ...problemsWith(getLesson(courseId, lessonId).actions)
+  });
+};
+var getLessonActionsTool = (courseId, lessonId, start, limit) => ok({ courseId, lessonId, ...getLessonActions(courseId, lessonId, start, limit) });
+var getLessonFileTreeTool = (courseId, lessonId) => ok({ courseId, lessonId, files: getLessonFileTree(courseId, lessonId) });
+var getLessonFileTool = (courseId, lessonId, filePath) => {
+  const content = getLessonFile(courseId, lessonId, filePath);
+  if (content === null) {
+    return ok({ courseId, lessonId, path: filePath, found: false, message: "No such file at the end of this lesson." });
+  }
+  return ok({ courseId, lessonId, path: filePath, found: true, content });
+};
+var compileLessonTool = async (courseId, lessonId) => {
+  const files = getLessonFiles(courseId, lessonId);
+  const result = await compileFiles(files);
+  return ok({ courseId, lessonId, fileCount: files.length, ...result });
+};
+var validateCourse = async (courseId) => {
+  const lessons = listLessons(courseId);
+  const results = [];
+  for (let i = 0; i < lessons.length; i++) {
+    const lesson = lessons[i];
+    const invalidActionIndexes = [];
+    lesson.actions.forEach((a, idx) => {
+      if (!isValidAction2(a)) invalidActionIndexes.push(idx);
+    });
+    const rejectedActions = rejectedActionsIn(lesson.actions);
+    const opensWithSpeech = lesson.actions.length === 0 || lesson.actions[0].name === "author-speak-before";
+    let snapshotContinuous = true;
+    if (i > 0 && lesson.continuesFromPrevious) {
+      snapshotContinuous = JSON.stringify(lesson.initialSnapshot) === JSON.stringify(lessons[i - 1].finalSnapshot);
+    }
+    let compileStatus = "skipped";
+    let compileErrors = [];
+    if (lesson.mustCompile) {
+      const c = await compileFiles(getLessonFiles(courseId, lesson.id));
+      compileStatus = c.status;
+      compileErrors = c.projects.filter((p) => p.errors.length > 0);
+    }
+    results.push({
+      lessonId: lesson.id,
+      name: lesson.name,
+      index: i,
+      actionsValid: invalidActionIndexes.length === 0,
+      hasActions: lesson.actions.length > 0,
+      invalidActionIndexes,
+      rejectedActions,
+      opensWithSpeech,
+      snapshotContinuous,
+      mustCompile: lesson.mustCompile,
+      compileStatus,
+      compileErrors
+    });
+  }
+  const allActionsValid = results.every((r) => r.actionsValid);
+  const allAllowed = results.every((r) => r.rejectedActions.length === 0);
+  const allOpenWithSpeech = results.every((r) => r.opensWithSpeech);
+  const allHaveActions = results.every((r) => r.hasActions);
+  const allContinuous = results.every((r) => r.snapshotContinuous);
+  const compileEnforced = results.filter((r) => r.mustCompile);
+  const allMustCompileClean = compileEnforced.every((r) => r.compileStatus === "ok");
+  const finalLesson = results[results.length - 1];
+  const finalCompilesClean = !!finalLesson && finalLesson.mustCompile && finalLesson.compileStatus === "ok";
+  const done = lessons.length > 0 && allHaveActions && allActionsValid && allAllowed && allOpenWithSpeech && allContinuous && allMustCompileClean && finalCompilesClean;
+  const reasons = [];
+  if (lessons.length === 0) reasons.push("Course has no lessons.");
+  for (const lesson of results.filter((result) => !result.hasActions)) {
+    reasons.push(`Lesson "${lesson.name}" (${lesson.lessonId}) has no actions.`);
+  }
+  results.forEach((result, i) => {
+    if (result.invalidActionIndexes.length === 0) return;
+    const details = result.invalidActionIndexes.map((index) => {
+      const action = lessons[i].actions[index];
+      const hint = valueHint(action.name);
+      return hint ? `action ${index} is ${action.name} ${JSON.stringify(action.value)}, but its value should be: ${hint}` : `action ${index} has an unknown name, ${JSON.stringify(action.name)}`;
+    });
+    reasons.push(`Lesson "${result.name}" (${result.lessonId}) has invalid actions: ${details.join("; ")}.`);
+  });
+  for (const result of results.filter((r) => !r.opensWithSpeech)) {
+    reasons.push(`Lesson "${result.name}" (${result.lessonId}) must open with author-speak-before: frame the lesson, and after the first lesson start by recapping the previous one.`);
+  }
+  for (const result of results.filter((r) => r.rejectedActions.length > 0)) {
+    reasons.push(`Lesson "${result.name}" (${result.lessonId}) uses actions lessons can't use; ${describeRejected(result.rejectedActions)}.`);
+  }
+  if (!allContinuous) reasons.push("Some lessons do not follow cleanly from the previous lesson (snapshot discontinuity).");
+  if (!allMustCompileClean) reasons.push("Some lessons marked mustCompile do not compile cleanly.");
+  if (finalLesson && !finalLesson.mustCompile) reasons.push("The final lesson must be marked mustCompile (all code should work by the end).");
+  else if (!finalCompilesClean) reasons.push("The final lesson does not compile cleanly.");
+  return { courseId, done, lessonCount: lessons.length, lessons: results, reasons };
+};
+var validateCourseTool = async (courseId) => ok(await validateCourse(courseId));
+var getCourseStatusTool = (courseId) => {
+  const course = getCourse(courseId);
+  return ok({
+    courseId: course.id,
+    name: course.name,
+    primaryLanguage: course.primaryLanguage,
+    lessonCount: course.lessons.length,
+    lessons: course.lessons.map((l, i) => ({
+      index: i,
+      lessonId: l.id,
+      name: l.name,
+      actionCount: l.actions.length,
+      // At the render page's default pauses, with narration estimated from word counts.
+      estimatedSeconds: estimatedSeconds(l.actions),
+      mustCompile: l.mustCompile,
+      continuesFromPrevious: l.continuesFromPrevious,
+      hasActions: l.actions.length > 0
+    }))
+  });
+};
+var exportCourseTool = (courseId) => {
+  const course = exportCourse(courseId);
+  const dir = path7.join(codevideoHome(), "exports");
+  fs7.mkdirSync(dir, { recursive: true });
+  const file = path7.join(dir, `${courseId.replace(/[^a-z0-9-_]+/gi, "_")}.json`);
+  const json = JSON.stringify(course, null, 2);
+  fs7.writeFileSync(file, json);
+  return ok({
+    courseId,
+    path: file,
+    lessonCount: course.lessons.length,
+    bytes: Buffer.byteLength(json),
+    message: "Exported to a file. Open or pass that path instead of reading the course into context."
+  });
+};
+
+// src/tools/renderTools.ts
+import os4 from "os";
+import fs8 from "fs";
+import path8 from "path";
+import { generateHtmlStringFromLesson } from "@fullstackcraftllc/codevideo-exporters";
+var ok2 = (data) => JSON.stringify(data, null, 2);
+var toILesson = (l) => ({
+  id: l.id,
+  name: l.name,
+  description: l.description,
+  actions: l.actions,
+  initialSnapshot: l.initialSnapshot,
+  finalSnapshot: l.finalSnapshot
+});
+var writePreviewHtml = async (courseId, l) => {
+  const html = await generateHtmlStringFromLesson(toILesson(l), {});
+  const outDir = path8.join(os4.homedir(), ".codevideo", "previews", courseId);
+  fs8.mkdirSync(outDir, { recursive: true });
+  const file = path8.join(outDir, `${l.id}.html`);
+  fs8.writeFileSync(file, html, "utf8");
+  return file;
+};
+var generateLessonPreviewTool = async (courseId, lessonId) => {
+  const file = await writePreviewHtml(courseId, getLesson(courseId, lessonId));
+  return ok2({ courseId, lessonId, previewHtml: file, message: "Open this HTML file in a browser to preview the lesson." });
+};
+var generateCoursePreviewsTool = async (courseId) => {
+  const validation = await validateCourse(courseId);
+  if (!validation.done) {
+    return ok2({
+      ok: false,
+      gated: true,
+      message: "Course has not passed validation yet \u2014 fix it first, then generate previews.",
+      reasons: validation.reasons
+    });
+  }
+  const previews = [];
+  for (const l of listLessons(courseId)) {
+    previews.push({ lessonId: l.id, name: l.name, previewHtml: await writePreviewHtml(courseId, l) });
+  }
+  return ok2({
+    ok: true,
+    courseId,
+    previews,
+    message: "Previews generated. Review them; once a human approves, call codevideo_render_course_videos to spawn per-lesson video rendering."
+  });
+};
+var lessonSpec = (course, l, options, open) => ({
+  kind: "course-lesson",
+  courseId: course.id,
+  lessonId: l.id,
+  label: l.name || "lesson",
+  project: toILesson(l),
+  outputPath: newVideoPath(l.name || "lesson"),
+  options,
+  open,
+  defaultLanguage: options.defaultLanguage ?? (course.primaryLanguage || "typescript")
+});
+var renderLessonVideoTool = async (courseId, lessonId, options = {}, open = true) => {
+  const validation = await validateCourse(courseId);
+  if (!validation.done) {
+    return ok2({ ok: false, gated: true, message: "No video until the course passes validation. Fix the course first.", reasons: validation.reasons });
+  }
+  const course = getCourse(courseId);
+  const lesson = getLesson(courseId, lessonId);
+  const [job] = queueRenders([lessonSpec(course, lesson, options, open)]);
+  return ok2({
+    ok: true,
+    ...describeJob(job),
+    estimatedSeconds: estimatedSeconds(lesson.actions, options),
+    message: "Queued. It renders in the background; check it with codevideo_get_render_job."
+  });
+};
+var renderCourseVideosTool = async (courseId, options = {}, open = false) => {
+  const validation = await validateCourse(courseId);
+  if (!validation.done) {
+    return ok2({ ok: false, gated: true, message: "No video until the course passes validation. Fix the course first.", reasons: validation.reasons });
+  }
+  const course = getCourse(courseId);
+  const jobs = queueRenders(course.lessons.map((l) => lessonSpec(course, l, options, open)));
+  return ok2({
+    ok: true,
+    courseId,
+    jobs: jobs.map((job, i) => ({
+      jobId: job.id,
+      lessonId: job.lessonId,
+      label: job.label,
+      outputPath: job.outputPath,
+      estimatedSeconds: estimatedSeconds(course.lessons[i].actions, options)
+    })),
+    message: `Queued ${jobs.length} lesson video(s). They render one at a time in the background; check them with codevideo_list_render_jobs({ courseId }).`
+  });
+};
+
+// src/resources/get_action_names.ts
+var getActionNames = () => {
+  return actionReference();
+};
+
+// src/resources/get_example_actions_array_by_keyword.ts
+var keywordsToExampleActionsMap = [
+  {
+    keywords: ["console log", "javascript", "js", "log"],
+    actions: [
+      {
+        name: "author-speak-before",
+        value: "Today we're going to learn about console.log in JavaScript. Console.log is a function that allows you to print messages to the console, which is useful for debugging and understanding your code better."
+      },
+      {
+        name: "author-speak-before",
+        value: "Let's first create an index.js file where we will write our code."
+      },
+      {
+        name: "mouse-move-file-explorer",
+        value: "1"
+      },
+      {
+        name: "mouse-right-click",
+        value: "1"
+      },
+      {
+        name: "mouse-move-file-explorer-context-menu-new-file",
+        value: "1"
+      },
+      {
+        name: "mouse-left-click",
+        value: "1"
+      }
+    ]
+  },
+  {
+    keywords: ["golang", "go", "golang console log", "golang log"],
+    actions: [
+      {
+        "name": "author-speak-before",
+        "value": "Let's learn how to use the fmt.Println function in Go!"
+      },
+      {
+        "name": "author-speak-before",
+        "value": "Let's first make a main.go file."
+      },
+      {
+        "name": "mouse-move-file-explorer",
+        "value": "1"
+      },
+      {
+        "name": "mouse-right-click",
+        "value": "1"
+      },
+      {
+        "name": "mouse-move-file-explorer-context-menu-new-file",
+        "value": "1"
+      },
+      {
+        "name": "mouse-left-click",
+        "value": "1"
+      },
+      {
+        "name": "file-explorer-type-new-file-input",
+        "value": "main.go"
+      },
+      {
+        "name": "file-explorer-enter-new-file-input",
+        "value": "1"
+      },
+      {
+        "name": "author-speak-before",
+        "value": "First, we'll need to declare the main package, and then the main function."
+      },
+      {
+        "name": "editor-type",
+        "value": "package main"
+      },
+      {
+        "name": "editor-enter",
+        "value": "2"
+      },
+      {
+        "name": "author-speak-before",
+        "value": "And we'll need the fmt package to use the Println function."
+      },
+      {
+        "name": "editor-type",
+        "value": 'import "fmt"'
+      },
+      {
+        "name": "editor-enter",
+        "value": "1"
+      },
+      {
+        "name": "editor-type",
+        "value": "func main() {"
+      },
+      {
+        "name": "editor-enter",
+        "value": "1"
+      },
+      {
+        "name": "author-speak-before",
+        "value": "and let's just print 'Hello world!' to the console."
+      },
+      {
+        "name": "editor-type",
+        "value": '    fmt.Println("Hello, world!")'
+      },
+      {
+        "name": "editor-enter",
+        "value": "1"
+      },
+      {
+        "name": "editor-type",
+        "value": "}"
+      },
+      {
+        "name": "editor-arrow-up",
+        "value": "1"
+      },
+      {
+        "name": "editor-command-right",
+        "value": "1"
+      },
+      {
+        "name": "author-speak-before",
+        "value": "and if I wanted to write the value of some variable to the console, I could do that like so:"
+      },
+      {
+        "name": "editor-backspace",
+        "value": "32"
+      },
+      {
+        "name": "editor-type",
+        "value": "    myVariable := 5"
+      },
+      {
+        "name": "editor-enter",
+        "value": "1"
+      },
+      {
+        "name": "editor-type",
+        "value": "    fmt.Println(myVariable)"
+      },
+      {
+        "name": "author-speak-before",
+        "value": "Now, when I run this code, I would expect the value of 'myVariable' to be printed to the console. Something like:"
+      },
+      {
+        "name": "editor-enter",
+        "value": "1"
+      },
+      {
+        "name": "editor-type",
+        "value": "    // 5"
+      },
+      {
+        "name": "author-speak-before",
+        "value": "Console logging is simple, yet powerful and very useful!"
+      }
+    ]
+  },
+  {
+    keywords: ["python", "python console log", "python log"],
+    actions: [
+      {
+        "name": "author-speak-before",
+        "value": "Let's learn how to use the print function in Python!"
+      },
+      {
+        "name": "author-speak-before",
+        "value": "First, let's make a main.py Python file."
+      },
+      {
+        "name": "mouse-move-file-explorer",
+        "value": "1"
+      },
+      {
+        "name": "mouse-right-click",
+        "value": "1"
+      },
+      {
+        "name": "mouse-move-file-explorer-context-menu-new-file",
+        "value": "1"
+      },
+      {
+        "name": "mouse-left-click",
+        "value": "1"
+      },
+      {
+        "name": "file-explorer-type-new-file-input",
+        "value": "main.py"
+      },
+      {
+        "name": "file-explorer-enter-new-file-input",
+        "value": "1"
+      },
+      {
+        "name": "author-speak-before",
+        "value": "and let's print 'Hello world!' to the console."
+      },
+      {
+        "name": "editor-type",
+        "value": "print('Hello, world!')"
+      },
+      {
+        "name": "author-speak-before",
+        "value": "and if I wanted to write the value of some variable to the console, I could do that like so:"
+      },
+      {
+        "name": "editor-backspace",
+        "value": "22"
+      },
+      {
+        "name": "editor-type",
+        "value": "my_variable = 5"
+      },
+      {
+        "name": "editor-enter",
+        "value": "1"
+      },
+      {
+        "name": "editor-type",
+        "value": "print(my_variable)"
+      },
+      {
+        "name": "author-speak-before",
+        "value": "Now, when I run this code, I would expect the value of 'my_variable' to be printed to the console. Something like:"
+      },
+      {
+        "name": "editor-enter",
+        "value": "1"
+      },
+      {
+        "name": "editor-type",
+        "value": "# 5"
+      },
+      {
+        "name": "author-speak-before",
+        "value": "Console logging is simple, yet powerful and very useful!"
+      },
+      {
+        "name": "author-speak-before",
+        "value": "Well done, lets save our file."
+      },
+      {
+        "name": "editor-save",
+        "value": "main.py"
+      },
+      {
+        "name": "author-speak-before",
+        "value": "Saved!"
+      },
+      {
+        "name": "author-speak-before",
+        "value": "Oh... and I've just realized... this file looks a bit strange... let's add the python shebang to the top of the file."
+      },
+      {
+        "name": "editor-arrow-up",
+        "value": "4"
+      },
+      {
+        "name": "editor-command-left",
+        "value": "1"
+      },
+      {
+        "name": "editor-enter",
+        "value": "1"
+      },
+      {
+        "name": "editor-arrow-up",
+        "value": "1"
+      },
+      {
+        "name": "editor-type",
+        "value": "#!/usr/bin/env python"
+      },
+      {
+        "name": "editor-enter",
+        "value": "1"
+      },
+      {
+        "name": "author-speak-before",
+        "value": "Ah...much better!"
+      },
+      {
+        "name": "author-speak-before",
+        "value": "Let's save the file again."
+      },
+      {
+        "name": "editor-save",
+        "value": "main.py"
+      },
+      {
+        "name": "author-speak-before",
+        "value": "Saved!"
+      },
+      {
+        "name": "author-speak-before",
+        "value": "Now, let's open a terminal and run this file..."
+      },
+      {
+        "name": "terminal-open",
+        "value": "1"
+      },
+      {
+        "name": "terminal-type",
+        "value": "python main.py"
+      },
+      {
+        "name": "terminal-set-output",
+        "value": "5"
+      },
+      {
+        "name": "terminal-enter",
+        "value": "1"
+      },
+      {
+        "name": "author-speak-before",
+        "value": "Perfect, our code is working as expected! I hope you enjoyed this lesson!"
+      }
+    ]
+  }
+];
+var getExampleActionsArrayByKeyword = (keyword) => {
+  const exampleJSONs = [];
+  if (Array.isArray(keyword)) {
+    for (var i = 0; i < keyword.length; i++) {
+      const exampleJSON = getExampleActionsArrayByKeyword(keyword[i]);
+      exampleJSONs.push(exampleJSON);
+    }
+    return exampleJSONs.join(", ");
+  } else {
+    const exampleJSON = getSingleExampleActionsArray(keyword);
+    if (exampleJSON) {
+      return exampleJSON;
+    }
+  }
+  return "";
+};
+var getSingleExampleActionsArray = (keyword) => {
+  for (var i = 0; i < keywordsToExampleActionsMap.length; i++) {
+    const keywordMap = keywordsToExampleActionsMap[i];
+    if (keywordMap.keywords.includes(keyword)) {
+      return JSON.stringify(keywordMap.actions);
+    }
+  }
+  return "";
+};
+
+// src/resources/get_example_lessons_by_keyword.ts
+var 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	github.com/golang/protobuf v1.5.3 // indirect\n	github.com/google/go-querystring v1.1.0 // indirect\n	github.com/hashicorp/go-cleanhttp v0.5.2 // indirect\n	github.com/hashicorp/go-retryablehttp v0.7.7 // indirect\n	github.com/joho/godotenv v1.5.1\n	gitlab.com/gitlab-org/api/client-go v0.120.0\n	golang.org/x/net v0.8.0 // indirect\n	golang.org/x/oauth2 v0.24.0 // indirect\n	golang.org/x/time v0.8.0 // indirect\n	google.golang.org/appengine v1.6.7 // indirect\n	google.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
+
+import (
+	"encoding/json"
+	"fmt"
+	"io"
+	"log"
+	"net/http"
+	"net/url"
+	"strings"
+)
+
+// in the case of GET, the parameter queryParameters is transferred to the URL as query parameters
+// in the case of POST, the parameter body, an io.Reader, is used
+func MakeHTTPRequest(fullUrl string, httpMethod string, headers map[string]string, queryParameters url.Values, body io.Reader) ([]byte, error) {
+	client := http.Client{}
+	u, err := url.Parse(fullUrl)
+	if err != nil {
+		return nil, err
+	}
+
+	// if it's a GET, we need to append the query parameters.
+	if httpMethod == "GET" {
+		q := u.Query()
+
+		for k, v := range queryParameters {
+			// this depends on the type of api, you may need to do it for each of v
+			q.Set(k, strings.Join(v, ","))
+		}
+		// set the query to the encoded parameters
+		u.RawQuery = q.Encode()
+	}
+
+	// regardless of GET or POST, we can safely add the body
+	req, err := http.NewRequest(httpMethod, u.String(), body)
+	if err != nil {
+		return nil, err
+	}
+
+	// for each header passed, add the header value to the request
+	for k, v := range headers {
+		req.Header.Set(k, v)
+	}
+
+	// optional: log the request for easier stack tracing
+	log.Printf("%s %s\\n", httpMethod, req.URL.String())
+
+	// finally, do the request
+	res, err := client.Do(req)
+	if err != nil {
+		return nil, err
+	}
+
+	if res == nil {
+		return nil, fmt.Errorf("error: calling %s returned empty response", u.String())
+	}
+
+	responseData, err := io.ReadAll(res.Body)
+	if err != nil {
+		return nil, err
+	}
+
+	defer res.Body.Close()
+
+	if res.StatusCode != http.StatusOK {
+		return nil, fmt.Errorf("error calling %s:\\nstatus: %s\\nresponseData: %s", u.String(), res.Status, responseData)
+	}
+
+	return responseData, nil
+}
+
+func MakeHTTPRequestGeneric[T any](fullUrl string, httpMethod string, headers map[string]string, queryParameters url.Values, body io.Reader, responseType T) (T, error) {
+	client := http.Client{}
+	u, err := url.Parse(fullUrl)
+	if err != nil {
+		return responseType, err
+	}
+
+	// if it's a GET, we need to append the query parameters.
+	if httpMethod == "GET" {
+		q := u.Query()
+
+		for k, v := range queryParameters {
+			// this depends on the type of api, you may need to do it for each of v
+			q.Set(k, strings.Join(v, ","))
+		}
+		// set the query to the encoded parameters
+		u.RawQuery = q.Encode()
+	}
+
+	// regardless of GET or POST, we can safely add the body
+	req, err := http.NewRequest(httpMethod, u.String(), body)
+	if err != nil {
+		return responseType, err
+	}
+
+	// for each header passed, add the header value to the request
+	for k, v := range headers {
+		req.Header.Set(k, v)
+	}
+
+	// optional: log the request for easier stack tracing
+	log.Printf("%s %s\\n", httpMethod, req.URL.String())
+
+	// finally, do the request
+	res, err := client.Do(req)
+	if err != nil {
+		return responseType, err
+	}
+
+	if res == nil {
+		return responseType, fmt.Errorf("error: calling %s returned empty response", u.String())
+	}
+
+	responseData, err := io.ReadAll(res.Body)
+	if err != nil {
+		return responseType, err
+	}
+
+	defer res.Body.Close()
+
+	if res.StatusCode != http.StatusOK {
+		return responseType, fmt.Errorf("error calling %s:\\nstatus: %s\\nresponseData: %s", u.String(), res.Status, responseData)
+	}
+
+	var responseObject T
+	err = json.Unmarshal(responseData, &responseObject)
+
+	if err != nil {
+		log.Printf("error unmarshaling response: %+v", err)
+		return responseType, err
+	}
+
+	return responseObject, nil
+}
+`,
+                  "language": "Go",
+                  "caretPosition": {
+                    "row": 0,
+                    "col": 0
+                  }
+                }
+              }
+            },
+            "main.go": {
+              "type": "file",
+              "content": 'package main\n\nimport (\n	"bufio"\n	"fmt"\n	"log"\n	"os"\n	"sort"\n	"strings"\n	"time"\n\n	"github.com/joho/godotenv"\n	"solve.ch/solvers/http_helper"\n)\n\ntype ContributionStats struct {\n	Username       string\n	DailyCommits   int\n	WeeklyCommits  int\n	MonthlyCommits int\n	YearlyCommits  int\n	DailyMRs       int\n	WeeklyMRs      int\n	MonthlyMRs     int\n	YearlyMRs      int\n	// New field to store total pages fetched from GitLab\n	PagesFetched int\n}\n\ntype TimePeriod struct {\n	Start time.Time\n	End   time.Time\n}\n\ntype GitLabAuthor struct {\n	ID        int    `json:"id"`\n	Username  string `json:"username"`\n	Name      string `json:"name"`\n	State     string `json:"state"`\n	AvatarURL string `json:"avatar_url"`\n	WebURL    string `json:"web_url"`\n}\n\ntype GitLabPushData struct {\n	CommitCount int    `json:"commit_count"`\n	Action      string `json:"action"`\n	RefType     string `json:"ref_type"`\n	CommitFrom  string `json:"commit_from"`\n	CommitTo    string `json:"commit_to"`\n	Ref         string `json:"ref"`\n	CommitTitle string `json:"commit_title"`\n	RefCount    *int   `json:"ref_count"`\n}\n\ntype GitLabEvent struct {\n	ID          int             `json:"id"`\n	ProjectID   int             `json:"project_id"`\n	ActionName  string          `json:"action_name"`\n	TargetID    *int            `json:"target_id"`\n	TargetIID   *int            `json:"target_iid"`\n	TargetType  *string         `json:"target_type"`\n	AuthorID    int             `json:"author_id"`\n	TargetTitle *string         `json:"target_title"`\n	CreatedAt   time.Time       `json:"created_at"`\n	Author      GitLabAuthor    `json:"author"`\n	PushData    *GitLabPushData `json:"push_data"`\n}\n\nfunc main() {\n	// Load .env file\n	err := godotenv.Load()\n	if err != nil {\n		log.Println("Warning: Error loading .env file:", err)\n	}\n\n	// Replace with your GitLab token\n	token := os.Getenv("GITLAB_TOKEN")\n	if token == "" {\n		log.Fatal("GITLAB_TOKEN environment variable not set")\n	}\n\n	// Read usernames from file\n	usernames, err := readUsernames("usernames.txt")\n	if err != nil {\n		log.Fatalf("Failed to read usernames: %v", err)\n	}\n\n	// Get contribution stats for each user\n	stats := make([]ContributionStats, 0)\n	for _, username := range usernames {\n		stat, err := getContributionStats(token, username)\n		if err != nil {\n			log.Printf("Warning: Failed to get stats for %s: %v", username, err)\n			continue\n		}\n		stats = append(stats, stat)\n	}\n\n	// Sort by yearly commits (could be modified to use different metrics)\n	sort.Slice(stats, func(i, j int) bool {\n		return stats[i].YearlyCommits > stats[j].YearlyCommits\n	})\n\n	// Print results with normalized bars\n	printResults(stats)\n}\n\nfunc readUsernames(filename string) ([]string, error) {\n	file, err := os.Open(filename)\n	if err != nil {\n		return nil, err\n	}\n	defer file.Close()\n\n	var usernames []string\n	scanner := bufio.NewScanner(file)\n	for scanner.Scan() {\n		username := strings.TrimSpace(scanner.Text())\n		if username != "" {\n			usernames = append(usernames, username)\n		}\n	}\n	return usernames, scanner.Err()\n}\n\nfunc getContributionStats(token, username string) (ContributionStats, error) {\n	stats := ContributionStats{Username: username}\n\n	// Define time windows for daily, weekly, monthly, yearly\n	todayStart := time.Now().Truncate(24 * time.Hour)\n	todayEnd := todayStart.Add(24 * time.Hour)\n\n	// last 7 days (including today)\n	weekStart := todayStart.AddDate(0, 0, -6)\n	weekEnd := todayEnd\n\n	// last 1 month\n	monthStart := todayStart.AddDate(0, -1, 0)\n	monthEnd := todayEnd\n\n	// last 1 year\n	yearStart := todayStart.AddDate(-1, 0, 0)\n	yearEnd := todayEnd\n\n	periods := map[string]TimePeriod{\n		"daily": {\n			Start: todayStart,\n			End:   todayEnd,\n		},\n		"weekly": {\n			Start: weekStart,\n			End:   weekEnd,\n		},\n		"monthly": {\n			Start: monthStart,\n			End:   monthEnd,\n		},\n		"yearly": {\n			Start: yearStart,\n			End:   yearEnd,\n		},\n	}\n\n	// We\'ll track how many pages we fetched total for each user\n	totalPages := 0\n\n	// Get user\'s events for each time period\n	for period, timeRange := range periods {\n		commits, mrs, pages, err := GetUserActivity(token, username, timeRange.Start, timeRange.End)\n		if err != nil {\n			return stats, err\n		}\n		// Accumulate total page count\n		totalPages += pages\n\n		switch period {\n		case "daily":\n			stats.DailyCommits = commits\n			stats.DailyMRs = mrs\n		case "weekly":\n			stats.WeeklyCommits = commits\n			stats.WeeklyMRs = mrs\n		case "monthly":\n			stats.MonthlyCommits = commits\n			stats.MonthlyMRs = mrs\n		case "yearly":\n			stats.YearlyCommits = commits\n			stats.YearlyMRs = mrs\n		}\n	}\n\n	// Store the total pages fetched in stats\n	stats.PagesFetched = totalPages\n\n	return 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	baseURL := "https://git.solve.ch/api/v4/users"\n	// We will iterate over pages, so exclude &page from the base URL:\n	fullURL := fmt.Sprintf(\n		"%s/%s/events?after=%s&before=%s&per_page=100",\n		baseURL,\n		username,\n		start.Format("2006-01-02"),\n		end.Format("2006-01-02"),\n	)\n\n	headers := map[string]string{\n		"PRIVATE-TOKEN": token,\n	}\n\n	var allEvents []GitLabEvent\n	page := 1\n\n	for {\n		// Construct URL for the current page\n		pagedURL := fmt.Sprintf("%s&page=%d", fullURL, page)\n\n		var tempEvents []GitLabEvent\n		tempEvents, err = http_helper.MakeHTTPRequestGeneric(\n			pagedURL,\n			"GET",\n			headers,\n			nil,\n			nil,\n			tempEvents,\n		)\n		if err != nil {\n			return 0, 0, 0, fmt.Errorf("failed to get user events (page %d): %v", page, err)\n		}\n\n		// If no events, we\'ve reached the end\n		if len(tempEvents) == 0 {\n			break\n		}\n\n		// Accumulate events\n		allEvents = append(allEvents, tempEvents...)\n		page++\n	}\n\n	// The page - 1 is how many pages we actually fetched\n	totalPages = page - 1\n\n	// Count commits and MRs\n	for _, event := range allEvents {\n		switch {\n		case event.ActionName == "pushed to" || event.ActionName == "pushed new":\n			if event.PushData != nil {\n				commits += event.PushData.CommitCount\n			}\n		case event.ActionName == "accepted" && event.TargetType != nil && *event.TargetType == "MergeRequest":\n			mrs++\n		case event.ActionName == "opened" && event.TargetType != nil && *event.TargetType == "MergeRequest":\n			mrs++\n		default:\n			// TODO: define a \'miscellaneous\' category for other types of events\n			commits++\n		}\n	}\n\n	return commits, mrs, totalPages, nil\n}\n\nfunc printResults(stats []ContributionStats) {\n\n	// loop over stats to get the average number of commits per merge request\n	var totalMRs, totalCommits int\n	for _, stat := range stats {\n		totalMRs += stat.YearlyMRs\n		totalCommits += stat.YearlyCommits\n	}\n\n	averageCommitsPerMR := int(float64(totalCommits) / float64(totalMRs))\n\n	// Find maximum values for normalization\n	var maxDaily, maxWeekly, maxMonthly, maxYearly int\n	for _, stat := range stats {\n		maxDaily = max(maxDaily, stat.DailyCommits+(stat.DailyMRs*averageCommitsPerMR))\n		maxWeekly = max(maxWeekly, stat.WeeklyCommits+(stat.WeeklyMRs*averageCommitsPerMR))\n		maxMonthly = max(maxMonthly, stat.MonthlyCommits+(stat.MonthlyMRs*averageCommitsPerMR))\n		maxYearly = max(maxYearly, stat.YearlyCommits+(stat.YearlyMRs*averageCommitsPerMR))\n	}\n\n	var maxDailyCommits, maxWeeklyCommits, maxMonthlyCommits, maxYearlyCommits int\n	for _, stat := range stats {\n		maxDailyCommits = max(maxDailyCommits, stat.DailyCommits)\n		maxWeeklyCommits = max(maxWeeklyCommits, stat.WeeklyCommits)\n		maxMonthlyCommits = max(maxMonthlyCommits, stat.MonthlyCommits)\n		maxYearlyCommits = max(maxYearlyCommits, stat.YearlyCommits)\n	}\n\n	var maxDailyMRs, maxWeeklyMRs, maxMonthlyMRs, maxYearlyMRs int\n	for _, stat := range stats {\n		maxDailyMRs = max(maxDailyMRs, stat.DailyMRs)\n		maxWeeklyMRs = max(maxWeeklyMRs, stat.WeeklyMRs)\n		maxMonthlyMRs = max(maxMonthlyMRs, stat.MonthlyMRs)\n		maxYearlyMRs = max(maxYearlyMRs, stat.YearlyMRs)\n	}\n\n	// sort stats by scaled contributions (commts + scaled MRs)\n	sort.Slice(stats, func(i, j int) bool {\n		return (stats[i].YearlyCommits + stats[i].YearlyMRs*averageCommitsPerMR) > (stats[j].YearlyCommits + stats[j].YearlyMRs*averageCommitsPerMR)\n	})\n\n	fmt.Println("\\n\u{1F3C6} Top Contributors Overall\\n")\n	fmt.Printf("(MRs scaled by %dx, the global average commits per MR across Solve)\\n", averageCommitsPerMR)\n	fmt.Println("========================")\n\n	emojisByRank := []string{"\u{1F947}", "\u{1F948}", "\u{1F949}"}\n\n	for index, stat := range stats {\n		// Use the index to get the corresponding emoji - if we are less than three, use the list\n		emoji := "\u{1F468}\u200D\u{1F4BB}"\n		if index < len(emojisByRank) {\n			emoji = emojisByRank[index]\n		}\n		fmt.Printf("\\n%s %s\\n", emoji, stat.Username)\n		fmt.Printf("   (Fetched %d pages from GitLab)\\n", stat.PagesFetched)\n\n		// Print daily, weekly, monthly, yearly bars\n		printBar("Today    ", stat.DailyCommits+(stat.DailyMRs*averageCommitsPerMR), maxDaily)\n		printBar("Week     ", stat.WeeklyCommits+(stat.WeeklyMRs*averageCommitsPerMR), maxWeekly)\n		printBar("Month    ", stat.MonthlyCommits+(stat.MonthlyMRs*averageCommitsPerMR), maxMonthly)\n		printBar("Year     ", stat.YearlyCommits+(stat.YearlyMRs*averageCommitsPerMR), maxYearly)\n\n		fmt.Printf("Details: %d commits, %d MRs in the past year. Total Score: %d\\n",\n			stat.YearlyCommits, stat.YearlyMRs, stat.YearlyCommits+(stat.YearlyMRs*averageCommitsPerMR))\n	}\n\n	// sort stats by commits now\n	sort.Slice(stats, func(i, j int) bool {\n		return stats[i].YearlyCommits > stats[j].YearlyCommits\n	})\n\n	fmt.Println("\\n\u{1F3C6} Top Committers")\n	fmt.Println("========================")\n\n	for index, stat := range stats {\n		// Use the index to get the corresponding emoji - if we are less than three, use the list\n		emoji := "\u{1F468}\u200D\u{1F4BB}"\n		if index < len(emojisByRank) {\n			emoji = emojisByRank[index]\n		}\n		fmt.Printf("\\n%s %s\\n", emoji, stat.Username)\n		fmt.Printf("   (Fetched %d pages from GitLab)\\n", stat.PagesFetched)\n\n		// Print daily, weekly, monthly, yearly bars\n		printBar("Today    ", stat.DailyCommits, maxDailyCommits)\n		printBar("Week     ", stat.WeeklyCommits, maxWeeklyCommits)\n		printBar("Month    ", stat.MonthlyCommits, maxMonthlyCommits)\n		printBar("Year     ", stat.YearlyCommits, maxYearlyCommits)\n\n		fmt.Printf("Details: %d commits in the past year\\n",\n			stat.YearlyCommits)\n	}\n\n	// sort stats by MRs now\n	sort.Slice(stats, func(i, j int) bool {\n		return stats[i].YearlyMRs > stats[j].YearlyMRs\n	})\n\n	fmt.Println("\\n\u{1F3C6} Top Merge Requesters")\n	fmt.Println("========================")\n\n	for index, stat := range stats {\n		// Use the index to get the corresponding emoji - if we are less than three, use the list\n		emoji := "\u{1F468}\u200D\u{1F4BB}"\n		if index < len(emojisByRank) {\n			emoji = emojisByRank[index]\n		}\n		fmt.Printf("\\n%s %s\\n", emoji, stat.Username)\n		fmt.Printf("   (Fetched %d pages from GitLab)\\n", stat.PagesFetched)\n\n		// Print daily, weekly, monthly, yearly bars\n		printBar("Today    ", stat.DailyMRs, maxDailyMRs)\n		printBar("Week     ", stat.WeeklyMRs, maxWeeklyMRs)\n		printBar("Month    ", stat.MonthlyMRs, maxMonthlyMRs)\n		printBar("Year     ", stat.YearlyMRs, maxYearlyMRs)\n\n		fmt.Printf("Details: %d MRs in the past year\\n",\n			stat.YearlyMRs)\n	}\n}\n\nfunc printBar(label string, value, maxValue int) {\n	const barWidth = 30\n	var percentage float64\n	if maxValue > 0 {\n		percentage = float64(value) / float64(maxValue) * 100\n	}\n\n	filledWidth := int(float64(barWidth) * percentage / 100)\n	bar := strings.Repeat("\u2588", filledWidth) + strings.Repeat("\u2591", barWidth-filledWidth)\n\n	fmt.Printf("%s [%s] %.1f%% (%d)\\n", label, bar, percentage, value)\n}\n\nfunc max(a, b int) int {\n	if a > b {\n		return a\n	}\n	return b\n}\n',
+              "language": "Go",
+              "caretPosition": {
+                "row": 0,
+                "col": 0
+              }
+            },
+            "main_test.go": {
+              "type": "file",
+              "content": `package main
+
+import (
+	"log"
+	"os"
+	"testing"
+	"time"
+
+	"github.com/joho/godotenv"
+	"solve.ch/solvers/http_helper"
+)
+
+func TestGetUserActivity(t *testing.T) {
+	// Load .env file
+	err := godotenv.Load()
+	if err != nil {
+		log.Println("Warning: Error loading .env file:", err)
+	}
+
+	// Get GitLab token from environment
+	token := os.Getenv("GITLAB_TOKEN")
+	if token == "" {
+		t.Fatal("GITLAB_TOKEN environment variable not set")
+	}
+
+	// Set up time range for last 7 days
+	now := time.Now()
+	sevenDaysAgo := now.AddDate(0, 0, -7)
+
+	// Test GetUserActivity function
+	commits, mrs, err := GetUserActivity(token, "cfrewin", sevenDaysAgo, now)
+	if err != nil {
+		t.Fatalf("GetUserActivity failed: %v", err)
+	}
+
+	// Log the results
+	t.Logf("Activity for user 'cfrewin' in the last 7 days:")
+	t.Logf("Commits: %d", commits)
+	t.Logf("Merge Requests: %d", mrs)
+
+	// From the sample JSON, we can see several commits and MRs
+	// Let's add some basic assertions
+	if commits == 0 {
+		t.Log("Warning: No commits found in the last 7 days")
+	}
+	if mrs < 0 {
+		t.Error("Number of merge requests should not be negative")
+	}
+
+	// Add detailed logging of commits by looking at the raw response
+	responseData, err := http_helper.MakeHTTPRequest(
+		"https://git.solve.ch/api/v4/users/cfrewin/events",
+		"GET",
+		map[string]string{"PRIVATE-TOKEN": token},
+		nil,
+		nil,
+	)
+	if err != nil {
+		t.Logf("Failed to get raw events: %v", err)
+	} else {
+		t.Logf("Raw response: %s", string(responseData))
+	}
+}
+`,
+              "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
+              }
             }
-        ]
-    },
-    {
-        keywords: ["python", "python console log", "python log"],
-        actions: [
-            {
-                "name": "author-speak-before",
-                "value": "Let's learn how to use the print function in Python!"
-            },
-            {
-                "name": "author-speak-before",
-                "value": "First, let's make a main.py Python file."
-            },
-            {
-                "name": "mouse-move-file-explorer",
-                "value": "1"
-            },
-            {
-                "name": "mouse-right-click",
-                "value": "1"
-            },
-            {
-                "name": "mouse-move-file-explorer-context-menu-new-file",
-                "value": "1"
-            },
-            {
-                "name": "mouse-left-click",
-                "value": "1"
-            },
-            {
-                "name": "file-explorer-type-new-file-input",
-                "value": "main.py"
-            },
-            {
-                "name": "file-explorer-enter-new-file-input",
-                "value": "1"
-            },
-            {
-                "name": "author-speak-before",
-                "value": "and let's print 'Hello world!' to the console."
-            },
-            {
-                "name": "editor-type",
-                "value": "print('Hello, world!')"
-            },
-            {
-                "name": "author-speak-before",
-                "value": "and if I wanted to write the value of some variable to the console, I could do that like so:"
-            },
-            {
-                "name": "editor-backspace",
-                "value": "22"
-            },
-            {
-                "name": "editor-type",
-                "value": "my_variable = 5"
-            },
-            {
-                "name": "editor-enter",
-                "value": "1"
-            },
-            {
-                "name": "editor-type",
-                "value": "print(my_variable)"
-            },
-            {
-                "name": "author-speak-before",
-                "value": "Now, when I run this code, I would expect the value of 'my_variable' to be printed to the console. Something like:"
-            },
-            {
-                "name": "editor-enter",
-                "value": "1"
-            },
-            {
-                "name": "editor-type",
-                "value": "# 5"
-            },
-            {
-                "name": "author-speak-before",
-                "value": "Console logging is simple, yet powerful and very useful!"
-            },
-            {
-                "name": "author-speak-before",
-                "value": "Well done, lets save our file."
-            },
-            {
-                "name": "editor-save",
-                "value": "main.py"
-            },
-            {
-                "name": "author-speak-before",
-                "value": "Saved!"
-            },
-            {
-                "name": "author-speak-before",
-                "value": "Oh... and I've just realized... this file looks a bit strange... let's add the python shebang to the top of the file."
-            },
-            {
-                "name": "editor-arrow-up",
-                "value": "4"
-            },
-            {
-                "name": "editor-command-left",
-                "value": "1"
-            },
-            {
-                "name": "editor-enter",
-                "value": "1"
-            },
-            {
-                "name": "editor-arrow-up",
-                "value": "1"
-            },
-            {
-                "name": "editor-type",
-                "value": "#!/usr/bin/env python"
-            },
-            {
-                "name": "editor-enter",
-                "value": "1"
-            },
-            {
-                "name": "author-speak-before",
-                "value": "Ah...much better!"
-            },
-            {
-                "name": "author-speak-before",
-                "value": "Let's save the file again."
-            },
-            {
-                "name": "editor-save",
-                "value": "main.py"
-            },
-            {
-                "name": "author-speak-before",
-                "value": "Saved!"
-            },
-            {
-                "name": "author-speak-before",
-                "value": "Now, let's open a terminal and run this file..."
-            },
-            {
-                "name": "terminal-open",
-                "value": "1"
-            },
-            {
-                "name": "terminal-type",
-                "value": "python main.py"
-            },
-            {
-                "name": "terminal-set-output",
-                "value": "5"
-            },
-            {
-                "name": "terminal-enter",
-                "value": "1"
-            },
+          }
+        },
+        "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": [
             {
-                "name": "author-speak-before",
-                "value": "Perfect, our code is working as expected! I hope you enjoyed this lesson!"
+              "currentSpeechCaption": ""
             }
-        ]
-    },
-];
-// 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 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]);
-            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;
-        }
+  }
+];
+var getExampleLessonByKeyword = (keyword) => {
+  const exampleJSONs = [];
+  if (Array.isArray(keyword)) {
+    for (var i = 0; i < keyword.length; i++) {
+      const exampleJSON = getExampleLessonByKeyword(keyword[i]);
+      exampleJSONs.push(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 < keywordsToExampleMap.length; i++) {
-        const keywordMap = keywordsToExampleMap[i];
-        if (keywordMap.keywords.includes(keyword)) {
-            return JSON.stringify(keywordMap.actions);
-        }
+    return exampleJSONs.join(", ");
+  } else {
+    const exampleJSON = getSingleExampleLesson(keyword);
+    if (exampleJSON) {
+      return exampleJSON;
+    }
+  }
+  return "";
+};
+var getSingleExampleLesson = (keyword) => {
+  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 "";
+  }
+  return "";
 };
 
-// Load environment variables from .env file
+// src/index.ts
 dotenv.config();
-const ActionSchema = z.object({
-    name: z.string(),
-    value: z.string()
+var ActionSchema = z2.object({
+  name: z2.string(),
+  value: z2.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
+var validActionNames = new Set(AllActionStrings);
+var StrictActionSchema = z2.object({
+  name: z2.string().refine((name) => validActionNames.has(name), "unknown CodeVideo action name"),
+  value: z2.string().min(1, "action 'value' must not be empty")
+}).refine(
+  (a) => !isRepeatableAction2(a) || /^[0-9]+$/.test(a.value),
+  { message: 'repeatable actions require a positive integer string value (usually "1")' }
+);
+var CourseSnapshotSchema = z2.custom((value) => {
+  if (!value || typeof value !== "object") return false;
+  const snapshot = value;
+  return typeof snapshot.isUnsavedChangesDialogOpen === "boolean" && typeof snapshot.unsavedFileName === "string" && !!snapshot.fileExplorerSnapshot && !!snapshot.editorSnapshot && !!snapshot.terminalSnapshot && !!snapshot.mouseSnapshot && !!snapshot.authorSnapshot;
+}, "Invalid CodeVideo course snapshot");
+var LessonSchema = z2.object({
+  id: z2.string(),
+  name: z2.string(),
+  description: z2.string(),
+  actions: z2.array(ActionSchema),
+  initialSnapshot: CourseSnapshotSchema,
+  finalSnapshot: CourseSnapshotSchema
+});
+var CourseSchema = z2.object({
+  id: z2.string(),
+  name: z2.string(),
+  description: z2.string(),
+  primaryLanguage: z2.string(),
+  lessons: z2.array(LessonSchema)
 });
-const CourseSchema = z.object({
-    id: z.string(),
-    name: z.string(),
-    description: z.string(),
-    primaryLanguage: z.string(),
-    lessons: z.array(LessonSchema)
+var RenderOptionsParam = RenderOptionsSchema.optional().describe("Render options: orientation, IDE layout (theme, font size, which panes and the cursor are visible), pacing, voice and render mode.");
+var openParam = (whenOmitted) => z2.boolean().optional().describe(`Open the finished video in the default player. Defaults to ${whenOmitted}.`);
+var QUEUED_MESSAGE = "Queued. It renders in the background, even if this client closes; check it with codevideo_get_render_job.";
+var jobReply = (result) => ({
+  content: [{
+    type: "text",
+    text: JSON.stringify({ ...describeJob(result.job), estimatedSeconds: result.estimatedSeconds, message: QUEUED_MESSAGE }, null, 2)
+  }]
 });
-const server = new McpServer({
+var errorReply = (prefix, error) => ({
+  isError: true,
+  content: [{ type: "text", text: `${prefix}: ${error instanceof Error ? error.message : String(error)}` }]
+});
+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
+    version
+  });
+  setupMcpServerTools(server);
+  return server;
+}
+function setupMcpServerTools(server) {
+  const tool = server.tool.bind(server);
+  tool(
+    "codevideo_instructions_to_create_a_course",
+    {
+      additionalContext: z2.string()
+    },
+    async ({ additionalContext }) => {
+      return {
+        content: [{
+          type: "text",
+          text: instructionsToCreateACourse(additionalContext)
+        }]
+      };
     }
-});
-// 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)
-            }
+  );
+  tool(
+    "codevideo_instructions_to_create_lesson_actions",
+    {
+      additionalContext: z2.string()
+    },
+    async ({ additionalContext }) => {
+      return {
+        content: [{
+          type: "text",
+          text: instructionsToCreateLessonActions(additionalContext)
         }]
-    })
-);
-
-// add resources
-server.resource(
-    "codevideo_get_action_names",
-    "codevideo_get_action_names://codevideo_get_action_names",
-    (uri) => ({
-        contents: [{
-            uri: uri.href,
-            text: getActionNames()
+      };
+    }
+  );
+  tool(
+    "codevideo_instructions_to_create_lesson_video",
+    {
+      additionalContext: z2.string()
+    },
+    async ({ additionalContext }) => {
+      return {
+        content: [{
+          type: "text",
+          text: instructionsToCreateLessonVideo(additionalContext)
         }]
-    })
-);
-
-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)
+      };
+    }
+  );
+  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: z2.array(ActionSchema).optional().describe("Array of CodeVideo actions to translate. Optional if actions were previously stored with codevideo_set_current_actions"),
+      targetLanguage: z2.string().describe("Target language for translation (e.g., 'Spanish', 'French', 'German')")
+    },
+    async ({ actionsToTranslation, targetLanguage }) => {
+      const typedActions = actionsToTranslation;
+      return {
+        content: [{
+          type: "text",
+          text: instructionsToTranslateActions(typedActions, targetLanguage)
         }]
-    })
-);
-*/
-server.tool("codevideo_instructions_to_create_a_course", {
-    additionalContext: z.string()
-}, async ({ additionalContext }) => {
-    return {
+      };
+    }
+  );
+  tool(
+    "codevideo_get_empty_lesson_snapshot",
+    {},
+    async () => {
+      return {
         content: [{
-                type: "text",
-                text: instructionsToCreateACourse(additionalContext)
-            }]
-    };
-});
-server.tool("codevideo_instructions_to_create_lesson_actions", {
-    additionalContext: z.string()
-}, async ({ additionalContext }) => {
-    return {
+          type: "text",
+          text: getEmptyLessonSnapshot()
+        }]
+      };
+    }
+  );
+  tool(
+    "codevideo_create_course_with_initial_metadata",
+    {
+      id: z2.string(),
+      name: z2.string(),
+      description: z2.string(),
+      primaryLanguage: z2.string()
+    },
+    async ({ id, name, description, primaryLanguage }) => {
+      return {
         content: [{
-                type: "text",
-                text: instructionsToCreateLessonActions(additionalContext)
-            }]
-    };
-});
-server.tool("codevideo_instructions_to_create_lesson_video", {
-    additionalContext: z.string()
-}, async ({ additionalContext }) => {
-    return {
+          type: "text",
+          text: createCourseWithInitialMetadata(id, name, description, primaryLanguage)
+        }]
+      };
+    }
+  );
+  tool(
+    "codevideo_add_actions_to_lesson",
+    {
+      lesson: LessonSchema,
+      actions: z2.array(ActionSchema)
+    },
+    async ({ lesson, actions }) => {
+      const typedLesson = lesson;
+      const typedActions = actions;
+      return {
         content: [{
-                type: "text",
-                text: instructionsToCreateLessonVideo(additionalContext)
-            }]
-    };
-});
-server.tool("codevideo_get_empty_lesson_snapshot", {}, async () => {
-    return {
+          type: "text",
+          text: addActionsToLesson(typedLesson, typedActions)
+        }]
+      };
+    }
+  );
+  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: z2.array(ActionSchema).optional().describe("Array of CodeVideo actions to apply. Optional if actions were previously stored with codevideo_set_current_actions")
+    },
+    async ({ actions }) => {
+      const typedActions = actions;
+      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 {
+          type: "text",
+          text: getFinalLessonSnapshot(typedActions)
+        }]
+      };
+    }
+  );
+  tool(
+    "codevideo_add_lesson_to_course",
+    {
+      course: CourseSchema,
+      id: z2.string(),
+      name: z2.string(),
+      description: z2.string()
+    },
+    async ({ course, id, name, description }) => {
+      const typedCourse = course;
+      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 {
+          type: "text",
+          text: addLessonToCourse(typedCourse, id, name, description)
+        }]
+      };
+    }
+  );
+  tool(
+    "codevideo_get_action_names",
+    "Every CodeVideo action, one per line: what it does and what its value takes. Check the rows for the actions you plan to use.",
+    {},
+    async () => {
+      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 {
+          type: "text",
+          text: getActionNames()
+        }]
+      };
+    }
+  );
+  tool(
+    "codevideo_get_example_actions_array_by_keyword",
+    {
+      keyword: z2.string()
+    },
+    async ({ keyword }) => {
+      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 {
+          type: "text",
+          text: getExampleActionsArrayByKeyword(keyword)
+        }]
+      };
+    }
+  );
+  tool(
+    "codevideo_get_example_lesson_by_keyword",
+    {
+      keyword: z2.string()
+    },
+    async ({ keyword }) => {
+      return {
         content: [{
-                type: "text",
-                text: addLessonToCourse(typedCourse, id, name, description)
-            }]
-    };
-});
-server.tool("codevideo_get_action_names", {}, async () => {
-    return {
+          type: "text",
+          text: getExampleLessonByKeyword(keyword)
+        }]
+      };
+    }
+  );
+  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: z2.string().describe("Local file system path to the repository/codebase directory")
+    },
+    async ({ repoLocation }) => {
+      return {
         content: [{
-                type: "text",
-                text: getActionNames()
-            }]
-    };
-});
-server.tool("codevideo_get_example_lesson", {
-    keyword: z.string()
-}, async ({ keyword }) => {
-    return {
+          type: "text",
+          text: await getInitialLessonStateFromLocalCodebase(repoLocation)
+        }]
+      };
+    }
+  );
+  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: z2.string().describe("GitHub repository URL (e.g., https://github.com/user/repo)")
+    },
+    async ({ repoUrl }) => {
+      return {
         content: [{
-                type: "text",
-                text: getExampleLesson(keyword)
-            }]
-    };
-});
-server.tool("codevideo_get_initial_lesson_state_from_local_repo", {
-    repoLocation: z.string()
-}, async ({ repoLocation }) => {
-    return {
+          type: "text",
+          text: await getInitialLessonStateFromGitHubRepo(repoUrl)
+        }]
+      };
+    }
+  );
+  tool(
+    "codevideo_make_markdown_from_actions",
+    "Generate a markdown blog post from CodeVideo actions array. Pass actions array OR use previously stored actions from codevideo_set_current_actions (recommended workflow).",
+    {
+      actions: z2.array(ActionSchema).optional().describe("Array of CodeVideo actions. Optional if actions were previously stored with codevideo_set_current_actions")
+    },
+    async ({ actions }) => {
+      const typedActions = actions;
+      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 {
+          type: "text",
+          text: makeMarkdownFromActions(typedActions)
+        }]
+      };
+    }
+  );
+  tool(
+    "codevideo_make_markdown_from_lesson",
+    "Generate a markdown blog post from a complete lesson object. Pass a lesson object OR use previously stored lesson from lesson management tools. This extracts the actions from the lesson and generates markdown.",
+    {
+      lesson: LessonSchema.optional().describe("Complete lesson object. Optional if lesson was previously stored with lesson management tools")
+    },
+    async ({ lesson }) => {
+      const typedLesson = lesson;
+      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 {
+          type: "text",
+          text: makeMarkdownFromLesson(typedLesson)
+        }]
+      };
+    }
+  );
+  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: z2.array(ActionSchema).optional().describe("Array of CodeVideo actions. Optional if actions were previously stored with codevideo_set_current_actions")
+    },
+    async ({ actions }) => {
+      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);
-        return {
-            content: [{
-                    type: "text",
-                    text: JSON.stringify({
-                        outputPath: result.outputPath,
-                        stdout: result.stdout,
-                        stderr: result.stderr
-                    }, null, 2)
-                }]
-        };
+          type: "text",
+          text: await makeHTMLWebPage(typedActions)
+        }]
+      };
     }
-    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)}`
-                }]
-        };
+  );
+  tool(
+    "codevideo_make_video_from_actions",
+    "Render a video from CodeVideo actions: pass actions, or omit them to use the ones stored with codevideo_set_current_actions. Queues a background render job and returns its jobId at once; follow it with codevideo_get_render_job.",
+    {
+      actions: z2.array(ActionSchema).optional().describe("Array of CodeVideo actions. Optional if actions were previously stored with codevideo_set_current_actions"),
+      options: RenderOptionsParam,
+      open: openParam(true)
+    },
+    async ({ actions, options, open }) => {
+      try {
+        return jobReply(queueVideoFromActions(actions, options ?? {}, open ?? true));
+      } catch (error) {
+        return errorReply("Couldn't queue the video", error);
+      }
     }
-});
-server.tool("codevideo_validate_actions", {
-    actions: z.array(ActionSchema).optional()
-}, async ({ actions }) => {
-    // Cast the actions to IAction if provided
-    const typedActions = actions;
-    return {
+  );
+  tool(
+    "codevideo_make_video_from_lesson",
+    "Render a video from a complete lesson object: pass the lesson, or omit it to use the one stored with codevideo_set_current_lesson. Queues a background render job and returns its jobId at once; follow it with codevideo_get_render_job. For lessons in a stored course, use codevideo_render_lesson_video instead.",
+    {
+      lesson: LessonSchema.optional().describe("Complete lesson object with snapshots. Optional if lesson was previously stored with lesson management tools"),
+      options: RenderOptionsParam,
+      open: openParam(true)
+    },
+    async ({ lesson, options, open }) => {
+      try {
+        return jobReply(queueVideoFromLesson(lesson, options ?? {}, open ?? true));
+      } catch (error) {
+        return errorReply("Couldn't queue the video", error);
+      }
+    }
+  );
+  tool(
+    "codevideo_validate_actions",
+    "Checks a list of actions: unknown names, values of the wrong kind, and actions lessons can't use, each with what to do instead.",
+    {
+      actions: z2.array(ActionSchema).optional()
+    },
+    async ({ actions }) => {
+      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 {
+          type: "text",
+          text: validateActions(typedActions)
+        }]
+      };
+    }
+  );
+  tool(
+    "codevideo_is_repeatable_action",
+    {
+      action: ActionSchema
+    },
+    async ({ action }) => {
+      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 {
+          type: "text",
+          text: isRepeatable(typedAction)
+        }]
+      };
+    }
+  );
+  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: z2.string().describe("Path to the video file to critique"),
+      actions: z2.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 }) => {
+      const typedActions = actions;
+      try {
         const critique = await critiqueVideoUsingGemini(videoPath, typedActions);
         return {
-            content: [{
-                    type: "text",
-                    text: critique
-                }]
+          content: [{
+            type: "text",
+            text: critique
+          }]
         };
-    }
-    catch (error) {
+      } 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}`
-                }]
+          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 {
+  );
+  tool(
+    "codevideo_set_current_actions",
+    "Legacy single-slot store: keep one actions array for later tool calls, so they can run without re-sending it. Every conversation shares this one slot. For courses or several lessons, use codevideo_create_course and the course tools, which keep work apart by id.",
+    {
+      actions: z2.array(ActionSchema).describe("Array of CodeVideo actions to store for later use")
+    },
+    async ({ actions }) => {
+      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) {
+          type: "text",
+          text: setCurrentActions(typedActions)
+        }]
+      };
+    }
+  );
+  tool(
+    "codevideo_get_current_actions",
+    "Legacy single-slot store: read back the actions stored with codevideo_set_current_actions (shared by every conversation).",
+    {},
+    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."
-                }]
+          content: [{
+            type: "text",
+            text: "No actions found in storage. Use codevideo_set_current_actions first to store actions."
+          }]
         };
+      }
+      return {
+        content: [{
+          type: "text",
+          text: JSON.stringify(actions, null, 2)
+        }]
+      };
     }
-    return {
+  );
+  tool(
+    "codevideo_set_current_lesson",
+    "Legacy single-slot store: keep one lesson object for later tool calls, so they can run without re-sending it. Every conversation shares this one slot. For courses or several lessons, use codevideo_create_course and the course tools, which keep work apart by id.",
+    {
+      lesson: LessonSchema.describe("Complete lesson object to store for later use")
+    },
+    async ({ lesson }) => {
+      const typedLesson = lesson;
+      return {
         content: [{
-                type: "text",
-                text: JSON.stringify(actions, null, 2)
-            }]
-    };
-});
-// start the server
-const transport = new StdioServerTransport();
-(async () => {
+          type: "text",
+          text: setCurrentLesson(typedLesson)
+        }]
+      };
+    }
+  );
+  tool(
+    "codevideo_get_current_lesson",
+    "Legacy single-slot store: read back the lesson stored with codevideo_set_current_lesson (shared by every conversation).",
+    {},
+    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)
+        }]
+      };
+    }
+  );
+  tool(
+    "codevideo_instructions_to_build_course_from_scratch",
+    "Get step-by-step instructions for building a COMPLETE multi-lesson 'build from scratch' course with the course-store tools (snapshots stay server-side). Use this before authoring a full course.",
+    { additionalContext: z2.string().describe("What the course should teach / build") },
+    async ({ additionalContext }) => ({
+      content: [{ type: "text", text: instructionsToBuildCourseFromScratch(additionalContext) }]
+    })
+  );
+  tool(
+    "codevideo_create_course",
+    "Create a new course (server-side, returns a courseId). Snapshots and lesson state live in the MCP, not in your context.",
+    {
+      name: z2.string(),
+      description: z2.string().optional(),
+      primaryLanguage: z2.string().optional(),
+      id: z2.string().optional()
+    },
+    async ({ name, description, primaryLanguage, id }) => ({
+      content: [{ type: "text", text: createCourseTool({ name, description, primaryLanguage, id }) }]
+    })
+  );
+  tool(
+    "codevideo_add_lesson",
+    "Add a lesson to a course. By default it continues from the previous lesson's final state (chained server-side). Set mustCompile:false for slideshow/discussion/half-refactor lessons. The reply includes the previous lesson's name and description, for the recap that opens this lesson.",
+    {
+      courseId: z2.string(),
+      name: z2.string(),
+      description: z2.string().min(1, "describe the lesson in one sentence; the next lesson's recap is written from it"),
+      mustCompile: z2.boolean().optional(),
+      continuesFromPrevious: z2.boolean().optional()
+    },
+    async ({ courseId, name, description, mustCompile, continuesFromPrevious }) => ({
+      content: [{ type: "text", text: addLessonTool(courseId, { name, description, mustCompile, continuesFromPrevious }) }]
+    })
+  );
+  tool(
+    "codevideo_set_lesson_actions",
+    "Store a lesson's actions, replacing any it had. The server recomputes the lesson's final snapshot and re-chains following lessons. Returns only a small ack (no snapshot). To change part of a lesson later, use codevideo_edit_lesson_actions instead of sending every action again.",
+    {
+      courseId: z2.string(),
+      lessonId: z2.string(),
+      actions: z2.array(StrictActionSchema)
+    },
+    async ({ courseId, lessonId, actions }) => {
+      try {
+        return { content: [{ type: "text", text: setLessonActionsTool(courseId, lessonId, actions) }] };
+      } catch (error) {
+        return errorReply("Couldn't store the actions", error);
+      }
+    }
+  );
+  tool(
+    "codevideo_edit_lesson_actions",
+    "Change part of a lesson without re-sending it: each edit removes deleteCount actions at start and inserts the given ones there, like Array.splice. Edits apply in order (each start refers to the actions as the previous edits left them), all or nothing, with one snapshot recompute. Use codevideo_get_lesson_actions to find indices.",
+    {
+      courseId: z2.string(),
+      lessonId: z2.string(),
+      edits: z2.array(z2.object({
+        start: z2.number().int().min(0).describe("Index of the first action to change"),
+        deleteCount: z2.number().int().min(0).describe("How many actions to remove at start (0 to only insert)"),
+        insert: z2.array(StrictActionSchema).default([]).describe("Actions to insert at start")
+      })).min(1)
+    },
+    async ({ courseId, lessonId, edits }) => {
+      try {
+        return { content: [{ type: "text", text: editLessonActionsTool(courseId, lessonId, edits) }] };
+      } catch (error) {
+        return errorReply("Couldn't apply the edits", error);
+      }
+    }
+  );
+  tool(
+    "codevideo_get_lesson_actions",
+    "Read part of a lesson's actions with their indices (default: the first 50), e.g. to find what to change with codevideo_edit_lesson_actions.",
+    {
+      courseId: z2.string(),
+      lessonId: z2.string(),
+      start: z2.number().int().min(0).optional(),
+      limit: z2.number().int().min(1).max(500).optional()
+    },
+    async ({ courseId, lessonId, start, limit }) => ({
+      content: [{ type: "text", text: getLessonActionsTool(courseId, lessonId, start, limit) }]
+    })
+  );
+  tool(
+    "codevideo_get_lesson_file_tree",
+    "List the file paths present at the END of a lesson (cheap; no file contents, no snapshot).",
+    { courseId: z2.string(), lessonId: z2.string() },
+    async ({ courseId, lessonId }) => ({
+      content: [{ type: "text", text: getLessonFileTreeTool(courseId, lessonId) }]
+    })
+  );
+  tool(
+    "codevideo_get_lesson_file",
+    "Get the contents of ONE file at the END of a lesson (cheap targeted read instead of dumping the whole snapshot).",
+    { courseId: z2.string(), lessonId: z2.string(), path: z2.string() },
+    async ({ courseId, lessonId, path: path9 }) => ({
+      content: [{ type: "text", text: getLessonFileTool(courseId, lessonId, path9) }]
+    })
+  );
+  tool(
+    "codevideo_compile_lesson",
+    "Compile the code at the end of a lesson and return only the structured errors. Use this to check a lesson builds before moving on.",
+    { courseId: z2.string(), lessonId: z2.string() },
+    async ({ courseId, lessonId }) => ({
+      content: [{ type: "text", text: await compileLessonTool(courseId, lessonId) }]
+    })
+  );
+  tool(
+    "codevideo_validate_course",
+    "Validate the whole course: per-lesson action validity, snapshot continuity, and compilation (for mustCompile lessons + the final lesson). Returns done:true when the course is complete.",
+    { courseId: z2.string() },
+    async ({ courseId }) => ({
+      content: [{ type: "text", text: await validateCourseTool(courseId) }]
+    })
+  );
+  tool(
+    "codevideo_get_course_status",
+    "Resumable checkpoint view of a course: lessons, action counts, estimated video length per lesson, flags \u2014 without pulling any snapshot.",
+    { courseId: z2.string() },
+    async ({ courseId }) => ({
+      content: [{ type: "text", text: getCourseStatusTool(courseId) }]
+    })
+  );
+  tool(
+    "codevideo_export_course",
+    "Export the full course (ICourse with snapshots) to a JSON file under ~/.codevideo/exports and return its path. The course itself isn't returned, so it doesn't fill your context.",
+    { courseId: z2.string() },
+    async ({ courseId }) => ({
+      content: [{ type: "text", text: exportCourseTool(courseId) }]
+    })
+  );
+  tool(
+    "codevideo_generate_lesson_preview",
+    "Generate a server-side HTML preview of a single lesson (open in a browser to eyeball it). Cheap; no video.",
+    { courseId: z2.string(), lessonId: z2.string() },
+    async ({ courseId, lessonId }) => ({
+      content: [{ type: "text", text: await generateLessonPreviewTool(courseId, lessonId) }]
+    })
+  );
+  tool(
+    "codevideo_generate_course_previews",
+    "Generate HTML previews for every lesson \u2014 GATED: only works once codevideo_validate_course returns done. Use for human review before rendering video.",
+    { courseId: z2.string() },
+    async ({ courseId }) => ({
+      content: [{ type: "text", text: await generateCoursePreviewsTool(courseId) }]
+    })
+  );
+  tool(
+    "codevideo_render_lesson_video",
+    "Render ONE lesson of a stored course to video: queues a background render job and returns its jobId. GATED: refuses until codevideo_validate_course returns done.",
+    { courseId: z2.string(), lessonId: z2.string(), options: RenderOptionsParam, open: openParam(true) },
+    async ({ courseId, lessonId, options, open }) => {
+      try {
+        return { content: [{ type: "text", text: await renderLessonVideoTool(courseId, lessonId, options ?? {}, open ?? true) }] };
+      } catch (error) {
+        return errorReply("Couldn't queue the video", error);
+      }
+    }
+  );
+  tool(
+    "codevideo_render_course_videos",
+    "Render every lesson of a stored course to video: queues one background render job per lesson, run one at a time in lesson order. GATED: refuses until codevideo_validate_course returns done. Run only after a human approves the previews.",
+    { courseId: z2.string(), options: RenderOptionsParam, open: openParam(false) },
+    async ({ courseId, options, open }) => {
+      try {
+        return { content: [{ type: "text", text: await renderCourseVideosTool(courseId, options ?? {}, open ?? false) }] };
+      } catch (error) {
+        return errorReply("Couldn't queue the videos", error);
+      }
+    }
+  );
+  tool(
+    "codevideo_get_render_job",
+    "Status of one render job: queued (with how many jobs are ahead), running (with the latest progress line), succeeded (the video exists at outputPath), failed (with the CLI's error), cancelled or interrupted. Includes the last lines of the CLI's log.",
+    { jobId: z2.string() },
+    async ({ jobId }) => {
+      const job = describeJobById(jobId, true);
+      return job ? { content: [{ type: "text", text: JSON.stringify(job, null, 2) }] } : { isError: true, content: [{ type: "text", text: `No render job ${jobId}.` }] };
+    }
+  );
+  tool(
+    "codevideo_list_render_jobs",
+    "Recent render jobs, newest first (default 20), optionally for one course or in one status.",
+    {
+      courseId: z2.string().optional(),
+      status: z2.enum(["queued", "running", "succeeded", "failed", "cancelled", "interrupted"]).optional(),
+      limit: z2.number().int().min(1).max(100).optional()
+    },
+    async ({ courseId, status, limit }) => ({
+      content: [{ type: "text", text: JSON.stringify(listJobs({ courseId, status, limit }).map((job) => describeJob(job)), null, 2) }]
+    })
+  );
+  tool(
+    "codevideo_cancel_render_job",
+    "Cancel one render job, or every unfinished render job of a course. Queued jobs are dropped; a running one is stopped along with its browser.",
+    { jobId: z2.string().optional(), courseId: z2.string().optional() },
+    async ({ jobId, courseId }) => {
+      if (!jobId === !courseId) {
+        return { isError: true, content: [{ type: "text", text: "Pass exactly one of jobId or courseId." }] };
+      }
+      const { cancelled, stopping } = requestCancel({ jobId, courseId });
+      return {
+        content: [{
+          type: "text",
+          text: JSON.stringify({ cancelled, stopping, message: stopping > 0 ? "Stopping the running job; it shows as cancelled within a few seconds." : "Done." }, null, 2)
+        }]
+      };
+    }
+  );
+}
+var invokedPath = process.argv[1];
+var isDirectExecution = invokedPath !== void 0 && fs9.realpathSync(fileURLToPath(import.meta.url)) === fs9.realpathSync(invokedPath);
+if (isDirectExecution && process.argv.includes("--render-worker")) {
+  runWorker().then(
+    () => process.exit(0),
+    (error) => {
+      console.error(error);
+      process.exit(1);
+    }
+  );
+} else if (isDirectExecution) {
+  const server = createMcpServer();
+  const transport = new StdioServerTransport();
+  (async () => {
     await server.connect(transport);
-})();
+  })();
+}
+export {
+  createMcpServer
+};
+//# sourceMappingURL=index.js.map