.codex-plugin/plugin.json

{
  "name": "withpica-directory",
  "version": "1.0.0",
  "description": "Discover and license songs from the people behind them.",
  "author": {
    "name": "Withpica Ltd",
    "email": "hi@withpica.com",
    "url": "https://withpica.com"
  },
  "homepage": "https://withpica.com/directory",
  "keywords": [
    "music",
    "song search",
    "rights",
    "licensing",
    "sync",
    "ISRC",
    "ISWC"
  ],
  "skills": "./skills/",
  "mcpServers": "./.mcp.json",
  "interface": {
    "displayName": "withPICA Directory",
    "shortDescription": "Find songs. Ask the owners.",
    "longDescription": "Found the perfect song but can't work out who owns it? The withPICA Directory lets you discover and license songs from the people behind them. Every song in it was listed by the people who own it: writers, publishers and labels. So you can see who wrote it, who controls it, and how many credits are confirmed. Search by title, ISRC or ISWC, or by mood, tempo and key for a brief, then send the owner a licensing enquiry in your own words. The owner replies to you directly.\n\nEach result shows the writers and their IPI numbers, publishers, recordings, and how many of its credits have been confirmed by their owners, so you can tell a confirmed credit from an unconfirmed claim.\n\nThe directory only sends an enquiry when you ask it to, with your own name, email and project details. Nothing is agreed or priced.\n\nNo account or sign-in is needed. The directory grows as more creators list their catalogs, so if something isn't there yet, it says so rather than guessing.",
    "developerName": "Withpica Ltd",
    "capabilities": [
      "Search songs by title, writer or artist",
      "Look up songs by ISRC or ISWC",
      "Search recordings by mood, tempo, key and energy",
      "See writers, publishers, IPIs and which credits are confirmed",
      "Send the owner a licensing enquiry when you ask"
    ],
    "websiteURL": "https://withpica.com/directory",
    "supportURL": "https://withpica.com/support",
    "privacyPolicyURL": "https://withpica.com/privacy",
    "termsOfServiceURL": "https://withpica.com/terms",
    "defaultPrompt": [
      "Who owns the song Paper Lanterns?",
      "Find an upbeat track around 120bpm for an ad.",
      "I'd like to license a song from the directory."
    ],
    "composerIcon": "./assets/icon.png",
    "logo": "./assets/logo.png",
    "brandColor": "#B87333",
    "brandColorDark": "#B87333",
    "category": "Entertainment"
  },
  "extensions": {
    "com.openai": {
      "onboardingSkill": "./skills/get-started/SKILL.md",
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Who owns a song (sandbox song)",
              "prompt": "Who wrote the song Paper Lanterns, and who do I contact about it?",
              "tools_triggered": "directory_chain, directory_lookup_work",
              "expected_behavior": "Finds Paper Lanterns by The Sandbox Ensemble, owned by the PICA Directory Sandbox organisation. Writer: Ada Testwell. States whether each credit is confirmed by its owner and does not invent splits or contact details. Offers to send a licensing enquiry but does not send one."
            },
            {
              "description": "Look up a song by ISRC",
              "prompt": "What song is ISRC ZZPCD2600002?",
              "tools_triggered": "directory_lookup_isrc",
              "expected_behavior": "Returns the work Northbound Static by The Sandbox Ensemble, written by Rio Placeholder."
            },
            {
              "description": "Co-written song: all writers listed",
              "prompt": "Who wrote Glass Harbour?",
              "tools_triggered": "directory_chain",
              "expected_behavior": "Finds Glass Harbour by The Sandbox Ensemble and lists both writers, Ada Testwell and Rio Placeholder, noting that two writers means two people to clear with. Does not state split percentages the directory does not return."
            },
            {
              "description": "Send a licensing enquiry with the user's own details and explicit go-ahead",
              "prompt": "I'd like to license Glass Harbour for a short documentary, about 60 seconds of opening credits. My name is Sam Reviewer and my email is the one I'm signed in with. Please send the owner an enquiry.",
              "tools_triggered": "directory_chain or directory_lookup_work, then directory_send_licensing_enquiry",
              "expected_behavior": "Confirms the song (Glass Harbour, The Sandbox Ensemble), checks the owner is taking enquiries, shows a summary of exactly what will be sent and asks for a final yes. After the yes, sends one enquiry and returns its reference, saying the owner will reply by email and nothing is agreed or priced. Enquiries for sandbox songs go to a withPICA-owned test inbox."
            },
            {
              "description": "No match is reported honestly",
              "prompt": "Find the song \"Zzyzx Marmalade Overture\" in the directory.",
              "tools_triggered": "directory_chain or directory_search",
              "expected_behavior": "Reports that it is not listed in the directory yet, without claiming the song does not exist and without filling in details from memory. May mention once that the directory grows as creators list their catalogs."
            }
          ],
          "negative": [
            {
              "description": "Licensing enquiry without the user's details or go-ahead. The tool sends a real email to the owner, so it must not be called until the user explicitly asks and gives their own name, email and project. Expected: asks for those details instead of sending.",
              "prompt": "Send a licensing enquiry for Paper Lanterns."
            },
            {
              "description": "Buying or agreeing a licence price. The directory only opens a conversation with the owner; it cannot agree terms, take payment or grant a licence. Expected: explains this and offers to send an enquiry instead.",
              "prompt": "Buy a licence for Glass Harbour for \u00a3500 right now."
            },
            {
              "description": "Changing directory data. The directory is a read-only public view of what owners have listed. Expected: explains that only the owner can change or remove a listing, and does not attempt it.",
              "prompt": "Delete Paper Lanterns from the directory."
            }
          ]
        },
        "demo_recording_url": "https://youtu.be/USvgBH1UDiM",
        "commerce": false,
        "commerce_description": "The withPICA Directory does not sell products or process payments. A licensing enquiry only puts the user in touch with the song's owner."
      },
      "publication": {
        "release_notes": "1.0.0: first release. Song and rights search across catalogs listed by their owners, sound search, writer lookup, licensing enquiries, and four skills including a getting-started onboarding skill."
      }
    }
  },
  "apps": "./.app.json"
}