Preview converting a character to its ruleset's successor
vault_preview_character_conversionPreview the version vault would make, in the ruleset that succeeds its own, of a character the user may edit (their own, or any for an admin with Admin Mode on). Creates nothing. Vault decides which rulesets convert and to which: the result's ruleset is { from, to } (codes; list_rulesets has their labels), and a character of a ruleset with no successor answers 409. The conversion makes a new version of the same character as its linked sheet in ruleset.to, beside the untouched original: it translates the sheet's records and keeps its numbers (ability scores, hit points, skills), and it is not a rules rebuild. The conversion asks the user nothing: vault makes every choice and reports it, and anything the user disagrees with they change on the new sheet afterward. Returns character ({ _id, name, updatedAt }), ruleset, fills (the blank linked sheet that will be filled in, or null when a new character will be made), and report, the forecast of what the conversion will do: { sections: [{ key, title, count, rows }] }, each row { name, result, note, text } (the thing on the original, what it becomes, and a sentence about it), or { name, before, after, text } for a total that comes out different. Every row's text is what follows its name, as vault words it ( → <result>, : <before>, now <after>, or empty): show each row as its name, then its text, then its note. Show the user the report as vault gives it, section by section, and ask whether to convert; then call vault_convert_character with character.updatedAt. Vault answers 409 when the character's ruleset does not convert, the character is not a player character, it already has a linked sheet in ruleset.to that has been used (deleting that sheet makes way), or the character was saved while vault read it (OUT_OF_SYNC: preview again), 403 when the owner is at the character limit or lacks the ruleset, and 404 for an unknown character or one the user may not edit. A 500 here is a fault in vault's own content that this character's conversion ran into; trying again will not fix it, so tell the user it needs reporting.
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": {
"id": "<id>"
},
"name": "vault_preview_character_conversion"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | Mongo `_id` of the character to convert (owned by the calling user, or any character for an admin with Admin Mode on). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||