Basics

Showing 25 of 53 from the live probe.

• Initialize

  Initialize the Basics Learning Platform. Call this tool when: 1. User says "start basics" (this starts the Basics Learning Platform, not a course) 2. At the start of every new conversation (FIRST tool call before any others) 3. User explicitly says "initialize" or "reset" to fix hallucinations This tool returns comprehensive system instructions explaining: - All step types you'll encounter (content, code, module, quiz) - Complete XML tag glossary and how to process them - What each tool returns

• Start

  Load a specific course or resume current course. Call when user says "do the react course", "start portfolio course", "do uplift", etc. Parse the course name from user input (e.g., "do the react course" → courseSlug: "react-basics", "portfolio course" → courseSlug: "portfolio"). If user just says "start" or "resume" with no course name, call with no courseSlug to resume their current course. NOTE: "start basics" means initialize the PLATFORM (call initialize() instead). Sessions and timing ar

• Progress

  Show detailed course progress and web URL

• Next

  Move to the next step in the course (automatically marks current step as complete)

• Jump

  Jump to a specific lesson you have already started (cannot skip ahead)

• Complete

  Mark the current step as complete without moving forward (optional - next auto-completes)

• Reset

  Reset all course progress

• Set Questions

  Set your preference for follow-up questions during course content

• Set Mode

  Set your learning mode to customize how course content is delivered

• Login

  Get a new authentication link for Basics. This generates a USER_KEY link for link-based authentication.

• Status

  Check current authentication status and logged-in user (works with link-based authentication)

• Logout

  Logout from Basics and clear stored credentials (for link-based authentication)

• Get User Key Link

  Get USER_KEY link for the authenticated user

• Initialize Session

  **REQUIRED** when user is in tutoring mode and starting/resuming a course. WHEN TO CALL (AUTOMATICALLY - do not ask user): - Immediately after start() returns with a TUTORING_MODE_DIRECTIVE - Before the first next() call when user is in tutoring mode - When next() returns TUTORING_MODE_PROMPT indicating no active session HOW TO CHECK: The start() tool response will include <TUTORING_MODE_DIRECTIVE> if this is needed. WHAT THIS DOES: 1. Creates a tutoring session with state machine (OPENING →

• Transition Session State

  Move the session to a new state. ALWAYS call this when changing phases. WHEN TO CALL: - After rapport building in OPENING → transition to "content" - For each step's content → transition to "step_dialogue" - At lesson boundaries → transition to "verification" - After failed verification → transition to "re_explanation" - When learner wants to stop → transition to "closing" Valid transitions: - opening → content - content → step_dialogue, verification, closing - step_dialogue → content, verific

• End Session

  Finalize and close the current tutoring session. Calculates final metrics, records time breakdown, and saves session notes. Can be called from any state (will transition through closing to ended).

• Get Active Session

  Get the current active tutoring session for the authenticated user. Returns session details including state, position, and metrics. Returns null if no active session exists.

• Get Tutoring Mode

  Get the current tutoring mode for the authenticated user. Returns either "normal" (standard content delivery) or "tutoring" (session-based conversational learning).

• Set Tutoring Mode

  Switch between normal and tutoring mode. ⚠️ CRITICAL: NEVER call this tool unless the user EXPLICITLY asks to switch modes! This is a USER PREFERENCE, not something the AI changes automatically. The mode persists across sessions - do NOT change it based on session flow. DO NOT call this tool when: - Transitioning between session states (opening → content → verification → closing) - Completing or ending a session - Any time during normal tutoring flow ONLY call this tool when the user says som

• Check Lesson Boundary

  **REQUIRED** after teaching each step in tutoring mode. WHEN TO CALL: - After you finish teaching a step conversationally (after step_dialogue) - The next() response includes <CHECK_LESSON_BOUNDARY> with the stepId to check - MUST be called BEFORE calling next() again WHAT TO DO WITH RESULT: If shouldTriggerVerification is TRUE: 1. Call transitionSessionState({ toState: "verification", triggerType: "completion" }) 2. Assess the learner's understanding (teach-back, application, prediction q

• Update Session Position

  Update the current position in the active tutoring session. Called by next() when in tutoring mode to track progress through the course.

• Record Step Start

  Mark the beginning of a step. Creates a timing record to track how long the learner spends. Called automatically when a step is presented in tutoring mode. Returns estimated duration based on user history or global averages.

• Record Step Completion

  Mark a step as complete with engagement metrics. Call this when a step is completed in tutoring mode. Records metrics about the interaction and updates aggregate statistics. Will automatically detect and record struggle points.

• Get Time Estimate

  Get personalized time estimate for lessons. Returns estimated duration based on user history or global averages. Adjusts estimates based on learner profile (processing speed, etc.).

• Get Struggle History

  Get learner's struggle points sorted by difficulty. Returns content where the learner has struggled, sorted by struggle score. Includes misconceptions and successful explanation approaches when available.