Lingard

Adds cards to an existing Lingard collection, deduplicating by normalized word title. Pass commit=true to write. By default every AI-generated card must include all applicable useful fields except image: title, translate, pos, pron/ipa, syns, and examples with translations. For German/Romance nouns, include the dictionary article in title/word when needed, e.g. der Hund, die Reise, das Haus. Example text and example translation must highlight the target word/translated word with {}. form is not part of speech; use it only for the current inflected-form category, otherwise omit/null it. Do not add word+translation-only cards unless the user explicitly requests sparse cards and allowIncompleteCards=true.

lingard_add_words_to_collection

Attaches generated or supplied images to existing Lingard cards. This tool does not generate images from prompt alone: pass actual imageBase64, dataUri, or imageUrl. PNG, JPEG, WebP, and SVG inputs are converted to WebP and uploaded as private custom card images. Pass commit=true to write.

lingard_attach_card_images

Commits a previously previewed or freshly supplied Lingard vocabulary change. For AI-generated new cards, include all applicable useful fields except image by default: title, translate, pos, pron/ipa, syns, and examples with translations. For German/Romance nouns, include the dictionary article in title/word when needed, e.g. der Hund, die Reise, das Haus. Example text and example translation must highlight the target word/translated word with {}. form is not part of speech; use it only for the current inflected-form category, otherwise omit/null it. Do not write word+translation-only cards unless allowIncompleteCards=true was explicitly requested by the user.

lingard_commit_vocab_changes

Creates a Lingard vocabulary collection, optionally with initial cards. Pass commit=true to write. By default every AI-generated card must include all applicable useful fields except image: title, translate, pos, pron/ipa, syns, and examples with translations. For German/Romance nouns, include the dictionary article in title/word when needed, e.g. der Hund, die Reise, das Haus. Example text and example translation must highlight the target word/translated word with {}. form is not part of speech; use it only for the current inflected-form category, otherwise omit/null it. Do not create word+translation-only cards unless the user explicitly requests sparse cards and allowIncompleteCards=true.

lingard_create_vocab_collection

Use this after search, or when the user gives a Lingard resource URI such as lingard://learning-context/en. Fetches the full live Lingard JSON record from Firestore.

fetch

Fills empty fields on existing Lingard cards. It never overwrites non-empty fields, except a card may use clearFields:["form"] to clear an incorrect grammatical form when the word is base/unmarked. Pass commit=true to write.

lingard_fill_missing_card_fields

Returns live Lingard cards in a collection that are missing requested fields such as translation, POS, pronunciation, examples, or image. Use before filling missing fields. A curated Lingard collection always reports zero gaps: its words come from the Lingard catalog and are not the user's to fill.

lingard_get_collection_gaps

Call this first whenever the user asks for their current Lingard learning context, English profile, vocabulary totals, saved collections, collection titles, card counts, or missing-field stats. Reads live Lingard Firestore data; do not answer from memory or generic Lingard history. Every collection reports `source`: "user" (made by the user), "catalog" (a curated Lingard collection — read-only, its words come from the Lingard catalog) and "unfiled" (the bucket of cards saved while reading, which belong to no collection). Never tell the user a collection is missing or that the account looks wrong just because they only recognise some of the titles.

lingard_get_learning_context

Returns live cards from one Lingard vocabulary collection by UUID or title, including curated Lingard collections and the "Words not in a collection" bucket of cards saved while reading. Use this when the user asks what words/cards are in a specific Lingard collection. Pass includeExamples:true to also read each card's example sentences and their translations — required before editing them.

lingard_get_vocab_collection

Returns live Lingard profile level, topic, collection context, and existing words so the calling AI can suggest level-appropriate new cards without duplicates.

lingard_get_word_suggestion_context