Novel Save Management
manage_novelCreate, resume, switch, end, rename, and list novels while saving or retrieving play context. Record provenance and filter active or archived campaigns for persistent lifecycle management.
Instructions
Manage a Novel's save-file lifecycle: create, resume, switch, end, rename, describe, set genre, list, save/get play context, and record provenance. list returns one line per Novel unless detail is set, and filter selects active, archived, or all. create, save_context, and provenance persist; list, info, and get_context are read-only. export, import, archive/unarchive, clone/branch, and checkpoint actions remain callable here for compatibility, but manage_archive exposes them with clearer scope — prefer it. Lifecycle changes are not reversible via manage_history, so clone a Novel before a risky change. Use when: handling a campaign's lifecycle or returning to saved context. Do NOT use when: managing content inside the Novel — use the entity tools; use manage_archive for export, import, archiving, cloning, branching, and checkpoints.
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_novel"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | No | Exported Novel JSON (import). | |
| mode | No | dry-run, merge, or replace (import). | |
| name | No | Novel name (create). | |
| slug | No | Novel slug (resume/switch/archive/unarchive/info). | |
| genre | No | Genre tag (create/genre). | |
| label | No | Checkpoint label (checkpoint_set/list/restore/remove). | |
| scope | No | Export scope (export). | |
| share | No | Emit a portable full-scope bundle with embedded adventure content (export; JSON only). | |
| action | Yes | create, resume, switch, end, export, import, rename, description, list, archive, unarchive, info, genre, complete_session_zero, clone, branch, save_context, get_context, checkpoint_set, checkpoint_list, checkpoint_restore, checkpoint_remove, or provenance. | |
| detail | No | Return full metadata (list). | |
| filter | No | active, archived, or all (list). | |
| format | No | Output format (export). | |
| strict | No | Fail on any cross-reference mismatch (import). | |
| creator | No | Creator attributed on the Novel's provenance record (provenance). | |
| license | No | License declared on the Novel's provenance record (provenance). | |
| ruleset | No | Ruleset slug (create). | |
| new_name | No | Name for the copy or branch (clone/branch). | |
| new_slug | No | New slug (rename). | |
| from_event | No | Event-log ordinal to branch from (branch; default latest). | |
| attribution | No | Source attributed on the Novel's provenance record (provenance). | |
| description | No | Description (create/description). | |
| source_slug | No | Novel to copy or branch from (clone/branch). | |
| player_goals | No | Player goals (save_context). | |
| current_scene | No | Current-scene summary (save_context). | |
| codex_adventure | No | Codex adventure to seed from (create). | |
| long_term_plans | No | Long-term plans (save_context). | |
| short_term_plans | No | Short-term plans (save_context). | |
| immediate_situation | No | Immediate situation (save_context). | |
| include_checkpoints | No | Include checkpoints in export (default false; export). | |
| trim_audit_sessions | No | Keep only the most recent N sessions' audit entries in the clone (clone; default full copy). | |
| pending_player_action | No | Pending player action (save_context). |
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). |