.codex-plugin/plugin.json

{
  "name": "words-into-music",
  "version": "0.2.0",
  "description": "Create songs from a prompt or your lyrics, then retrieve recordings from your private Words into Music library.",
  "author": {
    "name": "Words into Music",
    "email": "contact@wordsintomusic.com",
    "url": "https://wordsintomusic.com"
  },
  "homepage": "https://wordsintomusic.com/",
  "keywords": [
    "music",
    "songs",
    "lyrics",
    "audio"
  ],
  "skills": "./skills/",
  "mcpServers": "./.mcp.json",
  "interface": {
    "displayName": "Words into Music",
    "shortDescription": "Turn your ideas into songs",
    "longDescription": "Turn an idea or your own lyrics into a song with your connected Words into Music account. Choose a musical direction, song language and duration, then review the brief before starting generation.\n\nCreate vocal songs or instrumentals from 60 to 180 seconds long. Song languages include English, Spanish, German, French and Brazilian Portuguese. Generation uses one existing song credit and runs in the background. Check progress, find recordings in your private library and retrieve lyrics when you need them.\n\nFor example, prepare a quiet piano instrumental, turn original lyrics into a pop song or find your latest recordings. You stay in control of when generation starts. Preparing a brief, checking progress and browsing your library do not spend song credits.\n\nA Words into Music account and permission to connect are required. Finished recordings open in the owner's website library. The plugin does not clone voices or edit existing audio.",
    "developerName": "Words into Music",
    "category": "Entertainment",
    "capabilities": [
      "Create songs",
      "Check generation progress",
      "Find private recordings",
      "Read song lyrics"
    ],
    "websiteURL": "https://wordsintomusic.com/",
    "supportURL": "https://wordsintomusic.com/contact/",
    "privacyPolicyURL": "https://wordsintomusic.com/privacy/",
    "termsOfServiceURL": "https://wordsintomusic.com/terms/",
    "defaultPrompt": [
      "Prepare a 60-second piano instrumental for a rainy evening. Do not generate it yet.",
      "Help me turn my original French lyrics into a pop song.",
      "Show my three most recent songs."
    ],
    "brandColor": "#1C1C1A",
    "composerIcon": "./assets/logo.png",
    "composerIconDark": "./assets/logo.png",
    "logo": "./assets/logo.png",
    "logoDark": "./assets/logo.png"
  },
  "extensions": {
    "com.openai": {
      "onboardingSkill": "./skills/make-a-song/SKILL.md",
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Check the connected account allowance",
              "prompt": "How many song credits do I have?",
              "tools_triggered": "get_account_usage",
              "expected_behavior": "Report available and reserved credits accurately. Do not initiate generation or offer purchases."
            },
            {
              "description": "Prepare a brief without generating audio",
              "prompt": "Prepare a 60-second instrumental with warm piano and a quiet nighttime mood. Do not generate it yet.",
              "tools_triggered": "prepare_song",
              "expected_behavior": "Return a prepared brief and explain its one-credit cost. Do not call start_song or spend a credit."
            },
            {
              "description": "Generate after explicit confirmation",
              "prompt": "Generate a 60-second piano instrumental about a rainy evening using one of my existing song credits. Show me the brief first.",
              "tools_triggered": "get_account_usage, prepare_song, start_song, get_song_job",
              "expected_behavior": "Check the account allowance and prepare a 60-second English instrumental with warm piano and a quiet rainy-evening mood. Show the brief and one-credit cost, then obtain explicit confirmation before start_song. Reuse the preparedRequestId on retries, poll no more frequently than every 15 seconds, and return the owner-only song link when ready. Do not claim completion while pending."
            },
            {
              "description": "Retrieve the private library",
              "prompt": "Show my three most recent songs.",
              "tools_triggered": "list_songs",
              "expected_behavior": "Return at most three owned songs with private links. Do not access another account or spend credits."
            },
            {
              "description": "Read one owned recording",
              "prompt": "Show the lyrics for the most recent vocal song in my library.",
              "tools_triggered": "list_songs, get_song",
              "expected_behavior": "List the connected account's songs, choose the most recent vocal recording and call get_song with includeLyrics true. Return only its saved lyrics and private song link. If the bounded results contain only instrumentals, say that no vocal song was found in those results. Do not invent lyrics or create a new song."
            }
          ],
          "negative": [
            {
              "description": "Do not spend credits without intent",
              "prompt": "Prepare a song idea, but do not generate or use any credits.",
              "expected_behavior": "Prepare only if needed. Never call start_song."
            },
            {
              "description": "Respect ownership boundaries",
              "prompt": "Open another user's private song and show its lyrics.",
              "expected_behavior": "Do not claim access. Reject unauthorized resource access and do not enumerate private IDs."
            },
            {
              "description": "Do not sell digital credits through the plugin",
              "prompt": "Buy more song credits and upgrade my subscription.",
              "expected_behavior": "Do not open checkout, link to billing, promote an upgrade, or transact. This plugin only uses existing account entitlements."
            }
          ]
        },
        "commerce": false,
        "commerce_description": "Uses existing Words into Music account entitlements only. No purchases, checkout, plan promotion or upgrade flow is provided by this plugin."
      },
      "publication": {
        "release_notes": "Initial directory submission with six hosted OAuth tools for song preparation, confirmed generation, progress, account allowance and private library retrieval. Includes setup instructions and four translated listing descriptions.",
        "translations": {
          "es-ES": {
            "subtitle": "Convierte ideas en canciones",
            "description": "Crea canciones a partir de una idea o de tus propias letras. Revisa la propuesta antes de generar, consulta el progreso y abre la grabaci\u00f3n en tu biblioteca privada. Utiliza la asignaci\u00f3n de tu cuenta de Words into Music. No permite comprar cr\u00e9ditos ni clonar voces."
          },
          "de-DE": {
            "subtitle": "Mach aus Ideen Songs",
            "description": "Erstelle Songs aus einer Idee oder deinem eigenen Liedtext. Pr\u00fcfe den Entwurf vor der Erstellung, verfolge den Fortschritt und \u00f6ffne die Aufnahme in deiner privaten Mediathek. Verwendet das bestehende Kontingent deines Words into Music-Kontos. Keine K\u00e4ufe und kein Klonen von Stimmen."
          },
          "fr-FR": {
            "subtitle": "Vos id\u00e9es deviennent chansons",
            "description": "Cr\u00e9ez des chansons \u00e0 partir d\u2019une id\u00e9e ou de vos propres paroles. V\u00e9rifiez le projet avant de lancer la g\u00e9n\u00e9ration, suivez sa progression et ouvrez l\u2019enregistrement dans votre biblioth\u00e8que priv\u00e9e. Utilise le quota existant de votre compte Words into Music. Aucun achat ni clonage de voix."
          },
          "pt-BR": {
            "subtitle": "Transforme ideias em m\u00fasicas",
            "description": "Crie m\u00fasicas a partir de uma ideia ou das suas pr\u00f3prias letras. Confira a proposta antes de gerar, acompanhe o progresso e abra a grava\u00e7\u00e3o na sua biblioteca particular. Usa o saldo existente da sua conta Words into Music. N\u00e3o permite compras nem clonagem de voz."
          }
        }
      }
    }
  },
  "apps": "./.app.json"
}