learngraph 0.5.0 → 0.7.0

package/dist/cjs/llm/adapters/openai.js

@@ -2,12 +2,90 @@
 /**
  * OpenAI adapter for LLM integration
  *
+ * Supports all OpenAI models including GPT-5, o3, and GPT-4.1 families.
+ *
  * @packageDocumentation
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.OpenAIAdapter = void 0;
+exports.OpenAIAdapter = exports.OPENAI_MODELS = exports.GPT_4_LEGACY_MODELS = exports.GPT_4O_MODELS = exports.GPT_4_1_MODELS = exports.O_SERIES_MODELS = exports.GPT_5_MODELS = void 0;
+exports.resolveOpenAIModel = resolveOpenAIModel;
 exports.createOpenAIAdapter = createOpenAIAdapter;
+exports.listOpenAIModels = listOpenAIModels;
 const base_js_1 = require("./base.js");
+// ─────────────────────────────────────────────────────────────────────────────
+// OpenAI Model Registry
+// Models are updated frequently - use any valid model ID string.
+// These constants are provided for convenience but you can use any model.
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * GPT-5 Models (Latest - 2025)
+ * - gpt-5: Flagship model for general-purpose and agentic use
+ * - gpt-5-mini: Smaller, faster version
+ * - gpt-5-nano: Smallest, most cost-effective
+ */
+exports.GPT_5_MODELS = {
+    'gpt-5': 'gpt-5',
+    'gpt-5-mini': 'gpt-5-mini',
+    'gpt-5-nano': 'gpt-5-nano',
+};
+/**
+ * o-Series Reasoning Models (Latest - 2025)
+ * - o3: Most powerful reasoning model
+ * - o3-pro: Extended thinking for complex tasks
+ * - o4-mini: Fast, cost-efficient reasoning
+ */
+exports.O_SERIES_MODELS = {
+    'o3': 'o3',
+    'o3-pro': 'o3-pro',
+    'o4-mini': 'o4-mini',
+    'o1': 'o1', // Previous generation
+};
+/**
+ * GPT-4.1 Models (2025)
+ * - Major gains in coding and instruction following
+ * - Up to 1M token context
+ */
+exports.GPT_4_1_MODELS = {
+    'gpt-4.1': 'gpt-4.1',
+    'gpt-4.1-mini': 'gpt-4.1-mini',
+    'gpt-4.1-nano': 'gpt-4.1-nano',
+};
+/**
+ * GPT-4o Models (2024-2025)
+ * - Optimized for speed and multimodal
+ */
+exports.GPT_4O_MODELS = {
+    'gpt-4o': 'gpt-4o',
+    'gpt-4o-mini': 'gpt-4o-mini',
+};
+/**
+ * Legacy GPT-4 Models
+ */
+exports.GPT_4_LEGACY_MODELS = {
+    'gpt-4-turbo': 'gpt-4-turbo',
+    'gpt-4': 'gpt-4',
+};
+/**
+ * All available OpenAI models
+ */
+exports.OPENAI_MODELS = {
+    ...exports.GPT_5_MODELS,
+    ...exports.O_SERIES_MODELS,
+    ...exports.GPT_4_1_MODELS,
+    ...exports.GPT_4O_MODELS,
+    ...exports.GPT_4_LEGACY_MODELS,
+};
+/**
+ * Resolve a model alias or ID to the full model ID
+ */
+function resolveOpenAIModel(modelOrAlias) {
+    // Check if it's an alias
+    if (modelOrAlias in exports.OPENAI_MODELS) {
+        return exports.OPENAI_MODELS[modelOrAlias];
+    }
+    // Otherwise return as-is (allows using any model ID directly)
+    return modelOrAlias;
+}
 /**
  * OpenAI adapter for chat completions
  */
@@ -110,12 +188,31 @@ class OpenAIAdapter extends base_js_1.BaseLLMAdapter {
 exports.OpenAIAdapter = OpenAIAdapter;
 /**
  * Create an OpenAI adapter from environment variables
+ *
+ * @param model - Model ID or alias (e.g., 'gpt-5', 'o3', 'gpt-4.1', 'gpt-4o')
+ *                Use aliases for convenience or full model IDs for specific versions.
+ *                Any valid OpenAI model ID will work - not limited to the aliases.
+ *
+ * @example
+ * ```typescript
+ * // Using current flagship model
+ * const adapter = createOpenAIAdapter('gpt-5');
+ *
+ * // Using reasoning model for complex tasks
+ * const adapter = createOpenAIAdapter('o3');
+ *
+ * // Using fast, cost-effective reasoning
+ * const adapter = createOpenAIAdapter('o4-mini');
+ *
+ * // Using a future model (when released)
+ * const adapter = createOpenAIAdapter('gpt-6');
+ * ```
  */
 function createOpenAIAdapter(model = 'gpt-4o', overrides) {
     const apiKey = typeof process !== 'undefined' ? process.env.OPENAI_API_KEY : undefined;
     const config = {
         provider: 'openai',
-        model,
+        model: resolveOpenAIModel(model),
         ...overrides,
     };
     if (apiKey) {
@@ -123,4 +220,13 @@ function createOpenAIAdapter(model = 'gpt-4o', overrides) {
     }
     return new OpenAIAdapter(config);
 }
+/**
+ * List all available OpenAI model aliases
+ */
+function listOpenAIModels() {
+    return Object.entries(exports.OPENAI_MODELS).map(([alias, modelId]) => ({
+        alias,
+        modelId,
+    }));
+}
 //# sourceMappingURL=openai.js.map

package/dist/cjs/llm/adapters/openai.js.map

@@ -1 +1 @@
-{"version":3,"file":"openai.js","sourceRoot":"","sources":["../../../../src/llm/adapters/openai.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"openai.js","sourceRoot":"","sources":["../../../../src/llm/adapters/openai.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAwFH,gDAOC;AAyLD,kDAiBC;AAKD,4CAKC;AA3SD,uCAAqE;AAErE,gFAAgF;AAChF,wBAAwB;AACxB,iEAAiE;AACjE,0EAA0E;AAC1E,gFAAgF;AAEhF;;;;;GAKG;AACU,QAAA,YAAY,GAAG;IAC1B,OAAO,EAAE,OAAO;IAChB,YAAY,EAAE,YAAY;IAC1B,YAAY,EAAE,YAAY;CAClB,CAAC;AAEX;;;;;GAKG;AACU,QAAA,eAAe,GAAG;IAC7B,IAAI,EAAE,IAAI;IACV,QAAQ,EAAE,QAAQ;IAClB,SAAS,EAAE,SAAS;IACpB,IAAI,EAAE,IAAI,EAAE,sBAAsB;CAC1B,CAAC;AAEX;;;;GAIG;AACU,QAAA,cAAc,GAAG;IAC5B,SAAS,EAAE,SAAS;IACpB,cAAc,EAAE,cAAc;IAC9B,cAAc,EAAE,cAAc;CACtB,CAAC;AAEX;;;GAGG;AACU,QAAA,aAAa,GAAG;IAC3B,QAAQ,EAAE,QAAQ;IAClB,aAAa,EAAE,aAAa;CACpB,CAAC;AAEX;;GAEG;AACU,QAAA,mBAAmB,GAAG;IACjC,aAAa,EAAE,aAAa;IAC5B,OAAO,EAAE,OAAO;CACR,CAAC;AAEX;;GAEG;AACU,QAAA,aAAa,GAAG;IAC3B,GAAG,oBAAY;IACf,GAAG,uBAAe;IAClB,GAAG,sBAAc;IACjB,GAAG,qBAAa;IAChB,GAAG,2BAAmB;CACd,CAAC;AAOX;;GAEG;AACH,SAAgB,kBAAkB,CAAC,YAAoB;IACrD,yBAAyB;IACzB,IAAI,YAAY,IAAI,qBAAa,EAAE,CAAC;QAClC,OAAO,qBAAa,CAAC,YAAgC,CAAC,CAAC;IACzD,CAAC;IACD,8DAA8D;IAC9D,OAAO,YAAY,CAAC;AACtB,CAAC;AAuCD;;GAEG;AACH,MAAa,aAAc,SAAQ,wBAAc;IAC9B,OAAO,CAAS;IAChB,YAAY,CAAU;IAEvC,YAAY,MAAoB;QAC9B,KAAK,CAAC,MAAM,CAAC,CAAC;QACd,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,2BAA2B,CAAC;QAC7D,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;YACxB,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC,YAAY,CAAC;QAC1C,CAAC;IACH,CAAC;IAED,IAAI,QAAQ;QACV,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,OAA0B;QACvC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,CAAC;YACzB,MAAM,IAAI,kBAAQ,CAChB,6EAA6E,EAC7E,gBAAgB,EAChB,IAAI,CAAC,QAAQ,CACd,CAAC;QACJ,CAAC;QAED,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,IAAI,EAAE;YAC/B,MAAM,OAAO,GAA2B;gBACtC,cAAc,EAAE,kBAAkB;gBAClC,aAAa,EAAE,UAAU,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE;aAC9C,CAAC;YAEF,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;gBACtB,OAAO,CAAC,qBAAqB,CAAC,GAAG,IAAI,CAAC,YAAY,CAAC;YACrD,CAAC;YAED,MAAM,IAAI,GAA4B;gBACpC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK;gBACxB,QAAQ,EAAE,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;oBACrC,IAAI,EAAE,CAAC,CAAC,IAAI;oBACZ,OAAO,EAAE,CAAC,CAAC,OAAO;iBACnB,CAAC,CAAC;gBACH,UAAU,EAAE,OAAO,CAAC,SAAS,IAAI,IAAI,CAAC,MAAM,CAAC,SAAS,IAAI,wBAAc,CAAC,SAAS;gBAClF,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,IAAI,CAAC,MAAM,CAAC,WAAW,IAAI,wBAAc,CAAC,WAAW;aAC1F,CAAC;YAEF,6BAA6B;YAC7B,IAAI,OAAO,CAAC,cAAc,KAAK,MAAM,EAAE,CAAC;gBACtC,IAAI,CAAC,eAAe,GAAG,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC;YACjD,CAAC;YAED,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;YACzC,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,wBAAc,CAAC,OAAO,CAAC,CAAC;YAEpG,IAAI,CAAC;gBACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,OAAO,mBAAmB,EAAE;oBAC/D,MAAM,EAAE,MAAM;oBACd,OAAO;oBACP,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;oBAC1B,MAAM,EAAE,UAAU,CAAC,MAAM;iBAC1B,CAAC,CAAC;gBAEH,YAAY,CAAC,OAAO,CAAC,CAAC;gBAEtB,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;oBACjB,MAAM,SAAS,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAwB,CAAC;oBACnF,MAAM,YAAY,GAAG,SAAS,CAAC,KAAK,EAAE,OAAO,IAAI,QAAQ,QAAQ,CAAC,MAAM,EAAE,CAAC;oBAE3E,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;wBAC5B,MAAM,IAAI,kBAAQ,CAAC,wBAAwB,YAAY,EAAE,EAAE,YAAY,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;oBAC1F,CAAC;oBAED,MAAM,IAAI,kBAAQ,CAAC,qBAAqB,YAAY,EAAE,EAAE,WAAW,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;gBACtF,CAAC;gBAED,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAmB,CAAC;gBACvD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;gBAE/B,IAAI,CAAC,MAAM,EAAE,CAAC;oBACZ,MAAM,IAAI,kBAAQ,CAAC,yBAAyB,EAAE,kBAAkB,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;gBACnF,CAAC;gBAED,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC;gBACvC,IAAI,IAAa,CAAC;gBAElB,IAAI,OAAO,CAAC,cAAc,KAAK,MAAM,EAAE,CAAC;oBACtC,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;gBACjC,CAAC;gBAED,OAAO;oBACL,OAAO;oBACP,IAAI;oBACJ,KAAK,EAAE;wBACL,YAAY,EAAE,IAAI,CAAC,KAAK,CAAC,aAAa;wBACtC,gBAAgB,EAAE,IAAI,CAAC,KAAK,CAAC,iBAAiB;wBAC9C,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,YAAY;qBACrC;oBACD,KAAK,EAAE,IAAI,CAAC,KAAK;oBACjB,YAAY,EAAE,MAAM,CAAC,aAAa,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;wBAC3C,MAAM,CAAC,aAAa,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;4BAC9C,MAAM,CAAC,aAAa,KAAK,gBAAgB,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,OAAO;iBACpF,CAAC;YACJ,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,YAAY,CAAC,OAAO,CAAC,CAAC;gBAEtB,IAAI,KAAK,YAAY,kBAAQ,EAAE,CAAC;oBAC9B,MAAM,KAAK,CAAC;gBACd,CAAC;gBAED,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;oBAC3B,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;wBAChC,MAAM,IAAI,kBAAQ,CAAC,iBAAiB,EAAE,SAAS,EAAE,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;oBACzE,CAAC;oBACD,MAAM,IAAI,kBAAQ,CAAC,kBAAkB,KAAK,CAAC,OAAO,EAAE,EAAE,eAAe,EAAE,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;gBAC/F,CAAC;gBAED,MAAM,IAAI,kBAAQ,CAAC,eAAe,EAAE,WAAW,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;YAClE,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;CACF;AAvHD,sCAuHC;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,SAAgB,mBAAmB,CACjC,QAAmC,QAAQ,EAC3C,SAAiC;IAEjC,MAAM,MAAM,GAAG,OAAO,OAAO,KAAK,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,SAAS,CAAC;IAEvF,MAAM,MAAM,GAAiB;QAC3B,QAAQ,EAAE,QAAQ;QAClB,KAAK,EAAE,kBAAkB,CAAC,KAAK,CAAC;QAChC,GAAG,SAAS;KACb,CAAC;IAEF,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC;IACzB,CAAC;IAED,OAAO,IAAI,aAAa,CAAC,MAAM,CAAC,CAAC;AACnC,CAAC;AAED;;GAEG;AACH,SAAgB,gBAAgB;IAC9B,OAAO,MAAM,CAAC,OAAO,CAAC,qBAAa,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC;QAC9D,KAAK;QACL,OAAO;KACR,CAAC,CAAC,CAAC;AACN,CAAC"}

package/dist/cjs/mcp/cli.js

@@ -0,0 +1,302 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * LearnGraph MCP Server CLI
+ *
+ * Command-line interface for running the LearnGraph MCP server.
+ *
+ * Usage:
+ *   npx learngraph-mcp                    # Run with in-memory storage
+ *   npx learngraph-mcp --neo4j <uri>      # Run with Neo4j backend
+ *   npx learngraph-mcp --level <path>     # Run with LevelGraph backend
+ *
+ * @packageDocumentation
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const server_js_1 = require("./server.js");
+const memory_js_1 = require("../storage/memory.js");
+function parseArgs(args) {
+    const options = {
+        backend: 'memory',
+        debug: false,
+        help: false,
+    };
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        switch (arg) {
+            case '-h':
+            case '--help':
+                options.help = true;
+                break;
+            case '-d':
+            case '--debug':
+                options.debug = true;
+                break;
+            case '--neo4j': {
+                options.backend = 'neo4j';
+                const nextArg = args[i + 1];
+                if (nextArg !== undefined && !nextArg.startsWith('-')) {
+                    options.neo4jUri = nextArg;
+                    i++;
+                }
+                break;
+            }
+            case '--neo4j-user': {
+                const nextArg = args[i + 1];
+                if (nextArg !== undefined) {
+                    options.neo4jUser = nextArg;
+                    i++;
+                }
+                break;
+            }
+            case '--neo4j-password': {
+                const nextArg = args[i + 1];
+                if (nextArg !== undefined) {
+                    options.neo4jPassword = nextArg;
+                    i++;
+                }
+                break;
+            }
+            case '--level':
+            case '--levelgraph': {
+                options.backend = 'levelgraph';
+                const nextArg = args[i + 1];
+                if (nextArg !== undefined && !nextArg.startsWith('-')) {
+                    options.levelPath = nextArg;
+                    i++;
+                }
+                break;
+            }
+            case '--memory':
+                options.backend = 'memory';
+                break;
+        }
+    }
+    return options;
+}
+function printHelp() {
+    console.error(`
+LearnGraph MCP Server
+
+An MCP server that provides educational knowledge graph capabilities to Claude.
+
+USAGE:
+    learngraph-mcp [OPTIONS]
+
+OPTIONS:
+    -h, --help              Show this help message
+    -d, --debug             Enable debug logging
+
+    --memory                Use in-memory storage (default)
+    --neo4j <uri>           Use Neo4j storage
+    --neo4j-user <user>     Neo4j username (default: neo4j)
+    --neo4j-password <pwd>  Neo4j password
+    --level <path>          Use LevelGraph storage
+
+ENVIRONMENT VARIABLES:
+    NEO4J_URI               Neo4j connection URI
+    NEO4J_USER              Neo4j username
+    NEO4J_PASSWORD          Neo4j password
+    LEARNGRAPH_DEBUG        Enable debug logging (1 or true)
+
+EXAMPLES:
+    # Run with in-memory storage
+    learngraph-mcp
+
+    # Run with Neo4j
+    learngraph-mcp --neo4j bolt://localhost:7687 --neo4j-password secret
+
+    # Run with LevelGraph (file-based)
+    learngraph-mcp --level ./my-graph
+
+CLAUDE DESKTOP CONFIGURATION:
+    Add to claude_desktop_config.json:
+    {
+      "mcpServers": {
+        "learngraph": {
+          "command": "npx",
+          "args": ["learngraph-mcp"]
+        }
+      }
+    }
+
+AVAILABLE TOOLS:
+    list_skills          List all skills in the knowledge graph
+    get_skill            Get detailed skill information
+    create_skill         Create a new skill
+    search_skills        Search skills by name/description
+    get_prerequisites    Get prerequisite skills
+    get_dependents       Get dependent skills
+    get_learning_path    Generate a learning path
+    get_zpd_skills       Get skills in the Zone of Proximal Development
+    create_prerequisite  Create a prerequisite relationship
+    get_graph_stats      Get graph statistics
+    validate_curriculum  Validate curriculum structure
+
+AVAILABLE RESOURCES:
+    learngraph://curriculum/overview     Curriculum overview
+    learngraph://curriculum/skills       All skills
+    learngraph://curriculum/edges        All prerequisites
+    learngraph://curriculum/skills/{id}  Specific skill
+    learngraph://curriculum/bloom/{lvl}  Skills by Bloom level
+    learngraph://curriculum/tags         All tags
+    learngraph://curriculum/export       Full export
+
+AVAILABLE PROMPTS:
+    analyze_syllabus         Extract skills from a syllabus
+    generate_learning_path   Create a personalized learning path
+    identify_prerequisites   Map prerequisite relationships
+    zpd_recommendations      Get ZPD-based skill recommendations
+    curriculum_validation    Validate curriculum structure
+    gap_analysis             Analyze competency gaps
+    create_assessment        Generate skill assessments
+    explain_concept          Multi-level concept explanations
+`);
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Storage Factory
+// ─────────────────────────────────────────────────────────────────────────────
+async function createStorage(options) {
+    const debug = options.debug || process.env.LEARNGRAPH_DEBUG === '1' || process.env.LEARNGRAPH_DEBUG === 'true';
+    if (debug) {
+        console.error('[LearnGraph MCP] Creating storage...');
+    }
+    switch (options.backend) {
+        case 'neo4j': {
+            const uri = options.neo4jUri || process.env.NEO4J_URI || 'bolt://localhost:7687';
+            const user = options.neo4jUser || process.env.NEO4J_USER || 'neo4j';
+            const password = options.neo4jPassword || process.env.NEO4J_PASSWORD;
+            if (!password) {
+                console.error('Error: Neo4j password required. Use --neo4j-password or NEO4J_PASSWORD env var.');
+                process.exit(1);
+            }
+            try {
+                const { Neo4jStorage } = await Promise.resolve().then(() => __importStar(require('../storage/neo4j.js')));
+                const storage = new Neo4jStorage();
+                await storage.connect({
+                    backend: 'neo4j',
+                    uri,
+                    username: user,
+                    password,
+                });
+                if (debug) {
+                    console.error(`[LearnGraph MCP] Connected to Neo4j at ${uri}`);
+                }
+                return storage;
+            }
+            catch (err) {
+                console.error('Error: Neo4j driver not installed. Run: npm install neo4j-driver');
+                process.exit(1);
+            }
+        }
+        case 'levelgraph': {
+            const path = options.levelPath;
+            try {
+                const { LevelGraphStorage } = await Promise.resolve().then(() => __importStar(require('../storage/levelgraph.js')));
+                const storage = new LevelGraphStorage();
+                const config = { backend: 'levelgraph' };
+                if (path) {
+                    config.path = path;
+                }
+                await storage.connect(config);
+                if (debug) {
+                    console.error(`[LearnGraph MCP] LevelGraph storage${path ? ` at ${path}` : ' (in-memory)'}`);
+                }
+                return storage;
+            }
+            catch (err) {
+                console.error('Error: LevelGraph not installed. Run: npm install level levelgraph');
+                process.exit(1);
+            }
+        }
+        case 'memory':
+        default: {
+            const storage = new memory_js_1.MemoryStorage();
+            await storage.connect({ backend: 'memory' });
+            if (debug) {
+                console.error('[LearnGraph MCP] Using in-memory storage');
+            }
+            return storage;
+        }
+    }
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Main
+// ─────────────────────────────────────────────────────────────────────────────
+async function main() {
+    const options = parseArgs(process.argv.slice(2));
+    if (options.help) {
+        printHelp();
+        process.exit(0);
+    }
+    const debug = options.debug || process.env.LEARNGRAPH_DEBUG === '1' || process.env.LEARNGRAPH_DEBUG === 'true';
+    try {
+        // Create storage
+        const storage = await createStorage(options);
+        // Create and start MCP server
+        const server = new server_js_1.LearnGraphMcpServer({
+            storage,
+            debug,
+        });
+        await server.start();
+        if (debug) {
+            console.error('[LearnGraph MCP] Server running. Waiting for MCP client connection...');
+        }
+        // Handle graceful shutdown
+        process.on('SIGINT', () => {
+            if (debug) {
+                console.error('[LearnGraph MCP] Shutting down...');
+            }
+            process.exit(0);
+        });
+        process.on('SIGTERM', () => {
+            if (debug) {
+                console.error('[LearnGraph MCP] Shutting down...');
+            }
+            process.exit(0);
+        });
+    }
+    catch (err) {
+        console.error('Error starting MCP server:', err instanceof Error ? err.message : err);
+        process.exit(1);
+    }
+}
+// Run if executed directly
+main().catch((err) => {
+    console.error('Fatal error:', err);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cjs/mcp/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../../src/mcp/cli.ts"],"names":[],"mappings":"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"}

package/dist/cjs/mcp/index.js

@@ -0,0 +1,79 @@
+"use strict";
+/**
+ * LearnGraph MCP Server Module
+ *
+ * Model Context Protocol integration for Claude.
+ * Provides tools, resources, and prompts for educational knowledge graphs.
+ *
+ * @packageDocumentation
+ *
+ * @example
+ * ```typescript
+ * import { LearnGraphMcpServer, startMcpServer } from 'learngraph/mcp';
+ * import { MemoryStorage } from 'learngraph/storage';
+ *
+ * // Create storage
+ * const storage = new MemoryStorage();
+ * await storage.connect({ backend: 'memory' });
+ *
+ * // Option 1: Quick start
+ * await startMcpServer({ storage });
+ *
+ * // Option 2: Full control
+ * const server = new LearnGraphMcpServer({ storage });
+ * console.log(server.listTools());
+ * await server.start();
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getPromptDefinition = exports.renderPrompt = exports.getPromptMetas = exports.PROMPT_DEFINITIONS = exports.getFullExport = exports.getAllTags = exports.getSkillsByBloomLevel = exports.getSkillById = exports.getAllEdges = exports.getAllSkills = exports.getCurriculumOverview = exports.resolveResource = exports.listResources = exports.getResourceTemplates = exports.validateCurriculum = exports.getGraphStats = exports.createPrerequisite = exports.getZpdSkills = exports.getLearningPath = exports.getDependents = exports.getPrerequisites = exports.searchSkills = exports.createSkill = exports.getSkill = exports.listSkills = exports.ValidateCurriculumSchema = exports.GetGraphStatsSchema = exports.CreatePrerequisiteSchema = exports.GetZpdSkillsSchema = exports.GetLearningPathSchema = exports.GetDependentsSchema = exports.GetPrerequisitesSchema = exports.SearchSkillsSchema = exports.CreateSkillSchema = exports.GetSkillSchema = exports.ListSkillsSchema = exports.TOOL_DEFINITIONS = exports.startMcpServer = exports.LearnGraphMcpServer = void 0;
+// Server
+var server_js_1 = require("./server.js");
+Object.defineProperty(exports, "LearnGraphMcpServer", { enumerable: true, get: function () { return server_js_1.LearnGraphMcpServer; } });
+Object.defineProperty(exports, "startMcpServer", { enumerable: true, get: function () { return server_js_1.startMcpServer; } });
+// Tools
+var tools_js_1 = require("./tools.js");
+Object.defineProperty(exports, "TOOL_DEFINITIONS", { enumerable: true, get: function () { return tools_js_1.TOOL_DEFINITIONS; } });
+// Individual tool schemas for advanced usage
+Object.defineProperty(exports, "ListSkillsSchema", { enumerable: true, get: function () { return tools_js_1.ListSkillsSchema; } });
+Object.defineProperty(exports, "GetSkillSchema", { enumerable: true, get: function () { return tools_js_1.GetSkillSchema; } });
+Object.defineProperty(exports, "CreateSkillSchema", { enumerable: true, get: function () { return tools_js_1.CreateSkillSchema; } });
+Object.defineProperty(exports, "SearchSkillsSchema", { enumerable: true, get: function () { return tools_js_1.SearchSkillsSchema; } });
+Object.defineProperty(exports, "GetPrerequisitesSchema", { enumerable: true, get: function () { return tools_js_1.GetPrerequisitesSchema; } });
+Object.defineProperty(exports, "GetDependentsSchema", { enumerable: true, get: function () { return tools_js_1.GetDependentsSchema; } });
+Object.defineProperty(exports, "GetLearningPathSchema", { enumerable: true, get: function () { return tools_js_1.GetLearningPathSchema; } });
+Object.defineProperty(exports, "GetZpdSkillsSchema", { enumerable: true, get: function () { return tools_js_1.GetZpdSkillsSchema; } });
+Object.defineProperty(exports, "CreatePrerequisiteSchema", { enumerable: true, get: function () { return tools_js_1.CreatePrerequisiteSchema; } });
+Object.defineProperty(exports, "GetGraphStatsSchema", { enumerable: true, get: function () { return tools_js_1.GetGraphStatsSchema; } });
+Object.defineProperty(exports, "ValidateCurriculumSchema", { enumerable: true, get: function () { return tools_js_1.ValidateCurriculumSchema; } });
+// Individual tool handlers for testing
+Object.defineProperty(exports, "listSkills", { enumerable: true, get: function () { return tools_js_1.listSkills; } });
+Object.defineProperty(exports, "getSkill", { enumerable: true, get: function () { return tools_js_1.getSkill; } });
+Object.defineProperty(exports, "createSkill", { enumerable: true, get: function () { return tools_js_1.createSkill; } });
+Object.defineProperty(exports, "searchSkills", { enumerable: true, get: function () { return tools_js_1.searchSkills; } });
+Object.defineProperty(exports, "getPrerequisites", { enumerable: true, get: function () { return tools_js_1.getPrerequisites; } });
+Object.defineProperty(exports, "getDependents", { enumerable: true, get: function () { return tools_js_1.getDependents; } });
+Object.defineProperty(exports, "getLearningPath", { enumerable: true, get: function () { return tools_js_1.getLearningPath; } });
+Object.defineProperty(exports, "getZpdSkills", { enumerable: true, get: function () { return tools_js_1.getZpdSkills; } });
+Object.defineProperty(exports, "createPrerequisite", { enumerable: true, get: function () { return tools_js_1.createPrerequisite; } });
+Object.defineProperty(exports, "getGraphStats", { enumerable: true, get: function () { return tools_js_1.getGraphStats; } });
+Object.defineProperty(exports, "validateCurriculum", { enumerable: true, get: function () { return tools_js_1.validateCurriculum; } });
+// Resources
+var resources_js_1 = require("./resources.js");
+Object.defineProperty(exports, "getResourceTemplates", { enumerable: true, get: function () { return resources_js_1.getResourceTemplates; } });
+Object.defineProperty(exports, "listResources", { enumerable: true, get: function () { return resources_js_1.listResources; } });
+Object.defineProperty(exports, "resolveResource", { enumerable: true, get: function () { return resources_js_1.resolveResource; } });
+Object.defineProperty(exports, "getCurriculumOverview", { enumerable: true, get: function () { return resources_js_1.getCurriculumOverview; } });
+Object.defineProperty(exports, "getAllSkills", { enumerable: true, get: function () { return resources_js_1.getAllSkills; } });
+Object.defineProperty(exports, "getAllEdges", { enumerable: true, get: function () { return resources_js_1.getAllEdges; } });
+Object.defineProperty(exports, "getSkillById", { enumerable: true, get: function () { return resources_js_1.getSkillById; } });
+Object.defineProperty(exports, "getSkillsByBloomLevel", { enumerable: true, get: function () { return resources_js_1.getSkillsByBloomLevel; } });
+Object.defineProperty(exports, "getAllTags", { enumerable: true, get: function () { return resources_js_1.getAllTags; } });
+Object.defineProperty(exports, "getFullExport", { enumerable: true, get: function () { return resources_js_1.getFullExport; } });
+// Prompts
+var prompts_js_1 = require("./prompts.js");
+Object.defineProperty(exports, "PROMPT_DEFINITIONS", { enumerable: true, get: function () { return prompts_js_1.PROMPT_DEFINITIONS; } });
+Object.defineProperty(exports, "getPromptMetas", { enumerable: true, get: function () { return prompts_js_1.getPromptMetas; } });
+Object.defineProperty(exports, "renderPrompt", { enumerable: true, get: function () { return prompts_js_1.renderPrompt; } });
+Object.defineProperty(exports, "getPromptDefinition", { enumerable: true, get: function () { return prompts_js_1.getPromptDefinition; } });
+//# sourceMappingURL=index.js.map

package/dist/cjs/mcp/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/mcp/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;;;AAEH,SAAS;AACT,yCAAkE;AAAzD,gHAAA,mBAAmB,OAAA;AAAE,2GAAA,cAAc,OAAA;AAmB5C,QAAQ;AACR,uCA2BoB;AA1BlB,4GAAA,gBAAgB,OAAA;AAEhB,6CAA6C;AAC7C,4GAAA,gBAAgB,OAAA;AAChB,0GAAA,cAAc,OAAA;AACd,6GAAA,iBAAiB,OAAA;AACjB,8GAAA,kBAAkB,OAAA;AAClB,kHAAA,sBAAsB,OAAA;AACtB,+GAAA,mBAAmB,OAAA;AACnB,iHAAA,qBAAqB,OAAA;AACrB,8GAAA,kBAAkB,OAAA;AAClB,oHAAA,wBAAwB,OAAA;AACxB,+GAAA,mBAAmB,OAAA;AACnB,oHAAA,wBAAwB,OAAA;AACxB,uCAAuC;AACvC,sGAAA,UAAU,OAAA;AACV,oGAAA,QAAQ,OAAA;AACR,uGAAA,WAAW,OAAA;AACX,wGAAA,YAAY,OAAA;AACZ,4GAAA,gBAAgB,OAAA;AAChB,yGAAA,aAAa,OAAA;AACb,2GAAA,eAAe,OAAA;AACf,wGAAA,YAAY,OAAA;AACZ,8GAAA,kBAAkB,OAAA;AAClB,yGAAA,aAAa,OAAA;AACb,8GAAA,kBAAkB,OAAA;AAGpB,YAAY;AACZ,+CAYwB;AAXtB,oHAAA,oBAAoB,OAAA;AACpB,6GAAA,aAAa,OAAA;AACb,+GAAA,eAAe,OAAA;AACf,qHAAA,qBAAqB,OAAA;AACrB,4GAAA,YAAY,OAAA;AACZ,2GAAA,WAAW,OAAA;AACX,4GAAA,YAAY,OAAA;AACZ,qHAAA,qBAAqB,OAAA;AACrB,0GAAA,UAAU,OAAA;AACV,6GAAA,aAAa,OAAA;AAIf,UAAU;AACV,2CAKsB;AAJpB,gHAAA,kBAAkB,OAAA;AAClB,4GAAA,cAAc,OAAA;AACd,0GAAA,YAAY,OAAA;AACZ,iHAAA,mBAAmB,OAAA"}