Propose a Correction
propose_correctionDuring a review shift, propose a correction to a page's transcription (field "ocr") or English (field "translation"). A correction is a list of exact span edits: each "find" must be copied exactly from the text the shift returned and occur once on the page (add surrounding words if it repeats); "replace" is the corrected text ("" deletes). Fix only what the scan or the original shows is wrong: misread letters, dropped or added words, a sentence the English skips. Do not restyle or modernise. Propose transcription fixes before translation fixes, as separate calls. Pass base_hash = page.text_version for that field. A proposal does NOT change the page: it is applied only after a second reader agrees, and the volunteer is credited. If the call says the page changed since it was loaded, say so and move on. drafted_by: "assistant" if you found and worded it in a book run, "volunteer" if the user supplied the wording, "assistant_accepted" if you drafted it and the user approved it specifically, "mixed" otherwise.
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": {
"item_id": "<item_id>",
"field": "<field>",
"base_hash": "<base_hash>",
"edits": "<edits>",
"volunteer_code": "<volunteer_code>",
"drafted_by": "<drafted_by>",
"assistant_model": "<assistant_model>"
},
"name": "propose_correction"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | How the user wants to be credited (optional) | |
| note | No | Anything the second reader should know (optional) | |
| edits | Yes | Span edits (1-30). | |
| field | Yes | "ocr" for the transcription, "translation" for the English | |
| item_id | Yes | page.item_id from the shift | |
| shift_id | No | ||
| base_hash | Yes | text_version.ocr or text_version.translation from the page | |
| drafted_by | Yes | ||
| volunteer_code | Yes | ||
| assistant_model | Yes | Your own model name and version, copied exactly as your instructions or system prompt give it, and whether extended thinking is on. Write "unknown" rather than guess; a wrong name is worse than none. | |
| user_agreed_to_terms | No | true if the user said yes when you asked whether their findings may be licensed to Source Library under https://sourcelibrary.org/terms. Pass it on every proposal of the shift. |