HanyuGuide

Move up to 200 words between two personal lists atomically, preserving source annotations and cloze cards. Retries are safe. Conflicting annotations reject the entire batch. Use only when the learner requests a move.

move_study_list_words

Read word IDs, Chinese text, and pinyin from up to 10 personal lists at once, including archived lists. Each list has its own stable word-ID cursor. Use these IDs for bulk moves and removals; never infer IDs.

study_list_words

Return the words the signed-in learner studied most recently on HanyuGuide. Use when the learner wants practice built from what they are learning now.

recently_studied_words

Remove word memberships from personal lists in bulk, only when requested. Does not delete dictionary words or study progress. Repeating a batch is safe.

remove_words_from_study_lists

Place up to 100 active personal lists in the requested relative order. Omitted lists retain their positions. Supply list IDs from study_lists. Repeating the same ordering is safe.

reorder_study_lists

Ask the HanyuGuide team to add a Chinese word the dictionary does not have yet. Use only after dictionary_entry or dictionary_search came back empty for it, and only when the learner wants it. Put what the learner knows in details: the meaning they think it has and where they saw it. With list_id (from study_lists), the word goes into that personal list once it is added; that needs list permission and full study access. The learner gets an email when the word is in.

request_word

Save the learner's answers to HanyuGuide flashcards studied in the conversation, so they count in HanyuGuide like answers given in the app and schedule each word's next review. Only for words from study_session or words the learner already studies. Set remembered from what the learner actually answered: true only when they recalled the meaning, false when they got it wrong, gave up, or asked for the answer. Never guess an answer for the learner. The flashcard card saves its own answers, so do not save those again.

record_reviews

Search HanyuGuide dictionary entries by Hanzi, pinyin, or English meaning. Use when the learner does not know the exact written form or wants candidate words; for one known word use dictionary_entry, for a list of words use dictionary_entries.

dictionary_search

Return a deduplicated mix of the signed-in learner's recent and difficult words. Use when the learner asks for a story, dialogue, or reading text made from the words they are learning.

story_seed_words

Return the signed-in learner's HanyuGuide study totals: words studied, reviews in the last 7 days, reviews due now, and hard words. Use when the learner asks how their study is going.

study_summary

Start a HanyuGuide study round for the signed-in learner as flashcards in the conversation: their due reviews first, then new words from their study lists up to today's goal, the same round the HanyuGuide app would give them. Use when the learner wants to study, review, or learn new words here. Where the flashcard card shows, the learner answers on the card and the card saves each answer; do not repeat the words as a text quiz. Without the card, show one word at a time with the meaning hidden (for a new word, show its meaning first), let the learner answer, then save the answers with record_reviews. On subscription_required, tell the learner their free session is over and share upgrade_url.

study_session