Capxule

Use when the user wants to look through the journeys, optionally within one category (a slug from list_journey_categories). Returns a page of the same cards as find_journey, with the total and next_offset.

Use when the user asks for a summary to keep. Composes a markdown takeaway from this journey session: what the user asked, the key points and the stops visited. Available on connected accounts; otherwise returns not_available.

Use when the user wants a guided, step-by-step journey on a topic, a skill or an exam. Searches the published journeys and returns up to three cards (id, title, summary, shape, languages, number of stops, estimated minutes, who it is for and not for, a premium flag, page_url). `in_progress: true` marks a journey this user already has open. When nothing matches, `alternatives` holds the three nearest journeys.

Use when the user asks where they are in a journey, how far they have come or how much is left. Returns the current stop, visited and remaining stops, percent done, practice stats, limits and a resume line.

Use when the user wants to continue the journey later, on the website or in another assistant. Returns a resume link and a short resume code for this session.

Use when the user asks what kinds of journeys are available. Returns each category slug, a readable label, the number of journeys in it and a few example titles.

Use when the user chooses a journey to start or continue. Opens it, or resumes the user's session for it, and returns the session contract: `session`, the stop titles, the capabilities, the limits in turns and the first step. Calling it again for the same journey resumes the same session; it never resets progress.

Use only when the user explicitly asks to start a journey over, after confirming with them. Returns to the first step and clears the visited stops; turns already used stay used. Returns the same session contract as open_journey.

Use for every step after open_journey. Sends the user's choice and returns the next step: `answer`, `statement`, numbered `options` with ids, `media`, `progress` and `limits`. Send `pick` with an option id when the user chose an option or its number; otherwise send `say` with what the user said. `go` jumps to a stop from the contract; `drill` and `simulate` start practice on exam journeys; `exit` leaves practice. Supply a fresh `turn_id` per step; a repeat returns the stored step. If the step carries `wall`, tell the user `wall.for_human`.