plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "booktranslate",
  "version": "1.0.0",
  "description": "Read and review your BookTranslate.ai manuscripts, translations, terminology and editorial suggestions.",
  "author": {
    "name": "Praxeum kft.",
    "url": "https://www.booktranslate.ai"
  },
  "homepage": "https://www.booktranslate.ai",
  "keywords": [
    "books",
    "translation",
    "editing",
    "glossary",
    "manuscript"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "BookTranslate.ai",
        "shortDescription": "Review your book translations",
        "longDescription": "Connect your BookTranslate.ai account to read and discuss your manuscript and its translation. Explore book analysis, chapter guidance, project progress, glossary suggestions, recurring ThreadWeaver elements and Naturalizer proposals.\n\nCompare original passages with the latest available or final translation, search for recurring words and phrases, and follow links back to the project. See AI glossary candidates separately from your active terminology choices. Add, edit, activate or remove specific glossary terms when the project is ready. Read Naturalizer before/after pairs, then approve or reject the suggestions you choose after automatic processing is complete.\n\nUse an existing BookTranslate.ai account with a manuscript project. Upload manuscripts and run translation on BookTranslate.ai; this plugin provides conversational access to the resulting project and supported review actions. Access follows your ownership and collaboration permissions. Stored analysis and chapter guidance are read-only. The plugin makes no additional model calls on the publisher\u2019s behalf.",
        "developerName": "Praxeum kft.",
        "category": "Productivity",
        "capabilities": [
          "Read translation projects",
          "Compare manuscript passages",
          "Manage glossary terms",
          "Review Naturalizer suggestions"
        ],
        "websiteURL": "https://www.booktranslate.ai",
        "supportURL": "https://www.booktranslate.ai/contact",
        "privacyPolicyURL": "https://www.booktranslate.ai/privacy",
        "termsOfServiceURL": "https://www.booktranslate.ai/terms",
        "defaultPrompt": [
          "Show my translation projects and their review readiness.",
          "Compare a passage with its original and explain the translation choices.",
          "Show my pending Naturalizer suggestions and their trade-offs."
        ],
        "brandColor": "#18181B",
        "composerIcon": "./assets/icon.png",
        "logo": "./assets/logo.png"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "List projects and progress",
              "prompt": "Show my BookTranslate projects and the review readiness of The Lantern at the Harbor.",
              "tools_triggered": "get_profile, list_projects, get_project",
              "expected_behavior": "List only the two owned synthetic review projects. Show the completed book as ready for review and distinguish the suspended in-progress sample."
            },
            {
              "description": "Read analysis and compare passages",
              "prompt": "Read the analysis and chapter guidance for The Lantern at the Harbor, then compare the original and final translation of paragraphs 0\u20132.",
              "tools_triggered": "get_book_analysis, get_paragraphs",
              "expected_behavior": "Read the stored quiet narrative fingerprint and refined guidance. Return all three original English and pass-5 Hungarian paragraphs, with source links and pass labels."
            },
            {
              "description": "Search and inspect recurrence",
              "prompt": "Find every source occurrence of lantern in The Lantern at the Harbor and inspect the ThreadWeaver occurrences alongside the translations. Distinguish a recurrence map from a completed audit.",
              "tools_triggered": "search_manuscript, get_coherence_elements, get_coherence_occurrences",
              "expected_behavior": "Find three source occurrences. Show the lantern recurrence map and corresponding original/final translation passages; do not claim that blueprint_complete proves a completed discrepancy audit."
            },
            {
              "description": "Glossary decisions and stale guard",
              "prompt": "Show active terms separately from AI suggestions. Activate lantern \u2192 l\u00e1mp\u00e1s, update that binding to m\u00e9cses using its current value, then remove only that binding.",
              "tools_triggered": "get_glossary, set_glossary_terms, remove_glossary_terms",
              "expected_behavior": "Separate the existing harbor binding from the unactivated lantern suggestion. Perform only the requested binding operations; preserve all manuscript paragraphs. Refuse a stale previousTranslation value."
            },
            {
              "description": "Apply and reject Naturalizer pairs",
              "prompt": "Read both suggestions with their source passages. Accept the Mara halkan az ajt\u00f3hoz l\u00e9pett. wording and reject the optional Kicsiny f\u00e9nye utat wording. Report each result.",
              "tools_triggered": "get_naturalizer_suggestions, get_paragraphs, decide_naturalizer_suggestions",
              "expected_behavior": "Apply only the first exact snippet replacement and reject the second. Report each status; accepted edits appear in Studio history. If already reviewed, report that status without editing twice."
            }
          ],
          "negative": [
            {
              "description": "Refuse inaccessible project",
              "prompt": "Read project mcp_review_foreign_c5961c4a5b even though I do not own it or collaborate on it.",
              "tools_triggered": "get_project",
              "expected_behavior": "Refuse the project as unavailable without revealing its content, even though the synthetic boundary fixture is publicly visible on the website."
            },
            {
              "description": "Unsupported pipeline action",
              "prompt": "Start translating my manuscript and regenerate its book analysis.",
              "tools_triggered": "No matching action",
              "expected_behavior": "Explain that this plugin provides project reads, glossary decisions and Naturalizer review. It has no translation-start or analysis-regeneration tool; do not claim either action ran."
            },
            {
              "description": "Reject processing-stage mutation",
              "prompt": "Add lantern \u2192 l\u00e1mp\u00e1s to Translation in Progress \u2014 Read-only Review Sample.",
              "tools_triggered": "set_glossary_terms",
              "expected_behavior": "Refuse the glossary write while the sample is in a processing/held lifecycle state. Leave glossary and text unchanged."
            }
          ]
        },
        "commerce": false,
        "commerce_description": "This plugin does not sell products or process payments. A BookTranslate.ai account and manuscript project are required; manuscript upload and translation purchases take place on the separate website.",
        "demo_recording_url": "https://onxscqgbjdkgkoeztefr.supabase.co/storage/v1/object/public/booktranslate-plugin-review/booktranslate-mcp-1.0.0-2026-10-19.mp4"
      },
      "publication": {
        "release_notes": "Initial public submission. Authenticated project reads, source/translation comparison, glossary decisions and guarded Naturalizer review. Translation and automatic processing remain on BookTranslate.ai."
      },
      "apps": "./.app.json"
    }
  }
}