learngraph 0.2.0 → 0.4.0

package/README.md

@@ -156,6 +156,81 @@ await storage.connect({
 });
 ```
 
+## LLM-Powered Curriculum Decomposition
+
+LearnGraph can automatically decompose curriculum content into skill graphs using LLMs:
+
+```typescript
+import { createOpenAIAdapter, createOrchestrator } from 'learngraph/llm';
+
+// Create an adapter (OpenAI, Anthropic, or Ollama)
+const adapter = createOpenAIAdapter('gpt-4o');
+const orchestrator = createOrchestrator(adapter);
+
+// Extract skills from curriculum content
+const extraction = await orchestrator.extractSkills({
+  content: `
+    Chapter 1: Introduction to Calculus
+    - Understand the concept of limits
+    - Calculate derivatives using the power rule
+    - Apply differentiation to real-world problems
+  `,
+  domain: 'Mathematics',
+  gradeLevel: 'College',
+});
+
+console.log(extraction.skills);
+// [{ name: 'Limits', bloomLevel: 'understand', ... }, ...]
+
+// Infer prerequisites between skills
+const prerequisites = await orchestrator.inferPrerequisites({
+  skills: extraction.skills,
+  domain: 'Mathematics',
+});
+
+// Full decomposition: skills + prerequisites in one call
+const decomposition = await orchestrator.decompose({
+  content: 'Full calculus syllabus here...',
+  title: 'Calculus I',
+  domain: 'Mathematics',
+});
+
+// Returns: { title, skills, prerequisites, skillInputs }
+// skillInputs are ready to insert into storage
+```
+
+### Supported LLM Providers
+
+```typescript
+import {
+  createOpenAIAdapter,    // GPT-4o, GPT-4, GPT-3.5
+  createAnthropicAdapter, // Claude 3.5, Claude 3
+  createOllamaAdapter,    // Llama, Mistral, etc.
+} from 'learngraph/llm';
+
+// OpenAI (set OPENAI_API_KEY env var)
+const openai = createOpenAIAdapter('gpt-4o');
+
+// Anthropic (set ANTHROPIC_API_KEY env var)
+const anthropic = createAnthropicAdapter('claude-3-5-sonnet-20241022');
+
+// Ollama (local models, no API key needed)
+const ollama = createOllamaAdapter('llama3.2');
+```
+
+### Bloom's Taxonomy Analysis
+
+Analyze the cognitive level of learning objectives:
+
+```typescript
+const analysis = await orchestrator.analyzeBloomLevel({
+  text: 'Compare and contrast mitosis and meiosis',
+});
+
+console.log(analysis);
+// { level: 'analyze', confidence: 0.9, indicators: ['compare', 'contrast'] }
+```
+
 ## Submodule Exports
 
 ```typescript
@@ -166,7 +241,13 @@ import { SkillNode, SkillEdge } from 'learngraph';
 import { MemoryStorage, LevelGraphStorage, Neo4jStorage } from 'learngraph/storage';
 
 // LLM integration for curriculum decomposition
-import { LLMProvider } from 'learngraph/llm';
+import {
+  createOpenAIAdapter,
+  createAnthropicAdapter,
+  createOllamaAdapter,
+  createOrchestrator,
+  LLMOrchestrator,
+} from 'learngraph/llm';
 
 // Query builders and ZPD calculation
 import { ZPDResult, LearningPath } from 'learngraph/query';

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

@@ -0,0 +1,124 @@
+"use strict";
+/**
+ * Anthropic adapter for LLM integration
+ *
+ * @packageDocumentation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AnthropicAdapter = void 0;
+exports.createAnthropicAdapter = createAnthropicAdapter;
+const base_js_1 = require("./base.js");
+/**
+ * Anthropic adapter for Claude models
+ */
+class AnthropicAdapter extends base_js_1.BaseLLMAdapter {
+    baseUrl;
+    constructor(config) {
+        super(config);
+        this.baseUrl = config.baseUrl ?? 'https://api.anthropic.com/v1';
+    }
+    get provider() {
+        return 'anthropic';
+    }
+    async complete(request) {
+        if (!this.isConfigured()) {
+            throw new base_js_1.LLMError('Anthropic adapter not configured. Set ANTHROPIC_API_KEY or pass apiKey in config.', 'NOT_CONFIGURED', this.provider);
+        }
+        return this.withRetry(async () => {
+            // Extract system message
+            const systemMessage = request.messages.find((m) => m.role === 'system');
+            const otherMessages = request.messages.filter((m) => m.role !== 'system');
+            const headers = {
+                'Content-Type': 'application/json',
+                'x-api-key': this.config.apiKey,
+                'anthropic-version': '2023-06-01',
+            };
+            const body = {
+                model: this.config.model,
+                messages: otherMessages.map((m) => ({
+                    role: m.role,
+                    content: m.content,
+                })),
+                max_tokens: request.maxTokens ?? this.config.maxTokens ?? base_js_1.DEFAULT_CONFIG.maxTokens,
+            };
+            // Add system message if present
+            if (systemMessage) {
+                body.system = systemMessage.content;
+            }
+            // Temperature (Anthropic uses 0-1 scale like OpenAI)
+            const temp = request.temperature ?? this.config.temperature ?? base_js_1.DEFAULT_CONFIG.temperature;
+            if (temp !== undefined) {
+                body.temperature = temp;
+            }
+            const controller = new AbortController();
+            const timeout = setTimeout(() => controller.abort(), this.config.timeout ?? base_js_1.DEFAULT_CONFIG.timeout);
+            try {
+                const response = await fetch(`${this.baseUrl}/messages`, {
+                    method: 'POST',
+                    headers,
+                    body: JSON.stringify(body),
+                    signal: controller.signal,
+                });
+                clearTimeout(timeout);
+                if (!response.ok) {
+                    const errorData = (await response.json().catch(() => ({})));
+                    const errorMessage = errorData.error?.message ?? `HTTP ${response.status}`;
+                    if (response.status === 429) {
+                        throw new base_js_1.LLMError(`Rate limit exceeded: ${errorMessage}`, 'RATE_LIMIT', this.provider);
+                    }
+                    throw new base_js_1.LLMError(`Anthropic API error: ${errorMessage}`, 'API_ERROR', this.provider);
+                }
+                const data = (await response.json());
+                // Get text content
+                const textBlock = data.content.find((block) => block.type === 'text');
+                const content = textBlock?.text ?? '';
+                let json;
+                if (request.responseFormat === 'json') {
+                    json = this.parseJSON(content);
+                }
+                return {
+                    content,
+                    json,
+                    usage: {
+                        promptTokens: data.usage.input_tokens,
+                        completionTokens: data.usage.output_tokens,
+                        totalTokens: data.usage.input_tokens + data.usage.output_tokens,
+                    },
+                    model: data.model,
+                    finishReason: data.stop_reason === 'end_turn' ? 'stop' :
+                        data.stop_reason === 'max_tokens' ? 'length' : 'error',
+                };
+            }
+            catch (error) {
+                clearTimeout(timeout);
+                if (error instanceof base_js_1.LLMError) {
+                    throw error;
+                }
+                if (error instanceof Error) {
+                    if (error.name === 'AbortError') {
+                        throw new base_js_1.LLMError('Request timeout', 'TIMEOUT', this.provider, error);
+                    }
+                    throw new base_js_1.LLMError(`Network error: ${error.message}`, 'NETWORK_ERROR', this.provider, error);
+                }
+                throw new base_js_1.LLMError('Unknown error', 'API_ERROR', this.provider);
+            }
+        });
+    }
+}
+exports.AnthropicAdapter = AnthropicAdapter;
+/**
+ * Create an Anthropic adapter from environment variables
+ */
+function createAnthropicAdapter(model = 'claude-3-5-sonnet-20241022', overrides) {
+    const apiKey = typeof process !== 'undefined' ? process.env.ANTHROPIC_API_KEY : undefined;
+    const config = {
+        provider: 'anthropic',
+        model,
+        ...overrides,
+    };
+    if (apiKey) {
+        config.apiKey = apiKey;
+    }
+    return new AnthropicAdapter(config);
+}
+//# sourceMappingURL=anthropic.js.map

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

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

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

@@ -0,0 +1,100 @@
+"use strict";
+/**
+ * Base adapter class for LLM providers
+ *
+ * @packageDocumentation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseLLMAdapter = exports.DEFAULT_CONFIG = exports.LLMError = void 0;
+/**
+ * LLM-related errors
+ */
+class LLMError extends Error {
+    code;
+    provider;
+    cause;
+    constructor(message, code, provider, cause) {
+        super(message);
+        this.code = code;
+        this.provider = provider;
+        this.cause = cause;
+        this.name = 'LLMError';
+    }
+}
+exports.LLMError = LLMError;
+/**
+ * Default configuration values
+ */
+exports.DEFAULT_CONFIG = {
+    maxTokens: 4096,
+    temperature: 0.3,
+    timeout: 60000,
+    retries: 2,
+};
+/**
+ * Abstract base class for LLM adapters
+ */
+class BaseLLMAdapter {
+    config;
+    constructor(config) {
+        this.config = {
+            ...exports.DEFAULT_CONFIG,
+            ...config,
+        };
+    }
+    get model() {
+        return this.config.model;
+    }
+    isConfigured() {
+        if (this.provider === 'ollama') {
+            return !!this.config.model;
+        }
+        return !!this.config.apiKey && !!this.config.model;
+    }
+    getConfig() {
+        const { apiKey: _, ...rest } = this.config;
+        return rest;
+    }
+    /**
+     * Retry a function with exponential backoff
+     */
+    async withRetry(fn, maxRetries = this.config.retries ?? exports.DEFAULT_CONFIG.retries) {
+        let lastError;
+        for (let attempt = 0; attempt <= maxRetries; attempt++) {
+            try {
+                return await fn();
+            }
+            catch (error) {
+                lastError = error instanceof Error ? error : new Error(String(error));
+                // Don't retry on certain errors
+                if (error instanceof LLMError) {
+                    if (error.code === 'NOT_CONFIGURED' || error.code === 'INVALID_RESPONSE') {
+                        throw error;
+                    }
+                }
+                if (attempt < maxRetries) {
+                    // Exponential backoff: 1s, 2s, 4s, ...
+                    const delay = Math.pow(2, attempt) * 1000;
+                    await new Promise((resolve) => setTimeout(resolve, delay));
+                }
+            }
+        }
+        throw lastError;
+    }
+    /**
+     * Parse JSON from LLM response, handling common issues
+     */
+    parseJSON(content) {
+        // Try to extract JSON from markdown code blocks
+        const jsonMatch = content.match(/```(?:json)?\s*([\s\S]*?)```/);
+        const jsonStr = jsonMatch && jsonMatch[1] ? jsonMatch[1].trim() : content.trim();
+        try {
+            return JSON.parse(jsonStr);
+        }
+        catch (error) {
+            throw new LLMError(`Failed to parse JSON response: ${error instanceof Error ? error.message : 'Unknown error'}`, 'PARSE_ERROR', this.provider, error instanceof Error ? error : undefined);
+        }
+    }
+}
+exports.BaseLLMAdapter = BaseLLMAdapter;
+//# sourceMappingURL=base.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../../../src/llm/adapters/base.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAUH;;GAEG;AACH,MAAa,QAAS,SAAQ,KAAK;IAGf;IACA;IACA;IAJlB,YACE,OAAe,EACC,IAAkB,EAClB,QAAqB,EACrB,KAAa;QAE7B,KAAK,CAAC,OAAO,CAAC,CAAC;QAJC,SAAI,GAAJ,IAAI,CAAc;QAClB,aAAQ,GAAR,QAAQ,CAAa;QACrB,UAAK,GAAL,KAAK,CAAQ;QAG7B,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;IACzB,CAAC;CACF;AAVD,4BAUC;AAWD;;GAEG;AACU,QAAA,cAAc,GAAG;IAC5B,SAAS,EAAE,IAAI;IACf,WAAW,EAAE,GAAG;IAChB,OAAO,EAAE,KAAK;IACd,OAAO,EAAE,CAAC;CACX,CAAC;AAEF;;GAEG;AACH,MAAsB,cAAc;IACxB,MAAM,CAAY;IAE5B,YAAY,MAAiB;QAC3B,IAAI,CAAC,MAAM,GAAG;YACZ,GAAG,sBAAc;YACjB,GAAG,MAAM;SACV,CAAC;IACJ,CAAC;IAID,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;IAC3B,CAAC;IAID,YAAY;QACV,IAAI,IAAI,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;YAC/B,OAAO,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;QAC7B,CAAC;QACD,OAAO,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;IACrD,CAAC;IAED,SAAS;QACP,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC;QAC3C,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACO,KAAK,CAAC,SAAS,CACvB,EAAoB,EACpB,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,sBAAc,CAAC,OAAO;QAE1D,IAAI,SAA4B,CAAC;QAEjC,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,UAAU,EAAE,OAAO,EAAE,EAAE,CAAC;YACvD,IAAI,CAAC;gBACH,OAAO,MAAM,EAAE,EAAE,CAAC;YACpB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,SAAS,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;gBAEtE,gCAAgC;gBAChC,IAAI,KAAK,YAAY,QAAQ,EAAE,CAAC;oBAC9B,IAAI,KAAK,CAAC,IAAI,KAAK,gBAAgB,IAAI,KAAK,CAAC,IAAI,KAAK,kBAAkB,EAAE,CAAC;wBACzE,MAAM,KAAK,CAAC;oBACd,CAAC;gBACH,CAAC;gBAED,IAAI,OAAO,GAAG,UAAU,EAAE,CAAC;oBACzB,uCAAuC;oBACvC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;oBAC1C,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;gBAC7D,CAAC;YACH,CAAC;QACH,CAAC;QAED,MAAM,SAAS,CAAC;IAClB,CAAC;IAED;;OAEG;IACO,SAAS,CAAI,OAAe;QACpC,gDAAgD;QAChD,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,8BAA8B,CAAC,CAAC;QAChE,MAAM,OAAO,GAAG,SAAS,IAAI,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;QAEjF,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAM,CAAC;QAClC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,QAAQ,CAChB,kCAAkC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,EAAE,EAC5F,aAAa,EACb,IAAI,CAAC,QAAQ,EACb,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAC3C,CAAC;QACJ,CAAC;IACH,CAAC;CACF;AAlFD,wCAkFC"}

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

@@ -0,0 +1,156 @@
+"use strict";
+/**
+ * Google Gemini LLM adapter
+ *
+ * @packageDocumentation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GeminiAdapter = void 0;
+exports.createGeminiAdapter = createGeminiAdapter;
+const base_js_1 = require("./base.js");
+/**
+ * Adapter for Google Gemini models
+ *
+ * Supports:
+ * - gemini-2.0-flash-exp
+ * - gemini-1.5-pro
+ * - gemini-1.5-flash
+ * - gemini-1.0-pro
+ */
+class GeminiAdapter extends base_js_1.BaseLLMAdapter {
+    baseUrl;
+    constructor(config) {
+        super(config);
+        // Use Google AI Studio API by default
+        this.baseUrl =
+            config.baseUrl ?? 'https://generativelanguage.googleapis.com/v1beta';
+    }
+    get provider() {
+        return 'gemini';
+    }
+    async complete(request) {
+        if (!this.isConfigured()) {
+            throw new base_js_1.LLMError('Gemini adapter is not configured. Set GOOGLE_API_KEY or GEMINI_API_KEY environment variable.', 'NOT_CONFIGURED', this.provider);
+        }
+        const geminiRequest = this.buildRequest(request);
+        try {
+            const response = await this.executeRequest(geminiRequest);
+            return this.parseResponse(response);
+        }
+        catch (error) {
+            if (error instanceof base_js_1.LLMError) {
+                throw error;
+            }
+            throw new base_js_1.LLMError(`Gemini API request failed: ${error instanceof Error ? error.message : 'Unknown error'}`, 'API_ERROR', this.provider, error instanceof Error ? error : undefined);
+        }
+    }
+    buildRequest(request) {
+        const geminiRequest = {
+            contents: [],
+            generationConfig: {
+                maxOutputTokens: request.maxTokens ?? this.config.maxTokens ?? 4096,
+                temperature: request.temperature ?? this.config.temperature ?? 0.3,
+            },
+        };
+        // Handle JSON response format
+        if (request.responseFormat === 'json') {
+            geminiRequest.generationConfig.responseMimeType = 'application/json';
+        }
+        // Convert messages to Gemini format
+        for (const message of request.messages) {
+            if (message.role === 'system') {
+                // Gemini uses systemInstruction for system messages
+                geminiRequest.systemInstruction = {
+                    parts: [{ text: message.content }],
+                };
+            }
+            else {
+                geminiRequest.contents.push({
+                    role: message.role === 'assistant' ? 'model' : 'user',
+                    parts: [{ text: message.content }],
+                });
+            }
+        }
+        return geminiRequest;
+    }
+    async executeRequest(request) {
+        const url = `${this.baseUrl}/models/${this.config.model}:generateContent?key=${this.config.apiKey}`;
+        const response = await fetch(url, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify(request),
+            signal: AbortSignal.timeout(this.config.timeout ?? 60000),
+        });
+        if (!response.ok) {
+            const errorBody = await response.text();
+            let errorMessage = `HTTP ${response.status}`;
+            try {
+                const errorJson = JSON.parse(errorBody);
+                errorMessage = errorJson.error?.message ?? errorMessage;
+            }
+            catch {
+                errorMessage = errorBody || errorMessage;
+            }
+            if (response.status === 429) {
+                throw new base_js_1.LLMError(`Rate limit exceeded: ${errorMessage}`, 'RATE_LIMIT', this.provider);
+            }
+            throw new base_js_1.LLMError(`Gemini API error: ${errorMessage}`, 'API_ERROR', this.provider);
+        }
+        return response.json();
+    }
+    parseResponse(response) {
+        if (!response.candidates || response.candidates.length === 0) {
+            throw new base_js_1.LLMError('No candidates in Gemini response', 'INVALID_RESPONSE', this.provider);
+        }
+        const candidate = response.candidates[0];
+        if (!candidate) {
+            throw new base_js_1.LLMError('No candidate in Gemini response', 'INVALID_RESPONSE', this.provider);
+        }
+        const content = candidate.content.parts.map((p) => p.text).join('');
+        // Try to parse JSON if present
+        let json;
+        try {
+            json = this.parseJSON(content);
+        }
+        catch {
+            // Not JSON, that's fine
+        }
+        // Map Gemini finish reasons to our standard format
+        const finishReason = candidate.finishReason === 'STOP' ? 'stop' :
+            candidate.finishReason === 'MAX_TOKENS' ? 'length' :
+                candidate.finishReason === 'SAFETY' ? 'content_filter' : 'stop';
+        return {
+            content,
+            json,
+            usage: {
+                promptTokens: response.usageMetadata?.promptTokenCount ?? 0,
+                completionTokens: response.usageMetadata?.candidatesTokenCount ?? 0,
+                totalTokens: response.usageMetadata?.totalTokenCount ?? 0,
+            },
+            model: this.config.model,
+            finishReason,
+        };
+    }
+}
+exports.GeminiAdapter = GeminiAdapter;
+/**
+ * Create a Gemini adapter from environment variables
+ */
+function createGeminiAdapter(model = 'gemini-2.0-flash-exp', overrides) {
+    // Support both GOOGLE_API_KEY and GEMINI_API_KEY
+    const apiKey = typeof process !== 'undefined'
+        ? process.env.GOOGLE_API_KEY ?? process.env.GEMINI_API_KEY
+        : undefined;
+    const config = {
+        provider: 'gemini',
+        model,
+        ...overrides,
+    };
+    if (apiKey) {
+        config.apiKey = apiKey;
+    }
+    return new GeminiAdapter(config);
+}
+//# sourceMappingURL=gemini.js.map

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

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

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

@@ -0,0 +1,33 @@
+"use strict";
+/**
+ * LLM adapter exports
+ *
+ * @packageDocumentation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MEDIAPIPE_MODELS = exports.createMediaPipeAdapter = exports.MediaPipeAdapter = exports.OPENROUTER_MODELS = exports.createOpenRouterAdapter = exports.OpenRouterAdapter = exports.createGeminiAdapter = exports.GeminiAdapter = exports.createOllamaAdapter = exports.OllamaAdapter = exports.createAnthropicAdapter = exports.AnthropicAdapter = exports.createOpenAIAdapter = exports.OpenAIAdapter = exports.DEFAULT_CONFIG = exports.LLMError = exports.BaseLLMAdapter = void 0;
+var base_js_1 = require("./base.js");
+Object.defineProperty(exports, "BaseLLMAdapter", { enumerable: true, get: function () { return base_js_1.BaseLLMAdapter; } });
+Object.defineProperty(exports, "LLMError", { enumerable: true, get: function () { return base_js_1.LLMError; } });
+Object.defineProperty(exports, "DEFAULT_CONFIG", { enumerable: true, get: function () { return base_js_1.DEFAULT_CONFIG; } });
+var openai_js_1 = require("./openai.js");
+Object.defineProperty(exports, "OpenAIAdapter", { enumerable: true, get: function () { return openai_js_1.OpenAIAdapter; } });
+Object.defineProperty(exports, "createOpenAIAdapter", { enumerable: true, get: function () { return openai_js_1.createOpenAIAdapter; } });
+var anthropic_js_1 = require("./anthropic.js");
+Object.defineProperty(exports, "AnthropicAdapter", { enumerable: true, get: function () { return anthropic_js_1.AnthropicAdapter; } });
+Object.defineProperty(exports, "createAnthropicAdapter", { enumerable: true, get: function () { return anthropic_js_1.createAnthropicAdapter; } });
+var ollama_js_1 = require("./ollama.js");
+Object.defineProperty(exports, "OllamaAdapter", { enumerable: true, get: function () { return ollama_js_1.OllamaAdapter; } });
+Object.defineProperty(exports, "createOllamaAdapter", { enumerable: true, get: function () { return ollama_js_1.createOllamaAdapter; } });
+var gemini_js_1 = require("./gemini.js");
+Object.defineProperty(exports, "GeminiAdapter", { enumerable: true, get: function () { return gemini_js_1.GeminiAdapter; } });
+Object.defineProperty(exports, "createGeminiAdapter", { enumerable: true, get: function () { return gemini_js_1.createGeminiAdapter; } });
+var openrouter_js_1 = require("./openrouter.js");
+Object.defineProperty(exports, "OpenRouterAdapter", { enumerable: true, get: function () { return openrouter_js_1.OpenRouterAdapter; } });
+Object.defineProperty(exports, "createOpenRouterAdapter", { enumerable: true, get: function () { return openrouter_js_1.createOpenRouterAdapter; } });
+Object.defineProperty(exports, "OPENROUTER_MODELS", { enumerable: true, get: function () { return openrouter_js_1.OPENROUTER_MODELS; } });
+var mediapipe_js_1 = require("./mediapipe.js");
+Object.defineProperty(exports, "MediaPipeAdapter", { enumerable: true, get: function () { return mediapipe_js_1.MediaPipeAdapter; } });
+Object.defineProperty(exports, "createMediaPipeAdapter", { enumerable: true, get: function () { return mediapipe_js_1.createMediaPipeAdapter; } });
+Object.defineProperty(exports, "MEDIAPIPE_MODELS", { enumerable: true, get: function () { return mediapipe_js_1.MEDIAPIPE_MODELS; } });
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/llm/adapters/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEH,qCAAqE;AAA5D,yGAAA,cAAc,OAAA;AAAE,mGAAA,QAAQ,OAAA;AAAE,yGAAA,cAAc,OAAA;AAGjD,yCAAiE;AAAxD,0GAAA,aAAa,OAAA;AAAE,gHAAA,mBAAmB,OAAA;AAC3C,+CAA0E;AAAjE,gHAAA,gBAAgB,OAAA;AAAE,sHAAA,sBAAsB,OAAA;AACjD,yCAAiE;AAAxD,0GAAA,aAAa,OAAA;AAAE,gHAAA,mBAAmB,OAAA;AAC3C,yCAAiE;AAAxD,0GAAA,aAAa,OAAA;AAAE,gHAAA,mBAAmB,OAAA;AAC3C,iDAAgG;AAAvF,kHAAA,iBAAiB,OAAA;AAAE,wHAAA,uBAAuB,OAAA;AAAE,kHAAA,iBAAiB,OAAA;AACtE,+CAA4F;AAAnF,gHAAA,gBAAgB,OAAA;AAAE,sHAAA,sBAAsB,OAAA;AAAE,gHAAA,gBAAgB,OAAA"}