plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "planbee",
  "version": "1.0.2",
  "description": "Manage maintenance work in PlanBee: equipment, maintenance tasks and incidents, with photos.",
  "author": {
    "name": "German Etcheverria",
    "email": "soporte@planbee.uy",
    "url": "https://planbee.uy"
  },
  "homepage": "https://planbee.uy",
  "license": "MIT",
  "keywords": [
    "maintenance",
    "cmms",
    "facility-management",
    "assets",
    "work-orders",
    "incidents"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "PlanBee",
        "shortDescription": "Manage maintenance work",
        "longDescription": "PlanBee helps maintenance teams keep their equipment running. Ask in plain language to look up equipment and check its condition, list and create maintenance tasks, report incidents, follow how they were resolved and what they cost, and attach photos to any of them. You can also search an equipment manual, read the maintenance notes of a place or a piece of equipment, check when a job was last done and whether its warranty is still active, review rounds and inspections, see how maintenance costs evolve month by month, find equipment by its QR label, and turn the account of a work shift into logged incidents plus a handover note.\n\nPlanBee works on the organizations of your connected PlanBee account. Every result and every action respects your role and permissions in that organization: you only see and change what you could see and change inside the PlanBee app.\n\nA PlanBee account is required. Invoicing, quotes, finances, subscription management and deleting equipment are not available here and are handled inside the PlanBee app.",
        "developerName": "Germ\u00e1n Etcheverria",
        "category": "Business & Operations",
        "capabilities": [
          "Look up equipment and its condition",
          "List and review maintenance tasks",
          "Create and update maintenance tasks",
          "Report and update incidents",
          "Attach photos to tasks, equipment and incidents",
          "Search equipment manuals and maintenance notes",
          "Check job history and work warranties",
          "Review rounds and inspection results",
          "See the monthly trend of maintenance costs",
          "Turn a shift report into incidents and a handover note"
        ],
        "websiteURL": "https://planbee.uy",
        "supportURL": "https://planbee.uy/support",
        "privacyPolicyURL": "https://planbee.uy/privacy",
        "termsOfServiceURL": "https://planbee.uy/terms",
        "defaultPrompt": [
          "Show me the latest maintenance tasks.",
          "Which equipment needs attention right now?",
          "Log an incident: the dishwasher isn't drying properly."
        ],
        "brandColor": "#171717",
        "brandColorDark": "#FF9B37",
        "composerIcon": "./assets/icon.png",
        "logo": "./assets/logo.png"
      },
      "onboardingSkill": "./skills/get-started/SKILL.md",
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "List the latest maintenance tasks.",
              "prompt": "Show me the latest maintenance tasks.",
              "tools_triggered": "maint_list_tasks",
              "expected_behavior": "Returns the most recent maintenance tasks of the test organization with their status and priority. On clients that render plugin UI they are also shown as task cards."
            },
            {
              "description": "Find a known piece of equipment by name. The equipment in the test organization is named in Spanish (\"C\u00e1mara refrigerada\", a walk-in cooler).",
              "prompt": "Show me the status of the C\u00e1mara refrigerada.",
              "tools_triggered": "maint_list_assets",
              "expected_behavior": "Finds the matching equipment and reports its operational status, criticality and location, plus any open tasks or incidents on it."
            },
            {
              "description": "Create a scheduled maintenance task.",
              "prompt": "Create a task to descale the coffee machine next Friday with medium priority.",
              "tools_triggered": "maint_create_task",
              "expected_behavior": "Creates the task in the test organization and confirms its due date and priority."
            },
            {
              "description": "Report a new equipment incident.",
              "prompt": "Log an incident: the dishwasher isn't drying properly.",
              "tools_triggered": "maint_create_incident",
              "expected_behavior": "Creates an open incident in the test organization and confirms its initial status and risk level."
            },
            {
              "description": "Review resolved incidents and their final costs.",
              "prompt": "Show me resolved incidents with their resolution type and final cost.",
              "tools_triggered": "maint_list_incidents",
              "expected_behavior": "Returns the resolved incidents with their resolution type and notes, and the final cost when one was recorded (it says so when no cost was recorded)."
            }
          ],
          "negative": [
            {
              "description": "Deleting equipment is not available through this plugin. It should explain that and not call a write tool.",
              "prompt": "Delete the vertical freezer from the system."
            },
            {
              "description": "Data from an organization the connected account does not belong to must not be returned.",
              "prompt": "Show me the assets of an organization I'm not a member of."
            },
            {
              "description": "Invoicing and subscription management are outside this plugin. It may look at maintenance records, but it must state that invoices and the subscription plan are not available here and must not invent figures.",
              "prompt": "What did we invoice last month and what's our subscription plan?"
            }
          ]
        },
        "demo_recording_url": "https://drive.google.com/file/d/19pWaFv3acbbrBbGZ3ETU7Q0NPveABsio/view",
        "commerce": false,
        "commerce_description": "This plugin does not sell products or process payments."
      },
      "publication": {
        "release_notes": "Adds read-only tools for those who look after equipment: equipment manuals and maintenance notes, job history, work warranties, rounds and inspections, monthly maintenance costs and QR label lookup, plus a guide to turn a shift report into incidents and a handover note.",
        "translations": {
          "es-ES": {
            "subtitle": "Gestion\u00e1 el mantenimiento",
            "description": "PlanBee ayuda a los equipos de mantenimiento a tener sus equipos funcionando. Ped\u00ed en lenguaje natural consultar equipos y su estado, listar y crear tareas de mantenimiento, reportar incidencias, ver c\u00f3mo se resolvieron y cu\u00e1nto costaron, y adjuntar fotos. Tambi\u00e9n pod\u00e9s buscar en el manual de un equipo, leer las indicaciones de mantenimiento de un lugar o equipo, ver cu\u00e1ndo se hizo un trabajo por \u00faltima vez y si su garant\u00eda sigue vigente, revisar recorridas e inspecciones, ver c\u00f3mo evolucionan los costos de mantenimiento mes a mes, encontrar un equipo por su etiqueta QR y convertir el relato de un turno en incidencias cargadas y un parte para el turno siguiente.\n\nPlanBee trabaja sobre las organizaciones de tu cuenta de PlanBee conectada. Cada resultado y cada acci\u00f3n respeta tu rol y tus permisos: solo ves y cambi\u00e1s lo mismo que podr\u00edas ver y cambiar dentro de la app.\n\nSe necesita una cuenta de PlanBee. La facturaci\u00f3n, los presupuestos, las finanzas, la suscripci\u00f3n y el borrado de equipos no est\u00e1n disponibles ac\u00e1: se manejan dentro de la app."
          }
        }
      },
      "apps": "./.app.json"
    }
  }
}