conversion_braille
Convert text to and from Grade 1 or 2 Unicode Braille. Encode plain text into braille or decode braille back to Latin text for preview and education.
Instructions
Braille Converter (Grade 1 & 2). Convert text to and from Unicode Braille patterns (U+2800-U+28FF), in either uncontracted Grade 1 (letter-by-letter) or contracted Grade 2 (word/letter-group contractions). Use it to preview how labels, signage, or short copy render in braille cells, or to read back braille into Latin text; it is a preview/education aid, not a certified textbook/Nemeth/music transcription engine. Runs locally on the supplied text: read-only, non-destructive, contacts no external service, and is rate-limited. Returns the braille (or decoded text) string, the ASCII-braille form, per-conversion analysis stats, and reference braille_info for the chosen grade.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| text | Yes | Input to convert: plain text when operation=encode, or a Unicode braille string when operation=decode. Trimmed; must be non-empty. Unsupported characters become the question-mark braille cell. | |
| operation | Yes | encode = text to braille; decode = braille to text. | |
| grade | No | 1 = uncontracted (each letter individually); 2 = contracted (uses word/letter-group contractions, ~20-30% shorter). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| success | No | Whether the conversion succeeded. | |
| result | No | The converted output: braille for encode, Latin text for decode. | |
| analysis | No | Per-conversion stats (operation, input_length, output_length, compression_ratio, character_stats, braille_stats); null on error. | |
| braille_info | No | Reference facts for the selected grade (name, description, cell_structure, inventor, supported_chars, etc.). | |
| grade | No | The braille grade used. | |
| ascii_braille | No | ASCII-braille (computer braille) form of the braille output. | |
| error | No | Error message, present only when success is false. |