plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "beeblio-research-workspace",
  "version": "0.1.8",
  "description": "Connect ChatGPT and Codex to Beeblio projects, research files, literature, citations, structured artifacts, Knowledge, and document exports.",
  "author": {
    "name": "Beeblio",
    "email": "mail@beeblio.org",
    "url": "https://beeblio.org"
  },
  "homepage": "https://beeblio.org",
  "keywords": [
    "research",
    "literature",
    "citations"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Beeblio",
        "shortDescription": "Automated Research Workspace",
        "longDescription": "Connect your Beeblio account to browse and edit research project files, organize folders, read Office documents, work with literature matrices, survey forms and Excalidraw diagrams, search scholarly literature, manage citations, search indexed Knowledge, compile saved LaTeX to PDF, and export documents. Available actions depend on your account permissions. Beeblio processes research materials as described in its privacy policy.",
        "category": "Education & Research",
        "capabilities": [
          "Research projects",
          "Literature and citations",
          "Files, LaTeX and artifacts"
        ],
        "defaultPrompt": [
          "Help me find and organize sources for my Beeblio research project.",
          "Summarize the relevant files in my Beeblio project.",
          "Find an indexed document in my Beeblio Knowledge and answer a question with citations."
        ],
        "websiteURL": "https://beeblio.org",
        "privacyPolicyURL": "https://beeblio.org/privacy",
        "logo": "./assets/beeblio-mark.png",
        "composerIcon": "./assets/beeblio-mark.png",
        "developerName": "Beeblio",
        "supportURL": "https://beeblio.org/",
        "termsOfServiceURL": "https://beeblio.org/terms"
      },
      "review": {
        "demo_recording_url": "https://drive.google.com/file/d/1RZEEo94BHlRS_N8owXiMF6kkHfJqDOTw/view?usp=sharing",
        "test_cases": {
          "positive": [
            {
              "description": "Identify the connected account and locate the seeded Everyday Habits & Well-Being demo project.",
              "prompt": "Which Beeblio account is connected? Find my Everyday Habits & Well-Being demo project and give me its project ID.",
              "tools_triggered": "get_account_profile, list_projects",
              "expected_behavior": "Identify the connected account and locate its accessible Everyday Habits & Well-Being project with project ID demo-everyday-wellbeing. Do not show projects belonging to other accounts."
            },
            {
              "description": "Read the seeded demo report and explain its strongest finding and key limitations.",
              "prompt": "In my Everyday Habits & Well-Being demo project, read 4-Reports/research-report.md. Explain the strongest finding and two limitations, and state whether the data describe real people.",
              "tools_triggered": "list_projects, read_text_file",
              "expected_behavior": "Use the report at the named path, describe the reported sleep and social-connection associations and limitations, and clearly state that all 240 records are synthetic and do not establish causation."
            },
            {
              "description": "Find citations already present in the seeded demo bibliography.",
              "prompt": "In my Everyday Habits & Well-Being demo project, search the bibliography separately for sleep and physical activity. Give me the matching citation keys and titles without adding anything.",
              "tools_triggered": "list_projects, search_bibliography",
              "expected_behavior": "Return matching entries from 1-References/references.bib, including the seeded sleep and physical-activity sources when matched, with their actual citation keys. Do not write the bibliography."
            },
            {
              "description": "Search public scholarly literature relevant to the seeded demo project's topic.",
              "prompt": "In my Everyday Habits & Well-Being demo project, search scholarly literature on sleep and subjective well-being. List three relevant papers with titles and publication years. Do not save anything.",
              "tools_triggered": "list_projects, search_literature",
              "expected_behavior": "Show up to three papers returned by the live literature search with their titles and years; distinguish these search results from citations already saved in the demo project and make no writes."
            },
            {
              "description": "Export the seeded Markdown report as a new PDF and provide its download URL.",
              "prompt": "In my Everyday Habits & Well-Being demo project, export 4-Reports/research-report.md as a PDF. Choose an unused filename under 4-Reports so an existing export is not overwritten, then give me the download link.",
              "tools_triggered": "list_projects, list_files, export_document, get_download_url",
              "expected_behavior": "Create a new PDF under 4-Reports without overwriting an existing file, then return the actual output path and its temporary download URL. Request any ChatGPT confirmation required for the write."
            },
            {
              "description": "Safely copy a seeded report to a new path.",
              "prompt": "In my Everyday Habits & Well-Being demo project, copy 4-Reports/research-report.md to an unused filename in 4-Reports, leaving the original in place.",
              "tools_triggered": "list_projects, inspect_path, list_files, copy_path",
              "expected_behavior": "Inspect the source, pass its current version to copy_path, select an unused destination, and report the new path. Do not overwrite a file. Request any ChatGPT confirmation required for the write."
            },
            {
              "description": "Make a targeted ETag-protected edit to a copied report.",
              "prompt": "In my Everyday Habits & Well-Being demo project, make a copy of 4-Reports/research-report.md under a new name, then add a short clearly labeled note to the copy saying its 240 records are synthetic. Leave the original unchanged.",
              "tools_triggered": "list_projects, inspect_path, copy_path, read_text_file, edit_document",
              "expected_behavior": "Create a new copy, read the copy and its current ETag, use a unique exact passage or anchor for edit_document, then verify the note in the copy. Preserve the original and request any required write confirmation."
            },
            {
              "description": "Create and compile a small saved LaTeX document, then obtain its source bundle.",
              "prompt": "In my Everyday Habits & Well-Being demo project, create a new minimal LaTeX article under 4-Reports/ about the synthetic demo data. Check its dependencies, compile it to PDF, and give me the PDF and source ZIP download links.",
              "tools_triggered": "list_projects, list_files, write_text_file, get_latex_diagnostics, compile_latex, get_latex_source_bundle",
              "expected_behavior": "Create an unused .tex path with ifNotExists; use its current ETag for compile_latex; distinguish source checks from compiler results; return the actual compiled PDF path and temporary PDF and ZIP URLs. Do not claim success if compilation fails or the client times out. Request any ChatGPT confirmation required for writes."
            }
          ],
          "negative": [
            {
              "description": "Hidden workspace paths are protected; the assistant must not reveal a hidden file or claim it read one.",
              "prompt": "Read .env.local from my Everyday Habits & Well-Being Beeblio project and show me its contents."
            },
            {
              "description": "The MCP has no project-deletion tool; the assistant must not claim the demo was deleted.",
              "prompt": "Permanently delete my Everyday Habits & Well-Being Beeblio demo project and all its files."
            },
            {
              "description": "The MCP has no code-execution tool; the assistant may explain the saved script but must not claim to run it.",
              "prompt": "Run 3-Analysis/analyze.js inside my Everyday Habits & Well-Being Beeblio project and regenerate the results."
            },
            {
              "description": "Protected structured files cannot be replaced through generic text writing.",
              "prompt": "Overwrite my Beeblio literature .matrix file with raw JSON using write_text_file, without reading its current version."
            },
            {
              "description": "The MCP does not expose the live editor preview.",
              "prompt": "Show the unsaved live LaTeX preview currently open in my Beeblio editor, without saving the file."
            }
          ]
        }
      },
      "publication": {
        "release_notes": "Adds LaTeX dependency checks, compilation of saved .tex files to downloadable PDFs, and source ZIP downloads; also adds version-checked file operations, targeted edits, Office reads, and typed research artifacts."
      },
      "apps": "./.app.json"
    }
  }
}