MCP / Tools / Screenplay / screenplay_edit_propose

screenplay_edit_propose

orchestrationbetaauth: screenplay:writeapproval: suggeststatus: v1

Quote, start accepted generation, and finalize revision-aware screenplay edits for a selected passage.

When to use

Use when the caller wants suggested screenplay edits before applying them.
Call phase=quote with the captured selection and instruction, accept the returned credit allowance, then use its phase=start next action. Use phase=finalize with the job ID to retrieve the proposal; Apply remains separate.

When not to use

Do not use for direct apply or broad story-graph changes.
Do not use while an active `screenplay_writer` parent job is still generating prose for the same project.

Examples

“Suggest sharper dialogue for this selected exchange.”

Anti-examples

Apply these accepted edits now.

Backend capabilities

screenplay.propose_surgical_edits

Input schema

screenplay_edit_propose input

{
  "$ref": "./screenplay.propose_surgical_edits.input.json"
}

Output schema

screenplay_edit_propose output

{
  "$ref": "./screenplay.propose_surgical_edits.output.json"
}