Take Play Turn
take_turnResolve free-text player intent through the parser and mint a session-scoped, read-only turn handle for recording the story outcome without mutating Novel state.
Instructions
Resolve a player intent through the parser and mint a turn handle for the story record. intent is free text parsed by the command resolver; entity_id optionally scopes the parse to the acting entity. The turn is read-only and non-persistent: no Novel state is mutated; the handle is session-scoped, single-use, and consumed by manage_story (action: record), though recording without it still works. Repeated calls mint fresh handles rather than resuming the prior one. Use when: taking a turn before recording its outcome. Do NOT use when: resolving a specific combat round — use manage_combat (action: advance); rolling a ruleset check — use resolve_mechanic (action: roll).
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": {
"intent": "<intent>"
},
"name": "take_turn"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| intent | Yes | Player intent to resolve (take_turn). | |
| entity_id | No | Acting entity id (take_turn). |
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). |