Concepts

Every generator in edu-sdk shares the same options shape and return envelope. React components consume that data with a few consistent rules.

Shared options

Every create* helper accepts:

model is an AI SDK model ID or a LanguageModel instance. See Models & providers.

content is either a non-empty string or a FileContent object (PDF / text / markdown bytes). See Working with files.

Some helpers add extra options (count, length, durationMinutes, include, and so on). Those are documented on each API page.

Artifact

Every generator returns Promise<Artifact<T>>:

{
  id: string;
  title: string;
  description?: string;
  metadata: {
    createdAt: string; // ISO timestamp
    model: string;     // resolved model label
    difficulty: "easy" | "medium" | "hard";
  };
  content: T;
}

T depends on the helper:

extractContent is not a generator — it returns extracted text, not an Artifact.

Choosing a generator

React prop shapes

Most components take the inner artifact.content array:

<Quiz questions={quiz.content} />
<Flashcards flashcards={flashcards.content} />
<PracticeProblems problems={problems.content} />

<StudyGuide /> is the exception — it takes the full artifact so it can render title and sections:

<StudyGuide studyGuide={studyGuide} />

There is no React component for notes, learning sets, or study sessions. Build your own layout, or compose the material components from nested artifacts. See Study session flow.

Nested artifacts

createLearningSet() and createStudySession() nest full artifacts under content:

const set = await createLearningSet({ /* ... */ });

// Outer envelope
set.title;
set.content.quiz; // Artifact<QuizQuestion[]> | undefined

// Pass into React
<Quiz questions={set.content.quiz!.content} />

Errors

Invalid options throw InvalidInputError. File problems throw UnsupportedContentError or ContentExtractionError. All extend EduSDKError. Model and network failures come from the AI SDK and are not wrapped. See Error handling.

Next: Core for the full API, or Quick Start for a minimal example.