Scene Management
manage_sceneSets active scene state, issues narrative directives, offers choices, resolves oracle questions, and skips time. Applies NPC changes and preserves countdowns during skips.
Instructions
Manage the active scene and its narrative framing — scene description, directive, choices, and oracle rolls. set overwrites the scene's description and metadata, derives the description from location only when description is omitted, and accepts fast_forward to skip an interval: changes applies NPC moves, conditions, or dispositions and skip_countdowns preserves narrative countdowns. directive replaces the active directive; choices replaces the offered options; oracle resolves a chance question and records the roll, so repeated calls are additive rather than idempotent. set and directive require the GM or Editor badge, persist to the Novel, are audited, and are undoable. Use when: setting scene state, issuing a directive, offering choices, consulting the oracle, or skipping time. Do NOT use when: recording a story beat — use manage_story (action: record); staging presence or autonomy — use manage_staging; changing the spatial model — use manage_world.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"action": "<action>"
},
"name": "manage_scene"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| beat | No | Story-beat tag (set): setup, escalation, turning_point, climax, resolution, denouement. | |
| seed | No | Deterministic seed (oracle). | |
| action | Yes | set, directive, presence, autonomy, choices, or oracle. | |
| prompt | No | Choice prompt (choices). | |
| choices | No | List of choices (choices). | |
| context | No | Context for the choice (choices). | |
| location | No | Scene location (set). | |
| question | No | Question to resolve (oracle). | |
| directive | No | Narrative directive (directive). | |
| atmosphere | No | Atmosphere (set). | |
| likelihood | No | Likelihood tier (oracle). | |
| scene_type | No | Scene-type tag or array (set). | |
| description | No | Scene description (set). | |
| time_of_day | No | Time of day (set). | |
| fast_forward | No | Narrative fast-forward (set). | |
| allow_freeform | No | Allow free-form response (choices). | |
| adventure_scene | No | Adventure-scene waypoint anchor; empty or null clears (set). | |
| skip_transition_hook | No | Skip the scene-transition hook (set). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| text | No | Human-readable text envelope mirroring the structured result (REQ-001, REQ-548a). | |
| status | Yes | Machine-readable result status: OK, NEED_INPUT, WARNING, PARTIAL, or an error category (REQ-002, REQ-548c). |