livonian

{'type': 'object', 'title': 'livonian_deromanizeArguments', 'required': ['text'], 'properties': {'text': {'type': 'string', 'title': 'Text', 'maxLength': 4000, 'minLength': 1, 'description': 'Romanized (clean-ASCII) Livonian text to resolve back to real orthography. Returns the attested dictionary spelling(s) whose romanization matches (source=dictionary, exact) â\x80\x94 several may match one ambiguous key. On a miss, a single best-effort reconstruction (source=reconstruction, approximate=true), which is a guess: romanize is lossy, so case, stød, palatalization and macron length cannot be recovered.'}}}

{'type': 'object', '$defs': {'Candidate': {'type': 'object', 'title': 'Candidate', 'required': ['word', 'source'], 'properties': {'kind': {'anyOf': [{'enum': ['lemma', 'form'], 'type': 'string'}, {'type': 'null'}], 'title': 'Kind', 'default': None, 'description': 'For a lossy-family dictionary candidate, whether the word is a headword (lemma) or an inflected form. None for a reconstruction, and always None for Interslavic transliterate (which does not distinguish lemma from form).'}, 'word': {'type': 'string', 'title': 'Word', 'description': 'A real orthographic word (source=dictionary) or the best-effort reconstruction (source=reconstruction).'}, 'source': {'enum': ['dictionary', 'reconstruction'], 'type': 'string', 'title': 'Source', 'description': 'dictionary = an ATTESTED spelling recalled from the dictionary index (exact, no guessing); reconstruction = a best-effort algorithmic guess, returned only when no attested word matched (never emitted by Interslavic transliterate, which returns empty on a miss instead).'}}, 'description': 'One candidate spelling from a reverse-lookup surface (deromanize /\ndetransliterate, or Interslavic transliterate).'}}, 'title': 'DeromanizedText', 'required': ['candidates', 'approximate'], 'properties': {'candidates': {'type': 'array', 'items': {'$ref': '#/$defs/Candidate'}, 'title': 'Candidates'}, 'approximate': {'type': 'boolean', 'title': 'Approximate'}}, 'description': "The MCP-facing payload: candidates only. ``original`` is deliberately absent â\x80\x94\nthe MCP result reaches an LLM's context, so the raw caller text must not be echoed\n(mirrors ``RomanizedText``/``TransliteratedText``)."}

{'type': 'object', 'title': 'livonian_get_inflectionsArguments', 'required': ['entry_id', 'word_class'], 'properties': {'entry_id': {'anyOf': [{'type': 'integer'}, {'type': 'string'}], 'title': 'Entry Id', 'description': 'The word id from a search result\'s inflection handle. Accepts a number or a digit-string (e.g. 17746 or "17746").'}, 'word_class': {'type': 'string', 'title': 'Word Class', 'pattern': '^[a-z]+$', 'maxLength': 8, 'minLength': 1, 'description': "The word-class code from a search result's inflection handle (e.g. 's' = noun, 'adj' = adjective, 'vi' = intransitive verb, 'vt' = transitive verb)."}}}

{'type': 'object', '$defs': {'Polarity': {'type': 'object', 'title': 'Polarity', 'required': ['affirmative', 'negative'], 'properties': {'negative': {'type': 'string', 'title': 'Negative'}, 'affirmative': {'type': 'string', 'title': 'Affirmative'}}, 'description': 'A verbal cell: the two polarities of one person in one mood/tense. ``negative``\nis the ready-to-use form â\x80\x94 the negation auxiliary (äb/äd/iz/algõâ\x80¦) is already folded\nin (e.g. ``äb toup``), not orphaned in a separate column. Livonian forms are verbatim.'}, 'NumberForms': {'type': 'object', 'title': 'NumberForms', 'required': ['singular', 'plural'], 'properties': {'plural': {'type': 'string', 'title': 'Plural'}, 'singular': {'type': 'string', 'title': 'Singular'}}, 'description': 'A nominal cell: the two number forms of one case. Livonian forms are verbatim.'}, 'VerbalParadigm': {'type': 'object', 'title': 'VerbalParadigm', 'required': ['entry_id', 'word_class', 'finite', 'nonfinite'], 'properties': {'found': {'type': 'boolean', 'const': True, 'title': 'Found', 'default': True}, 'finite': {'type': 'object', 'title': 'Finite', 'description': "Mood/tense (English, lower-case: 'present', 'past', 'conditional', â\x80¦) â\x86\x92 pronoun (Livonian, verbatim: ma/sa/ta/mÄ\x93g/tÄ\x93g/ne) â\x86\x92 {affirmative, negative}. The negative already includes its auxiliary.", 'additionalProperties': {'type': 'object', 'additionalProperties': {'$ref': '#/$defs/Polarity'}}}, 'source': {'type': 'string', 'title': 'Source', 'default': 'ErnÅ¡treits, Valts (ed. in chief), Viitso, Tiit-Rein, Kurpniece, Milda & VÄ\x81vere, Signis. 2024. Livonian morphology database. Riga: University of Latvia Livonian Institute. https://livonian.tech/ (CC BY-SA 4.0)'}, 'category': {'type': 'string', 'const': 'verbal', 'title': 'Category', 'default': 'verbal'}, 'entry_id': {'type': 'string', 'title': 'Entry Id'}, 'nonfinite': {'type': 'object', 'title': 'Nonfinite', 'description': "Non-finite section (English, lower-case: 'principal parts', 'participles') â\x86\x92 form label (English) â\x86\x92 the Livonian form.", 'additionalProperties': {'type': 'object', 'additionalProperties': {'type': 'string'}}}, 'word_class': {'type': 'string', 'title': 'Word Class'}}, 'description': 'Conjugation of a verb, grouped the way the grammar is: finite moods/tenses by\nperson and polarity, plus the non-finite forms.\n\n``category`` discriminates this from the nominal and not-found shapes.'}, 'NominalParadigm': {'type': 'object', 'title': 'NominalParadigm', 'required': ['entry_id', 'word_class', 'cases'], 'properties': {'cases': {'type': 'object', 'title': 'Cases', 'description': "Case name (English, lower-case) â\x86\x92 its singular/plural forms, in paradigm order, e.g. 'nominative', 'genitive', 'partitive'.", 'additionalProperties': {'$ref': '#/$defs/NumberForms'}}, 'found': {'type': 'boolean', 'const': True, 'title': 'Found', 'default': True}, 'source': {'type': 'string', 'title': 'Source', 'default': 'ErnÅ¡treits, Valts (ed. in chief), Viitso, Tiit-Rein, Kurpniece, Milda & VÄ\x81vere, Signis. 2024. Livonian morphology database. Riga: University of Latvia Livonian Institute. https://livonian.tech/ (CC BY-SA 4.0)'}, 'category': {'type': 'string', 'const': 'nominal', 'title': 'Category', 'default': 'nominal'}, 'entry_id': {'type': 'string', 'title': 'Entry Id'}, 'word_class': {'type': 'string', 'title': 'Word Class'}}, 'description': 'Declension of a noun/adjective/numeral/pronoun: case â\x86\x92 {singular, plural}.\n\n``category`` discriminates this from the verbal and not-found shapes â\x80\x94 switch on it\nbefore reading the body.'}, 'ParadigmNotFound': {'type': 'object', 'title': 'ParadigmNotFound', 'required': ['entry_id', 'word_class'], 'properties': {'found': {'type': 'boolean', 'const': False, 'title': 'Found', 'default': False}, 'source': {'type': 'string', 'title': 'Source', 'default': 'ErnÅ¡treits, Valts (ed. in chief), Viitso, Tiit-Rein, Kurpniece, Milda & VÄ\x81vere, Signis. 2024. Livonian morphology database. Riga: University of Latvia Livonian Institute. https://livonian.tech/ (CC BY-SA 4.0)'}, 'category': {'type': 'string', 'const': 'not_found', 'title': 'Category', 'default': 'not_found'}, 'entry_id': {'type': 'string', 'title': 'Entry Id'}, 'word_class': {'type': 'string', 'title': 'Word Class'}}, 'description': 'No paradigm for this entry_id/word_class (the morphology DB has none, or the\nhandle was wrong). ``found`` is False and there is no table body.'}}, 'title': 'livonian_get_inflectionsOutput', 'required': ['result'], 'properties': {'result': {'oneOf': [{'$ref': '#/$defs/NominalParadigm'}, {'$ref': '#/$defs/VerbalParadigm'}, {'$ref': '#/$defs/ParadigmNotFound'}], 'title': 'Result', 'discriminator': {'mapping': {'verbal': '#/$defs/VerbalParadigm', 'nominal': '#/$defs/NominalParadigm', 'not_found': '#/$defs/ParadigmNotFound'}, 'propertyName': 'category'}}}}

{'type': 'object', 'title': 'livonian_romanizeArguments', 'required': ['text'], 'properties': {'text': {'type': 'string', 'title': 'Text', 'maxLength': 4000, 'minLength': 1, 'description': "Livonian text to reduce to clean, pronounceable ASCII. Strips macrons, diacritics and capitals (Ä\x81â\x86\x92aa, Å¡â\x86\x92sh, õâ\x86\x92u), softens a palatalized consonant (Å\x86 ļ Å\x97 Å£ á¸\x91) only before a vowel (Å\x86+aâ\x86\x92nya, else ikÅ¡iggiÅ\x86â\x86\x92ikshiggin), and hyphenates the broken tone (si'zzõlâ\x86\x92siz-zul) and long-vowel diphthong glides (kÄ«enâ\x86\x92kee-en). Pass a word, phrase, or several lines."}}}

{'type': 'object', 'title': 'RomanizedText', 'required': ['text'], 'properties': {'text': {'type': 'string', 'title': 'Text', 'description': 'The romanized ASCII output.'}}, 'description': "The MCP-facing romanization payload: the ASCII output only. ``original`` is\ndeliberately absent â\x80\x94 like the Markdown render (see\n:func:`~livonian.languages.livonian.render.romanization_to_markdown`), the MCP\nresult reaches an LLM's context, so the raw caller text must not be echoed\nthrough it. The JSON API's :class:`Romanization` keeps the echo for\nprogrammatic callers."}

{'type': 'object', '$defs': {'SearchLanguage': {'enum': ['liv', 'lat', 'est', 'eng'], 'type': 'string', 'title': 'SearchLanguage', 'description': "Which language the query word is matched against. Headwords come back in\nLivonian and glosses in English either way; this only selects the language the\nquery term is in. Codes are the site's own."}}, 'title': 'livonian_searchArguments', 'required': ['query'], 'properties': {'query': {'type': 'string', 'title': 'Query', 'maxLength': 120, 'minLength': 1, 'description': "A SINGLE content word, not a phrase. Exactly one word per call â\x80\x94 even with several candidates or synonyms in mind, search them one at a time ('see', then 'look'), never combined into one query like 'see look'. Drop function words and infinitive markers â\x80\x94 search 'to water' as 'water', 'the sea' as 'sea'. The dictionary matches one attested headword, so a multi-word query often returns nothing even when the word exists; search the main word first, then refine. May be Livonian, Latvian, Estonian, or English (e.g. 'jarÄ\x81', 'away', 'sea'). Matching is bidirectional. An inflected Livonian form (search_language='liv') is resolved to its dictionary lemma automatically when the form is known â\x80\x94 the result says so when that happened."}, 'max_forms': {'anyOf': [{'type': 'integer', 'maximum': 12, 'minimum': 0}, {'type': 'null'}], 'title': 'Max Forms', 'default': None, 'description': "Optional override for how many inflection tables to expand this call (0â\x80\x9312). Raise it to pull more tables in ONE call on a broad query, or set a small value to keep a broad query cheap. On an uncached query each table is fetched sequentially with polite pacing toward the upstream, so a high value on a cold broad query is slow â\x80\x94 the bound limits upstream fan-out, not just response size. Omit to use the server's default cap."}, 'include_forms': {'type': 'boolean', 'title': 'Include Forms', 'default': True, 'description': "When true (default), each match's full inflection table is returned INLINE â\x80\x94 usable cases/tenses in ONE call, no follow-up livonian_get_inflections. Set false to get just the headword handles + glosses: a cheap way to SCREEN several candidate words or synonyms (which exist? which sense?) before spending forms on the one you pick. Bounded by a per-search cap â\x80\x94 use max_forms to raise or lower it for this call."}, 'search_language': {'$ref': '#/$defs/SearchLanguage', 'default': 'eng', 'description': "Language your query word is in â\x80\x94 selects which language the search matches against: 'eng' (default), 'liv', 'lat', or 'est'. For Englishâ\x86\x92Livonian translation, keep 'eng'. Glosses are in English."}}}

{'type': 'object', '$defs': {'Entry': {'type': 'object', 'title': 'Entry', 'required': ['headword'], 'properties': {'senses': {'type': 'array', 'items': {'$ref': '#/$defs/Sense'}, 'title': 'Senses'}, 'entry_id': {'type': 'string', 'title': 'Entry Id', 'default': '', 'description': 'Numeric word id for the forms endpoint.'}, 'headword': {'type': 'string', 'title': 'Headword'}, 'type_code': {'type': 'string', 'title': 'Type Code', 'default': '', 'description': "Paradigm type code, e.g. '99', '53a'."}, 'word_class': {'type': 'string', 'title': 'Word Class', 'default': '', 'description': "Word-class code, e.g. 's', 'vt', 'adj'."}, 'pronunciation': {'type': 'string', 'title': 'Pronunciation', 'default': '', 'description': 'Phonetic form in braces, e.g. {äm}.'}, 'part_of_speech': {'type': 'string', 'title': 'Part Of Speech', 'default': '', 'description': "e.g. 'noun', 'verb', 'adjective'."}}, 'description': 'One dictionary entry (one upstream result card): the headword with its\npronunciation, part of speech, paradigm anchors, and senses.\n\n``entry_id`` + ``word_class`` are the same anchors carried by an\n:class:`InflectionHandle` â\x80\x94 feed them to ``livonian_get_inflections`` for the full paradigm.\nEvery field except ``headword``/``gloss`` defaults, so a card missing a\npronunciation, type code, or senses still validates.'}, 'Sense': {'type': 'object', 'title': 'Sense', 'required': ['gloss'], 'properties': {'gloss': {'type': 'string', 'title': 'Gloss'}, 'label': {'type': 'string', 'title': 'Label', 'default': ''}, 'examples': {'type': 'array', 'items': {'$ref': '#/$defs/Example'}, 'title': 'Examples'}}, 'description': 'One sense of a headword: its gloss and any usage examples. ``label`` is the\nupstream sense marker (``a)``, ``b)``) and is empty for a single, unlabelled sense.'}, 'Example': {'type': 'object', 'title': 'Example', 'required': ['livonian'], 'properties': {'english': {'type': 'string', 'title': 'English', 'default': ''}, 'livonian': {'type': 'string', 'title': 'Livonian'}}, 'description': 'One usage example for a sense: the Livonian sentence and its English translation.\n``english`` is empty when the upstream entry gives the Livonian without a gloss.'}, 'Polarity': {'type': 'object', 'title': 'Polarity', 'required': ['affirmative', 'negative'], 'properties': {'negative': {'type': 'string', 'title': 'Negative'}, 'affirmative': {'type': 'string', 'title': 'Affirmative'}}, 'description': 'A verbal cell: the two polarities of one person in one mood/tense. ``negative``\nis the ready-to-use form â\x80\x94 the negation auxiliary (äb/äd/iz/algõâ\x80¦) is already folded\nin (e.g. ``äb toup``), not orphaned in a separate column. Livonian forms are verbatim.'}, 'NumberForms': {'type': 'object', 'title': 'NumberForms', 'required': ['singular', 'plural'], 'properties': {'plural': {'type': 'string', 'title': 'Plural'}, 'singular': {'type': 'string', 'title': 'Singular'}}, 'description': 'A nominal cell: the two number forms of one case. Livonian forms are verbatim.'}, 'SearchLanguage': {'enum': ['liv', 'lat', 'est', 'eng'], 'type': 'string', 'title': 'SearchLanguage', 'description': "Which language the query word is matched against. Headwords come back in\nLivonian and glosses in English either way; this only selects the language the\nquery term is in. Codes are the site's own."}, 'VerbalParadigm': {'type': 'object', 'title': 'VerbalParadigm', 'required': ['entry_id', 'word_class', 'finite', 'nonfinite'], 'properties': {'found': {'type': 'boolean', 'const': True, 'title': 'Found', 'default': True}, 'finite': {'type': 'object', 'title': 'Finite', 'description': "Mood/tense (English, lower-case: 'present', 'past', 'conditional', â\x80¦) â\x86\x92 pronoun (Livonian, verbatim: ma/sa/ta/mÄ\x93g/tÄ\x93g/ne) â\x86\x92 {affirmative, negative}. The negative already includes its auxiliary.", 'additionalProperties': {'type': 'object', 'additionalProperties': {'$ref': '#/$defs/Polarity'}}}, 'source': {'type': 'string', 'title': 'Source', 'default': 'ErnÅ¡treits, Valts (ed. in chief), Viitso, Tiit-Rein, Kurpniece, Milda & VÄ\x81vere, Signis. 2024. Livonian morphology database. Riga: University of Latvia Livonian Institute. https://livonian.tech/ (CC BY-SA 4.0)'}, 'category': {'type': 'string', 'const': 'verbal', 'title': 'Category', 'default': 'verbal'}, 'entry_id': {'type': 'string', 'title': 'Entry Id'}, 'nonfinite': {'type': 'object', 'title': 'Nonfinite', 'description': "Non-finite section (English, lower-case: 'principal parts', 'participles') â\x86\x92 form label (English) â\x86\x92 the Livonian form.", 'additionalProperties': {'type': 'object', 'additionalProperties': {'type': 'string'}}}, 'word_class': {'type': 'string', 'title': 'Word Class'}}, 'description': 'Conjugation of a verb, grouped the way the grammar is: finite moods/tenses by\nperson and polarity, plus the non-finite forms.\n\n``category`` discriminates this from the nominal and not-found shapes.'}, 'NominalParadigm': {'type': 'object', 'title': 'NominalParadigm', 'required': ['entry_id', 'word_class', 'cases'], 'properties': {'cases': {'type': 'object', 'title': 'Cases', 'description': "Case name (English, lower-case) â\x86\x92 its singular/plural forms, in paradigm order, e.g. 'nominative', 'genitive', 'partitive'.", 'additionalProperties': {'$ref': '#/$defs/NumberForms'}}, 'found': {'type': 'boolean', 'const': True, 'title': 'Found', 'default': True}, 'source': {'type': 'string', 'title': 'Source', 'default': 'ErnÅ¡treits, Valts (ed. in chief), Viitso, Tiit-Rein, Kurpniece, Milda & VÄ\x81vere, Signis. 2024. Livonian morphology database. Riga: University of Latvia Livonian Institute. https://livonian.tech/ (CC BY-SA 4.0)'}, 'category': {'type': 'string', 'const': 'nominal', 'title': 'Category', 'default': 'nominal'}, 'entry_id': {'type': 'string', 'title': 'Entry Id'}, 'word_class': {'type': 'string', 'title': 'Word Class'}}, 'description': 'Declension of a noun/adjective/numeral/pronoun: case â\x86\x92 {singular, plural}.\n\n``category`` discriminates this from the verbal and not-found shapes â\x80\x94 switch on it\nbefore reading the body.'}, 'InflectionHandle': {'type': 'object', 'title': 'InflectionHandle', 'required': ['entry_id', 'word_class'], 'properties': {'forms': {'anyOf': [{'oneOf': [{'$ref': '#/$defs/NominalParadigm'}, {'$ref': '#/$defs/VerbalParadigm'}, {'$ref': '#/$defs/ParadigmNotFound'}], 'discriminator': {'mapping': {'verbal': '#/$defs/VerbalParadigm', 'nominal': '#/$defs/NominalParadigm', 'not_found': '#/$defs/ParadigmNotFound'}, 'propertyName': 'category'}}, {'type': 'null'}], 'title': 'Forms', 'default': None, 'description': "The full inflection paradigm, populated when a search is asked to include forms. None when not requested or beyond the cap; category 'none' when the word has no paradigm."}, 'context': {'type': 'string', 'title': 'Context', 'default': '', 'description': 'Nearby headword / entry text.'}, 'entry_id': {'type': 'string', 'title': 'Entry Id', 'description': 'Numeric word id used by the forms endpoint.'}, 'pos_hint': {'type': 'string', 'title': 'Pos Hint', 'default': '', 'description': 'Part-of-speech hint near the link.'}, 'word_class': {'type': 'string', 'title': 'Word Class', 'description': "Word-class code, e.g. 's', 'vi', 'vt', 'adj'."}}, 'description': 'A reliable, structured anchor for fetching a full paradigm. Feed\n``entry_id`` + ``word_class`` to ``livonian_get_inflections`` â\x80\x94 or ask ``search`` to\ninclude the table inline (``forms``).'}, 'ParadigmNotFound': {'type': 'object', 'title': 'ParadigmNotFound', 'required': ['entry_id', 'word_class'], 'properties': {'found': {'type': 'boolean', 'const': False, 'title': 'Found', 'default': False}, 'source': {'type': 'string', 'title': 'Source', 'default': 'ErnÅ¡treits, Valts (ed. in chief), Viitso, Tiit-Rein, Kurpniece, Milda & VÄ\x81vere, Signis. 2024. Livonian morphology database. Riga: University of Latvia Livonian Institute. https://livonian.tech/ (CC BY-SA 4.0)'}, 'category': {'type': 'string', 'const': 'not_found', 'title': 'Category', 'default': 'not_found'}, 'entry_id': {'type': 'string', 'title': 'Entry Id'}, 'word_class': {'type': 'string', 'title': 'Word Class'}}, 'description': 'No paradigm for this entry_id/word_class (the morphology DB has none, or the\nhandle was wrong). ``found`` is False and there is no table body.'}}, 'title': 'SearchResult', 'required': ['query', 'language', 'found'], 'properties': {'found': {'type': 'boolean', 'title': 'Found', 'description': 'False when nothing matched.'}, 'query': {'type': 'string', 'title': 'Query'}, 'source': {'type': 'string', 'title': 'Source', 'default': 'ErnÅ¡treits, Valts (ed. in chief), Viitso, Tiit-Rein, VÄ\x81vere, Signis, Damberg, PÄ\x93tõr, Kurpniece, Milda, Balodis, Uldis, Tuisk, Tuuli, KÅ«la, Gita, Tomingas, Marili, Soosaar Sven-Erik, SedláÄ\x8dková, Anna & Jurgenovskis, Toms. 2024. Livonian lexicographic database. Riga: University of Latvia Livonian Institute. https://livonian.tech/ (CC BY-SA 4.0)'}, 'entries': {'type': 'array', 'items': {'$ref': '#/$defs/Entry'}, 'title': 'Entries', 'description': 'Structured dictionary entries: headword, pronunciation, part of speech, paradigm anchors, and senses with example sentences.'}, 'handles': {'type': 'array', 'items': {'$ref': '#/$defs/InflectionHandle'}, 'title': 'Handles'}, 'language': {'$ref': '#/$defs/SearchLanguage'}, 'resolved_from': {'type': 'string', 'title': 'Resolved From', 'default': '', 'description': "The original inflected query when search_method='lemma_index'; empty on a direct match."}, 'search_method': {'enum': ['direct', 'lemma_index'], 'type': 'string', 'title': 'Search Method', 'default': 'direct', 'description': "How the match was found: 'direct' = the query itself matched; 'lemma_index' = the query was an inflected Livonian form, resolved to its dictionary lemma via the cached paradigm index and re-searched."}, 'resolved_lemma': {'type': 'string', 'title': 'Resolved Lemma', 'default': '', 'description': "The dictionary lemma actually searched when search_method='lemma_index'; empty on a direct match."}, 'forms_truncated': {'type': 'integer', 'title': 'Forms Truncated', 'default': 0, 'description': 'How many handles did NOT get an inline table because the per-search cap was reached. Refine the query or call livonian_get_inflections.'}}, 'description': 'The result of a dictionary search.'}