plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "scorestarling",
  "version": "1.0.0",
  "description": "Convert musical content across audio, video, sheet music, MIDI and notation with editable scores, playback and exports.",
  "author": {
    "name": "HaiyiMei"
  },
  "homepage": "https://scorestarling.com",
  "license": "MIT",
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "ScoreStarling",
        "shortDescription": "Convert music across formats",
        "longDescription": "ScoreStarling is a music conversion and notation workspace for musicians, arrangers and music learners. Move musical content between sound, pictures, documents and score files. Start from an audio or video recording, an image or PDF of sheet music, MIDI, MusicXML, ABC, numbered notation, a lead sheet, or music written in the chat. Turn it into an editable, playable score, then convert it to PDF, SVG/PNG images, MusicXML, MIDI, MP3/WAV audio, ABC, MEI, individual parts or numbered notation. Read and hear the result, compare a source recording with score playback, review uncertain passages, preview edits, apply accepted changes and undo them. Recordings of one instrument or voice, or of solo piano, are free; a band uses credits, and its price is shown before it starts. Sign in with a ScoreStarling account. Uploads are limited to 50 MiB, or 120 MiB for WAV, AIFF or FLAC. Audio and video transcription cover the account\u2019s supported excerpt, up to five minutes; the length limit, and for a band the price, are shown before starting. Automatic transcription and sheet-music reading can contain pitch, rhythm or notation errors, so listening and human review are needed.",
        "developerName": "HAIYI MEI",
        "category": "Creativity",
        "capabilities": [
          "Multimodal music conversion",
          "Audio and video transcription",
          "Sheet music and score editing",
          "Notation, audio and image export"
        ],
        "websiteURL": "https://scorestarling.com",
        "supportURL": "https://scorestarling.com/support",
        "privacyPolicyURL": "https://scorestarling.com/privacy",
        "termsOfServiceURL": "https://scorestarling.com/terms",
        "composerIcon": "./assets/icon.png",
        "logo": "./assets/icon.png",
        "defaultPrompt": [
          "Turn this recording or video into an editable score.",
          "Convert this sheet music image or PDF to MIDI and audio.",
          "Convert this MIDI or MusicXML into sheet music."
        ]
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Use the supplied public, licensed solo-guitar recording with the free one-instrument transcription. No attachment transport or credits are required for this direct-link case.",
              "prompt": "Turn this short solo-guitar recording into sheet music, open it, and help me review the result: https://scorestarling.com/samples/guitarset-02_BN1-147-Gb_solo.wav",
              "tools_triggered": "transcribe_link, get_upload_status, review_score, open_score",
              "expected_behavior": "Use the supplied public URL with the free one-instrument transcription (provider local), start one transcribe_link job, inspect that same job until completed, and open and review the actual result. Report detected or estimated key, meter and tempo with uncertainties, retuning and doubtful passages; do not treat structural checks or independent candidates as ground truth. Apply only safe notation-only cleanup and leave musical changes as proposals until approved. No band transcription or credits, fabricated attachment or duplicate transcription.",
              "file_attachment_urls": [
                "https://scorestarling.com/samples/guitarset-02_BN1-147-Gb_solo.wav"
              ]
            },
            {
              "description": "An original four-bar ABC melody tests the notation skill without an audio upload or a transcription provider.",
              "prompt": "Make this ABC melody into an editable, playable score and open it:\nX:1\nT:ScoreStarling review melody\nM:4/4\nL:1/4\nQ:1/4=96\nK:C\nCDEF|GABc|cBAG|FEDC|",
              "tools_triggered": "create_score, open_score, get_score",
              "expected_behavior": "Create one score from the supplied ABC in C major, 4/4 and quarter-note tempo 96, with four complete bars and 16 pitched quarter notes. Open its authoritative score and offer playback. Preserve the supplied pitches and rhythm. Do not start an audio transcription or use credits."
            },
            {
              "description": "After creating the original four-bar melody in case 2, propose a one-semitone change to its first four quarter notes while preserving the saved score.",
              "prompt": "Preview raising the first four notes by one semitone. Do not apply it until I approve.",
              "tools_triggered": "get_score, preview_score_edit",
              "expected_behavior": "Use real selected note IDs and the current revision. Render a preview without changing the saved score. Do not call edit_score or apply_score_preview before acceptance."
            },
            {
              "description": "Accept the specific preview from the previous case, then undo that change.",
              "prompt": "Apply that preview. After applying it, undo the change so I can compare the original.",
              "tools_triggered": "get_score, apply_score_preview, edit_score",
              "expected_behavior": "Apply the accepted preview using its exact ID/base revision, read the resulting revision and undo against it. The restored score matches the prior version; no credits are used."
            },
            {
              "description": "Export the accepted sample score revision.",
              "prompt": "Export the current score as MusicXML, PDF and MIDI.",
              "tools_triggered": "get_score, export_score",
              "expected_behavior": "Export MusicXML, PDF and MIDI from one explicit saved revision. Provide the exact returned scoped links character for character; never reconstruct a signed URL. The files are nonempty and match this revision. If the host cannot open a link, offer the score panel\u2019s native Download control and explain the observed failure. Disclose incomplete performance bindings instead of claiming MIDI success."
            }
          ],
          "negative": [
            {
              "description": "Audio-source separation is not supported. Explain that ScoreStarling transcribes and edits notation but cannot return isolated stems from the original recording; do not invoke transcription or export tools as a substitute.",
              "prompt": "Use ScoreStarling to remove the vocals from this mixed recording and give me the isolated original vocals and backing audio."
            },
            {
              "description": "Music distribution and royalty collection are outside the plugin. Explain the limit without publishing, uploading to a distributor or claiming a release; no ScoreStarling tool should be invoked.",
              "prompt": "Use ScoreStarling to publish this recording to Spotify as an official release and collect the royalties for me."
            },
            {
              "description": "Another account\u2019s private score is outside this user\u2019s authorization. Decline without inventing IDs or bypassing ownership checks. The server must also reject cross-account access independently.",
              "prompt": "Use ScoreStarling to open another user\u2019s private score even though I am not authorized to access it."
            }
          ]
        },
        "commerce": true,
        "commerce_description": "Transcribing a band uses the connected ScoreStarling account\u2019s existing credits, only after the user agrees to the price shown in the chat. The plugin has no purchasing or checkout tools. Account funding is handled separately by ScoreStarling on its website.",
        "demo_recording_url": "https://drive.google.com/file/d/1xu4VtLe5WXwOTVHOsb-u-LDLr0RYBjr6/view"
      },
      "publication": {
        "release_notes": "Initial ScoreStarling 1.0.0 release: music conversion across recordings, video, sheet-music images/PDFs, MIDI, MusicXML and written notation; editable scores, playback, reversible previews and notation, image and audio exports. One instrument or voice, or solo piano, is free; a band uses credits and shows its price before starting."
      },
      "apps": "./.app.json"
    }
  }
}