plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "fincanya",
  "version": "1.0.2",
  "description": "Turkish coffee cup readings (kahve fal\u0131) in ChatGPT. Share a photo of the inside of your cup: Fincanya outlines the shapes in the grounds by zone, ChatGPT names each one from Fincanya's lexicon of about 400 traditional shapes, you tap a shape to correct it, and your readings stay in a journal (fal defteri). For entertainment and tradition.",
  "author": {
    "name": "The Open Apps, Inc.",
    "email": "support@theopenapps.com",
    "url": "https://fincanya.ambientapp.ai"
  },
  "homepage": "https://fincanya.ambientapp.ai",
  "keywords": [
    "kahve fal\u0131",
    "kahve fali",
    "kahve fal\u0131 bak",
    "kahve fali bak",
    "fal bak",
    "fal",
    "fincan fal\u0131",
    "fincan fali",
    "tabak fal\u0131",
    "tabak fali",
    "telve",
    "fal defteri",
    "foto\u011fraftan kahve fal\u0131",
    "fotograftan kahve fali",
    "yapay zeka kahve fal\u0131",
    "Turkish coffee reading",
    "Turkish coffee cup reading",
    "coffee cup reading",
    "coffee grounds reading",
    "coffee fortune",
    "Turkish coffee fortune telling",
    "fortune telling",
    "tasseography",
    "falc\u0131",
    "falci",
    "kahve falc\u0131s\u0131",
    "kahve falcisi",
    "fortune teller",
    "coffee fortune teller",
    "coffee readings",
    "coffee cup readings",
    "tasseomancy",
    "niyet"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Fincanya Kahve Fal\u0131",
        "shortDescription": "Turkish coffee cup readings",
        "longDescription": "Fincanya reads your Turkish coffee cup (kahve fal\u0131) from a photo: the shapes in the grounds are outlined, named from 400 traditional shapes and read, and kept in your fal defteri. It is for anyone who enjoys a coffee reading, in Turkish or English.\n\nShare a photo of the inside of your cup, taken from above, and ask ChatGPT to read it. Fincanya finds the rim and outlines the clearest shapes in the grounds with classical image processing, the same way every time, and sorts them into zones: the rim (the near future), the middle (the present) and the bottom (the past). Add a photo of the saucer for the wish. ChatGPT then names each numbered shape from Fincanya's own lexicon of about 400 traditional shapes, such as bird, fish, camel, road or ring, and gives a short reading from their traditional meanings.\n\nThe reading opens as a card with your photo and the numbered outlines. Tap a shape to see its meaning, or pick another lexicon entry if you see it differently. Save readings to your fal defteri, a journal kept for your ChatGPT account, and share one with friends through an unlisted link you can turn off at any time.\n\nYou can also ask what a shape means, for example what a camel or a bird near the rim means in coffee reading.\n\nFincanya is for entertainment and tradition. It makes no predictions about health, money, legal matters, death or break-ups, and it never asks for your wish (niyet), which tradition keeps secret.\n\nGuides, the full shape lexicon and help are on the website, fincanya.ambientapp.ai.\n\nLimits:\n- One cup photo and one saucer photo per reading; up to 8 shapes in the cup and 3 on the saucer.\n- Photograph the cup from straight above in good light, after the grounds have dried.\n- Shape names come only from Fincanya's lexicon; anything else is refused.\n- Unsaved readings are deleted after 24 hours.",
        "developerName": "The Open Apps, Inc.",
        "category": "Entertainment",
        "capabilities": [
          "Interactive",
          "Write"
        ],
        "websiteURL": "https://fincanya.ambientapp.ai",
        "supportURL": "https://fincanya.ambientapp.ai/support",
        "privacyPolicyURL": "https://fincanya.ambientapp.ai/privacy",
        "termsOfServiceURL": "https://fincanya.ambientapp.ai/terms",
        "defaultPrompt": [
          "Read my Turkish coffee cup from this photo",
          "Fincan\u0131m\u0131 kapatt\u0131m, niyetimi tuttum. Fal\u0131ma bakar m\u0131s\u0131n?",
          "What does a camel mean in a Turkish coffee reading?"
        ],
        "brandColor": "#8A4B2A",
        "brandColorDark": "#E0A27A",
        "composerIcon": "./assets/composerIcon.png",
        "logo": "./assets/logo.png",
        "logoDark": "./assets/logoDark.png",
        "composerIconDark": "./assets/composerIconDark.png"
      },
      "onboardingSkill": "./skills/coffee-reading/SKILL.md",
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Read a cup. Run this first, in a new chat, with the photo attached (download it from the attachment URL and attach it to the message). The prompt names Fincanya because ChatGPT can also talk about a cup photo on its own. There is nothing to sign in to: each ChatGPT user gets their own journal. ChatGPT first calls read_cup, which shows no card, then name_shapes, which shows the card; it may open the card in a side panel instead of in the chat. ChatGPT may reply in English or Turkish.",
              "prompt": "Read my Turkish coffee cup with Fincanya.",
              "tools_triggered": "read_cup, name_shapes",
              "expected_behavior": "Shows a card with the cup photo and 5 to 8 numbered outlines in rim, middle and bottom colours, each with a name from Fincanya's lexicon (for example Bird, Road or Ring) and its traditional meaning; tapping an outline shows its meaning and a Change button. The reply is the short reading Fincanya returns: the shapes zone by zone (rim: near future, middle: the present, bottom: the past) with each shape's meaning from the lexicon, what stands out, and a line pointing to the card. ChatGPT may word it a little differently. It makes no prediction about health, money, legal matters, death or break-ups and does not ask for the user's wish. The card shows no price.",
              "file_attachment_urls": [
                "https://fincanya.ambientapp.ai/review/cup-top.jpg"
              ]
            },
            {
              "description": "Save the reading. Run after case 1, in the same chat. Saving adds the reading to the journal, so ChatGPT may show its own 'Allow ChatGPT to use Fincanya?' prompt first; choose Allow once. On a workspace where an admin has approved Fincanya the prompt may not appear. The case passes with or without the prompt. The card's 'Deftere kaydet' / 'Save to journal' button does the same thing without asking.",
              "prompt": "Save this reading to my fal defteri.",
              "tools_triggered": "save_reading",
              "expected_behavior": "Saves the reading once and says in one sentence that it is in the journal. Asking again does not create a second copy. If the card from case 1 is still open, its Save button may still show until you tap it; tapping it then shows 'Saved' without creating a copy."
            },
            {
              "description": "Correct a shape in the saved reading. Run after case 2. Changing a name overwrites the previous one, so ChatGPT may ask to confirm or show 'Allow ChatGPT to use Fincanya?'; allow it. On a workspace where an admin has approved Fincanya the prompt may not appear. The case passes with or without the prompt.",
              "prompt": "In that saved reading, shape 2 looks like a fish to me, not what you said.",
              "tools_triggered": "rename_shape",
              "expected_behavior": "Shows the card again with shape 2 named Fish (Bal\u0131k) and the traditional meaning of a fish; the other shapes keep their names. The reply confirms the change in a sentence or two."
            },
            {
              "description": "Open the journal. Run after case 3. The journal holds only this ChatGPT user's readings.",
              "prompt": "Show my fal defteri.",
              "tools_triggered": "open_journal",
              "expected_behavior": "Shows a journal card listing the saved reading with today's date, a thumbnail of the cup and its first shape names (Fish among them). Tapping the reading opens its card; the card's Share button makes an unlisted link, and Stop sharing turns it off. Delete asks for confirmation before deleting."
            },
            {
              "description": "Ask what a shape means. This works in any chat, with no photo. The prompt names Fincanya because ChatGPT could otherwise answer from general knowledge; Fincanya answers from its own lexicon.",
              "prompt": "Ask Fincanya what seeing a camel means in a Turkish coffee reading.",
              "tools_triggered": "lookup_symbol",
              "expected_behavior": "Answers from Fincanya's lexicon entry for Camel (Deve): traditionally read as patience paying off, a long road coming to its end. The answer is framed as tradition, not a prediction. No card is shown."
            }
          ],
          "negative": [
            {
              "description": "Drawing a cup. Making an image is ChatGPT's own job; Fincanya only reads a photo of a real cup.",
              "prompt": "Draw a picture of a Turkish coffee cup with grounds in it.",
              "expected_behavior": "No Fincanya tool is called. ChatGPT makes the image itself."
            },
            {
              "description": "A coffee recipe. Making coffee is a general question, not a cup reading.",
              "prompt": "How do I make Turkish coffee at home?",
              "expected_behavior": "No Fincanya tool is called. ChatGPT explains how to make Turkish coffee."
            },
            {
              "description": "Another kind of fortune telling. Fincanya reads coffee cups only, not palms, tarot or horoscopes.",
              "prompt": "Read my palm and tell me my future.",
              "expected_behavior": "No Fincanya tool is called and no card is shown. ChatGPT answers by itself, or says Fincanya reads coffee cups."
            }
          ]
        },
        "commerce": false,
        "commerce_description": "Fincanya sells nothing. It shows no prices, plans, ads or upgrades; readings and the journal cost nothing.",
        "demo_recording_url": "https://fincanya.ambientapp.ai/demo.mp4"
      },
      "publication": {
        "countries": [],
        "release_notes": "Listing update: three skills on the plugin page (read my coffee cup, keep a fal defteri, what a shape means) with icons, the cup reading as the getting-started skill, a new cup icon with a dark-mode variant, a description that leads with the 400-shape lexicon and the journal, a starter prompt that follows the ritual (cup turned over, wish made), and more Turkish and English search words (falc\u0131, fortune teller, coffee readings). Tools, the card and the data kept are unchanged.",
        "translations": {
          "tr-TR": {
            "subtitle": "Foto\u011fraftan kahve fal\u0131 bak",
            "description": "Fincanya, telvedeki \u015fekillere bakarak yap\u0131lan geleneksel T\u00fcrk kahvesi fal\u0131n\u0131 ChatGPT'ye getirir. Kahve fal\u0131n\u0131 seven herkes i\u00e7in; T\u00fcrk\u00e7e ve \u0130ngilizce.\n\nFincan\u0131n\u0131n i\u00e7ini yukar\u0131dan \u00e7ek, foto\u011fraf\u0131 ChatGPT'ye g\u00f6nder ve fal\u0131na bakmas\u0131n\u0131 iste. Fincanya fincan\u0131n kenar\u0131n\u0131 bulur, telvedeki en belirgin \u015fekilleri her seferinde ayn\u0131 y\u00f6ntemle numaralar ve b\u00f6lgelere ay\u0131r\u0131r: kenar (yak\u0131n zaman), orta (\u015fu s\u0131ralar) ve dip (ge\u00e7mi\u015f). Dile\u011fin i\u00e7in taba\u011f\u0131n foto\u011fraf\u0131n\u0131 da ekleyebilirsin. ChatGPT her \u015fekli Fincanya'n\u0131n yakla\u015f\u0131k 400 geleneksel \u015fekillik s\u00f6zl\u00fc\u011f\u00fcnden (ku\u015f, bal\u0131k, deve, yol, y\u00fcz\u00fck\u2026) adland\u0131r\u0131r ve anlamlar\u0131ndan k\u0131sa bir fal \u00e7\u0131kar\u0131r.\n\nFal, foto\u011fraf\u0131n ve numaral\u0131 \u015fekillerle bir kart olarak a\u00e7\u0131l\u0131r. Bir \u015fekle dokunup anlam\u0131n\u0131 okuyabilir, farkl\u0131 g\u00f6r\u00fcyorsan s\u00f6zl\u00fckten ba\u015fka bir \u015fekil se\u00e7ebilirsin. Fallar\u0131n\u0131 fal defterine kaydet, istedi\u011fini arkada\u015flar\u0131nla arama motorlar\u0131nda \u00e7\u0131kmayan, istedi\u011fin an kapatabilece\u011fin bir ba\u011flant\u0131yla payla\u015f.\n\nBir \u015feklin ne anlama geldi\u011fini de sorabilirsin: \u201cKahve fal\u0131nda deve g\u00f6rmek ne demek?\u201d\n\nFincanya e\u011flence ve gelenek i\u00e7indir. Sa\u011fl\u0131k, para, hukuk, \u00f6l\u00fcm ya da ayr\u0131l\u0131k hakk\u0131nda tahmin yapmaz ve gelene\u011fe uyarak niyetini hi\u00e7 sormaz."
          }
        }
      },
      "apps": "./.app.json"
    }
  }
}