Check whether Microsoft Visio is running and return version and open document info.

Start Microsoft Visio. Auto-detects the installation. Does nothing if already running.

Create a new blank Visio drawing document.

Open an existing Visio file (.vsdx or .vsd).

Save the active Visio document. Optionally save to a new path.

Close the active Visio document.

Get name, path, page count and save status of the active document.

List all pages in the active Visio document with name, size, and shape count.

Add a new page to the active Visio document.

Add a shape to a Visio page. Coordinates are in inches from the top-left corner.

Set or replace the text label of a shape.

Move a shape to a new position (top-left coordinates in inches).

Resize a shape to new dimensions.

Permanently delete a shape from the page.

Draw a connector (arrow) between two shapes.

List all shapes on a page with their IDs, positions, sizes, and text content.

Get the shapes currently selected in the active Visio window.

List all connectors on a page, showing which shapes they connect.

Export the Visio document or a page to PNG, PDF, SVG, EMF, or VSDX.

List every diagram type this server can build (currently UML Activity and Basic Flowchart), with a one-line description and the element-kind vocabulary each type allows. Use this to choose a type when the requirement does not name one.

Return the full element vocabulary for one diagram type: each kind's Visio master, default size (px @96dpi), and default styling. Use this to build nodes with valid "kind" values for the chosen type.

Resolve which installed Visio stencil supplies a diagram type's masters (discovery-first: running docs -> candidate files -> master index). Returns status "resolved" (with the stencil path) or "needs_download" when the stencil is not installed.

Validate a diagram spec (an IR object with diagram_type/nodes/edges). Runs vocabulary/structure checks and, if nodes are positioned, geometry checks (on-page, no overlaps). Returns { ok, problems }.

PHASE 1 of diagram generation. You (the calling model) read the requirement, decide the diagram type, and extract the elements, then call this to validate the graph against that type's vocabulary (rejecting mixed element types) and get back a normalized analysis to pass into plan_diagram.

PHASE 2 of diagram generation. Takes the analysis (or any IR spec) and computes a concrete, positioned layout: ranks/rows, orthogonal edge routing through empty corridors, guard-label placement. Explicit x/y on any node or explicit edge waypoints are preserved (manual override).

PHASE 3 of diagram generation. Renders the positioned spec in Visio and saves .vsdx plus .png. Resolves the diagram type's stencil first; if it is not installed this returns status "needs_download" and renders nothing unless allow_primitive_fallback=true. Visio stays open and visible.