Set prompt
set_promptReplace the text of a node of a group, as typing it in the app would: a generator's prompt, a text node's body, or a story element's stage body (the Story element node of a story element group, for that group's stage). @# tokens are checked (every token must cite something in the project); on a generator the reference edges follow the tokens, so a token you drop disconnects that input and a token you add connects it. Defaults to the group's default target (defaultNodeId in get_group: a shot's panel, the starred generator of a production group or the art direction, a story element's Story element node); nodeId picks another. Read the current text and its references with get_group first. The shot panel's prompt is managed by the app: a prompt you set there is kept as written (it no longer follows the shot's action, framing and camera) until you call again with restoreDefault: true. Story element referenceHandles (@ref_…) are turned into live references. No images are generated and no credits are spent.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| nodeId | No | A node of the group from get_group (nodeId): a generator, a text node or the Story element node. Omit for the group's default target (defaultNodeId in get_group): a shot's panel, the starred generator of a production group or the art direction, a story element's Story element node. | |
| target | Yes | The group, e.g. { kind: "shot", id: shotId } for a shot's panel group, { kind: "story_element", id: entityId } for a reference sheet, { kind: "art_direction" }. | |
| projectId | Yes | ScreenWeaver project id (from list_projects). | |
| promptText | No | The whole new text: a generator's prompt, a text node's body, or the Story element's body for this group's stage. Cite nodes with @#nodeId tokens (from get_group), story elements with their referenceHandle (list_entities), the art direction with @#ad-text / @#ad-image. Every token must resolve. Keep the tokens of images you want kept. | |
| restoreDefault | No | Shot panel only: put the panel prompt back on the app's template (it follows the shot's action, framing and camera again). Pass instead of promptText. |