@snaptrude/plugin-core 0.9.16 → 0.9.18-voids-20261016.1

package/api-manifest.json

@@ -987,7 +987,7 @@
     "examplePrompts": [
       "Subtract the courtyard from the building mass",
       "Cut this solid out of that one",
-      "Punch a hole through the slab with this box\n\n# Example\n```ts\n// buildingBrep minus courtyardBrep — order matters\nconst carved = await snaptrude.core.geom.create.brepFromSubtraction(buildingBrep, courtyardBrep)\n```"
+      "Subtract this box solid from that solid\n\n# Example\n```ts\n// buildingBrep minus courtyardBrep — order matters\nconst carved = await snaptrude.core.geom.create.brepFromSubtraction(buildingBrep, courtyardBrep)\n```"
     ],
     "argsType": "BrepHandle",
     "resultType": "BrepHandle"
@@ -2422,7 +2422,7 @@
     "summary": "Add a hole to a contour by appending an inner profile. Immutable — returns a NEW contour and leaves the input unchanged.",
     "examplePrompts": [
       "Cut a hole in this shape",
-      "Punch an opening through this floor outline\n\n# Example\n```ts\nconst outer = await snaptrude.core.geom.create.profileRect(10, 8)\nconst contour = await snaptrude.core.geom.create.contourFromProfile(outer)\nconst hole = await snaptrude.core.geom.create.profileRect(2, 2)\nconst withHole = await snaptrude.core.geom.update.contour.addHole(contour, hole)\nconst count = await snaptrude.core.geom.query.contour.getHoleCount(withHole) // 1\n```"
+      "Punch an opening through this outline\n\n# Example\n```ts\nconst outer = await snaptrude.core.geom.create.profileRect(10, 8)\nconst contour = await snaptrude.core.geom.create.contourFromProfile(outer)\nconst hole = await snaptrude.core.geom.create.profileRect(2, 2)\nconst withHole = await snaptrude.core.geom.update.contour.addHole(contour, hole)\nconst count = await snaptrude.core.geom.query.contour.getHoleCount(withHole) // 1\n```"
     ],
     "argsType": "ContourHandle",
     "resultType": "ContourHandle"
@@ -2466,7 +2466,7 @@
     "summary": "Remove a hole from a contour by inner-profile index. Immutable — returns a NEW contour and leaves the input unchanged.",
     "examplePrompts": [
       "Remove the hole from this shape",
-      "Fill in the opening in this floor outline\n\n# Example\n```ts\nconst outer = await snaptrude.core.geom.create.profileRect(10, 8)\nconst hole = await snaptrude.core.geom.create.profileRect(2, 2)\nconst contour = await snaptrude.core.geom.create.contourFromProfiles(outer, [hole])\nconst solid = await snaptrude.core.geom.update.contour.removeHole(contour, 0)\n```"
+      "Fill in the opening in this outline\n\n# Example\n```ts\nconst outer = await snaptrude.core.geom.create.profileRect(10, 8)\nconst hole = await snaptrude.core.geom.create.profileRect(2, 2)\nconst contour = await snaptrude.core.geom.create.contourFromProfiles(outer, [hole])\nconst solid = await snaptrude.core.geom.update.contour.removeHole(contour, 0)\n```"
     ],
     "argsType": "ContourHandle",
     "resultType": "ContourHandle"
@@ -4566,6 +4566,36 @@
     "resultType": "boolean",
     "deprecated": "core.camera.zoomSelection"
   },
+  {
+    "path": "design.bim.create",
+    "namespace": "design.bim",
+    "summary": "Execute native Sketch-to-BIM. Revalidates scope, catalogue access and construction before mutation. Uses native progress/cancel controls and worker cancellation. Floors/roofs retain project defaults.",
+    "examplePrompts": [
+      "Convert these sketch rooms to BIM with wall layers chosen for each room boundary"
+    ],
+    "argsType": "string",
+    "resultType": "PluginBimResult"
+  },
+  {
+    "path": "design.bim.getContext",
+    "namespace": "design.bim",
+    "summary": "Read room adjacency and native conversion eligibility in the active proposal.",
+    "examplePrompts": [
+      "Inspect the rooms on each side of these sketch wall boundaries"
+    ],
+    "argsType": "PluginBimContextArgs",
+    "resultType": "PluginBimContext"
+  },
+  {
+    "path": "design.bim.prepare",
+    "namespace": "design.bim",
+    "summary": "Stage a complete wall-construction assignment. A new prepare replaces this plugin's prior plan.",
+    "examplePrompts": [
+      "Validate wall layer assignments before converting sketch rooms to BIM"
+    ],
+    "argsType": "PluginBimPrepareArgs",
+    "resultType": "PluginBimPreparation"
+  },
   {
     "path": "design.boolean.intersect",
     "namespace": "design.boolean",
@@ -4607,6 +4637,38 @@
     "argsType": "ComponentHandle[]",
     "resultType": "BooleanOutcome"
   },
+  {
+    "path": "design.catalog.get",
+    "namespace": "design.catalog",
+    "summary": "",
+    "examplePrompts": [],
+    "argsType": "PluginCatalogReference",
+    "resultType": "PluginCatalogEntry | null"
+  },
+  {
+    "path": "design.catalog.list",
+    "namespace": "design.catalog",
+    "summary": "",
+    "examplePrompts": [],
+    "argsType": "PluginCatalogKind",
+    "resultType": "PluginCatalogEntry[]"
+  },
+  {
+    "path": "design.catalog.listCategories",
+    "namespace": "design.catalog",
+    "summary": "Discover categories from accessible saved families and current project constructions. Omit parent for roots; pass a slash-separated returned path for its direct children. This metadata read does not fetch recipes, include unsaved drafts or legacy mesh inventories, or establish capabilities. Use search then get before placement. Names retain their case.",
+    "examplePrompts": [],
+    "argsType": "PluginCatalogListCategoriesArgs",
+    "resultType": "PluginCatalogCategory[]"
+  },
+  {
+    "path": "design.catalog.search",
+    "namespace": "design.catalog",
+    "summary": "Search accessible saved-family and project-construction metadata without downloading recipes. Categories are data, not an SDK enum. Legacy mesh inventories and unsaved drafts are excluded. Inspect selected references with get before placement; a search match does not prove validity or supported behavior. Pagination reads live data, not a snapshot. Failures reject.",
+    "examplePrompts": [],
+    "argsType": "PluginCatalogSearchArgs",
+    "resultType": "PluginCatalogSearchResult"
+  },
   {
     "path": "design.create.beam",
     "namespace": "design.create",
@@ -4617,7 +4679,7 @@
       "Run a 300x600 beam across the room",
       "Extrude this cross-section into a 5m long beam\n\n# Example\n```ts\nconst rect = await snaptrude.core.geom.create.profileRect(0.3, 0.6)\nconst section = await snaptrude.core.geom.create.contourFromProfile(rect)\nconst alongX = await snaptrude.core.math.vec3.new(1, 0, 0)\nconst beam = await snaptrude.design.create.beam(section, 6, alongX)\n```"
     ],
-    "argsType": "ContourHandle",
+    "argsType": "| [section: ContourHandle, length: number, direction?: Vec3Handle]\n      | [axis: LineHandle, options: PluginFamilyPlacement]",
     "resultType": "ComponentHandle"
   },
   {
@@ -4643,7 +4705,7 @@
       "Put a dropped ceiling in the living room at 3 metres",
       "Add a 50mm thick ceiling lifted 2800mm from floor level\n\n# Example\n```ts\nconst rect = await snaptrude.core.geom.create.profileRect(5, 4)\nconst contour = await snaptrude.core.geom.create.contourFromProfile(rect)\nconst ceiling = await snaptrude.design.create.ceiling(contour, 0.05, 2.8)\n```"
     ],
-    "argsType": "ContourHandle",
+    "argsType": "| [contour: ContourHandle, thickness: number, heightFromFloor?: number]\n      | [contour: ContourHandle, options: PluginFamilyCeilingOptions]",
     "resultType": "ComponentHandle"
   },
   {
@@ -4656,7 +4718,7 @@
       "Create a 450mm square concrete column 4 metres high",
       "Stand a column up from this base point\n\n# Example\n```ts\nconst rect = await snaptrude.core.geom.create.profileRect(0.45, 0.45)\nconst crossSection = await snaptrude.core.geom.create.contourFromProfile(rect)\nconst base = await snaptrude.core.math.vec3.new(4, 0, 4)\nconst column = await snaptrude.design.create.column(base, crossSection, 3)\n```"
     ],
-    "argsType": "Vec3Handle",
+    "argsType": "| [\n          position: Vec3Handle,\n          crossSection: ContourHandle,\n          height: number,\n          directionUp?: Vec3Handle,\n        ]\n      | [axis: LineHandle, options: PluginFamilyPlacement]",
     "resultType": "ComponentHandle"
   },
   {
@@ -4688,7 +4750,7 @@
   {
     "path": "design.create.door",
     "namespace": "design.create",
-    "summary": "Place a **door** from the catalog into a host wall.",
+    "summary": "Place a parametric **door** family into a host wall.",
     "examplePrompts": [
       "Add a door to this wall here",
       "Place a sliding door on the selected wall",
@@ -4705,7 +4767,7 @@
   {
     "path": "design.create.doors",
     "namespace": "design.create",
-    "summary": "Place **many doors** into host walls in one undoable operation (bulk plural of {@linkcode door}). Each item carries its own catalog id, host wall, world position, and optional `facing`, `label`, `width` and `height` — the same fields as a `\"door\"` {@linkcode PluginDesignCreateOpeningOptions}. Validate-all-or-throw; one command.",
+    "summary": "Place **many doors** into host walls in one undoable operation (bulk plural of {@linkcode door}). Each item carries its own family id, host wall, world position, and optional `facing`, `label`, `width` and `height` — the same fields as a `\"door\"` {@linkcode PluginDesignCreateOpeningOptions}. Validate-all-or-throw; one command.",
     "examplePrompts": [
       "Add doors to all of these walls at once",
       "Place a door in every room in one operation",
@@ -4715,7 +4777,7 @@
     ],
     "argsType": "PluginCreateDoorItem[]",
     "resultType": "ComponentHandle[]",
-    "performance": "Bulk creator — the whole batch is ONE host round-trip and ONE undo entry, and each distinct catalog source loads once. Always prefer this over calling `design.create.door` in a loop: build the full `items[]` array first (all host walls and points up front), then make one call. # Example ```ts const v = snaptrude.core.math.vec3 const [wall] = await snaptrude.design.query.listWalls({ isSelected: true }) const [entry] = await snaptrude.design.doors.listCatalog() const [front, side] = await snaptrude.design.create.doors([ { catalogId: entry.id, hostWall: wall, position: await v.new(2, 0, 5), label: \"D-01\" }, { catalogId: entry.id, hostWall: wall, position: await v.new(6, 0, 5), width: 1.2 }, ]) // `wall` was re-cut twice and no longer resolves — ask the opening for its host: const currentWall = await snaptrude.design.query.getHost(front) ```"
+    "performance": "Bulk creator — the whole batch is ONE host round-trip and ONE undo entry. Always prefer this over calling `design.create.door` in a loop: build the full `items[]` array first (all host walls and points up front), then make one call. # Example ```ts const v = snaptrude.core.math.vec3 const [wall] = await snaptrude.design.query.listWalls({ isSelected: true }) const [entry] = await snaptrude.design.doors.listCatalog() const [front, side] = await snaptrude.design.create.doors([ { familyId: entry.id, hostWall: wall, position: await v.new(2, 0, 5), label: \"D-01\" }, { familyId: entry.id, hostWall: wall, position: await v.new(6, 0, 5), values: { width: \"1200mm\" } }, ]) // The host still resolves after both cuts: const currentWall = await snaptrude.design.query.getHost(front) ```"
   },
   {
     "path": "design.create.floor",
@@ -4727,9 +4789,9 @@
       "Lay flooring across the selected outline",
       "Put a floor at this position with 150mm thickness\n\n# Example\n```ts\nconst rect = await snaptrude.core.geom.create.profileRect(5, 4)\nconst contour = await snaptrude.core.geom.create.contourFromProfile(rect)\nconst floor = await snaptrude.design.create.floor(contour, 0.1)\n```"
     ],
-    "argsType": "ContourHandle",
-    "resultType": "ComponentHandle",
-    "performance": "For MORE THAN ONE floor, call `design.create.floors(items[])` — one host round-trip and ONE undo entry for the whole batch. Looping this single-floor creator is N round-trips and N undo entries."
+    "argsType": "| [contour: ContourHandle, thickness: number, position?: Vec3Handle]\n      | [contour: ContourHandle, options: PluginFamilyFloorOptions]",
+    "resultType": "ComponentHandle[]",
+    "performance": "For dimensional floors, `design.create.floors(items[])` uses one host round-trip and one undo entry. That bulk method does not accept native family options; use this method for a family-backed floor."
   },
   {
     "path": "design.create.floors",
@@ -4841,14 +4903,14 @@
   {
     "path": "design.create.opening",
     "namespace": "design.create",
-    "summary": "Place a catalog **door or window** into a host wall with optional size overrides.",
+    "summary": "Place a parametric **door or window** into a host wall with parameter overrides.",
     "examplePrompts": [
       "Add a 1m wide door to this wall here",
       "Place a window with a 0.9m sill height on the selected wall"
     ],
     "argsType": "PluginDesignCreateOpeningOptions",
     "resultType": "ComponentHandle",
-    "performance": "Single-opening creator — use it for one hosted opening. For MORE THAN ONE, call `design.create.doors(items[])` / `design.create.windows(items[])`: the same per-item fields, one host round-trip, ONE undo entry. # Example ```ts const opening = await snaptrude.design.create.opening({ kind: \"window\", catalogId: windowType.id, hostWall: wall, position: await snaptrude.core.math.vec3.new(3, 0, 5), width: 1.2, height: 1.5, sillHeight: 0.9, }) ```"
+    "performance": "Single-opening creator — use it for one hosted opening. For MORE THAN ONE, call `design.create.doors(items[])` / `design.create.windows(items[])`: the same per-item fields, one host round-trip, ONE undo entry. # Example ```ts const opening = await snaptrude.design.create.opening({ kind: \"window\", familyId: windowType.id, hostWall: wall, position: await snaptrude.core.math.vec3.new(3, 0, 5), width: 1.2, height: 1.5, sillHeight: 0.9, }) ```"
   },
   {
     "path": "design.create.referenceLines",
@@ -4888,7 +4950,7 @@
       "Make a basement slab that extrudes downward",
       "Give this room outline a 6 inch slab\n\n# Example\n```ts\nconst rect = await snaptrude.core.geom.create.profileRect(12, 10)\nconst contour = await snaptrude.core.geom.create.contourFromProfile(rect)\nconst slab = await snaptrude.design.create.slab(contour, 0.15, \"down\", \"Plinth\")\n```"
     ],
-    "argsType": "ContourHandle",
+    "argsType": "| [\n          contour: ContourHandle,\n          thickness: number,\n          direction?: \"up\" | \"down\",\n          slabType?: PluginSlabType,\n        ]\n      | [contour: ContourHandle, options: PluginFamilySlabOptions]",
     "resultType": "ComponentHandle"
   },
   {
@@ -4950,6 +5012,39 @@
     "argsType": "PluginStaircasePreset",
     "resultType": "ComponentHandle"
   },
+  {
+    "path": "design.create.void",
+    "namespace": "design.create",
+    "summary": "Cut a **void** — a hole, opening or shaft — through an existing FLAT slab, floor, roof or ceiling. The void is a selectable child object of its host (the \"Void\" of the Draw Void tool). It always cuts the full host thickness. It can be moved with `design.transform.move` (a move that would leave the host is shortened without a report) and removed with `design.delete.entities`; to resize, delete it and cut a new one (`design.update.space` refuses a void).",
+    "examplePrompts": [
+      "Cut a hole in this slab",
+      "Add a 1.2m by 2.4m stair opening in the first-floor slab",
+      "Make a 600 x 600 service penetration in the floor for the riser",
+      "Put a skylight opening through the roof",
+      "Cut a round 1m duct hole in the slab",
+      "Make a cut-out in the ceiling for the light well",
+      "Add a double-height atrium void in the level 2 floor"
+    ],
+    "argsType": "ComponentHandle",
+    "resultType": "ComponentHandle",
+    "performance": "Single-void creator. For MORE THAN ONE void, call `design.create.voids(items[])`: one host round-trip, ONE undo entry, one cut per host."
+  },
+  {
+    "path": "design.create.voids",
+    "namespace": "design.create",
+    "summary": "Cut **many voids** (holes, openings, shafts) through slabs, floors, roofs and ceilings in one undoable operation (bulk plural of {@linkcode void}). Items may share a host or use different hosts — one shaft outline on every storey's slab AND floor is one call. Validate-all-or-throw: one item whose host does not contain the outline rejects the whole batch, so pass only the hosts that contain it; `details.itemIndex` names the failing item (for two overlapping items of the batch, the earlier one). At most 50 voids per host and 200 in all per call. Same outline rules as {@linkcode void}: plan outline, 25.4 mm (0.1 SU) clearance, floor AND slab are separate hosts. Call it as `snaptrude.design.create.voids(...)`.",
+    "examplePrompts": [
+      "Cut a lift shaft through every floor slab of the core",
+      "Cut a 2m x 2m shaft through all the slabs at this location",
+      "Make stair openings in all the floors above the staircases",
+      "Make holes in the roof for these three skylights",
+      "Cut openings in each storey's slab matching this outline",
+      "Punch the same riser penetration through every floor at once"
+    ],
+    "argsType": "PluginCreateVoidItem[]",
+    "resultType": "ComponentHandle[]",
+    "performance": "ONE host round-trip, ONE undo entry, ONE cut per host. Never call `void` in a loop. Runs synchronously on the main thread: 50 voids on one host take about 1 s, and the time grows with the number of hosts (caps: 50 per host, 200 per call)."
+  },
   {
     "path": "design.create.wallRuns",
     "namespace": "design.create",
@@ -4989,7 +5084,7 @@
   {
     "path": "design.create.window",
     "namespace": "design.create",
-    "summary": "Place a **window** from the catalog into a host wall.",
+    "summary": "Place a parametric **window** family into a host wall.",
     "examplePrompts": [
       "Add a window to this wall here",
       "Place a casement window on the selected wall",
@@ -5005,7 +5100,7 @@
   {
     "path": "design.create.windows",
     "namespace": "design.create",
-    "summary": "Place **many windows** into host walls in one undoable operation (bulk plural of {@linkcode window}). Each item carries its own catalog id, host wall, world position, and optional `facing`, `label`, `width`, `height` and `sillHeight` — the same fields as a `\"window\"` {@linkcode PluginDesignCreateOpeningOptions}. `sillHeight` is measured from the host wall base to the BOTTOM of the window. Validate-all-or-throw; one command.",
+    "summary": "Place **many windows** into host walls in one undoable operation (bulk plural of {@linkcode window}). Each item carries its own family id, host wall, world position, and optional `facing`, `label`, `width`, `height` and `sillHeight` — the same fields as a `\"window\"` {@linkcode PluginDesignCreateOpeningOptions}. `sillHeight` is measured from the host wall base to the BOTTOM of the window. Validate-all-or-throw; one command.",
     "examplePrompts": [
       "Add windows along this whole facade at once",
       "Place a window in every bedroom in one operation",
@@ -5015,7 +5110,7 @@
     ],
     "argsType": "PluginCreateWindowItem[]",
     "resultType": "ComponentHandle[]",
-    "performance": "Bulk creator — the whole batch is ONE host round-trip and ONE undo entry, and each distinct catalog source loads once. Always prefer this over calling `design.create.window` in a loop: build the full `items[]` array first (all host walls and points up front), then make one call. # Example ```ts const v = snaptrude.core.math.vec3 const [wall] = await snaptrude.design.query.listWalls({ isSelected: true }) const [casement] = await snaptrude.design.windows.listCatalog() const placed = await snaptrude.design.create.windows([ { catalogId: casement.id, hostWall: wall, position: await v.new(2, 0, 5), sillHeight: 0.9 }, { catalogId: casement.id, hostWall: wall, position: await v.new(5, 0, 5), sillHeight: 0.9 }, ]) const currentWall = await snaptrude.design.query.getHost(placed[0]) ```"
+    "performance": "Bulk creator — the whole batch is ONE host round-trip and ONE undo entry. Always prefer this over calling `design.create.window` in a loop: build the full `items[]` array first (all host walls and points up front), then make one call. # Example ```ts const v = snaptrude.core.math.vec3 const [wall] = await snaptrude.design.query.listWalls({ isSelected: true }) const [casement] = await snaptrude.design.windows.listCatalog() const placed = await snaptrude.design.create.windows([ { familyId: casement.id, hostWall: wall, position: await v.new(2, 0, 5), values: { sill: \"900mm\" } }, { familyId: casement.id, hostWall: wall, position: await v.new(5, 0, 5), values: { sill: \"900mm\" } }, ]) const currentWall = await snaptrude.design.query.getHost(placed[0]) ```"
   },
   {
     "path": "design.delete.entities",
@@ -5026,7 +5121,8 @@
       "Remove these walls from the model",
       "Get rid of this mass entirely",
       "Delete all the furniture I picked",
-      "Remove the door and window I just created"
+      "Remove the door and window I just created",
+      "Remove the void I cut in this slab"
     ],
     "argsType": "ComponentHandle[]",
     "resultType": "PluginDesignChangeResult",
@@ -5137,7 +5233,7 @@
   {
     "path": "design.doors.getDimensions",
     "namespace": "design.doors",
-    "summary": "Get a door's full dimensions in one call — width along the wall, vertical height, and thickness through the wall — measured in the door's local oriented space. Parity with {@linkcode PluginDesignWindowsApi.getDimensions}.",
+    "summary": "Get evaluated opening width/height and host thickness, in Snaptrude units. The opening can include allowances beyond the width/height input parameters.",
     "examplePrompts": [
       "What are the dimensions of this door?",
       "How big is the selected door?",
@@ -5176,7 +5272,7 @@
   {
     "path": "design.doors.getSupportFloor",
     "namespace": "design.doors",
-    "summary": "Get the floor a door is hosted on — the storey/level component that supports the door.",
+    "summary": "Returns null for recipe doors. Room floors own doorway infill; there is no separate support-floor entity.",
     "examplePrompts": [
       "Which floor is this door on?",
       "What storey does the selected door belong to?",
@@ -5189,7 +5285,7 @@
   {
     "path": "design.doors.getSwingDirection",
     "namespace": "design.doors",
-    "summary": "Get a door's swing (hinge) handedness. Stand on the side the door swings open to, facing the door: `'left'` when the hinged jamb is on your left, `'right'` when it is on your right. Derived from the placed mesh's orientation (the same reflection `mirror` and the `hinge` placement option apply), not a persisted field.",
+    "summary": "Read the saved hand parameter. left means local -X; right means local +X. Returns null when the recipe does not declare that control.",
     "examplePrompts": [
       "Which way does this door swing?",
       "Is the selected door left-handed or right-handed?",
@@ -5254,7 +5350,7 @@
   {
     "path": "design.doors.mirror",
     "namespace": "design.doors",
-    "summary": "Mirror a door about its own axes. `'x'` (default) flips the swing side — the door opens to the other side of the wall; `'z'` swaps the hinged jamb (left-hand ↔ right-hand, same swing side); `'y'` turns it upside down. Undoable as a single command.",
+    "summary": "Change authored controls in one undo step: x (default) toggles swing front/back; z toggles hand left/right. The recipe must declare these enums. Axis y rejects. No mesh reflection occurs. Recipes use outputs.swingSide (1 or -1) for the adjoining room's floor ownership. A door between two room floors requires this output; a missing or invalid report rejects the cut.",
     "examplePrompts": [
       "Flip this door's swing",
       "Mirror the selected door",
@@ -5305,6 +5401,46 @@
     "argsType": "ComponentHandle",
     "resultType": "OffsetSplitOutcome"
   },
+  {
+    "path": "design.electrical.context",
+    "namespace": "design.electrical",
+    "summary": "Read the active proposal's architectural context before authoring. Keep one revision across pages.",
+    "examplePrompts": [],
+    "argsType": "z.input<typeof NetworkContextArgs>",
+    "resultType": "NetworkContextResult"
+  },
+  {
+    "path": "design.electrical.create",
+    "namespace": "design.electrical",
+    "summary": "Construct each node on its authored storey, with one undo command and queued project persistence. Networks can span storeys. Reuse requestId on retry; components returns the durable node mapping. Coordinates are world millimetres, Y-up; rotations are degrees. No engineering rules are inferred. Throws for stale architecture, invalid references/geometry or conflicting retries.",
+    "examplePrompts": [],
+    "argsType": "z.input<typeof NetworkCreateArgs>",
+    "resultType": "NetworkCreateResult"
+  },
+  {
+    "path": "design.electrical.get",
+    "namespace": "design.electrical",
+    "summary": "Read one saved graph in the active proposal; null on miss. IDs are durable, not worker handles.",
+    "examplePrompts": [],
+    "argsType": "z.input<typeof NetworkGetArgs>",
+    "resultType": "SavedNetworkGraph | null"
+  },
+  {
+    "path": "design.electrical.query",
+    "namespace": "design.electrical",
+    "summary": "Read bounded authored topology in graph revision. Crossings do not connect. No clash/compliance claims.",
+    "examplePrompts": [],
+    "argsType": "z.input<typeof NetworkQueryArgs>",
+    "resultType": "NetworkQueryResult"
+  },
+  {
+    "path": "design.electrical.validate",
+    "namespace": "design.electrical",
+    "summary": "Validate authored JSON, pinned families and recipe evaluation without placing or saving anything. This does not build kernel meshes or certify engineering/code compliance.",
+    "examplePrompts": [],
+    "argsType": "z.input<typeof NetworkValidateArgs>",
+    "resultType": "NetworkValidation"
+  },
   {
     "path": "design.erase.edge",
     "namespace": "design.erase",
@@ -5335,7 +5471,7 @@
   {
     "path": "design.family.create",
     "namespace": "design.family",
-    "summary": "Save the prepared bundle to the library — the user's personal library unless `teamId` is given. {@linkcode PluginDesignFamilyApi.place} already saves, so `create` is for sharing with a team. When nothing of the family is in the model yet, one instance is also dropped at the centre of the current view on the active storey (`placed: true`), so a save is never invisible.",
+    "summary": "Save the prepared bundle to the library — the user's personal library unless `teamId` is given. {@linkcode PluginDesignFamilyApi.place} already saves generic components. Hosted doors/windows save without placement; they need a wall and position through `design.create.door` / `design.create.window`. For a non-hosted family with no placed instance, saving also drops one standalone sample at the current view centre on the active storey (`placed: true`). This includes architectural families: the sample does not assign a family to a native host.",
     "examplePrompts": [
       "Save this as a family called Vertical Louvre",
       "Add it to my library\n\n# Example\n```ts\nconst { definitionId } = await snaptrude.design.family.create({ name: \"Louvre Screen\" })\n```"
@@ -5351,7 +5487,7 @@
       "Delete the Louvre Screen family from my library",
       "Get rid of that bollard and every copy of it in here\n\n# Example\n```ts\nawait snaptrude.design.family.delete({ id: \"revit:steel-bollard~bef047\" })\nawait snaptrude.design.family.delete({ id: \"revit:steel-bollard~bef047\", instances: true })\n```"
     ],
-    "argsType": "PluginDesignFamilyDeleteArgs",
+    "argsType": "PluginDesignFamilyDeleteArgs | string",
     "resultType": "PluginFamilyDeleteResult"
   },
   {
@@ -5368,10 +5504,32 @@
   {
     "path": "design.family.get",
     "namespace": "design.family",
-    "summary": "The prepared family's spec bundle, or `null` when nothing is prepared.",
+    "summary": "A family's spec bundle: the prepared draft's, or — to CHANGE a saved family — that family's recipe, opened as the new draft.",
+    "examplePrompts": [
+      "Make the chairs I placed 50 mm wider",
+      "Change the Louvre Screen family so its blades are deeper\n\n# Example\n```ts\nconst draft = await snaptrude.design.family.get()\nconst family = await snaptrude.design.family.get({ component })\n// family.editing → { familyId, version, name, library }\n```"
+    ],
+    "argsType": "PluginDesignFamilyGetArgs | string",
+    "resultType": "PluginFamilyGetResult | null"
+  },
+  {
+    "path": "design.family.getDefinition",
+    "namespace": "design.family",
+    "summary": "Read one saved catalog definition without opening a draft or placing geometry. Both id and version are required. The catalog checks access on every read. Length defaults and bounds are in mm, ready for network graph overrides; angle parameters retain degrees, identified by each parameter's unit. existing getParameters/place/setParameters continue to use Snaptrude units. Defaults include current catalog overrides, which can change without a new version. No scene, registry, history, or persistence state is changed. Missing/inaccessible pins and invalid recipes fail; no latest-version fallback. This metadata does not certify connectors or engineering compatibility.",
     "examplePrompts": [],
-    "argsType": null,
-    "resultType": "PluginFamilyBundle | null"
+    "argsType": "PluginDesignFamilyGetDefinitionArgs",
+    "resultType": "PluginFamilyDefinition"
+  },
+  {
+    "path": "design.family.getExamples",
+    "namespace": "design.family",
+    "summary": "Worked example families to learn from: real, tested bundles by discipline (architecture, structure, MEP, furniture). With no `id`, returns the catalogue — each example's id, label, discipline and the patterns it teaches — filtered by `discipline` / `tag` when given. With an `id`, returns that example's full bundle. Fetch the one closest to the task before authoring and borrow its patterns; examples are patterns to combine, not templates to copy whole.",
+    "examplePrompts": [
+      "Show me an example of a structural family",
+      "How is a hosted door family written?\n\n# Example\n```ts\nconst list = await snaptrude.design.family.getExamples({ discipline: \"mep\" })\nconst ex = await snaptrude.design.family.getExamples({ id: list[0].id })\n```"
+    ],
+    "argsType": "PluginDesignFamilyGetExamplesArgs | string",
+    "resultType": "PluginFamilyExampleSummary[] | PluginFamilyExample"
   },
   {
     "path": "design.family.getParameters",
@@ -5392,19 +5550,43 @@
       "How do I write a parametric family spec?",
       "Show me the family DSL\n\n# Example\n```ts\nconst { reference } = await snaptrude.design.family.getReference()\n```"
     ],
-    "argsType": null,
+    "argsType": "PluginDesignFamilyGetReferenceArgs | PluginFamilyReferenceSection",
     "resultType": "PluginFamilyReference"
   },
+  {
+    "path": "design.family.getTemplate",
+    "namespace": "design.family",
+    "summary": "Get a validated starter recipe for a door or window, with an opening contract, host wall-thickness binding and role-named parts. Edit profiles, panels, glazing, hardware and materials while preserving the contract. Use `prepare` / `flex` to check the recipe, then `create` to save it and `design.create.door(familyId, hostWall, position, { version, values }, facing)` (or `window`) to place it. Edit the resulting ParametricComponent through `getParameters` / `setParameters`, not a separate opening API.",
+    "examplePrompts": [],
+    "argsType": "PluginDesignFamilyGetTemplateArgs",
+    "resultType": "PluginFamilyTemplateResult"
+  },
   {
     "path": "design.family.list",
     "namespace": "design.family",
-    "summary": "Every parametric family registered in this session — native and imported.",
+    "summary": "Every available parametric family, merging the session registry and catalog.",
     "examplePrompts": [
       "What families are available?\n\n# Example\n```ts\nconst families = await snaptrude.design.family.list()\n```"
     ],
-    "argsType": null,
+    "argsType": "PluginDesignFamilyListArgs & { compact: true }",
+    "resultType": "string[]"
+  },
+  {
+    "path": "design.family.list",
+    "namespace": "design.family",
+    "summary": "",
+    "examplePrompts": [],
+    "argsType": "PluginDesignFamilyListArgs & { compact?: false }",
     "resultType": "PluginFamilySummary[]"
   },
+  {
+    "path": "design.family.list",
+    "namespace": "design.family",
+    "summary": "",
+    "examplePrompts": [],
+    "argsType": "PluginDesignFamilyListArgs",
+    "resultType": "PluginFamilySummary[] | string[]"
+  },
   {
     "path": "design.family.place",
     "namespace": "design.family",
@@ -5412,7 +5594,7 @@
     "examplePrompts": [
       "Place it in the model",
       "Put a louvre screen at the origin",
-      "Copy that table two metres to the right\n\n# Example\n```ts\n// positioned — geometry exists when this resolves\nconst { component } = await snaptrude.design.family.place({\nid: \"revit:gypsum-stud-partition~90ad72\",\nposition: { x: 0, y: 0, z: 0 },\nrotation: 90,\n})\nawait snaptrude.design.transform.move([component], { x: 2, y: 0, z: 0 })\n\n// interactive — the user clicks\nawait snaptrude.design.family.place()\n```"
+      "Copy that table two metres to the right\n\n# Example\n```ts\n// positioned — geometry exists when this resolves\nconst { component } = await snaptrude.design.family.place({\nid: \"revit:gypsum-stud-partition~90ad72\",\nposition: { x: 0, y: 0, z: 0 },\nrotation: 90,\n})\nawait snaptrude.design.transform.move([component], { x: 2, y: 0, z: 0 })\n\n// interactive — the user clicks\nawait snaptrude.design.family.place()\n\n// hosted — a door in a wall, near a point along it\nawait snaptrude.design.family.place({ id: doorId, host: wall, position: { x: 3, y: 0, z: 0 } })\n```"
     ],
     "argsType": "PluginDesignFamilyPlaceArgs",
     "resultType": "PluginFamilyPlaceResult"
@@ -5436,7 +5618,7 @@
     "summary": "Change a placed component's parameters and rebuild its geometry in place.",
     "examplePrompts": [
       "Make that table seat 8",
-      "Change the stud spacing to 400\n\n# Example\n```ts\nawait snaptrude.design.family.setParameters({ component, values: { seats: 8 } })\n```"
+      "Change the stud spacing to 400\n\n# Example\n```ts\nawait snaptrude.design.family.setParameters({ component, values: { seats: 8 } })\nawait snaptrude.design.family.setParameters({ component, children: { chair: { width: \"380mm\" } } })\nawait snaptrude.design.family.setParameters({\ncomponent: railing,\nlinks: { steps: { from: stair, expr: \"steps\" }, side: { from: stair, expr: \"width - 40mm\" } },\n})\nawait snaptrude.design.family.setParameters({\ncomponent: post,\nrelations: { add: [{ kind: \"attach\", side: \"top\", to: slab, bind: { height: \"reach\" } }] },\n})\n```"
     ],
     "argsType": "PluginDesignFamilySetParametersArgs",
     "resultType": "PluginFamilyInstanceParameters"
@@ -5847,6 +6029,86 @@
     "argsType": "ComponentHandle",
     "resultType": "PluginMaterialResult"
   },
+  {
+    "path": "design.mechanical.context",
+    "namespace": "design.mechanical",
+    "summary": "Read the active proposal's architectural context before authoring. Keep one revision across pages.",
+    "examplePrompts": [],
+    "argsType": "z.input<typeof NetworkContextArgs>",
+    "resultType": "NetworkContextResult"
+  },
+  {
+    "path": "design.mechanical.create",
+    "namespace": "design.mechanical",
+    "summary": "Construct each node on its authored storey, with one undo command and queued project persistence. Networks can span storeys. Reuse requestId on retry; components returns the durable node mapping. Coordinates are world millimetres, Y-up; rotations are degrees. No engineering rules are inferred. Throws for stale architecture, invalid references/geometry or conflicting retries.",
+    "examplePrompts": [],
+    "argsType": "z.input<typeof NetworkCreateArgs>",
+    "resultType": "NetworkCreateResult"
+  },
+  {
+    "path": "design.mechanical.get",
+    "namespace": "design.mechanical",
+    "summary": "Read one saved graph in the active proposal; null on miss. IDs are durable, not worker handles.",
+    "examplePrompts": [],
+    "argsType": "z.input<typeof NetworkGetArgs>",
+    "resultType": "SavedNetworkGraph | null"
+  },
+  {
+    "path": "design.mechanical.query",
+    "namespace": "design.mechanical",
+    "summary": "Read bounded authored topology in graph revision. Crossings do not connect. No clash/compliance claims.",
+    "examplePrompts": [],
+    "argsType": "z.input<typeof NetworkQueryArgs>",
+    "resultType": "NetworkQueryResult"
+  },
+  {
+    "path": "design.mechanical.validate",
+    "namespace": "design.mechanical",
+    "summary": "Validate authored JSON, pinned families and recipe evaluation without placing or saving anything. This does not build kernel meshes or certify engineering/code compliance.",
+    "examplePrompts": [],
+    "argsType": "z.input<typeof NetworkValidateArgs>",
+    "resultType": "NetworkValidation"
+  },
+  {
+    "path": "design.plumbing.context",
+    "namespace": "design.plumbing",
+    "summary": "Read the active proposal's architectural context before authoring. Keep one revision across pages.",
+    "examplePrompts": [],
+    "argsType": "z.input<typeof NetworkContextArgs>",
+    "resultType": "NetworkContextResult"
+  },
+  {
+    "path": "design.plumbing.create",
+    "namespace": "design.plumbing",
+    "summary": "Construct each node on its authored storey, with one undo command and queued project persistence. Networks can span storeys. Reuse requestId on retry; components returns the durable node mapping. Coordinates are world millimetres, Y-up; rotations are degrees. No engineering rules are inferred. Throws for stale architecture, invalid references/geometry or conflicting retries.",
+    "examplePrompts": [],
+    "argsType": "z.input<typeof NetworkCreateArgs>",
+    "resultType": "NetworkCreateResult"
+  },
+  {
+    "path": "design.plumbing.get",
+    "namespace": "design.plumbing",
+    "summary": "Read one saved graph in the active proposal; null on miss. IDs are durable, not worker handles.",
+    "examplePrompts": [],
+    "argsType": "z.input<typeof NetworkGetArgs>",
+    "resultType": "SavedNetworkGraph | null"
+  },
+  {
+    "path": "design.plumbing.query",
+    "namespace": "design.plumbing",
+    "summary": "Read bounded authored topology in graph revision. Crossings do not connect. No clash/compliance claims.",
+    "examplePrompts": [],
+    "argsType": "z.input<typeof NetworkQueryArgs>",
+    "resultType": "NetworkQueryResult"
+  },
+  {
+    "path": "design.plumbing.validate",
+    "namespace": "design.plumbing",
+    "summary": "Validate authored JSON, pinned families and recipe evaluation without placing or saving anything. This does not build kernel meshes or certify engineering/code compliance.",
+    "examplePrompts": [],
+    "argsType": "z.input<typeof NetworkValidateArgs>",
+    "resultType": "NetworkValidation"
+  },
   {
     "path": "design.query.exists",
     "namespace": "design.query",
@@ -5969,12 +6231,13 @@
   {
     "path": "design.query.getHost",
     "namespace": "design.query",
-    "summary": "Get an entity's host/parent entity (e.g. the wall a door is cut into).",
+    "summary": "Get an entity's host/parent entity (e.g. the wall a door is cut into, or the slab, floor, roof or ceiling a void is cut through).",
     "examplePrompts": [
       "Which wall is this door in?",
       "Find the parent of the selected window",
       "What is this element attached to?",
-      "Which wall hosts this window?\n\n# Example\n```ts\n// From a door up to its host wall, then measure the wall\nconst [door] = await snaptrude.design.query.listDoors({ isSelected: true })\nconst hostWall = door ? await snaptrude.design.query.getHost(door) : null\nif (hostWall) {\nconst m = await snaptrude.design.query.measure(hostWall)\nconsole.log(\"wall length:\", m?.length)\n}\n```"
+      "Which wall hosts this window?",
+      "Which slab is this shaft in?\n\n# Example\n```ts\n// From a door up to its host wall, then measure the wall\nconst [door] = await snaptrude.design.query.listDoors({ isSelected: true })\nconst hostWall = door ? await snaptrude.design.query.getHost(door) : null\nif (hostWall) {\nconst m = await snaptrude.design.query.measure(hostWall)\nconsole.log(\"wall length:\", m?.length)\n}\n```"
     ],
     "argsType": "ComponentHandle",
     "resultType": "ComponentHandle | null"
@@ -6088,12 +6351,13 @@
   {
     "path": "design.query.listChildren",
     "namespace": "design.query",
-    "summary": "List an entity's direct child entities — for example the doors and windows hosted in a wall.",
+    "summary": "List an entity's direct child entities — for example the doors and windows hosted in a wall, or the voids (holes, shafts, openings) cut in a slab, floor, roof or ceiling by `design.create.void`.",
     "examplePrompts": [
       "What's inside this wall — list its doors and windows",
       "Show the child elements of the selected object",
       "Which openings belong to this wall?",
-      "List everything nested under this mass\n\n# Example\n```ts\n// Count the openings hosted in a wall, split by kind\nconst children = await snaptrude.design.query.listChildren(wall)\nlet doors = 0\nlet windows = 0\nfor (const child of children) {\nconst kind = await snaptrude.design.query.getEntityType(child)\nif (kind === \"door\") doors++\nif (kind === \"window\") windows++\n}\n```"
+      "List everything nested under this mass",
+      "List all holes in this slab\n\n# Example\n```ts\n// Count the openings hosted in a wall, split by kind\nconst children = await snaptrude.design.query.listChildren(wall)\nlet doors = 0\nlet windows = 0\nfor (const child of children) {\nconst kind = await snaptrude.design.query.getEntityType(child)\nif (kind === \"door\") doors++\nif (kind === \"window\") windows++\n}\n```"
     ],
     "argsType": "ComponentHandle",
     "resultType": "ComponentHandle[]"
@@ -6522,14 +6786,14 @@
   {
     "path": "design.types.get",
     "namespace": "design.types",
-    "summary": "Get one building type by its `\"<kind>:<name>\"` id — its labelled layer stack (each layer's role, thickness and material) plus the summed total thickness.",
+    "summary": "Get one building type by its legacy id or exact native wall pin — its labelled layer stack (each layer's role, thickness and material) plus the summed total thickness.",
     "examplePrompts": [
       "What layers make up this wall type?",
       "Show the construction of the exposed-concrete wall",
       "What's the total thickness of this slab type?",
-      "Which materials are in this roof assembly?\n\n# Example\n```ts\nconst [first] = await snaptrude.design.types.list(\"wall\")\nconst type = await snaptrude.design.types.get(first.id)\nif (type) for (const layer of type.layers) console.log(layer.name, layer.thickness)\n```"
+      "Which materials are in this roof assembly?\n\n# Example\n```ts\nconst [first] = await snaptrude.design.types.list(\"wall\")\nconst type = await snaptrude.design.types.get(first.nativeFamily ?? first.id)\nif (type) for (const layer of type.layers) console.log(layer.name, layer.thickness)\n```"
     ],
-    "argsType": "string",
+    "argsType": "PluginWallType",
     "resultType": "PluginBuildingType | null"
   },
   {
@@ -6571,6 +6835,14 @@
     "argsType": "ComponentHandle[]",
     "resultType": "PluginDesignChangeResult"
   },
+  {
+    "path": "design.update.beam",
+    "namespace": "design.update",
+    "summary": "Replace a native beam family while preserving its authored axis. Values use mm/degrees.",
+    "examplePrompts": [],
+    "argsType": "ComponentHandle",
+    "resultType": "PluginDesignChangeResult"
+  },
   {
     "path": "design.update.buildableEnvelope",
     "namespace": "design.update",
@@ -6596,6 +6868,14 @@
     "argsType": "ComponentHandle",
     "resultType": "PluginDesignChangeResult"
   },
+  {
+    "path": "design.update.column",
+    "namespace": "design.update",
+    "summary": "Replace a native column family while preserving its authored axis. Values use mm/degrees.",
+    "examplePrompts": [],
+    "argsType": "ComponentHandle",
+    "resultType": "PluginDesignChangeResult"
+  },
   {
     "path": "design.update.floor",
     "namespace": "design.update",
@@ -6863,7 +7143,7 @@
   {
     "path": "design.windows.getDimensions",
     "namespace": "design.windows",
-    "summary": "Get a window's full dimensions in one call — width along the wall, vertical height, and thickness through the wall — measured in the window's local oriented space.",
+    "summary": "Get evaluated opening width/height and host thickness in Snaptrude units. The opening can differ from the width/height input parameters.",
     "examplePrompts": [
       "What are the dimensions of this window?",
       "How big is the selected window?",
@@ -7369,7 +7649,7 @@
       "Add a red arrow from the title to the plan view",
       "Point an arrow at the top-left view on the cover sheet\n\n# Example\n```ts\nconst { shapeId } = await snaptrude.presentation.annotate.arrow(\n\"sheet_1\",\n{ x: 100, y: 200 },\n{ x: 300, y: 250 },\n{ color: \"red\" },\n)\n```"
     ],
-    "argsType": "string",
+    "argsType": "string | undefined",
     "resultType": "PluginPresentationAnnotateResult"
   },
   {
@@ -7381,7 +7661,7 @@
       "Put a yellow note on the cover sheet",
       "Leave a note next to the ground floor plan\n\n# Example\n```ts\nconst { shapeId } = await snaptrude.presentation.annotate.note(\n\"sheet_1\",\n\"Review this wall\",\n{ position: { x: 60, y: 120 }, color: \"yellow\" },\n)\n```"
     ],
-    "argsType": "string",
+    "argsType": "string | undefined",
     "resultType": "PluginPresentationAnnotateResult"
   },
   {
@@ -7393,7 +7673,7 @@
       "Add a red rectangle highlight to the sheet",
       "Draw an ellipse around the entrance on the cover sheet\n\n# Example\n```ts\nconst { shapeId } = await snaptrude.presentation.annotate.shape(\n\"sheet_1\",\n\"cloud\",\n{ x: 80, y: 80, w: 240, h: 160 },\n{ color: \"red\" },\n)\n```"
     ],
-    "argsType": "string",
+    "argsType": "string | undefined",
     "resultType": "PluginPresentationAnnotateResult"
   },
   {
@@ -7406,7 +7686,7 @@
       "Caption this view with \"Proposed layout\"",
       "Put a red note on the sheet\n\n# Example\n```ts\nconst { shapeId } = await snaptrude.presentation.annotate.text(\n\"sheet_1\",\n\"Ground Floor\",\n{ position: { x: 40, y: 40 }, size: \"xl\", color: \"blue\" },\n)\n```"
     ],
-    "argsType": "string",
+    "argsType": "string | undefined",
     "resultType": "PluginPresentationAnnotateTextResult"
   },
   {
@@ -7509,20 +7789,325 @@
     "argsType": "string",
     "resultType": "PluginPresentationDiagramsPlaceResult"
   },
+  {
+    "path": "presentation.drawings.applyPreset",
+    "namespace": "presentation.drawings",
+    "summary": "Bind a native kernel plan to a view preset and clear its declared overrides, so it takes the preset's styles. Local title, proposal and building text is kept. One Present undo step. Presets apply only to drawings whose `getCapabilities(drawingId).presets` is `true`.",
+    "examplePrompts": [
+      "Apply the presentation plan preset to this drawing",
+      "Use the Planning Issue style on every plan drawing",
+      "Make this drawing look like the other plans\n\n# Example\n```ts\nconst presets = await snaptrude.presentation.viewPresets.list()\nconst preset = presets.find((each) => each.name === \"Planning Issue\")\nif (preset) await snaptrude.presentation.drawings.applyPreset(drawing.id, preset.id)\n```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginDrawing"
+  },
+  {
+    "path": "presentation.drawings.copy",
+    "namespace": "presentation.drawings",
+    "summary": "Duplicate a drawing with its labels and annotations (native duplication, offset slightly from the original). One Present undo step. The copy keeps the original's source view, scale, crop, styles and preset binding.",
+    "examplePrompts": [
+      "Duplicate this drawing",
+      "Make a copy of the ground floor plan drawing",
+      "Copy this drawing so I can try a different style\n\n# Example\n```ts\nconst copy = await snaptrude.presentation.drawings.copy(drawing.id)\nawait snaptrude.presentation.drawings.rename(copy.id, \"Ground Floor (option B)\")\n```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginDrawing"
+  },
+  {
+    "path": "presentation.drawings.create",
+    "namespace": "presentation.drawings",
+    "summary": "Generate a drawing from a saved view. Creates the drawing beside its source view on the canvas, never on a sheet; to put a drawing on a sheet use `presentation.sheets.place(sheetId, viewId)` (fits it to the sheet) or `presentation.sheets.placeDrawing(sheetId, drawingId)` (moves this drawing onto the sheet, scaled down to fit). Omit `position` unless the user asked for a specific place: the host puts the new drawing next to its source view, clear of other drawings. An explicit `position` (page coordinates, the drawing's centre) is kept and can land on top of an existing drawing. The user's selection is left as it was. Changes the drawing, not the Present camera. The Present view may follow the drawing as a courtesy to a user watching (never zooming in, not while the camera is locked); to look at it, call `presentation.camera.zoomTo(drawing.id)` then `presentation.camera.capture()`. `scale` must be a standard architectural scale denominator (100 means 1:100) in the project's unit system; any other value is rejected. Metric: 10, 20, 50, 100, 150, 200, 250, 500, 1000. Imperial detail: 12, 16, 24, 32, 48, 64, 96, 128, 192, 384, 768, 1536 (1\" = 1' to 1/128\" = 1'; 48 is 1/4\" = 1', 96 is 1/8\" = 1'). Imperial site: 120, 240, 360, 480, 600, 1200, 2400, 3600, 4800 (1\" = 10' to 1\" = 400'). Pick the LARGEST standard scale (smallest denominator) at which the view still fits its frame or sheet and its room labels stay readable: for a building floor plan that is usually 1:50 to 1:200 (1/4\" = 1' to 1/16\" = 1'). Never use a site-sized scale (1:500 and up, 1/64\" = 1' (768) and smaller, 1\" = 20' (240) and up) for a single building plan unless the user asked for it. `scale` applies to plans, site plans and elevations; leave it out for a 3D view. After creating, read `labels.getLayout(drawingId)`: when labels are unplaced and carry a `suggestedScale`, move to that larger scale with `setScale`. To apply a preset, create first and then call `applyPreset`.",
+    "examplePrompts": [
+      "Create a drawing from the ground floor view",
+      "Make a 1:100 plan drawing of level 2",
+      "Draw the north elevation at 1/8\" = 1'",
+      "Put the site plan view on the Present canvas as a drawing\n\n# Example\n```ts\nconst { views } = await snaptrude.presentation.views.list()\nconst plan = views.find((view) => view.kind === \"plan\")!\nconst drawing = await snaptrude.presentation.drawings.create(plan.id, { scale: 100 })\nawait snaptrude.presentation.camera.zoomTo(drawing.id)\nconst { image } = await snaptrude.presentation.camera.capture()\n// To put it on a sheet: await snaptrude.presentation.sheets.placeDrawing(sheet.id, drawing.id)\n```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginDrawing"
+  },
+  {
+    "path": "presentation.drawings.delete",
+    "namespace": "presentation.drawings",
+    "summary": "Delete a drawing with its labels and annotations, as one Present undo step. The source saved view is not deleted.",
+    "examplePrompts": [
+      "Delete this drawing",
+      "Remove the old elevation drawing from the canvas",
+      "Get rid of the duplicate plan drawing\n\n# Example\n```ts\nawait snaptrude.presentation.drawings.delete(drawing.id)\n```"
+    ],
+    "argsType": "string",
+    "resultType": "void"
+  },
+  {
+    "path": "presentation.drawings.export",
+    "namespace": "presentation.drawings",
+    "summary": "Export one drawing, with its labels and annotations, without a sheet. PDF size follows the drawing's canvas bounds; SVG and PDF keep vector content, raster fallbacks stay raster. `resolution` applies to raster formats. It does not wait for the canvas to paint, so it works while the user is on another browser tab. `download: true` starts a browser download and returns metadata only (never send large base64 to an agent); otherwise `files` carry `dataBase64`. `downloadStarted` means initiated, not proof of an OS-saved file. Layout warnings are returned. `fileName` is a base name WITHOUT an extension (\"Floor Pattern View\", never \"Floor Pattern View.pdf\"): the host appends .pdf/.svg/.png/.jpg for the format, and a name ending in .pdf, .svg, .png, .jpg or .jpeg, a dot or a space is rejected.",
+    "examplePrompts": [
+      "Export this drawing as a PDF",
+      "Download the ground floor plan drawing as an SVG",
+      "Save this drawing as a high-resolution PNG\n\n# Example\n```ts\nawait snaptrude.presentation.drawings.getStatus(drawing.id, { waitMs: 10_000 })\nconst result = await snaptrude.presentation.drawings.export(drawing.id, \"pdf\", {\nfileName: \"Ground Floor Plan\",\ndownload: true,\n})\n```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginDrawingExportResult"
+  },
+  {
+    "path": "presentation.drawings.get",
+    "namespace": "presentation.drawings",
+    "summary": "Read one drawing by its stable id.",
+    "examplePrompts": [
+      "Does the ground floor drawing still exist?",
+      "What preset is this drawing using?",
+      "Read the scale and crop of this drawing\n\n# Example\n```ts\nconst current = await snaptrude.presentation.drawings.get(drawing.id)\nif (current) console.log(current.scale, current.presetId)\n```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginDrawing | null"
+  },
+  {
+    "path": "presentation.drawings.getCapabilities",
+    "namespace": "presentation.drawings",
+    "summary": "Read what a drawing supports: its actual renderer, whether it takes presets (native kernel plans only), label layout and an architectural scale, the standard scales for this project, and its export formats. Read this before preset, scale, label-layout, style or export writes instead of inferring support from the source view.",
+    "examplePrompts": [
+      "What editing capabilities does this drawing support?",
+      "Can I apply a preset to this drawing?",
+      "Which scales can this drawing use?\n\n# Example\n```ts\nconst capabilities = await snaptrude.presentation.drawings.getCapabilities(drawing.id)\nif (capabilities.presets) {\nawait snaptrude.presentation.drawings.applyPreset(drawing.id, preset.id)\n}\n```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginDrawingCapabilities"
+  },
+  {
+    "path": "presentation.drawings.getStatus",
+    "namespace": "presentation.drawings",
+    "summary": "Read a drawing's generation, label-layout and asset-upload state, optionally waiting up to `waitMs` (0 by default, at most 30,000) for it to become export-ready and uploaded. A timeout is not an error: the current state is returned. Read this before export or before closing Present mode.",
+    "examplePrompts": [
+      "Is this drawing ready to export?",
+      "Wait for the new drawing to finish generating",
+      "Has the drawing been uploaded yet?\n\n# Example\n```ts\nconst status = await snaptrude.presentation.drawings.getStatus(drawing.id, {\nwaitMs: 10_000,\n})\nif (!status.exportReady) console.warn(status.warnings)\n```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginDrawingStatus"
+  },
+  {
+    "path": "presentation.drawings.getStyles",
+    "namespace": "presentation.drawings",
+    "summary": "Read a drawing's effective style categories (preset plus its own overrides) and the controls each category accepts. Always read this before {@linkcode PluginPresentationDrawingsApi.updateStyles}: accepted categories and controls depend on the drawing, and an `absent` category rejects writes. Do not echo a whole `settings` record as a patch (legacy reads may include the read-only `disable` flag and `-1` for unset opacity).",
+    "examplePrompts": [
+      "Show the editable styles for this drawing",
+      "What line weight are the walls drawn with?",
+      "Which categories can I restyle on this plan?\n\n# Example\n```ts\nconst styles = await snaptrude.presentation.drawings.getStyles(drawing.id)\nconst editable = styles.categories.filter((row) => !row.absent)\n```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginDrawingStyles"
+  },
+  {
+    "path": "presentation.drawings.labels.getLayout",
+    "namespace": "presentation.drawings.labels",
+    "summary": "Read the label-layout diagnostics of a drawing: labels that could not be placed cleanly (each with a `suggestedScale` at which it would fit), pinned labels, merged duplicates and dropped rows. Reading never hides a label: an unplaced label is still shown at a best-effort position.",
+    "examplePrompts": [
+      "Check this drawing for overlapping labels",
+      "Do all the room names fit on the ground floor drawing?",
+      "Which scale would make the labels on this plan readable?\n\n# Example\n```ts\nconst layout = await snaptrude.presentation.drawings.labels.getLayout(drawing.id)\nconst suggested = layout.unplaced.find((row) => row.suggestedScale)?.suggestedScale\nif (suggested) await snaptrude.presentation.drawings.setScale(drawing.id, suggested)\n```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginDrawingLabelLayout"
+  },
+  {
+    "path": "presentation.drawings.labels.list",
+    "namespace": "presentation.drawings.labels",
+    "summary": "List every text label on a drawing, including labels the user or the layout has hidden. An agent's own annotations under the drawing are not labels and are not listed.",
+    "examplePrompts": [
+      "List all labels in this drawing",
+      "Which room labels are hidden on the ground floor drawing?",
+      "Show me the text of every label on this plan\n\n# Example\n```ts\nconst labels = await snaptrude.presentation.drawings.labels.list(drawing.id)\nconst hidden = labels.filter((label) => label.hidden)\n```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginPlacedViewLabel[]"
+  },
+  {
+    "path": "presentation.drawings.labels.move",
+    "namespace": "presentation.drawings.labels",
+    "summary": "Move a label within its drawing. A room label keeps the new position as a native pin at the drawing's current architectural scale; other labels move as plain text shapes. One Present undo step.",
+    "examplePrompts": [
+      "Move the Kitchen label up a little",
+      "Put the living room name in the middle of the room",
+      "Nudge this label to the left\n\n# Example\n```ts\nconst [label] = await snaptrude.presentation.drawings.labels.list(drawing.id)\nawait snaptrude.presentation.drawings.labels.move(label.labelId, {\nx: label.position.x,\ny: label.position.y - 20,\n})\n```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginPlacedViewLabel"
+  },
+  {
+    "path": "presentation.drawings.labels.place",
+    "namespace": "presentation.drawings.labels",
+    "summary": "Pin a room label that could not be placed cleanly at the best position the native layout solver finds, at the current architectural scale. May wait up to ten seconds for a reloaded drawing's fit data. One Present undo step.",
+    "examplePrompts": [
+      "Place the labels that do not fit",
+      "Pin the Kitchen label where it fits best",
+      "Fix the overlapping room names on this drawing\n\n# Example\n```ts\nconst { unplaced } = await snaptrude.presentation.drawings.labels.getLayout(drawing.id)\nfor (const row of unplaced) {\nawait snaptrude.presentation.drawings.labels.place(row.labelId)\n}\n```"
+    ],
+    "argsType": "string",
+    "resultType": "boolean"
+  },
+  {
+    "path": "presentation.drawings.labels.reset",
+    "namespace": "presentation.drawings.labels",
+    "summary": "Clear room-label pins (from `move`, `place` or the user) so the native layout places those labels again: at the current architectural scale by default, or at every scale with `{ scope: \"all\" }`. One Present undo step.",
+    "examplePrompts": [
+      "Reset the label positions on this drawing",
+      "Undo all my label moves at every scale",
+      "Let the room labels lay themselves out again\n\n# Example\n```ts\nconst cleared = await snaptrude.presentation.drawings.labels.reset(drawing.id, {\nscope: \"all\",\n})\n```"
+    ],
+    "argsType": "string",
+    "resultType": "number"
+  },
+  {
+    "path": "presentation.drawings.labels.setHidden",
+    "namespace": "presentation.drawings.labels",
+    "summary": "Hide or show a label. This is the user's own visibility, independent of labels the layout or a crop hides. One Present undo step.",
+    "examplePrompts": [
+      "Hide the Store label on this drawing",
+      "Show the corridor label again",
+      "Turn off the label for the plant room\n\n# Example\n```ts\nconst labels = await snaptrude.presentation.drawings.labels.list(drawing.id)\nconst store = labels.find((label) => label.text.startsWith(\"Store\"))\nif (store) await snaptrude.presentation.drawings.labels.setHidden(store.labelId, true)\n```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginPlacedViewLabel"
+  },
+  {
+    "path": "presentation.drawings.list",
+    "namespace": "presentation.drawings",
+    "summary": "List the drawings on the current Present page, loose or on sheets.",
+    "examplePrompts": [
+      "List all drawings in this presentation",
+      "Which drawings are not on a sheet yet?",
+      "What scale is each plan drawing at?\n\n# Example\n```ts\nconst drawings = await snaptrude.presentation.drawings.list()\nconst loose = drawings.filter((drawing) => !drawing.sheetId)\n```"
+    ],
+    "argsType": null,
+    "resultType": "PluginDrawing[]"
+  },
+  {
+    "path": "presentation.drawings.listFonts",
+    "namespace": "presentation.drawings",
+    "summary": "List the font families drawing text can use, from the native catalog (`\"DEFAULT\"` first). Use these names in a style patch's `fontFamily` instead of inventing one.",
+    "examplePrompts": [
+      "Which fonts can I use for drawing labels?",
+      "Is Inter available as a drawing font?",
+      "List the fonts for the title block\n\n# Example\n```ts\nconst fonts = await snaptrude.presentation.drawings.listFonts()\nconst family = fonts.includes(\"Inter\") ? \"Inter\" : \"DEFAULT\"\n```"
+    ],
+    "argsType": null,
+    "resultType": "string[]"
+  },
+  {
+    "path": "presentation.drawings.listPatterns",
+    "namespace": "presentation.drawings",
+    "summary": "List the hatch patterns the native pattern catalog offers. Use these ids in a style patch's `pattern.id` instead of inventing one.",
+    "examplePrompts": [
+      "What hatch patterns can I use?",
+      "List the brick and concrete patterns",
+      "Which fill patterns are available for rooms?\n\n# Example\n```ts\nconst patterns = await snaptrude.presentation.drawings.listPatterns()\nconst brick = patterns.find((pattern) => pattern.label.toLowerCase().includes(\"brick\"))\n```"
+    ],
+    "argsType": null,
+    "resultType": "{ id: string; label: string; group: string }[]"
+  },
+  {
+    "path": "presentation.drawings.rename",
+    "namespace": "presentation.drawings",
+    "summary": "Set the drawing's own title text. The source saved view keeps its name. One Present undo step.",
+    "examplePrompts": [
+      "Rename this drawing to Ground Floor Plan",
+      "Change the title of the elevation drawing",
+      "Call this drawing Level 2 General Arrangement\n\n# Example\n```ts\nawait snaptrude.presentation.drawings.rename(drawing.id, \"Ground Floor Plan\")\n```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginDrawing"
+  },
+  {
+    "path": "presentation.drawings.resetOverrides",
+    "namespace": "presentation.drawings",
+    "summary": "Drop a kernel plan's own style overrides so it matches its bound preset again. Local title, proposal and building text is kept. One Present undo step.",
+    "examplePrompts": [
+      "Reset this drawing to its preset styles",
+      "Undo my style changes on the ground floor plan",
+      "Clear the overrides on this drawing\n\n# Example\n```ts\nawait snaptrude.presentation.drawings.resetOverrides(drawing.id)\n```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginDrawing"
+  },
+  {
+    "path": "presentation.drawings.setCrop",
+    "namespace": "presentation.drawings",
+    "summary": "Crop a drawing to a window of itself, or pass `null` to remove the crop. Crop corners are 0–1 fractions of the uncropped drawing and must satisfy `topLeft < bottomRight` on both axes. One Present undo step. A loose drawing that grows over a neighbour it did not cover before (for example when the crop is removed) moves to the nearest free spot, which `placedViews.setCrop` does not do; an overlap the user made stays, and a drawing on a sheet never moves. Changes the drawing, not the Present camera. The Present view may follow the drawing as a courtesy to a user watching (never zooming in, not while the camera is locked); to look at it, call `presentation.camera.zoomTo(drawing.id)` then `presentation.camera.capture()`.",
+    "examplePrompts": [
+      "Crop this drawing to the left half",
+      "Remove the crop from the site plan drawing",
+      "Show only the top-right corner of this plan\n\n# Example\n```ts\nawait snaptrude.presentation.drawings.setCrop(drawing.id, {\ntopLeft: { x: 0, y: 0 },\nbottomRight: { x: 0.5, y: 1 },\n})\nawait snaptrude.presentation.drawings.setCrop(drawing.id, null)\n```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginDrawing"
+  },
+  {
+    "path": "presentation.drawings.setScale",
+    "namespace": "presentation.drawings",
+    "summary": "Set a drawing's architectural scale; perspective/isometric drawings reject this. `scale` must be a standard architectural scale denominator (100 means 1:100) in the project's unit system; any other value is rejected. Metric: 10, 20, 50, 100, 150, 200, 250, 500, 1000. Imperial detail: 12, 16, 24, 32, 48, 64, 96, 128, 192, 384, 768, 1536 (1\" = 1' to 1/128\" = 1'; 48 is 1/4\" = 1', 96 is 1/8\" = 1'). Imperial site: 120, 240, 360, 480, 600, 1200, 2400, 3600, 4800 (1\" = 10' to 1\" = 400'). Pick the LARGEST standard scale (smallest denominator) at which the view still fits its frame or sheet and its room labels stay readable: for a building floor plan that is usually 1:50 to 1:200 (1/4\" = 1' to 1/16\" = 1'). Never use a site-sized scale (1:500 and up, 1/64\" = 1' (768) and smaller, 1\" = 20' (240) and up) for a single building plan unless the user asked for it. A loose drawing that grows over a neighbour it did not cover before moves to the nearest free spot, which `placedViews.setScale` does not do; an overlap the user made stays, and a drawing on a sheet never moves. Changes the drawing, not the Present camera. The Present view may follow the drawing as a courtesy to a user watching (never zooming in, not while the camera is locked); to look at it, call `presentation.camera.zoomTo(drawing.id)` then `presentation.camera.capture()`.",
+    "examplePrompts": [
+      "Set this drawing to 1:50",
+      "Change the plan drawing scale to 1/4\" = 1'",
+      "Make the ground floor drawing bigger so the labels fit\n\n# Example\n```ts\nconst layout = await snaptrude.presentation.drawings.labels.getLayout(drawing.id)\nconst suggested = layout.unplaced.find((row) => row.suggestedScale)?.suggestedScale\nawait snaptrude.presentation.drawings.setScale(drawing.id, suggested ?? 50)\n```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginDrawing"
+  },
+  {
+    "path": "presentation.drawings.updateContent",
+    "namespace": "presentation.drawings",
+    "summary": "Regenerate one to 100 drawings from their source views, after the model or the view changed. Waits for the update to finish.",
+    "examplePrompts": [
+      "Update this drawing with my latest model changes",
+      "Refresh all the drawings",
+      "Regenerate the ground floor plan drawing\n\n# Example\n```ts\nconst drawings = await snaptrude.presentation.drawings.list()\nconst results = await snaptrude.presentation.drawings.updateContent(\ndrawings.map((drawing) => drawing.id),\n)\n```"
+    ],
+    "argsType": "string[]",
+    "resultType": "{ drawingId: string; updated: boolean }[]"
+  },
+  {
+    "path": "presentation.drawings.updateStyles",
+    "namespace": "presentation.drawings",
+    "summary": "Merge a sparse style patch into one category of a drawing, as one Present undo step. Nested objects merge rather than replace the row. Line and outline weights are paper millimetres (0–2.11); opacity is 0–100; colours are `#rrggbb`. On a kernel plan the patch becomes the drawing's own overrides of its preset; other drawings take the legacy placed-view category patch. An absent category, an unsupported field or an invalid value rejects the whole write.",
+    "examplePrompts": [
+      "Make the walls on this drawing thicker",
+      "Fill the rooms at 60% opacity with a larger hatch",
+      "Turn off the door tags on this plan\n\n# Example\n```ts\nconst styles = await snaptrude.presentation.drawings.getStyles(drawing.id)\nconst space = styles.categories.find((row) => row.category === \"Space\")\nif (space && !space.absent && space.controls.some((control) => control.key === \"opacity\")) {\nawait snaptrude.presentation.drawings.updateStyles(drawing.id, \"Space\", {\nopacity: 60,\npattern: { scale: 1.5 },\n})\n}\n```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginDrawingStyles"
+  },
   {
     "path": "presentation.export",
     "namespace": "presentation",
-    "summary": "Export the presentation's layout sheets to a downloadable file (PDF / PNG / JPG) and return the encoded bytes as base64. Wraps the Present-mode Export dialog pipeline headlessly. Requires Present mode to be open.",
+    "summary": "Export the presentation's layout sheets to a downloadable file (PDF / PNG / JPG). Return base64 by default; `download: true` initiates browser downloads and returns metadata without base64. Requires Present mode to be open. `fileName` is a base name WITHOUT an extension (\"Floor Pattern View\", never \"Floor Pattern View.pdf\"): the host appends the extension for the format, and a name ending in .pdf, .svg, .png, .jpg or .jpeg, a dot or a space is rejected.",
     "examplePrompts": [
       "Export the presentation as a PDF",
       "Download all sheets as a single PDF",
       "Export sheet 1 as a PNG",
       "Save the presentation sheets as JPG images",
-      "Export these sheets to PDF at high resolution\n\n# Example\n```ts\nconst { files } = await snaptrude.presentation.export(\"pdf\")\n```"
+      "Export these sheets to PDF at high resolution\n\n# Example\n```ts\nconst { files } = await snaptrude.presentation.export(\"pdf\")\nconst download = await snaptrude.presentation.export(\"pdf\", { download: true })\n```"
     ],
     "argsType": "PluginPresentationExportFormat",
     "resultType": "PluginPresentationExportResult"
   },
+  {
+    "path": "presentation.export",
+    "namespace": "presentation",
+    "summary": "",
+    "examplePrompts": [],
+    "argsType": "PluginPresentationExportFormat",
+    "resultType": "PluginPresentationExportDownloadResult"
+  },
+  {
+    "path": "presentation.export",
+    "namespace": "presentation",
+    "summary": "",
+    "examplePrompts": [],
+    "argsType": "PluginPresentationExportFormat",
+    "resultType": "PluginPresentationExportResult | PluginPresentationExportDownloadResult"
+  },
   {
     "path": "presentation.import.image",
     "namespace": "presentation.import",
@@ -7788,7 +8373,7 @@
   {
     "path": "presentation.placedViews.setScale",
     "namespace": "presentation.placedViews",
-    "summary": "Set a placed view's architectural scale.",
+    "summary": "Set a placed view's architectural scale. `scale` must be a standard architectural scale denominator (100 means 1:100) in the project's unit system; any other value is rejected. Metric: 10, 20, 50, 100, 150, 200, 250, 500, 1000. Imperial detail: 12, 16, 24, 32, 48, 64, 96, 128, 192, 384, 768, 1536 (1\" = 1' to 1/128\" = 1'; 48 is 1/4\" = 1', 96 is 1/8\" = 1'). Imperial site: 120, 240, 360, 480, 600, 1200, 2400, 3600, 4800 (1\" = 10' to 1\" = 400'). Pick the LARGEST standard scale (smallest denominator) at which the view still fits its frame or sheet and its room labels stay readable: for a building floor plan that is usually 1:50 to 1:200 (1/4\" = 1' to 1/16\" = 1'). Never use a site-sized scale (1:500 and up, 1/64\" = 1' (768) and smaller, 1\" = 20' (240) and up) for a single building plan unless the user asked for it.",
     "examplePrompts": [
       "Set the plan to 1:100",
       "Change the placed floor plan to 1:50 scale",
@@ -7823,6 +8408,99 @@
     "argsType": "string",
     "resultType": "PluginPlacedViewCategoryStyles"
   },
+  {
+    "path": "presentation.sections.create",
+    "namespace": "presentation.sections",
+    "summary": "Draw a section line from `start` to `end` on the plan. The section looks along the line's direction turned a quarter turn — a line drawn toward +x looks toward +z; flip it with `update(id, { isFlipped: true })`. Its slice defaults to the building's full height and its depth to the far side of the model. Write-gated; one undo step.",
+    "examplePrompts": [
+      "Cut a section through the middle of the building, east to west",
+      "Add a section across the stair core",
+      "Draw a longitudinal section and open it\n\n# Example\n```ts\nconst section = await snaptrude.presentation.sections.create(\n{ x: -40, z: 10 },\n{ x: 40, z: 10 },\n{ name: \"Longitudinal\", isActive: true },\n)\n```"
+    ],
+    "argsType": "PluginSectionPoint",
+    "resultType": "PluginSection"
+  },
+  {
+    "path": "presentation.sections.delete",
+    "namespace": "presentation.sections",
+    "summary": "Delete a section. Closes its view first if it is open. Write-gated; one undo step.",
+    "examplePrompts": [
+      "Delete Section B\n\n# Example\n```ts\nawait snaptrude.presentation.sections.delete(sectionId)\n```"
+    ],
+    "argsType": "string",
+    "resultType": "boolean"
+  },
+  {
+    "path": "presentation.sections.get",
+    "namespace": "presentation.sections",
+    "summary": "Get one section by id.",
+    "examplePrompts": [
+      "Where does Section A run?",
+      "How deep is this section?\n\n# Example\n```ts\nconst section = await snaptrude.presentation.sections.get(sectionId)\nconsole.log(section?.start, section?.end)\n```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginSection | null"
+  },
+  {
+    "path": "presentation.sections.getActive",
+    "namespace": "presentation.sections",
+    "summary": "Get the section whose view is open.",
+    "examplePrompts": [
+      "Which section am I looking at?\n\n# Example\n```ts\nconst open = await snaptrude.presentation.sections.getActive()\n```"
+    ],
+    "argsType": null,
+    "resultType": "PluginSection | null"
+  },
+  {
+    "path": "presentation.sections.getCut",
+    "namespace": "presentation.sections",
+    "summary": "What a section cuts: every element its cutting plane passes through within the section's extents, with the cut's area, outline length and extent on the plane, largest first. Computed from the model, not from the drawing, so it needs no open view and works however the section is shown; furniture is left out, as in the drawing, and so is anything hidden in the model. Areas are exact for closed solids. Repeated calls reuse the cuts of elements that have not changed. Read-only.",
+    "examplePrompts": [
+      "Which walls does Section A cut?",
+      "How thick is the slab where the section crosses it?",
+      "Does this section go through the stair?",
+      "What is the floor-to-floor height in this section?\n\n# Example\n```ts\nconst cut = await snaptrude.presentation.sections.getCut(sectionId)\nconst walls = cut.elements.filter((element) => element.type === \"wall\")\nconst thickest = walls[0]\nconsole.log(thickest.extent.uMax - thickest.extent.uMin)\n```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginSectionCut"
+  },
+  {
+    "path": "presentation.sections.list",
+    "namespace": "presentation.sections",
+    "summary": "List the project's sections, in Views panel order.",
+    "examplePrompts": [
+      "Which sections are there?",
+      "List the section lines in this project",
+      "Is there a section through the stair?\n\n# Example\n```ts\nconst sections = await snaptrude.presentation.sections.list()\n```"
+    ],
+    "argsType": null,
+    "resultType": "PluginSection[]"
+  },
+  {
+    "path": "presentation.sections.setActive",
+    "namespace": "presentation.sections",
+    "summary": "Open a section's view, or close the open one with `null`. Opening frames the section's saved camera, or a straight-on view when it has none. Closing returns to 3D; with no section view open, `null` does nothing. Not an edit: nothing is added to the undo history.",
+    "examplePrompts": [
+      "Open Section A",
+      "Show me the section through the atrium",
+      "Close the section view\n\n# Example\n```ts\nawait snaptrude.presentation.sections.setActive(section.sectionId)\nawait snaptrude.presentation.sections.setActive(null)\n```"
+    ],
+    "argsType": "string | null",
+    "resultType": "PluginSection | null"
+  },
+  {
+    "path": "presentation.sections.update",
+    "namespace": "presentation.sections",
+    "summary": "Change a section. Only the given fields change; the whole patch is one undo step. Flipping without a `depth` carries the depth to the far side of the model in the new direction, as `create` does. Write-gated.",
+    "examplePrompts": [
+      "Make Section A look the other way",
+      "Only show the ground floor in this section",
+      "Rename the section to \"Through atrium\"",
+      "Move the section line 5 m north\n\n# Example\n```ts\nawait snaptrude.presentation.sections.update(sectionId, {\nisFlipped: true,\ndepth: 60,\n})\n```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginSection"
+  },
   {
     "path": "presentation.shapes.list",
     "namespace": "presentation.shapes",
@@ -7925,17 +8603,31 @@
   {
     "path": "presentation.sheets.place",
     "namespace": "presentation.sheets",
-    "summary": "Place a saved view onto a sheet.",
+    "summary": "Place a saved view onto a sheet. This is the call that puts a view on a sheet (`presentation.drawings.create` makes a drawing beside its source view, not on a sheet). When `scale` is omitted the view is fitted to the target sheet: a 2D or site-plan view is placed at the largest standard scale at which it fits inside the target sheet's margin, and never at a larger scale than the normal view drop would pick; a 3D view has no scale, so it is shrunk evenly to fit instead. This is the same fit as `placeDrawing`. Omit `position` unless the user asked for a specific place. Without a `position` the drawing goes to the sheet centre when that is free, otherwise to the nearest free spot to the centre inside the margin, beside the drawings already there; when there is no free spot it is centred anyway and the result has `overlaps: true`. With a `position` it is placed as given, and the result has `overlaps: true` when it covers another drawing, but it is not moved. In both cases only other drawings count (placed views and their title blocks and labels): text, images and other shapes on the sheet are ignored. Each call fits one view to the whole sheet, so a second fitted view often has no free spot: when several views should share a sheet, pass a `scale` small enough for all of them; otherwise use `sheets.create` per view. When the result's `overlaps` is true, move the drawing or put it on its own sheet. An explicit `scale` is always kept, even when the drawing (title block included) does not fit inside the sheet's margin at that scale; the result then has `overflows: true`. When it is true, pass a smaller scale (larger denominator), omit `scale` to fit, or use a larger sheet. `scale` must be a standard architectural scale denominator (100 means 1:100) in the project's unit system; any other value is rejected. Metric: 10, 20, 50, 100, 150, 200, 250, 500, 1000. Imperial detail: 12, 16, 24, 32, 48, 64, 96, 128, 192, 384, 768, 1536 (1\" = 1' to 1/128\" = 1'; 48 is 1/4\" = 1', 96 is 1/8\" = 1'). Imperial site: 120, 240, 360, 480, 600, 1200, 2400, 3600, 4800 (1\" = 10' to 1\" = 400'). Pick the LARGEST standard scale (smallest denominator) at which the view still fits its frame or sheet and its room labels stay readable: for a building floor plan that is usually 1:50 to 1:200 (1/4\" = 1' to 1/16\" = 1'). Never use a site-sized scale (1:500 and up, 1/64\" = 1' (768) and smaller, 1\" = 20' (240) and up) for a single building plan unless the user asked for it.",
     "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 at 1:100 scale",
-      "Place the plan on the cover sheet at quarter-inch scale\n\n# Example\n```ts\nconst { shapeId } = await snaptrude.presentation.sheets.place(\"sheet_1\", \"view_123\", {\nscale: 100, // 1:100 (metric project)\n})\n```"
+      "Place the plan on the cover sheet at quarter-inch scale",
+      "Add a floor plan drawing of each storey to this sheet\n\n# Example\n```ts\nconst { shapeId } = await snaptrude.presentation.sheets.place(\"sheet_1\", \"view_123\", {\nscale: 100, // 1:100 (metric project)\n})\n```"
     ],
     "argsType": "string",
     "resultType": "PluginPresentationSheetsPlaceResult"
   },
+  {
+    "path": "presentation.sheets.placeDrawing",
+    "namespace": "presentation.sheets",
+    "summary": "Move an existing drawing onto a sheet without copying or regenerating it, scaled down to fit the sheet when it is too big. `presentation.drawings.create` leaves a drawing beside its source view, not on a sheet; this is the call that puts it on one. To place a saved view on a sheet in one call, use `sheets.place(sheetId, viewId)`, which fits it the same way. By default (`fit` true or omitted) a drawing larger than the sheet's drawable area (the sheet inside its margin) is moved to the LARGEST standard architectural scale at which it fits; a drawing that already fits keeps its scale, and a drawing is never scaled up. A 3D drawing has no architectural scale, so it is shrunk uniformly to fit instead. With `fit: false` the scale is kept and a drawing that does not fit is rejected with an error naming the drawing, the sheet and the scale, and saying to call `placeDrawing` without `fit: false` to fit it, or use a larger sheet. When even the smallest standard scale does not fit, the call is rejected with an error suggesting a larger sheet size. Without a `position` the drawing goes to the sheet centre when that is free, otherwise to the nearest free spot to the centre inside the margin, beside the drawings already there; when there is no free spot it is centred anyway and the result has `overlaps: true`. With a `position` it is placed as given, and the result has `overlaps: true` when it covers another drawing, but it is not moved. In both cases only other drawings count (placed views and their title blocks and labels): text, images and other shapes on the sheet are ignored. Each call fits one drawing to the whole sheet, so a second fitted drawing often has no free spot: when several drawings should share a sheet, give them scales small enough for all of them; otherwise use `sheets.create` per drawing. The position is sheet-local. The drawing's stable id remains unchanged; `shapeId` therefore identifies the moved drawing. The result reports the architectural scale the drawing has on the sheet and whether this call changed it; a host that reports it also says whether the drawing `overlaps` another drawing on the sheet (move it or put it on its own sheet when true).",
+    "examplePrompts": [
+      "Move this drawing onto the cover sheet",
+      "Place drawing_1 at the center of sheet_2",
+      "Put the level 2 plan drawing on the Level 2 Plan sheet",
+      "Add the floor plan drawings to this sheet\n\n# Example\n```ts\nconst { scale, rescaled } = await snaptrude.presentation.sheets.placeDrawing(\nsheet.id,\ndrawing.id,\n)\n```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginPresentationSheetsPlaceDrawingResult"
+  },
   {
     "path": "presentation.sheets.rename",
     "namespace": "presentation.sheets",
@@ -8059,6 +8751,90 @@
     "argsType": "string",
     "resultType": "PluginCanvasShape"
   },
+  {
+    "path": "presentation.viewPresets.copy",
+    "namespace": "presentation.viewPresets",
+    "summary": "Duplicate a preset under a native-generated unique name. Drawing bindings do not change. Not undoable (catalog write). Built-ins can be copied.",
+    "examplePrompts": [
+      "Duplicate this preset",
+      "Make an editable copy of the built-in preset",
+      "Copy the Planning Issue preset so I can change it\n\n# Example\n```ts\nconst copy = await snaptrude.presentation.viewPresets.copy(preset.id)\nawait snaptrude.presentation.viewPresets.rename(copy.id, \"Planning Issue B\")\n```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginViewPreset"
+  },
+  {
+    "path": "presentation.viewPresets.create",
+    "namespace": "presentation.viewPresets",
+    "summary": "Save a kernel-plan drawing's effective styles as a new custom preset and bind that drawing to it. Not undoable (catalog write).",
+    "examplePrompts": [
+      "Save this drawing's styles as a new preset",
+      "Make a preset called Planning Issue from this plan",
+      "Turn my restyled drawing into a reusable style\n\n# Example\n```ts\nconst capabilities = await snaptrude.presentation.drawings.getCapabilities(drawing.id)\nif (capabilities.presets) {\nconst preset = await snaptrude.presentation.viewPresets.create(\"Planning Issue\", {\nfromDrawingId: drawing.id,\n})\n}\n```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginViewPreset"
+  },
+  {
+    "path": "presentation.viewPresets.delete",
+    "namespace": "presentation.viewPresets",
+    "summary": "Delete a custom preset and rebind its drawings to another existing preset. Built-ins cannot be deleted. Not undoable (catalog write).",
+    "examplePrompts": [
+      "Delete this preset",
+      "Remove the old style preset and switch its drawings to the default",
+      "Get rid of the Planning Issue B preset\n\n# Example\n```ts\nconst presets = await snaptrude.presentation.viewPresets.list()\nconst replacement = presets.find((each) => each.builtIn)!\nawait snaptrude.presentation.viewPresets.delete(customPreset.id, {\nreplacementId: replacement.id,\n})\n```"
+    ],
+    "argsType": "string",
+    "resultType": "void"
+  },
+  {
+    "path": "presentation.viewPresets.get",
+    "namespace": "presentation.viewPresets",
+    "summary": "Read one preset by id.",
+    "examplePrompts": [
+      "Which preset is this drawing using?",
+      "Is this preset a built-in one?",
+      "Read the preset bound to the ground floor plan\n\n# Example\n```ts\nconst drawing = await snaptrude.presentation.drawings.get(drawingId)\nconst preset = drawing?.presetId\n? await snaptrude.presentation.viewPresets.get(drawing.presetId)\n: null\n```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginViewPreset | null"
+  },
+  {
+    "path": "presentation.viewPresets.list",
+    "namespace": "presentation.viewPresets",
+    "summary": "List the preset catalog: built-ins first, then custom presets by name.",
+    "examplePrompts": [
+      "List the available drawing style presets",
+      "Which custom presets does this presentation have?",
+      "Is there a Planning Issue preset?\n\n# Example\n```ts\nconst presets = await snaptrude.presentation.viewPresets.list()\nconst custom = presets.filter((preset) => !preset.builtIn)\n```"
+    ],
+    "argsType": null,
+    "resultType": "PluginViewPreset[]"
+  },
+  {
+    "path": "presentation.viewPresets.rename",
+    "namespace": "presentation.viewPresets",
+    "summary": "Rename a custom preset. Names must stay unique; built-ins cannot be renamed. Not undoable (catalog write).",
+    "examplePrompts": [
+      "Rename this preset to Client Review",
+      "Call the copied preset Planning Issue B",
+      "Change the name of my custom drawing style\n\n# Example\n```ts\nawait snaptrude.presentation.viewPresets.rename(preset.id, \"Client Review\")\n```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginViewPreset"
+  },
+  {
+    "path": "presentation.viewPresets.update",
+    "namespace": "presentation.viewPresets",
+    "summary": "Replace a custom preset's values with the effective styles of a drawing already bound to it, then refresh every bound drawing. Built-ins cannot be updated. Not undoable (catalog write).",
+    "examplePrompts": [
+      "Update this preset from the current drawing styles",
+      "Push my style changes to every drawing using this preset",
+      "Save these overrides into the Planning Issue preset\n\n# Example\n```ts\nawait snaptrude.presentation.viewPresets.update(drawing.presetId!, {\nfromDrawingId: drawing.id,\n})\n```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginViewPreset"
+  },
   {
     "path": "presentation.views.capture",
     "namespace": "presentation.views",
@@ -8141,7 +8917,7 @@
     "summary": "List the saved views in the active project.",
     "examplePrompts": [
       "List all the saved views",
-      "What 2D and 3D views are in this project?",
+      "What plan, 3D, and elevation 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```"