@project-ava-supernova/core 0.2.71

package/dist/tools/learning.d.ts

@@ -0,0 +1,154 @@
+import type { Tool, ToolResult, ToolExecutionContext, ToolRiskLevel } from './types.js';
+import type { FunctionSchema } from '../providers/types.js';
+/**
+ * Learning tools — Ava creates, teaches, and tracks learning paths through conversation.
+ * Data is stored locally in ~/.ava/learning.json and synced to platform when connected.
+ */
+export interface QuizQuestion {
+    question: string;
+    options?: string[];
+    correct_answer: string;
+    user_answer?: string;
+    is_correct?: boolean;
+    explanation?: string;
+}
+/**
+ * A single interactive step in a lesson — the Brilliant-style atom: teach a
+ * bite, the learner does something, Ava checks it live, then advances. This is
+ * the teach→do→check loop that replaces the old read-then-test model (a
+ * `content` blob + `quiz_questions` at the end).
+ *
+ * `interaction.evaluation` is the agent-native part: for open input
+ * (free_text / code) there is no single right answer, so Ava grades the
+ * learner's *actual* attempt against the rubric — e.g. "did they write a prompt
+ * with context + task + constraint, for a real situation of their own?". That
+ * live grading of novel input is what Brilliant's fixed widgets can't do, and
+ * what makes "a tutor for whatever you wish to learn" hold.
+ */
+export interface LessonStep {
+    id: string;
+    /** The bite Ava presents before the learner acts — short concept, markdown. */
+    teach: string;
+    interaction: {
+        kind: 'choice' | 'free_text' | 'code' | 'predict';
+        /** What Ava asks the learner to do. */
+        prompt: string;
+        /** For 'choice' — the options shown. */
+        options?: string[];
+        /** Canonical answer for a deterministic check (choice / predict). */
+        answer?: string;
+        /** Rubric/intent for Ava to grade OPEN input (free_text / code), where
+         *  there is no single right answer. The agent reads the learner's real
+         *  attempt against this. */
+        evaluation?: string;
+        /** Starter code for 'code' interactions (real sandbox execution). */
+        starter?: string;
+    };
+    /** Deterministic feedback for choice / predict checks. */
+    feedback?: {
+        correct: string;
+        incorrect: string;
+    };
+    status: 'not_started' | 'attempted' | 'mastered';
+    attempts: number;
+    /** The learner's last typed answer / code — for resume + spaced recall. */
+    last_attempt: string | null;
+}
+export interface Lesson {
+    id: string;
+    title: string;
+    content: string | null;
+    steps?: LessonStep[];
+    type: 'concept' | 'exercise' | 'project' | 'quiz' | 'recap' | 'challenge';
+    status: 'not_started' | 'in_progress' | 'completed' | 'needs_review';
+    difficulty: 'easy' | 'medium' | 'hard';
+    estimated_minutes: number | null;
+    learning_objectives: string[];
+    prerequisites: string[];
+    resources: Array<{
+        title: string;
+        url?: string;
+        type: 'doc' | 'video' | 'article' | 'tool';
+    }>;
+    quiz_questions: QuizQuestion[];
+    score: number | null;
+    attempts: number;
+    best_score: number | null;
+    ava_feedback: string | null;
+    completed_at: string | null;
+    last_reviewed_at: string | null;
+    review_count: number;
+    tags: string[];
+    time_spent_minutes: number;
+    started_at: string | null;
+}
+export interface Milestone {
+    title: string;
+    at_percent: number;
+    reached: boolean;
+    reached_at: string | null;
+}
+export interface Module {
+    id: string;
+    title: string;
+    description: string | null;
+    status: 'locked' | 'available' | 'in_progress' | 'completed';
+    progress_percent: number;
+    estimated_minutes: number | null;
+    learning_objectives: string[];
+    lessons: Lesson[];
+}
+export interface Curriculum {
+    id: string;
+    title: string;
+    description: string | null;
+    subject: string;
+    level: string;
+    goal: string | null;
+    estimated_hours: number | null;
+    status: 'active' | 'completed' | 'paused';
+    progress_percent: number;
+    modules: Module[];
+    tags: string[];
+    created_at: string;
+    updated_at: string;
+    completed_at: string | null;
+    adaptive_level: 'easy' | 'medium' | 'hard' | null;
+    milestones: Milestone[];
+    curriculum_learning_objectives: string[];
+    curriculum_prerequisites: string;
+    target_audience: string;
+}
+export interface LearningStore {
+    curriculums: Curriculum[];
+    streaks: {
+        current: number;
+        longest: number;
+        lastActiveDate: string | null;
+    };
+}
+export declare class LearningCreateTool implements Tool {
+    readonly name = "learning_create";
+    readonly description = "Create a structured learning curriculum with modules and lessons for the user";
+    readonly riskLevel: ToolRiskLevel;
+    readonly requiresConfirmation = true;
+    readonly schema: FunctionSchema;
+    execute(args: Record<string, unknown>, context: ToolExecutionContext): Promise<ToolResult>;
+}
+export declare class LearningTeachTool implements Tool {
+    readonly name = "learning_teach";
+    readonly description = "Deliver a lesson, write teaching content, give feedback, run a quiz, or trigger a review for the user's active curriculum";
+    readonly riskLevel: ToolRiskLevel;
+    readonly requiresConfirmation = false;
+    readonly schema: FunctionSchema;
+    execute(args: Record<string, unknown>, context: ToolExecutionContext): Promise<ToolResult>;
+}
+export declare class LearningProgressTool implements Tool {
+    readonly name = "learning_progress";
+    readonly description = "View learning progress, list curriculums, find next lesson, check review schedule, or search across learning content";
+    readonly riskLevel: ToolRiskLevel;
+    readonly requiresConfirmation = false;
+    readonly schema: FunctionSchema;
+    execute(args: Record<string, unknown>, context: ToolExecutionContext): Promise<ToolResult>;
+}
+//# sourceMappingURL=learning.d.ts.map

package/dist/tools/learning.d.ts.map

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