Causality Management
manage_causalityPropose, admit, reject, list, or inspect objective causal transitions and admit external events with audited ledger records and optimistic concurrency guards.
Instructions
Manage objective causal state and transition proposals. causal_propose records a proposal without applying it; causal_admit applies the proposal and causal_reject marks it rejected without deleting the ledger record; causal_expected_version guards optimistic concurrency and causal_from records the expected prior value; causal_ingress admits an external event without a proposal. Proposals persist and are audited, and the ledger is capped by TTRPG_CAUSAL_MAX_LEDGER_ENTRIES; list and state are read-only. Causal changes are not undoable via manage_history. Use when: proposing, admitting, rejecting, listing, or inspecting causal transitions, or ingressing an external event. Do NOT use when: changing rooms, things, or exits — 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_causality"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| action | Yes | causal_propose, causal_admit, causal_reject, causal_list, causal_state, causal_ingress. | |
| causal_key | No | State key within the entity (causal_propose). | |
| causal_from | No | Expected prior value (causal_propose). | |
| causal_scope | No | Scope coordinate (causal_propose; default the active Novel slug). | |
| causal_value | No | Proposed value (causal_propose/causal_ingress). | |
| causal_domain | No | location or scalar (causal_propose; default location). | |
| causal_entity | No | Entity whose objective state is proposed (causal_propose). | |
| causal_proposal_id | No | Recorded proposal id (causal_admit/causal_reject). | |
| causal_origin_source | No | narrative, machine, or ruleset (causal_propose). | |
| causal_source_ordinal | No | Contributing event-log ordinal (causal_propose; default the latest event). | |
| causal_expected_version | No | Optimistic version guard (causal_propose). |
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). |