learngraph 0.4.0 → 0.7.0

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

@@ -1,14 +1,23 @@
 /**
  * LLM adapter exports
  *
+ * All adapters support flexible model selection:
+ * - Use model aliases for convenience (e.g., 'sonnet-4.5', 'gpt-5', 'gemini-3-flash')
+ * - Use full model IDs for specific versions
+ * - Use any valid model ID string for future models
+ *
  * @packageDocumentation
  */
 export { BaseLLMAdapter, LLMError, DEFAULT_CONFIG } from './base.js';
 export type { LLMErrorCode } from './base.js';
-export { OpenAIAdapter, createOpenAIAdapter } from './openai.js';
-export { AnthropicAdapter, createAnthropicAdapter } from './anthropic.js';
-export { OllamaAdapter, createOllamaAdapter } from './ollama.js';
-export { GeminiAdapter, createGeminiAdapter } from './gemini.js';
+export { OpenAIAdapter, createOpenAIAdapter, resolveOpenAIModel, listOpenAIModels, OPENAI_MODELS, GPT_5_MODELS, O_SERIES_MODELS, GPT_4_1_MODELS, GPT_4O_MODELS, GPT_4_LEGACY_MODELS, } from './openai.js';
+export type { OpenAIModelAlias } from './openai.js';
+export { AnthropicAdapter, createAnthropicAdapter, resolveClaudeModel, listClaudeModels, CLAUDE_MODELS, CLAUDE_4_5_MODELS, CLAUDE_4_MODELS, CLAUDE_3_5_MODELS, CLAUDE_3_MODELS, } from './anthropic.js';
+export type { ClaudeModelAlias } from './anthropic.js';
+export { OllamaAdapter, createOllamaAdapter, resolveOllamaModel, listOllamaModels, OLLAMA_MODELS, LLAMA_MODELS, MISTRAL_MODELS, QWEN_MODELS, CODING_MODELS, SMALL_MODELS, } from './ollama.js';
+export type { OllamaModelAlias } from './ollama.js';
+export { GeminiAdapter, createGeminiAdapter, resolveGeminiModel, listGeminiModels, GEMINI_MODELS, GEMINI_3_MODELS, GEMINI_2_5_MODELS, GEMINI_2_0_MODELS, GEMINI_1_5_MODELS, } from './gemini.js';
+export type { GeminiModelAlias } from './gemini.js';
 export { OpenRouterAdapter, createOpenRouterAdapter, OPENROUTER_MODELS } from './openrouter.js';
 export { MediaPipeAdapter, createMediaPipeAdapter, MEDIAPIPE_MODELS } from './mediapipe.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/llm/adapters/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AACrE,YAAY,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAE9C,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACjE,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAC1E,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAChG,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/llm/adapters/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AACrE,YAAY,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAG9C,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,EAChB,aAAa,EACb,YAAY,EACZ,eAAe,EACf,cAAc,EACd,aAAa,EACb,mBAAmB,GACpB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAGpD,OAAO,EACL,gBAAgB,EAChB,sBAAsB,EACtB,kBAAkB,EAClB,gBAAgB,EAChB,aAAa,EACb,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EACjB,eAAe,GAChB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAGvD,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,EAChB,aAAa,EACb,YAAY,EACZ,cAAc,EACd,WAAW,EACX,aAAa,EACb,YAAY,GACb,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAGpD,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,EAChB,aAAa,EACb,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAGpD,OAAO,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAGhG,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/types/llm/adapters/ollama.d.ts

@@ -1,10 +1,109 @@
 /**
  * Ollama adapter for local LLM integration
  *
+ * Supports any model available through Ollama including Llama, Mistral, Qwen, and more.
+ *
  * @packageDocumentation
  */
 import type { LLMProvider, OllamaConfig, CompletionRequest, CompletionResponse } from '../../types/llm.js';
 import { BaseLLMAdapter } from './base.js';
+/**
+ * Meta Llama Models (Latest)
+ * - llama3.3: 70B parameter model, excellent general purpose
+ * - llama3.2: Available in 1B, 3B, and vision variants
+ */
+export declare const LLAMA_MODELS: {
+    readonly 'llama3.3': "llama3.3";
+    readonly 'llama3.3:70b': "llama3.3:70b";
+    readonly 'llama3.2': "llama3.2";
+    readonly 'llama3.2:1b': "llama3.2:1b";
+    readonly 'llama3.2:3b': "llama3.2:3b";
+    readonly 'llama3.2-vision': "llama3.2-vision";
+    readonly 'llama3.1': "llama3.1";
+    readonly 'llama3.1:8b': "llama3.1:8b";
+    readonly 'llama3.1:70b': "llama3.1:70b";
+};
+/**
+ * Mistral Models
+ * - mistral-large: Most capable Mistral model
+ * - mistral-nemo: Fast, efficient
+ * - mixtral: Mixture of experts
+ */
+export declare const MISTRAL_MODELS: {
+    readonly 'mistral-large': "mistral-large";
+    readonly 'mistral-nemo': "mistral-nemo";
+    readonly mistral: "mistral";
+    readonly mixtral: "mixtral";
+    readonly 'mixtral:8x7b': "mixtral:8x7b";
+};
+/**
+ * Qwen Models (Alibaba)
+ * - qwen2.5: Latest Qwen release
+ * - qwen2.5-coder: Optimized for coding
+ */
+export declare const QWEN_MODELS: {
+    readonly 'qwen2.5': "qwen2.5";
+    readonly 'qwen2.5:72b': "qwen2.5:72b";
+    readonly 'qwen2.5-coder': "qwen2.5-coder";
+    readonly qwen2: "qwen2";
+};
+/**
+ * Coding-Focused Models
+ */
+export declare const CODING_MODELS: {
+    readonly codellama: "codellama";
+    readonly 'deepseek-coder-v2': "deepseek-coder-v2";
+    readonly codegemma: "codegemma";
+    readonly starcoder2: "starcoder2";
+};
+/**
+ * Small/Fast Models
+ */
+export declare const SMALL_MODELS: {
+    readonly phi3: "phi3";
+    readonly 'phi3:mini': "phi3:mini";
+    readonly gemma2: "gemma2";
+    readonly 'gemma2:2b': "gemma2:2b";
+};
+/**
+ * All popular Ollama models
+ */
+export declare const OLLAMA_MODELS: {
+    readonly phi3: "phi3";
+    readonly 'phi3:mini': "phi3:mini";
+    readonly gemma2: "gemma2";
+    readonly 'gemma2:2b': "gemma2:2b";
+    readonly codellama: "codellama";
+    readonly 'deepseek-coder-v2': "deepseek-coder-v2";
+    readonly codegemma: "codegemma";
+    readonly starcoder2: "starcoder2";
+    readonly 'qwen2.5': "qwen2.5";
+    readonly 'qwen2.5:72b': "qwen2.5:72b";
+    readonly 'qwen2.5-coder': "qwen2.5-coder";
+    readonly qwen2: "qwen2";
+    readonly 'mistral-large': "mistral-large";
+    readonly 'mistral-nemo': "mistral-nemo";
+    readonly mistral: "mistral";
+    readonly mixtral: "mixtral";
+    readonly 'mixtral:8x7b': "mixtral:8x7b";
+    readonly 'llama3.3': "llama3.3";
+    readonly 'llama3.3:70b': "llama3.3:70b";
+    readonly 'llama3.2': "llama3.2";
+    readonly 'llama3.2:1b': "llama3.2:1b";
+    readonly 'llama3.2:3b': "llama3.2:3b";
+    readonly 'llama3.2-vision': "llama3.2-vision";
+    readonly 'llama3.1': "llama3.1";
+    readonly 'llama3.1:8b': "llama3.1:8b";
+    readonly 'llama3.1:70b': "llama3.1:70b";
+};
+/**
+ * Model alias type for convenient model selection
+ */
+export type OllamaModelAlias = keyof typeof OLLAMA_MODELS;
+/**
+ * Resolve a model alias or name (passthrough for Ollama since names are direct)
+ */
+export declare function resolveOllamaModel(modelOrAlias: string): string;
 /**
  * Ollama adapter for local models
  */
@@ -25,6 +124,32 @@ export declare class OllamaAdapter extends BaseLLMAdapter {
 }
 /**
  * Create an Ollama adapter
+ *
+ * @param model - Any model name that's been pulled via `ollama pull <model>`
+ *                Common models: llama3.3, mistral, qwen2.5, codellama
+ *                Run `ollama list` to see installed models.
+ *
+ * @example
+ * ```typescript
+ * // Using latest Llama model
+ * const adapter = createOllamaAdapter('llama3.3');
+ *
+ * // Using Mistral
+ * const adapter = createOllamaAdapter('mistral-large');
+ *
+ * // Using coding-focused model
+ * const adapter = createOllamaAdapter('qwen2.5-coder');
+ *
+ * // Using any custom or fine-tuned model
+ * const adapter = createOllamaAdapter('my-custom-model');
+ * ```
+ */
+export declare function createOllamaAdapter(model?: OllamaModelAlias | string, overrides?: Partial<OllamaConfig>): OllamaAdapter;
+/**
+ * List popular Ollama model aliases
  */
-export declare function createOllamaAdapter(model?: string, overrides?: Partial<OllamaConfig>): OllamaAdapter;
+export declare function listOllamaModels(): {
+    alias: string;
+    modelId: string;
+}[];
 //# sourceMappingURL=ollama.d.ts.map

package/dist/types/llm/adapters/ollama.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ollama.d.ts","sourceRoot":"","sources":["../../../../src/llm/adapters/ollama.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,WAAW,EACX,YAAY,EACZ,iBAAiB,EACjB,kBAAkB,EACnB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,cAAc,EAA4B,MAAM,WAAW,CAAC;AAuBrE;;GAEG;AACH,qBAAa,aAAc,SAAQ,cAAc;IAC/C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,MAAM,EAAE,YAAY;IAKhC,IAAI,QAAQ,IAAI,WAAW,CAE1B;IAED,YAAY,IAAI,OAAO;IAIjB,QAAQ,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IA+GvE;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAWrC;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;CAgBtC;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,SAAa,EAClB,SAAS,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAChC,aAAa,CAOf"}
+{"version":3,"file":"ollama.d.ts","sourceRoot":"","sources":["../../../../src/llm/adapters/ollama.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,WAAW,EACX,YAAY,EACZ,iBAAiB,EACjB,kBAAkB,EACnB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,cAAc,EAA4B,MAAM,WAAW,CAAC;AASrE;;;;GAIG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;CAUf,CAAC;AAEX;;;;;GAKG;AACH,eAAO,MAAM,cAAc;;;;;;CAMjB,CAAC;AAEX;;;;GAIG;AACH,eAAO,MAAM,WAAW;;;;;CAKd,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,aAAa;;;;;CAKhB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,YAAY;;;;;CAKf,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;CAMhB,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,OAAO,aAAa,CAAC;AAE1D;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAO/D;AAuBD;;GAEG;AACH,qBAAa,aAAc,SAAQ,cAAc;IAC/C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,MAAM,EAAE,YAAY;IAKhC,IAAI,QAAQ,IAAI,WAAW,CAE1B;IAED,YAAY,IAAI,OAAO;IAIjB,QAAQ,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IA+GvE;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAWrC;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;CAgBtC;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,GAAE,gBAAgB,GAAG,MAAmB,EAC7C,SAAS,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAChC,aAAa,CAOf;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,EAAE,CAKvE"}

package/dist/types/llm/adapters/openai.d.ts

@@ -1,10 +1,87 @@
 /**
  * OpenAI adapter for LLM integration
  *
+ * Supports all OpenAI models including GPT-5, o3, and GPT-4.1 families.
+ *
  * @packageDocumentation
  */
 import type { LLMProvider, OpenAIConfig, CompletionRequest, CompletionResponse } from '../../types/llm.js';
 import { BaseLLMAdapter } from './base.js';
+/**
+ * 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
+ */
+export declare const GPT_5_MODELS: {
+    readonly 'gpt-5': "gpt-5";
+    readonly 'gpt-5-mini': "gpt-5-mini";
+    readonly '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
+ */
+export declare const O_SERIES_MODELS: {
+    readonly o3: "o3";
+    readonly 'o3-pro': "o3-pro";
+    readonly 'o4-mini': "o4-mini";
+    readonly o1: "o1";
+};
+/**
+ * GPT-4.1 Models (2025)
+ * - Major gains in coding and instruction following
+ * - Up to 1M token context
+ */
+export declare const GPT_4_1_MODELS: {
+    readonly 'gpt-4.1': "gpt-4.1";
+    readonly 'gpt-4.1-mini': "gpt-4.1-mini";
+    readonly 'gpt-4.1-nano': "gpt-4.1-nano";
+};
+/**
+ * GPT-4o Models (2024-2025)
+ * - Optimized for speed and multimodal
+ */
+export declare const GPT_4O_MODELS: {
+    readonly 'gpt-4o': "gpt-4o";
+    readonly 'gpt-4o-mini': "gpt-4o-mini";
+};
+/**
+ * Legacy GPT-4 Models
+ */
+export declare const GPT_4_LEGACY_MODELS: {
+    readonly 'gpt-4-turbo': "gpt-4-turbo";
+    readonly 'gpt-4': "gpt-4";
+};
+/**
+ * All available OpenAI models
+ */
+export declare const OPENAI_MODELS: {
+    readonly 'gpt-4-turbo': "gpt-4-turbo";
+    readonly 'gpt-4': "gpt-4";
+    readonly 'gpt-4o': "gpt-4o";
+    readonly 'gpt-4o-mini': "gpt-4o-mini";
+    readonly 'gpt-4.1': "gpt-4.1";
+    readonly 'gpt-4.1-mini': "gpt-4.1-mini";
+    readonly 'gpt-4.1-nano': "gpt-4.1-nano";
+    readonly o3: "o3";
+    readonly 'o3-pro': "o3-pro";
+    readonly 'o4-mini': "o4-mini";
+    readonly o1: "o1";
+    readonly 'gpt-5': "gpt-5";
+    readonly 'gpt-5-mini': "gpt-5-mini";
+    readonly 'gpt-5-nano': "gpt-5-nano";
+};
+/**
+ * Model alias type for convenient model selection
+ */
+export type OpenAIModelAlias = keyof typeof OPENAI_MODELS;
+/**
+ * Resolve a model alias or ID to the full model ID
+ */
+export declare function resolveOpenAIModel(modelOrAlias: string): string;
 /**
  * OpenAI adapter for chat completions
  */
@@ -17,6 +94,32 @@ export declare class OpenAIAdapter extends BaseLLMAdapter {
 }
 /**
  * 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');
+ * ```
+ */
+export declare function createOpenAIAdapter(model?: OpenAIModelAlias | string, overrides?: Partial<OpenAIConfig>): OpenAIAdapter;
+/**
+ * List all available OpenAI model aliases
  */
-export declare function createOpenAIAdapter(model?: string, overrides?: Partial<OpenAIConfig>): OpenAIAdapter;
+export declare function listOpenAIModels(): {
+    alias: string;
+    modelId: string;
+}[];
 //# sourceMappingURL=openai.d.ts.map

package/dist/types/llm/adapters/openai.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"openai.d.ts","sourceRoot":"","sources":["../../../../src/llm/adapters/openai.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,WAAW,EACX,YAAY,EACZ,iBAAiB,EACjB,kBAAkB,EACnB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,cAAc,EAA4B,MAAM,WAAW,CAAC;AAuCrE;;GAEG;AACH,qBAAa,aAAc,SAAQ,cAAc;IAC/C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAS;gBAE3B,MAAM,EAAE,YAAY;IAQhC,IAAI,QAAQ,IAAI,WAAW,CAE1B;IAEK,QAAQ,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC;CAuGxE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,SAAW,EAChB,SAAS,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAChC,aAAa,CAcf"}
+{"version":3,"file":"openai.d.ts","sourceRoot":"","sources":["../../../../src/llm/adapters/openai.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,WAAW,EACX,YAAY,EACZ,iBAAiB,EACjB,kBAAkB,EACnB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,cAAc,EAA4B,MAAM,WAAW,CAAC;AAQrE;;;;;GAKG;AACH,eAAO,MAAM,YAAY;;;;CAIf,CAAC;AAEX;;;;;GAKG;AACH,eAAO,MAAM,eAAe;;;;;CAKlB,CAAC;AAEX;;;;GAIG;AACH,eAAO,MAAM,cAAc;;;;CAIjB,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,aAAa;;;CAGhB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;CAGtB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;CAMhB,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,OAAO,aAAa,CAAC;AAE1D;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAO/D;AAuCD;;GAEG;AACH,qBAAa,aAAc,SAAQ,cAAc;IAC/C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAS;gBAE3B,MAAM,EAAE,YAAY;IAQhC,IAAI,QAAQ,IAAI,WAAW,CAE1B;IAEK,QAAQ,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC;CAuGxE;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,GAAE,gBAAgB,GAAG,MAAiB,EAC3C,SAAS,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAChC,aAAa,CAcf;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,EAAE,CAKvE"}

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"}