theater.needle.tools

show_watch

Wait until something changes on the canvas, then return what happened — images added, layers moved, styles changed, exports — together with a picture of the result, so you can see what the person did and act on it. Blocks until there is news or the wait runs out, so call it in a loop to follow along while they work. This loop plus piece_say is NARRATOR MODE: the person (often a child) plays with the pieces by hand and you tell the story of what they do — the wolf creeps toward the house, have the pig gasp. Watch, react through the characters' own bubbles, repeat. Pass the `nextCursor` from the previous call so nothing is missed between calls.

Page: /

Input schema

{
  "type": "object",
  "properties": {
    "cursor": {
      "type": "number",
      "description": "The nextCursor from your last call. Omit to start from now."
    },
    "timeoutSeconds": {
      "type": "number",
      "description": "How long to wait, 1–30. Default 25."
    },
    "preview": {
      "type": "boolean",
      "description": "Include a picture of the canvas. Default true."
    }
  }
}