@snaptrude/plugin-core 0.3.0 → 0.5.0

package/api-manifest.json

@@ -0,0 +1,3845 @@
+[
+  {
+    "path": "core.buildings.copy",
+    "namespace": "core.buildings",
+    "summary": "Copy a building.",
+    "examplePrompts": [
+      "Copy building blg_1",
+      "Make an independent editable copy of this building",
+      "Copy Tower A as instances to save memory\n\n# Example\n```ts\nconst { buildingId } = await snaptrude.core.buildings.copy(\"blg_1\", {\nname: \"Tower A Copy\",\nasInstances: false,\n})\n```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginCoreBuildingsCopyResult"
+  },
+  {
+    "path": "core.buildings.create",
+    "namespace": "core.buildings",
+    "summary": "Create a new building.",
+    "examplePrompts": [
+      "Create a building called Tower B",
+      "Add a new building at elevation 12 meters",
+      "Make a second building named Annex\n\n# Example\n```ts\nconst { buildingId } = await snaptrude.core.buildings.create(\"Tower B\", 0)\n```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginCoreBuildingsCreateResult"
+  },
+  {
+    "path": "core.buildings.delete",
+    "namespace": "core.buildings",
+    "summary": "Delete a building.",
+    "examplePrompts": [
+      "Delete building blg_2",
+      "Remove the Annex building and everything in it",
+      "Delete this building\n\n# Example\n```ts\nawait snaptrude.core.buildings.delete(\"blg_2\")\n```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginCoreBuildingsDeleteResult"
+  },
+  {
+    "path": "core.buildings.get",
+    "namespace": "core.buildings",
+    "summary": "Get a single building by id.",
+    "examplePrompts": [
+      "Get the building with id blg_1",
+      "Look up a single building by its id",
+      "What is the base elevation of building blg_2?\n\n# Example\n```ts\nconst building = await snaptrude.core.buildings.get(\"blg_1\")\nif (building) console.log(building.name, building.baseElevation)\n```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginCoreBuildingsGetResult"
+  },
+  {
+    "path": "core.buildings.getActive",
+    "namespace": "core.buildings",
+    "summary": "Get the active building.",
+    "examplePrompts": [
+      "Which building is active?",
+      "Get the current building",
+      "What building am I working in?\n\n# Example\n```ts\nconst active = await snaptrude.core.buildings.getActive()\nif (active) console.log(active.buildingId)\n```"
+    ],
+    "argsType": null,
+    "resultType": "PluginCoreBuildingsGetActiveResult"
+  },
+  {
+    "path": "core.buildings.list",
+    "namespace": "core.buildings",
+    "summary": "List the buildings in the active project.",
+    "examplePrompts": [
+      "List all the buildings in my project",
+      "How many buildings are in this model?",
+      "Show every building with its base elevation\n\n# Example\n```ts\nconst { buildings } = await snaptrude.core.buildings.list()\nfor (const b of buildings) console.log(b.name, b.baseElevation)\n```"
+    ],
+    "argsType": null,
+    "resultType": "PluginCoreBuildingsListResult"
+  },
+  {
+    "path": "core.buildings.listStoreys",
+    "namespace": "core.buildings",
+    "summary": "List the storeys of a building.",
+    "examplePrompts": [
+      "List the storeys in building blg_1",
+      "How many floors does this building have?",
+      "Get the storey ids of the active building\n\n# Example\n```ts\nconst { storeyIds } = await snaptrude.core.buildings.listStoreys(\"blg_1\")\nconsole.log(`${storeyIds.length} storeys`)\n```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginCoreBuildingsListStoreysResult"
+  },
+  {
+    "path": "core.buildings.setActive",
+    "namespace": "core.buildings",
+    "summary": "Make a building the active building.",
+    "examplePrompts": [
+      "Switch to building blg_2",
+      "Make this building the active one",
+      "Set the active building to blg_1\n\n# Example\n```ts\nawait snaptrude.core.buildings.setActive(\"blg_2\")\n```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginCoreBuildingsSetActiveResult"
+  },
+  {
+    "path": "core.buildings.update",
+    "namespace": "core.buildings",
+    "summary": "Update a building's name and/or base elevation.",
+    "examplePrompts": [
+      "Rename building blg_1 to Tower A",
+      "Move the building up to elevation 6 meters",
+      "Change the base elevation of blg_2\n\n# Example\n```ts\nconst building = await snaptrude.core.buildings.update(\"blg_1\", { name: \"Tower A\" })\n```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginCoreBuildingsUpdateResult"
+  },
+  {
+    "path": "core.comment.create",
+    "namespace": "core.comment",
+    "summary": "Create a comment.",
+    "examplePrompts": [],
+    "argsType": "string",
+    "resultType": "CommentHandle"
+  },
+  {
+    "path": "core.comment.delete",
+    "namespace": "core.comment",
+    "summary": "Delete a comment.",
+    "examplePrompts": [],
+    "argsType": "CommentHandle",
+    "resultType": "boolean"
+  },
+  {
+    "path": "core.comment.isResolved",
+    "namespace": "core.comment",
+    "summary": "Whether a comment is resolved.",
+    "examplePrompts": [],
+    "argsType": "CommentHandle",
+    "resultType": "boolean"
+  },
+  {
+    "path": "core.comment.list",
+    "namespace": "core.comment",
+    "summary": "List all (non-deleted) comment handles in the project.",
+    "examplePrompts": [],
+    "argsType": null,
+    "resultType": "CommentHandle[]"
+  },
+  {
+    "path": "core.comment.reopen",
+    "namespace": "core.comment",
+    "summary": "Reopen a resolved comment. Paired with {@link PluginCommentApi.resolve}.",
+    "examplePrompts": [],
+    "argsType": "CommentHandle",
+    "resultType": "boolean"
+  },
+  {
+    "path": "core.comment.resolve",
+    "namespace": "core.comment",
+    "summary": "Mark a comment resolved. Paired with {@link PluginCommentApi.reopen}.",
+    "examplePrompts": [],
+    "argsType": "CommentHandle",
+    "resultType": "boolean"
+  },
+  {
+    "path": "core.comment.tag",
+    "namespace": "core.comment",
+    "summary": "Tag (mention) a user on an existing comment, by email.",
+    "examplePrompts": [],
+    "argsType": "CommentHandle",
+    "resultType": "boolean"
+  },
+  {
+    "path": "core.comment.update",
+    "namespace": "core.comment",
+    "summary": "Edit a comment's message (and optional",
+    "examplePrompts": [],
+    "argsType": "CommentHandle",
+    "resultType": "boolean"
+  },
+  {
+    "path": "core.geom.create.arc",
+    "namespace": "core.geom.create",
+    "summary": "Create a circular arc from its start, end, centre, and axis point handles. Host API call — returns a handle.",
+    "examplePrompts": [],
+    "argsType": "Vec3Handle",
+    "resultType": "ArcHandle"
+  },
+  {
+    "path": "core.geom.create.circle",
+    "namespace": "core.geom.create",
+    "summary": "Create a circle from a centre point, an axis (plane normal), and a radius. Host API call — returns a handle. A circle is a closed curve; read it back via `snaptrude.core.geom.query.circle.*`.",
+    "examplePrompts": [],
+    "argsType": "Vec3Handle",
+    "resultType": "CircleHandle"
+  },
+  {
+    "path": "core.geom.create.contourFromProfile",
+    "namespace": "core.geom.create",
+    "summary": "Create a contour (an outer profile loop, no holes). Host API call — returns a handle.",
+    "examplePrompts": [],
+    "argsType": "ProfileHandle",
+    "resultType": "ContourHandle"
+  },
+  {
+    "path": "core.geom.create.contourFromProfiles",
+    "namespace": "core.geom.create",
+    "summary": "Create a contour from an outer profile plus zero or more inner profiles (holes). Host API call — returns a handle.",
+    "examplePrompts": [],
+    "argsType": "ProfileHandle",
+    "resultType": "ContourHandle"
+  },
+  {
+    "path": "core.geom.create.line",
+    "namespace": "core.geom.create",
+    "summary": "Create a straight line segment between two point handles. Host API call — returns a handle.",
+    "examplePrompts": [],
+    "argsType": "Vec3Handle",
+    "resultType": "LineHandle"
+  },
+  {
+    "path": "core.geom.create.profileFromCurves",
+    "namespace": "core.geom.create",
+    "summary": "Create a profile from an ordered list of curve handles forming a closed loop. Host API call — returns a handle.",
+    "examplePrompts": [],
+    "argsType": "CurveHandle[]",
+    "resultType": "ProfileHandle"
+  },
+  {
+    "path": "core.geom.create.profileFromLinePoints",
+    "namespace": "core.geom.create",
+    "summary": "Create a closed profile from an ordered list of point handles connected by line segments (last auto-connected to first). Host API call — returns a handle.",
+    "examplePrompts": [],
+    "argsType": "Vec3Handle[]",
+    "resultType": "ProfileHandle"
+  },
+  {
+    "path": "core.geom.create.profileRect",
+    "namespace": "core.geom.create",
+    "summary": "Create an axis-aligned **rectangle** profile (XZ plane) of `width` × `depth`, centred at `center` (defaults to the origin). Host API call — returns a handle.",
+    "examplePrompts": [],
+    "argsType": "number",
+    "resultType": "ProfileHandle"
+  },
+  {
+    "path": "core.geom.delete.contour",
+    "namespace": "core.geom.delete",
+    "summary": "Free a transient contour resource handle — releases its registry entry and reclaims its share of the plugin's resource quota. Handle-lifecycle only; does NOT tear down engine-side geometry, nor the contour's child profile handles.",
+    "examplePrompts": [],
+    "argsType": "ContourHandle",
+    "resultType": "void"
+  },
+  {
+    "path": "core.geom.delete.profile",
+    "namespace": "core.geom.delete",
+    "summary": "Free a transient profile resource handle — releases its registry entry and reclaims its share of the plugin's resource quota. This is a handle-lifecycle operation only and does NOT tear down any engine-side geometry.",
+    "examplePrompts": [],
+    "argsType": "ProfileHandle",
+    "resultType": "void"
+  },
+  {
+    "path": "core.geom.query.arc.getAxis",
+    "namespace": "core.geom.query.arc",
+    "summary": "Read the rotation axis of an arc.",
+    "examplePrompts": [],
+    "argsType": "ArcHandle",
+    "resultType": "Vec3Components"
+  },
+  {
+    "path": "core.geom.query.arc.getCentre",
+    "namespace": "core.geom.query.arc",
+    "summary": "Read the centre point of an arc.",
+    "examplePrompts": [],
+    "argsType": "ArcHandle",
+    "resultType": "Vec3Components"
+  },
+  {
+    "path": "core.geom.query.arc.getRadius",
+    "namespace": "core.geom.query.arc",
+    "summary": "Read the radius of an arc.",
+    "examplePrompts": [],
+    "argsType": "ArcHandle",
+    "resultType": "number"
+  },
+  {
+    "path": "core.geom.query.arc.getSweepAngle",
+    "namespace": "core.geom.query.arc",
+    "summary": "Read the sweep angle of an arc (the angle subtended at its centre).",
+    "examplePrompts": [],
+    "argsType": "ArcHandle",
+    "resultType": "number"
+  },
+  {
+    "path": "core.geom.query.arc.isValid",
+    "namespace": "core.geom.query.arc",
+    "summary": "Check whether an arc is geometrically valid.",
+    "examplePrompts": [],
+    "argsType": "ArcHandle",
+    "resultType": "boolean"
+  },
+  {
+    "path": "core.geom.query.brep.getBoundingBox",
+    "namespace": "core.geom.query.brep",
+    "summary": "Get the axis-aligned bounding box of a brep.",
+    "examplePrompts": [],
+    "argsType": "BrepHandle",
+    "resultType": "BBoxComponents"
+  },
+  {
+    "path": "core.geom.query.brep.getCentroid",
+    "namespace": "core.geom.query.brep",
+    "summary": "Get the centroid (mean of all vertex positions) of a brep.",
+    "examplePrompts": [],
+    "argsType": "BrepHandle",
+    "resultType": "Vec3Components"
+  },
+  {
+    "path": "core.geom.query.brep.getEdge",
+    "namespace": "core.geom.query.brep",
+    "summary": "Get the edge connecting two vertices (by their brep vertex indices).",
+    "examplePrompts": [],
+    "argsType": "BrepHandle",
+    "resultType": "EdgeHandle | null"
+  },
+  {
+    "path": "core.geom.query.brep.getEdgeCount",
+    "namespace": "core.geom.query.brep",
+    "summary": "Get the number of edges in a brep.",
+    "examplePrompts": [],
+    "argsType": "BrepHandle",
+    "resultType": "number"
+  },
+  {
+    "path": "core.geom.query.brep.getFaceCount",
+    "namespace": "core.geom.query.brep",
+    "summary": "Get the number of faces in a brep.",
+    "examplePrompts": [],
+    "argsType": "BrepHandle",
+    "resultType": "number"
+  },
+  {
+    "path": "core.geom.query.brep.getHalfEdgeCount",
+    "namespace": "core.geom.query.brep",
+    "summary": "Get the number of half-edges in a brep.",
+    "examplePrompts": [],
+    "argsType": "BrepHandle",
+    "resultType": "number"
+  },
+  {
+    "path": "core.geom.query.brep.getVertexCount",
+    "namespace": "core.geom.query.brep",
+    "summary": "Get the number of vertices in a brep.",
+    "examplePrompts": [],
+    "argsType": "BrepHandle",
+    "resultType": "number"
+  },
+  {
+    "path": "core.geom.query.brep.getVertexPosition",
+    "namespace": "core.geom.query.brep",
+    "summary": "Get the position of a vertex within a brep.",
+    "examplePrompts": [],
+    "argsType": "BrepHandle",
+    "resultType": "Vec3Components"
+  },
+  {
+    "path": "core.geom.query.brep.hasEdge",
+    "namespace": "core.geom.query.brep",
+    "summary": "Test whether an edge connects two vertices (by their brep vertex indices).",
+    "examplePrompts": [],
+    "argsType": "BrepHandle",
+    "resultType": "boolean"
+  },
+  {
+    "path": "core.geom.query.brep.isEqual",
+    "namespace": "core.geom.query.brep",
+    "summary": "Test whether two breps are geometrically equal.",
+    "examplePrompts": [],
+    "argsType": "BrepHandle",
+    "resultType": "boolean"
+  },
+  {
+    "path": "core.geom.query.brep.listEdges",
+    "namespace": "core.geom.query.brep",
+    "summary": "List the edges of a brep.",
+    "examplePrompts": [],
+    "argsType": "BrepHandle",
+    "resultType": "EdgeHandle[]"
+  },
+  {
+    "path": "core.geom.query.brep.listEdgesBetween",
+    "namespace": "core.geom.query.brep",
+    "summary": "List every edge connecting two vertices (by their brep vertex indices).",
+    "examplePrompts": [],
+    "argsType": "BrepHandle",
+    "resultType": "EdgeHandle[]"
+  },
+  {
+    "path": "core.geom.query.brep.listFaces",
+    "namespace": "core.geom.query.brep",
+    "summary": "List the faces of a brep.",
+    "examplePrompts": [],
+    "argsType": "BrepHandle",
+    "resultType": "FaceHandle[]"
+  },
+  {
+    "path": "core.geom.query.brep.listHalfEdges",
+    "namespace": "core.geom.query.brep",
+    "summary": "List the half-edges of a brep.",
+    "examplePrompts": [],
+    "argsType": "BrepHandle",
+    "resultType": "HalfEdgeHandle[]"
+  },
+  {
+    "path": "core.geom.query.brep.listVertexPositions",
+    "namespace": "core.geom.query.brep",
+    "summary": "List the positions of all vertices in a brep (ordered as {@linkcode PluginGeomQueryBrepApi.listVertices}).",
+    "examplePrompts": [],
+    "argsType": "BrepHandle",
+    "resultType": "Vec3Components[]"
+  },
+  {
+    "path": "core.geom.query.brep.listVertices",
+    "namespace": "core.geom.query.brep",
+    "summary": "List the vertices of a brep.",
+    "examplePrompts": [],
+    "argsType": "BrepHandle",
+    "resultType": "VertexHandle[]"
+  },
+  {
+    "path": "core.geom.query.circle.getAxis",
+    "namespace": "core.geom.query.circle",
+    "summary": "Read the axis (plane normal) of a circle.",
+    "examplePrompts": [],
+    "argsType": "CircleHandle",
+    "resultType": "Vec3Components"
+  },
+  {
+    "path": "core.geom.query.circle.getCentre",
+    "namespace": "core.geom.query.circle",
+    "summary": "Read the centre point of a circle.",
+    "examplePrompts": [],
+    "argsType": "CircleHandle",
+    "resultType": "Vec3Components"
+  },
+  {
+    "path": "core.geom.query.circle.getLength",
+    "namespace": "core.geom.query.circle",
+    "summary": "Read the length (circumference, `2πr`) of a circle.",
+    "examplePrompts": [],
+    "argsType": "CircleHandle",
+    "resultType": "number"
+  },
+  {
+    "path": "core.geom.query.circle.getNearestPoint",
+    "namespace": "core.geom.query.circle",
+    "summary": "Get the point on a circle nearest to an arbitrary point.",
+    "examplePrompts": [],
+    "argsType": "CircleHandle",
+    "resultType": "Vec3Components"
+  },
+  {
+    "path": "core.geom.query.circle.getNormal",
+    "namespace": "core.geom.query.circle",
+    "summary": "Get the (in-plane, radial) normal direction of a circle at a point on it.",
+    "examplePrompts": [],
+    "argsType": "CircleHandle",
+    "resultType": "Vec3Components"
+  },
+  {
+    "path": "core.geom.query.circle.getPointAtDistance",
+    "namespace": "core.geom.query.circle",
+    "summary": "Get the point reached by travelling a signed arc-distance along the circle from a reference point that lies on it.",
+    "examplePrompts": [],
+    "argsType": "CircleHandle",
+    "resultType": "Vec3Components"
+  },
+  {
+    "path": "core.geom.query.circle.getRadius",
+    "namespace": "core.geom.query.circle",
+    "summary": "Read the radius of a circle.",
+    "examplePrompts": [],
+    "argsType": "CircleHandle",
+    "resultType": "number"
+  },
+  {
+    "path": "core.geom.query.circle.getTangent",
+    "namespace": "core.geom.query.circle",
+    "summary": "Get the tangent direction of a circle at a point on it.",
+    "examplePrompts": [],
+    "argsType": "CircleHandle",
+    "resultType": "Vec3Components"
+  },
+  {
+    "path": "core.geom.query.circle.hasPoint",
+    "namespace": "core.geom.query.circle",
+    "summary": "Test whether a point lies on a circle.",
+    "examplePrompts": [],
+    "argsType": "CircleHandle",
+    "resultType": "boolean"
+  },
+  {
+    "path": "core.geom.query.circle.isEqual",
+    "namespace": "core.geom.query.circle",
+    "summary": "Test whether two circles are geometrically equal.",
+    "examplePrompts": [],
+    "argsType": "CircleHandle",
+    "resultType": "boolean"
+  },
+  {
+    "path": "core.geom.query.circle.isValid",
+    "namespace": "core.geom.query.circle",
+    "summary": "Check whether a circle is geometrically valid (non-degenerate axis + positive radius).",
+    "examplePrompts": [],
+    "argsType": "CircleHandle",
+    "resultType": "boolean"
+  },
+  {
+    "path": "core.geom.query.circle.listPoints",
+    "namespace": "core.geom.query.circle",
+    "summary": "Sample a circle into an ordered list of points.",
+    "examplePrompts": [],
+    "argsType": "CircleHandle",
+    "resultType": "Vec3Components[]"
+  },
+  {
+    "path": "core.geom.query.contour.getArea",
+    "namespace": "core.geom.query.contour",
+    "summary": "Get the (approximate) net enclosed area of a contour — the outer profile area minus the area of every hole.",
+    "examplePrompts": [],
+    "argsType": "ContourHandle",
+    "resultType": "number"
+  },
+  {
+    "path": "core.geom.query.contour.getBoundingBox",
+    "namespace": "core.geom.query.contour",
+    "summary": "Get the axis-aligned bounding box of a contour.",
+    "examplePrompts": [],
+    "argsType": "ContourHandle",
+    "resultType": "BBoxComponents"
+  },
+  {
+    "path": "core.geom.query.contour.getHoleCount",
+    "namespace": "core.geom.query.contour",
+    "summary": "Get the number of inner profiles (holes) in a contour.",
+    "examplePrompts": [],
+    "argsType": "ContourHandle",
+    "resultType": "number"
+  },
+  {
+    "path": "core.geom.query.contour.getNearestPoint",
+    "namespace": "core.geom.query.contour",
+    "summary": "Get the point on a contour nearest to an arbitrary point.",
+    "examplePrompts": [],
+    "argsType": "ContourHandle",
+    "resultType": "Vec3Components"
+  },
+  {
+    "path": "core.geom.query.contour.getNormal",
+    "namespace": "core.geom.query.contour",
+    "summary": "Get the unit normal vector of a contour's plane.",
+    "examplePrompts": [],
+    "argsType": "ContourHandle",
+    "resultType": "Vec3Components | null"
+  },
+  {
+    "path": "core.geom.query.contour.getOuterProfile",
+    "namespace": "core.geom.query.contour",
+    "summary": "Get the outer (boundary) profile of a contour. Host API call — mints a fresh handle.",
+    "examplePrompts": [],
+    "argsType": "ContourHandle",
+    "resultType": "ProfileHandle | null"
+  },
+  {
+    "path": "core.geom.query.contour.getPerimeter",
+    "namespace": "core.geom.query.contour",
+    "summary": "Get the perimeter (total length of every curve) of a contour, including holes.",
+    "examplePrompts": [],
+    "argsType": "ContourHandle",
+    "resultType": "number"
+  },
+  {
+    "path": "core.geom.query.contour.hasPoint",
+    "namespace": "core.geom.query.contour",
+    "summary": "Test whether a point lies inside a contour (inside the outer profile and outside every hole).",
+    "examplePrompts": [],
+    "argsType": "ContourHandle",
+    "resultType": "boolean"
+  },
+  {
+    "path": "core.geom.query.contour.isClockwise",
+    "namespace": "core.geom.query.contour",
+    "summary": "Test whether a contour's outer profile is wound clockwise on the XZ plane.",
+    "examplePrompts": [],
+    "argsType": "ContourHandle",
+    "resultType": "boolean"
+  },
+  {
+    "path": "core.geom.query.contour.isEmpty",
+    "namespace": "core.geom.query.contour",
+    "summary": "Test whether a contour is empty (its outer profile contains no curves).",
+    "examplePrompts": [],
+    "argsType": "ContourHandle",
+    "resultType": "boolean"
+  },
+  {
+    "path": "core.geom.query.contour.isEqual",
+    "namespace": "core.geom.query.contour",
+    "summary": "Test whether two contours are geometrically equal.",
+    "examplePrompts": [],
+    "argsType": "ContourHandle",
+    "resultType": "boolean"
+  },
+  {
+    "path": "core.geom.query.contour.isOnBoundary",
+    "namespace": "core.geom.query.contour",
+    "summary": "Test whether a point lies on a contour's boundary (any of its curves).",
+    "examplePrompts": [],
+    "argsType": "ContourHandle",
+    "resultType": "boolean"
+  },
+  {
+    "path": "core.geom.query.contour.isOrientationValid",
+    "namespace": "core.geom.query.contour",
+    "summary": "Test whether a contour's orientation is valid (outer profile and holes are wound consistently).",
+    "examplePrompts": [],
+    "argsType": "ContourHandle",
+    "resultType": "boolean"
+  },
+  {
+    "path": "core.geom.query.contour.isPlanar",
+    "namespace": "core.geom.query.contour",
+    "summary": "Test whether a contour is planar.",
+    "examplePrompts": [],
+    "argsType": "ContourHandle",
+    "resultType": "boolean"
+  },
+  {
+    "path": "core.geom.query.contour.isSelfIntersecting",
+    "namespace": "core.geom.query.contour",
+    "summary": "Test whether a contour intersects itself.",
+    "examplePrompts": [],
+    "argsType": "ContourHandle",
+    "resultType": "boolean"
+  },
+  {
+    "path": "core.geom.query.contour.listHoles",
+    "namespace": "core.geom.query.contour",
+    "summary": "List the inner profiles (holes) of a contour. Host API call — mints fresh handles.",
+    "examplePrompts": [],
+    "argsType": "ContourHandle",
+    "resultType": "ProfileHandle[]"
+  },
+  {
+    "path": "core.geom.query.curve.getChordLength",
+    "namespace": "core.geom.query.curve",
+    "summary": "Get the straight-line chord length between a curve's endpoints.",
+    "examplePrompts": [],
+    "argsType": "CurveHandle",
+    "resultType": "number"
+  },
+  {
+    "path": "core.geom.query.curve.getCommonPart",
+    "namespace": "core.geom.query.curve",
+    "summary": "Get the common (overlapping) part of two curves.",
+    "examplePrompts": [],
+    "argsType": "CurveHandle",
+    "resultType": "CurveHandle | null"
+  },
+  {
+    "path": "core.geom.query.curve.getCurvature",
+    "namespace": "core.geom.query.curve",
+    "summary": "Get the curvature of a curve at a point on it.",
+    "examplePrompts": [],
+    "argsType": "CurveHandle",
+    "resultType": "number"
+  },
+  {
+    "path": "core.geom.query.curve.getDistanceAlong",
+    "namespace": "core.geom.query.curve",
+    "summary": "Get the arc-length distance along a curve between two points on it.",
+    "examplePrompts": [],
+    "argsType": "CurveHandle",
+    "resultType": "number"
+  },
+  {
+    "path": "core.geom.query.curve.getDistanceBetween",
+    "namespace": "core.geom.query.curve",
+    "summary": "Get the perpendicular distance between two parallel lines.",
+    "examplePrompts": [],
+    "argsType": "LineHandle",
+    "resultType": "number"
+  },
+  {
+    "path": "core.geom.query.curve.getDistanceToPoint",
+    "namespace": "core.geom.query.curve",
+    "summary": "Get the shortest distance from an arbitrary point to a curve.",
+    "examplePrompts": [],
+    "argsType": "CurveHandle",
+    "resultType": "number"
+  },
+  {
+    "path": "core.geom.query.curve.getEndPoint",
+    "namespace": "core.geom.query.curve",
+    "summary": "Get the end point of a curve.",
+    "examplePrompts": [],
+    "argsType": "CurveHandle",
+    "resultType": "Vec3Components"
+  },
+  {
+    "path": "core.geom.query.curve.getLength",
+    "namespace": "core.geom.query.curve",
+    "summary": "Get the arc-length of a curve.",
+    "examplePrompts": [],
+    "argsType": "CurveHandle",
+    "resultType": "number"
+  },
+  {
+    "path": "core.geom.query.curve.getMergedCurve",
+    "namespace": "core.geom.query.curve",
+    "summary": "Merge two curves into a single curve when they are mergeable.",
+    "examplePrompts": [],
+    "argsType": "CurveHandle",
+    "resultType": "CurveHandle | null"
+  },
+  {
+    "path": "core.geom.query.curve.getMidPoint",
+    "namespace": "core.geom.query.curve",
+    "summary": "Get the mid point of a curve.",
+    "examplePrompts": [],
+    "argsType": "CurveHandle",
+    "resultType": "Vec3Components"
+  },
+  {
+    "path": "core.geom.query.curve.getNearestPoint",
+    "namespace": "core.geom.query.curve",
+    "summary": "Get the point on a curve nearest to an arbitrary point.",
+    "examplePrompts": [],
+    "argsType": "CurveHandle",
+    "resultType": "Vec3Components"
+  },
+  {
+    "path": "core.geom.query.curve.getNormal",
+    "namespace": "core.geom.query.curve",
+    "summary": "Get the unit normal vector of a curve at a point on it.",
+    "examplePrompts": [],
+    "argsType": "CurveHandle",
+    "resultType": "Vec3Components"
+  },
+  {
+    "path": "core.geom.query.curve.getParameterAtPoint",
+    "namespace": "core.geom.query.curve",
+    "summary": "Get the curve parameter corresponding to a point on the curve.",
+    "examplePrompts": [],
+    "argsType": "CurveHandle",
+    "resultType": "number"
+  },
+  {
+    "path": "core.geom.query.curve.getPointAtDistance",
+    "namespace": "core.geom.query.curve",
+    "summary": "Get the point at a given distance along a curve from a reference point.",
+    "examplePrompts": [],
+    "argsType": "CurveHandle",
+    "resultType": "Vec3Components"
+  },
+  {
+    "path": "core.geom.query.curve.getProjection",
+    "namespace": "core.geom.query.curve",
+    "summary": "Project a point onto a curve.",
+    "examplePrompts": [],
+    "argsType": "CurveHandle",
+    "resultType": "Vec3Components"
+  },
+  {
+    "path": "core.geom.query.curve.getShortestGap",
+    "namespace": "core.geom.query.curve",
+    "summary": "Get the shortest gap between two curves, optionally including their endpoints.",
+    "examplePrompts": [],
+    "argsType": "CurveHandle",
+    "resultType": "number"
+  },
+  {
+    "path": "core.geom.query.curve.getStartPoint",
+    "namespace": "core.geom.query.curve",
+    "summary": "Get the start point of a curve.",
+    "examplePrompts": [],
+    "argsType": "CurveHandle",
+    "resultType": "Vec3Components"
+  },
+  {
+    "path": "core.geom.query.curve.getTangent",
+    "namespace": "core.geom.query.curve",
+    "summary": "Get the unit tangent vector of a curve at a point on it.",
+    "examplePrompts": [],
+    "argsType": "CurveHandle",
+    "resultType": "Vec3Components"
+  },
+  {
+    "path": "core.geom.query.curve.hasPoint",
+    "namespace": "core.geom.query.curve",
+    "summary": "Test whether a curve contains a point, optionally including its endpoints.",
+    "examplePrompts": [],
+    "argsType": "CurveHandle",
+    "resultType": "boolean"
+  },
+  {
+    "path": "core.geom.query.curve.isContinuous",
+    "namespace": "core.geom.query.curve",
+    "summary": "Test whether two curves are continuous (share an endpoint without a gap).",
+    "examplePrompts": [],
+    "argsType": "CurveHandle",
+    "resultType": "boolean"
+  },
+  {
+    "path": "core.geom.query.curve.isEqual",
+    "namespace": "core.geom.query.curve",
+    "summary": "Test whether two curves are geometrically equal.",
+    "examplePrompts": [],
+    "argsType": "CurveHandle",
+    "resultType": "boolean"
+  },
+  {
+    "path": "core.geom.query.curve.isLinear",
+    "namespace": "core.geom.query.curve",
+    "summary": "Test whether a curve is a straight line.",
+    "examplePrompts": [],
+    "argsType": "CurveHandle",
+    "resultType": "boolean"
+  },
+  {
+    "path": "core.geom.query.curve.isOnCurve",
+    "namespace": "core.geom.query.curve",
+    "summary": "Test whether a point lies on a curve within an optional threshold.",
+    "examplePrompts": [],
+    "argsType": "CurveHandle",
+    "resultType": "boolean"
+  },
+  {
+    "path": "core.geom.query.curve.isOverlapping",
+    "namespace": "core.geom.query.curve",
+    "summary": "Test whether two curves overlap (share a collinear/concentric span), optionally including their endpoints.",
+    "examplePrompts": [],
+    "argsType": "CurveHandle",
+    "resultType": "boolean"
+  },
+  {
+    "path": "core.geom.query.curve.isParallel",
+    "namespace": "core.geom.query.curve",
+    "summary": "Test whether two lines are parallel within an optional tolerance.",
+    "examplePrompts": [],
+    "argsType": "LineHandle",
+    "resultType": "boolean"
+  },
+  {
+    "path": "core.geom.query.curve.listIntersections",
+    "namespace": "core.geom.query.curve",
+    "summary": "List the intersection points between two curves.",
+    "examplePrompts": [],
+    "argsType": "CurveHandle",
+    "resultType": "Vec3Components[]"
+  },
+  {
+    "path": "core.geom.query.curve.listPoints",
+    "namespace": "core.geom.query.curve",
+    "summary": "List sampled points along a curve.",
+    "examplePrompts": [],
+    "argsType": "CurveHandle",
+    "resultType": "Vec3Components[]"
+  },
+  {
+    "path": "core.geom.query.curve.listSubdivisions",
+    "namespace": "core.geom.query.curve",
+    "summary": "List the points produced by subdividing a curve into equal segments.",
+    "examplePrompts": [],
+    "argsType": "CurveHandle",
+    "resultType": "Vec3Components[]"
+  },
+  {
+    "path": "core.geom.query.edge.getCurve",
+    "namespace": "core.geom.query.edge",
+    "summary": "Get the underlying curve geometry of an edge (a line or arc).",
+    "examplePrompts": [],
+    "argsType": "EdgeHandle",
+    "resultType": "CurveHandle | null"
+  },
+  {
+    "path": "core.geom.query.edge.getHalfEdge",
+    "namespace": "core.geom.query.edge",
+    "summary": "Get the primary half-edge of an edge.",
+    "examplePrompts": [],
+    "argsType": "EdgeHandle",
+    "resultType": "HalfEdgeHandle | null"
+  },
+  {
+    "path": "core.geom.query.edge.getIndex",
+    "namespace": "core.geom.query.edge",
+    "summary": "Get the index of an edge within its brep.",
+    "examplePrompts": [],
+    "argsType": "EdgeHandle",
+    "resultType": "number"
+  },
+  {
+    "path": "core.geom.query.edge.listFaces",
+    "namespace": "core.geom.query.edge",
+    "summary": "List the faces bordering an edge (one or two).",
+    "examplePrompts": [],
+    "argsType": "EdgeHandle",
+    "resultType": "FaceHandle[]"
+  },
+  {
+    "path": "core.geom.query.edge.listVertices",
+    "namespace": "core.geom.query.edge",
+    "summary": "List the two endpoint vertices of an edge.",
+    "examplePrompts": [],
+    "argsType": "EdgeHandle",
+    "resultType": "VertexHandle[]"
+  },
+  {
+    "path": "core.geom.query.face.getHalfEdge",
+    "namespace": "core.geom.query.face",
+    "summary": "Get a seed half-edge of a face's outer loop.",
+    "examplePrompts": [],
+    "argsType": "FaceHandle",
+    "resultType": "HalfEdgeHandle | null"
+  },
+  {
+    "path": "core.geom.query.face.getHoleContainingHalfEdge",
+    "namespace": "core.geom.query.face",
+    "summary": "Get the seed half-edge of the hole loop containing a given half-edge.",
+    "examplePrompts": [],
+    "argsType": "FaceHandle",
+    "resultType": "HalfEdgeHandle | null"
+  },
+  {
+    "path": "core.geom.query.face.getHoleCount",
+    "namespace": "core.geom.query.face",
+    "summary": "Get the number of holes in a face.",
+    "examplePrompts": [],
+    "argsType": "FaceHandle",
+    "resultType": "number"
+  },
+  {
+    "path": "core.geom.query.face.getIndex",
+    "namespace": "core.geom.query.face",
+    "summary": "Get the index of a face within its brep.",
+    "examplePrompts": [],
+    "argsType": "FaceHandle",
+    "resultType": "number"
+  },
+  {
+    "path": "core.geom.query.face.getMaterialIndex",
+    "namespace": "core.geom.query.face",
+    "summary": "Get the raw (unmapped) material index of a face.",
+    "examplePrompts": [],
+    "argsType": "FaceHandle",
+    "resultType": "number"
+  },
+  {
+    "path": "core.geom.query.face.hasHoles",
+    "namespace": "core.geom.query.face",
+    "summary": "Test whether a face has any holes.",
+    "examplePrompts": [],
+    "argsType": "FaceHandle",
+    "resultType": "boolean"
+  },
+  {
+    "path": "core.geom.query.face.listAdjacentFaces",
+    "namespace": "core.geom.query.face",
+    "summary": "List the faces adjacent to a face (sharing an edge). Boundary edges are skipped.",
+    "examplePrompts": [],
+    "argsType": "FaceHandle",
+    "resultType": "FaceHandle[]"
+  },
+  {
+    "path": "core.geom.query.face.listEdges",
+    "namespace": "core.geom.query.face",
+    "summary": "List the edges of a face's outer loop.",
+    "examplePrompts": [],
+    "argsType": "FaceHandle",
+    "resultType": "EdgeHandle[]"
+  },
+  {
+    "path": "core.geom.query.face.listHalfEdges",
+    "namespace": "core.geom.query.face",
+    "summary": "List the half-edges of a face's outer loop.",
+    "examplePrompts": [],
+    "argsType": "FaceHandle",
+    "resultType": "HalfEdgeHandle[]"
+  },
+  {
+    "path": "core.geom.query.face.listHoleHalfEdges",
+    "namespace": "core.geom.query.face",
+    "summary": "List the half-edge loop of one hole of a face (by hole index).",
+    "examplePrompts": [],
+    "argsType": "FaceHandle",
+    "resultType": "HalfEdgeHandle[]"
+  },
+  {
+    "path": "core.geom.query.face.listHoles",
+    "namespace": "core.geom.query.face",
+    "summary": "List a face's holes as one seed half-edge per hole loop.",
+    "examplePrompts": [],
+    "argsType": "FaceHandle",
+    "resultType": "HalfEdgeHandle[]"
+  },
+  {
+    "path": "core.geom.query.face.listVertexPositions",
+    "namespace": "core.geom.query.face",
+    "summary": "List the positions of a face's outer-loop vertices (needs the parent brep for coordinates).",
+    "examplePrompts": [],
+    "argsType": "FaceHandle",
+    "resultType": "Vec3Components[]"
+  },
+  {
+    "path": "core.geom.query.face.listVertexPositionsWithCurves",
+    "namespace": "core.geom.query.face",
+    "summary": "List the tessellated boundary points of a face's outer loop (arcs sampled, sense-corrected). Not cardinality-equal to {@linkcode PluginGeomQueryFaceApi.listVertexPositions}.",
+    "examplePrompts": [],
+    "argsType": "FaceHandle",
+    "resultType": "Vec3Components[]"
+  },
+  {
+    "path": "core.geom.query.face.listVertices",
+    "namespace": "core.geom.query.face",
+    "summary": "List the vertices of a face's outer loop.",
+    "examplePrompts": [],
+    "argsType": "FaceHandle",
+    "resultType": "VertexHandle[]"
+  },
+  {
+    "path": "core.geom.query.halfedge.getEdge",
+    "namespace": "core.geom.query.halfedge",
+    "summary": "Get the edge of a half-edge.",
+    "examplePrompts": [],
+    "argsType": "HalfEdgeHandle",
+    "resultType": "EdgeHandle"
+  },
+  {
+    "path": "core.geom.query.halfedge.getFace",
+    "namespace": "core.geom.query.halfedge",
+    "summary": "Get the face of a half-edge.",
+    "examplePrompts": [],
+    "argsType": "HalfEdgeHandle",
+    "resultType": "FaceHandle"
+  },
+  {
+    "path": "core.geom.query.halfedge.getFlip",
+    "namespace": "core.geom.query.halfedge",
+    "summary": "Get the flip (opposite) half-edge of the shared edge.",
+    "examplePrompts": [],
+    "argsType": "HalfEdgeHandle",
+    "resultType": "HalfEdgeHandle | null"
+  },
+  {
+    "path": "core.geom.query.halfedge.getNext",
+    "namespace": "core.geom.query.halfedge",
+    "summary": "Get the next half-edge around the face loop.",
+    "examplePrompts": [],
+    "argsType": "HalfEdgeHandle",
+    "resultType": "HalfEdgeHandle | null"
+  },
+  {
+    "path": "core.geom.query.halfedge.getPrev",
+    "namespace": "core.geom.query.halfedge",
+    "summary": "Get the previous half-edge around the face loop.",
+    "examplePrompts": [],
+    "argsType": "HalfEdgeHandle",
+    "resultType": "HalfEdgeHandle | null"
+  },
+  {
+    "path": "core.geom.query.halfedge.getVertex",
+    "namespace": "core.geom.query.halfedge",
+    "summary": "Get the tail vertex of a half-edge.",
+    "examplePrompts": [],
+    "argsType": "HalfEdgeHandle",
+    "resultType": "VertexHandle"
+  },
+  {
+    "path": "core.geom.query.halfedge.isForward",
+    "namespace": "core.geom.query.halfedge",
+    "summary": "Test whether a half-edge is the forward (primary) half-edge of its edge — i.e. `edge.getHalfEdge() === thisHalfEdge`.",
+    "examplePrompts": [],
+    "argsType": "HalfEdgeHandle",
+    "resultType": "boolean"
+  },
+  {
+    "path": "core.geom.query.halfedge.isOnBoundary",
+    "namespace": "core.geom.query.halfedge",
+    "summary": "Test whether a half-edge lies on the brep boundary (has no flip).",
+    "examplePrompts": [],
+    "argsType": "HalfEdgeHandle",
+    "resultType": "boolean"
+  },
+  {
+    "path": "core.geom.query.profile.getArea",
+    "namespace": "core.geom.query.profile",
+    "summary": "Get the (approximate) enclosed area of a profile.",
+    "examplePrompts": [],
+    "argsType": "ProfileHandle",
+    "resultType": "number"
+  },
+  {
+    "path": "core.geom.query.profile.getBoundingBox",
+    "namespace": "core.geom.query.profile",
+    "summary": "Get the axis-aligned bounding box of a profile.",
+    "examplePrompts": [],
+    "argsType": "ProfileHandle",
+    "resultType": "BBoxComponents"
+  },
+  {
+    "path": "core.geom.query.profile.getNearestPoint",
+    "namespace": "core.geom.query.profile",
+    "summary": "Get the point on a profile nearest to an arbitrary point.",
+    "examplePrompts": [],
+    "argsType": "ProfileHandle",
+    "resultType": "Vec3Components"
+  },
+  {
+    "path": "core.geom.query.profile.getNormal",
+    "namespace": "core.geom.query.profile",
+    "summary": "Get the unit normal vector of a profile's plane.",
+    "examplePrompts": [],
+    "argsType": "ProfileHandle",
+    "resultType": "Vec3Components | null"
+  },
+  {
+    "path": "core.geom.query.profile.getPerimeter",
+    "namespace": "core.geom.query.profile",
+    "summary": "Get the perimeter (total curve length) of a profile.",
+    "examplePrompts": [],
+    "argsType": "ProfileHandle",
+    "resultType": "number"
+  },
+  {
+    "path": "core.geom.query.profile.hasPoint",
+    "namespace": "core.geom.query.profile",
+    "summary": "Test whether a point lies inside a profile.",
+    "examplePrompts": [],
+    "argsType": "ProfileHandle",
+    "resultType": "boolean"
+  },
+  {
+    "path": "core.geom.query.profile.isClockwise",
+    "namespace": "core.geom.query.profile",
+    "summary": "Test whether a profile is wound clockwise on the XZ plane.",
+    "examplePrompts": [],
+    "argsType": "ProfileHandle",
+    "resultType": "boolean"
+  },
+  {
+    "path": "core.geom.query.profile.isClosed",
+    "namespace": "core.geom.query.profile",
+    "summary": "Test whether a profile forms a closed loop.",
+    "examplePrompts": [],
+    "argsType": "ProfileHandle",
+    "resultType": "boolean"
+  },
+  {
+    "path": "core.geom.query.profile.isEmpty",
+    "namespace": "core.geom.query.profile",
+    "summary": "Test whether a profile contains no curves.",
+    "examplePrompts": [],
+    "argsType": "ProfileHandle",
+    "resultType": "boolean"
+  },
+  {
+    "path": "core.geom.query.profile.isEqual",
+    "namespace": "core.geom.query.profile",
+    "summary": "Test whether two profiles are geometrically equal.",
+    "examplePrompts": [],
+    "argsType": "ProfileHandle",
+    "resultType": "boolean"
+  },
+  {
+    "path": "core.geom.query.profile.isOnBoundary",
+    "namespace": "core.geom.query.profile",
+    "summary": "Test whether a point lies on a profile's boundary.",
+    "examplePrompts": [],
+    "argsType": "ProfileHandle",
+    "resultType": "boolean"
+  },
+  {
+    "path": "core.geom.query.profile.isPlanar",
+    "namespace": "core.geom.query.profile",
+    "summary": "Test whether a profile is planar.",
+    "examplePrompts": [],
+    "argsType": "ProfileHandle",
+    "resultType": "boolean"
+  },
+  {
+    "path": "core.geom.query.profile.isSelfIntersecting",
+    "namespace": "core.geom.query.profile",
+    "summary": "Test whether a profile intersects itself.",
+    "examplePrompts": [],
+    "argsType": "ProfileHandle",
+    "resultType": "boolean"
+  },
+  {
+    "path": "core.geom.query.profile.listCurves",
+    "namespace": "core.geom.query.profile",
+    "summary": "List the curves that make up a profile. Host API call — mints fresh handles.",
+    "examplePrompts": [],
+    "argsType": "ProfileHandle",
+    "resultType": "CurveHandle[]"
+  },
+  {
+    "path": "core.geom.query.profile.listPoints",
+    "namespace": "core.geom.query.profile",
+    "summary": "List the tessellated points along a profile.",
+    "examplePrompts": [],
+    "argsType": "ProfileHandle",
+    "resultType": "Vec3Components[]"
+  },
+  {
+    "path": "core.geom.query.vertex.getHalfEdge",
+    "namespace": "core.geom.query.vertex",
+    "summary": "Get a seed half-edge emanating from a vertex.",
+    "examplePrompts": [],
+    "argsType": "VertexHandle",
+    "resultType": "HalfEdgeHandle | null"
+  },
+  {
+    "path": "core.geom.query.vertex.getIndex",
+    "namespace": "core.geom.query.vertex",
+    "summary": "Get the index of a vertex within its brep.",
+    "examplePrompts": [],
+    "argsType": "VertexHandle",
+    "resultType": "number"
+  },
+  {
+    "path": "core.geom.query.vertex.getPosition",
+    "namespace": "core.geom.query.vertex",
+    "summary": "Get the position of a vertex (needs the parent brep for coordinates).",
+    "examplePrompts": [],
+    "argsType": "BrepHandle",
+    "resultType": "Vec3Components"
+  },
+  {
+    "path": "core.geom.query.vertex.listEdges",
+    "namespace": "core.geom.query.vertex",
+    "summary": "List the edges around a vertex.",
+    "examplePrompts": [],
+    "argsType": "VertexHandle",
+    "resultType": "EdgeHandle[]"
+  },
+  {
+    "path": "core.geom.query.vertex.listFaces",
+    "namespace": "core.geom.query.vertex",
+    "summary": "List the faces around a vertex.",
+    "examplePrompts": [],
+    "argsType": "VertexHandle",
+    "resultType": "FaceHandle[]"
+  },
+  {
+    "path": "core.geom.query.vertex.listHalfEdges",
+    "namespace": "core.geom.query.vertex",
+    "summary": "List the half-edges around a vertex.",
+    "examplePrompts": [],
+    "argsType": "VertexHandle",
+    "resultType": "HalfEdgeHandle[]"
+  },
+  {
+    "path": "core.geom.query.vertex.listNeighbors",
+    "namespace": "core.geom.query.vertex",
+    "summary": "List the neighbouring vertices of a vertex.",
+    "examplePrompts": [],
+    "argsType": "VertexHandle",
+    "resultType": "VertexHandle[]"
+  },
+  {
+    "path": "core.geom.update.contour.addHole",
+    "namespace": "core.geom.update.contour",
+    "summary": "Add a hole to a contour by appending an inner profile. Immutable — returns a NEW contour and leaves the input unchanged.",
+    "examplePrompts": [],
+    "argsType": "ContourHandle",
+    "resultType": "ContourHandle"
+  },
+  {
+    "path": "core.geom.update.contour.mirror",
+    "namespace": "core.geom.update.contour",
+    "summary": "Mirror a contour across a plane. Immutable — returns a NEW contour and leaves the input unchanged.",
+    "examplePrompts": [],
+    "argsType": "ContourHandle",
+    "resultType": "ContourHandle"
+  },
+  {
+    "path": "core.geom.update.contour.move",
+    "namespace": "core.geom.update.contour",
+    "summary": "Translate a contour by a vector. Immutable — returns a NEW contour and leaves the input unchanged.",
+    "examplePrompts": [],
+    "argsType": "ContourHandle",
+    "resultType": "ContourHandle"
+  },
+  {
+    "path": "core.geom.update.contour.offset",
+    "namespace": "core.geom.update.contour",
+    "summary": "Offset a contour inward/outward by a signed distance. Immutable — returns a NEW contour and leaves the input unchanged.",
+    "examplePrompts": [],
+    "argsType": "ContourHandle",
+    "resultType": "ContourHandle"
+  },
+  {
+    "path": "core.geom.update.contour.removeHole",
+    "namespace": "core.geom.update.contour",
+    "summary": "Remove a hole from a contour by inner-profile index. Immutable — returns a NEW contour and leaves the input unchanged.",
+    "examplePrompts": [],
+    "argsType": "ContourHandle",
+    "resultType": "ContourHandle"
+  },
+  {
+    "path": "core.geom.update.contour.rotate",
+    "namespace": "core.geom.update.contour",
+    "summary": "Rotate a contour about an axis through an optional pivot. Immutable — returns a NEW contour and leaves the input unchanged.",
+    "examplePrompts": [],
+    "argsType": "ContourHandle",
+    "resultType": "ContourHandle"
+  },
+  {
+    "path": "core.geom.update.contour.scale",
+    "namespace": "core.geom.update.contour",
+    "summary": "Scale a contour uniformly or per-axis about an optional pivot. Immutable — returns a NEW contour and leaves the input unchanged.",
+    "examplePrompts": [],
+    "argsType": "ContourHandle",
+    "resultType": "ContourHandle"
+  },
+  {
+    "path": "core.geom.update.curve.extend",
+    "namespace": "core.geom.update.curve",
+    "summary": "Extend a curve by a distance from one of its ends. Host API call — returns a handle.",
+    "examplePrompts": [],
+    "argsType": "CurveHandle",
+    "resultType": "CurveHandle"
+  },
+  {
+    "path": "core.geom.update.curve.offset",
+    "namespace": "core.geom.update.curve",
+    "summary": "Offset a curve by a translation vector. Host API call — returns a handle.",
+    "examplePrompts": [],
+    "argsType": "CurveHandle",
+    "resultType": "CurveHandle"
+  },
+  {
+    "path": "core.geom.update.curve.reverse",
+    "namespace": "core.geom.update.curve",
+    "summary": "Reverse the direction of a curve. Host API call — returns a handle.",
+    "examplePrompts": [],
+    "argsType": "CurveHandle",
+    "resultType": "CurveHandle"
+  },
+  {
+    "path": "core.geom.update.curve.split",
+    "namespace": "core.geom.update.curve",
+    "summary": "Split a curve at a point into separate segments. Host API call — returns handles.",
+    "examplePrompts": [],
+    "argsType": "CurveHandle",
+    "resultType": "CurveHandle[]"
+  },
+  {
+    "path": "core.geom.update.curve.trim",
+    "namespace": "core.geom.update.curve",
+    "summary": "Trim a curve to the portion between two parameter values. Host API call — returns a handle.",
+    "examplePrompts": [],
+    "argsType": "CurveHandle",
+    "resultType": "CurveHandle"
+  },
+  {
+    "path": "core.geom.update.profile.add",
+    "namespace": "core.geom.update.profile",
+    "summary": "Append a curve to the start or end of a profile. The curve must connect to the chosen end. Immutable — returns a NEW profile and leaves the input unchanged.",
+    "examplePrompts": [],
+    "argsType": "ProfileHandle",
+    "resultType": "ProfileHandle"
+  },
+  {
+    "path": "core.geom.update.profile.mirror",
+    "namespace": "core.geom.update.profile",
+    "summary": "Mirror a profile across a plane. Immutable — returns a NEW profile and leaves the input unchanged.",
+    "examplePrompts": [],
+    "argsType": "ProfileHandle",
+    "resultType": "ProfileHandle"
+  },
+  {
+    "path": "core.geom.update.profile.move",
+    "namespace": "core.geom.update.profile",
+    "summary": "Translate a profile by a vector. Immutable — returns a NEW profile and leaves the input unchanged.",
+    "examplePrompts": [],
+    "argsType": "ProfileHandle",
+    "resultType": "ProfileHandle"
+  },
+  {
+    "path": "core.geom.update.profile.offset",
+    "namespace": "core.geom.update.profile",
+    "summary": "Offset a closed profile inward/outward by a signed distance. Immutable — returns a NEW profile and leaves the input unchanged.",
+    "examplePrompts": [],
+    "argsType": "ProfileHandle",
+    "resultType": "ProfileHandle"
+  },
+  {
+    "path": "core.geom.update.profile.remove",
+    "namespace": "core.geom.update.profile",
+    "summary": "Remove the curve at the start or end of a profile. Immutable — returns a NEW profile and leaves the input unchanged.",
+    "examplePrompts": [],
+    "argsType": "ProfileHandle",
+    "resultType": "ProfileHandle"
+  },
+  {
+    "path": "core.geom.update.profile.reverse",
+    "namespace": "core.geom.update.profile",
+    "summary": "Reverse the orientation of a profile. Immutable — returns a NEW profile and leaves the input unchanged.",
+    "examplePrompts": [],
+    "argsType": "ProfileHandle",
+    "resultType": "ProfileHandle"
+  },
+  {
+    "path": "core.geom.update.profile.rotate",
+    "namespace": "core.geom.update.profile",
+    "summary": "Rotate a profile about an axis through an optional pivot. Immutable — returns a NEW profile and leaves the input unchanged.",
+    "examplePrompts": [],
+    "argsType": "ProfileHandle",
+    "resultType": "ProfileHandle"
+  },
+  {
+    "path": "core.geom.update.profile.scale",
+    "namespace": "core.geom.update.profile",
+    "summary": "Scale a profile uniformly or per-axis about an optional pivot. Immutable — returns a NEW profile and leaves the input unchanged.",
+    "examplePrompts": [],
+    "argsType": "ProfileHandle",
+    "resultType": "ProfileHandle"
+  },
+  {
+    "path": "core.geom.update.profile.simplify",
+    "namespace": "core.geom.update.profile",
+    "summary": "Simplify a profile by merging collinear/redundant segments. Immutable — returns a NEW profile and leaves the input unchanged.",
+    "examplePrompts": [],
+    "argsType": "ProfileHandle",
+    "resultType": "ProfileHandle"
+  },
+  {
+    "path": "core.groups.create",
+    "namespace": "core.groups",
+    "summary": "Group components into a new group.",
+    "examplePrompts": [
+      "Group the selected components",
+      "Make a group called Kitchen from these elements",
+      "Bundle components cmp_1 and cmp_2 into a group\n\n# Example\n```ts\nconst { groupId } = await snaptrude.core.groups.create([\"cmp_1\", \"cmp_2\"], \"Kitchen\")\n```"
+    ],
+    "argsType": "ComponentHandle[]",
+    "resultType": "PluginCoreGroupsCreateResult"
+  },
+  {
+    "path": "core.groups.delete",
+    "namespace": "core.groups",
+    "summary": "Delete (dissolve) a group.",
+    "examplePrompts": [
+      "Ungroup group-12",
+      "Dissolve this group but keep its contents",
+      "Delete the group without deleting its members\n\n# Example\n```ts\nawait snaptrude.core.groups.delete(\"group-12\")\n```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginCoreGroupsDeleteResult"
+  },
+  {
+    "path": "core.groups.get",
+    "namespace": "core.groups",
+    "summary": "Get a single group by id.",
+    "examplePrompts": [
+      "Get the group with id group-12",
+      "Look up a single group by its id",
+      "Is group-3 locked and how many members does it have?\n\n# Example\n```ts\nconst group = await snaptrude.core.groups.get(\"group-12\")\nif (group) console.log(group.name, group.memberCount)\n```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginCoreGroupsGetResult"
+  },
+  {
+    "path": "core.groups.getBounds",
+    "namespace": "core.groups",
+    "summary": "Get the axis-aligned bounds of a group.",
+    "examplePrompts": [
+      "How big is this group?",
+      "Get the bounding box of group-12",
+      "Where is the center of this group?\n\n# Example\n```ts\nconst bounds = await snaptrude.core.groups.getBounds(\"group-12\")\nif (bounds) console.log(bounds.center.x, bounds.center.y, bounds.center.z)\n```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginCoreGroupsGetBoundsResult"
+  },
+  {
+    "path": "core.groups.getForComponent",
+    "namespace": "core.groups",
+    "summary": "Get the group a component belongs to.",
+    "examplePrompts": [
+      "Which group is this wall in?",
+      "Find the group that contains component cmp_42",
+      "Is this element grouped, and if so which group?\n\n# Example\n```ts\nconst group = await snaptrude.core.groups.getForComponent(\"cmp_42\")\nconsole.log(group ? group.name : \"ungrouped\")\n```"
+    ],
+    "argsType": "ComponentHandle",
+    "resultType": "PluginCoreGroupsGetForComponentResult"
+  },
+  {
+    "path": "core.groups.isLocked",
+    "namespace": "core.groups",
+    "summary": "Report whether a group is locked.",
+    "examplePrompts": [
+      "Is group-12 locked?",
+      "Check whether this group is locked before editing it",
+      "Tell me if the group is locked\n\n# Example\n```ts\nif (await snaptrude.core.groups.isLocked(\"group-12\")) {\nconsole.log(\"locked — unlock it first\")\n}\n```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginCoreGroupsIsLockedResult"
+  },
+  {
+    "path": "core.groups.list",
+    "namespace": "core.groups",
+    "summary": "List every group in the active project.",
+    "examplePrompts": [
+      "List all the groups in my project",
+      "What groups do I have and how many things are in each?",
+      "Show every group with its lock state",
+      "How many groups are in this model?\n\n# Example\n```ts\nconst { groups } = await snaptrude.core.groups.list()\nfor (const g of groups) console.log(g.name, g.memberCount, g.isLocked)\n```"
+    ],
+    "argsType": null,
+    "resultType": "PluginCoreGroupsListResult"
+  },
+  {
+    "path": "core.groups.listMembers",
+    "namespace": "core.groups",
+    "summary": "List the direct members of a group.",
+    "examplePrompts": [
+      "What's inside group-12?",
+      "List the members of this group",
+      "Show the components and subgroups in group-3\n\n# Example\n```ts\nconst { members } = await snaptrude.core.groups.listMembers(\"group-12\")\nfor (const m of members) console.log(m.type, m.id)\n```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginCoreGroupsListMembersResult"
+  },
+  {
+    "path": "core.groups.update",
+    "namespace": "core.groups",
+    "summary": "Update a group's name and/or membership.",
+    "examplePrompts": [
+      "Rename group-12 to Kitchen",
+      "Add these two walls to the group",
+      "Remove cmp_7 from group-3\n\n# Example\n```ts\nconst group = await snaptrude.core.groups.update(\"group-12\", {\nname: \"Kitchen\",\naddComponentIds: [\"cmp_9\"],\n})\n```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginCoreGroupsUpdateResult"
+  },
+  {
+    "path": "core.history.redo",
+    "namespace": "core.history",
+    "summary": "Step forward over previously undone entries. Symmetric with {@linkcode PluginHistoryApi.undo}.",
+    "examplePrompts": [],
+    "argsType": "number",
+    "resultType": "PluginHistoryStepResult"
+  },
+  {
+    "path": "core.history.undo",
+    "namespace": "core.history",
+    "summary": "Step back over committed history entries.",
+    "examplePrompts": [],
+    "argsType": "number",
+    "resultType": "PluginHistoryStepResult"
+  },
+  {
+    "path": "core.layers.get",
+    "namespace": "core.layers",
+    "summary": "Get a single drawing layer by id.",
+    "examplePrompts": [
+      "Get the drawing layer with id ly_5",
+      "Is layer ly_5 hidden or locked?",
+      "Look up a single drawing layer by its id\n\n# Example\n```ts\nconst layer = await snaptrude.core.layers.get(\"ly_5\")\nif (layer) console.log(layer.name, layer.hidden, layer.locked)\n```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginCoreLayersGetResult"
+  },
+  {
+    "path": "core.layers.getActive",
+    "namespace": "core.layers",
+    "summary": "Get the active drawing layer of a storey.",
+    "examplePrompts": [
+      "Which drawing layer is active on this storey?",
+      "Get the current layer on storey st_2",
+      "What layer am I drawing on?\n\n# Example\n```ts\nconst active = await snaptrude.core.layers.getActive(\"st_2\")\nif (active) console.log(active.name)\n```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginCoreLayersGetActiveResult"
+  },
+  {
+    "path": "core.layers.list",
+    "namespace": "core.layers",
+    "summary": "List the drawing layers of a storey.",
+    "examplePrompts": [
+      "List the drawing layers on this storey",
+      "Show all the PDF underlays on storey st_2",
+      "What CAD layers are on the ground floor?\n\n# Example\n```ts\nconst { layers } = await snaptrude.core.layers.list(\"st_2\")\nfor (const l of layers) console.log(l.name, l.layerType, l.hidden)\n```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginCoreLayersListResult"
+  },
+  {
+    "path": "core.layers.setActive",
+    "namespace": "core.layers",
+    "summary": "Make a drawing layer the active layer of its storey.",
+    "examplePrompts": [
+      "Draw on layer ly_5",
+      "Make this the active layer",
+      "Switch the active layer to the CAD underlay\n\n# Example\n```ts\nawait snaptrude.core.layers.setActive(\"ly_5\")\n```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginCoreLayersSetActiveResult"
+  },
+  {
+    "path": "core.layers.update",
+    "namespace": "core.layers",
+    "summary": "Update a drawing layer's visibility.",
+    "examplePrompts": [
+      "Hide the PDF underlay layer",
+      "Show the CAD layer again",
+      "Hide layer ly_5\n\n# Example\n```ts\nconst layer = await snaptrude.core.layers.update(\"ly_5\", true)\n```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginCoreLayersUpdateResult"
+  },
+  {
+    "path": "core.math.quat.components",
+    "namespace": "core.math.quat",
+    "summary": "Read the primitive `{ x, y, z, w }` components of a quaternion handle.",
+    "examplePrompts": [],
+    "argsType": "QuatHandle",
+    "resultType": "QuatComponents"
+  },
+  {
+    "path": "core.math.quat.conjugate",
+    "namespace": "core.math.quat",
+    "summary": "Conjugate.",
+    "examplePrompts": [],
+    "argsType": "QuatHandle",
+    "resultType": "QuatHandle"
+  },
+  {
+    "path": "core.math.quat.dot",
+    "namespace": "core.math.quat",
+    "summary": "Dot product.",
+    "examplePrompts": [],
+    "argsType": "QuatHandle",
+    "resultType": "number"
+  },
+  {
+    "path": "core.math.quat.equals",
+    "namespace": "core.math.quat",
+    "summary": "Exact component equality.",
+    "examplePrompts": [],
+    "argsType": "QuatHandle",
+    "resultType": "boolean"
+  },
+  {
+    "path": "core.math.quat.equalsApprox",
+    "namespace": "core.math.quat",
+    "summary": "Approximate equality within `epsilon` (default `1e-6`).",
+    "examplePrompts": [],
+    "argsType": "QuatHandle",
+    "resultType": "boolean"
+  },
+  {
+    "path": "core.math.quat.fromAxisAngle",
+    "namespace": "core.math.quat",
+    "summary": "Build from a rotation axis and angle (radians).",
+    "examplePrompts": [],
+    "argsType": "Vec3Handle",
+    "resultType": "QuatHandle"
+  },
+  {
+    "path": "core.math.quat.fromEuler",
+    "namespace": "core.math.quat",
+    "summary": "Build from Euler angles (radians).",
+    "examplePrompts": [],
+    "argsType": "number",
+    "resultType": "QuatHandle"
+  },
+  {
+    "path": "core.math.quat.identity",
+    "namespace": "core.math.quat",
+    "summary": "The identity rotation.",
+    "examplePrompts": [],
+    "argsType": null,
+    "resultType": "QuatHandle"
+  },
+  {
+    "path": "core.math.quat.inverse",
+    "namespace": "core.math.quat",
+    "summary": "Inverse rotation.",
+    "examplePrompts": [],
+    "argsType": "QuatHandle",
+    "resultType": "QuatHandle"
+  },
+  {
+    "path": "core.math.quat.length",
+    "namespace": "core.math.quat",
+    "summary": "Magnitude.",
+    "examplePrompts": [],
+    "argsType": "QuatHandle",
+    "resultType": "number"
+  },
+  {
+    "path": "core.math.quat.multiply",
+    "namespace": "core.math.quat",
+    "summary": "Hamilton product `a * b` (apply `b` then `a`).",
+    "examplePrompts": [],
+    "argsType": "QuatHandle",
+    "resultType": "QuatHandle"
+  },
+  {
+    "path": "core.math.quat.new",
+    "namespace": "core.math.quat",
+    "summary": "Create a quaternion from primitive components.",
+    "examplePrompts": [],
+    "argsType": "number",
+    "resultType": "QuatHandle"
+  },
+  {
+    "path": "core.math.quat.normalize",
+    "namespace": "core.math.quat",
+    "summary": "Unit quaternion.",
+    "examplePrompts": [],
+    "argsType": "QuatHandle",
+    "resultType": "QuatHandle"
+  },
+  {
+    "path": "core.math.quat.slerp",
+    "namespace": "core.math.quat",
+    "summary": "Spherical linear interpolation.",
+    "examplePrompts": [],
+    "argsType": "QuatHandle",
+    "resultType": "QuatHandle"
+  },
+  {
+    "path": "core.math.quat.toAxisAngle",
+    "namespace": "core.math.quat",
+    "summary": "Decompose into axis + angle.",
+    "examplePrompts": [],
+    "argsType": "QuatHandle",
+    "resultType": "{ axis: Vec3Handle; angle: number }"
+  },
+  {
+    "path": "core.math.vec3.add",
+    "namespace": "core.math.vec3",
+    "summary": "Component-wise sum `a + b`.",
+    "examplePrompts": [],
+    "argsType": "Vec3Handle",
+    "resultType": "Vec3Handle"
+  },
+  {
+    "path": "core.math.vec3.components",
+    "namespace": "core.math.vec3",
+    "summary": "Read the primitive `{ x, y, z }` components of a vector handle.",
+    "examplePrompts": [],
+    "argsType": "Vec3Handle",
+    "resultType": "Vec3Components"
+  },
+  {
+    "path": "core.math.vec3.cross",
+    "namespace": "core.math.vec3",
+    "summary": "Cross product `a × b`.",
+    "examplePrompts": [],
+    "argsType": "Vec3Handle",
+    "resultType": "Vec3Handle"
+  },
+  {
+    "path": "core.math.vec3.distance",
+    "namespace": "core.math.vec3",
+    "summary": "Euclidean distance between two points.",
+    "examplePrompts": [],
+    "argsType": "Vec3Handle",
+    "resultType": "number"
+  },
+  {
+    "path": "core.math.vec3.dot",
+    "namespace": "core.math.vec3",
+    "summary": "Dot product.",
+    "examplePrompts": [],
+    "argsType": "Vec3Handle",
+    "resultType": "number"
+  },
+  {
+    "path": "core.math.vec3.equals",
+    "namespace": "core.math.vec3",
+    "summary": "Exact component equality.",
+    "examplePrompts": [],
+    "argsType": "Vec3Handle",
+    "resultType": "boolean"
+  },
+  {
+    "path": "core.math.vec3.equalsApprox",
+    "namespace": "core.math.vec3",
+    "summary": "Approximate equality within `epsilon` (default `1e-6`).",
+    "examplePrompts": [],
+    "argsType": "Vec3Handle",
+    "resultType": "boolean"
+  },
+  {
+    "path": "core.math.vec3.length",
+    "namespace": "core.math.vec3",
+    "summary": "Euclidean length.",
+    "examplePrompts": [],
+    "argsType": "Vec3Handle",
+    "resultType": "number"
+  },
+  {
+    "path": "core.math.vec3.lengthSquared",
+    "namespace": "core.math.vec3",
+    "summary": "Squared length (avoids the sqrt).",
+    "examplePrompts": [],
+    "argsType": "Vec3Handle",
+    "resultType": "number"
+  },
+  {
+    "path": "core.math.vec3.lerp",
+    "namespace": "core.math.vec3",
+    "summary": "Linear interpolation `a + (b - a) * t`.",
+    "examplePrompts": [],
+    "argsType": "Vec3Handle",
+    "resultType": "Vec3Handle"
+  },
+  {
+    "path": "core.math.vec3.negate",
+    "namespace": "core.math.vec3",
+    "summary": "Negate (reverse direction).",
+    "examplePrompts": [],
+    "argsType": "Vec3Handle",
+    "resultType": "Vec3Handle"
+  },
+  {
+    "path": "core.math.vec3.new",
+    "namespace": "core.math.vec3",
+    "summary": "Create a vector from primitive components.",
+    "examplePrompts": [],
+    "argsType": "number",
+    "resultType": "Vec3Handle"
+  },
+  {
+    "path": "core.math.vec3.normalize",
+    "namespace": "core.math.vec3",
+    "summary": "Unit vector in the same direction (zero vector if length 0).",
+    "examplePrompts": [],
+    "argsType": "Vec3Handle",
+    "resultType": "Vec3Handle"
+  },
+  {
+    "path": "core.math.vec3.scale",
+    "namespace": "core.math.vec3",
+    "summary": "Scale `v` by a scalar.",
+    "examplePrompts": [],
+    "argsType": "Vec3Handle",
+    "resultType": "Vec3Handle"
+  },
+  {
+    "path": "core.math.vec3.subtract",
+    "namespace": "core.math.vec3",
+    "summary": "Component-wise difference `a - b`.",
+    "examplePrompts": [],
+    "argsType": "Vec3Handle",
+    "resultType": "Vec3Handle"
+  },
+  {
+    "path": "core.project.settings.getTolerance",
+    "namespace": "core.project.settings",
+    "summary": "Get the project tolerance as a numeric magnitude.",
+    "examplePrompts": [],
+    "argsType": null,
+    "resultType": "number"
+  },
+  {
+    "path": "core.project.settings.grid.disable",
+    "namespace": "core.project.settings.grid",
+    "summary": "Turn the grid off.",
+    "examplePrompts": [],
+    "argsType": null,
+    "resultType": "boolean"
+  },
+  {
+    "path": "core.project.settings.grid.enable",
+    "namespace": "core.project.settings.grid",
+    "summary": "Turn the grid on.",
+    "examplePrompts": [],
+    "argsType": null,
+    "resultType": "boolean"
+  },
+  {
+    "path": "core.project.settings.grid.getValue",
+    "namespace": "core.project.settings.grid",
+    "summary": "Get the grid cell value.",
+    "examplePrompts": [],
+    "argsType": null,
+    "resultType": "number"
+  },
+  {
+    "path": "core.project.settings.grid.setValue",
+    "namespace": "core.project.settings.grid",
+    "summary": "Set the grid cell value.",
+    "examplePrompts": [],
+    "argsType": "number",
+    "resultType": "boolean"
+  },
+  {
+    "path": "core.project.settings.setTolerance",
+    "namespace": "core.project.settings",
+    "summary": "Set the project tolerance. The value snaps to the **nearest allowed** per-unit precision option (tolerance is a discrete dropdown, not arbitrary).",
+    "examplePrompts": [],
+    "argsType": "number",
+    "resultType": "boolean"
+  },
+  {
+    "path": "core.project.settings.snaps.disableAngle",
+    "namespace": "core.project.settings.snaps",
+    "summary": "Turn angle snapping off.",
+    "examplePrompts": [],
+    "argsType": null,
+    "resultType": "boolean"
+  },
+  {
+    "path": "core.project.settings.snaps.disableDimension",
+    "namespace": "core.project.settings.snaps",
+    "summary": "Turn dimension snapping off.",
+    "examplePrompts": [],
+    "argsType": null,
+    "resultType": "boolean"
+  },
+  {
+    "path": "core.project.settings.snaps.disableMagnetic",
+    "namespace": "core.project.settings.snaps",
+    "summary": "Turn magnetic snapping off.",
+    "examplePrompts": [],
+    "argsType": null,
+    "resultType": "boolean"
+  },
+  {
+    "path": "core.project.settings.snaps.disableNormal",
+    "namespace": "core.project.settings.snaps",
+    "summary": "Turn normal (perpendicular) snapping off.",
+    "examplePrompts": [],
+    "argsType": null,
+    "resultType": "boolean"
+  },
+  {
+    "path": "core.project.settings.snaps.disableParallel",
+    "namespace": "core.project.settings.snaps",
+    "summary": "Turn parallel snapping off.",
+    "examplePrompts": [],
+    "argsType": null,
+    "resultType": "boolean"
+  },
+  {
+    "path": "core.project.settings.snaps.enableAngle",
+    "namespace": "core.project.settings.snaps",
+    "summary": "Turn angle snapping on.",
+    "examplePrompts": [],
+    "argsType": null,
+    "resultType": "boolean"
+  },
+  {
+    "path": "core.project.settings.snaps.enableDimension",
+    "namespace": "core.project.settings.snaps",
+    "summary": "Turn dimension snapping on.",
+    "examplePrompts": [],
+    "argsType": null,
+    "resultType": "boolean"
+  },
+  {
+    "path": "core.project.settings.snaps.enableMagnetic",
+    "namespace": "core.project.settings.snaps",
+    "summary": "Turn magnetic snapping on.",
+    "examplePrompts": [],
+    "argsType": null,
+    "resultType": "boolean"
+  },
+  {
+    "path": "core.project.settings.snaps.enableNormal",
+    "namespace": "core.project.settings.snaps",
+    "summary": "Turn normal (perpendicular) snapping on.",
+    "examplePrompts": [],
+    "argsType": null,
+    "resultType": "boolean"
+  },
+  {
+    "path": "core.project.settings.snaps.enableParallel",
+    "namespace": "core.project.settings.snaps",
+    "summary": "Turn parallel snapping on.",
+    "examplePrompts": [],
+    "argsType": null,
+    "resultType": "boolean"
+  },
+  {
+    "path": "core.project.settings.snaps.getAngle",
+    "namespace": "core.project.settings.snaps",
+    "summary": "Get the angle-snap threshold (degrees).",
+    "examplePrompts": [],
+    "argsType": null,
+    "resultType": "number"
+  },
+  {
+    "path": "core.project.settings.snaps.getDimension",
+    "namespace": "core.project.settings.snaps",
+    "summary": "Get the dimension-snap threshold.",
+    "examplePrompts": [],
+    "argsType": null,
+    "resultType": "number"
+  },
+  {
+    "path": "core.project.settings.snaps.setAngle",
+    "namespace": "core.project.settings.snaps",
+    "summary": "Set the angle-snap threshold (degrees).",
+    "examplePrompts": [],
+    "argsType": "number",
+    "resultType": "boolean"
+  },
+  {
+    "path": "core.project.settings.snaps.setDimension",
+    "namespace": "core.project.settings.snaps",
+    "summary": "Set the dimension-snap threshold.",
+    "examplePrompts": [],
+    "argsType": "number",
+    "resultType": "boolean"
+  },
+  {
+    "path": "core.tags.assign",
+    "namespace": "core.tags",
+    "summary": "Assign a tag to components, creating the category and tag if needed.",
+    "examplePrompts": [
+      "Tag the selected spaces as Retail in the Zone category",
+      "Tag these rooms High Priority, creating the tag if it doesn't exist",
+      "Put cmp_1 and cmp_2 in Zone / Retail\n\n# Example\n```ts\nconst { tagId, tagCreated, assigned } = await snaptrude.core.tags.assign(\n[\"cmp_1\", \"cmp_2\"],\n\"Zone\",\n\"Retail\",\n)\n```"
+    ],
+    "argsType": "ComponentHandle[]",
+    "resultType": "PluginCoreTagsAssignResult"
+  },
+  {
+    "path": "core.tags.create",
+    "namespace": "core.tags",
+    "summary": "Create a new tag in a category.",
+    "examplePrompts": [
+      "Add a tag called 2-hour to the Fire Rating category",
+      "Create a red High Priority tag in category cat_3",
+      "Make a new tag named Retail\n\n# Example\n```ts\nconst tag = await snaptrude.core.tags.create(\"cat_3\", \"Retail\", \"#b5e1dc\")\n```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginCoreTagsCreateResult"
+  },
+  {
+    "path": "core.tags.createCategory",
+    "namespace": "core.tags",
+    "summary": "Create a new tag category.",
+    "examplePrompts": [
+      "Create a tag category called Fire Rating",
+      "Add a new category named Zone",
+      "Make a category for occupancy type\n\n# Example\n```ts\nconst category = await snaptrude.core.tags.createCategory(\"Fire Rating\")\n```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginCoreTagsCreateCategoryResult"
+  },
+  {
+    "path": "core.tags.delete",
+    "namespace": "core.tags",
+    "summary": "Delete a tag.",
+    "examplePrompts": [
+      "Delete the Retail tag",
+      "Remove tag tag_9",
+      "Delete this label\n\n# Example\n```ts\nconst { resetComponentCount } = await snaptrude.core.tags.delete(\"tag_9\")\n```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginCoreTagsDeleteResult"
+  },
+  {
+    "path": "core.tags.deleteCategory",
+    "namespace": "core.tags",
+    "summary": "Delete a tag category and all its tags.",
+    "examplePrompts": [
+      "Delete the Zone tag category",
+      "Remove category cat_3 and all its tags",
+      "Delete this category\n\n# Example\n```ts\nconst { deletedTagCount } = await snaptrude.core.tags.deleteCategory(\"cat_3\")\n```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginCoreTagsDeleteCategoryResult"
+  },
+  {
+    "path": "core.tags.get",
+    "namespace": "core.tags",
+    "summary": "Get a single tag by id.",
+    "examplePrompts": [
+      "Get the tag with id tag_9",
+      "Look up a single tag by its id",
+      "What color is this tag?\n\n# Example\n```ts\nconst tag = await snaptrude.core.tags.get(\"tag_9\")\nif (tag) console.log(tag.name, tag.color)\n```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginCoreTagsGetResult"
+  },
+  {
+    "path": "core.tags.getCategory",
+    "namespace": "core.tags",
+    "summary": "Get a single tag category by id.",
+    "examplePrompts": [
+      "Get the tag category with id cat_3",
+      "Look up a category by its id",
+      "Which tags are in this category?\n\n# Example\n```ts\nconst category = await snaptrude.core.tags.getCategory(\"cat_3\")\nif (category) console.log(category.name, category.tagIds)\n```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginCoreTagsGetCategoryResult"
+  },
+  {
+    "path": "core.tags.getTagsForComponent",
+    "namespace": "core.tags",
+    "summary": "List the tags carried by a component.",
+    "examplePrompts": [
+      "What tags does this space have?",
+      "List the tags on component cmp_42",
+      "Show the labels applied to this room\n\n# Example\n```ts\nconst { tags } = await snaptrude.core.tags.getTagsForComponent(\"cmp_42\")\nfor (const t of tags) console.log(t.categoryName, t.tagName)\n```"
+    ],
+    "argsType": "ComponentHandle",
+    "resultType": "PluginCoreTagsGetTagsForComponentResult"
+  },
+  {
+    "path": "core.tags.list",
+    "namespace": "core.tags",
+    "summary": "List tags, optionally within one category.",
+    "examplePrompts": [
+      "List every tag in the project",
+      "Show the tags in category cat_3",
+      "What tags are available?\n\n# Example\n```ts\nconst { tags } = await snaptrude.core.tags.list(\"cat_3\")\nfor (const t of tags) console.log(t.name, t.color)\n```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginCoreTagsListResult"
+  },
+  {
+    "path": "core.tags.listCategories",
+    "namespace": "core.tags",
+    "summary": "List the tag categories.",
+    "examplePrompts": [
+      "List all the tag categories",
+      "What tag categories do I have?",
+      "Show every category and its tags\n\n# Example\n```ts\nconst { categories } = await snaptrude.core.tags.listCategories()\nfor (const c of categories) console.log(c.name, c.tagIds.length)\n```"
+    ],
+    "argsType": null,
+    "resultType": "PluginCoreTagsListCategoriesResult"
+  },
+  {
+    "path": "core.tags.listComponents",
+    "namespace": "core.tags",
+    "summary": "List the components carrying a given tag or category.",
+    "examplePrompts": [
+      "Which spaces have the tag tag_9?",
+      "List every component tagged in category cat_3",
+      "Which spaces are untagged in the Occupancy category?\n\n# Example\n```ts\nconst { componentIds } = await snaptrude.core.tags.listComponents({ tagId: \"tag_9\" })\nconsole.log(`${componentIds.length} components`)\n```"
+    ],
+    "argsType": "{ tagId?: string; categoryId?: string; untagged?: boolean }",
+    "resultType": "PluginCoreTagsListComponentsResult"
+  },
+  {
+    "path": "core.tags.unassign",
+    "namespace": "core.tags",
+    "summary": "Clear a category's tag from components.",
+    "examplePrompts": [
+      "Remove the Occupancy tag from the selected spaces",
+      "Clear category cat_3 on components cmp_1 and cmp_2",
+      "Untag these rooms in the Zone category\n\n# Example\n```ts\nawait snaptrude.core.tags.unassign(\"cat_3\", [\"cmp_1\", \"cmp_2\"])\n```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginCoreTagsUnassignResult"
+  },
+  {
+    "path": "core.tags.update",
+    "namespace": "core.tags",
+    "summary": "Update a tag's name and/or color.",
+    "examplePrompts": [
+      "Rename tag tag_9 to Retail",
+      "Change this tag's color to #ff8800",
+      "Recolor the High Priority tag\n\n# Example\n```ts\nconst tag = await snaptrude.core.tags.update(\"tag_9\", { name: \"Retail\" })\n```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginCoreTagsUpdateResult"
+  },
+  {
+    "path": "core.tags.updateCategory",
+    "namespace": "core.tags",
+    "summary": "Rename a tag category.",
+    "examplePrompts": [
+      "Rename category cat_3 to Occupancy",
+      "Change the name of this tag category",
+      "Update the Zone category's name\n\n# Example\n```ts\nconst category = await snaptrude.core.tags.updateCategory(\"cat_3\", \"Occupancy\")\n```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginCoreTagsUpdateCategoryResult"
+  },
+  {
+    "path": "core.units.convert",
+    "namespace": "core.units",
+    "summary": "Convert a value between two unit types.",
+    "examplePrompts": [],
+    "argsType": "number",
+    "resultType": "number"
+  },
+  {
+    "path": "core.units.getBabylonType",
+    "namespace": "core.units",
+    "summary": "The internal storage unit type all geometry is stored in (`\"babylon\"`).",
+    "examplePrompts": [],
+    "argsType": null,
+    "resultType": "PUnitType"
+  },
+  {
+    "path": "core.units.getType",
+    "namespace": "core.units",
+    "summary": "The current project's unit type. Paired with {@linkcode PluginUnitsApi.setType}.",
+    "examplePrompts": [],
+    "argsType": null,
+    "resultType": "PUnitType"
+  },
+  {
+    "path": "core.units.listTypes",
+    "namespace": "core.units",
+    "summary": "List the selectable real-world unit types (excludes the internal `babylon` storage type, which is read via {@linkcode PluginUnitsApi.getBabylonType}).",
+    "examplePrompts": [],
+    "argsType": null,
+    "resultType": "PUnitType[]"
+  },
+  {
+    "path": "core.units.setType",
+    "namespace": "core.units",
+    "summary": "Set the current project's unit type. Paired with {@linkcode PluginUnitsApi.getType}.",
+    "examplePrompts": [],
+    "argsType": "PUnitType",
+    "resultType": "boolean"
+  },
+  {
+    "path": "core.zoom.extents",
+    "namespace": "core.zoom",
+    "summary": "Zoom (fit) the camera to all geometry in the scene — the \"zoom extents\" action.",
+    "examplePrompts": [],
+    "argsType": null,
+    "resultType": "boolean"
+  },
+  {
+    "path": "core.zoom.selection",
+    "namespace": "core.zoom",
+    "summary": "Zoom (fit) the camera to the current selection.",
+    "examplePrompts": [],
+    "argsType": null,
+    "resultType": "boolean"
+  },
+  {
+    "path": "design.boolean.intersect",
+    "namespace": "design.boolean",
+    "summary": "Keep only the overlap of the inputs (`A ∩ B`). Order-independent. HARD constraint: **EXACTLY 2** components (schema `.length(2)`; the engine also throws `MoreThan2ComponentsForIntersect` on >2).",
+    "examplePrompts": [],
+    "argsType": "ComponentHandle[]",
+    "resultType": "BooleanOutcome"
+  },
+  {
+    "path": "design.boolean.subtract",
+    "namespace": "design.boolean",
+    "summary": "Subtract `tools` from `target` (`target − ⋃tools`). ORDER-SENSITIVE: the host seeds `[target, ...tools]`; index 0 is the arg brep, the rest are tool breps. `deleted` includes the target AND every tool; `created` is the remainder mass(es).",
+    "examplePrompts": [],
+    "argsType": "ComponentHandle",
+    "resultType": "BooleanOutcome"
+  },
+  {
+    "path": "design.boolean.union",
+    "namespace": "design.boolean",
+    "summary": "Fuse ≥2 components into a single mass (`A ∪ B ∪ …`). Order-independent.",
+    "examplePrompts": [],
+    "argsType": "ComponentHandle[]",
+    "resultType": "BooleanOutcome"
+  },
+  {
+    "path": "design.create.beam",
+    "namespace": "design.create",
+    "summary": "Create a **beam** by extruding a cross-section contour along `direction` by `length`.",
+    "examplePrompts": [],
+    "argsType": "ContourHandle",
+    "resultType": "ComponentHandle"
+  },
+  {
+    "path": "design.create.ceiling",
+    "namespace": "design.create",
+    "summary": "Create a **ceiling** by extruding a footprint contour by `thickness`, lifted `heightFromFloor` above the floor.",
+    "examplePrompts": [],
+    "argsType": "ContourHandle",
+    "resultType": "ComponentHandle"
+  },
+  {
+    "path": "design.create.column",
+    "namespace": "design.create",
+    "summary": "Create a **column** by extruding a cross-section contour upward by `height` from a base `position`.",
+    "examplePrompts": [],
+    "argsType": "Vec3Handle",
+    "resultType": "ComponentHandle"
+  },
+  {
+    "path": "design.create.copy",
+    "namespace": "design.create",
+    "summary": "**Copy** existing entities, offsetting each copy by `displacement * i` (i = 1…count), source positions preserved. Migrated from the removed `tools.copy`. In `\"instance\"` mode copies stay in the source's instance family where possible; `\"unique\"` makes independent geometry. The created copies become the active selection. Undoable.",
+    "examplePrompts": [],
+    "argsType": "ComponentHandle[]",
+    "resultType": "ComponentHandle[]"
+  },
+  {
+    "path": "design.create.floor",
+    "namespace": "design.create",
+    "summary": "Create a **floor** by extruding a footprint contour by `thickness` (extruded upward).",
+    "examplePrompts": [],
+    "argsType": "ContourHandle",
+    "resultType": "ComponentHandle"
+  },
+  {
+    "path": "design.create.furniture",
+    "namespace": "design.create",
+    "summary": "Place a **furniture** item from the project library at a world position.",
+    "examplePrompts": [],
+    "argsType": "string",
+    "resultType": "ComponentHandle"
+  },
+  {
+    "path": "design.create.mass",
+    "namespace": "design.create",
+    "summary": "Create a **mass** — a generic extruded prism (default `massType` \"Generic mass\"). Same footprint-extrude path as {@linkcode PluginDesignCreateApi.space}.",
+    "examplePrompts": [],
+    "argsType": "ContourHandle",
+    "resultType": "ComponentHandle"
+  },
+  {
+    "path": "design.create.referenceLines",
+    "namespace": "design.create",
+    "summary": "Create **reference lines** from a profile — one reference line per curve in the profile's ordered chain. Returns a handle per created line.",
+    "examplePrompts": [],
+    "argsType": "ProfileHandle",
+    "resultType": "ComponentHandle[]"
+  },
+  {
+    "path": "design.create.roof",
+    "namespace": "design.create",
+    "summary": "Create a **roof** by extruding a footprint contour by `thickness`. Created flat (extruded downward); pitch/slope is a separate post-creation edit.",
+    "examplePrompts": [],
+    "argsType": "ContourHandle",
+    "resultType": "ComponentHandle"
+  },
+  {
+    "path": "design.create.slab",
+    "namespace": "design.create",
+    "summary": "Create a **slab** by extruding a footprint contour by `thickness` (default direction: down).",
+    "examplePrompts": [],
+    "argsType": "ContourHandle",
+    "resultType": "ComponentHandle"
+  },
+  {
+    "path": "design.create.space",
+    "namespace": "design.create",
+    "summary": "Create a **space** (a room / mass) by extruding a footprint contour upward.",
+    "examplePrompts": [],
+    "argsType": "ContourHandle",
+    "resultType": "ComponentHandle"
+  },
+  {
+    "path": "design.create.spaces",
+    "namespace": "design.create",
+    "summary": "Create **many spaces** in one undoable operation (bulk plural of {@linkcode space}). Migrated from the removed `entity.space.bulkCreate`. Each item extrudes a contour footprint up `height`. Validate-all-or-throw; one command. For a rectangular (box) space, build the footprint with `core.geom.create.profileRect` → `contourFromProfile`, then pass it as an item.",
+    "examplePrompts": [],
+    "argsType": "PluginCreateSpaceItem[]",
+    "resultType": "ComponentHandle[]"
+  },
+  {
+    "path": "design.create.staircase",
+    "namespace": "design.create",
+    "summary": "Create a **staircase** from a parametric preset, placed at a point.",
+    "examplePrompts": [],
+    "argsType": "PluginStaircasePreset",
+    "resultType": "ComponentHandle"
+  },
+  {
+    "path": "design.create.walls",
+    "namespace": "design.create",
+    "summary": "Create a connected run of **walls** from a profile — one wall per curve in the profile's chain, with mitred corners at shared endpoints.",
+    "examplePrompts": [],
+    "argsType": "ProfileHandle",
+    "resultType": "ComponentHandle[]"
+  },
+  {
+    "path": "design.delete.entities",
+    "namespace": "design.delete",
+    "summary": "Delete one or more entities. Generic hard delete (backed by the same batched, undoable path as `entity.space.delete`). Cascade is opinionated by the engine: children are removed and linked-list neighbours are fixed up — not caller-tunable in v1. Undoable — commits as a **single** undo entry.",
+    "examplePrompts": [],
+    "argsType": "ComponentHandle[]",
+    "resultType": "PluginDesignChangeResult"
+  },
+  {
+    "path": "design.doors.getFamily",
+    "namespace": "design.doors",
+    "summary": "Get a door's family name (Revit/native).",
+    "examplePrompts": [],
+    "argsType": "ComponentHandle",
+    "resultType": "string | null"
+  },
+  {
+    "path": "design.doors.getHeight",
+    "namespace": "design.doors",
+    "summary": "Get a door's height.",
+    "examplePrompts": [],
+    "argsType": "ComponentHandle",
+    "resultType": "number | null"
+  },
+  {
+    "path": "design.doors.getSupportFloor",
+    "namespace": "design.doors",
+    "summary": "Get the floor a door is hosted on.",
+    "examplePrompts": [],
+    "argsType": "ComponentHandle",
+    "resultType": "ComponentHandle | null"
+  },
+  {
+    "path": "design.doors.getSwingDirection",
+    "namespace": "design.doors",
+    "summary": "Get a door's swing (hinge) handedness — derived from the mesh reflection state.",
+    "examplePrompts": [],
+    "argsType": "ComponentHandle",
+    "resultType": "\"left\" | \"right\" | null"
+  },
+  {
+    "path": "design.doors.getType",
+    "namespace": "design.doors",
+    "summary": "Get a door's type name.",
+    "examplePrompts": [],
+    "argsType": "ComponentHandle",
+    "resultType": "string | null"
+  },
+  {
+    "path": "design.doors.getWidth",
+    "namespace": "design.doors",
+    "summary": "Get a door's width.",
+    "examplePrompts": [],
+    "argsType": "ComponentHandle",
+    "resultType": "number | null"
+  },
+  {
+    "path": "design.doors.mirror",
+    "namespace": "design.doors",
+    "summary": "Mirror a door across an axis (reflect its swing). Undoable (one command).",
+    "examplePrompts": [],
+    "argsType": "ComponentHandle",
+    "resultType": "PluginDesignChangeResult"
+  },
+  {
+    "path": "design.doors.setHeight",
+    "namespace": "design.doors",
+    "summary": "Set the height of one or more doors (engine units; re-cuts the host wall). Undoable.",
+    "examplePrompts": [],
+    "argsType": "ComponentHandle[]",
+    "resultType": "PluginDesignChangeResult"
+  },
+  {
+    "path": "design.doors.setWidth",
+    "namespace": "design.doors",
+    "summary": "Set the width of one or more doors (engine units; re-cuts the host wall). Undoable.",
+    "examplePrompts": [],
+    "argsType": "ComponentHandle[]",
+    "resultType": "PluginDesignChangeResult"
+  },
+  {
+    "path": "design.edit.offsetSplit",
+    "namespace": "design.edit",
+    "summary": "Offset-and-split the top profile of one component. Positive = outward, negative = inward. Single-component only (the engine rejects batches).",
+    "examplePrompts": [],
+    "argsType": "ComponentHandle",
+    "resultType": "OffsetSplitOutcome"
+  },
+  {
+    "path": "design.erase.edge",
+    "namespace": "design.erase",
+    "summary": "Commit the erase for one edge. `DirectUnion` merges the two adjacent masses; `DirectDelete` drops the single mass behind the boundary edge. Single undo entry.",
+    "examplePrompts": [],
+    "argsType": "ErasableEdgeRef",
+    "resultType": "PluginDesignEraseEdgeResult"
+  },
+  {
+    "path": "design.erase.listErasableEdges",
+    "namespace": "design.erase",
+    "summary": "Enumerate every erasable edge in the current plan's bottom-adjacency graph (one {@linkcode ErasableEdgeRef} per edge). Pure read — no scene mutation, no command, not undoable. Erase-ineligible components (locked, hidden, off-storey) are filtered out.",
+    "examplePrompts": [],
+    "argsType": "PluginDesignListErasableEdgesArgs",
+    "resultType": "ErasableEdgeRef[]"
+  },
+  {
+    "path": "design.furniture.exists",
+    "namespace": "design.furniture",
+    "summary": "Test whether a catalog item exists for the given library id.",
+    "examplePrompts": [],
+    "argsType": "string",
+    "resultType": "boolean"
+  },
+  {
+    "path": "design.furniture.getCatalogItem",
+    "namespace": "design.furniture",
+    "summary": "Get a single catalog item by its library id.",
+    "examplePrompts": [],
+    "argsType": "string",
+    "resultType": "PluginFurnitureCatalogItem | null"
+  },
+  {
+    "path": "design.furniture.listCatalog",
+    "namespace": "design.furniture",
+    "summary": "List the placeable furniture catalog (team + general libraries).",
+    "examplePrompts": [],
+    "argsType": "\"team\" | \"general\"",
+    "resultType": "PluginFurnitureCatalogItem[]"
+  },
+  {
+    "path": "design.isLocked",
+    "namespace": "design",
+    "summary": "Test whether an entity is locked (folds group + bucket lock unless `includeInherited: false`).",
+    "examplePrompts": [],
+    "argsType": "ComponentHandle",
+    "resultType": "boolean"
+  },
+  {
+    "path": "design.listLocked",
+    "namespace": "design",
+    "summary": "List the explicitly-locked entities (excludes purely group/bucket-inherited locks).",
+    "examplePrompts": [],
+    "argsType": null,
+    "resultType": "ComponentHandle[]"
+  },
+  {
+    "path": "design.lock",
+    "namespace": "design",
+    "summary": "Lock entities (blocks editing). Undoable. Cascades to void/door/window children, stacked-wall companions, and terrain neighborhood; skips active-group members.",
+    "examplePrompts": [],
+    "argsType": "ComponentHandle[]",
+    "resultType": "PluginDesignChangeResult"
+  },
+  {
+    "path": "design.materials.apply",
+    "namespace": "design.materials",
+    "summary": "Apply a material (by handle or spec) to one or more components. Undoable (`save`, default true).",
+    "examplePrompts": [],
+    "argsType": "ComponentHandle[]",
+    "resultType": "PluginMaterialResult"
+  },
+  {
+    "path": "design.materials.create",
+    "namespace": "design.materials",
+    "summary": "Create (or get, idempotent by name) a material from a spec.",
+    "examplePrompts": [],
+    "argsType": "PluginMaterialSpec",
+    "resultType": "MaterialHandle"
+  },
+  {
+    "path": "design.materials.getDefault",
+    "namespace": "design.materials",
+    "summary": "Get the default material for a component's type.",
+    "examplePrompts": [],
+    "argsType": "ComponentHandle",
+    "resultType": "MaterialHandle | null"
+  },
+  {
+    "path": "design.materials.getInfo",
+    "namespace": "design.materials",
+    "summary": "Read a material's descriptor.",
+    "examplePrompts": [],
+    "argsType": "MaterialHandle",
+    "resultType": "PluginMaterialInfo | null"
+  },
+  {
+    "path": "design.materials.hasTexture",
+    "namespace": "design.materials",
+    "summary": "Test whether a material has a texture.",
+    "examplePrompts": [],
+    "argsType": "MaterialHandle",
+    "resultType": "boolean"
+  },
+  {
+    "path": "design.materials.isDefault",
+    "namespace": "design.materials",
+    "summary": "Test whether a component carries its (type) default material.",
+    "examplePrompts": [],
+    "argsType": "ComponentHandle",
+    "resultType": "boolean"
+  },
+  {
+    "path": "design.materials.isUniform",
+    "namespace": "design.materials",
+    "summary": "Test whether a component has a single (uniform) material across all faces.",
+    "examplePrompts": [],
+    "argsType": "ComponentHandle",
+    "resultType": "boolean"
+  },
+  {
+    "path": "design.materials.list",
+    "namespace": "design.materials",
+    "summary": "List the project materials.",
+    "examplePrompts": [],
+    "argsType": "\"project\" | \"preset\"",
+    "resultType": "MaterialHandle[]"
+  },
+  {
+    "path": "design.materials.reset",
+    "namespace": "design.materials",
+    "summary": "Reset one or more components to their default material. Undoable. Paired with `apply`.",
+    "examplePrompts": [],
+    "argsType": "ComponentHandle[]",
+    "resultType": "PluginMaterialResult"
+  },
+  {
+    "path": "design.query.exists",
+    "namespace": "design.query",
+    "summary": "Test whether an entity id resolves to a live scene entity.",
+    "examplePrompts": [],
+    "argsType": "ComponentHandle",
+    "resultType": "boolean"
+  },
+  {
+    "path": "design.query.geometry.getBottomContour",
+    "namespace": "design.query.geometry",
+    "summary": "Get the **bottom-face contour** of a component — the footprint outline (outer profile + holes) of its lowest horizontal face, as a reusable {@linkcode ContourHandle}.",
+    "examplePrompts": [],
+    "argsType": "ComponentHandle",
+    "resultType": "ContourHandle | null"
+  },
+  {
+    "path": "design.query.geometry.getBrep",
+    "namespace": "design.query.geometry",
+    "summary": "Get the boundary-representation (BREP) mesh of a scene component.",
+    "examplePrompts": [],
+    "argsType": "ComponentHandle",
+    "resultType": "BrepHandle | null"
+  },
+  {
+    "path": "design.query.getBoundingBox",
+    "namespace": "design.query",
+    "summary": "Get the **union** axis-aligned bounding box enclosing a set of entities.",
+    "examplePrompts": [],
+    "argsType": "ComponentHandle[]",
+    "resultType": "BBoxComponents | null"
+  },
+  {
+    "path": "design.query.getById",
+    "namespace": "design.query",
+    "summary": "Look an entity up by id — returns the same handle if it still resolves live, else `null`. A cheap validity probe (distinct from {@linkcode PluginDesignQueryApi.exists}).",
+    "examplePrompts": [],
+    "argsType": "ComponentHandle",
+    "resultType": "ComponentHandle | null"
+  },
+  {
+    "path": "design.query.getEntityRef",
+    "namespace": "design.query",
+    "summary": "Get a serializable, persistable reference to an entity. Under the all-handle model a {@linkcode ComponentHandle} already IS the ref (raw `Component.id`), so this is the identity passthrough — provided for API completeness.",
+    "examplePrompts": [],
+    "argsType": "ComponentHandle",
+    "resultType": "ComponentHandle"
+  },
+  {
+    "path": "design.query.getEntityType",
+    "namespace": "design.query",
+    "summary": "Get an entity's {@linkcode PluginEntityType}.",
+    "examplePrompts": [],
+    "argsType": "ComponentHandle",
+    "resultType": "PluginEntityType | null"
+  },
+  {
+    "path": "design.query.getHost",
+    "namespace": "design.query",
+    "summary": "Get an entity's host/parent entity (e.g. the wall a door is cut into).",
+    "examplePrompts": [],
+    "argsType": "ComponentHandle",
+    "resultType": "ComponentHandle | null"
+  },
+  {
+    "path": "design.query.getLabel",
+    "namespace": "design.query",
+    "summary": "Get an entity's human label (`room_type` for spaces/masses, else the mesh label; `\"\"` when unlabelled). The write side is `design.update` (`setLabel`).",
+    "examplePrompts": [],
+    "argsType": "ComponentHandle",
+    "resultType": "string"
+  },
+  {
+    "path": "design.query.getProperties",
+    "namespace": "design.query",
+    "summary": "Read an entity's common properties as a {@linkcode PluginEntityProperties} record (only applicable fields are present). For spaces/masses this includes `adjacency` — the per-entity adjacency read (bulk form: `program.adjacency.getMatrix`).",
+    "examplePrompts": [],
+    "argsType": "ComponentHandle",
+    "resultType": "PluginEntityProperties"
+  },
+  {
+    "path": "design.query.listBeams",
+    "namespace": "design.query",
+    "summary": "List all **beams**, filtered.",
+    "examplePrompts": [],
+    "argsType": "PluginEntityFilter",
+    "resultType": "ComponentHandle[]"
+  },
+  {
+    "path": "design.query.listByType",
+    "namespace": "design.query",
+    "summary": "List entities of a single {@linkcode PluginEntityType}, plus filter.",
+    "examplePrompts": [],
+    "argsType": "PluginEntityType",
+    "resultType": "ComponentHandle[]"
+  },
+  {
+    "path": "design.query.listCeilings",
+    "namespace": "design.query",
+    "summary": "List all **ceilings**, filtered.",
+    "examplePrompts": [],
+    "argsType": "PluginEntityFilter",
+    "resultType": "ComponentHandle[]"
+  },
+  {
+    "path": "design.query.listChildren",
+    "namespace": "design.query",
+    "summary": "List an entity's direct child entities.",
+    "examplePrompts": [],
+    "argsType": "ComponentHandle",
+    "resultType": "ComponentHandle[]"
+  },
+  {
+    "path": "design.query.listColumns",
+    "namespace": "design.query",
+    "summary": "List all **columns**, filtered.",
+    "examplePrompts": [],
+    "argsType": "PluginEntityFilter",
+    "resultType": "ComponentHandle[]"
+  },
+  {
+    "path": "design.query.listDoors",
+    "namespace": "design.query",
+    "summary": "List all **doors**, filtered.",
+    "examplePrompts": [],
+    "argsType": "PluginEntityFilter",
+    "resultType": "ComponentHandle[]"
+  },
+  {
+    "path": "design.query.listEntities",
+    "namespace": "design.query",
+    "summary": "List **all** BIM entities in the project matching the filter.",
+    "examplePrompts": [],
+    "argsType": "PluginEntityFilter",
+    "resultType": "ComponentHandle[]"
+  },
+  {
+    "path": "design.query.listFloors",
+    "namespace": "design.query",
+    "summary": "List all **floors**, filtered.",
+    "examplePrompts": [],
+    "argsType": "PluginEntityFilter",
+    "resultType": "ComponentHandle[]"
+  },
+  {
+    "path": "design.query.listFurniture",
+    "namespace": "design.query",
+    "summary": "List all **furniture**, filtered.",
+    "examplePrompts": [],
+    "argsType": "PluginEntityFilter",
+    "resultType": "ComponentHandle[]"
+  },
+  {
+    "path": "design.query.listMasses",
+    "namespace": "design.query",
+    "summary": "List all **generic masses** (non-room masses), filtered.",
+    "examplePrompts": [],
+    "argsType": "PluginEntityFilter",
+    "resultType": "ComponentHandle[]"
+  },
+  {
+    "path": "design.query.listMullions",
+    "namespace": "design.query",
+    "summary": "List all **curtain-wall mullions**, filtered.",
+    "examplePrompts": [],
+    "argsType": "PluginEntityFilter",
+    "resultType": "ComponentHandle[]"
+  },
+  {
+    "path": "design.query.listReferenceLines",
+    "namespace": "design.query",
+    "summary": "List all **reference lines**, filtered.",
+    "examplePrompts": [],
+    "argsType": "PluginEntityFilter",
+    "resultType": "ComponentHandle[]"
+  },
+  {
+    "path": "design.query.listRoofs",
+    "namespace": "design.query",
+    "summary": "List all **roofs**, filtered.",
+    "examplePrompts": [],
+    "argsType": "PluginEntityFilter",
+    "resultType": "ComponentHandle[]"
+  },
+  {
+    "path": "design.query.listSlabs",
+    "namespace": "design.query",
+    "summary": "List all **slabs**, filtered.",
+    "examplePrompts": [],
+    "argsType": "PluginEntityFilter",
+    "resultType": "ComponentHandle[]"
+  },
+  {
+    "path": "design.query.listSpaces",
+    "namespace": "design.query",
+    "summary": "List all **spaces** (room masses), filtered. See {@linkcode PluginDesignQueryApi.listWalls}.",
+    "examplePrompts": [],
+    "argsType": "PluginEntityFilter",
+    "resultType": "ComponentHandle[]"
+  },
+  {
+    "path": "design.query.listStaircases",
+    "namespace": "design.query",
+    "summary": "List all **staircases**, filtered.",
+    "examplePrompts": [],
+    "argsType": "PluginEntityFilter",
+    "resultType": "ComponentHandle[]"
+  },
+  {
+    "path": "design.query.listWalls",
+    "namespace": "design.query",
+    "summary": "List all **walls**, filtered.",
+    "examplePrompts": [],
+    "argsType": "PluginEntityFilter",
+    "resultType": "ComponentHandle[]"
+  },
+  {
+    "path": "design.query.listWindows",
+    "namespace": "design.query",
+    "summary": "List all **windows**, filtered.",
+    "examplePrompts": [],
+    "argsType": "PluginEntityFilter",
+    "resultType": "ComponentHandle[]"
+  },
+  {
+    "path": "design.query.measure",
+    "namespace": "design.query",
+    "summary": "Measure an entity — the multi-metric bundle (area/volume/length + bbox).",
+    "examplePrompts": [],
+    "argsType": "ComponentHandle",
+    "resultType": "PluginEntityMeasurements | null"
+  },
+  {
+    "path": "design.query.spaces.get",
+    "namespace": "design.query.spaces",
+    "summary": "Get selected properties of a space — the selective multi-property read.",
+    "examplePrompts": [],
+    "argsType": "ComponentHandle",
+    "resultType": "PluginDesignQuerySpacesGetResult"
+  },
+  {
+    "path": "design.query.spaces.getFootprint",
+    "namespace": "design.query.spaces",
+    "summary": "Get the **footprint** of a space — its bottom-face contour (outer profile + holes) as a reusable {@linkcode ContourHandle}. Equivalent to {@linkcode PluginDesignQueryGeometryApi.getBottomContour} narrowed to spaces.",
+    "examplePrompts": [],
+    "argsType": "ComponentHandle",
+    "resultType": "ContourHandle | null"
+  },
+  {
+    "path": "design.selection.add",
+    "namespace": "design.selection",
+    "summary": "Add entities to the current selection.",
+    "examplePrompts": [],
+    "argsType": "ComponentHandle[]",
+    "resultType": "PluginDesignChangeResult"
+  },
+  {
+    "path": "design.selection.clear",
+    "namespace": "design.selection",
+    "summary": "Clear the selection (≡ `set([])`).",
+    "examplePrompts": [],
+    "argsType": null,
+    "resultType": "PluginDesignChangeResult"
+  },
+  {
+    "path": "design.selection.get",
+    "namespace": "design.selection",
+    "summary": "Get the currently-selected entities.",
+    "examplePrompts": [],
+    "argsType": null,
+    "resultType": "ComponentHandle[]"
+  },
+  {
+    "path": "design.selection.remove",
+    "namespace": "design.selection",
+    "summary": "Remove entities from the current selection.",
+    "examplePrompts": [],
+    "argsType": "ComponentHandle[]",
+    "resultType": "PluginDesignChangeResult"
+  },
+  {
+    "path": "design.selection.set",
+    "namespace": "design.selection",
+    "summary": "Replace the selection with exactly the given entities.",
+    "examplePrompts": [],
+    "argsType": "ComponentHandle[]",
+    "resultType": "PluginDesignChangeResult"
+  },
+  {
+    "path": "design.transform.move",
+    "namespace": "design.transform",
+    "summary": "Translate entities by a **relative** displacement vector (added to the first component's absolute position as the anchor). Undoable.",
+    "examplePrompts": [],
+    "argsType": "ComponentHandle[]",
+    "resultType": "PluginDesignChangeResult"
+  },
+  {
+    "path": "design.transform.rotate",
+    "namespace": "design.transform",
+    "summary": "Rotate entities by a **signed angle in DEGREES**, anchored at the combined bounding-box centre (positive = CCW about +Y). NOTE: unlike the removed `tools.transform.rotate` (radians + caller pivot), this canonical form takes DEGREES and has NO caller pivot — the pivot is always the bbox centre. Undoable.",
+    "examplePrompts": [],
+    "argsType": "ComponentHandle[]",
+    "resultType": "PluginDesignChangeResult"
+  },
+  {
+    "path": "design.unlock",
+    "namespace": "design",
+    "summary": "Unlock entities. Undoable. Paired with {@linkcode PluginDesignApi.lock}.",
+    "examplePrompts": [],
+    "argsType": "ComponentHandle[]",
+    "resultType": "PluginDesignChangeResult"
+  },
+  {
+    "path": "design.update.space",
+    "namespace": "design.update",
+    "summary": "Update ONE space — sparse `properties` and/or a `geometry` re-extrude. Undoable.",
+    "examplePrompts": [],
+    "argsType": "ComponentHandle",
+    "resultType": "PluginSpaceUpdateResult"
+  },
+  {
+    "path": "design.update.spaces",
+    "namespace": "design.update",
+    "summary": "Update **many spaces** in one undoable operation (bulk plural of {@linkcode space}). Migrated from `entity.space.bulkUpdate`. Validate-all-or-throw; one command.",
+    "examplePrompts": [],
+    "argsType": "PluginUpdateSpaceItem[]",
+    "resultType": "PluginSpaceUpdateResult[]"
+  },
+  {
+    "path": "design.windows.getDimensions",
+    "namespace": "design.windows",
+    "summary": "Get a window's dimensions (local oriented space; `thickness` = through-wall depth).",
+    "examplePrompts": [],
+    "argsType": "ComponentHandle",
+    "resultType": "PluginWindowDimensions | null"
+  },
+  {
+    "path": "design.windows.getHeight",
+    "namespace": "design.windows",
+    "summary": "Get a window's height.",
+    "examplePrompts": [],
+    "argsType": "ComponentHandle",
+    "resultType": "number | null"
+  },
+  {
+    "path": "design.windows.getType",
+    "namespace": "design.windows",
+    "summary": "Get a window's type name.",
+    "examplePrompts": [],
+    "argsType": "ComponentHandle",
+    "resultType": "string | null"
+  },
+  {
+    "path": "design.windows.getWidth",
+    "namespace": "design.windows",
+    "summary": "Get a window's width.",
+    "examplePrompts": [],
+    "argsType": "ComponentHandle",
+    "resultType": "number | null"
+  },
+  {
+    "path": "design.windows.setHeight",
+    "namespace": "design.windows",
+    "summary": "Set a window's height (engine units; re-cuts the host wall). Undoable.",
+    "examplePrompts": [],
+    "argsType": "ComponentHandle",
+    "resultType": "PluginDesignChangeResult"
+  },
+  {
+    "path": "design.windows.setWidth",
+    "namespace": "design.windows",
+    "summary": "Set a window's width (engine units; re-cuts the host wall). Undoable.",
+    "examplePrompts": [],
+    "argsType": "ComponentHandle",
+    "resultType": "PluginDesignChangeResult"
+  },
+  {
+    "path": "entity.buildableEnvelope.create",
+    "namespace": "entity.buildableEnvelope",
+    "summary": "Create a new parametric buildable envelope.",
+    "examplePrompts": [],
+    "argsType": "PluginBuildableEnvelopePolygonVertex[]",
+    "resultType": "PluginBuildableEnvelopeCreateResult"
+  },
+  {
+    "path": "entity.buildableEnvelope.update",
+    "namespace": "entity.buildableEnvelope",
+    "summary": "Update an existing parametric buildable envelope.",
+    "examplePrompts": [],
+    "argsType": "string",
+    "resultType": "PluginBuildableEnvelopeUpdateResult"
+  },
+  {
+    "path": "entity.referenceLine.createMulti",
+    "namespace": "entity.referenceLine",
+    "summary": "Create multiple reference lines from a profile.",
+    "examplePrompts": [],
+    "argsType": "ProfileHandle",
+    "resultType": "PluginReferenceLineCreateMultiResult"
+  },
+  {
+    "path": "entity.referenceLine.delete",
+    "namespace": "entity.referenceLine",
+    "summary": "Delete a reference line by its ID.",
+    "examplePrompts": [],
+    "argsType": "string",
+    "resultType": "PluginReferenceLineDeleteResult"
+  },
+  {
+    "path": "entity.referenceLine.get",
+    "namespace": "entity.referenceLine",
+    "summary": "Get properties of a reference line by its ID.",
+    "examplePrompts": [],
+    "argsType": "string",
+    "resultType": "PluginReferenceLineGetResult"
+  },
+  {
+    "path": "entity.referenceLine.getAll",
+    "namespace": "entity.referenceLine",
+    "summary": "Get the IDs of all reference lines in the current project.",
+    "examplePrompts": [],
+    "argsType": null,
+    "resultType": "PluginReferenceLineGetAllResult"
+  },
+  {
+    "path": "entity.story.create",
+    "namespace": "entity.story",
+    "summary": "Create a new story (floor) in the project.",
+    "examplePrompts": [],
+    "argsType": "number",
+    "resultType": "PluginStoryCreateResult"
+  },
+  {
+    "path": "entity.story.get",
+    "namespace": "entity.story",
+    "summary": "Get properties of a story by its storey number.",
+    "examplePrompts": [],
+    "argsType": "number",
+    "resultType": "PluginStoryGetResult"
+  },
+  {
+    "path": "entity.story.getAll",
+    "namespace": "entity.story",
+    "summary": "Get all stories in the current project.",
+    "examplePrompts": [],
+    "argsType": null,
+    "resultType": "PluginStoryGetAllResult"
+  },
+  {
+    "path": "entity.story.update",
+    "namespace": "entity.story",
+    "summary": "Update a story's height.",
+    "examplePrompts": [],
+    "argsType": "number",
+    "resultType": "PluginStoryUpdateResult"
+  },
+  {
+    "path": "presentation.diagrams.place",
+    "namespace": "presentation.diagrams",
+    "summary": "Place diagram images onto a sheet.",
+    "examplePrompts": [
+      "Place the adjacency diagram on Sheet 1",
+      "Add the program diagram to the cover sheet",
+      "Drop these diagram images onto the layout\n\n# Example\n```ts\nawait snaptrude.presentation.diagrams.place(\"sheet_1\", [\n\"https://example.com/program-diagram.png\",\n])\n```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginPresentationDiagramsPlaceResult"
+  },
+  {
+    "path": "presentation.import.image",
+    "namespace": "presentation.import",
+    "summary": "Import a reference image onto the current Present sheet.",
+    "examplePrompts": [
+      "Import this reference image onto the present canvas",
+      "Add a JPG to my presentation board",
+      "Drop this site photo onto the current sheet",
+      "Bring an inspiration image into Present mode\n\n# Example\n```ts\nconst { shapeIds } = await snaptrude.presentation.import.image(\n{ url: \"https://example.com/ref.png\" },\n{ position: { x: 200, y: 150 } },\n)\n```"
+    ],
+    "argsType": "{ url?: string; dataUrl?: string }",
+    "resultType": "PluginPresentationImportResult"
+  },
+  {
+    "path": "presentation.import.pdf",
+    "namespace": "presentation.import",
+    "summary": "Import a PDF onto the current Present sheet (one shape per page).",
+    "examplePrompts": [
+      "Import this PDF onto the present canvas",
+      "Add a multi-page PDF reference to my board",
+      "Bring a PDF floor plan into Present mode as vectors",
+      "Place each page of this PDF on the sheet\n\n# Example\n```ts\nconst { shapeIds } = await snaptrude.presentation.import.pdf({\nurl: \"https://example.com/plans.pdf\",\n})\n```"
+    ],
+    "argsType": "{ url?: string; dataUrl?: string }",
+    "resultType": "PluginPresentationImportResult"
+  },
+  {
+    "path": "presentation.sheets.create",
+    "namespace": "presentation.sheets",
+    "summary": "Create a new layout sheet.",
+    "examplePrompts": [
+      "Create a new sheet called Cover",
+      "Add a layout sheet",
+      "Make a new presentation sheet named Floor Plans\n\n# Example\n```ts\nconst sheet = await snaptrude.presentation.sheets.create(\"Cover\")\n```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginPresentationSheet"
+  },
+  {
+    "path": "presentation.sheets.get",
+    "namespace": "presentation.sheets",
+    "summary": "Get a single sheet by id.",
+    "examplePrompts": [
+      "Get the sheet with id sheet_1",
+      "Find the sheet called Cover",
+      "Look up a layout sheet by id\n\n# Example\n```ts\nconst sheet = await snaptrude.presentation.sheets.get(\"sheet_1\")\n```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginPresentationSheetsGetResult"
+  },
+  {
+    "path": "presentation.sheets.list",
+    "namespace": "presentation.sheets",
+    "summary": "List the layout sheets in the presentation.",
+    "examplePrompts": [
+      "List all the sheets",
+      "How many layout sheets are there?",
+      "Show me the presentation sheets",
+      "What sheets can I place views on?\n\n# Example\n```ts\nconst { sheets } = await snaptrude.presentation.sheets.list()\n```"
+    ],
+    "argsType": null,
+    "resultType": "PluginPresentationSheetsListResult"
+  },
+  {
+    "path": "presentation.sheets.place",
+    "namespace": "presentation.sheets",
+    "summary": "Place a saved view onto a sheet.",
+    "examplePrompts": [
+      "Place the floor plan on Sheet 1",
+      "Add this 3D view to the cover sheet",
+      "Drop the site plan onto the layout sheet at 100, 200",
+      "Put the Ground Floor view on sheet_1\n\n# Example\n```ts\nconst { shapeId } = await snaptrude.presentation.sheets.place(\"sheet_1\", \"view_123\")\n```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginPresentationSheetsPlaceResult"
+  },
+  {
+    "path": "presentation.views.capture",
+    "namespace": "presentation.views",
+    "summary": "Capture a screenshot of a view as a base64 image.",
+    "examplePrompts": [
+      "Take a screenshot of the current view",
+      "Capture this view as a PNG",
+      "Render the Site Plan view to an image",
+      "Export a high-res image of what I'm looking at\n\n# Example\n```ts\nconst { image } = await snaptrude.presentation.views.capture({ format: \"png\" })\n```"
+    ],
+    "argsType": "{\n    viewId?: string\n    format?: \"png\" | \"jpeg\"\n    resolution?: string\n  }",
+    "resultType": "PluginPresentationViewsCaptureResult"
+  },
+  {
+    "path": "presentation.views.create",
+    "namespace": "presentation.views",
+    "summary": "Save the current camera/scene state as a new named view.",
+    "examplePrompts": [
+      "Save the current view as Lobby Perspective",
+      "Create a new saved view from where I'm looking",
+      "Bookmark this camera angle",
+      "Save the current 2D plan as a view\n\n# Example\n```ts\nconst view = await snaptrude.presentation.views.create(\"Lobby\")\n```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginPresentationViewsCreateResult"
+  },
+  {
+    "path": "presentation.views.get",
+    "namespace": "presentation.views",
+    "summary": "Get a single saved view by id.",
+    "examplePrompts": [
+      "Get the view with id view_12345",
+      "Find the saved view called Ground Floor Plan",
+      "Look up a presentation view by its id\n\n# Example\n```ts\nconst view = await snaptrude.presentation.views.get(\"view_123\")\n```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginPresentationViewsGetResult"
+  },
+  {
+    "path": "presentation.views.getActive",
+    "namespace": "presentation.views",
+    "summary": "Get the currently active view.",
+    "examplePrompts": [
+      "Which view is active right now?",
+      "Get the current view",
+      "What view am I looking at?\n\n# Example\n```ts\nconst active = await snaptrude.presentation.views.getActive()\n```"
+    ],
+    "argsType": null,
+    "resultType": "PluginPresentationViewsGetResult"
+  },
+  {
+    "path": "presentation.views.list",
+    "namespace": "presentation.views",
+    "summary": "List the saved views in the active project.",
+    "examplePrompts": [
+      "List all the saved views",
+      "What 2D and 3D views are in this project?",
+      "Which view is currently active?",
+      "Get the names of every presentation view",
+      "Show me the 3D views I can put on a sheet\n\n# Example\n```ts\nconst { views } = await snaptrude.presentation.views.list()\nconst active = views.find((v) => v.isActive)\nconst plans = views.filter((v) => v.type === \"2d\")\n```"
+    ],
+    "argsType": null,
+    "resultType": "PluginPresentationViewsListResult"
+  },
+  {
+    "path": "presentation.views.setActive",
+    "namespace": "presentation.views",
+    "summary": "Activate a saved view — move the camera to it and restore its scene state.",
+    "examplePrompts": [
+      "Switch to the Ground Floor plan view",
+      "Make the 3D view active",
+      "Go to the view named Entrance",
+      "Load the site plan view\n\n# Example\n```ts\nawait snaptrude.presentation.views.setActive(\"view_123\")\n```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginPresentationViewsSetActiveResult"
+  },
+  {
+    "path": "program.adjacency.compute",
+    "namespace": "program.adjacency",
+    "summary": "Compute (or refresh) the adjacency data for the project.",
+    "examplePrompts": [
+      "Refresh adjacency analysis",
+      "Compute the adjacency matrix for this project",
+      "Recalculate which departments should be adjacent\n\n# Example\n```ts\nconst { success } = await snaptrude.program.adjacency.compute()\nif (success) {\nconst data = await snaptrude.program.adjacency.getMatrix(\"space\")\n}\n```"
+    ],
+    "argsType": null,
+    "resultType": "PluginProgramAdjacencyComputeResult"
+  },
+  {
+    "path": "program.adjacency.getMatrix",
+    "namespace": "program.adjacency",
+    "summary": "Read the adjacency matrix at the department or space level.",
+    "examplePrompts": [
+      "Get the space adjacency matrix",
+      "Which departments must be adjacent?",
+      "Show the adjacency relationships between departments",
+      "Read the adjacency matrix for these spaces",
+      "Which rooms are restricted from being next to each other?\n\n# Example\n```ts\nconst { ids, matrix } = await snaptrude.program.adjacency.getMatrix(\"department\")\n```"
+    ],
+    "argsType": "PluginAdjacencyLevel",
+    "resultType": "PluginProgramAdjacencyGetMatrixResult"
+  },
+  {
+    "path": "program.areas.get",
+    "namespace": "program.areas",
+    "summary": "Get the program area summary.",
+    "examplePrompts": [
+      "What's my FAR right now?",
+      "Give me the program area summary",
+      "How much built-up area have I used against the site area?",
+      "Am I within my FAR target?\n\n# Example\n```ts\nconst s = await snaptrude.program.areas.get()\nconsole.log(s.builtUp, s.siteArea, s.achievedFar, s.targetFar, s.areaUnit)\n```"
+    ],
+    "argsType": null,
+    "resultType": "PluginProgramAreasGetResult"
+  },
+  {
+    "path": "program.areas.list",
+    "namespace": "program.areas",
+    "summary": "List the program area rollup grouped by a facet.",
+    "examplePrompts": [
+      "Break down the area by storey",
+      "Show the area rollup per department",
+      "Group the built-up area by building\n\n# Example\n```ts\nconst { groups } = await snaptrude.program.areas.list(\"storeys\")\nfor (const g of groups) console.log(g.name, g.builtUp, g.count)\n```"
+    ],
+    "argsType": "PluginProgramAreaGroupBy",
+    "resultType": "PluginProgramAreasListResult"
+  },
+  {
+    "path": "program.areas.listMembers",
+    "namespace": "program.areas",
+    "summary": "List the spaces that make up one area group.",
+    "examplePrompts": [
+      "List the spaces on this storey with their areas",
+      "What rooms are in the Bedrooms department bucket?",
+      "Break the storey area down into individual spaces\n\n# Example\n```ts\nconst { members } = await snaptrude.program.areas.listMembers(\"storeys\", \"st_2\")\nfor (const m of members) console.log(m.label, m.carpet)\n```"
+    ],
+    "argsType": "PluginProgramAreaGroupBy",
+    "resultType": "PluginProgramAreasListMembersResult"
+  },
+  {
+    "path": "program.areas.update",
+    "namespace": "program.areas",
+    "summary": "Update the program's FAR settings.",
+    "examplePrompts": [
+      "Set the target FAR to 2.5",
+      "Override the site area to 5000",
+      "Allow a 10 percent FAR deviation\n\n# Example\n```ts\nconst s = await snaptrude.program.areas.update({ targetFar: 2.5 })\nconsole.log(s.achievedFar, s.targetFar)\n```"
+    ],
+    "argsType": "{ targetFar?: number; siteArea?: number; deviation?: number }",
+    "resultType": "PluginProgramAreasUpdateResult"
+  },
+  {
+    "path": "program.classification.listTags",
+    "namespace": "program.classification",
+    "summary": "List a space's tags for display, grouped by category.",
+    "examplePrompts": [
+      "What tags are on this space?",
+      "Show the tags grouped by category for sp_4",
+      "List this room's display tags",
+      "Which tags does this space have?\n\n# Example\n```ts\nconst { tagsByCategory } = await snaptrude.program.classification.listTags(\"sp_4\")\n```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginProgramClassificationTagsResult"
+  },
+  {
+    "path": "program.classification.listTypes",
+    "namespace": "program.classification",
+    "summary": "List the selectable classification options for spaces.",
+    "examplePrompts": [
+      "What space types can I assign?",
+      "List the available area classifications",
+      "What classification options exist?",
+      "Show me the valid space-type values\n\n# Example\n```ts\nconst { spaceTypes, areaClasses } = await snaptrude.program.classification.listTypes()\n```"
+    ],
+    "argsType": null,
+    "resultType": "PluginProgramClassificationTypesResult"
+  },
+  {
+    "path": "program.cores.isCore",
+    "namespace": "program.cores",
+    "summary": "Test whether a space is a circulation core element.",
+    "examplePrompts": [
+      "Is this space a core?",
+      "Does this mass belong to the core?",
+      "Check if space sp_1 is a circulation core\n\n# Example\n```ts\nconst isCore = await snaptrude.program.cores.isCore(\"sp_1\")\n```"
+    ],
+    "argsType": "string",
+    "resultType": "boolean"
+  },
+  {
+    "path": "program.cores.list",
+    "namespace": "program.cores",
+    "summary": "List the cores currently in the building.",
+    "examplePrompts": [
+      "List the cores in the building",
+      "How many cores are placed?",
+      "Show me the lift and stair cores",
+      "Which storeys have cores?\n\n# Example\n```ts\nconst { cores } = await snaptrude.program.cores.list()\n```"
+    ],
+    "argsType": null,
+    "resultType": "PluginProgramCoresListResult"
+  },
+  {
+    "path": "program.departments.assign",
+    "namespace": "program.departments",
+    "summary": "Assign one or more spaces to a department.",
+    "examplePrompts": [
+      "Assign the selected rooms to the Bedrooms department",
+      "Put spaces 12 and 13 in the Circulation department",
+      "Move this space into the Lobby department",
+      "Add the kitchen spaces to the Service department\n\n# Example\n```ts\nawait snaptrude.program.departments.assign(\"dep_123\", [\"sp_1\", \"sp_2\"])\n```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginProgramDepartmentsAssignResult"
+  },
+  {
+    "path": "program.departments.create",
+    "namespace": "program.departments",
+    "summary": "Create a new department in the active program.",
+    "examplePrompts": [
+      "Create a department called Bedrooms in light blue",
+      "Add a new program group named Circulation with color #cccccc",
+      "Make a Classrooms department",
+      "Set up a Lobby department in the program\n\n# Example\n```ts\nconst { departmentId } = await snaptrude.program.departments.create(\"Bedrooms\", \"#b5e1dc\")\n```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginProgramDepartmentsCreateResult"
+  },
+  {
+    "path": "program.departments.get",
+    "namespace": "program.departments",
+    "summary": "Get a single department by id.",
+    "examplePrompts": [
+      "Get the department with id dep_123",
+      "Look up a single department by its id",
+      "What is the target area of this department id?\n\n# Example\n```ts\nconst dept = await snaptrude.program.departments.get(\"dep_123\")\nif (dept) console.log(dept.name, dept.targetArea)\n```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginProgramDepartmentsGetResult"
+  },
+  {
+    "path": "program.departments.list",
+    "namespace": "program.departments",
+    "summary": "List the departments in the active program.",
+    "examplePrompts": [
+      "List all the departments in my program",
+      "What program groups do I have and what are their target areas?",
+      "Show every department with its colour",
+      "Get the area target for each department",
+      "How many departments are in this project?\n\n# Example\n```ts\nconst { units, departments } = await snaptrude.program.departments.list()\nfor (const d of departments) console.log(d.name, d.color, d.targetArea, units)\n```"
+    ],
+    "argsType": null,
+    "resultType": "PluginProgramDepartmentsListResult"
+  },
+  {
+    "path": "program.departments.setTargetArea",
+    "namespace": "program.departments",
+    "summary": "Set a department's target area.",
+    "examplePrompts": [
+      "Set the Bedrooms department target area to 2000 sqft",
+      "Give the Circulation department a 500 sqm area target",
+      "Target 1500 square feet for the Classrooms department",
+      "Update the area goal for department dep_123\n\n# Example\n```ts\nawait snaptrude.program.departments.setTargetArea(\"dep_123\", 2000, \"ft2\")\n```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginProgramDepartmentsSetTargetAreaResult"
+  },
+  {
+    "path": "program.departments.unassign",
+    "namespace": "program.departments",
+    "summary": "Remove one or more spaces from their department.",
+    "examplePrompts": [
+      "Remove the selected rooms from their department",
+      "Unassign space sp_1 from any department",
+      "Clear the department on these spaces",
+      "Take the kitchen out of the Service department\n\n# Example\n```ts\nawait snaptrude.program.departments.unassign([\"sp_1\"])\n```"
+    ],
+    "argsType": "ComponentHandle[]",
+    "resultType": "PluginProgramDepartmentsUnassignResult"
+  },
+  {
+    "path": "program.departments.update",
+    "namespace": "program.departments",
+    "summary": "Update a department's name and/or color.",
+    "examplePrompts": [
+      "Rename the Bedrooms department to Suites",
+      "Change the Circulation department colour to #ff8800",
+      "Recolour department dep_123",
+      "Update the Lobby department's display name\n\n# Example\n```ts\nconst dept = await snaptrude.program.departments.update(\"dep_123\", { name: \"Suites\" })\n```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginProgramDepartmentsUpdateResult"
+  },
+  {
+    "path": "program.metrics.get",
+    "namespace": "program.metrics",
+    "summary": "Get the area-program summary for the active project.",
+    "examplePrompts": [
+      "How much area have I allocated versus my targets?",
+      "Give me the program area summary",
+      "Which departments are over or under their target area?",
+      "What's the total built area in the program?",
+      "Show the area breakdown per department",
+      "Am I within my area program?\n\n# Example\n```ts\nconst m = await snaptrude.program.metrics.get()\nconsole.log(`${m.totalAllocatedArea} / ${m.totalTargetArea} ${m.units}`)\nconsole.log(\"unassigned:\", m.unassignedArea)\nfor (const d of m.departments) {\nconsole.log(d.name, d.allocatedArea, d.targetArea)\n}\n```"
+    ],
+    "argsType": null,
+    "resultType": "PluginProgramMetricsSummary"
+  },
+  {
+    "path": "program.site.get",
+    "namespace": "program.site",
+    "summary": "Get a snapshot of the project site.",
+    "examplePrompts": [
+      "What is my total site area?",
+      "Give me a summary of the site",
+      "How many site parcels are on the canvas?",
+      "Show the site footprint and its area",
+      "How big is the plot I'm building on?\n\n# Example\n```ts\nconst site = await snaptrude.program.site.get()\nconsole.log(`${site.totalArea} ${site.units} across ${site.polygonCount} parcels`)\n```"
+    ],
+    "argsType": null,
+    "resultType": "PluginProgramSiteSnapshot"
+  },
+  {
+    "path": "program.site.getArea",
+    "namespace": "program.site",
+    "summary": "Get just the total site area.",
+    "examplePrompts": [
+      "What's the total site area?",
+      "How big is my plot in square metres?",
+      "Total parcel area on the site\n\n# Example\n```ts\nconst { area, units } = await snaptrude.program.site.getArea()\n```"
+    ],
+    "argsType": null,
+    "resultType": "PluginProgramSiteAreaResult"
+  },
+  {
+    "path": "program.site.getContext",
+    "namespace": "program.site",
+    "summary": "Get the geo-referenced terrain context of the site.",
+    "examplePrompts": [
+      "What's the site's map center and bounds?",
+      "How wide is the terrain in metres?",
+      "Give me the parcel geometry and areas",
+      "Where is the site located on the map?\n\n# Example\n```ts\nconst ctx = await snaptrude.program.site.getContext()\nif (ctx) console.log(ctx.center, ctx.widthInM)\n```"
+    ],
+    "argsType": null,
+    "resultType": "PluginProgramSiteContextResult"
+  },
+  {
+    "path": "program.site.listGeoPolygons",
+    "namespace": "program.site",
+    "summary": "List the site parcels as geographic latitude/longitude rings.",
+    "examplePrompts": [
+      "Give me the site polygons in latitude and longitude",
+      "Export the plot boundary as geo-coordinates",
+      "Where is the site located geographically?",
+      "Get the site parcels as lat/long rings\n\n# Example\n```ts\nconst { polygons } = await snaptrude.program.site.listGeoPolygons()\nconst firstRing = polygons[0] // [{ lat, lng, alt }, ...]\n```"
+    ],
+    "argsType": null,
+    "resultType": "PluginProgramSiteListGeoPolygonsResult"
+  },
+  {
+    "path": "program.site.listPolygons",
+    "namespace": "program.site",
+    "summary": "List the site parcels with their footprints (in scene coordinates).",
+    "examplePrompts": [
+      "List every site parcel",
+      "Show me each plot's footprint",
+      "Which site parcels are largest?",
+      "Get the boundary points of the site polygons\n\n# Example\n```ts\nconst { polygons, units } = await snaptrude.program.site.listPolygons()\nfor (const p of polygons) console.log(p.label, p.area, units, p.footprint.length)\n```"
+    ],
+    "argsType": null,
+    "resultType": "PluginProgramSiteListPolygonsResult"
+  },
+  {
+    "path": "program.spreadsheet.addChart",
+    "namespace": "program.spreadsheet",
+    "summary": "Add a chart to a sheet, driven by a cell range.",
+    "examplePrompts": [
+      "Add a bar chart of the department areas",
+      "Insert a pie chart from range B2:C10",
+      "Put a column chart on the Program sheet",
+      "Chart the area breakdown by department\n\n# Example\n```ts\nconst { chartId } = await snaptrude.program.spreadsheet.addChart(\n\"Program\",\n\"column\",\n\"A1:B10\",\n{ title: \"Area by department\" },\n)\n```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginProgramSpreadsheetAddChartResult"
+  },
+  {
+    "path": "program.spreadsheet.addConditionalFormatting",
+    "namespace": "program.spreadsheet",
+    "summary": "Add a conditional-formatting rule to a range.",
+    "examplePrompts": [
+      "Add data bars to the area column",
+      "Show a proportional bar inside cells B2:B10",
+      "Add conditional formatting data bars to the quantities\n\n# Example\n```ts\nawait snaptrude.program.spreadsheet.addConditionalFormatting(\"Summary\", \"B2:B10\", {\ntype: \"dataBar\",\ncolor: \"#4f9cf9\",\n})\n```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginProgramSpreadsheetAddConditionalFormattingResult"
+  },
+  {
+    "path": "program.spreadsheet.bindings.create",
+    "namespace": "program.spreadsheet.bindings",
+    "summary": "Create a named binding from a dataset to a sheet range (and do an initial refresh).",
+    "examplePrompts": [
+      "Bind the takeoff to the Data sheet",
+      "Create a live binding from the takeoff to A1 on Data",
+      "Link the takeoff dataset to a sheet range\n\n# Example\n```ts\nawait snaptrude.program.spreadsheet.bindings.create(\n\"takeoff\",\n{ dataset: \"takeoff\" },\n{ sheetName: \"Data\", startCell: \"A1\" },\n)\n```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginProgramSpreadsheetBindingsCreateResult"
+  },
+  {
+    "path": "program.spreadsheet.bindings.list",
+    "namespace": "program.spreadsheet.bindings",
+    "summary": "List all data bindings in the workbook.",
+    "examplePrompts": [
+      "List the data bindings",
+      "What bindings are set up on the sheets?",
+      "Show all the live data bindings\n\n# Example\n```ts\nconst { bindings } = await snaptrude.program.spreadsheet.bindings.list()\n```"
+    ],
+    "argsType": null,
+    "resultType": "PluginProgramSpreadsheetBindingsListResult"
+  },
+  {
+    "path": "program.spreadsheet.bindings.refresh",
+    "namespace": "program.spreadsheet.bindings",
+    "summary": "Refresh one binding (by name) or all bindings, re-pulling their source data.",
+    "examplePrompts": [
+      "Refresh the takeoff binding",
+      "Re-pull all my data bindings",
+      "Refresh every binding on the sheets\n\n# Example\n```ts\nawait snaptrude.program.spreadsheet.bindings.refresh({ name: \"takeoff\" })\n```"
+    ],
+    "argsType": "{ name?: string }",
+    "resultType": "PluginProgramSpreadsheetBindingsRefreshResult"
+  },
+  {
+    "path": "program.spreadsheet.createSheet",
+    "namespace": "program.spreadsheet",
+    "summary": "Create (or reuse/replace) a named sheet in the report workbook.",
+    "examplePrompts": [
+      "Create a sheet called Summary",
+      "Add a new blank sheet named Takeoff",
+      "Make a sheet, replacing it if it already exists",
+      "Start a fresh sheet to write into\n\n# Example\n```ts\nawait snaptrude.program.spreadsheet.createSheet(\"Summary\")\n```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginProgramSpreadsheetCreateSheetResult"
+  },
+  {
+    "path": "program.spreadsheet.export",
+    "namespace": "program.spreadsheet",
+    "summary": "Export the whole report workbook to a file (xlsx, pdf, or csv).",
+    "examplePrompts": [
+      "Export the report as an Excel file",
+      "Download the whole workbook as a PDF",
+      "Export the program workbook to xlsx",
+      "Save the report as a csv file\n\n# Example\n```ts\nconst file = await snaptrude.program.spreadsheet.export(\"xlsx\")\n// file.fileName, file.mimeType, file.dataBase64\n```"
+    ],
+    "argsType": "PluginSpreadsheetExportFormat",
+    "resultType": "PluginProgramSpreadsheetExportResult"
+  },
+  {
+    "path": "program.spreadsheet.getAuditLog",
+    "namespace": "program.spreadsheet",
+    "summary": "Read the recent audit log of program-spreadsheet operations.",
+    "examplePrompts": [
+      "Show the recent spreadsheet actions",
+      "What did the plugin change in the workbook?",
+      "Get the last 10 audit log entries",
+      "Read the program spreadsheet audit log\n\n# Example\n```ts\nconst { entries } = await snaptrude.program.spreadsheet.getAuditLog({ limit: 10 })\n```"
+    ],
+    "argsType": "{ limit?: number }",
+    "resultType": "PluginProgramSpreadsheetGetAuditLogResult"
+  },
+  {
+    "path": "program.spreadsheet.getProgram",
+    "namespace": "program.spreadsheet",
+    "summary": "Read the area-program dataset (departments with target vs allocated area).",
+    "examplePrompts": [
+      "Get the area program data",
+      "Read the department program before I render it",
+      "Give me the program rows with target vs allocated area",
+      "What's the program dataset the report is built from?\n\n# Example\n```ts\nconst program = await snaptrude.program.spreadsheet.getProgram()\nfor (const row of program.rows) console.log(row.name, row.allocatedArea, row.targetArea)\n```"
+    ],
+    "argsType": null,
+    "resultType": "PluginProgramSpreadsheetGetProgramResult"
+  },
+  {
+    "path": "program.spreadsheet.getSheetData",
+    "namespace": "program.spreadsheet",
+    "summary": "Read a sheet's data back as a matrix (and optionally as header-keyed records).",
+    "examplePrompts": [
+      "Read the data back from the Program sheet",
+      "Get the values in range A1:D20 of a sheet",
+      "Read a sheet as rows of records keyed by header",
+      "What's in the takeoff sheet right now?\n\n# Example\n```ts\nconst { values, records } = await snaptrude.program.spreadsheet.getSheetData(\n\"Program\",\n{ header: true },\n)\n```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginProgramSpreadsheetGetSheetDataResult"
+  },
+  {
+    "path": "program.spreadsheet.getTakeoff",
+    "namespace": "program.spreadsheet",
+    "summary": "Read the quantity/material takeoff dataset (per-element quantities).",
+    "examplePrompts": [
+      "Get the takeoff data",
+      "Read the quantity takeoff rows",
+      "Give me the per-element quantities before I render them",
+      "What's in the material takeoff right now?\n\n# Example\n```ts\nconst takeoff = await snaptrude.program.spreadsheet.getTakeoff()\nconsole.log(takeoff.rowCount, \"elements\")\n```"
+    ],
+    "argsType": null,
+    "resultType": "PluginProgramSpreadsheetGetTakeoffResult"
+  },
+  {
+    "path": "program.spreadsheet.highlightCells",
+    "namespace": "program.spreadsheet",
+    "summary": "Highlight a range of cells (background color and optional emphasis).",
+    "examplePrompts": [
+      "Highlight the cells that are over budget",
+      "Color range A2:A10 red",
+      "Highlight B2:D2 in yellow",
+      "Emphasize the totals row on the Program sheet\n\n# Example\n```ts\nawait snaptrude.program.spreadsheet.highlightCells(\"Program\", \"A2:A10\", {\ncolor: \"#ffe08a\",\n})\n```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginProgramSpreadsheetHighlightCellsResult"
+  },
+  {
+    "path": "program.spreadsheet.listSheets",
+    "namespace": "program.spreadsheet",
+    "summary": "List the sheets in the report workbook.",
+    "examplePrompts": [
+      "List the sheets in the spreadsheet",
+      "What sheets are in the report workbook?",
+      "Which sheet is currently active?",
+      "How many sheets does the report have?\n\n# Example\n```ts\nconst { sheets, activeSheet } = await snaptrude.program.spreadsheet.listSheets()\n```"
+    ],
+    "argsType": null,
+    "resultType": "PluginProgramSpreadsheetListSheetsResult"
+  },
+  {
+    "path": "program.spreadsheet.mergeCells",
+    "namespace": "program.spreadsheet",
+    "summary": "Merge a contiguous range of cells into a single spanned cell.",
+    "examplePrompts": [
+      "Merge cells A1 to D1 for the title",
+      "Span the header across the first four columns",
+      "Merge A1:D1 and set it to \"Program Summary\"\n\n# Example\n```ts\nawait snaptrude.program.spreadsheet.mergeCells(\"Summary\", \"A1:D1\", \"Program Summary\")\n```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginProgramSpreadsheetMergeCellsResult"
+  },
+  {
+    "path": "program.spreadsheet.ping",
+    "namespace": "program.spreadsheet",
+    "summary": "Ping the program-mode spreadsheet bridge to check it is reachable.",
+    "examplePrompts": [
+      "Ping the spreadsheet bridge",
+      "Is the program spreadsheet available?",
+      "Check the spreadsheet connection is alive\n\n# Example\n```ts\nconst { pong } = await snaptrude.program.spreadsheet.ping()\n```"
+    ],
+    "argsType": null,
+    "resultType": "PluginProgramSpreadsheetPingResult"
+  },
+  {
+    "path": "program.spreadsheet.recalculate",
+    "namespace": "program.spreadsheet",
+    "summary": "Recompute the workbook's formula results.",
+    "examplePrompts": [
+      "Recalculate the workbook",
+      "Recompute all the formulas",
+      "Recalculate the Summary sheet\n\n# Example\n```ts\nawait snaptrude.program.spreadsheet.recalculate()\n```"
+    ],
+    "argsType": "{ sheetName?: string }",
+    "resultType": "PluginProgramSpreadsheetRecalculateResult"
+  },
+  {
+    "path": "program.spreadsheet.render",
+    "namespace": "program.spreadsheet",
+    "summary": "Render a titled, formatted table onto a named sheet (create-or-replace).",
+    "examplePrompts": [
+      "Render my takeoff as a table on a sheet",
+      "Write the area schedule to a spreadsheet with totals",
+      "Put the department breakdown on a sheet called \"Program\"",
+      "Output this data as a formatted table with a header",
+      "Create a report sheet from these rows and columns\n\n# Example\n```ts\nawait snaptrude.program.spreadsheet.render(\n\"Program\",\n[\n{ key: \"name\", header: \"Department\" },\n{ key: \"area\", header: \"Area\", format: \"0.00\", align: \"right\" },\n],\n[{ name: \"FOH\", area: 120.5 }],\n{ totals: [{ column: \"area\", fn: \"sum\", label: \"Total\" }] },\n)\n```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginProgramSpreadsheetRenderResult"
+  },
+  {
+    "path": "program.spreadsheet.renderProgram",
+    "namespace": "program.spreadsheet",
+    "summary": "Render the area program onto a sheet.",
+    "examplePrompts": [
+      "Render the area program onto a sheet",
+      "Put the department program on a spreadsheet",
+      "Generate the program schedule sheet titled Program",
+      "Render the program filtered to the residential departments\n\n# Example\n```ts\nawait snaptrude.program.spreadsheet.renderProgram({ sheetName: \"Program\" })\n```"
+    ],
+    "argsType": "{ sheetName?: string; title?: string; filter?: string }",
+    "resultType": "PluginProgramSpreadsheetRenderResult"
+  },
+  {
+    "path": "program.spreadsheet.renderTakeoff",
+    "namespace": "program.spreadsheet",
+    "summary": "Render the quantity/material takeoff onto a sheet.",
+    "examplePrompts": [
+      "Render the takeoff onto a sheet",
+      "Put the quantity takeoff on a spreadsheet",
+      "Generate the takeoff schedule sheet titled Takeoff",
+      "Render the material takeoff filtered to the walls\n\n# Example\n```ts\nawait snaptrude.program.spreadsheet.renderTakeoff({ sheetName: \"Takeoff\" })\n```"
+    ],
+    "argsType": "{ sheetName?: string; title?: string; filter?: string }",
+    "resultType": "PluginProgramSpreadsheetRenderResult"
+  },
+  {
+    "path": "program.spreadsheet.runScript",
+    "namespace": "program.spreadsheet",
+    "summary": "Run an author-supplied script against a sandboxed workbook facade.",
+    "examplePrompts": [
+      "Run this SpreadJS script against the workbook",
+      "Execute a custom script on the sheets",
+      "Run a script to tweak the workbook\n\n# Example\n```ts\nconst { result } = await snaptrude.program.spreadsheet.runScript(\n\"return workbook.getSheetCount();\",\n)\n```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginProgramSpreadsheetRunScriptResult"
+  },
+  {
+    "path": "program.spreadsheet.setFormulas",
+    "namespace": "program.spreadsheet",
+    "summary": "Set formulas on individual cells of a sheet.",
+    "examplePrompts": [
+      "Put a SUM formula in cell B10",
+      "Set formulas totalling each column",
+      "Add a formula to compute the variance column",
+      "Write =SUM(B2:B9) into B10 on the Summary sheet\n\n# Example\n```ts\nawait snaptrude.program.spreadsheet.setFormulas(\"Summary\", [\n{ cell: \"B10\", formula: \"=SUM(B2:B9)\" },\n])\n```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginProgramSpreadsheetSetFormulasResult"
+  },
+  {
+    "path": "program.spreadsheet.setStyles",
+    "namespace": "program.spreadsheet",
+    "summary": "Apply cell styles to one or more ranges of a sheet.",
+    "examplePrompts": [
+      "Make the header row bold with a grey fill",
+      "Right-align the numbers in column B",
+      "Format A1:D1 with a background color and bold text",
+      "Style the totals row\n\n# Example\n```ts\nawait snaptrude.program.spreadsheet.setStyles(\"Summary\", [\n{ range: \"A1:D1\", style: { fontWeight: \"bold\", backColor: \"#eef\" } },\n])\n```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginProgramSpreadsheetSetStylesResult"
+  },
+  {
+    "path": "program.spreadsheet.setValues",
+    "namespace": "program.spreadsheet",
+    "summary": "Write a block of raw values into a sheet, anchored at a cell.",
+    "examplePrompts": [
+      "Write these rows to the sheet starting at A1",
+      "Put this data into the Summary sheet",
+      "Set the values in the takeoff sheet from B2",
+      "Drop this matrix of numbers onto a sheet\n\n# Example\n```ts\nawait snaptrude.program.spreadsheet.setValues(\n\"Summary\",\n[[\"Department\", \"Area\"], [\"FOH\", 120.5]],\n\"A1\",\n)\n```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginProgramSpreadsheetSetValuesResult"
+  },
+  {
+    "path": "program.spreadsheet.templates.apply",
+    "namespace": "program.spreadsheet.templates",
+    "summary": "Apply a saved template to a target sheet (create-or-replace).",
+    "examplePrompts": [
+      "Apply the Cover template to a new sheet",
+      "Use my saved template on the Report sheet",
+      "Apply template \"Cover\" to sheet \"Report\"\n\n# Example\n```ts\nawait snaptrude.program.spreadsheet.templates.apply(\"Cover\", \"Report\")\n```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginProgramSpreadsheetTemplatesApplyResult"
+  },
+  {
+    "path": "program.spreadsheet.templates.create",
+    "namespace": "program.spreadsheet.templates",
+    "summary": "Save a sheet's current layout as a named template.",
+    "examplePrompts": [
+      "Save this sheet as a reusable template",
+      "Create a template from the Summary sheet",
+      "Save the current layout as a template called \"Cover\"\n\n# Example\n```ts\nawait snaptrude.program.spreadsheet.templates.create(\"Cover\", \"Summary\")\n```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginProgramSpreadsheetTemplatesCreateResult"
+  },
+  {
+    "path": "program.spreadsheet.transaction",
+    "namespace": "program.spreadsheet",
+    "summary": "Run a sequence of sheet operations as one atomic, undoable transaction.",
+    "examplePrompts": [
+      "Create a sheet and write to it in one atomic step",
+      "Batch these sheet edits as a single undoable action",
+      "Run these operations together as one transaction\n\n# Example\n```ts\nawait snaptrude.program.spreadsheet.transaction(\n[\n{ method: \"createSheet\", args: { name: \"Summary\" } },\n{ method: \"setValues\", args: { sheetName: \"Summary\", values: [[\"A\", 1]] } },\n],\n\"Build summary\",\n)\n```"
+    ],
+    "argsType": "PluginSpreadsheetTransactionOp[]",
+    "resultType": "PluginProgramSpreadsheetTransactionResult"
+  }
+]