tomo_account_status
ChatGPTWhether this chat is connected to a Tomo account, and the standing the cards show: hearts, streak, sparks. Read-only and never asks anyone to sign in. A card calls it after a Connect to notice the account arriving.
tomo_cancel_build
ChatGPTStops a course that is still being written and refunds the sparks. The build card offers this itself; you do not need to call it.
tomo_connect_account
ChatGPTConnect the user's own Tomo account to this chat, so their streak, sparks and progress are saved and the courses they make here show up in the Tomo app. Use it when the user asks to connect, link or sign in to Tomo, or taps Connect on a course card. If they are not connected yet, they are asked to sign in. When they were mid-course — a card's Connect says which level they were about to start — pass that course and level: the reply tells you to open it next.
tomo_course_progress
ChatGPTProgress of an in-flight Tomo course build, and the first level once it's ready. The course card calls this itself while it renders; you do not need to.
tomo_find_course
ChatGPTLook up Tomo's published courses. The results come back to you only; the user sees nothing yet. Then, if one course fits, open it with tomo_play_level: its card is the course page with a Start button. If two or more fit, let the user choose with tomo_show_courses. Try it before tomo_make_course: a ready-made course is playable instantly, where a new one takes minutes to write. Call it ONCE per request, with everything in that one call. A specific subject: one short phrase in topics, the way a person types into a search box ('SQL joins', 'the water cycle', 'chess openings'), never a sentence, because every extra word narrows the search. A broad ask ('a new hobby', 'something for my commute'): several concrete candidates in topics, e.g. ['chess', 'photography', 'guitar', 'baking', 'gardening']. No subject at all ('something fun', 'surprise me', 'what's popular'): categories instead, or nothing for the most popular courses overall.
tomo_finish_level
ChatGPTRecords a finished Tomo level — completed, or ended by running out of hearts — and returns its star rating. The level card calls this itself; you do not need to.
tomo_home
ChatGPTOpen Tomo's home: the course the learner can continue, a box to start a new one, their own courses and a few popular ones. Call it when they ask to open Tomo, to see their library or their courses, or what they were learning; to look for a course on a subject use tomo_find_course instead. The view opens courses and starts new ones itself, so don't list them in your reply.
tomo_keep_payoff
ChatGPTSaves a completed level's payoff to the learner's Keepers. The level card calls this when they tap Keep; you do not need to.
tomo_library
ChatGPTThe learner's Tomo home again, for the home view coming back from a course. The view calls this itself; you do not need to.
tomo_make_course
ChatGPTTurn what this conversation has been teaching the user into a real, playable Tomo course, and let them play the first level right here. Use it when someone has been learning something with you and wants to actually retain it — they say they have an exam or interview, they want to practise, they ask you to quiz or test them, or they ask for a course, curriculum or study plan. Pass context summarising what you covered and why they care; the course is written from it. Tell the user roughly how long it will take (see depth) and that they can keep chatting — the card shows live progress and becomes playable in place when it's done. Building spends sparks from the user's Tomo balance (the card shows how many); without enough, nothing is built and the card says so.
tomo_open_level
ChatGPTOpens a course where the learner already is, Tomo's home or the panel beside the conversation, at the level they are on or the one given. The card calls this itself when a course or the next level is tapped; you do not need to.
tomo_play_level
ChatGPTOpen one level of a Tomo course so the user can play it here in the conversation. Call it after tomo_find_course when one course fits or they pick one, or when they ask to try, start or preview one; at level 1 the card is the course page itself. Never state or hint at the answers — they play, you don't narrate. One level per turn. Level 1 of any course plays without an account; later levels need a connected Tomo account (the tool says so and the host offers the sign-in), and levels open in order.
tomo_send_to_device
ChatGPTPushes a course to the signed-in learner's own phone so they can carry on there. The card offers this itself on desktop; you do not need to.
tomo_settings
ChatGPTThe user's own defaults for a new Tomo course: teaching voice, course length and starting level. A host's own settings page for Tomo may read them here too; call it yourself only when the user asks what their Tomo defaults are. Never ask the user about these before building a course: the defaults apply on their own.
tomo_share_payoff
ChatGPTMakes the share link for a finished level — the same quiz-a-friend or share-this-fact link the app makes, with the sender's referral attribution. The level card calls this when they tap the share action; you do not need to.
tomo_show_courses
ChatGPTLet the user choose between two or more Tomo courses: a shelf they tap to open one. Call it once, after tomo_find_course, with the courses that fit what they asked for, best first. For a single course call tomo_play_level instead; its card already shows the course. When nothing fits, don't call it: say so and offer tomo_make_course. The shelf's buttons open the courses, so don't list or describe them in your reply.
tomo_start_build
ChatGPTStarts writing a course on the topic typed into the home view's Create a course box, and spends the sparks for it. The home view calls this itself; to build a course in a conversation use tomo_make_course.
tomo_update_settings
ChatGPTChange the user's defaults for a new Tomo course. A host's own settings page for Tomo may save through this too; call it yourself only when the user asks to change a default, such as 'always teach me like a pirate' or 'make my courses longer from now on'. A wish about one course is not this: pass that to tomo_make_course and list it in asked.