tell_user
PUT A SENTENCE ON THEIR SCREEN, as you work. They are watching the Motion tab while you build, and between your tool calls it shows nothing — a busy agent and a hung one look identical from there. Call this at every step that takes more than a few seconds: what you are about to do, what just landed, what you had to fix. Write like a person talking to someone over their shoulder, one sentence, no jargon. kind:'done' when the whole job is finished and kind:'problem' the moment you are stuck — those are the two endings they are waiting for. Read read_skill {topic:'motion-workflow'} for how this fits the rest.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| of | No | How many there are in total, e.g. 5 — draws a progress bar. Send both or neither, and only when you genuinely know the total; a bar that goes backwards is worse than none. | |
| kind | No | Omit while working. 'done' ends the job, 'problem' flags a blocker. | |
| step | No | Which one you are on, e.g. 2. | |
| text | Yes | One friendly sentence, first person. Not a log line. | |
| token | Yes | The session token that connect returned. |