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
story.entity_query
Input schema
story_entity_query input
{
"$ref": "./story.entity_query.input.json"
}Output schema
story_entity_query output
{
"$ref": "./story.entity_query.output.json"
}← All toolsv1 · query_tool