story_entity_query
List, get, or search story graph entities such as cards, scenes, episodes, arcs, and relationships.
When to use
Use when the caller needs structured story-graph state.
For scene entities, use the returned `stage_ids` / `primary_stage_id` when chaining into `story_entity_propose`.
Use for character/story-card context such as motivations, physical descriptions, or scene summaries; use media/shot tools for actual visual assets.
When not to use
Do not use for screenplay document reads.
Do not use to discover generated images, recurring shot elements, scene moodboards, or media assets; use `project_assets_query`, `shot_list_query`, or the `shot_element_library` resource.
Examples
“Search for scenes involving the antagonist.”
“Read one scene entity and reuse its `primary_stage_id` for a follow-up proposal call.”
“Read Anna's story card context before preparing visual reference generation.”
Anti-examples
- Apply these screenplay edits.
- List Anna's saved reference images or recurring shot element assets.
Backend capabilities
Input schema
{
"$ref": "./story.entity_query.input.json"
}Output schema
{
"$ref": "./story.entity_query.output.json"
}