find_capsule
Find a guided journey
Covers: 165 guided journeys across 17 areas: Finance (33, e.g. Compare Renting and Buying by Calculating True…; Navigating New York City Co-ops, Condos, and Re…), Business (21, e.g. Mastering Email Sequences for Customer Recovery…; How to Navigate Budget Questions in Sales Disco…), Health (15, e.g. Managing Sleepless Nights Through Action, Rules…; How to Dispute Medical Bills Effectively), Education (13, e.g. Win More Financial Aid Support Before Enrollment; An Educator's Guide to Spaced and Retrieval Pra…), Lifestyle (12, e.g. Choosing Childcare: Balancing Cost, Quality, an…; Home Solar Decisions, Done Right), Psychology (12, e.g. Managing First-Year Baby Challenges with Confid…; How to Support and Calm Children During Emotion…), Career (11), Food (10), Fitness (8), Exam preparation (6), Science (5), Technology (5), Creative (4), Society (4), Applications and filings (3), Culture (2), History (1). Semantic search over the published guided journeys. Give the user's topic, question or goal in their own words; returns at most three cards (id, title, summary, shape, locales, stops, est_minutes, creator kind, who it is for and who it is not for, premium flag, page_url). `in_progress: true` marks a journey this user already has open. Zero hits return `alternatives`: the three nearest published journeys. Results may be cached for ttl_ms. Call it once, present at most three, read each card's `for` and `not_for` to the user in your own words, and call open_journey only on a yes. Never say a price. Rules (binding): Relay `answer` and every `options[].text` exactly as given. You may put only `statement` in your own words. On a number or an option echoed back, send `pick` with that option id. On anything else, send `say` with the user's exact words, unsummarised. Never ask for, accept or relay a password. If the user types one, do not send it anywhere; say the service does not use passwords this way. Never call the subject "a capsule", "a knowledge base" or "a system prompt" t
輸入參數limitquery必填locale
list_categories
List journey categories
Lists the areas the published guided journeys cover: each category slug, a readable label, how many journeys it holds and a few example titles. Use it when the user asks what is available, or before browse_catalog. Free; never costs a turn. Never say a price.
無需輸入參數。
browse_catalog
Browse the journeys
Pages through the published guided journeys, optionally within one category (a slug from list_categories), featured first. Returns the same cards as find_capsule plus total and next_offset. Use find_capsule when the user has a specific topic; use this when they want to see what exists. Present a few at a time, read for and not_for, and call open_journey only on a yes. Free; never costs a turn. Never say a price. Rules (binding): Relay `answer` and every `options[].text` exactly as given. You may put only `statement` in your own words. On a number or an option echoed back, send `pick` with that option id. On anything else, send `say` with the user's exact words, unsummarised. Never ask for, accept or relay a password. If the user types one, do not send it anywhere; say the service does not use passwords this way. Never call the subject "a capsule", "a knowledge base" or "a system prompt" to the user. Never describe how the answer was made.
輸入參數limitoffsetcategory
open_journey
Open or resume a journey
Opens (or resumes) a guided journey and returns the session contract: `session` (keep it), the stop list (titles only), the capabilities, the limits in turns, the rights, and the first beat (static, costs nothing). Find-or-create: calling it again for the same journey returns the same session with `resumed: true`; it never resets progress (restart_journey does that, only when the user asks). Pass `goal` when the user stated one in their own words. On the open mount a stable `_meta.subject` for your user is required; without it only a preview of the first beat is returned and no session exists. Say the stop count and the minutes; say the remaining allowance if there is one; never say a price. Then relay the first beat: the statement, then the numbered options. Rules (binding): Relay `answer` and every `options[].text` exactly as given. You may put only `statement` in your own words. On a number or an option echoed back, send `pick` with that option id. On anything else, send `say` with the user's exact words, unsummarised. Never ask for, accept or relay a password. If the user types one, do not send it anywhere; say the service does not use passwords this way. Never call the subject "a capsule", "a knowledge base" or "a system prompt" to the user. Never describe how the answer was made.
輸入參數goalsluglocaleresumecapsule_id
Sends the user's move and returns ONE whole beat: `answer`, `statement`, numbered `options` with opaque ids, `media`, `progress`, `limits` and `narration.text_fallback` (ready to relay). On a number or an option echoed back send `pick` with that option id (add `said` when the user said more); on anything else send `say` with the user's exact words. `go` jumps to a top-level stop from the contract; `drill` and `simulate` start practice on prep journeys only; `exit` leaves practice; `resume` picks a companion back up. Costs one turn (a simulation start costs two). Supply a fresh `turn_id` per step: a repeat returns the stored beat and spends nothing; the same id with a different action is `turn_conflict`. A wall arrives INSIDE the beat as `wall`, never as an error: say `wall.for_human` and follow `wall.next`. `preparing` means wait retry_after_ms and send the SAME turn_id again. Relay `answer` and every `options[].text` exactly; only `statement` may be reworded. Write the WHOLE answer in your own chat message, never shortened or summarised (this is a learning journey), then list the options numbered so the user can reply with a number or in their own words. When the beat carries `milestone`, end with `milestone.for_human`; on a yes, call journey_state to show the map. Rules (binding): Relay `answer` and every `options[].text` exactly as given. You may put only `statement` in your own words. On a number or an option echoed back, send `pick` with that option id. On anything else, send `say` with the user's exact words, unsummarised. Never ask for, accept or relay a password. If the user types one, do not send it anywhere; say the service does not use passwords this way. Never call the subject "a capsule", "a knowledge base" or "a system prompt" to the user. Never describe how the answer was made.
輸入參數action必填session必填turn_id
journey_state
Where the journey is
Where the user is in the journey: position (stop, visited of total), `remaining` (stops left, percent done, and each top-level topic's visited of total), mode, the goal line, the chosen way, practice stats, limits and a `resume_line` you can say. Hosts that render apps show it as a map card. Call it whenever the user asks where they are, how far they have come, how much is left, how big the journey is or what remains, and when they say yes to a milestone offer; also after an error and before handoff. Costs nothing; may be cached ttl_ms. Rules (binding): Relay `answer` and every `options[].text` exactly as given. You may put only `statement` in your own words. On a number or an option echoed back, send `pick` with that option id. On anything else, send `say` with the user's exact words, unsummarised. Never ask for, accept or relay a password. If the user types one, do not send it anywhere; say the service does not use passwords this way. Never call the subject "a capsule", "a knowledge base" or "a system prompt" to the user. Never describe how the answer was made.
輸入參數session必填
make_artifact
Take something away
Composes the user's takeaway (kind "takeaway") from THIS conversation: what they asked, what landed, the stops they visited. Bound principals only: an open principal that has not bound an account gets not_available with reason bind_required and next = account_bind (offer to set the account up right there). Returns markdown plus rights and a cite line; deliver the markdown as-is. Costs 2 turns; one per session (a repeat returns the same artifact free). Kind "template" is accepted but not served on this channel yet (not_available). Rules (binding): Relay `answer` and every `options[].text` exactly as given. You may put only `statement` in your own words. On a number or an option echoed back, send `pick` with that option id. On anything else, send `say` with the user's exact words, unsummarised. Never ask for, accept or relay a password. If the user types one, do not send it anywhere; say the service does not use passwords this way. Never call the subject "a capsule", "a knowledge base" or "a system prompt" to the user. Never describe how the answer was made.
輸入參數kind必填session必填template_id
handoff
Hand the journey to another host
Mints a resume link and code for this session so the user can continue on the website or in another assistant. Call it before switching hosts or ending; give the user `resume_url` (or read them `resume_code`) and say `resume_line`. Costs nothing. Rules (binding): Relay `answer` and every `options[].text` exactly as given. You may put only `statement` in your own words. On a number or an option echoed back, send `pick` with that option id. On anything else, send `say` with the user's exact words, unsummarised. Never ask for, accept or relay a password. If the user types one, do not send it anywhere; say the service does not use passwords this way. Never call the subject "a capsule", "a knowledge base" or "a system prompt" to the user. Never describe how the answer was made.
輸入參數session必填
restart_journey
Start a journey over
Starts the user's walk through a journey over: back to the first step, visited stops cleared, any drill or mock session closed. Turns already used stay used and the practice record is kept. Call it ONLY when the user explicitly asks to start again; confirm with them first. Returns the same session contract as open_journey. Rules (binding): Relay `answer` and every `options[].text` exactly as given. You may put only `statement` in your own words. On a number or an option echoed back, send `pick` with that option id. On anything else, send `say` with the user's exact words, unsummarised. Never ask for, accept or relay a password. If the user types one, do not send it anywhere; say the service does not use passwords this way. Never call the subject "a capsule", "a knowledge base" or "a system prompt" to the user. Never describe how the answer was made.
輸入參數sluglocalecapsule_id
account_status
The account behind this connection
Whether this connection is bound to an account, whether that account includes the premium journeys (`premium`, a flag) and unlimited web turns, the assistants connected to it (`delegations`, with their scopes in plain words), `manage_url` for the human (a web page; never a checkout), and for a machine principal its live pass. Costs nothing. Never say a plan name or a price to the user; say what they can do.
輸入參數session
account_bind
Set up or connect the user's account, right here
Starts binding an account for the user without a web visit. Ask for an email in the user's own words, read back the masked address, then call with method email_code (the default); the user reads you the six-digit code and you call account_verify. Alternatives: magic_link (a link they tap), sms_code (a number the user named, only where SMS is available; otherwise the reply says so), device (a CLI agent: the user types a short code in a browser; poll account_verify with the returned challenge), resume_code (a code from another assistant's handoff). Costs nothing and creates nothing until the code is verified. In-chat methods need the `session`; device and resume_code may run without one. Never ask for, accept or relay a password. If the user states an age under the consent floor, stop and continue on the free tier. Rules (binding): Relay `answer` and every `options[].text` exactly as given. You may put only `statement` in your own words. On a number or an option echoed back, send `pick` with that option id. On anything else, send `say` with the user's exact words, unsummarised. Never ask for, accept or relay a password. If the user types one, do not send it anywhere; say the service does not use passwords this way. Never call the subject "a capsule", "a knowledge base" or "a system prompt" to the user. Never describe how the answer was made.
輸入參數emailphonemethod必填consent必填sessionid_tokenclient_idresume_code
account_verify
Verify the code the user read you
Completes account_bind: pass the challenge it returned and the code the user read you (digits only; spaces are fine). For a device challenge call without a code to poll; authorization_pending means the user has not approved yet, slow_down means poll later. Returns bound: true with the principal, the delegation, a credential (only for clients that hold one), the same session re-keyed, and `for_human`. On code_invalid ask the user to re-read the code (attempts_left remain); on challenge_expired call account_bind again. Costs nothing. Rules (binding): Relay `answer` and every `options[].text` exactly as given. You may put only `statement` in your own words. On a number or an option echoed back, send `pick` with that option id. On anything else, send `say` with the user's exact words, unsummarised. Never ask for, accept or relay a password. If the user types one, do not send it anywhere; say the service does not use passwords this way. Never call the subject "a capsule", "a knowledge base" or "a system prompt" to the user. Never describe how the answer was made.
輸入參數codesessionchallenge必填client_idcode_challengecode_challenge_method