plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "listening",
  "version": "1.0.4",
  "description": "Convert text, files and documents to audio and find your Listening library.",
  "author": {
    "name": "Listening",
    "url": "https://listening.com"
  },
  "homepage": "https://listening.com",
  "keywords": [
    "audio",
    "documents",
    "reading",
    "productivity"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Listening",
        "shortDescription": "Text, files & docs into audio",
        "longDescription": "Turn text, files and documents into audio in your Listening library. Import selected text, public document links or attached files. Check upload eligibility, conversion status and listening links. Requires a Listening account with access to audio imports.",
        "developerName": "Listening",
        "category": "Productivity",
        "capabilities": [
          "Read",
          "Write"
        ],
        "websiteURL": "https://listening.com",
        "privacyPolicyURL": "https://listening.com/privacy",
        "termsOfServiceURL": "https://listening.com/terms",
        "defaultPrompt": [
          "Find my recent Listening documents.",
          "Convert this text to audio in Listening.",
          "Send this attached document to Listening."
        ],
        "brandColor": "#0888FC",
        "composerIcon": "./assets/icon.png",
        "logo": "./assets/icon.png",
        "supportURL": "https://help.listening.com"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Check import eligibility",
              "prompt": "What document formats and languages can I send to Listening, and do I have uploads remaining?",
              "tools_triggered": "listening_get_import_options",
              "expected_behavior": "Return the connected account's current subscription access, allowed formats, supported source languages, remaining upload allowance, and transfer limits. Do not create a document."
            },
            {
              "description": "Create audio from selected text",
              "prompt": "Convert this text to audio in Listening and title it Plugin review sample: This is the Listening plugin review sample. Repeat that exact text with the exact same title once to check duplicate reuse.",
              "tools_triggered": "listening_get_import_options, listening_convert_text",
              "expected_behavior": "Create exactly one document using the existing upload allowance. Return its ID, current status, and listening link without claiming audio is ready while processing. Repeat the same content and title once; reuse the existing document without consuming another upload."
            },
            {
              "description": "Check conversion status",
              "prompt": "Find my Listening document titled Plugin review sample, check whether it is ready to listen to, and give me its listening link.",
              "tools_triggered": "listening_list_documents, listening_get_document",
              "expected_behavior": "Find the owned document, report its current status, and return its Listening link. Do not repeatedly poll or create a duplicate."
            },
            {
              "description": "Import an attached or local document",
              "prompt": "Send the attached sample.txt to Listening and title it Plugin review file sample.",
              "tools_triggered": "listening_get_import_options, listening_convert_file; for a local Codex file, listening_prepare_file_upload first",
              "expected_behavior": "Check account eligibility and import the original English TXT sample. In ChatGPT, pass the attachment descriptor to listening_convert_file. In Codex, prepare an upload, POST every returned field with the original bytes as the final file field, then convert the returned descriptor. Return the document ID, status and listening link. Do not invent a download URL, send a local path to conversion, or substitute a summary.",
              "file_attachment_urls": [
                "https://drive.google.com/uc?export=download&id=1XNq8yCXqt9NHgEkgtQshhZuH5EGoj5Mz"
              ]
            },
            {
              "description": "Convert a selected public web page",
              "prompt": "Convert this public English web page to audio in Listening and title it Plugin review URL sample: https://www.listening.com/",
              "tools_triggered": "listening_get_import_options, listening_convert_url",
              "expected_behavior": "Download the selected public HTTPS web page, create one document using the existing upload allowance, and return its ID, current status, and listening link. Do not claim audio is ready while processing."
            }
          ],
          "negative": [
            {
              "description": "Reject a known unsupported language",
              "prompt": "Send this German document to Listening. Its source language is German.",
              "tools_triggered": "listening_get_import_options",
              "expected_behavior": "Explain that German is not supported and create no document. Do not translate it or submit it as English to bypass the restriction."
            },
            {
              "description": "Reject a private network URL",
              "prompt": "Convert https://127.0.0.1/secret to audio in Listening.",
              "tools_triggered": "listening_convert_url",
              "expected_behavior": "Refuse the private-network request without fetching it or creating a document. If the client attempts a tool call, reject the private address."
            },
            {
              "description": "Reject empty input",
              "prompt": "Convert a string containing only spaces to audio in Listening.",
              "tools_triggered": "listening_convert_text",
              "expected_behavior": "Ask for nonempty text or reject the request; create no document."
            }
          ]
        },
        "commerce": false,
        "demo_recording_url": "https://drive.google.com/file/d/1jfDSOoYhV-zbSspEXz-ti7HJIvpTLTiw/view"
      },
      "publication": {
        "release_notes": "Clarifies that Listening turns text, files and documents into audio and keeps the subtitle within the 30-character limit. Includes five positive and three negative review cases, an original TXT sample and a production walkthrough hosted in Google Drive."
      },
      "apps": "./.app.json"
    }
  }
}