Lore Management
manage_loreCreate, revise, remove, import, and control a Novel's lore entries so durable facts remain recallable and Player-visible knowledge stays gated.
Instructions
Manage the active Novel's lore entries — durable facts every caller recalls. set upserts a keyed entry, merging supplied fields into an existing key; update requires an existing key and changes only supplied fields; set_secret, reveal, secret_list, and knowledge control Player-visible facts. import defaults to dry-run; merge overwrites colliding keys and keeps entries not in the import; replace clears first. Triggers fire on scene-text match; sticky counts scenes an entry stays active after its last match. visibility gates Player read access (gm_only default, shared, player_discovered). Mutations require GM/Editor, persist to the Novel, and are undoable; reads are read-only. Use when: creating, revising, removing, toggling, grouping, suggesting, listing, exporting, importing, or controlling knowledge. Do NOT use when: recording one entity's beliefs or perceptions — use manage_belief; handling cold-reference documents — use manage_corpus; storing scratch notes — use manage_note.
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_lore"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| key | No | Lore key (set/update/remove/toggle/group/get). | |
| data | No | JSON or Markdown lorebook data (import). | |
| mode | No | dry-run, merge, or replace (import). | |
| group | No | Group name, or null to clear (set/update/group). | |
| action | Yes | set, update, remove, toggle, group, suggest, list, get, export, import, set_secret, reveal, secret_list, or knowledge. | |
| detail | No | Return full lore entries instead of summary entries (list). | |
| format | No | Optional output format (export). | |
| sticky | No | Optional sticky weight (set/update). | |
| content | No | Lore content (set/update). | |
| priority | No | Optional priority (set/update). | |
| triggers | No | Optional recall triggers (set/update). | |
| entity_id | No | Entity to reveal to / whose knowledge to read (reveal/knowledge). | |
| visibility | No | gm_only (default), shared, or player_discovered — Player read access (set/update; reveal sets player_discovered). | |
| badge_scope | No | game_master or shared (set/update). | |
| world_target | No | Optional world-model target reference (set/set_secret). |
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). |