apply-auto-selection
ChatGPTBefore calling it, ask the user to confirm that the calculated equipment may be applied to the project; pass confirm=true only after explicit confirmation. Apply the complete result from forms.autoSelection.result to the project cache and refresh ESCP via withEquipment. Replaces existing equipment settings in the current project and may persist the replacement to a linked account Case. The accepted result contains the selected pump, seal, motor, cable, and surface equipment without alerts. Partial results or results with alerts are rejected with a concrete error reason.
calculate-auto-selection
ChatGPTCalculate simple auto-selection using the current session inputs, frequency, optional brand filters, and wellbore/fluid/inflow condition edits. Writes forms.autoSelection.result without mutating project.escp until a later apply operation. Returns the selected equipment and any calculation alerts or upstream failure context.
calculate-complications-gas-separation
ChatGPTCalculate the current complications gas separation request against the upstream flow-rate-on-tubing-bottom calculator.
calculate-complications-risk
ChatGPTCalculate complications risk from the loaded project and submitted risk-assessment inputs. The tool prepares the required gas-separation and project calculation prerequisites automatically when the selected pump and project data are available. Returns the upstream common, wax, salt, corrosion, erosion, solids, and gas risk buckets with summary data. Reports missing project inputs or upstream calculation failures.
calculate-inclinometry
ChatGPTUse this for a submitted inclinometry widget form or a direct no-UI, text-only result request. Calculate trajectory from deviation survey points and optional wellbore configuration and allowable DLS limits. Returns calculated survey points with actual DLS, an optional allowable maximum curvature rate, and casing, tubing, and perforation chart overlay depths when configured. Reports insufficient input or upstream calculation failures.
calculate-ipr
ChatGPTUse this for a submitted IPR widget form or an explicit no-form, text-only, direct-result request, including non-rendering clients. Calculate a well IPR (Inflow Performance Relationship) curve and the working point at the target flowrate. Inputs include inflow type, reservoir and fluid pressures, targetFlowrate, and either a productivity index or test points. Omit waterCut to use the loaded project value; explicit waterCut is percent (0–100). Returns curve points, productivity index, qMax, the working point when it is in range, and echoed inputs. inputSources.waterCut identifies the original value and unit before conversion. Reports validation or upstream calculation failures without inventing values.
get-complications-equipment-catalog
ChatGPTLoad the current complications equipment catalog from the configured upstream cache endpoints. Returns pump sections and gas separators for the active project context.
get-current-project
ChatGPTRead the complete current nv.design project and saved form state for questions or analysis about any project section. Returns project, forms, projectState, provenance, provenanceSummary, import options, and projectLink. When projectState is empty, project contains defaults, not a loaded user project.
get-project-import-options
ChatGPTUse this to see project upload options and the questionnaire XLSX template link.
get-project-list
ChatGPTList your nv.design Projects and their Cases with General information.
import-project
ChatGPTImports a user-provided nv.design JSON project, SubPUMP TXT/S12 report, or completed XLSX datasheet. Accepts the ChatGPT upload descriptor; the server downloads and parses the file. Replaces the current session project and form state, which may discard existing session edits. Returns a project summary and available follow-up actions, or an import error.
initialize
ChatGPTLoad the current nv.design project context, provenance, available well-engineering tools, localized project-import options, and project link. Use it when the user needs the current session context or asks what this plugin can do. Call initialize once before the first domain tool; fresh for each new capability question, including repeats/language changes; never to write a completed tool reply. Capability replies: four engineering options from tools, complete ordered intake.en, footer; account/import/navigation are intake choices; no intake suppression. Prefer Intelligence UI with native actions when supported; otherwise use readable Markdown with the same information. Choose a natural layout; no fixed greeting script.
list-complications-pumps
ChatGPTList and search pump sections available to the active complications project. Use the returned pump section IDs when selecting or validating a pump.
mark-complications-risk-interpret-consumed
ChatGPTMark the cached complications risk interpretation follow-up as consumed.
mark-ipr-interpret-consumed
ChatGPTMark the cached IPR interpretation follow-up as consumed.
save-current-project
ChatGPTSave the current project to your nv.design account for future chats.
save-ipr-draft
ChatGPTSave the current IPR form inputs for widget reload without running a calculation.
select-project
ChatGPTSelect an accessible nv.design Project and Case for this chat.
show-auto-selection-form
ChatGPTShow the simple auto-selection widget for automatic equipment selection. It collects wellbore, fluid, and inflow conditions, frequency, and optional equipment manufacturer filters before a result is calculated and applied. This tool opens the form and does not calculate or apply equipment.
show-complications-form
ChatGPTShow the complications form widget for a general complications, risk, or risk-assessment request, or a named wax/ASPO, salt/scale, corrosion, erosion, solids, free-gas, pump-selection, or gas-separation request. Free gas and All complications are always visible. For a general request leave showWax, showSalt, showCorrosion, showErosion, and showSolids unset or false; for a named risk set only the matching flags true.
show-inclinometry-form
ChatGPTShow the inclinometry form widget for a bare deviation survey, inclinometry, trajectory, DLS, or wellbore request. The form covers deviation survey points and can expose wellbore configuration or allowable DLS inputs. Set showWellboreConfiguration for casing, tubing, perforation, or pump-setting-depth data; set showDls for allowable or maximum dogleg severity and DLS-limit checks. If the user accepts an offer to calculate allowable DLS, open this form with showDls=true and wait for the user to submit it. Keep both flags false for ordinary survey and trajectory requests.
show-ipr-form
ChatGPTShow the IPR form widget for a bare IPR or inflow-performance request, including productivity index, qMax, working point, test points, or bottomhole pressure at a target flowrate. This tool is for interactive form entry, not submitted widget inputs or explicit no-form, text-only, direct-result requests. For ordinary IPR requests, open this form once and wait for the user to submit Calculate.
validate-auto-selection-conditions
ChatGPTValidate wellbore, fluid, and inflow conditions for the auto-selection widget. Returns validation errors or confirms that the conditions are valid for equipment composition.
validate-complications-pump
ChatGPTValidate the current complications pump request against the upstream pump productivity calculator.