Check whether Beat is running and reachable, and list its open documents. Call this first.

List every screenplay currently open in Beat, with the docIndex to use for other tools.

Get the complete Fountain text of a Beat document.

Replace the ENTIRE text of a Beat document with new Fountain text. Use this for full rewrites; prefer beat_replace_scene for targeted edits so you don't disturb the rest of the script.

Get the full outline of a Beat document: scene headings, sections and synopsis lines, in order, with the sceneIndex needed by beat_get_scene_text / beat_replace_scene.

Get just the scenes (no sections/synopses) of a Beat document, with sceneIndex, heading text, and position.

Get the full text of a single scene by its sceneIndex (from beat_get_scenes).

Replace a single scene's text in place (heading through the line before the next scene), identified by sceneIndex from beat_get_scenes. The rest of the script is untouched.

Insert text at a specific character index in a Beat document (indexes come from beat_get_outline/beat_get_scenes).

Append text (e.g. a new scene) to the end of a Beat document.

Debug helper: dumps whatever fields the installed Beat version exposes on its document objects. Only needed if beat_list_documents titles/paths look wrong.