learngraph 0.2.0 → 0.4.0

package/dist/esm/llm/prompts.js

@@ -0,0 +1,360 @@
+/**
+ * Prompts for LLM-based educational tasks
+ *
+ * @packageDocumentation
+ */
+// ─────────────────────────────────────────────────────────────────────────────
+// System Prompts
+// ─────────────────────────────────────────────────────────────────────────────
+export const SYSTEM_PROMPTS = {
+    skillExtraction: `You are an expert educational curriculum analyst specializing in competency-based education and learning science.
+
+Your task is to analyze curriculum content and extract discrete, measurable skills that learners should master.
+
+For each skill you identify:
+1. Name: A concise, action-oriented name (e.g., "Calculate derivative of polynomial")
+2. Description: A clear explanation of what mastery of this skill looks like
+3. Bloom's Level: Classify using Bloom's Taxonomy (remember, understand, apply, analyze, evaluate, create)
+4. Difficulty: Estimate difficulty on a 0-1 scale based on cognitive complexity
+5. Threshold Concept: Identify if this is a transformative "gateway" skill that changes understanding
+6. Estimated Time: How long a typical learner needs to achieve mastery
+
+Focus on:
+- Observable, measurable outcomes
+- Skills that can be assessed
+- Appropriate granularity (not too broad, not too narrow)
+- Clear prerequisite relationships
+
+Bloom's Level Guidelines:
+- remember (0.20): Recall facts, terms, basic concepts
+- understand (0.35): Explain ideas, interpret, summarize
+- apply (0.50): Use information in new situations, solve problems
+- analyze (0.65): Draw connections, organize, compare, contrast
+- evaluate (0.80): Justify decisions, make judgments, critique
+- create (0.90): Produce new work, design, construct`,
+    prerequisiteInference: `You are an expert in learning science and curriculum design, specializing in prerequisite mapping and learning path optimization.
+
+Your task is to analyze skills and infer prerequisite relationships between them.
+
+For each prerequisite relationship:
+1. Identify which skill must be learned first (source/prerequisite)
+2. Identify which skill depends on it (target/dependent)
+3. Classify the relationship type:
+   - hard: Absolutely required - cannot learn target without source
+   - soft: Strongly beneficial but not strictly required
+   - recommended: Helpful for optimal learning path
+4. Estimate strength (0-1): How critical is this prerequisite?
+5. Provide clear reasoning for the relationship
+
+Consider:
+- Bloom's level progression (lower levels typically prerequisite to higher)
+- Conceptual dependencies (foundational concepts before advanced)
+- Skill hierarchies within domains
+- Transfer of learning between related skills
+- Avoid circular dependencies`,
+    bloomAnalysis: `You are an expert in Bloom's Taxonomy and educational assessment design.
+
+Analyze the given text and determine its cognitive level according to Bloom's Taxonomy:
+
+1. remember - Recall facts and basic concepts
+   Verbs: define, identify, list, name, recall, recognize, state
+
+2. understand - Explain ideas or concepts
+   Verbs: describe, explain, interpret, summarize, classify, compare
+
+3. apply - Use information in new situations
+   Verbs: apply, calculate, solve, demonstrate, implement, use
+
+4. analyze - Draw connections among ideas
+   Verbs: analyze, compare, contrast, differentiate, examine, organize
+
+5. evaluate - Justify a decision or course of action
+   Verbs: evaluate, assess, critique, judge, justify, recommend
+
+6. create - Produce new or original work
+   Verbs: create, design, develop, construct, formulate, produce
+
+Provide:
+- The Bloom's level
+- Confidence score (0-1)
+- Key indicators (verbs/phrases) that led to this classification
+- Brief reasoning`,
+    curriculumDecomposition: `You are an expert curriculum designer and learning scientist.
+
+Your task is to decompose curriculum content into a structured skill graph suitable for adaptive learning systems.
+
+Process:
+1. Identify the overall learning goals and outcomes
+2. Break down content into discrete, measurable skills
+3. Classify each skill by Bloom's level and difficulty
+4. Identify threshold concepts (transformative gateway skills)
+5. Map prerequisite relationships between skills
+6. Ensure appropriate granularity for personalized learning
+
+Output a complete skill graph with:
+- Skills: Name, description, Bloom's level, difficulty, estimated time
+- Prerequisites: Source skill, target skill, type, strength, reasoning
+
+Principles:
+- Every skill should be assessable
+- Skills should be at appropriate granularity (15-45 min to master)
+- Clear progression from foundational to advanced
+- Identify threshold concepts that unlock new understanding
+- Consider both hard prerequisites (required) and soft (beneficial)`,
+};
+// ─────────────────────────────────────────────────────────────────────────────
+// JSON Schemas for Structured Output
+// ─────────────────────────────────────────────────────────────────────────────
+export const EXTRACTION_SCHEMA = {
+    type: 'object',
+    properties: {
+        skills: {
+            type: 'array',
+            items: {
+                type: 'object',
+                properties: {
+                    name: { type: 'string', description: 'Concise, action-oriented skill name' },
+                    description: { type: 'string', description: 'What mastery of this skill looks like' },
+                    bloomLevel: {
+                        type: 'string',
+                        enum: ['remember', 'understand', 'apply', 'analyze', 'evaluate', 'create'],
+                        description: "Bloom's Taxonomy level",
+                    },
+                    difficulty: {
+                        type: 'number',
+                        minimum: 0,
+                        maximum: 1,
+                        description: 'Difficulty on 0-1 scale',
+                    },
+                    confidence: {
+                        type: 'number',
+                        minimum: 0,
+                        maximum: 1,
+                        description: 'Confidence in this extraction',
+                    },
+                    isThresholdConcept: {
+                        type: 'boolean',
+                        description: 'Is this a transformative gateway skill?',
+                    },
+                    estimatedMinutes: {
+                        type: 'number',
+                        description: 'Estimated time to master in minutes',
+                    },
+                    keywords: {
+                        type: 'array',
+                        items: { type: 'string' },
+                        description: 'Associated keywords/concepts',
+                    },
+                    reasoning: {
+                        type: 'string',
+                        description: 'Why this skill was extracted',
+                    },
+                },
+                required: ['name', 'description', 'bloomLevel', 'difficulty', 'confidence'],
+            },
+        },
+        warnings: {
+            type: 'array',
+            items: { type: 'string' },
+            description: 'Any warnings or notes about the extraction',
+        },
+    },
+    required: ['skills'],
+};
+export const PREREQUISITE_SCHEMA = {
+    type: 'object',
+    properties: {
+        prerequisites: {
+            type: 'array',
+            items: {
+                type: 'object',
+                properties: {
+                    sourceId: { type: 'string', description: 'ID of the prerequisite skill' },
+                    targetId: { type: 'string', description: 'ID of the dependent skill' },
+                    strength: {
+                        type: 'number',
+                        minimum: 0,
+                        maximum: 1,
+                        description: 'How critical is this prerequisite (0-1)',
+                    },
+                    type: {
+                        type: 'string',
+                        enum: ['hard', 'soft', 'recommended'],
+                        description: 'Type of prerequisite relationship',
+                    },
+                    confidence: {
+                        type: 'number',
+                        minimum: 0,
+                        maximum: 1,
+                        description: 'Confidence in this inference',
+                    },
+                    reasoning: {
+                        type: 'string',
+                        description: 'Why this prerequisite relationship exists',
+                    },
+                },
+                required: ['sourceId', 'targetId', 'strength', 'type', 'confidence', 'reasoning'],
+            },
+        },
+    },
+    required: ['prerequisites'],
+};
+export const BLOOM_ANALYSIS_SCHEMA = {
+    type: 'object',
+    properties: {
+        level: {
+            type: 'string',
+            enum: ['remember', 'understand', 'apply', 'analyze', 'evaluate', 'create'],
+            description: "Detected Bloom's level",
+        },
+        confidence: {
+            type: 'number',
+            minimum: 0,
+            maximum: 1,
+            description: 'Confidence in detection',
+        },
+        indicators: {
+            type: 'array',
+            items: { type: 'string' },
+            description: 'Key verbs/phrases indicating this level',
+        },
+        reasoning: {
+            type: 'string',
+            description: 'Explanation for the classification',
+        },
+    },
+    required: ['level', 'confidence', 'indicators', 'reasoning'],
+};
+export const DECOMPOSITION_SCHEMA = {
+    type: 'object',
+    properties: {
+        title: { type: 'string', description: 'Course/curriculum title' },
+        skills: {
+            type: 'array',
+            items: {
+                type: 'object',
+                properties: {
+                    id: { type: 'string', description: 'Unique skill identifier' },
+                    name: { type: 'string' },
+                    description: { type: 'string' },
+                    bloomLevel: {
+                        type: 'string',
+                        enum: ['remember', 'understand', 'apply', 'analyze', 'evaluate', 'create'],
+                    },
+                    difficulty: { type: 'number', minimum: 0, maximum: 1 },
+                    isThresholdConcept: { type: 'boolean' },
+                    estimatedMinutes: { type: 'number' },
+                    keywords: { type: 'array', items: { type: 'string' } },
+                },
+                required: ['id', 'name', 'description', 'bloomLevel', 'difficulty'],
+            },
+        },
+        prerequisites: {
+            type: 'array',
+            items: {
+                type: 'object',
+                properties: {
+                    sourceId: { type: 'string' },
+                    targetId: { type: 'string' },
+                    strength: { type: 'number', minimum: 0, maximum: 1 },
+                    type: { type: 'string', enum: ['hard', 'soft', 'recommended'] },
+                    reasoning: { type: 'string' },
+                },
+                required: ['sourceId', 'targetId', 'strength', 'type'],
+            },
+        },
+        warnings: {
+            type: 'array',
+            items: { type: 'string' },
+        },
+    },
+    required: ['title', 'skills', 'prerequisites'],
+};
+// ─────────────────────────────────────────────────────────────────────────────
+// Prompt Builders
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Build a skill extraction prompt
+ */
+export function buildExtractionPrompt(content, options) {
+    let prompt = `Analyze the following curriculum content and extract all discrete, measurable skills.\n\n`;
+    if (options?.domain) {
+        prompt += `Domain: ${options.domain}\n`;
+    }
+    if (options?.gradeLevel) {
+        prompt += `Target Audience: ${options.gradeLevel}\n`;
+    }
+    if (options?.context) {
+        prompt += `Additional Context: ${options.context}\n`;
+    }
+    prompt += `\n--- CURRICULUM CONTENT ---\n${content}\n--- END CONTENT ---\n\n`;
+    prompt += `Extract all skills from this content. For each skill, provide name, description, Bloom's level, difficulty (0-1), and identify if it's a threshold concept.`;
+    return prompt;
+}
+/**
+ * Build a prerequisite inference prompt
+ */
+export function buildPrerequisitePrompt(skills, options) {
+    let prompt = `Analyze the following skills and infer prerequisite relationships between them.\n\n`;
+    if (options?.domain) {
+        prompt += `Domain: ${options.domain}\n`;
+    }
+    prompt += `\n--- SKILLS ---\n`;
+    for (const skill of skills) {
+        prompt += `ID: ${skill.id}\n`;
+        prompt += `Name: ${skill.name}\n`;
+        prompt += `Description: ${skill.description}\n`;
+        prompt += `Bloom's Level: ${skill.bloomLevel}\n`;
+        prompt += `Difficulty: ${skill.difficulty}\n\n`;
+    }
+    prompt += `--- END SKILLS ---\n\n`;
+    prompt += `For each prerequisite relationship you identify:\n`;
+    prompt += `1. Specify sourceId (prerequisite) and targetId (dependent)\n`;
+    prompt += `2. Classify as hard, soft, or recommended\n`;
+    prompt += `3. Provide strength (0-1) and reasoning\n`;
+    if (options?.inferTransitive === false) {
+        prompt += `\nNote: Only infer direct prerequisites, not transitive ones.`;
+    }
+    return prompt;
+}
+/**
+ * Build a Bloom's analysis prompt
+ */
+export function buildBloomPrompt(text, context) {
+    let prompt = `Analyze the following text and determine its Bloom's Taxonomy level.\n\n`;
+    if (context) {
+        prompt += `Context: ${context}\n\n`;
+    }
+    prompt += `--- TEXT ---\n${text}\n--- END TEXT ---\n\n`;
+    prompt += `Classify this text according to Bloom's Taxonomy (remember, understand, apply, analyze, evaluate, create).`;
+    return prompt;
+}
+/**
+ * Build a curriculum decomposition prompt
+ */
+export function buildDecompositionPrompt(content, options) {
+    let prompt = `Decompose the following curriculum into a complete skill graph.\n\n`;
+    if (options?.title) {
+        prompt += `Course Title: ${options.title}\n`;
+    }
+    if (options?.domain) {
+        prompt += `Domain: ${options.domain}\n`;
+    }
+    if (options?.gradeLevel) {
+        prompt += `Target Audience: ${options.gradeLevel}\n`;
+    }
+    if (options?.context) {
+        prompt += `Additional Context: ${options.context}\n`;
+    }
+    if (options?.maxDepth) {
+        prompt += `Maximum Skill Hierarchy Depth: ${options.maxDepth}\n`;
+    }
+    prompt += `\n--- CURRICULUM CONTENT ---\n${content}\n--- END CONTENT ---\n\n`;
+    prompt += `Create a complete skill graph with:\n`;
+    prompt += `1. All discrete, measurable skills with unique IDs\n`;
+    prompt += `2. Bloom's level and difficulty for each skill\n`;
+    prompt += `3. Prerequisite relationships between skills\n`;
+    prompt += `4. Identify threshold concepts that unlock understanding\n`;
+    return prompt;
+}
+//# sourceMappingURL=prompts.js.map

package/dist/esm/llm/prompts.js.map

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

package/dist/esm/types/llm.js

@@ -0,0 +1,7 @@
+/**
+ * LLM provider types for skill extraction and prerequisite inference
+ *
+ * @packageDocumentation
+ */
+export {};
+//# sourceMappingURL=llm.js.map

package/dist/esm/types/llm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm.js","sourceRoot":"","sources":["../../../src/types/llm.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

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

@@ -0,0 +1,21 @@
+/**
+ * Anthropic adapter for LLM integration
+ *
+ * @packageDocumentation
+ */
+import type { LLMProvider, AnthropicConfig, CompletionRequest, CompletionResponse } from '../../types/llm.js';
+import { BaseLLMAdapter } from './base.js';
+/**
+ * Anthropic adapter for Claude models
+ */
+export declare class AnthropicAdapter extends BaseLLMAdapter {
+    private readonly baseUrl;
+    constructor(config: AnthropicConfig);
+    get provider(): LLMProvider;
+    complete(request: CompletionRequest): Promise<CompletionResponse>;
+}
+/**
+ * Create an Anthropic adapter from environment variables
+ */
+export declare function createAnthropicAdapter(model?: string, overrides?: Partial<AnthropicConfig>): AnthropicAdapter;
+//# sourceMappingURL=anthropic.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic.d.ts","sourceRoot":"","sources":["../../../../src/llm/adapters/anthropic.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,WAAW,EACX,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EACnB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,cAAc,EAA4B,MAAM,WAAW,CAAC;AAiCrE;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,cAAc;IAClD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,MAAM,EAAE,eAAe;IAKnC,IAAI,QAAQ,IAAI,WAAW,CAE1B;IAEK,QAAQ,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC;CAyGxE;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,SAA+B,EACpC,SAAS,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,GACnC,gBAAgB,CAclB"}

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

@@ -0,0 +1,46 @@
+/**
+ * Base adapter class for LLM providers
+ *
+ * @packageDocumentation
+ */
+import type { LLMProvider, LLMConfig, LLMAdapter, CompletionRequest, CompletionResponse } from '../../types/llm.js';
+/**
+ * LLM-related errors
+ */
+export declare class LLMError extends Error {
+    readonly code: LLMErrorCode;
+    readonly provider: LLMProvider;
+    readonly cause?: Error | undefined;
+    constructor(message: string, code: LLMErrorCode, provider: LLMProvider, cause?: Error | undefined);
+}
+export type LLMErrorCode = 'NOT_CONFIGURED' | 'API_ERROR' | 'RATE_LIMIT' | 'INVALID_RESPONSE' | 'TIMEOUT' | 'NETWORK_ERROR' | 'PARSE_ERROR';
+/**
+ * Default configuration values
+ */
+export declare const DEFAULT_CONFIG: {
+    maxTokens: number;
+    temperature: number;
+    timeout: number;
+    retries: number;
+};
+/**
+ * Abstract base class for LLM adapters
+ */
+export declare abstract class BaseLLMAdapter implements LLMAdapter {
+    protected config: LLMConfig;
+    constructor(config: LLMConfig);
+    abstract get provider(): LLMProvider;
+    get model(): string;
+    abstract complete(request: CompletionRequest): Promise<CompletionResponse>;
+    isConfigured(): boolean;
+    getConfig(): Omit<LLMConfig, 'apiKey'>;
+    /**
+     * Retry a function with exponential backoff
+     */
+    protected withRetry<T>(fn: () => Promise<T>, maxRetries?: number): Promise<T>;
+    /**
+     * Parse JSON from LLM response, handling common issues
+     */
+    protected parseJSON<T>(content: string): T;
+}
+//# sourceMappingURL=base.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../../src/llm/adapters/base.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,WAAW,EACX,SAAS,EACT,UAAU,EACV,iBAAiB,EACjB,kBAAkB,EACnB,MAAM,oBAAoB,CAAC;AAE5B;;GAEG;AACH,qBAAa,QAAS,SAAQ,KAAK;aAGf,IAAI,EAAE,YAAY;aAClB,QAAQ,EAAE,WAAW;aACrB,KAAK,CAAC,EAAE,KAAK;gBAH7B,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,YAAY,EAClB,QAAQ,EAAE,WAAW,EACrB,KAAK,CAAC,EAAE,KAAK,YAAA;CAKhC;AAED,MAAM,MAAM,YAAY,GACpB,gBAAgB,GAChB,WAAW,GACX,YAAY,GACZ,kBAAkB,GAClB,SAAS,GACT,eAAe,GACf,aAAa,CAAC;AAElB;;GAEG;AACH,eAAO,MAAM,cAAc;;;;;CAK1B,CAAC;AAEF;;GAEG;AACH,8BAAsB,cAAe,YAAW,UAAU;IACxD,SAAS,CAAC,MAAM,EAAE,SAAS,CAAC;gBAEhB,MAAM,EAAE,SAAS;IAO7B,QAAQ,KAAK,QAAQ,IAAI,WAAW,CAAC;IAErC,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,QAAQ,CAAC,QAAQ,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAE1E,YAAY,IAAI,OAAO;IAOvB,SAAS,IAAI,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC;IAKtC;;OAEG;cACa,SAAS,CAAC,CAAC,EACzB,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,UAAU,SAAgD,GACzD,OAAO,CAAC,CAAC,CAAC;IA2Bb;;OAEG;IACH,SAAS,CAAC,SAAS,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,CAAC;CAgB3C"}

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

@@ -0,0 +1,30 @@
+/**
+ * Google Gemini LLM adapter
+ *
+ * @packageDocumentation
+ */
+import type { LLMProvider, GeminiConfig, CompletionRequest, CompletionResponse } from '../../types/llm.js';
+import { BaseLLMAdapter } from './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
+ */
+export declare class GeminiAdapter extends BaseLLMAdapter {
+    private readonly baseUrl;
+    constructor(config: GeminiConfig);
+    get provider(): LLMProvider;
+    complete(request: CompletionRequest): Promise<CompletionResponse>;
+    private buildRequest;
+    private executeRequest;
+    private parseResponse;
+}
+/**
+ * Create a Gemini adapter from environment variables
+ */
+export declare function createGeminiAdapter(model?: string, overrides?: Partial<GeminiConfig>): GeminiAdapter;
+//# sourceMappingURL=gemini.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"gemini.d.ts","sourceRoot":"","sources":["../../../../src/llm/adapters/gemini.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,WAAW,EACX,YAAY,EACZ,iBAAiB,EACjB,kBAAkB,EACnB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,cAAc,EAAY,MAAM,WAAW,CAAC;AAsCrD;;;;;;;;GAQG;AACH,qBAAa,aAAc,SAAQ,cAAc;IAC/C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,MAAM,EAAE,YAAY;IAOhC,IAAI,QAAQ,IAAI,WAAW,CAE1B;IAEK,QAAQ,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IA2BvE,OAAO,CAAC,YAAY;YAgCN,cAAc;IAyC5B,OAAO,CAAC,aAAa;CA6CtB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,SAAyB,EAC9B,SAAS,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAChC,aAAa,CAkBf"}

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

@@ -0,0 +1,14 @@
+/**
+ * LLM adapter exports
+ *
+ * @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 { 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

@@ -0,0 +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"}

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

@@ -0,0 +1,113 @@
+/**
+ * MediaPipe LLM Inference adapter for local Gemma models
+ *
+ * This adapter integrates with Google's MediaPipe LLM Inference Task API
+ * to run Gemma models locally using WebGPU acceleration.
+ *
+ * Supported models:
+ * - Gemma 2B / 7B
+ * - Gemma 2 2B
+ * - Gemma 3n (2B, 4B parameters)
+ *
+ * Requirements:
+ * - WebGPU-capable browser or Node.js with WebGPU support
+ * - @mediapipe/tasks-genai package
+ * - Downloaded model weights (.bin file)
+ *
+ * @packageDocumentation
+ */
+import type { LLMProvider, MediaPipeConfig, CompletionRequest, CompletionResponse } from '../../types/llm.js';
+import { BaseLLMAdapter } from './base.js';
+/**
+ * Gemma model variants for MediaPipe
+ */
+export declare const MEDIAPIPE_MODELS: {
+    readonly 'gemma-2b': "gemma-2b-it-gpu-int4.bin";
+    readonly 'gemma-7b': "gemma-7b-it-gpu-int8.bin";
+    readonly 'gemma2-2b': "gemma2-2b-it-gpu-int4.bin";
+    readonly 'gemma3n-e2b': "gemma-3n-E2B-it-int4.task";
+    readonly 'gemma3n-e4b': "gemma-3n-E4B-it-int4.task";
+};
+/**
+ * Adapter for MediaPipe LLM Inference API
+ *
+ * Runs Gemma models locally using WebGPU acceleration.
+ * The adapter lazily loads the model on first use.
+ *
+ * @example
+ * ```typescript
+ * import { MediaPipeAdapter } from 'learngraph/llm';
+ *
+ * const adapter = new MediaPipeAdapter({
+ *   provider: 'mediapipe',
+ *   model: 'gemma3n-e2b',
+ *   modelPath: '/models/gemma-3n-E2B-it-int4.task',
+ * });
+ *
+ * // Use with orchestrator
+ * const orchestrator = createOrchestrator(adapter);
+ * ```
+ */
+export declare class MediaPipeAdapter extends BaseLLMAdapter {
+    private inference;
+    private readonly modelPath;
+    private readonly randomSeed?;
+    private readonly topK;
+    private readonly loraRanks?;
+    private initPromise;
+    constructor(config: MediaPipeConfig);
+    get provider(): LLMProvider;
+    /**
+     * Check if MediaPipe is configured (model path exists)
+     */
+    isConfigured(): boolean;
+    /**
+     * Initialize the MediaPipe LLM Inference engine
+     * Called automatically on first request
+     */
+    initialize(): Promise<void>;
+    private doInitialize;
+    /**
+     * Load MediaPipe library dynamically
+     */
+    private loadMediaPipe;
+    complete(request: CompletionRequest): Promise<CompletionResponse>;
+    /**
+     * Build a prompt string from chat messages
+     * Uses Gemma's instruction format
+     */
+    private buildPrompt;
+    /**
+     * Parse the generated response
+     */
+    private parseGeneratedResponse;
+    /**
+     * Close the inference engine and release resources
+     */
+    close(): void;
+}
+/**
+ * Create a MediaPipe adapter for local Gemma models
+ *
+ * @param modelPath - Path to the model file (.bin or .task)
+ * @param model - Model identifier (for reference)
+ * @param overrides - Additional configuration options
+ *
+ * @example
+ * ```typescript
+ * // Using a Gemma 3n model
+ * const adapter = createMediaPipeAdapter(
+ *   '/models/gemma-3n-E2B-it-int4.task',
+ *   'gemma3n-e2b'
+ * );
+ *
+ * // With custom options
+ * const adapter = createMediaPipeAdapter(
+ *   '/models/gemma2-2b-it-gpu-int4.bin',
+ *   'gemma2-2b',
+ *   { maxTokens: 2048, temperature: 0.5 }
+ * );
+ * ```
+ */
+export declare function createMediaPipeAdapter(modelPath: string, model?: string, overrides?: Partial<Omit<MediaPipeConfig, 'provider' | 'modelPath'>>): MediaPipeAdapter;
+//# sourceMappingURL=mediapipe.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mediapipe.d.ts","sourceRoot":"","sources":["../../../../src/llm/adapters/mediapipe.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EACV,WAAW,EACX,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EACnB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,cAAc,EAAY,MAAM,WAAW,CAAC;AAoCrD;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;;;CAMnB,CAAC;AAEX;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,gBAAiB,SAAQ,cAAc;IAClD,OAAO,CAAC,SAAS,CAA6B;IAC9C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAS;IACpC,OAAO,CAAC,WAAW,CAA8B;gBAErC,MAAM,EAAE,eAAe;IAYnC,IAAI,QAAQ,IAAI,WAAW,CAE1B;IAED;;OAEG;IACH,YAAY,IAAI,OAAO;IAIvB;;;OAGG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;YAcnB,YAAY;IAuC1B;;OAEG;YACW,aAAa;IAarB,QAAQ,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAqCvE;;;OAGG;IACH,OAAO,CAAC,WAAW;IA6BnB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IA6B9B;;OAEG;IACH,KAAK,IAAI,IAAI;CAOd;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,MAAM,EACjB,KAAK,SAAY,EACjB,SAAS,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,eAAe,EAAE,UAAU,GAAG,WAAW,CAAC,CAAC,GACnE,gBAAgB,CASlB"}

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

@@ -0,0 +1,30 @@
+/**
+ * Ollama adapter for local LLM integration
+ *
+ * @packageDocumentation
+ */
+import type { LLMProvider, OllamaConfig, CompletionRequest, CompletionResponse } from '../../types/llm.js';
+import { BaseLLMAdapter } from './base.js';
+/**
+ * Ollama adapter for local models
+ */
+export declare class OllamaAdapter extends BaseLLMAdapter {
+    private readonly baseUrl;
+    constructor(config: OllamaConfig);
+    get provider(): LLMProvider;
+    isConfigured(): boolean;
+    complete(request: CompletionRequest): Promise<CompletionResponse>;
+    /**
+     * Check if Ollama is available
+     */
+    isAvailable(): Promise<boolean>;
+    /**
+     * List available models
+     */
+    listModels(): Promise<string[]>;
+}
+/**
+ * Create an Ollama adapter
+ */
+export declare function createOllamaAdapter(model?: string, overrides?: Partial<OllamaConfig>): OllamaAdapter;
+//# sourceMappingURL=ollama.d.ts.map