plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "app-6ab97889d48c819194cac7245d06bb05",
  "version": "1.0.1",
  "description": "See and hear real music in the conversation: playable notation, harmony in real repertoire, part-writing checks, sight-reading and ear training.",
  "author": {
    "name": "Mayank Sanganeria",
    "email": "support@musictutor.app",
    "url": "https://musictutor.app"
  },
  "homepage": "https://musictutor.app",
  "keywords": [
    "music",
    "music theory",
    "sight-reading",
    "ear training",
    "notation",
    "harmony",
    "education"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Music Tutor",
        "shortDescription": "Real music you can see & hear",
        "longDescription": "Music Tutor puts real music in the conversation: notation you can see and hear, drawn from public-domain works. Ask a music question and the answer comes with an interactive card that engraves the notes, plays them with note highlighting, and offers follow-ups.\n\n- Find a piece: \"How does the Moonlight Sonata start?\" shows the real opening bars, playable. Or browse famous openings by composer, era or form.\n- Chords and scales, spelled right: any chord or scale on a staff, a keyboard and a guitar chord box.\n- Harmony in real music: ask for a Neapolitan sixth, a German sixth or a deceptive cadence and see it in Chopin, Mozart or Schubert, with the chord coloured, labelled and played; open more of the piece from any example.\n- Check part writing: paste a four-part chorale or two-voice counterpoint and get parallel fifths, spacing, range and resolution problems marked by bar and beat.\n- What to learn next: \"I can play F\u00fcr Elise, what next?\" suggests pieces from a level 1-10 learning path, each with its opening and what it teaches.\n- Sight-reading: short passages of real piano music from level 1 to 10, or focused on one skill such as ledger lines or dotted rhythms.\n- Ear training: interval, chord, inversion, scale and mode quizzes built for exactly what you want to drill; at the end you see what you mixed up and get a suggested next quiz.\n- Lead sheets: carols, hymns and folk songs with melody, words and chord symbols; chords play under the tune.\n- Transpose for your instrument: \"for my clarinet\", \"for alto sax\", \"lower it for my voice\".\n- Guess the composer: a listening game with a daily puzzle and a shareable score.\n\nOnly music out of copyright is shown (published before 1930 and composer dead at least 71 years, or traditional), with a reviewed hold list for later arrangements and lyrics. No account or sign-in, and no personal information requested; see the privacy policy for what is logged. Cards link to the free practice pages of Real Sight Reader and Real Ear Trainer for playing along on your own instrument.",
        "developerName": "Mayank Sanganeria",
        "category": "Education & Research",
        "capabilities": [
          "Playable notation",
          "Famous openings by name",
          "Harmony in real music",
          "Part-writing checks",
          "What to learn next",
          "Sight-reading passages",
          "Ear-training quizzes",
          "Lead sheets",
          "Transpose for your instrument",
          "Guess the composer"
        ],
        "websiteURL": "https://musictutor.app",
        "supportURL": "https://musictutor.app/support",
        "privacyPolicyURL": "https://musictutor.app/privacy",
        "termsOfServiceURL": "https://musictutor.app/terms",
        "defaultPrompt": [
          "How does the Moonlight Sonata start?",
          "Show me a real Neapolitan sixth",
          "Quiz me on intervals, easy"
        ],
        "brandColor": "#3A45C4",
        "composerIcon": "./assets/icon.png",
        "logo": "./assets/icon.png",
        "screenshots": [
          "./assets/02-harmony-example.png",
          "./assets/01-sight-reading.png",
          "./assets/06-lead-sheet.png",
          "./assets/04-chord.png",
          "./assets/10-composer-reveal.png"
        ]
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Named-piece lookup. Setup: new conversation with Music Tutor enabled; no account or attachments.",
              "prompt": "How does the Moonlight Sonata start?",
              "tools_triggered": "find_music",
              "expected_behavior": "Call find_music with query identifying Moonlight Sonata. Show the returned Beethoven Piano Sonata No. 14, Op. 27 No. 2 opening with title, composer and returned bar range, engraved on two staves with playback. Caption and explanation must match structuredContent; no invented score or recording."
            },
            {
              "description": "Harmony search with source attribution. Setup: new conversation with Music Tutor enabled; no account or attachments.",
              "prompt": "Show me a real Neapolitan sixth.",
              "tools_triggered": "find_harmony_example",
              "expected_behavior": "Call find_harmony_example with concept N6 or the equivalent Neapolitan alias. structuredContent.concept_id must be neapolitan. Show 1\u20136 returned repertoire examples with target bars highlighted, spelling and source/licence credits; any textbook figure is additional. Explain the returned example, preserve noncommercial credits, and do not claim an unsupported fixed result order."
            },
            {
              "description": "Learning-path recommendations from a familiar piece. Setup: new conversation with Music Tutor enabled; no account or attachments.",
              "prompt": "I can play F\u00fcr Elise. What should I learn next?",
              "tools_triggered": "suggest_next_pieces",
              "expected_behavior": "Call suggest_next_pieces with after identifying F\u00fcr Elise and count 4 (or its default). Show the returned pieces with title, composer, level, what each teaches, and playable openings. Use structuredContent.items and its caveat that levels are editorial rather than exam grades; do not invent recommendations missing from the result."
            },
            {
              "description": "Deterministic SATB voice-leading check. Setup: new conversation; each voice holds one whole note per bar, two bars in C major, 4/4. Octaves in the prompt remove voicing ambiguity.",
              "prompt": "Check these two bars of SATB part writing in C major, 4/4, one whole note per bar: soprano G4 then A4, alto E4 then F4, tenor C4 then B3, bass C3 then D3. Are there parallel fifths?",
              "tools_triggered": "check_part_writing",
              "expected_behavior": "Call check_part_writing with score encoding the specified pitches and durations, key C and style chorale (or its default). Return error_count 1, warning_count 0 and a parallel_fifths_octaves finding between Soprano and Bass at bar 2, beat 1. Show the engraved exercise with corresponding marked notes and explain the parallel fifths."
            },
            {
              "description": "Custom harmonic-interval quiz and feedback. Setup: new conversation; press Hear it, answer all eight questions, and inspect the results. No account or attachments.",
              "prompt": "Quiz me on perfect 4th vs perfect 5th vs tritone, played together, 8 questions.",
              "tools_triggered": "ear_training_quiz",
              "expected_behavior": "Call ear_training_quiz with family interval, options P4/P5/TT, play harmonic and questions 8. The card must contain eight playable questions whose answers belong to those options. Do not disclose answer_key before the learner answers. After completing the card, show feedback and a score consistent with actual responses, observed confusions and a suggested next quiz. No fixed random answer sequence is required."
            }
          ],
          "negative": [
            {
              "description": "Setup: new conversation. Explain that Music Tutor cannot access streaming accounts or create Spotify playlists. Invoke none of its tools and do not claim a playlist was created.",
              "prompt": "Create a Spotify playlist of my favorite songs."
            },
            {
              "description": "Setup: new conversation; no audio fixture is needed to establish the unsupported capability. Explain that Music Tutor cannot accept or transcribe recordings. Invoke none of its tools; do not fabricate a transcription.",
              "prompt": "Transcribe my uploaded piano recording into sheet music."
            },
            {
              "description": "Setup: new conversation. Explain that Music Tutor cannot book lessons or modify calendars. Invoke none of its tools and do not claim an event was created.",
              "prompt": "Schedule a piano lesson on my calendar for tomorrow."
            }
          ]
        },
        "commerce": false,
        "commerce_description": "Music Tutor is free. It does not sell products or process payments.",
        "demo_recording_url": "https://www.dropbox.com/scl/fi/wx0sil2shil7jj6p89x6a/musictutor-demo.mov?rlkey=jff4kstav9yzontic43whhlfo&dl=0"
      },
      "publication": {
        "release_notes": "Privacy policy rewritten to cover data collected per tool (inputs and outputs), purposes, recipients, retention and user controls, with a privacy@musictutor.app contact. Eleven read-only tools; no account or sign-in.",
        "countries": []
      },
      "apps": "./.app.json"
    }
  }
}