learngraph 0.2.0 → 0.3.0

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

@@ -0,0 +1,298 @@
+/**
+ * LLM provider types for skill extraction and prerequisite inference
+ *
+ * @packageDocumentation
+ */
+import type { BloomLevel } from './bloom.js';
+import type { SkillNodeInput } from './skill.js';
+/**
+ * Supported LLM providers
+ */
+export type LLMProvider = 'openai' | 'anthropic' | 'ollama' | 'custom';
+/**
+ * Base configuration for all LLM providers
+ */
+export interface LLMConfig {
+    /** Provider type */
+    provider: LLMProvider;
+    /** Model identifier (e.g., 'gpt-4o', 'claude-3-5-sonnet-20241022', 'llama3.2') */
+    model: string;
+    /** API key (not needed for Ollama) */
+    apiKey?: string;
+    /** Base URL for API (optional, for custom endpoints) */
+    baseUrl?: string;
+    /** Maximum tokens to generate */
+    maxTokens?: number;
+    /** Temperature for generation (0-1) */
+    temperature?: number;
+    /** Request timeout in milliseconds */
+    timeout?: number;
+    /** Number of retries on failure */
+    retries?: number;
+}
+/**
+ * OpenAI-specific configuration
+ */
+export interface OpenAIConfig extends LLMConfig {
+    provider: 'openai';
+    /** Organization ID (optional) */
+    organization?: string;
+}
+/**
+ * Anthropic-specific configuration
+ */
+export interface AnthropicConfig extends LLMConfig {
+    provider: 'anthropic';
+}
+/**
+ * Ollama-specific configuration (local models)
+ */
+export interface OllamaConfig extends LLMConfig {
+    provider: 'ollama';
+    /** Default: http://localhost:11434 */
+    baseUrl?: string;
+}
+/**
+ * Message role in conversation
+ */
+export type MessageRole = 'system' | 'user' | 'assistant';
+/**
+ * Chat message
+ */
+export interface ChatMessage {
+    role: MessageRole;
+    content: string;
+}
+/**
+ * LLM completion request
+ */
+export interface CompletionRequest {
+    /** Messages for chat completion */
+    messages: ChatMessage[];
+    /** Override temperature for this request */
+    temperature?: number;
+    /** Override max tokens for this request */
+    maxTokens?: number;
+    /** Response format (for structured output) */
+    responseFormat?: 'text' | 'json';
+    /** JSON schema for structured output (if responseFormat is 'json') */
+    jsonSchema?: Record<string, unknown>;
+}
+/**
+ * LLM completion response
+ */
+export interface CompletionResponse {
+    /** Generated text content */
+    content: string;
+    /** Parsed JSON (if responseFormat was 'json') */
+    json?: unknown;
+    /** Token usage statistics */
+    usage: {
+        promptTokens: number;
+        completionTokens: number;
+        totalTokens: number;
+    };
+    /** Model used for completion */
+    model: string;
+    /** Finish reason */
+    finishReason: 'stop' | 'length' | 'content_filter' | 'error';
+}
+/**
+ * Request to extract skills from curriculum content
+ */
+export interface SkillExtractionRequest {
+    /** Raw curriculum/syllabus content */
+    content: string;
+    /** Content format hint */
+    format?: 'markdown' | 'text' | 'html' | 'pdf';
+    /** Domain/subject area hint */
+    domain?: string;
+    /** Target audience/grade level */
+    gradeLevel?: string;
+    /** Additional context for extraction */
+    context?: string;
+    /** Tags to apply to all extracted skills */
+    tags?: string[];
+    /** Minimum confidence threshold (0-1) */
+    minConfidence?: number;
+}
+/**
+ * LLM-extracted skill with metadata
+ */
+export interface ExtractedSkillLLM {
+    /** Skill name (concise) */
+    name: string;
+    /** Skill description */
+    description: string;
+    /** Detected Bloom's level */
+    bloomLevel: BloomLevel;
+    /** Difficulty estimate (0-1) */
+    difficulty: number;
+    /** Confidence in extraction (0-1) */
+    confidence: number;
+    /** Whether this is a threshold concept */
+    isThresholdConcept: boolean;
+    /** Estimated time to master in minutes */
+    estimatedMinutes?: number;
+    /** Source text that generated this skill */
+    sourceText?: string;
+    /** LLM's reasoning for this extraction */
+    reasoning?: string;
+    /** Keywords/concepts associated with this skill */
+    keywords?: string[];
+}
+/**
+ * Result of skill extraction
+ */
+export interface SkillExtractionResponse {
+    /** Extracted skills */
+    skills: ExtractedSkillLLM[];
+    /** Overall extraction confidence */
+    confidence: number;
+    /** Token usage */
+    usage: CompletionResponse['usage'];
+    /** Warnings or notes from extraction */
+    warnings: string[];
+    /** Processing time in milliseconds */
+    durationMs: number;
+}
+/**
+ * Request to infer prerequisites between skills
+ */
+export interface PrerequisiteInferenceRequest {
+    /** Skills to analyze for prerequisites */
+    skills: Array<{
+        id: string;
+        name: string;
+        description: string;
+        bloomLevel: BloomLevel;
+        difficulty: number;
+    }>;
+    /** Domain context */
+    domain?: string;
+    /** Whether to infer transitive prerequisites */
+    inferTransitive?: boolean;
+    /** Minimum confidence for edge suggestion */
+    minConfidence?: number;
+}
+/**
+ * Inferred prerequisite relationship
+ */
+export interface InferredPrerequisite {
+    /** Source skill ID (the prerequisite) */
+    sourceId: string;
+    /** Target skill ID (depends on source) */
+    targetId: string;
+    /** Relationship strength (0-1) */
+    strength: number;
+    /** Type of prerequisite */
+    type: 'hard' | 'soft' | 'recommended';
+    /** Confidence in this inference (0-1) */
+    confidence: number;
+    /** LLM's reasoning for this relationship */
+    reasoning: string;
+}
+/**
+ * Result of prerequisite inference
+ */
+export interface PrerequisiteInferenceResponse {
+    /** Inferred prerequisites */
+    prerequisites: InferredPrerequisite[];
+    /** Token usage */
+    usage: CompletionResponse['usage'];
+    /** Processing time in milliseconds */
+    durationMs: number;
+}
+/**
+ * Request to analyze Bloom's level of text
+ */
+export interface BloomAnalysisRequest {
+    /** Text to analyze */
+    text: string;
+    /** Context for analysis */
+    context?: string;
+}
+/**
+ * Result of Bloom's level analysis
+ */
+export interface BloomAnalysisResponse {
+    /** Detected Bloom's level */
+    level: BloomLevel;
+    /** Confidence in detection (0-1) */
+    confidence: number;
+    /** Key verbs/phrases that indicated this level */
+    indicators: string[];
+    /** LLM's reasoning */
+    reasoning: string;
+    /** Token usage */
+    usage: CompletionResponse['usage'];
+}
+/**
+ * Request to decompose curriculum into a skill graph
+ */
+export interface DecompositionRequest {
+    /** Curriculum content */
+    content: string;
+    /** Title of the course/curriculum */
+    title?: string;
+    /** Domain/subject */
+    domain?: string;
+    /** Target grade level */
+    gradeLevel?: string;
+    /** Additional context */
+    context?: string;
+    /** Maximum depth of skill hierarchy */
+    maxDepth?: number;
+    /** Whether to infer prerequisites */
+    inferPrerequisites?: boolean;
+}
+/**
+ * Result of curriculum decomposition
+ */
+export interface DecompositionResponse {
+    /** Course/curriculum title */
+    title: string;
+    /** Extracted skills */
+    skills: ExtractedSkillLLM[];
+    /** Inferred prerequisites (if requested) */
+    prerequisites: InferredPrerequisite[];
+    /** Skill inputs ready for storage */
+    skillInputs: SkillNodeInput[];
+    /** Token usage */
+    usage: CompletionResponse['usage'];
+    /** Processing time in milliseconds */
+    durationMs: number;
+    /** Warnings from processing */
+    warnings: string[];
+}
+/**
+ * LLM adapter interface for different providers
+ */
+export interface LLMAdapter {
+    /** Provider name */
+    readonly provider: LLMProvider;
+    /** Model identifier */
+    readonly model: string;
+    /** Send a completion request */
+    complete(request: CompletionRequest): Promise<CompletionResponse>;
+    /** Check if the adapter is properly configured */
+    isConfigured(): boolean;
+    /** Get current configuration (without sensitive data) */
+    getConfig(): Omit<LLMConfig, 'apiKey'>;
+}
+/**
+ * High-level LLM orchestrator for educational tasks
+ */
+export interface LLMOrchestrator {
+    /** Extract skills from curriculum content */
+    extractSkills(request: SkillExtractionRequest): Promise<SkillExtractionResponse>;
+    /** Infer prerequisites between skills */
+    inferPrerequisites(request: PrerequisiteInferenceRequest): Promise<PrerequisiteInferenceResponse>;
+    /** Analyze Bloom's level of text */
+    analyzeBloomLevel(request: BloomAnalysisRequest): Promise<BloomAnalysisResponse>;
+    /** Full curriculum decomposition */
+    decompose(request: DecompositionRequest): Promise<DecompositionResponse>;
+    /** Get the underlying adapter */
+    getAdapter(): LLMAdapter;
+}
+//# sourceMappingURL=llm.d.ts.map

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

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "learngraph",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "The world's first AI-powered learning path generator. Transform syllabi into personalized mastery paths with Zone of Proximal Development (ZPD), Bloom's Taxonomy, spaced repetition, and Bayesian Knowledge Tracing built in. Every student's path to mastery.",
   "author": "Dr. Ernesto Lee <dr.ernesto.lee@gmail.com>",
   "license": "Apache-2.0",