.codex-plugin/plugin.json

{
  "name": "kodapdf",
  "version": "1.0.0",
  "displayName": "KodaPDF",
  "subtitle": "PDF Tools & Converter",
  "category": "Productivity",
  "description": "All-in-one productivity suite to convert, compress, merge, split, OCR, protect, and edit PDF documents.",
  "website_url": "https://kodapdf.com",
  "support_url": "https://kodapdf.com/en/contact",
  "privacy_policy_url": "https://kodapdf.com/en/privacy",
  "terms_of_service_url": "https://kodapdf.com/en/terms",
  "homepage": "https://kodapdf.com",
  "icon": "./assets/icon.png",
  "author": {
    "name": "KodaPDF Team",
    "email": "support@kodapdf.com",
    "url": "https://kodapdf.com"
  },
  "keywords": [
    "productivity",
    "pdf",
    "converter",
    "compress",
    "merge",
    "split",
    "ocr",
    "documents",
    "office"
  ],
  "skills": "./skills/",
  "mcpServers": "./mcp.json",
  "interface": {
    "displayName": "KodaPDF",
    "developerName": "KodaPDF Team",
    "developer_name": "KodaPDF Team",
    "subtitle": "PDF Tools & Converter",
    "shortDescription": "PDF Tools & Converter",
    "longDescription": "KodaPDF is an all-in-one productivity suite to convert between formats (Word, PDF, Excel, PPT), compress, merge, split, extract OCR text, and protect PDF documents.",
    "category": "Productivity",
    "capabilities": [
      "Interactive",
      "Read",
      "Write"
    ],
    "websiteURL": "https://kodapdf.com",
    "website_url": "https://kodapdf.com",
    "supportURL": "https://kodapdf.com/en/contact",
    "support_url": "https://kodapdf.com/en/contact",
    "privacyPolicyURL": "https://kodapdf.com/en/privacy",
    "privacy_policy_url": "https://kodapdf.com/en/privacy",
    "termsOfServiceURL": "https://kodapdf.com/en/terms",
    "terms_of_service_url": "https://kodapdf.com/en/terms",
    "icon": "./assets/icon.png",
    "logo": "./assets/logo.png"
  },
  "review": {
    "test_cases": {
      "positive": [
        {
          "description": "Convert an existing Word document (.docx) to PDF format",
          "prompt": "Please convert this Word document to PDF: https://www.w3.org/WAI/ER/tests/xhtml/testfiles/resources/pdf/dummy.pdf",
          "tools_triggered": "convert_document",
          "expected_behavior": "The model calls convert_document with file_url and target_format='pdf', then presents the completed job status and downloadable PDF link."
        },
        {
          "description": "Compress a PDF file to reduce its size for email or web",
          "prompt": "Can you compress this PDF file to make it smaller? https://www.w3.org/WAI/ER/tests/xhtml/testfiles/resources/pdf/dummy.pdf",
          "tools_triggered": "compress_pdf",
          "expected_behavior": "The model invokes compress_pdf with file_url and recommended compression level, returning the reduced file download link."
        },
        {
          "description": "Merge two PDF documents sequentially into a single consolidated PDF",
          "prompt": "Please merge these two PDF files into one: https://www.w3.org/WAI/ER/tests/xhtml/testfiles/resources/pdf/dummy.pdf and https://www.w3.org/WAI/ER/tests/xhtml/testfiles/resources/pdf/dummy.pdf",
          "tools_triggered": "merge_pdfs",
          "expected_behavior": "The model calls merge_pdfs with the list of two file URLs and returns the merged PDF download link."
        },
        {
          "description": "Extract readable text content from a document using OCR",
          "prompt": "Extract the text from this document using OCR: https://www.w3.org/WAI/ER/tests/xhtml/testfiles/resources/pdf/dummy.pdf",
          "tools_triggered": "extract_text_ocr",
          "expected_behavior": "The model invokes extract_text_ocr with file_url and displays the extracted text content to the user."
        },
        {
          "description": "Lock and encrypt a PDF document with a user password",
          "prompt": "Protect this PDF with password 'SecretPass2026': https://www.w3.org/WAI/ER/tests/xhtml/testfiles/resources/pdf/dummy.pdf",
          "tools_triggered": "protect_pdf",
          "expected_behavior": "The model calls protect_pdf with file_url and password, providing the download link for the encrypted document."
        }
      ],
      "negative": [
        {
          "description": "General conversational or factual question unrelated to documents",
          "prompt": "What is the capital of Australia and what is its population?",
          "tools_triggered": "",
          "expected_behavior": "The model answers the question about Canberra directly without invoking any KodaPDF tools."
        },
        {
          "description": "Programming or software development question",
          "prompt": "Write a Python script to sort an array using quicksort.",
          "tools_triggered": "",
          "expected_behavior": "The model provides the Python quicksort code directly without calling any KodaPDF tools."
        },
        {
          "description": "Creative image generation prompt",
          "prompt": "Generate a watercolor painting of a serene mountain landscape at sunset.",
          "tools_triggered": "",
          "expected_behavior": "The model responds creatively without attempting to run document conversion tools."
        }
      ]
    }
  },
  "extensions": {
    "com.openai": {
      "mcpServers": {
        "kodapdf": {
          "type": "http",
          "url": "https://kodapdf.com/api/mcp"
        }
      },
      "interface": {
        "displayName": "KodaPDF",
        "developerName": "KodaPDF Team",
        "developer_name": "KodaPDF Team",
        "subtitle": "PDF Tools & Converter",
        "shortDescription": "PDF Tools & Converter",
        "longDescription": "KodaPDF is an all-in-one productivity suite to convert between formats (Word, PDF, Excel, PPT), compress, merge, split, extract OCR text, and protect PDF documents.",
        "category": "Productivity",
        "capabilities": [
          "Interactive",
          "Read",
          "Write"
        ],
        "websiteURL": "https://kodapdf.com",
        "website_url": "https://kodapdf.com",
        "supportURL": "https://kodapdf.com/en/contact",
        "support_url": "https://kodapdf.com/en/contact",
        "privacyPolicyURL": "https://kodapdf.com/en/privacy",
        "privacy_policy_url": "https://kodapdf.com/en/privacy",
        "termsOfServiceURL": "https://kodapdf.com/en/terms",
        "terms_of_service_url": "https://kodapdf.com/en/terms",
        "composerIcon": "./assets/icon.png",
        "icon": "./assets/icon.png",
        "logo": "./assets/logo.png"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Convert an existing Word document (.docx) to PDF format",
              "prompt": "Please convert this Word document to PDF: https://www.w3.org/WAI/ER/tests/xhtml/testfiles/resources/pdf/dummy.pdf",
              "tools_triggered": "convert_document",
              "expected_behavior": "The model calls convert_document with file_url and target_format='pdf', then presents the completed job status and downloadable PDF link."
            },
            {
              "description": "Compress a PDF file to reduce its size for email or web",
              "prompt": "Can you compress this PDF file to make it smaller? https://www.w3.org/WAI/ER/tests/xhtml/testfiles/resources/pdf/dummy.pdf",
              "tools_triggered": "compress_pdf",
              "expected_behavior": "The model invokes compress_pdf with file_url and recommended compression level, returning the reduced file download link."
            },
            {
              "description": "Merge two PDF documents sequentially into a single consolidated PDF",
              "prompt": "Please merge these two PDF files into one: https://www.w3.org/WAI/ER/tests/xhtml/testfiles/resources/pdf/dummy.pdf and https://www.w3.org/WAI/ER/tests/xhtml/testfiles/resources/pdf/dummy.pdf",
              "tools_triggered": "merge_pdfs",
              "expected_behavior": "The model calls merge_pdfs with the list of two file URLs and returns the merged PDF download link."
            },
            {
              "description": "Extract readable text content from a document using OCR",
              "prompt": "Extract the text from this document using OCR: https://www.w3.org/WAI/ER/tests/xhtml/testfiles/resources/pdf/dummy.pdf",
              "tools_triggered": "extract_text_ocr",
              "expected_behavior": "The model invokes extract_text_ocr with file_url and displays the extracted text content to the user."
            },
            {
              "description": "Lock and encrypt a PDF document with a user password",
              "prompt": "Protect this PDF with password 'SecretPass2026': https://www.w3.org/WAI/ER/tests/xhtml/testfiles/resources/pdf/dummy.pdf",
              "tools_triggered": "protect_pdf",
              "expected_behavior": "The model calls protect_pdf with file_url and password, providing the download link for the encrypted document."
            }
          ],
          "negative": [
            {
              "description": "General conversational or factual question unrelated to documents",
              "prompt": "What is the capital of Australia and what is its population?",
              "tools_triggered": "",
              "expected_behavior": "The model answers the question about Canberra directly without invoking any KodaPDF tools."
            },
            {
              "description": "Programming or software development question",
              "prompt": "Write a Python script to sort an array using quicksort.",
              "tools_triggered": "",
              "expected_behavior": "The model provides the Python quicksort code directly without calling any KodaPDF tools."
            },
            {
              "description": "Creative image generation prompt",
              "prompt": "Generate a watercolor painting of a serene mountain landscape at sunset.",
              "tools_triggered": "",
              "expected_behavior": "The model responds creatively without attempting to run document conversion tools."
            }
          ]
        }
      }
    }
  },
  "apps": "./.app.json"
}