add_vocabulary_entry
ChatGPTCreate own draft expression+sense from an explicit learner request. Read existing entries first to avoid duplicates. Include transcription_ipa, pronunciation_locale and truthful pronunciation_source for each new entry. No fake lesson is created; publish a valid complete bundle to enable practice.
archive_vocabulary_entry
ChatGPTArchive own expression without deleting attempts/history. Learner-requested operation.
begin_lesson
ChatGPTBegin/resume main or create separate optional practice/Live. For new workflow set teaching_contract_version="1.1"; then get_session_context, read all required sections and prepare each stage. requested_minutes applies to optional Live only; use actual session IDs returned.
confirm_lesson_note_presented
ChatGPTOn the turn after displaying the saved exact explanation, confirm prepared→presented with NEW request UUID and current note revision; retain source_message_ref. This never completes a lesson.
finish_lesson
ChatGPTFinish only after actual required reports/statuses. Main needs complete Study coverage; skipped voice is explicit learner choice. Optional practice never changes main counters/cursor. Sites D1 sets actual finished_at; retries preserve request UUID/payload.
finish_vocabulary_practice
ChatGPTEnd the current own practice early at learner STOP, retaining real attempts. No extra cards/forced retries. This does not complete a main lesson.
get_completed_lessons
ChatGPTRead authoritative unique main/completed/finished_at in local dates [from_date,to_date), UTC/IANA timezone. Optional Live, cards, partial work and repeated polling never add a main completion.
get_course_outline
ChatGPTRead the active route as short lesson summaries with actual completion counts; page until next_offset is null. No full methodology in outline.
get_current_lesson
ChatGPTRead active main, actual state and coordinator reading manifest before deciding begin/resume. Optional Live is independent of this cursor.
get_learning_context
ChatGPTOnly the connected learner. IDs are course-local, checked on the server; never accept user_id/course_id, SQL or administration. Read at every new teaching chat or context loss. Returns full core teaching contract, pinned program, current learner facts and required section manifest. A manifest/search snippet is not the required reading.
get_learning_preferences
ChatGPTRead own versioned learner preferences, separate from pedagogical progress.
get_learning_progress
ChatGPTRead authoritative actual main/optional history, module evidence and deferred/route review events. No guessed CEFR or projection from viewing notes.
get_lesson_definition
ChatGPTRead the complete definition and 6–8 ordered vocabulary candidates of a course blueprint or assigned program lesson_key, including special overrides. At least one selector is required.
get_lesson_notes
ChatGPTRead own immutable explanation versions and presentation states; prepared is not presented/studied. Never regenerate pending bodies.
get_lesson_record
ChatGPTRead one actual lesson including checkpoint/revision; planning is separate from completion.
get_operation_status
ChatGPTCheck own request receipt: authoritative applied vs not_found; also report separate Site outbox delivery when available. No claim of Android sync merely from a DB receipt.
get_program_options
ChatGPTList genuinely published level/track programs and the current enrollment. Unavailable future programs are not selectable.
get_session_context
ChatGPTRead exact own session/assignment, previous real reports, pinned definition and stage-specific full reading requirements. Refresh at every stage transition/resume.
get_session_reports
ChatGPTRead actual reports/statuses of one own lesson; unseen conversations are not evidence.
get_vocabulary_entry
ChatGPTRead one own expression+sense, screening/practice state, progress and lesson links with current revisions.
get_vocabulary_notes
ChatGPTRead own pending/processed vocabulary observations; unknown/requested words should be saved promptly, not inferred from unseen clicks.
get_vocabulary_practice
ChatGPTRead own current v5 training/current challenge; initial answer keys are hidden. Does not start a main lesson.
link_vocabulary_to_lesson
ChatGPTLink own reusable expression+sense to an actual own lesson with truthful relation/usage/evidence. No duplicated expression for each lesson.
list_connected_apps
ChatGPTList only own safe app grant metadata; needs separately approved account:read. No client registry credentials/tokens.
list_connected_devices
ChatGPTList only own Android device session metadata; no secrets. Requires separately approved account:read.
list_learning_history
ChatGPTPage own actual main/practice history, truthful statuses/checkpoints/finished_at.
list_learning_resources
ChatGPTList course-owned stored resources plus available catalog documents. Does not grant Drive access.
list_teaching_documents
ChatGPTList permitted, versioned methodology/program documents and hashes. Read full sections with the reading tools.
list_teaching_sections
ChatGPTList section metadata of a permitted document. This index does not satisfy required reading.
list_vocabulary
ChatGPTList own expressions with query, state, lesson and pagination, including planned/draft/archived when requested. Never expose another learner.
list_vocabulary_cards
ChatGPTRead own management card contents, current immutable versions, answers and choices. Management keys must not be reused as independent retrieval evidence.
list_vocabulary_disputes
ChatGPTList own actual disputed attempts; open/resolved filter with pagination.
list_vocabulary_examples
ChatGPTList own examples including retired versions and revisions.
open_vocabulary_dispute
ChatGPTDispute an actual own incorrect v5 attempt; freezes its contribution until resolution. Does not manufacture attempts.
plan_lesson
ChatGPTCreate/update own custom blueprint (or own new module) with complete task boundaries/resources/vocabulary in teaching_definition. Planning never changes completion; select_next_lesson is explicit.
prepare_lesson_session
ChatGPTSave finite exact assignment after full required reading. context must contain outcomes(1–3), target_forms, out_of_scope, activities(1–12), stop_rules and review_target(null or one justified review). Retain returned revisions. No placeholders/new chapters.
publish_vocabulary_bundle
ChatGPTAtomically publish a complete staged bundle after schema/activation validation; immutable played card versions remain intact. Mark listed source notes processed only after successful publication.
read_learning_material
ChatGPTRead one permitted document or lesson note belonging to the connected learner. Obtain its ID from learning context; never guesses another account.
read_learning_resource
ChatGPTRead one own stored reference resource by resource_id, in exact paginated chunks. A missing source is an error.
read_teaching_document
ChatGPTRead exact full document in bounded pages; follow next_offset. Returns immutable version/hash and delivery receipt. Required section receipts must be obtained with read_teaching_section.
read_teaching_section
ChatGPTRead exact required section text. Follow every next_offset; retain all delivery receipts. Sections are indexed individually; read all returned requirements including child sections.
record_deferred_learning
ChatGPTSave evidenced off-target patterns/request for later; never convert it automatically to active targets/cards or extra homework. Only own optional lesson link.
resolve_vocabulary_dispute
ChatGPTResolve one own actual dispute using existing v5 recomputation and honest explanation. Do not manually patch progress or played snapshots.
restore_vocabulary_card
ChatGPTChange own card status; preserve played snapshots and reject activation/deactivation that invalidates the bundle.
restore_vocabulary_entry
ChatGPTRestore own expression only if content validation allows activation.
restore_vocabulary_example
ChatGPTChange status of own example; preserve IDs/history and reject changes that invalidate active card dependencies.
retire_vocabulary_card
ChatGPTChange own card status; preserve played snapshots and reject activation/deactivation that invalidates the bundle.
retire_vocabulary_example
ChatGPTChange status of own example; preserve IDs/history and reject changes that invalidate active card dependencies.
revise_vocabulary_card
ChatGPTCreate a NEW immutable content version plus answer/choice rows and update the one own card pointer in one bounded validated batch; never rewrite played versions.
revoke_connected_app
ChatGPTRevoke one own app grant immediately; independent of other apps/Android. Requires account:manage and explicit learner request. Reconnect through ordinary consent.
revoke_connected_device
ChatGPTImmediately revoke one own Android device; does not revoke plugin or other integrations. Requires account:manage and explicit learner request.
save_learning_content
ChatGPTSave a bounded batch of expressions, examples, immutable card versions and vocabulary state for your own course using v5 schema. Consult the returned content contract. Activation must satisfy existing content validation. No statistics, lessons, administrative tables, SQL or schema changes.
save_learning_route_review
ChatGPTRecord evidence-based route review within a planned slot, normally after3/12 main completions. Optional module status updates require current revisions and actual evidence in details. Word/card statistics are never changed.
save_lesson_checkpoint
ChatGPTSave honest partial work, exact pending payloads/receipts and next step. STOP immediately; checkpoint is not completion. Cannot modify completed history.
save_lesson_note
ChatGPTSave exact displayed-theory Markdown plus equivalent safe HTML/format1 atomically as prepared BEFORE display. Use note_id=session_id+":note:"+topic_key+":v"+content_version. Text/format immutable; edits create linked version. Show identical Markdown; next turn separately confirm presented. Reconstructed is reference only. Legacy Markdown-only records remain compatible.
save_session_report
ChatGPTSave actual Study/voice evidence and coverage with canonical report ID from session. status received/completed/partial; main Study coverage complete means core explained/attempted, not mastered. Optional Live may honestly have partial coverage. Actual duration only if known, with minutes_source.
save_vocabulary_bundle
ChatGPTPersist full draft changes without activating incomplete content. Include matching IPA/locale/source on the expression. Stage one expression, ≥4 examples and ≥8 required cards with immutable versions/answers/choices plus state/lesson links. Read teacher_schema bundle/entity sections first. Retry exact UUID/payload/revision.
save_vocabulary_examples
ChatGPTSave own examples and translations. Four valid active examples required before expression activation; extra useful examples are allowed. Stage a complete bundle for activation.
save_vocabulary_note
ChatGPTSave actual learner word request/unknown evidence in the v5 observation contract. A pending observation is not a ready card or mastery.
search_teaching_knowledge
ChatGPTSearch assigned program/methodology sections. Results are snippets and navigation, never proof of full required reading.
select_learning_program
ChatGPTSelect published program/version after explicit learner choice and atomically set its entry level in the learning profile. Reject unresolved active main; preserve old history, words and integration namespace. Returning to a program restores its saved route.
select_next_lesson
ChatGPTExplicitly choose an available course blueprint; check own prerequisite modules and active-main guard. This does not start or complete it.
set_vocabulary_state
ChatGPTSet actual screening/self-report and practice enabled/paused independently. known ≠ mastered; state changes do not write progress statistics.
skip_lesson_session
ChatGPTSkip opening/closing voice only at the learner’s request (fatigue/time/stop); never skip Study to claim completion. Keep truthful reason.
start_vocabulary_practice
ChatGPTUse the existing Site/Android v5 engine:5/10 expressions,3 rounds and existing retry rule. Returns current challenge without grading keys. Actual persistence may be pending; check operation status.
submit_vocabulary_answer
ChatGPTSubmit actual learner answer to the existing evaluator; never self-generate student answers. Reports real assistance and preserves played snapshot. Actions self_yes/self_no are learner self-report, not independent production.
unlink_vocabulary_from_lesson
ChatGPTRemove a lesson relation only, retaining expression, other links and historical attempts.
update_learning_preferences
ChatGPTUpdate only approved personal UI/audio preferences. Does not alter learning algorithms or another account.
update_learning_profile
ChatGPTUpdate only fields the learner requests; preserve history and course identity. Use profile object and actual course revision. Legacy level/role/goal/timezone parameters remain accepted.
update_vocabulary_entry
ChatGPTUpdate own requested phrase/sense/meaning metadata with current revision; preserve played attempts/card versions. Review IPA when changing phrase/sense; submit matching transcription_ipa, pronunciation_locale and pronunciation_source together. Card content corrections require revise_vocabulary_card.
use_vocabulary_help
ChatGPTRecord actual hint/reveal assistance before exposing it; later answer remains assisted/self-assessed. Only the current own challenge.
