plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "pdfhost",
  "version": "0.1.1",
  "description": "Search, share, embed, and analyze PDFs hosted in your PDFHost account.",
  "author": {
    "name": "PDFHost",
    "email": "sam@pdfhost.se",
    "url": "https://pdfhost.se"
  },
  "homepage": "https://pdfhost.se",
  "license": "Proprietary",
  "keywords": [
    "pdf",
    "documents",
    "analytics",
    "embed"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "PDFHost",
        "shortDescription": "Host and analyze PDFs",
        "longDescription": "PDFHost gives teams permanent PDF links, website embeds, QR codes, and document analytics. Connect your account to search hosted PDFs, inspect sharing details, retrieve responsive embed code, and review aggregate views, downloads, visitors, and read-time trends. The connector is read-only and cannot upload, modify, or delete documents.",
        "developerName": "PDFHost",
        "category": "Data & Analytics",
        "capabilities": [
          "PDF document search",
          "Document analytics",
          "Share-link details",
          "Embed code"
        ],
        "websiteURL": "https://pdfhost.se",
        "supportURL": "https://pdfhost.se/support",
        "privacyPolicyURL": "https://pdfhost.se/privacy",
        "termsOfServiceURL": "https://pdfhost.se/terms",
        "defaultPrompt": [
          "Find my most-viewed PDFHost documents from the last month.",
          "Search my PDFHost account for documents tagged proposal.",
          "Get embed code for my latest PDFHost document."
        ],
        "brandColor": "#2D5016",
        "composerIcon": "./assets/logo.png",
        "logo": "./assets/logo.png"
      },
      "review": {
        "demo_recording_url": "https://pdfhost.se/assets/pdfhost-chatgpt-review-walkthrough.mp4",
        "test_cases": {
          "positive": [
            {
              "description": "Search documents by title.",
              "prompt": "Find documents with proposal in the title.",
              "tools_triggered": "search_documents",
              "expected_behavior": "Returns only matching documents owned by the connected account."
            },
            {
              "description": "Filter documents by a tag.",
              "prompt": "Show documents tagged client.",
              "tools_triggered": "search_documents",
              "expected_behavior": "Returns matching documents and no documents from another account."
            },
            {
              "description": "Read an individual document.",
              "prompt": "Show details for pdf_aB3kR7mNqX2p.",
              "tools_triggered": "get_document",
              "expected_behavior": "Returns sharing details for that owned document."
            },
            {
              "description": "Generate owned document embed code.",
              "prompt": "Get embed code for pdf_aB3kR7mNqX2p.",
              "tools_triggered": "get_embed_code",
              "expected_behavior": "Returns iframe HTML only for an owned public document."
            },
            {
              "description": "Review aggregate analytics.",
              "prompt": "Show 30-day analytics for pdf_aB3kR7mNqX2p.",
              "tools_triggered": "get_document_analytics",
              "expected_behavior": "Returns aggregate views, downloads, visitors, and daily trends."
            }
          ],
          "negative": [
            {
              "description": "Attempt to delete a document.",
              "prompt": "Delete pdf_aB3kR7mNqX2p.",
              "expected_behavior": "The plugin does not expose a delete tool and does not change any document."
            },
            {
              "description": "Attempt cross-account access.",
              "prompt": "Show details for a document that is not in my account.",
              "expected_behavior": "The plugin returns not found and does not disclose another account's data."
            },
            {
              "description": "Request unavailable analytics entitlement.",
              "prompt": "Show analytics for my document on a plan without analytics.",
              "expected_behavior": "The plugin clearly states that the feature requires the existing eligible plan without starting checkout."
            }
          ]
        },
        "commerce": false
      },
      "publication": {
        "release_notes": "Initial PDFHost document search, sharing, embed, and analytics tools."
      },
      "apps": "./.app.json"
    }
  }
}