Edu SDKCore
Generation APIs in the edu-sdk package.
edu-sdk generates learning materials from content. Pass a model (string ID or AI SDK LanguageModel), content (string or FileContent), optional difficulty (easy | medium | hard), and optional learnerContext.
Every generator returns an Artifact<T> envelope. Invalid options throw InvalidInputError. Unsupported or empty files throw UnsupportedContentError / ContentExtractionError.
When to use which
| Goal | API |
|---|---|
| One material type | A single generator below |
| Several materials from the same content | createLearningSet() |
| Timed agenda plus materials | createStudySession() |
| Text from a file first | extractContent() |
| Score quiz answers | gradeQuiz() / Assessment |
| Personalize from past work / quiz history | Personalization (buildLearnerContext, analyzePastWork) |
Content
| Function | Returns |
|---|---|
extractContent() | Extracted text from file bytes (not an artifact) |
Pass a file object directly as content on any create* call, or extract first to inspect / cache / trim. See Working with files.
Generators
| Function | content type |
|---|---|
createFlashcards() | Flashcard[] (each with id, optional topics) |
createNote() | Markdown string |
createQuiz() | QuizQuestion[] (each with required id, optional topics) |
createStudyGuide() | StudyGuideContent (key concepts may include topics) |
createPracticeProblems() | PracticeProblem[] (each with id, optional topics) |
Workflows
| Function | content type |
|---|---|
createLearningSet() | Nested artifacts chosen via include |
createStudySession() | Timed agenda + LearningSetContent materials |
Assessment
| Function | Role |
|---|---|
gradeQuiz() | Deterministic scoring; optional byTopic when questions have topics |
| Assessment | createQuizAttempt() / completeQuizAttempt() for attempt lifecycle |
Personalization
| API | Role |
|---|---|
buildLearnerContext() | Pure merge of focus / exam / quiz signals → LearnerContext |
analyzePastWork() | LLM diagnostic of past exams/homework → Artifact<PastWorkAnalysis> |
See the Personalization guide for the closed loop. See Quick Start for a full createQuiz example, and Concepts for the shared contract.