plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "sonarlex",
  "version": "1.0.0",
  "description": "A daily hidden-word game in ChatGPT. Each turn you try up to 5 words and see how close each is in meaning to a secret word that only Sonarlex's server knows: #1 is the word itself. One shared word a day in English and one in Turkish, scored by turns, with hints, streaks and share squares that give nothing away.",
  "author": {
    "name": "The Open Apps, Inc.",
    "email": "support@theopenapps.com",
    "url": "https://sonarlex.ambientapp.ai"
  },
  "homepage": "https://sonarlex.ambientapp.ai",
  "keywords": [
    "word game",
    "word puzzle",
    "daily puzzle",
    "guess the word",
    "hidden word",
    "kelime oyunu",
    "Turkish",
    "vocabulary"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Sonarlex Word Puzzle",
        "shortDescription": "Daily game: guess the word",
        "longDescription": "Sonarlex is a daily hidden-word game. Every day everyone playing a language hunts the same secret word. Each turn you try up to 5 words, and each gets a number for how close it is in meaning to the secret word: #1 is the word itself, #2 its closest word, and the lower the number, the warmer you are. Find it in as few turns as you can.\n\nType your words in the card or just tell ChatGPT, for example \"ocean, ship, salt\". Plurals and other forms count as their base word, and in Turkish you can type without Turkish letters.\n\nThe secret word stays on Sonarlex's server: neither you nor ChatGPT can see it, so ChatGPT plays as an honest teammate. Ask it for ideas if you like; words it suggests are marked in your share squares.\n\nStuck? You get 3 hints a puzzle, each showing a word about halfway between your closest word so far and the secret, for one turn each. Give up and Sonarlex shows the word and its closest words. When you find it, the card shows today's median and coloured share squares that give nothing away. Your streak grows each day you solve it. New to the game? Start with the practice puzzle, whose word never changes.\n\nLimits:\n- One shared word a day per language: English (a new word at midnight UTC) and Turkish (at midnight T\u00fcrkiye time). Sonarlex follows your ChatGPT language; say \"in Turkish\" or \"in English\" to switch.\n- About 28,000 English and 22,000 Turkish words have a number. Phrases, very common words such as \"the\" and offensive words don't, and trying one costs nothing.\n- Closeness comes from openly licensed word vectors (GloVe for English, fastText for Turkish), so it reflects how words are used, not a dictionary.\n- No accounts: Sonarlex keeps your boards and streak under ChatGPT's anonymous user ID. Say \"Delete my Sonarlex data\" to delete them.",
        "developerName": "The Open Apps, Inc.",
        "category": "Entertainment",
        "capabilities": [
          "Interactive",
          "Write"
        ],
        "websiteURL": "https://sonarlex.ambientapp.ai",
        "supportURL": "https://sonarlex.ambientapp.ai/support",
        "privacyPolicyURL": "https://sonarlex.ambientapp.ai/privacy",
        "termsOfServiceURL": "https://sonarlex.ambientapp.ai/terms",
        "defaultPrompt": [
          "Let's play today's Sonarlex word puzzle",
          "Start the Sonarlex practice puzzle",
          "Bug\u00fcn\u00fcn Sonarlex kelime bulmacas\u0131n\u0131 oynayal\u0131m"
        ],
        "brandColor": "#0F766E",
        "brandColorDark": "#5EEAD4",
        "composerIcon": "./assets/composerIcon.png",
        "logo": "./assets/logo.png"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Open the practice puzzle. Run the five cases in order, in one new chat, by typing. There is nothing to sign in to: each ChatGPT user has their own board. The practice puzzle's secret word never changes, so the numbers below are exact on any day; \"in English\" keeps them exact even if your ChatGPT language is Turkish. If this ChatGPT account played the practice puzzle before (for example on a rerun), first say \"Delete my Sonarlex data\" and allow it, so the board starts empty. ChatGPT may open the card in a side panel instead of in the chat; the panel shows the same board.",
              "prompt": "Start the Sonarlex practice puzzle in English and explain the rules.",
              "tools_triggered": "show_puzzle",
              "expected_behavior": "The card shows \"Sonarlex \u00b7 Practice\" with an EN tag, 0 turns, 3 hints left, a word box and a short line on how to play. The reply explains that each turn takes up to 5 words, that each word gets a number for how close it is in meaning to the secret word (#1 is the word itself, lower is closer), and that fewer turns is better. ChatGPT names no guess at the secret word: it can't see it."
            },
            {
              "description": "Try three words in chat. Run after case 1. ChatGPT may show its own 'Allow ChatGPT to use Sonarlex?' prompt first; choose Allow once. The case passes with or without it. Typing the same three words in the card's word box instead gives the same numbers.",
              "prompt": "My words: ship, sea, anchor",
              "tools_triggered": "guess_words",
              "expected_behavior": "The card lists the words closest first: sea #18, ship #38, anchor #222, and shows 1 turn. The reply gives the three numbers and says sea is the closest so far, without guessing the secret word. Sending the same message again uses nothing: ChatGPT either calls guess_words again, and the result says no turn was used, or answers from the board that those words were already tried. Either way the board still shows 1 turn. (ChatGPT sometimes calls a tool twice for one message; the second call uses no turn either.)"
            },
            {
              "description": "Ask for a hint. Run after case 2. A hint costs one turn.",
              "prompt": "Give me a hint.",
              "tools_triggered": "get_hint",
              "expected_behavior": "The hint is \"pier\" at #10: about halfway between the closest word so far (sea, #18) and the secret word, never closer than #10. The card adds pier #10 with a bulb, shows 2 turns and 2 hints left. The reply gives the hint and its number."
            },
            {
              "description": "Find the word. Run after case 3.",
              "prompt": "Is it harbor?",
              "tools_triggered": "guess_words",
              "expected_behavior": "\"harbor\" is #1, the secret word. The card shows harbor, \"Found in 3 turns \u00b7 1 hint\", its 10 closest words (harbour #2, bay #3, shore #4 and so on) and share squares that spell nothing out, with a Copy button. The word box is gone. The reply says the user found it, in 3 turns."
            },
            {
              "description": "Today's shared puzzle, then give up. Run after case 4 (or on its own). Today's secret word changes every day, so this case checks the flow rather than a word. Giving up ends today's puzzle for this user, so ChatGPT may ask you to confirm or show 'Allow ChatGPT to use Sonarlex?'; allow it. The case passes with or without the question. If this account already gave up on today's puzzle, the card simply shows it again.",
              "prompt": "Open today's Sonarlex puzzle. I give up, what's the word?",
              "tools_triggered": "show_puzzle, reveal_word",
              "expected_behavior": "The card shows today's \"Sonarlex #\" number, then, after the give-up, \"The word was\" with the word, \"You gave up\" and its 10 closest words. The reply names the word. Before the give-up, nothing in the chat or the card shows the word."
            }
          ],
          "negative": [
            {
              "description": "A different word game. Sonarlex plays only its own daily hidden-word puzzle; ChatGPT plays this itself.",
              "prompt": "Let's play hangman with a five-letter word.",
              "expected_behavior": "No Sonarlex tool is called. ChatGPT runs the hangman game itself."
            },
            {
              "description": "A dictionary question. Sonarlex doesn't define words.",
              "prompt": "What does the word 'serendipity' mean?",
              "expected_behavior": "No Sonarlex tool is called. ChatGPT explains the word itself."
            },
            {
              "description": "Writing word puzzles is ChatGPT's own job.",
              "prompt": "Write me three crossword clues for the word 'ocean'.",
              "expected_behavior": "No Sonarlex tool is called. ChatGPT writes the clues itself."
            }
          ]
        },
        "commerce": false,
        "demo_recording_url": "https://sonarlex.ambientapp.ai/demo.mp4"
      },
      "publication": {
        "countries": [],
        "release_notes": "First release: a daily hidden-word game in English and Turkish. Try up to 5 words a turn and see how close each is in meaning to a secret word kept on Sonarlex's server; 3 hints a puzzle, a practice puzzle, streaks, today's median and share squares that give nothing away.",
        "translations": {
          "tr-TR": {
            "subtitle": "G\u00fcnl\u00fck kelime tahmin oyunu",
            "description": "Sonarlex g\u00fcnl\u00fck bir gizli kelime oyunu. Her g\u00fcn o dili oynayan herkes ayn\u0131 gizli kelimeyi arar. Her turda en fazla 5 kelime dener, her birinin gizli kelimeye anlamca ne kadar yak\u0131n oldu\u011funu bir numarayla g\u00f6r\u00fcrs\u00fcn: #1 kelimenin kendisi, #2 en yak\u0131n kelimesi; numara k\u00fc\u00e7\u00fcld\u00fck\u00e7e \u0131s\u0131n\u0131rs\u0131n. Kelimeyi olabildi\u011fince az turda bul.\n\nKelimelerini karta yaz ya da ChatGPT'ye s\u00f6yle: \"deniz, gemi, tuz\" gibi. \u00c7ekimli bi\u00e7imler k\u00f6k kelime say\u0131l\u0131r, T\u00fcrk\u00e7e karakter \u015fart de\u011fildir.\n\nGizli kelime Sonarlex'in sunucusunda durur: ne sen ne ChatGPT g\u00f6rebilir; ChatGPT d\u00fcr\u00fcst bir tak\u0131m arkada\u015f\u0131 olur. \u0130stersen fikir sor; \u00f6nerdi\u011fi kelimeler payla\u015f\u0131m karelerinde i\u015faretlenir.\n\nTak\u0131ld\u0131n m\u0131? Bulmaca ba\u015f\u0131na 3 ipucun var; her biri en iyi kelimenle gizli kelimenin yakla\u015f\u0131k ortas\u0131nda bir kelime g\u00f6sterir ve bir tur say\u0131l\u0131r. Pes edersen Sonarlex kelimeyi ve en yak\u0131n kelimelerini g\u00f6sterir. Bulunca kart g\u00fcn\u00fcn medyan\u0131n\u0131 ve hi\u00e7bir \u015fey ele vermeyen renkli payla\u015f\u0131m karelerini g\u00f6sterir. Her \u00e7\u00f6zd\u00fc\u011f\u00fcn g\u00fcn serin b\u00fcy\u00fcr. Yeni misin? Kelimesi hi\u00e7 de\u011fi\u015fmeyen al\u0131\u015ft\u0131rma bulmacas\u0131yla ba\u015fla.\n\nS\u0131n\u0131rlar:\n- Her dilde g\u00fcnde bir ortak kelime: T\u00fcrk\u00e7e (gece yar\u0131s\u0131, TS\u0130) ve \u0130ngilizce (03:00, TS\u0130). Sonarlex ChatGPT dilini izler.\n- T\u00fcrk\u00e7ede yakla\u015f\u0131k 22.000, \u0130ngilizcede yakla\u015f\u0131k 28.000 kelimenin numaras\u0131 var. Kelime gruplar\u0131, \"ve\" gibi \u00e7ok yayg\u0131n kelimeler ve k\u00fcf\u00fcrler listede yoktur; denemek tur harcamaz.\n- Hesap yok: tahtalar\u0131n ve serin ChatGPT'nin anonim kimli\u011fiyle saklan\u0131r. \"Sonarlex verilerimi sil\" diyerek silebilirsin."
          }
        }
      },
      "apps": "./.app.json"
    }
  }
}