add_days
ChatGPTUse this when the teacher wants more days in an existing week (up to five at a time, seven in all). Adds planned, empty days with a title, target and final product; nothing is generated and it cannot be undone from here.
add_reading
ChatGPTUse this when the teacher gives you the text students will read, as pasted text or a web link, and wants it added to a lesson or a whole week. Adds the reading and includes it so the coach can quote it; a reading on a week reaches every day and resets their lesson checks. The reading's words are never returned. Over 50,000 characters it is added but not included until the teacher confirms an excerpt in TeacherHero.
build_lessons
ChatGPTUse this when a week or lesson already exists and the teacher wants its empty phases written. Give exactly one of week_id or lesson_id. Starts a background build that uses AI generation and returns its progress; never rewrites a phase that already has text (use regenerate_phase for that).
check_lesson
ChatGPTUse this when the teacher wants the lesson check re-run: do the six phases read as one lesson, does the timing fit, what to fix. Starts a background job that uses AI generation and changes no phase.
create_lessons
ChatGPTUse this only after plan_lessons has been shown and the teacher agreed: creates the course, unit, week and days from the brief and starts building them in the background. Adds new items to their account and uses AI generation. Returns the week (or lesson) with the build's progress. Progress comes from get_progress — do not wait for it.
edit_phase
ChatGPTUse this when the teacher wants a small, exact change to a phase: replace a sentence, add or remove a list item. Changes the lesson immediately (limit 600 characters; for more use regenerate_phase) and returns a receipt with an undo. Clears the lesson check. Read the phase with get_phase first and use a path from it.
find_items
ChatGPTUse this to search the teacher's weeks and lessons by title for the @-mention picker. Read-only.
get_phase
ChatGPTUse this when you need the actual text of one lesson phase — to judge it, quote it or plan an edit. Read-only. Returns the teacher's view, so answers and teacher notes are included and marked; never read them out as student material.
get_profile
ChatGPTUse this when you need to know which TeacherHero account is connected, for example when the teacher asks whose curriculum this is. Read-only.
get_progress
ChatGPTUse this to see how a build, export, retry or lesson check is going, from the job_id in its result. Read-only. Report the progress and stop; do not poll in a loop. A week builds one day at a time: any day in finished_days can be opened with show_lesson while the rest builds.
list_curricula
ChatGPTUse this when you need ids: every course, unit, week and lesson the teacher has, with how many phases of each lesson are written. Pass a query to narrow by title. Read-only. Use it instead of guessing an id.
list_readings
ChatGPTUse this to see which readings a lesson or week has and whether each is included for the coach. Read-only. Returns titles, sizes and flags only; the text is never available.
open_teacherhero
ChatGPTUse this when the teacher wants to open TeacherHero, see their recent weeks and courses, or start from their workspace. Read-only. Takes no arguments. Before connecting it shows a Connect screen; if connected is false, use get_profile to request account linking before opening their curriculum.
plan_lessons
ChatGPTUse this when the teacher wants to make a week or a lesson, before anything is made: it checks the brief, lists what is still missing and shows the days it would create. Writes nothing. Never guess the grade, subject or final product — leave them blank so they show as missing and ask the teacher. Always call this and show the plan before create_lessons.
prepare_materials
ChatGPTUse this when the teacher wants the files for a lesson or a week: student packet, slides, printables, and for the teacher the lesson plan and answer key. Builds the files in their account; a lesson is built now, a week as a background job (check get_progress). Choose audience students for anything handed to students — it never contains answers or teacher notes. Needs every phase of a lesson to be written.
regenerate_phase
ChatGPTUse this when the teacher wants a whole phase rewritten with a new instruction (for a few words, use edit_phase or rewrite_text instead). Replaces the phase's text in a background job that uses AI generation; the previous text is kept in version history. Phases below it are flagged for review.
retry_job
ChatGPTUse this when a build or export failed, stopped partway or was interrupted and the teacher wants the unfinished items run again. Starts a new background job and uses AI generation for build jobs. If a step was interrupted mid-call, ask the teacher before setting confirm_rerun.
rewrite_text
ChatGPTUse this when the teacher wants one passage in a phase reworded (simpler, shorter, a question, an example). Rewrites the passage you quote exactly and saves it, using one small AI generation; returns a receipt with an undo. Only works on a top-level text field or one item of a list field, not on resource text.
search_standards
ChatGPTUse this when the teacher asks which standards fit a topic or skill, or to check a code. Searches the standards catalog (CCSS) and returns real codes with their text and the publisher's notice. Read-only. Never invent a code; you cannot add a standard to a lesson.
show_example_lesson
ChatGPTUse this when someone wants to look inside one day of the example week, with its six phases. Needs no account. Read-only; for a connected teacher's own lesson use show_lesson.
show_example_week
ChatGPTUse this when someone wants to see what TeacherHero makes before connecting an account, or asks for an example of a planned week. Shows a sample five-day week and needs no account. Read-only.
show_lesson
ChatGPTUse this when the teacher wants to read or work on one lesson: its setup, lesson check and six phases (Warm-Up, I Do, We Do, Y'all Do, You Do, Exit Ticket). Read-only. The lesson text itself is in the widget; call get_phase to read one phase's text yourself.
show_week
ChatGPTUse this when the teacher wants to see one week: its days, how much of each is written, the lesson checks and any build in progress. Read-only. Get the week_id from open_teacherhero, list_curricula or find_items; never guess it.
undo_change
ChatGPTUse this when the teacher wants to take back a change made through edit_phase, rewrite_text, update_lesson_setup or update_week_setup, by the action_id on its receipt. Restores the earlier text; it is refused if the lesson was changed again since.
update_lesson_setup
ChatGPTUse this when the teacher wants to change a lesson's title, learning target, final product, period length, vocabulary, prior knowledge, class considerations or key skill. Changes the lesson immediately, clears its lesson check and marks written phases for review; returns a receipt with an undo. It cannot add standards.
update_week_setup
ChatGPTUse this when the teacher wants to change a week's title, objective, texts, vocabulary, skills, assessments, pacing notes or number of days. Every day in the week inherits it, so it clears each day's lesson check; returns a receipt with an undo.