theater.needle.tools

show_play

Run scenes. In text chat, omit stages and hold to play the full show without live narration. In voice mode, pass one stage id with hold:true to play that scene and HOLD — the stage stays lit, the music keeps playing, and the last frame stands — so you can narrate what happened and write the next scene AFTER seeing this one. Call again with the next stage to continue; a call without hold ends with the curtain call and credits. This scene-by-scene loop keeps voice narration in step with the story. Run the scenes one after another. Each one builds up — everybody with an entrance arrives — then its script plays, then they leave and the next scene begins. Returns the whole timetable at once and keeps playing, so in voice mode you can narrate to it rather than waiting. The build-up and the exits are made for you; you only write what happens in between, with stage_script. Narration saved on beats is returned in the play document; if using voice mode, speak those passages alongside their moments.

Page: /

Input schema

{
  "type": "object",
  "properties": {
    "stages": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Scene ids, in the order to play them. Omit for all of them, as created."
    },
    "hold": {
      "type": "boolean",
      "description": "Hold the stage after these scenes instead of ending: lights stay down, music keeps playing, last frame stands. Continue with another show_play; end with one that leaves this off."
    }
  }
}