Parrot

Call this first in every conversation. Returns the learner's Parrot Spanish level, day streak, and how many words they are learning and know. Teach at level.cefr (for example "Lower B1"); if it is null, ask the learner or start gently. Use level.parrotLevel only as the learner-facing name of their level. Neither level can be changed through Parrot's tools, so never try to set it and never tell the learner it changed.

get_learner_context

Lists the Spanish words the learner is currently learning in Parrot, most recently updated first. Prefer this when choosing what to practice. Pass nextCursor back as cursor to get the next page; nextCursor is null on the last page.

list_learning_words

Lists the Spanish words the learner already knows in Parrot, most recently updated first. Call this only when the learner asks what they know or asks you to check a specific word; use list_learning_words to choose practice. Pass nextCursor back as cursor to get the next page.

list_known_words

Counts today toward the learner's Parrot day streak. Call it once, after a real Spanish practice session with the learner, not at the start and not for small talk. incremented is false when today was already counted. It does not change the learner's level.

record_practice_today

Saves up to 50 Spanish words to the learner's Parrot dictionary as learning or known. Call this only when the learner explicitly asks you to save or mark words. Give nativeWord (the English meaning) for every word; Parrot keeps its existing meaning for words it already has. Afterwards, say plainly which words were saved and their status. Saving words never changes the learner's level, so never say it did.

set_word_status