learngraph 0.5.0 → 0.8.0

package/dist/types/llm/graphrag-orchestrator.d.ts

@@ -0,0 +1,280 @@
+/**
+ * GraphRAG-enhanced LLM orchestrator
+ *
+ * Extends the base orchestrator with semantic search capabilities
+ * to provide better context for skill extraction and prerequisite inference.
+ *
+ * @packageDocumentation
+ */
+import type { LLMAdapter, SkillExtractionRequest, SkillExtractionResponse, PrerequisiteInferenceRequest, PrerequisiteInferenceResponse, DecompositionRequest, DecompositionResponse, ExtractedSkillLLM } from '../types/llm.js';
+import type { BloomLevel } from '../types/bloom.js';
+import type { GraphRAGStorage, VectorSearchResult } from '../types/graphrag.js';
+import { LLMOrchestrator } from './orchestrator.js';
+/**
+ * Options for GraphRAG-enhanced operations
+ */
+export interface GraphRAGOrchestratorOptions {
+    /** Maximum similar skills to include in context (default: 5) */
+    maxContextSkills?: number;
+    /** Minimum similarity score for context skills (default: 0.6) */
+    minContextScore?: number;
+    /** Include prerequisite chains in context (default: true) */
+    includePrerequisites?: boolean;
+    /** Weight for similar skill context in prompt (default: 0.3) */
+    contextWeight?: number;
+}
+/**
+ * Extended extraction request with RAG context
+ */
+export interface RAGSkillExtractionRequest extends SkillExtractionRequest {
+    /** Enable RAG-enhanced extraction */
+    useRAG?: boolean;
+    /** RAG options */
+    ragOptions?: GraphRAGOrchestratorOptions;
+}
+/**
+ * Extended extraction response with RAG metadata
+ */
+export interface RAGSkillExtractionResponse extends SkillExtractionResponse {
+    /** Similar skills used for context */
+    contextSkills?: VectorSearchResult[];
+    /** RAG context that was provided */
+    ragContext?: string;
+}
+/**
+ * Extended decomposition request with RAG
+ */
+export interface RAGDecompositionRequest extends DecompositionRequest {
+    /** Enable RAG-enhanced decomposition */
+    useRAG?: boolean;
+    /** RAG options */
+    ragOptions?: GraphRAGOrchestratorOptions;
+}
+/**
+ * Extended decomposition response with RAG metadata
+ */
+export interface RAGDecompositionResponse extends DecompositionResponse {
+    /** Similar skills used for context */
+    contextSkills?: VectorSearchResult[];
+    /** RAG context that was provided */
+    ragContext?: string;
+    /** Skills that were matched to existing graph skills */
+    matchedSkills?: Array<{
+        extractedId: string;
+        matchedSkillId: string;
+        similarity: number;
+    }>;
+}
+/**
+ * GraphRAG-enhanced LLM orchestrator
+ *
+ * Provides semantic search-enhanced skill extraction and prerequisite inference.
+ */
+export declare class GraphRAGOrchestrator extends LLMOrchestrator {
+    private storage;
+    private defaultOptions;
+    constructor(adapter: LLMAdapter, storage?: GraphRAGStorage, options?: GraphRAGOrchestratorOptions);
+    /**
+     * Set the GraphRAG storage
+     */
+    setStorage(storage: GraphRAGStorage): void;
+    /**
+     * Get the current storage
+     */
+    getStorage(): GraphRAGStorage | null;
+    /**
+     * Check if GraphRAG is available
+     */
+    isRAGEnabled(): boolean;
+    /**
+     * Build context string from similar skills
+     */
+    private formatSkillContext;
+    /**
+     * Build context from full GraphRAG context
+     */
+    private formatGraphRAGContext;
+    /**
+     * Extract skills with RAG enhancement
+     */
+    extractSkillsWithRAG(request: RAGSkillExtractionRequest): Promise<RAGSkillExtractionResponse>;
+    /**
+     * Infer prerequisites with RAG enhancement
+     */
+    inferPrerequisitesWithRAG(request: PrerequisiteInferenceRequest & {
+        useRAG?: boolean;
+        ragOptions?: GraphRAGOrchestratorOptions;
+    }): Promise<PrerequisiteInferenceResponse & {
+        ragContext?: string;
+    }>;
+    /**
+     * Full curriculum decomposition with RAG enhancement
+     */
+    decomposeWithRAG(request: RAGDecompositionRequest): Promise<RAGDecompositionResponse>;
+    /**
+     * Find existing skills that match extracted skills
+     *
+     * Use this after extraction to identify duplicates
+     */
+    matchExtractedSkills(extractedSkills: ExtractedSkillLLM[], options?: {
+        minSimilarity?: number;
+    }): Promise<Array<{
+        extracted: ExtractedSkillLLM;
+        matches: VectorSearchResult[];
+        bestMatch?: {
+            skillId: string;
+            similarity: number;
+        };
+    }>>;
+    /**
+     * Suggest prerequisite links between extracted and existing skills
+     */
+    suggestPrerequisiteLinks(extractedSkills: Array<{
+        id: string;
+        name: string;
+        description: string;
+        bloomLevel: BloomLevel;
+    }>, options?: {
+        maxSuggestionsPerSkill?: number;
+    }): Promise<Array<{
+        extractedSkillId: string;
+        suggestedPrerequisites: Array<{
+            skillId: string;
+            skillName: string;
+            confidence: number;
+        }>;
+        suggestedDependents: Array<{
+            skillId: string;
+            skillName: string;
+            confidence: number;
+        }>;
+    }>>;
+    /**
+     * Generate a personalized learning path with LLM-enhanced reasoning
+     *
+     * This combines GraphRAG path generation with LLM analysis
+     * to provide better explanations and alternative paths.
+     */
+    generateLearningPath(request: LearningPathRequest): Promise<LearningPathWithReasoning>;
+    /**
+     * Format a learning path for LLM context
+     */
+    private formatPathForLLM;
+    /**
+     * Analyze a learner's progress and recommend next steps
+     */
+    analyzeProgressAndRecommend(request: ProgressAnalysisRequest): Promise<ProgressAnalysisResult>;
+}
+/**
+ * Request for learning path generation
+ */
+export interface LearningPathRequest {
+    /** Natural language goal description */
+    goal: string;
+    /** Current skill mastery states (skillId -> mastery 0-1) */
+    currentMastery?: Map<string, number>;
+    /** Maximum path length */
+    maxSteps?: number;
+    /** Learning preferences */
+    preferences?: {
+        style?: 'practical' | 'theoretical' | 'balanced';
+        difficulty?: 'gradual' | 'challenging';
+    };
+    /** Enhance path with LLM reasoning */
+    enhanceWithLLM?: boolean;
+}
+/**
+ * Enhanced learning path result with LLM reasoning
+ */
+export interface LearningPathWithReasoning {
+    /** Ordered list of skills with optional learning guidance */
+    path: Array<import('../types/skill.js').SkillNode & {
+        learningGuidance?: {
+            whyImportant: string;
+            howToApproach: string;
+            estimatedEffort: string;
+        };
+    }>;
+    /** Edges connecting path skills */
+    edges: import('../types/edge.js').PrerequisiteEdge[];
+    /** Estimated total time (minutes) */
+    estimatedMinutes: number;
+    /** Detailed reasoning for the path */
+    reasoning: string;
+    /** Alternative paths */
+    alternatives?: Array<{
+        path: import('../types/skill.js').SkillNode[];
+        reasoning: string;
+    }>;
+    /** LLM-generated enhancements */
+    llmEnhancements?: {
+        tips: string[];
+        potentialChallenges: string[];
+        alternativeApproaches?: Array<{
+            name: string;
+            description: string;
+            tradeoffs: string;
+        }>;
+    };
+    /** API usage */
+    usage?: import('../types/llm.js').CompletionResponse['usage'];
+    /** Processing time in milliseconds */
+    durationMs: number;
+}
+/**
+ * Progress analysis request
+ */
+export interface ProgressAnalysisRequest {
+    /** Map of skill IDs to mastery levels (0-1) */
+    masteredSkills: Map<string, number>;
+    /** The learner's goal (optional) */
+    goal?: string;
+    /** Generate LLM insights */
+    generateInsights?: boolean;
+    /** Max recommendations to return */
+    maxRecommendations?: number;
+}
+/**
+ * Skill recommendation
+ */
+export interface SkillRecommendation {
+    /** The recommended skill */
+    skill: import('../types/skill.js').SkillNode;
+    /** How ready the learner is (0-1) */
+    readiness: number;
+    /** Why this skill is recommended */
+    reason: string;
+    /** Priority score */
+    priority: number;
+}
+/**
+ * LLM-generated progress insights
+ */
+export interface ProgressInsights {
+    /** Summary of current progress */
+    progressSummary: string;
+    /** Strengths identified */
+    strengths: string[];
+    /** Areas for improvement */
+    areasToImprove: string[];
+    /** Motivational message */
+    encouragement: string;
+    /** Suggested focus areas */
+    focusAreas: string[];
+}
+/**
+ * Progress analysis result
+ */
+export interface ProgressAnalysisResult {
+    /** Recommended skills */
+    recommendations: SkillRecommendation[];
+    /** LLM insights (if requested) */
+    insights?: ProgressInsights;
+    /** Processing time */
+    durationMs: number;
+}
+/**
+ * Create a GraphRAG-enhanced orchestrator
+ */
+export declare function createGraphRAGOrchestrator(adapter: LLMAdapter, storage?: GraphRAGStorage, options?: GraphRAGOrchestratorOptions): GraphRAGOrchestrator;
+//# sourceMappingURL=graphrag-orchestrator.d.ts.map

package/dist/types/llm/graphrag-orchestrator.d.ts.map

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

package/dist/types/llm/index.d.ts

@@ -7,5 +7,7 @@ export type { LLMProvider, LLMConfig, OpenAIConfig, AnthropicConfig, OllamaConfi
 export { BaseLLMAdapter, LLMError, DEFAULT_CONFIG, OpenAIAdapter, createOpenAIAdapter, AnthropicAdapter, createAnthropicAdapter, OllamaAdapter, createOllamaAdapter, GeminiAdapter, createGeminiAdapter, OpenRouterAdapter, createOpenRouterAdapter, OPENROUTER_MODELS, MediaPipeAdapter, createMediaPipeAdapter, MEDIAPIPE_MODELS, } from './adapters/index.js';
 export type { LLMErrorCode } from './adapters/index.js';
 export { LLMOrchestrator, createOrchestrator } from './orchestrator.js';
+export { GraphRAGOrchestrator, createGraphRAGOrchestrator, } from './graphrag-orchestrator.js';
+export type { GraphRAGOrchestratorOptions, RAGSkillExtractionRequest, RAGSkillExtractionResponse, RAGDecompositionRequest, RAGDecompositionResponse, LearningPathRequest, LearningPathWithReasoning, ProgressAnalysisRequest, ProgressAnalysisResult, SkillRecommendation, ProgressInsights, } from './graphrag-orchestrator.js';
 export { SYSTEM_PROMPTS, EXTRACTION_SCHEMA, PREREQUISITE_SCHEMA, BLOOM_ANALYSIS_SCHEMA, DECOMPOSITION_SCHEMA, buildExtractionPrompt, buildPrerequisitePrompt, buildBloomPrompt, buildDecompositionPrompt, } from './prompts.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/llm/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/llm/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,YAAY,EACV,WAAW,EACX,SAAS,EACT,YAAY,EACZ,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,WAAW,EACX,WAAW,EACX,iBAAiB,EACjB,kBAAkB,EAClB,sBAAsB,EACtB,iBAAiB,EACjB,uBAAuB,EACvB,4BAA4B,EAC5B,oBAAoB,EACpB,6BAA6B,EAC7B,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,EACrB,UAAU,EACV,eAAe,IAAI,gBAAgB,GACpC,MAAM,iBAAiB,CAAC;AAKzB,OAAO,EACL,cAAc,EACd,QAAQ,EACR,cAAc,EACd,aAAa,EACb,mBAAmB,EACnB,gBAAgB,EAChB,sBAAsB,EACtB,aAAa,EACb,mBAAmB,EACnB,aAAa,EACb,mBAAmB,EACnB,iBAAiB,EACjB,uBAAuB,EACvB,iBAAiB,EACjB,gBAAgB,EAChB,sBAAsB,EACtB,gBAAgB,GACjB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAKxD,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAKxE,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,mBAAmB,EACnB,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,EACrB,uBAAuB,EACvB,gBAAgB,EAChB,wBAAwB,GACzB,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/llm/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,YAAY,EACV,WAAW,EACX,SAAS,EACT,YAAY,EACZ,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,WAAW,EACX,WAAW,EACX,iBAAiB,EACjB,kBAAkB,EAClB,sBAAsB,EACtB,iBAAiB,EACjB,uBAAuB,EACvB,4BAA4B,EAC5B,oBAAoB,EACpB,6BAA6B,EAC7B,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,EACrB,UAAU,EACV,eAAe,IAAI,gBAAgB,GACpC,MAAM,iBAAiB,CAAC;AAKzB,OAAO,EACL,cAAc,EACd,QAAQ,EACR,cAAc,EACd,aAAa,EACb,mBAAmB,EACnB,gBAAgB,EAChB,sBAAsB,EACtB,aAAa,EACb,mBAAmB,EACnB,aAAa,EACb,mBAAmB,EACnB,iBAAiB,EACjB,uBAAuB,EACvB,iBAAiB,EACjB,gBAAgB,EAChB,sBAAsB,EACtB,gBAAgB,GACjB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAKxD,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAKxE,OAAO,EACL,oBAAoB,EACpB,0BAA0B,GAC3B,MAAM,4BAA4B,CAAC;AACpC,YAAY,EACV,2BAA2B,EAC3B,yBAAyB,EACzB,0BAA0B,EAC1B,uBAAuB,EACvB,wBAAwB,EACxB,mBAAmB,EACnB,yBAAyB,EACzB,uBAAuB,EACvB,sBAAsB,EACtB,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,4BAA4B,CAAC;AAKpC,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,mBAAmB,EACnB,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,EACrB,uBAAuB,EACvB,gBAAgB,EAChB,wBAAwB,GACzB,MAAM,cAAc,CAAC"}

package/dist/types/mcp/cli.d.ts

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+/**
+ * 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
+ */
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/types/mcp/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../../src/mcp/cli.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;GAWG"}

package/dist/types/mcp/index.d.ts

@@ -0,0 +1,32 @@
+/**
+ * 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();
+ * ```
+ */
+export { LearnGraphMcpServer, startMcpServer } from './server.js';
+export type { McpServerConfig, McpTextContent, McpImageContent, McpContent, McpToolResult, McpResourceMeta, McpPromptArgument, McpPromptMeta, LearnerProfile, LearningPathResult, ZpdResult, SkillSearchResult, GraphStatistics, } from './types.js';
+export { TOOL_DEFINITIONS, type ToolName, ListSkillsSchema, GetSkillSchema, CreateSkillSchema, SearchSkillsSchema, GetPrerequisitesSchema, GetDependentsSchema, GetLearningPathSchema, GetZpdSkillsSchema, CreatePrerequisiteSchema, GetGraphStatsSchema, ValidateCurriculumSchema, listSkills, getSkill, createSkill, searchSkills, getPrerequisites, getDependents, getLearningPath, getZpdSkills, createPrerequisite, getGraphStats, validateCurriculum, } from './tools.js';
+export { getResourceTemplates, listResources, resolveResource, getCurriculumOverview, getAllSkills, getAllEdges, getSkillById, getSkillsByBloomLevel, getAllTags, getFullExport, type ResourceContent, } from './resources.js';
+export { PROMPT_DEFINITIONS, getPromptMetas, renderPrompt, getPromptDefinition, } from './prompts.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/mcp/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/mcp/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAGH,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAGlE,YAAY,EACV,eAAe,EACf,cAAc,EACd,eAAe,EACf,UAAU,EACV,aAAa,EACb,eAAe,EACf,iBAAiB,EACjB,aAAa,EACb,cAAc,EACd,kBAAkB,EAClB,SAAS,EACT,iBAAiB,EACjB,eAAe,GAChB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,gBAAgB,EAChB,KAAK,QAAQ,EAEb,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EACjB,kBAAkB,EAClB,sBAAsB,EACtB,mBAAmB,EACnB,qBAAqB,EACrB,kBAAkB,EAClB,wBAAwB,EACxB,mBAAmB,EACnB,wBAAwB,EAExB,UAAU,EACV,QAAQ,EACR,WAAW,EACX,YAAY,EACZ,gBAAgB,EAChB,aAAa,EACb,eAAe,EACf,YAAY,EACZ,kBAAkB,EAClB,aAAa,EACb,kBAAkB,GACnB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,oBAAoB,EACpB,aAAa,EACb,eAAe,EACf,qBAAqB,EACrB,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,qBAAqB,EACrB,UAAU,EACV,aAAa,EACb,KAAK,eAAe,GACrB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,YAAY,EACZ,mBAAmB,GACpB,MAAM,cAAc,CAAC"}

package/dist/types/mcp/prompts.d.ts

@@ -0,0 +1,27 @@
+/**
+ * MCP Prompt Templates
+ *
+ * Educational prompt templates for curriculum building and learning path generation.
+ *
+ * @packageDocumentation
+ */
+import type { McpPromptMeta } from './types.js';
+/**
+ * All available prompt templates
+ */
+export declare const PROMPT_DEFINITIONS: Record<string, McpPromptMeta & {
+    template: (args: Record<string, string>) => string;
+}>;
+/**
+ * Get prompt metadata for MCP listing
+ */
+export declare function getPromptMetas(): McpPromptMeta[];
+/**
+ * Render a prompt with arguments
+ */
+export declare function renderPrompt(promptName: string, args: Record<string, string>): string | null;
+/**
+ * Get a prompt definition by name
+ */
+export declare function getPromptDefinition(promptName: string): McpPromptMeta | null;
+//# sourceMappingURL=prompts.d.ts.map

package/dist/types/mcp/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../../src/mcp/prompts.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAMhD;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,GAAG;IAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,MAAM,CAAA;CAAE,CA6WrH,CAAC;AAEF;;GAEG;AACH,wBAAgB,cAAc,IAAI,aAAa,EAAE,CAahD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC3B,MAAM,GAAG,IAAI,CAOf;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAgB5E"}

package/dist/types/mcp/resources.d.ts

@@ -0,0 +1,59 @@
+/**
+ * MCP Resource Definitions
+ *
+ * Resource endpoints for exposing curriculum data through MCP.
+ *
+ * @packageDocumentation
+ */
+import type { GraphStorage } from '../types/index.js';
+import type { McpResourceMeta } from './types.js';
+/**
+ * Resource content result
+ */
+export interface ResourceContent {
+    uri: string;
+    mimeType: string;
+    text?: string;
+    blob?: string;
+}
+/**
+ * Get all available resource templates
+ */
+export declare function getResourceTemplates(): McpResourceMeta[];
+/**
+ * Get curriculum overview
+ */
+export declare function getCurriculumOverview(storage: GraphStorage): Promise<ResourceContent>;
+/**
+ * Get all skills
+ */
+export declare function getAllSkills(storage: GraphStorage): Promise<ResourceContent>;
+/**
+ * Get all edges
+ */
+export declare function getAllEdges(storage: GraphStorage): Promise<ResourceContent>;
+/**
+ * Get skill by ID
+ */
+export declare function getSkillById(storage: GraphStorage, skillId: string): Promise<ResourceContent | null>;
+/**
+ * Get skills by Bloom level
+ */
+export declare function getSkillsByBloomLevel(storage: GraphStorage, level: string): Promise<ResourceContent>;
+/**
+ * Get all tags with counts
+ */
+export declare function getAllTags(storage: GraphStorage): Promise<ResourceContent>;
+/**
+ * Get full curriculum export
+ */
+export declare function getFullExport(storage: GraphStorage): Promise<ResourceContent>;
+/**
+ * Route a resource URI to its handler
+ */
+export declare function resolveResource(storage: GraphStorage, uri: string): Promise<ResourceContent | null>;
+/**
+ * List all available resources (including dynamic ones based on current data)
+ */
+export declare function listResources(storage: GraphStorage): Promise<McpResourceMeta[]>;
+//# sourceMappingURL=resources.d.ts.map

package/dist/types/mcp/resources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["../../../src/mcp/resources.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,YAAY,EAA+B,MAAM,mBAAmB,CAAC;AACnF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAMD;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,eAAe,EAAE,CA6CxD;AAMD;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,eAAe,CAAC,CA+D3F;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,eAAe,CAAC,CAqBlF;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,eAAe,CAAC,CAmBjF;AAED;;GAEG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CA8BjC;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,YAAY,EACrB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,eAAe,CAAC,CAiC1B;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,eAAe,CAAC,CAgChF;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,eAAe,CAAC,CA+BnF;AAMD;;GAEG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,YAAY,EACrB,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAyCjC;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAyBrF"}

package/dist/types/mcp/server.d.ts

@@ -0,0 +1,136 @@
+/**
+ * LearnGraph MCP Server
+ *
+ * Model Context Protocol server for Claude integration.
+ * Exposes knowledge graph tools, resources, and prompts.
+ *
+ * @packageDocumentation
+ */
+import type { McpServerConfig, McpToolResult } from './types.js';
+/**
+ * LearnGraph MCP Server
+ *
+ * Provides tools, resources, and prompts for Claude to interact with
+ * educational knowledge graphs.
+ *
+ * @example
+ * ```typescript
+ * import { LearnGraphMcpServer } from 'learngraph/mcp';
+ * import { MemoryStorage } from 'learngraph/storage';
+ *
+ * const storage = new MemoryStorage();
+ * await storage.connect({ backend: 'memory' });
+ *
+ * const server = new LearnGraphMcpServer({ storage });
+ * await server.start();
+ * ```
+ */
+export declare class LearnGraphMcpServer {
+    private storage;
+    private config;
+    private isRunning;
+    constructor(config: McpServerConfig);
+    /**
+     * Log debug messages
+     */
+    private log;
+    /**
+     * Get server info
+     */
+    getServerInfo(): {
+        name: string;
+        version: string;
+    };
+    /**
+     * List available tools
+     */
+    listTools(): Array<{
+        name: string;
+        description: string;
+        inputSchema: Record<string, unknown>;
+    }>;
+    /**
+     * Execute a tool
+     */
+    executeTool(name: string, args: Record<string, unknown>): Promise<McpToolResult>;
+    /**
+     * List available resources
+     */
+    listResources(): Promise<Array<{
+        uri: string;
+        name: string;
+        description?: string;
+        mimeType?: string;
+    }>>;
+    /**
+     * Get resource templates
+     */
+    listResourceTemplates(): Array<{
+        uri: string;
+        name: string;
+        description?: string;
+        mimeType?: string;
+    }>;
+    /**
+     * Read a resource
+     */
+    readResource(uri: string): Promise<{
+        uri: string;
+        mimeType: string;
+        text?: string;
+    } | null>;
+    /**
+     * List available prompts
+     */
+    listPrompts(): Array<{
+        name: string;
+        description?: string;
+        arguments?: Array<{
+            name: string;
+            description?: string;
+            required?: boolean;
+        }>;
+    }>;
+    /**
+     * Get a prompt
+     */
+    getPrompt(name: string, args: Record<string, string>): {
+        description?: string;
+        messages: Array<{
+            role: string;
+            content: string;
+        }>;
+    } | null;
+    /**
+     * Convert Zod schema to JSON Schema
+     */
+    private zodToJsonSchema;
+    /**
+     * Start the MCP server (stdio transport)
+     *
+     * This requires @modelcontextprotocol/sdk to be installed.
+     */
+    start(): Promise<void>;
+    /**
+     * Check if server is running
+     */
+    get running(): boolean;
+}
+/**
+ * Create and start an MCP server
+ *
+ * Convenience function for quick server setup.
+ *
+ * @example
+ * ```typescript
+ * import { startMcpServer } from 'learngraph/mcp';
+ * import { MemoryStorage } from 'learngraph/storage';
+ *
+ * const storage = new MemoryStorage();
+ * await storage.connect({ backend: 'memory' });
+ *
+ * await startMcpServer({ storage });
+ * ```
+ */
+export declare function startMcpServer(config: McpServerConfig): Promise<LearnGraphMcpServer>;
+//# sourceMappingURL=server.d.ts.map

package/dist/types/mcp/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../src/mcp/server.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAoBjE;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,OAAO,CAAe;IAC9B,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,SAAS,CAAS;gBAEd,MAAM,EAAE,eAAe;IAUnC;;OAEG;IACH,OAAO,CAAC,GAAG;IAOX;;OAEG;IACH,aAAa,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE;IAOlD;;OAEG;IACH,SAAS,IAAI,KAAK,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACtC,CAAC;IAQF;;OAEG;IACG,WAAW,CACf,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,aAAa,CAAC;IA+BzB;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,KAAK,CAAC;QACnC,GAAG,EAAE,MAAM,CAAC;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC,CAAC;IAIH;;OAEG;IACH,qBAAqB,IAAI,KAAK,CAAC;QAC7B,GAAG,EAAE,MAAM,CAAC;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;IAIF;;OAEG;IACG,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;QACvC,GAAG,EAAE,MAAM,CAAC;QACZ,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,GAAG,IAAI,CAAC;IAIT;;OAEG;IACH,WAAW,IAAI,KAAK,CAAC;QACnB,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,SAAS,CAAC,EAAE,KAAK,CAAC;YAChB,IAAI,EAAE,MAAM,CAAC;YACb,WAAW,CAAC,EAAE,MAAM,CAAC;YACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;SACpB,CAAC,CAAC;KACJ,CAAC;IAIF;;OAEG;IACH,SAAS,CACP,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC3B;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,GAAG,IAAI;IAoBtF;;OAEG;IACH,OAAO,CAAC,eAAe;IA8EvB;;;;OAIG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAyI5B;;OAEG;IACH,IAAI,OAAO,IAAI,OAAO,CAErB;CACF;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,cAAc,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAI1F"}