plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "nv-design",
  "version": "1.0.0",
  "description": "nv.design helps well engineers evaluate oil-well inflow, wellbore trajectories, production risks, and artificial-lift equipment. Open interactive forms, calculate IPR curves and working points, inspect deviation surveys and dogleg limits, assess production complications, and calculate and apply equipment selections. Import nv.design JSON projects, SubPUMP TXT/S12 reports, or filled XLSX datasheets to prefill the forms. Engineering workflows can operate in the current chat without account sign-in where supported. Cognito OAuth is required to list account Projects and Cases, select an accessible Case, or save the current project to an account. After an explicit save or account Case selection, committed project edits are synchronized to the account. Calculations depend on the configured nv.design services and available project data.",
  "author": {
    "name": "NewVision Upstream",
    "url": "https://newvision.io"
  },
  "homepage": "https://newvision.io",
  "keywords": [
    "well engineering",
    "inflow performance",
    "well trajectory",
    "production risks",
    "artificial lift"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "nv.design",
        "logo": "./assets/icon.png",
        "composerIcon": "./assets/icon.png",
        "shortDescription": "Size and select ESP pumps",
        "longDescription": "This plugin helps production and artificial lift engineers choose an electric submersible pump (ESP) system for an oil well and check how it will perform under the well\u2019s conditions.\n\nStart with your well geometry, fluid and reservoir data, and target production rate. Upload an Excel questionnaire, a supported export (e.g. SubPump) or a saved project - or enter the data in the forms within ChatGPT. Then ask a question such as \u201cSelect an ESP for this well\u201d or \u201cCheck the risk of corrosion.\u201d\n\nYou\u2019ll get a proposed equipment selection, including the pump, motor, cables and supporting equipment, along with calculation results, charts and explanations. You can also assess potential problems such as free gas, scale, wax deposits and corrosion. \n\nChange the operating speed, manufacturer or well conditions and rerun the calculation to explore another option.\n\nYour well data carries through the conversation, and you can open the same project in nv.design to continue in the full application. Sign in to browse your account Projects and Cases or explicitly save the current project. After saving or selecting an account Case, committed project changes are synchronized to your account.",
        "developerName": "NewVision Upstream",
        "category": "Data & Analytics",
        "capabilities": [
          "IPR curves and working points",
          "Well trajectories and dogleg limits",
          "Production complication risks",
          "Artificial-lift equipment selection",
          "Project file import",
          "Account Projects and Cases",
          "Project saving and synchronization"
        ],
        "websiteURL": "https://newvision.io",
        "supportURL": "https://newvision.io/help",
        "privacyPolicyURL": "https://newvision.io/policy",
        "termsOfServiceURL": "https://newvision.io/terms"
      },
      "review": {
        "demo_recording_url": "https://www.youtube.com/watch?v=YOUR_VIDEO_ID",
        "test_cases": {
          "positive": [
            {
              "description": "Discover capabilities and access, select, and save an account Case using Cognito OAuth.",
              "prompt": "What can nv.design do? List my account Projects and Cases, select the first accessible Case, and save the current project to my account.",
              "tools_triggered": "initialize, get-project-list, select-project, save-current-project",
              "expected_behavior": "Explains the four engineering workflows and account/import options. Requires Cognito sign-in for account operations. Lists only accessible Projects and Cases, uses the returned identifiers for selection, and saves only because the user explicitly requested it. If the account has no Cases or a service fails, reports that state without inventing records or claiming a successful save."
            },
            {
              "description": "Calculate an IPR directly from explicit inputs without opening a form.",
              "prompt": "Calculate an IPR directly in text, without a form, using nv.design field units: Vogel inflow, target flowrate 100 bbl/day, reservoir pressure 3000 psi, water cut 0%, bubble-point pressure 2000 psi, use productivity index 1 bbl/day/psi, and no test points; interpret the result.",
              "tools_triggered": "initialize, calculate-ipr",
              "expected_behavior": "Returns the computed curve, productivity index, maximum flowrate and working point when in range, and interprets only the returned results; validation or service failures are reported without invented values."
            },
            {
              "description": "Calculate a simple vertical survey without optional wellbore or dogleg-limit inputs.",
              "prompt": "Calculate this deviation survey directly in text without a form, using minimum curvature and nv.design field units: depth/inclination/azimuth/vertical depth = 0 ft/0 degrees/0 degrees/0 ft, 100 ft/0 degrees/0 degrees/100 ft, 200 ft/0 degrees/0 degrees/200 ft; target inclination, no wellbore overlay, no allowable DLS calculation.",
              "tools_triggered": "initialize, calculate-inclinometry",
              "expected_behavior": "Returns the calculated survey and actual dogleg severity for the vertical trajectory without inventing casing, tubing, or allowable dogleg-limit values."
            },
            {
              "description": "Handle a complications request with no loaded project.",
              "prompt": "In this new chat, open the corrosion and erosion risk assessment for my well; I have not uploaded a project yet.",
              "tools_triggered": "initialize, show-complications-form",
              "expected_behavior": "Explains that a project must be uploaded before the complications assessment and does not invent a risk result or claim that a project was imported."
            },
            {
              "description": "Start equipment selection without silently calculating or applying equipment.",
              "prompt": "Open the automatic equipment-selection form so I can enter well conditions and manufacturer preferences; wait for me to submit it.",
              "tools_triggered": "initialize, show-auto-selection-form",
              "expected_behavior": "Shows the editable equipment-selection form with supported manufacturer options and optional import guidance; no selection is calculated or applied merely by opening the form."
            }
          ],
          "negative": [
            {
              "description": "Do not invoke well-engineering tools for financial trading.",
              "prompt": "Buy shares in an oil company for me.",
              "expected_behavior": "Does not invoke nv.design because it does not trade securities or manage investment accounts."
            },
            {
              "description": "Do not mistake a household plumbing request for oil-well equipment selection.",
              "prompt": "Choose and order a kitchen tap and a domestic water booster pump for my apartment.",
              "expected_behavior": "Does not invoke nv.design because household plumbing purchases are outside its oil-well engineering workflows."
            },
            {
              "description": "Do not invoke project tools for a general explanation.",
              "prompt": "Explain in general what OAuth is; do not access or change any well project.",
              "expected_behavior": "Answers the general question without invoking nv.design tools."
            }
          ]
        },
        "commerce": false,
        "commerce_description": "The MCP performs well-engineering and project-management operations; it does not sell products or process payments."
      },
      "publication": {
        "release_notes": "nv.design 1.0.0 supports Cognito OAuth sign-in for browsing account Projects and Cases, selecting a Case, and saving the current project. After saving or selecting an account Case, committed project changes are synchronized to the account. Engineering workflows include IPR calculations, well trajectory analysis, production risk assessment, artificial-lift equipment selection, and project import."
      },
      "apps": "./.app.json"
    }
  }
}