Fincanya Kahve Falı

Use this when the user says a shape in a saved reading is something else ("number 2 is a fish, not a bird"). Replaces that shape's name with another Fincanya lexicon entry and shows the updated card; the result text gives the new name and its traditional meaning. Readings that aren't saved yet are corrected through name_shapes with the new names, or in the card.

rename_shape

Use this only when the user asks to delete a saved reading, or their whole fal defteri (all: true). Permanently deletes the photo crops, outlines and names, and stops any share link. The result text is a one-sentence confirmation in the user's language.

delete_reading

Use this when the user asks what a shape means in Turkish coffee reading ("kahve falında deve görmek ne demek?"), or to find a lexicon entry while naming shapes. Searches the Fincanya lexicon in Turkish or English and returns up to 5 entries with their traditional meanings, plus a one-sentence answer from the top match (answer_en, answer_tr) that is suitable to show the user as is. Read-only.

lookup_symbol

Use this after read_cup to name the outlined shapes from the Fincanya lexicon of about 400 traditional shapes. Takes, for each shape_id, the lexicon entry the shape most resembles in the photo (one of its suggestions, or any lexicon name in Turkish or English); names outside the lexicon are refused with the closest entries. Returns each shape's traditional meaning, a short reading text built only from those meanings (reply_en, reply_tr) that is suitable to show the user as is, and shows the reading card: the photo with numbered outlines that the user can tap to correct. Saves nothing.

name_shapes

Use this when the user wants to see their past coffee readings (fal defteri), or one of them. Without reading_id it shows the list, newest first; with reading_id it shows that reading's card. The result text is a one-sentence summary in the user's language.

open_journal

Use this when the user shares a photo of the inside of their Turkish coffee cup for a coffee reading (kahve falı), optionally with a photo of the saucer. Finds the cup's rim and outlines up to 8 shapes in the grounds (3 on the saucer) with classical image processing, the same way every time, and returns where each shape is (rim, middle, bottom or saucer zone; clock position, 12 = top of the photo), its size, its form and 8 lexicon suggestions picked from its geometry (length, openings, symmetry, orientation) and zone. The result contains geometry and suggestions only, no meanings: name_shapes turns it into the reading. Shows no card and adds nothing to the user's fal defteri; the analysis (a crop of the cup and the outlines) is kept for 24 hours so name_shapes and save_reading can use it, then deleted. The same photo always gives the same analysis.

read_cup

Use this when the user asks to keep a reading in their fal defteri (coffee-reading journal). Saves the cup photo crop, the outlines and the names for this ChatGPT user only. Saving the same analysis again returns the reading already saved. The card's Save button does the same. The result text is a one-sentence confirmation in the user's language.

save_reading

Use this when the user wants a link to show a saved reading to friends. Creates an unlisted web page with the cup photo, the outlines, the names and their meanings, and returns its link; anyone with the link can view it until the user stops sharing. Calling it again returns the same link.

share_reading

Use this when the user wants a reading's share link to stop working. The link is turned off at once; the reading stays in the fal defteri.

stop_sharing