@snaptrude/plugin-core 0.7.0 → 0.8.0

package/api-manifest.json

@@ -347,6 +347,71 @@
     "argsType": "string",
     "resultType": "PluginCoreBuildingsUpdateResult"
   },
+  {
+    "path": "core.camera.getProjection",
+    "namespace": "core.camera",
+    "summary": "Read the camera's current projection: `\"perspective\"` (the default 3D view) or `\"orthographic\"`. In 2D (plan) mode this always reports `\"orthographic\"` — a plan is an orthographic projection.",
+    "examplePrompts": [
+      "Is the camera in perspective or orthographic?",
+      "What projection is the 3D view using?",
+      "Check whether perspective is on\n\n# Example\n```ts\nconst projection = await snaptrude.core.camera.getProjection()\nconsole.log(projection) // \"perspective\" | \"orthographic\"\n```"
+    ],
+    "argsType": null,
+    "resultType": "PluginCameraProjection"
+  },
+  {
+    "path": "core.camera.lookFrom",
+    "namespace": "core.camera",
+    "summary": "Point the camera: place its eye at `eye` looking toward `target` (world coordinates, internal `babylon` units). View-state only — not undoable.",
+    "examplePrompts": [
+      "Look at the model from above the north-east corner",
+      "Position the camera at (50, 30, 50) looking at the origin",
+      "Point the camera at the centre of the building from the side",
+      "Set the eye to this point and aim it at that point\n\n# Example\n```ts\nconst { vec3 } = snaptrude.core.math\nawait snaptrude.core.camera.lookFrom(vec3.new(50, 30, 50), vec3.new(0, 0, 0))\n```"
+    ],
+    "argsType": "Vec3Handle",
+    "resultType": "boolean"
+  },
+  {
+    "path": "core.camera.setMode",
+    "namespace": "core.camera",
+    "summary": "Toggle the modelling mode between `2d` (plan) and `3d`. Mirrors the canvas 2D/3D toggle: `3d` enters the isometric perspective view, `2d` drops to the orthographic plan of the active storey. View-state only — not undoable.",
+    "examplePrompts": [
+      "Switch to 3D view",
+      "Drop into 2D plan mode",
+      "Go back to 3D",
+      "Show the floor plan in 2D\n\n# Example\n```ts\nawait snaptrude.core.camera.setMode(\"3d\")\n```"
+    ],
+    "argsType": "PluginCameraMode",
+    "resultType": "boolean"
+  },
+  {
+    "path": "core.camera.setProjection",
+    "namespace": "core.camera",
+    "summary": "Switch the 3D camera between `\"perspective\"` and `\"orthographic\"` projection — the Perspective/Orthographic control in the Design tab's View Settings panel. Like {@linkcode PluginCameraApi.setMode}, this is a transient view-state change: not write-gated, not undoable.",
+    "examplePrompts": [
+      "Switch the camera to orthographic",
+      "Turn perspective off",
+      "Give me a perspective view of the model",
+      "Make the 3D view orthographic like an axonometric drawing\n\n# Example\n```ts\nawait snaptrude.core.camera.setProjection(\"orthographic\")\nconst projection = await snaptrude.core.camera.getProjection() // \"orthographic\"\n```"
+    ],
+    "argsType": "PluginCameraProjection",
+    "resultType": "boolean"
+  },
+  {
+    "path": "core.camera.setStandardView",
+    "namespace": "core.camera",
+    "summary": "Snap the camera to a standard view — the five orthographic elevations (`top` / `front` / `back` / `left` / `right`) or the 3D `iso` (isometric perspective) view. Mirrors the canvas view menu. View-state only — not undoable. The orthographic presets exit 2D mode first if needed.",
+    "examplePrompts": [
+      "Switch to the top view",
+      "Show me the front elevation",
+      "Go to the isometric view",
+      "Look at the model from the left",
+      "Give me a plan view from the top\n\n# Example\n```ts\nawait snaptrude.core.camera.setStandardView(\"top\")\n```"
+    ],
+    "argsType": "PluginStandardView",
+    "resultType": "boolean"
+  },
   {
     "path": "core.comment.create",
     "namespace": "core.comment",
@@ -373,6 +438,19 @@
     "argsType": "CommentHandle",
     "resultType": "boolean"
   },
+  {
+    "path": "core.comment.get",
+    "namespace": "core.comment",
+    "summary": "Read a comment's full detail — its text, author, pin location, resolved state, and reply thread. Comments are otherwise write-only; this is the read side. Pass a top-level comment handle or a reply handle (a reply has an empty `thread`). Returns `null` if the handle doesn't match a live comment.",
+    "examplePrompts": [
+      "Read the comment on this wall and tell me what it says",
+      "Who left this comment and where is it pinned?",
+      "Show me the full thread for this comment",
+      "Get the text and author of the selected comment\n\n# Example\n```ts\nconst [first] = await snaptrude.core.comment.list()\nconst details = await snaptrude.core.comment.get(first)\nconsole.log(details?.content, \"by\", details?.author?.name)\nconsole.log(`${details?.thread.length ?? 0} replies`)\n```"
+    ],
+    "argsType": "CommentHandle",
+    "resultType": "PluginCommentDetails | null"
+  },
   {
     "path": "core.comment.isResolved",
     "namespace": "core.comment",
@@ -412,6 +490,19 @@
     "argsType": "CommentHandle",
     "resultType": "boolean"
   },
+  {
+    "path": "core.comment.reply",
+    "namespace": "core.comment",
+    "summary": "Reply to a comment — posts a new comment threaded under `comment` (which must be a top-level comment, not itself a reply). Notifies the thread's participants, mirroring the sidebar Reply action.",
+    "examplePrompts": [
+      "Reply to this comment saying I fixed the wall height",
+      "Add a reply to the review note confirming it's done",
+      "Respond to the comment about the door with \"looks good now\"",
+      "Post a follow-up on the selected comment thread\n\n# Example\n```ts\nconst [thread] = await snaptrude.core.comment.list()\nconst reply = await snaptrude.core.comment.reply(thread, \"Fixed 👍\")\n```"
+    ],
+    "argsType": "CommentHandle",
+    "resultType": "CommentHandle"
+  },
   {
     "path": "core.comment.resolve",
     "namespace": "core.comment",
@@ -2023,6 +2114,46 @@
     "argsType": "string",
     "resultType": "PluginCoreGroupsUpdateResult"
   },
+  {
+    "path": "core.handles.beginScope",
+    "namespace": "core.handles",
+    "summary": "Open a mint-recording scope: every arena handle MINTED after this call (fresh mints only — identity-deduped re-registrations of pre-existing objects are not captured) is freed when the matching {@linkcode endScope} runs. Scopes nest, up to 64 deep — always pair begin/end in try/finally.",
+    "examplePrompts": [],
+    "argsType": null,
+    "resultType": "ScopeToken"
+  },
+  {
+    "path": "core.handles.endScope",
+    "namespace": "core.handles",
+    "summary": "Close a scope by its token and free every handle it recorded, except those listed in `retain`. Retained handles are promoted to the enclosing scope (if any), so nesting composes like block scopes. Closing is token-addressed: an out-of-order close (interleaved async tasks) frees only that scope's mints and leaves other open scopes intact. Always pair begin/end in try/finally so a thrown body cannot leak the scope.",
+    "examplePrompts": [],
+    "argsType": "ScopeToken",
+    "resultType": "void"
+  },
+  {
+    "path": "core.handles.release",
+    "namespace": "core.handles",
+    "summary": "Free arena handles in bulk. Unknown, foreign, or already-released ids are silent no-ops — there is no per-id result and no count, so responses can never be used as an existence oracle.",
+    "examplePrompts": [],
+    "argsType": "ReadonlyArray<AnyArenaHandle>",
+    "resultType": "void"
+  },
+  {
+    "path": "core.handles.releaseAll",
+    "namespace": "core.handles",
+    "summary": "Free every live arena handle of one kind, or ALL arena handles when the kind is omitted. Useful at batch boundaries — e.g. a poll loop that mints a fresh footprint contour per tick.",
+    "examplePrompts": [],
+    "argsType": "ArenaKind",
+    "resultType": "void"
+  },
+  {
+    "path": "core.handles.stats",
+    "namespace": "core.handles",
+    "summary": "Live handle-registry statistics for the calling plugin, plus the host page's JS heap usage (when the browser exposes it). Diagnostic surface for verifying that releases actually shrink host memory.",
+    "examplePrompts": [],
+    "argsType": null,
+    "resultType": "PluginHandlesStatsResult"
+  },
   {
     "path": "core.history.redo",
     "namespace": "core.history",
@@ -2050,6 +2181,20 @@
     "argsType": "number",
     "resultType": "PluginHistoryStepResult"
   },
+  {
+    "path": "core.io.export.model",
+    "namespace": "core.io.export",
+    "summary": "Export the model to a 3D file and return its bytes as base64.",
+    "examplePrompts": [
+      "Export the model as a GLB",
+      "Give me the whole scene as an OBJ file",
+      "Export just my selection to GLB",
+      "Download the model as an FBX file",
+      "Export the scene to 3DS for 3ds Max\n\n# Example\n```ts\nconst file = await snaptrude.core.io.export.model(\"glb\")\n// decode base64 → bytes and save/download in the plugin UI\nconst bytes = Uint8Array.from(atob(file.dataBase64), (c) => c.charCodeAt(0))\nconst blob = new Blob([bytes], { type: file.mimeType })\n// ...offer blob for download as file.fileName\n\n// Only the current selection, as OBJ text:\nconst obj = await snaptrude.core.io.export.model(\"obj\", \"selection\")\nconst text = atob(obj.dataBase64)\n```"
+    ],
+    "argsType": "ExportModelFormat",
+    "resultType": "ExportedFile"
+  },
   {
     "path": "core.io.import.cadJson",
     "namespace": "core.io.import",
@@ -3041,11 +3186,12 @@
   {
     "path": "core.proposals.create",
     "namespace": "core.proposals",
-    "summary": "Create a new design option (proposal).",
+    "summary": "Create a new design option (proposal) — blank, or configured from a base proposal (the New Proposal modal's two paths).",
     "examplePrompts": [
       "Create a design option called Scheme B",
       "Add a new proposal named Option 2",
-      "Make a fresh design variant to explore\n\n# Example\n```ts\nconst { id } = await snaptrude.core.proposals.create(\"Scheme B\")\n```"
+      "Duplicate the current proposal as Scheme C",
+      "Create a design option based on Proposal 1 that shares its site layer\n\n# Example\n```ts\n// blank design option\nconst { id } = await snaptrude.core.proposals.create(\"Scheme B\")\n\n// configured from the active proposal: duplicate every layer\nconst base = await snaptrude.core.proposals.getActive()\nif (base) {\nconst { id: dup } = await snaptrude.core.proposals.create(\"Scheme C\", {\nbaseProposalId: base.id,\n})\n// …or share one layer and leave the rest behind\nconst { id: shared } = await snaptrude.core.proposals.create(\"Scheme D\", {\nbaseProposalId: base.id,\nlayers: [{ bucketId: base.defaultBucketId, action: \"share\" }],\n})\n}\n```"
     ],
     "argsType": "string",
     "resultType": "PluginCoreProposalsCreateResult"
@@ -3379,6 +3525,19 @@
     "argsType": "PUnitType",
     "resultType": "boolean"
   },
+  {
+    "path": "core.user.getLocale",
+    "namespace": "core.user",
+    "summary": "Get the viewer's locale: IANA timezone and BCP-47 language tag, resolved from the browser (`Intl.DateTimeFormat().resolvedOptions().timeZone` and `navigator.language`). Locale only — no precise location.",
+    "examplePrompts": [
+      "What timezone is the user in?",
+      "Get the viewer's language for localized labels",
+      "Format the report date in the user's local timezone",
+      "Which locale should I use for this plugin's UI?\n\n# Example\n```ts\nconst { timezone, language } = await snaptrude.core.user.getLocale()\n```"
+    ],
+    "argsType": null,
+    "resultType": "PluginUserLocale"
+  },
   {
     "path": "core.zoom.extents",
     "namespace": "core.zoom",
@@ -3450,7 +3609,7 @@
   {
     "path": "design.create.beam",
     "namespace": "design.create",
-    "summary": "Create a **beam** by extruding a cross-section contour along `direction` by `length`.",
+    "summary": "Create a **beam** by extruding a cross-section contour along `direction` by `length`. Matches the Snaptrude beam tool's semantics: the beam body hangs BELOW the plane the section is authored on.",
     "examplePrompts": [
       "Add a beam spanning 6 metres between the columns",
       "Create a horizontal beam along the X axis",
@@ -3476,7 +3635,7 @@
   {
     "path": "design.create.column",
     "namespace": "design.create",
-    "summary": "Create a **column** by extruding a cross-section contour upward by `height` from a base `position`.",
+    "summary": "Create a **column** by extruding a cross-section contour upward by `height` from a base `position`. The column is built to EXACTLY `height` — unlike the interactive draw tool, no slab-thickness deduction is applied.",
     "examplePrompts": [
       "Add a 3m tall column at this point",
       "Place a column at the grid intersection",
@@ -3509,7 +3668,8 @@
       "Place a sliding door on the selected wall",
       "Put a door from the catalog at this point on the wall",
       "Insert the entrance door into this wall",
-      "Add a door to the wall and call it Entry-01\n\n# Example\n```ts\nconst [wall] = await snaptrude.design.query.listWalls({ isSelected: true })\nconst [entry] = await snaptrude.design.doors.listCatalog()\nconst door = await snaptrude.design.create.door(\nentry.id,\nwall,\nawait snaptrude.core.math.vec3.new(3, 0, 5),\n{ label: \"Entry-01\" },\n)\n```"
+      "Add a door to the wall and call it Entry-01",
+      "Add a door that opens into the living room\n\n# Example\n```ts\nconst [wall] = await snaptrude.design.query.listWalls({ isSelected: true })\nconst [entry] = await snaptrude.design.doors.listCatalog()\nconst door = await snaptrude.design.create.door(\nentry.id,\nwall,\nawait snaptrude.core.math.vec3.new(3, 0, 5),\n{ label: \"Entry-01\" },\n)\n// …facing a specific side of the wall (pass a point inside that room):\nconst intoKitchen = await snaptrude.design.create.door(\nentry.id,\nwall,\nawait snaptrude.core.math.vec3.new(3, 0, 5),\nundefined,\nawait snaptrude.core.math.vec3.new(3, 0, 9),\n)\n```"
     ],
     "argsType": "string",
     "resultType": "ComponentHandle"
@@ -3536,7 +3696,8 @@
       "Add a sofa from the furniture catalog to the living room",
       "Drop a desk into the scene at 3, 0, 5",
       "Insert the uploaded bed model in the bedroom",
-      "Put a table from my project library here and name it Table-01\n\n# Example\n```ts\nconst chair = await snaptrude.design.create.furniture(\n\"6620f1a…\",             // from design.furniture.listCatalog()\nawait snaptrude.core.math.vec3.new(3, 0, 5),\n{ label: \"Chair-01\" },\n)\n```"
+      "Put a table from my project library here and name it Table-01",
+      "Place a chair here rotated 90 degrees\n\n# Example\n```ts\nconst chair = await snaptrude.design.create.furniture(\n\"6620f1a…\",             // from design.furniture.listCatalog()\nawait snaptrude.core.math.vec3.new(3, 0, 5),\n{ label: \"Chair-01\" },\n)\n// …placed already turned 90° about the vertical axis:\nconst turned = await snaptrude.design.create.furniture(\n\"6620f1a…\",\nawait snaptrude.core.math.vec3.new(3, 0, 5),\nundefined,\n90,\n)\n```"
     ],
     "argsType": "string",
     "resultType": "ComponentHandle"
@@ -3618,7 +3779,8 @@
       "Add a new space on the current storey using this footprint",
       "Make a bedroom here and assign it to the Residential department",
       "Extrude this closed outline into a 10 foot high room",
-      "Can you create a Kitchen space from the sketch I just drew?\n\n# Example\n```ts\nconst v = snaptrude.core.math.vec3\nconst outer = await snaptrude.core.geom.create.profileFromLinePoints([\nawait v.new(0, 0, 0),\nawait v.new(10, 0, 0),\nawait v.new(10, 0, 8),\nawait v.new(0, 0, 8),\n])\nconst contour = await snaptrude.core.geom.create.contourFromProfile(outer)\nconst space = await snaptrude.design.create.space(contour, 3, \"Living\")\n```"
+      "Can you create a Kitchen space from the sketch I just drew?",
+      "Create a bedroom on the second floor from this outline\n\n# Example\n```ts\nconst v = snaptrude.core.math.vec3\nconst outer = await snaptrude.core.geom.create.profileFromLinePoints([\nawait v.new(0, 0, 0),\nawait v.new(10, 0, 0),\nawait v.new(10, 0, 8),\nawait v.new(0, 0, 8),\n])\nconst contour = await snaptrude.core.geom.create.contourFromProfile(outer)\nconst space = await snaptrude.design.create.space(contour, 3, \"Living\")\n// …place one directly on the second floor (no setActive dance):\nconst upstairs = await snaptrude.design.create.space(\ncontour, 3, \"Bedroom\", undefined, undefined, undefined, undefined, 2,\n)\n```"
     ],
     "argsType": "ContourHandle",
     "resultType": "ComponentHandle"
@@ -3626,12 +3788,13 @@
   {
     "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.",
+    "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. Each item may carry its own `storey` (see {@linkcode PluginCreateSpaceItem}) so a single call can populate several floors at once.",
     "examplePrompts": [
       "Create several rooms at once from these footprints",
       "Generate all the bedrooms in one operation",
       "Bulk create the spaces for this floor plan",
-      "Add three rooms with different heights in a single undo step\n\n# Example\n```ts\nconst rect = await snaptrude.core.geom.create.profileRect(4, 3)\nconst contour = await snaptrude.core.geom.create.contourFromProfile(rect)\nconst [a, b] = await snaptrude.design.create.spaces([\n{ contour, height: 3, label: \"R1\" },\n{ contour, height: 4, label: \"R2\", position: await vec3.new(10, 0, 0) },\n])\n```"
+      "Add three rooms with different heights in a single undo step",
+      "Create one room on the ground floor and one on the first floor\n\n# Example\n```ts\nconst rect = await snaptrude.core.geom.create.profileRect(4, 3)\nconst contour = await snaptrude.core.geom.create.contourFromProfile(rect)\nconst [a, b] = await snaptrude.design.create.spaces([\n{ contour, height: 3, label: \"R1\" },\n{ contour, height: 4, label: \"R2\", position: await vec3.new(10, 0, 0) },\n])\n```"
     ],
     "argsType": "PluginCreateSpaceItem[]",
     "resultType": "ComponentHandle[]"
@@ -3659,7 +3822,9 @@
       "Create 3m high, 200mm thick walls from these points",
       "Build a wall run around the room outline",
       "Turn this polyline sketch into walls",
-      "Add walls with mitred corners along the path\n\n# Example\n```ts\nconst v = snaptrude.core.math.vec3\nconst centerlines = await snaptrude.core.geom.create.profileFromLinePoints([\nawait v.new(0, 0, 0),\nawait v.new(8, 0, 0),\nawait v.new(8, 0, 6),\n])\nconst walls = await snaptrude.design.create.walls(centerlines, 3, 0.2)\n```"
+      "Add walls with mitred corners along the path",
+      "Draw brick walls with plaster along this outline",
+      "Build the perimeter in exposed concrete walls\n\n# Example\n```ts\nconst v = snaptrude.core.math.vec3\nconst centerlines = await snaptrude.core.geom.create.profileFromLinePoints([\nawait v.new(0, 0, 0),\nawait v.new(8, 0, 0),\nawait v.new(8, 0, 6),\n])\nconst walls = await snaptrude.design.create.walls(centerlines, 3, 0.2)\n// …built as a specific wall type (layers/material/thickness from the type):\nconst [brick] = await snaptrude.design.types.list(\"wall\")\nconst brickWalls = await snaptrude.design.create.walls(\ncenterlines, 3, undefined, brick.label,\n)\n```"
     ],
     "argsType": "ProfileHandle",
     "resultType": "ComponentHandle[]"
@@ -3673,7 +3838,8 @@
       "Place a casement window on the selected wall",
       "Put a window from the catalog at this point on the wall",
       "Insert a window into the living room wall",
-      "Add a window to the wall and name it Win-01\n\n# Example\n```ts\nconst [wall] = await snaptrude.design.query.listWalls({ isSelected: true })\nconst [entry] = await snaptrude.design.windows.listCatalog()\nconst window = await snaptrude.design.create.window(\nentry.id,\nwall,\nawait snaptrude.core.math.vec3.new(3, 0, 5),\n{ label: \"Win-01\" },\n)\n```"
+      "Add a window to the wall and name it Win-01",
+      "Add a casement window opening toward the garden side\n\n# Example\n```ts\nconst [wall] = await snaptrude.design.query.listWalls({ isSelected: true })\nconst [entry] = await snaptrude.design.windows.listCatalog()\nconst window = await snaptrude.design.create.window(\nentry.id,\nwall,\nawait snaptrude.core.math.vec3.new(3, 0, 5),\n{ label: \"Win-01\" },\n)\n```"
     ],
     "argsType": "string",
     "resultType": "ComponentHandle"
@@ -3718,6 +3884,19 @@
     "argsType": "string",
     "resultType": "PluginObjectCatalogItem | null"
   },
+  {
+    "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}.",
+    "examplePrompts": [
+      "What are the dimensions of this door?",
+      "How big is the selected door?",
+      "Give me the width, height and depth of this door",
+      "Measure the entrance door including its thickness through the wall\n\n# Example\n```ts\nconst [door] = await snaptrude.design.query.listDoors({ isSelected: true })\nconst dims = await snaptrude.design.doors.getDimensions(door)\nif (dims) console.log(dims.width, dims.height, dims.thickness)\n```"
+    ],
+    "argsType": "ComponentHandle",
+    "resultType": "PluginDoorDimensions | null"
+  },
   {
     "path": "design.doors.getFamily",
     "namespace": "design.doors",
@@ -3929,6 +4108,19 @@
     "argsType": "string",
     "resultType": "PluginFurnitureCatalogItem | null"
   },
+  {
+    "path": "design.furniture.getDimensions",
+    "namespace": "design.furniture",
+    "summary": "Get the dimensions of a PLACED furniture item — `length` (along the object), `width` (across it) and `height` (vertical), in engine units. Mirrors the Length/Width/Height fields of the furniture properties panel.",
+    "examplePrompts": [
+      "How big is this sofa?",
+      "What are the dimensions of the selected furniture?",
+      "Measure the length, width and height of this table",
+      "Get the size of the chair I just placed\n\n# Example\n```ts\nconst [item] = await snaptrude.design.query.listFurniture({ isSelected: true })\nconst dims = await snaptrude.design.furniture.getDimensions(item)\nif (dims) console.log(dims.length, dims.width, dims.height)\n```"
+    ],
+    "argsType": "ComponentHandle",
+    "resultType": "PluginFurnitureDimensions | null"
+  },
   {
     "path": "design.furniture.listCatalog",
     "namespace": "design.furniture",
@@ -3956,6 +4148,19 @@
     "argsType": null,
     "resultType": "string[]"
   },
+  {
+    "path": "design.furniture.setDimensions",
+    "namespace": "design.furniture",
+    "summary": "Resize a PLACED furniture item along one or more axes — `length`, `width` and/or `height` (engine units). Omitted axes are left unchanged. Each supplied axis is an undoable command, mirroring editing the furniture properties panel.",
+    "examplePrompts": [
+      "Make this table 1.8m long",
+      "Resize the selected sofa to 2000 wide",
+      "Set this furniture to 800mm tall",
+      "Change the desk to 1500 long and 700 deep\n\n# Example\n```ts\nconst [item] = await snaptrude.design.query.listFurniture({ isSelected: true })\nconst { affected } = await snaptrude.design.furniture.setDimensions(item, {\nlength: 1800,\nheight: 750\n})\n```"
+    ],
+    "argsType": "ComponentHandle",
+    "resultType": "PluginDesignChangeResult"
+  },
   {
     "path": "design.isAreaLocked",
     "namespace": "design",
@@ -4072,6 +4277,20 @@
     "argsType": "PluginMaterialSpec",
     "resultType": "MaterialHandle"
   },
+  {
+    "path": "design.materials.get",
+    "namespace": "design.materials",
+    "summary": "Read the material applied to a component **as a whole** — the eyedropper. For a uniformly-painted component this is that single material; for a per-face-painted component it is the material on the component's base/first face. Use {@linkcode PluginDesignMaterialsApi.getByFace} / {@linkcode PluginDesignMaterialsApi.listByFace} for the per-face breakdown.",
+    "examplePrompts": [
+      "What material is on this wall?",
+      "Eyedrop the finish of the selected object",
+      "Which material does this slab use?",
+      "Read the material on this column so I can paint others with it",
+      "Is this component painted, and with what?\n\n# Example\n```ts\nconst [component] = await snaptrude.design.selection.get()\nconst sampled = await snaptrude.design.materials.get(component)\nif (sampled) {\nconsole.log(sampled.name, sampled.source) // e.g. \"Brick Red\" \"applied\"\nconst info = await snaptrude.design.materials.getInfo(sampled.material)\nconsole.log(info?.colorHex)\n}\n```"
+    ],
+    "argsType": "ComponentHandle",
+    "resultType": "PluginComponentMaterial | null"
+  },
   {
     "path": "design.materials.getByFace",
     "namespace": "design.materials",
@@ -4152,15 +4371,14 @@
   {
     "path": "design.materials.list",
     "namespace": "design.materials",
-    "summary": "List the project materials.",
+    "summary": "List the materials loaded in the project — every named material in the live scene (applied finishes, plugin-created materials, and type defaults in use). For the browsable preset/library catalog (finishes not yet in the project), use {@linkcode PluginDesignMaterialsApi.listPresets}.",
     "examplePrompts": [
       "List all the materials in this project",
       "What materials do I have available to apply?",
-      "Show me the preset materials library",
       "Which finishes exist in this model?",
-      "Get every material in the project palette\n\n# Example\n```ts\nconst presets = await snaptrude.design.materials.list(\"preset\")\nconsole.log(presets.length, \"preset materials\")\n```"
+      "Get every material in the project palette\n\n# Example\n```ts\nconst materials = await snaptrude.design.materials.list()\nconsole.log(materials.length, \"materials in the project\")\n```"
     ],
-    "argsType": "\"project\" | \"preset\"",
+    "argsType": null,
     "resultType": "MaterialHandle[]"
   },
   {
@@ -4175,6 +4393,19 @@
     "argsType": "ComponentHandle",
     "resultType": "PluginFaceMaterial[]"
   },
+  {
+    "path": "design.materials.listPresets",
+    "namespace": "design.materials",
+    "summary": "List the preset material library — the catalog the app's material browser shows (the built-in finishes plus the workspace's uploaded materials), fetched from the material library service. Library entries are **not** scene materials and carry no {@linkcode MaterialHandle}; each is a named texture record. To use one, feed it to {@linkcode PluginDesignMaterialsApi.create} / {@linkcode PluginDesignMaterialsApi.apply} as a {@linkcode PluginMaterialSpec}: `{ name, textureUrl, materialType: category }`.",
+    "examplePrompts": [
+      "Show me the preset materials library",
+      "What wood finishes are available in the material library?",
+      "Browse the material catalog and apply a brick texture",
+      "Which preset materials can I choose from?\n\n# Example\n```ts\nconst presets = await snaptrude.design.materials.listPresets()\nconst brick = presets.find((p) => p.category.toLowerCase().includes(\"brick\"))\nif (brick) {\nconst walls = await snaptrude.design.query.listWalls()\nawait snaptrude.design.materials.apply(walls, {\nname: brick.name,\ntextureUrl: brick.textureUrl,\nmaterialType: brick.category,\n})\n}\n```"
+    ],
+    "argsType": null,
+    "resultType": "PluginPresetMaterial[]"
+  },
   {
     "path": "design.materials.reset",
     "namespace": "design.materials",
@@ -4334,10 +4565,11 @@
   {
     "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`).",
+    "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`). For walls and the slab family (slab / floor / roof / ceiling) this includes `buildingType` — the assigned building type NAME the panel's type dropdown shows, matching `design.types.list(kind)`.",
     "examplePrompts": [
       "Show me all the details of the selected object",
       "What storey is this wall on?",
+      "Which wall type is assigned to this wall?",
       "Which department does this room belong to?",
       "Is this element locked or hidden?",
       "Get the adjacencies of this space\n\n# Example\n```ts\nconst [wall] = await snaptrude.design.query.listWalls()\nconst props = await snaptrude.design.query.getProperties(wall)\nconsole.log(props.type, props.storey, props.boundingBox)\n\n// The record is partial — type-specific fields exist only where they apply\nconst [room] = await snaptrude.design.query.listSpaces()\nconst p = await snaptrude.design.query.getProperties(room)\nif (p.spaceType === \"Room\" && p.areaClass === \"NET\") {\nfor (const adj of p.adjacency ?? []) {\n// adj.value: 2 = direct, 1 = indirect/contact, -1 = restricted\nconsole.log(adj.spaceId, adj.value)\n}\n}\n```"
@@ -4602,9 +4834,11 @@
     "examplePrompts": [
       "What's the area of this room?",
       "How long is the selected wall?",
+      "How thick is this wall?",
+      "Get the thickness of the slab on level 2",
       "Get the volume of this mass",
       "Give me the dimensions of the selected element",
-      "What's the floor area of the kitchen?\n\n# Example\n```ts\nconst [space] = await snaptrude.design.query.listSpaces()\nconst m = await snaptrude.design.query.measure(space)\nconsole.log(m?.area, m?.volume)\n```"
+      "What's the floor area of the kitchen?\n\n# Example\n```ts\nconst [space] = await snaptrude.design.query.listSpaces()\nconst m = await snaptrude.design.query.measure(space)\nconsole.log(m?.area, m?.volume)\n\n// wall dimensions — the panel's Thickness / Height, in engine units\nconst [wall] = await snaptrude.design.query.listWalls()\nconst wm = await snaptrude.design.query.measure(wall)\nconsole.log(wm?.thickness, wm?.height)\n```"
     ],
     "argsType": "ComponentHandle",
     "resultType": "PluginEntityMeasurements | null"
@@ -4731,6 +4965,20 @@
     "argsType": "ComponentHandle[]",
     "resultType": "PluginDesignChangeResult"
   },
+  {
+    "path": "design.transform.mirror",
+    "namespace": "design.transform",
+    "summary": "Mirror components **in place** about a horizontal axis, flipping their geometry across that axis through the combined bounding-box centre (the mesh's world-matrix flip + brep inversion + CAD/dimension-line/parametric handling commit atomically). Nothing moves off-centre — this is the toolbar \"flip\", not a translate-and-reflect. Undoable.",
+    "examplePrompts": [
+      "Mirror the selected building across the x axis",
+      "Flip these rooms left to right",
+      "Mirror this furniture block horizontally",
+      "Flip the selected walls front to back",
+      "Create a mirror image of these masses about the z axis\n\n# Example\n```ts\nconst rooms = await snaptrude.design.selection.get()\nawait snaptrude.design.transform.mirror(rooms, \"x\")\n```"
+    ],
+    "argsType": "ComponentHandle[]",
+    "resultType": "PluginDesignChangeResult"
+  },
   {
     "path": "design.transform.move",
     "namespace": "design.transform",
@@ -4748,16 +4996,43 @@
   {
     "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.",
+    "summary": "Rotate entities by a **signed angle in DEGREES** (positive = CCW about +Y). The pivot defaults to the combined bounding-box centre; pass `options.pivot` to rotate about an explicit world-space point instead. NOTE: unlike the removed `tools.transform.rotate` (radians), this canonical form takes DEGREES. Undoable.",
     "examplePrompts": [
       "Rotate the selected building 90 degrees",
       "Turn this room 45 degrees clockwise",
       "Spin the furniture block 180 degrees about its centre",
-      "Rotate these masses 30 degrees around the vertical axis\n\n# Example\n```ts\nawait snaptrude.design.transform.rotate([\"space-id\"], 90)\n```"
+      "Rotate these masses 30 degrees around the vertical axis",
+      "Rotate these walls 90 degrees about the origin\n\n# Example\n```ts\nawait snaptrude.design.transform.rotate([\"space-id\"], 90)\n// …or rotate about an explicit pivot point\nconst { vec3 } = snaptrude.core.math\nawait snaptrude.design.transform.rotate([\"space-id\"], 90, { pivot: vec3.new(0, 0, 0) })\n```"
     ],
     "argsType": "ComponentHandle[]",
     "resultType": "PluginDesignChangeResult"
   },
+  {
+    "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.",
+    "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```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginBuildingType | null"
+  },
+  {
+    "path": "design.types.list",
+    "namespace": "design.types",
+    "summary": "List the building types of one `kind` (wall / slab / floor / ceiling / roof) — the built-in defaults plus any team/user-added types. Returns lightweight summaries; call {@linkcode PluginDesignTypesApi.get} for the full layer stack.",
+    "examplePrompts": [
+      "What wall types does this project have?",
+      "List the available slab assemblies",
+      "Show me every roof type in the project",
+      "Which floor types can I use?\n\n# Example\n```ts\nconst wallTypes = await snaptrude.design.types.list(\"wall\")\nfor (const t of wallTypes) console.log(t.id, t.label, t.thickness)\n```"
+    ],
+    "argsType": "PluginBuildingTypeKind",
+    "resultType": "PluginBuildingTypeSummary[]"
+  },
   {
     "path": "design.unlock",
     "namespace": "design",
@@ -4784,6 +5059,69 @@
     "argsType": "ComponentHandle[]",
     "resultType": "PluginDesignChangeResult"
   },
+  {
+    "path": "design.update.ceiling",
+    "namespace": "design.update",
+    "summary": "Edit a **ceiling's** thickness — the slab-family updater for ceilings (shares the slab thickness command). Undoable. Thickness is in **engine units** (the `design.doors.setWidth` convention) and must be `> 0`. Ceilings have no Overhang control, so `overhang` is rejected with `PRECONDITION_FAILED`.",
+    "examplePrompts": [
+      "Make this ceiling 150mm thick",
+      "Set every ceiling to a 100 thickness",
+      "Thicken the ceiling to 200\n\n# Example\n```ts\nconst [ceiling] = await snaptrude.design.query.listCeilings()\nawait snaptrude.design.update.ceiling(ceiling, { thickness: 150 })\n```"
+    ],
+    "argsType": "ComponentHandle",
+    "resultType": "PluginDesignChangeResult"
+  },
+  {
+    "path": "design.update.floor",
+    "namespace": "design.update",
+    "summary": "Edit a **floor's** thickness — the slab-family updater for floors (shares the slab thickness command). Undoable. Thickness is in **engine units** (the `design.doors.setWidth` convention) and must be `> 0`. Floors have no Overhang control, so `overhang` is rejected with `PRECONDITION_FAILED`.",
+    "examplePrompts": [
+      "Make this floor 200mm thick",
+      "Set every floor to a 250 thickness",
+      "Thicken the ground floor slab to 300\n\n# Example\n```ts\nconst [floor] = await snaptrude.design.query.listFloors()\nawait snaptrude.design.update.floor(floor, { thickness: 200 })\n```"
+    ],
+    "argsType": "ComponentHandle",
+    "resultType": "PluginDesignChangeResult"
+  },
+  {
+    "path": "design.update.roof",
+    "namespace": "design.update",
+    "summary": "Edit a **roof's** thickness and/or overhang — the same commands the roof panel's Thickness field and Overhang slider drive (shares the slab-family machinery). Sparse: only the fields you provide change. Undoable. Both values are in **engine units** (the `design.doors.setWidth` convention); thickness must be `> 0`, overhang is an absolute offset (negative insets the roof) and re-applying the current overhang is a no-op.",
+    "examplePrompts": [
+      "Make this roof 300mm thick",
+      "Set the roof slab thickness to 250",
+      "Give the roof a 600 overhang",
+      "Pull the roof overhang back to 0\n\n# Example\n```ts\nconst [roof] = await snaptrude.design.query.listRoofs()\nawait snaptrude.design.update.roof(roof, { overhang: 600 })\n```"
+    ],
+    "argsType": "ComponentHandle",
+    "resultType": "PluginDesignChangeResult"
+  },
+  {
+    "path": "design.update.setBaseOffset",
+    "namespace": "design.update",
+    "summary": "Set a component's **base offset** — its vertical distance above its own storey's base level. Moves the component so its base lands at `storeyBase + offset`, composed over the same command-backed move machinery as {@linkcode setElevation} (undoable, persisted, per-type invariants kept in sync). Use this instead of {@linkcode setElevation} when you want an offset relative to the storey rather than an absolute world height. `offset` is in **engine units** (the `design.doors.setWidth` convention); `0` sits the base flush with the storey base. Re-applying the current offset is a no-op.",
+    "examplePrompts": [
+      "Lift this element 300 above its floor",
+      "Set this staircase's base offset to 0",
+      "Raise the selected mass 500 off the storey base",
+      "Offset this slab 150 above the floor level\n\n# Example\n```ts\nconst [stair] = await snaptrude.design.query.listStaircases()\nawait snaptrude.design.update.setBaseOffset(stair, 0)\n```"
+    ],
+    "argsType": "ComponentHandle",
+    "resultType": "PluginDesignChangeResult"
+  },
+  {
+    "path": "design.update.setElevation",
+    "namespace": "design.update",
+    "summary": "Set a component's **absolute world elevation** — moves it vertically so its base (the bounding-box bottom, world Y) lands at `elevation`. Composed over the canonical command-backed move machinery, so it is undoable and persisted exactly like dragging the element up or down; per-type invariants (e.g. a staircase's base offset) stay in sync. `elevation` is in **engine units** (the `design.doors.setWidth` convention). Re-applying the current elevation is a no-op.",
+    "examplePrompts": [
+      "Set this element's elevation to 3000",
+      "Raise this mass so its base sits at 3 metres",
+      "Drop the selected slab to elevation 0",
+      "Put this staircase's base at 3200\n\n# Example\n```ts\n// Sit the roof slab exactly at the top of a 3m storey\nconst [roof] = await snaptrude.design.query.listRoofs()\nawait snaptrude.design.update.setElevation(roof, 3000)\n```"
+    ],
+    "argsType": "ComponentHandle",
+    "resultType": "PluginDesignChangeResult"
+  },
   {
     "path": "design.update.setLabel",
     "namespace": "design.update",
@@ -4797,6 +5135,32 @@
     "argsType": "ComponentHandle",
     "resultType": "boolean"
   },
+  {
+    "path": "design.update.setStorey",
+    "namespace": "design.update",
+    "summary": "Reassign one or more components to another **storey** — the same operation as the properties panel's Story dropdown, and it works across element kinds exactly like the panel (walls, slabs, masses, furniture, staircases, ...). Each component is moved vertically to the target storey's level (per-kind placement rules — e.g. a slab sits at the storey base, a wall on it) and its storey assignment, children, and dimension lines update together as **one undoable operation**.",
+    "examplePrompts": [
+      "Move this sofa to storey 2",
+      "Put the selected walls on the first basement level",
+      "Send everything on this storey up one level",
+      "Reassign these slabs to storey 3\n\n# Example\n```ts\n// Move the current selection up to storey 2\nconst selection = await snaptrude.design.selection.get()\nconst { affected } = await snaptrude.design.update.setStorey(selection, 2)\nconsole.log(\"moved\", affected.length, \"components\")\n```"
+    ],
+    "argsType": "ComponentHandle[]",
+    "resultType": "PluginDesignChangeResult"
+  },
+  {
+    "path": "design.update.slab",
+    "namespace": "design.update",
+    "summary": "Edit a **slab's** thickness and/or overhang — the same commands the properties panel's Thickness field and Overhang slider drive. Sparse: only the fields you provide change. Undoable; the slab rebuilds and dimension lines refresh. Both values are in **engine units** (the same convention as `design.doors.setWidth`); thickness must be `> 0`, overhang is an absolute offset (negative insets the slab) and re-applying the current overhang is a no-op.",
+    "examplePrompts": [
+      "Set this slab's thickness to 250mm",
+      "Make the floor slab 300 thick",
+      "Give this slab a 200 overhang",
+      "Remove the overhang on every slab on level 2\n\n# Example\n```ts\nconst [slab] = await snaptrude.design.query.listSlabs()\nawait snaptrude.design.update.slab(slab, { thickness: 250, overhang: 200 })\n```"
+    ],
+    "argsType": "ComponentHandle",
+    "resultType": "PluginDesignChangeResult"
+  },
   {
     "path": "design.update.space",
     "namespace": "design.update",
@@ -4839,6 +5203,59 @@
     "argsType": "ComponentHandle[]",
     "resultType": "PluginDesignChangeResult"
   },
+  {
+    "path": "design.update.wall",
+    "namespace": "design.update",
+    "summary": "Edit a **wall** — its thickness and/or height (the same command the properties panel's Thickness/Height fields drive) and/or its **wall type** (the panel's Wall Types dropdown: converts the wall to another type, rebuilding its layer stack and materials). Sparse: only the fields you provide change. Undoable; the geometry rebuilds and any dimension lines refresh. Stacked-wall companions and hosted fenestration are handled exactly as the panel does.",
+    "examplePrompts": [
+      "Make this wall 230mm thick",
+      "Set the selected wall's height to 3 metres",
+      "Thicken every exterior wall to 300",
+      "Change this wall to a Glass Wall",
+      "Convert all the partitions on this floor to Brick Wall\n\n# Example\n```ts\n// Convert every wall on storey 1 to the first listed wall type\nconst [wallType] = await snaptrude.design.types.list(\"wall\")\nconst walls = await snaptrude.design.query.listWalls({ storeys: [1] })\nfor (const wall of walls) {\nawait snaptrude.design.update.wall(wall, { type: wallType.id })\n}\n```"
+    ],
+    "argsType": "ComponentHandle",
+    "resultType": "PluginDesignChangeResult"
+  },
+  {
+    "path": "design.visibility.hide",
+    "namespace": "design.visibility",
+    "summary": "Hide entities from the viewport — the same as the \"Hide\" action. Undoable. Hosted door/window/void children ride along with their wall. Already-hidden entities stay hidden.",
+    "examplePrompts": [
+      "Hide the selected walls",
+      "Conceal these masses so I can see behind them",
+      "Hide every column on this floor",
+      "Make this furniture disappear from view\n\n# Example\n```ts\nconst walls = await snaptrude.design.query.listWalls({ storeys: [1] })\nconst { affected } = await snaptrude.design.visibility.hide(walls)\n```"
+    ],
+    "argsType": "ComponentHandle[]",
+    "resultType": "PluginDesignChangeResult"
+  },
+  {
+    "path": "design.visibility.isolate",
+    "namespace": "design.visibility",
+    "summary": "Isolate entities — hide everything else so only the given entities remain visible (the \"Isolate\" / solo action). Undoable. Reverse it with {@linkcode PluginDesignVisibilityApi.showAll}.",
+    "examplePrompts": [
+      "Isolate the selected room so I can focus on it",
+      "Show only these walls and hide the rest",
+      "Solo this mass",
+      "Hide everything except the staircase\n\n# Example\n```ts\nconst [room] = await snaptrude.design.selection.get()\nawait snaptrude.design.visibility.isolate([room])\n```"
+    ],
+    "argsType": "ComponentHandle[]",
+    "resultType": "PluginDesignChangeResult"
+  },
+  {
+    "path": "design.visibility.showAll",
+    "namespace": "design.visibility",
+    "summary": "Reveal everything hidden on the active story — the \"Show All\" action, which also exits an isolate. Undoable.",
+    "examplePrompts": [
+      "Show everything again",
+      "Unhide all the hidden objects",
+      "Exit isolate mode",
+      "Reveal everything I hid earlier\n\n# Example\n```ts\nconst { affected } = await snaptrude.design.visibility.showAll()\nconsole.log(`Revealed ${affected.length} entities`)\n```"
+    ],
+    "argsType": null,
+    "resultType": "PluginDesignChangeResult"
+  },
   {
     "path": "design.windows.exists",
     "namespace": "design.windows",
@@ -5065,6 +5482,19 @@
     "argsType": "number",
     "resultType": "PluginStoryCreateResult"
   },
+  {
+    "path": "entity.story.delete",
+    "namespace": "entity.story",
+    "summary": "Delete a story and everything on it — the same as removing it from the storey panel. Every element placed on the story (walls, floors, masses, …) is deleted with it, the remaining stories are re-stacked, and the active story falls back to an adjacent one. Committed as a single undo step.",
+    "examplePrompts": [
+      "Delete the top floor",
+      "Remove the basement level",
+      "Get rid of storey 3",
+      "Delete the second floor and everything on it\n\n# Example\n```ts\nconst { newActiveStory } = await snaptrude.entity.story.delete(3)\nconsole.log(`Deleted story 3; now on story ${newActiveStory}`)\n```"
+    ],
+    "argsType": "number",
+    "resultType": "PluginStoryDeleteResult"
+  },
   {
     "path": "entity.story.duplicate",
     "namespace": "entity.story",
@@ -5105,19 +5535,300 @@
     "argsType": null,
     "resultType": "PluginStoryGetAllResult"
   },
+  {
+    "path": "entity.story.setActive",
+    "namespace": "entity.story",
+    "summary": "Make a story the active story — the same as clicking it in the storey/layer panel. Subsequent draws and creates target this story, and in 2D the viewport switches to it. This is a view/navigation change: it is **not** undoable and commits nothing to the model.",
+    "examplePrompts": [
+      "Switch to the second floor",
+      "Make the ground storey active",
+      "Go to the basement level",
+      "Set level 3 as the current storey\n\n# Example\n```ts\n// Activate story 2, then draw a wall — it lands on story 2.\nawait snaptrude.entity.story.setActive(2)\n```"
+    ],
+    "argsType": "number",
+    "resultType": "PluginStorySetActiveResult"
+  },
   {
     "path": "entity.story.update",
     "namespace": "entity.story",
-    "summary": "Update a story's floor-to-floor height, cascading the full geometry change.",
+    "summary": "Update a story's floor-to-floor `height` and/or `name`.",
     "examplePrompts": [
       "Change the ground floor height to 3.5 metres",
       "Make the second storey taller",
+      "Rename the ground floor to \"Lobby\"",
       "Set the floor-to-floor height of level 1",
-      "Increase the height of the third floor\n\n# Example\n```ts\n// Set ground floor height to 5 Babylon units — walls stretch and the\n// floors above move up to match, all in a single undo step.\nconst result = await snaptrude.entity.story.update(1, 5)\n```"
+      "Rename storey 2 and make it taller in one go\n\n# Example\n```ts\n// Set ground floor height to 5 Babylon units — walls stretch and the\n// floors above move up to match, all in a single undo step.\nconst result = await snaptrude.entity.story.update(1, 5)\n// Rename only, leaving the height untouched.\nawait snaptrude.entity.story.update(1, undefined, { name: \"Lobby\" })\n```"
     ],
     "argsType": "number",
     "resultType": "PluginStoryUpdateResult"
   },
+  {
+    "path": "presentation.aiInspiration.cancelJob",
+    "namespace": "presentation.aiInspiration",
+    "summary": "Cancel a transient AI Inspiration job.",
+    "examplePrompts": [
+      "Cancel the running generation",
+      "Stop that AI job\n\n# Example\n```ts\nconst { job } = await snaptrude.presentation.aiInspiration.cancelJob({ jobId })\nconsole.log(job.status) // \"cancelled\" (or a terminal state it already reached)\n```"
+    ],
+    "argsType": "PluginAIInspirationJobArgs",
+    "resultType": "PluginAIInspirationCancelJobResult"
+  },
+  {
+    "path": "presentation.aiInspiration.deleteRecipe",
+    "namespace": "presentation.aiInspiration",
+    "summary": "Delete a project-level AI Inspiration recipe.",
+    "examplePrompts": [
+      "Delete the facade render recipe",
+      "Remove that saved AI recipe\n\n# Example\n```ts\nconst { recipes } = await snaptrude.presentation.aiInspiration.listRecipes()\nconst stale = recipes.find((r) => r.name === \"Old style test\")\nif (stale) {\nconst { deleted } = await snaptrude.presentation.aiInspiration.deleteRecipe({ recipeId: stale.id })\nconsole.log(deleted)\n}\n```"
+    ],
+    "argsType": "PluginAIInspirationDeleteRecipeArgs",
+    "resultType": "PluginAIInspirationDeleteRecipeResult"
+  },
+  {
+    "path": "presentation.aiInspiration.extractRecipeFromShape",
+    "namespace": "presentation.aiInspiration",
+    "summary": "Extract a reusable recipe draft from the workflow path ending at a shape.",
+    "examplePrompts": [
+      "Turn this workflow into a reusable recipe",
+      "Save the generation steps behind this image\n\n# Example\n```ts\nconst extraction = await snaptrude.presentation.aiInspiration.extractRecipeFromShape({\nshapeId: selected.shapeId,\n})\nif (extraction.status === \"ready\") console.log(extraction.draft.summary)\n```"
+    ],
+    "argsType": "PluginAIInspirationExtractRecipeFromShapeArgs",
+    "resultType": "PluginAIInspirationExtractionResult"
+  },
+  {
+    "path": "presentation.aiInspiration.generate",
+    "namespace": "presentation.aiInspiration",
+    "summary": "Generate an image or video from a Present canvas source.",
+    "examplePrompts": [
+      "Generate an image from this sketch",
+      "Render the selected view as a photorealistic image",
+      "Make an AI image of a modern facade from this source",
+      "Generate a video from this image",
+      "Turn this massing into a rendered street view\n\n# Example\n```ts\nconst { sources } = await snaptrude.presentation.aiInspiration.listSources({})\nconst [source, ...refs] = sources\nconst { outputs } = await snaptrude.presentation.aiInspiration.generate({\nsourceShapeId: source.shapeId,\nprompt: \"Photorealistic render of a modern timber facade at dusk\",\nreferenceShapeIds: refs.slice(0, 2).map((r) => r.shapeId),\nreferenceStrength: \"medium\",\n})\nfor (const out of outputs ?? []) console.log(out.outputType, out.shapeId, out.outputUrl)\n```"
+    ],
+    "argsType": "PluginAIInspirationGenerateArgs",
+    "resultType": "PluginAIInspirationRunResult"
+  },
+  {
+    "path": "presentation.aiInspiration.getJob",
+    "namespace": "presentation.aiInspiration",
+    "summary": "Get a transient AI Inspiration job by ID.",
+    "examplePrompts": [
+      "Is my render finished?",
+      "Check on the generation job\n\n# Example\n```ts\nconst { jobId } = await snaptrude.presentation.aiInspiration.generate({\nsourceShapeId: source.shapeId,\nprompt: \"Aerial dusk render\",\nrunMode: \"job\",\n})\nconst { job } = await snaptrude.presentation.aiInspiration.getJob({ jobId })\nconsole.log(job.status, job.progress?.message)\n```"
+    ],
+    "argsType": "PluginAIInspirationJobArgs",
+    "resultType": "PluginAIInspirationGetJobResult"
+  },
+  {
+    "path": "presentation.aiInspiration.getModelCapabilities",
+    "namespace": "presentation.aiInspiration",
+    "summary": "Get capability flags for a model.",
+    "examplePrompts": [
+      "What can this model do?",
+      "Does the default model support reference images?",
+      "Check if the video model supports keyframes\n\n# Example\n```ts\nconst { defaultModelId } = await snaptrude.presentation.aiInspiration.listModels()\nconst { capability } = await snaptrude.presentation.aiInspiration.getModelCapabilities({\nmodelId: defaultModelId,\n})\nconsole.log(capability.supportsReferenceImages, capability.maxExtraImages)\n```"
+    ],
+    "argsType": "PluginAIInspirationGetModelCapabilitiesArgs",
+    "resultType": "PluginAIInspirationGetModelCapabilitiesResult"
+  },
+  {
+    "path": "presentation.aiInspiration.getPresetCatalog",
+    "namespace": "presentation.aiInspiration",
+    "summary": "Get the curated AI Inspiration preset catalog.",
+    "examplePrompts": [
+      "What style presets are available?",
+      "List the curated AI generation presets",
+      "Show me the exterior render styles\n\n# Example\n```ts\nconst { categories, presets } = await snaptrude.presentation.aiInspiration.getPresetCatalog()\nconst exterior = presets.filter((p) => p.categoryLabel === \"Exterior\")\nconsole.log(categories.map((c) => c.label), exterior.map((p) => p.name))\n```"
+    ],
+    "argsType": null,
+    "resultType": "PluginAIInspirationGetPresetCatalogResult"
+  },
+  {
+    "path": "presentation.aiInspiration.getSelectedBranchRerunPlan",
+    "namespace": "presentation.aiInspiration",
+    "summary": "Build a rerun plan for the selected workflow branch ending at a shape.",
+    "examplePrompts": [
+      "Can I rerun the steps that produced this output?",
+      "Preview the rerun for this generated image\n\n# Example\n```ts\nconst plan = await snaptrude.presentation.aiInspiration.getSelectedBranchRerunPlan({\nshapeId: selected.shapeId,\n})\nif (plan.status === \"ready\") console.log(plan.edges.map((e) => e.operation.label))\nelse console.log(\"Cannot rerun:\", plan.reason)\n```"
+    ],
+    "argsType": "PluginAIInspirationGetWorkflowForShapeArgs",
+    "resultType": "PluginAIInspirationRerunPlanResult"
+  },
+  {
+    "path": "presentation.aiInspiration.getSelection",
+    "namespace": "presentation.aiInspiration",
+    "summary": "Get selected Present canvas shapes that AI Inspiration can use.",
+    "examplePrompts": [
+      "Generate from what I have selected",
+      "Which of my selected shapes can be used as AI sources?\n\n# Example\n```ts\nconst { selectedShapeIds, sources } = await snaptrude.presentation.aiInspiration.getSelection()\nconsole.log(selectedShapeIds.length, \"selected,\", sources.length, \"usable\")\n```"
+    ],
+    "argsType": null,
+    "resultType": "PluginAIInspirationGetSelectionResult"
+  },
+  {
+    "path": "presentation.aiInspiration.getWorkflowForShape",
+    "namespace": "presentation.aiInspiration",
+    "summary": "Get the sanitized workflow graph containing a Present shape.",
+    "examplePrompts": [
+      "Show the generation history of this image",
+      "What workflow produced this shape?\n\n# Example\n```ts\nconst { workflow, node } = await snaptrude.presentation.aiInspiration.getWorkflowForShape({\nshapeId: selected.shapeId,\n})\nif (workflow && node) console.log(node.id, workflow.edgeIds.length, \"edges\")\n```"
+    ],
+    "argsType": "PluginAIInspirationGetWorkflowForShapeArgs",
+    "resultType": "PluginAIInspirationGetWorkflowForShapeResult"
+  },
+  {
+    "path": "presentation.aiInspiration.listJobs",
+    "namespace": "presentation.aiInspiration",
+    "summary": "List transient AI Inspiration jobs created in the current host session.",
+    "examplePrompts": [
+      "What AI jobs are running?",
+      "Show my generation queue\n\n# Example\n```ts\nconst { jobs } = await snaptrude.presentation.aiInspiration.listJobs()\nconst running = jobs.filter((j) => j.status === \"running\" || j.status === \"queued\")\nconsole.log(running.map((j) => `${j.jobId}: ${j.method}`))\n```"
+    ],
+    "argsType": null,
+    "resultType": "PluginAIInspirationListJobsResult"
+  },
+  {
+    "path": "presentation.aiInspiration.listModels",
+    "namespace": "presentation.aiInspiration",
+    "summary": "List AI Inspiration models that can be used for generation.",
+    "examplePrompts": [
+      "What AI inspiration models can I use?",
+      "List the available image and video models",
+      "Which generation model is the default?\n\n# Example\n```ts\nconst { defaultModelId, models } = await snaptrude.presentation.aiInspiration.listModels()\nconst videoModels = models.filter((m) => m.output === \"video\")\nconsole.log(defaultModelId, videoModels.map((m) => m.id))\n```"
+    ],
+    "argsType": null,
+    "resultType": "PluginAIInspirationListModelsResult"
+  },
+  {
+    "path": "presentation.aiInspiration.listRecipes",
+    "namespace": "presentation.aiInspiration",
+    "summary": "List project-level AI Inspiration recipes stored in Present document metadata.",
+    "examplePrompts": [
+      "What AI recipes are saved in this project?",
+      "List my generation recipes\n\n# Example\n```ts\nconst { recipes } = await snaptrude.presentation.aiInspiration.listRecipes()\nconsole.log(recipes.map((r) => `${r.name} → ${r.outputKind}`))\n```"
+    ],
+    "argsType": null,
+    "resultType": "PluginAIInspirationListRecipesResult"
+  },
+  {
+    "path": "presentation.aiInspiration.listSources",
+    "namespace": "presentation.aiInspiration",
+    "summary": "List image/view/video sources on the current Present page.",
+    "examplePrompts": [
+      "List the images I can generate from on this page",
+      "What source shapes are on the present canvas?",
+      "Show me the reference images available for AI generation\n\n# Example\n```ts\nconst { sources } = await snaptrude.presentation.aiInspiration.listSources({ includeGenerated: true })\nfor (const s of sources) console.log(s.kind, s.shapeId, s.name)\n```"
+    ],
+    "argsType": "PluginAIInspirationListSourcesArgs",
+    "resultType": "PluginAIInspirationListSourcesResult"
+  },
+  {
+    "path": "presentation.aiInspiration.refine",
+    "namespace": "presentation.aiInspiration",
+    "summary": "Refine/upscale an AI Inspiration source image.",
+    "examplePrompts": [
+      "Upscale this AI image",
+      "Refine and sharpen the selected render",
+      "Make this generated image higher resolution\n\n# Example\n```ts\nconst { sources } = await snaptrude.presentation.aiInspiration.listSources({ includeGenerated: true })\nconst image = sources.find((s) => s.kind === \"image\")\nif (image) {\nconst { outputs } = await snaptrude.presentation.aiInspiration.refine({\nsourceShapeId: image.shapeId,\nupscaleFactor: 2,\n})\nconsole.log(outputs?.[0]?.shapeId)\n}\n```"
+    ],
+    "argsType": "PluginAIInspirationRefineArgs",
+    "resultType": "PluginAIInspirationRunResult"
+  },
+  {
+    "path": "presentation.aiInspiration.rerunSelectedBranch",
+    "namespace": "presentation.aiInspiration",
+    "summary": "Rerun the selected workflow branch and supersede the previous branch.",
+    "examplePrompts": [
+      "Rerun this generation branch",
+      "Regenerate this output with the same steps\n\n# Example\n```ts\nconst { outputs } = await snaptrude.presentation.aiInspiration.rerunSelectedBranch({\nshapeId: selected.shapeId,\n})\nconsole.log(outputs?.map((o) => o.shapeId))\n```"
+    ],
+    "argsType": "PluginAIInspirationRerunSelectedBranchArgs",
+    "resultType": "PluginAIInspirationRunResult"
+  },
+  {
+    "path": "presentation.aiInspiration.runRecipe",
+    "namespace": "presentation.aiInspiration",
+    "summary": "Run a saved or inline recipe against Present canvas slot shapes.",
+    "examplePrompts": [
+      "Apply my saved recipe to this image",
+      "Run the dusk-render recipe on the selected view\n\n# Example\n```ts\nconst { recipes } = await snaptrude.presentation.aiInspiration.listRecipes()\nconst recipe = recipes[0]\nconst { sources } = await snaptrude.presentation.aiInspiration.listSources({})\nconst { outputs } = await snaptrude.presentation.aiInspiration.runRecipe({\nrecipeId: recipe.id,\nslotShapeIds: { [recipe.slots[0].id]: sources[0].shapeId },\n})\nconsole.log(outputs?.map((o) => o.outputUrl))\n```"
+    ],
+    "argsType": "PluginAIInspirationRunRecipeArgs",
+    "resultType": "PluginAIInspirationRunResult"
+  },
+  {
+    "path": "presentation.aiInspiration.saveRecipe",
+    "namespace": "presentation.aiInspiration",
+    "summary": "Save a project-level AI Inspiration recipe.",
+    "examplePrompts": [
+      "Save this recipe as \"Dusk facade render\"",
+      "Store these generation steps for reuse\n\n# Example\n```ts\nconst extraction = await snaptrude.presentation.aiInspiration.extractRecipeFromShape({\nshapeId: selected.shapeId,\n})\nif (extraction.status === \"ready\") {\nconst saved = await snaptrude.presentation.aiInspiration.saveRecipe({\ndraft: extraction.draft,\nname: \"Dusk facade render\",\n})\nconsole.log(saved.status, saved.recipe?.id)\n}\n```"
+    ],
+    "argsType": "PluginAIInspirationSaveRecipeArgs",
+    "resultType": "PluginAIInspirationSaveRecipeResult"
+  },
+  {
+    "path": "presentation.annotate.arrow",
+    "namespace": "presentation.annotate",
+    "summary": "Draw an arrow on a sheet.",
+    "examplePrompts": [
+      "Draw an arrow pointing at the entrance on Sheet 1",
+      "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",
+    "resultType": "PluginPresentationAnnotateResult"
+  },
+  {
+    "path": "presentation.annotate.note",
+    "namespace": "presentation.annotate",
+    "summary": "Add a sticky note to a sheet.",
+    "examplePrompts": [
+      "Add a sticky note \"Review this wall\" to Sheet 1",
+      "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",
+    "resultType": "PluginPresentationAnnotateResult"
+  },
+  {
+    "path": "presentation.annotate.shape",
+    "namespace": "presentation.annotate",
+    "summary": "Draw a geo shape (rectangle, ellipse, cloud, …) on a sheet.",
+    "examplePrompts": [
+      "Draw a revision cloud around the kitchen on Sheet 2",
+      "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",
+    "resultType": "PluginPresentationAnnotateResult"
+  },
+  {
+    "path": "presentation.annotate.text",
+    "namespace": "presentation.annotate",
+    "summary": "Add a text label to a sheet.",
+    "examplePrompts": [
+      "Add a title \"Ground Floor\" to Sheet 1",
+      "Label the cover sheet with the project name",
+      "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",
+    "resultType": "PluginPresentationAnnotateTextResult"
+  },
+  {
+    "path": "presentation.diagrams.generateProgram",
+    "namespace": "presentation.diagrams",
+    "summary": "Generate the program (space + department) diagrams for the current model, creating new layout sheets.",
+    "examplePrompts": [
+      "Generate the program diagrams for this project",
+      "Auto-generate the space and department diagram sheets",
+      "Create the program layout sheets from the model\n\n# Example\n```ts\nconst { sheetIds } = await snaptrude.presentation.diagrams.generateProgram()\n```"
+    ],
+    "argsType": null,
+    "resultType": "PluginPresentationDiagramsGenerateResult"
+  },
   {
     "path": "presentation.diagrams.place",
     "namespace": "presentation.diagrams",
@@ -5130,6 +5841,20 @@
     "argsType": "string",
     "resultType": "PluginPresentationDiagramsPlaceResult"
   },
+  {
+    "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.",
+    "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```"
+    ],
+    "argsType": "PluginPresentationExportFormat",
+    "resultType": "PluginPresentationExportResult"
+  },
   {
     "path": "presentation.import.image",
     "namespace": "presentation.import",
@@ -5175,12 +5900,25 @@
     "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```"
+      "Add an A3 landscape layout sheet",
+      "Make a new ANSI D presentation sheet named Floor Plans",
+      "Create a portrait A4 sheet\n\n# Example\n```ts\nconst sheet = await snaptrude.presentation.sheets.create(\"Cover\", {\nsize: \"ISO_A3\",\norientation: \"landscape\",\n})\n```"
     ],
     "argsType": "string",
     "resultType": "PluginPresentationSheet"
   },
+  {
+    "path": "presentation.sheets.delete",
+    "namespace": "presentation.sheets",
+    "summary": "Delete a layout sheet.",
+    "examplePrompts": [
+      "Delete sheet_2",
+      "Remove the Cover sheet",
+      "Get rid of the last layout sheet\n\n# Example\n```ts\nconst { id } = await snaptrude.presentation.sheets.delete(\"sheet_2\")\n```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginPresentationSheetsDeleteResult"
+  },
   {
     "path": "presentation.sheets.get",
     "namespace": "presentation.sheets",
@@ -5214,11 +5952,73 @@
       "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```"
+      "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```"
     ],
     "argsType": "string",
     "resultType": "PluginPresentationSheetsPlaceResult"
   },
+  {
+    "path": "presentation.sheets.rename",
+    "namespace": "presentation.sheets",
+    "summary": "Rename a layout sheet.",
+    "examplePrompts": [
+      "Rename sheet_1 to Cover",
+      "Call the first sheet Ground Floor",
+      "Change this sheet's name to Site Plan\n\n# Example\n```ts\nconst sheet = await snaptrude.presentation.sheets.rename(\"sheet_1\", \"Cover\")\n```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginPresentationSheet"
+  },
+  {
+    "path": "presentation.sheets.reorder",
+    "namespace": "presentation.sheets",
+    "summary": "Move a sheet to a new position in the sheet order.",
+    "examplePrompts": [
+      "Move sheet_3 to the front",
+      "Make the Cover sheet the first sheet",
+      "Reorder this sheet to position 2\n\n# Example\n```ts\nconst { sheets } = await snaptrude.presentation.sheets.reorder(\"sheet_3\", 0)\n```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginPresentationSheetsListResult"
+  },
+  {
+    "path": "presentation.sheets.setActive",
+    "namespace": "presentation.sheets",
+    "summary": "Make a sheet the active sheet.",
+    "examplePrompts": [
+      "Go to sheet_1",
+      "Open the Cover sheet",
+      "Switch to the Site Plan sheet\n\n# Example\n```ts\nawait snaptrude.presentation.sheets.setActive(\"sheet_1\")\n```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginPresentationSheet"
+  },
+  {
+    "path": "presentation.sheets.setSize",
+    "namespace": "presentation.sheets",
+    "summary": "Set a sheet's paper size and/or orientation.",
+    "examplePrompts": [
+      "Resize sheet_1 to A1",
+      "Make the cover sheet ANSI B portrait",
+      "Change this sheet to Arch D landscape",
+      "Set the sheet size to A3\n\n# Example\n```ts\nconst sheet = await snaptrude.presentation.sheets.setSize(\"sheet_1\", \"ISO_A1\", \"portrait\")\n```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginPresentationSheet"
+  },
+  {
+    "path": "presentation.sheets.updatePlacedView",
+    "namespace": "presentation.sheets",
+    "summary": "Refresh placed views to the current model state.",
+    "examplePrompts": [
+      "Update all the placed views to the latest model",
+      "Refresh the views on sheet_1",
+      "Re-render the placed views after my edits\n\n# Example\n```ts\nconst { shapeIds } = await snaptrude.presentation.sheets.updatePlacedView()\n```"
+    ],
+    "argsType": "{\n    sheetId?: string\n  }",
+    "resultType": "PluginPresentationSheetsUpdatePlacedViewResult"
+  },
   {
     "path": "presentation.views.capture",
     "namespace": "presentation.views",
@@ -5240,11 +6040,24 @@
       "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```"
+      "Save the current 2D plan as a view",
+      "Save a view on the second storey\n\n# Example\n```ts\nconst view = await snaptrude.presentation.views.create(\"Lobby\")\n// …or capture the view on a specific storey\nconst level2 = await snaptrude.presentation.views.create(\"Level 2\", { storey: 2 })\n```"
     ],
     "argsType": "string",
     "resultType": "PluginPresentationViewsCreateResult"
   },
+  {
+    "path": "presentation.views.delete",
+    "namespace": "presentation.views",
+    "summary": "Delete a saved view.",
+    "examplePrompts": [
+      "Delete the view named Old Draft",
+      "Remove this saved view",
+      "Get rid of the Lobby camera bookmark\n\n# Example\n```ts\nconst { id } = await snaptrude.presentation.views.delete(\"view_123\")\n```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginPresentationViewsDeleteResult"
+  },
   {
     "path": "presentation.views.get",
     "namespace": "presentation.views",
@@ -5272,7 +6085,7 @@
   {
     "path": "presentation.views.getSettings",
     "namespace": "presentation.views",
-    "summary": "Read a saved view's display settings (background, color mode, axis, edges, labels).",
+    "summary": "Read a saved view's display settings (background, color mode, view mode, axis, edges, labels).",
     "examplePrompts": [
       "What color mode is the Ground Floor view using?",
       "Get the display settings for this view",
@@ -5296,6 +6109,18 @@
     "argsType": null,
     "resultType": "PluginPresentationViewsListResult"
   },
+  {
+    "path": "presentation.views.rename",
+    "namespace": "presentation.views",
+    "summary": "Rename a saved view.",
+    "examplePrompts": [
+      "Rename the view Lobby to Entrance Lobby",
+      "Call this view Ground Floor Plan",
+      "Change the active view's name to Final\n\n# Example\n```ts\nconst view = await snaptrude.presentation.views.rename(\"view_123\", \"Entrance\")\n```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginPresentationViewsRenameResult"
+  },
   {
     "path": "presentation.views.setActive",
     "namespace": "presentation.views",
@@ -5318,7 +6143,8 @@
       "Turn off the axis in the Ground Floor view",
       "Set the background of the active view to white",
       "Show area labels on this view",
-      "Enable hidden-line mode for the section view\n\n# Example\n```ts\nawait snaptrude.presentation.views.updateSettings(\"view_123\", {\ncolorMode: \"monochrome\",\nshowAxis: false,\n})\n```"
+      "Enable hidden-line mode for the section view",
+      "Make the 3D view orthographic instead of perspective\n\n# Example\n```ts\nawait snaptrude.presentation.views.updateSettings(\"view_123\", {\ncolorMode: \"monochrome\",\nshowAxis: false,\n})\n// switch a 3D view to an isometric (orthographic) projection\nawait snaptrude.presentation.views.updateSettings(\"view_123\", {\nviewMode: \"isometric\",\n})\n```"
     ],
     "argsType": "string",
     "resultType": "PluginPresentationViewsUpdateSettingsResult"
@@ -5390,6 +6216,18 @@
     "argsType": "PluginProgramAreaGroupBy",
     "resultType": "PluginProgramAreasListMembersResult"
   },
+  {
+    "path": "program.areas.refresh",
+    "namespace": "program.areas",
+    "summary": "Force the area breakdown to recompute, then return the fresh summary.",
+    "examplePrompts": [
+      "Recompute the area totals before I read them",
+      "Refresh the FAR numbers",
+      "Make sure the area breakdown is up to date\n\n# Example\n```ts\nconst s = await snaptrude.program.areas.refresh()\nconst { groups } = await snaptrude.program.areas.list(\"storeys\") // now fresh\nconsole.log(s.builtUp, groups.length)\n```"
+    ],
+    "argsType": null,
+    "resultType": "PluginProgramAreasRefreshResult"
+  },
   {
     "path": "program.areas.update",
     "namespace": "program.areas",
@@ -5399,7 +6237,7 @@
       "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 }",
+    "argsType": "{\n    targetFar?: number\n    siteArea?: number\n    deviation?: number\n  }",
     "resultType": "PluginProgramAreasUpdateResult"
   },
   {
@@ -5544,6 +6382,18 @@
     "argsType": "string",
     "resultType": "PluginProgramDepartmentsUpdateResult"
   },
+  {
+    "path": "program.layout.applySolution",
+    "namespace": "program.layout",
+    "summary": "Apply one of the pending arrange solutions.",
+    "examplePrompts": [
+      "Apply the second arrange solution",
+      "Pick layout solution 3 and commit it",
+      "Apply the arrange solution I chose\n\n# Example\n```ts\nawait snaptrude.program.layout.arrange({ autoCommit: false })\nlet job = await snaptrude.program.layout.getState()\nwhile (job?.status === \"running\") {\nawait new Promise((r) => setTimeout(r, 5000))\njob = await snaptrude.program.layout.getState()\n}\nif (job?.status === \"pendingReview\") {\nconsole.log(`${job.totalSolutions} candidate layouts`)\nawait snaptrude.program.layout.applySolution(1) // commit the second one\n}\n```"
+    ],
+    "argsType": "number",
+    "resultType": "PluginProgramLayoutApplyResult"
+  },
   {
     "path": "program.layout.arrange",
     "namespace": "program.layout",
@@ -5551,7 +6401,8 @@
     "examplePrompts": [
       "Arrange the rooms in the envelope",
       "Lay out the departments inside the building envelope",
-      "Auto-arrange the program spaces\n\n# Example\n```ts\nconst { success, error } = await snaptrude.program.layout.arrange()\nif (!success) throw new Error(error)\n// poll until the layout is applied\nlet job = await snaptrude.program.layout.getState()\nwhile (job?.status === \"running\") {\nawait new Promise((r) => setTimeout(r, 5000))\njob = await snaptrude.program.layout.getState()\n}\n```"
+      "Auto-arrange the program spaces",
+      "Arrange the rooms but let me pick the solution\n\n# Example\n```ts\nconst { success, error } = await snaptrude.program.layout.arrange()\nif (!success) throw new Error(error)\n// poll until the layout is applied\nlet job = await snaptrude.program.layout.getState()\nwhile (job?.status === \"running\") {\nawait new Promise((r) => setTimeout(r, 5000))\njob = await snaptrude.program.layout.getState()\n}\n```"
     ],
     "argsType": "PluginProgramLayoutRunArgs",
     "resultType": "PluginProgramLayoutRunResult"
@@ -5592,6 +6443,18 @@
     "argsType": "PluginProgramLayoutRunArgs",
     "resultType": "PluginProgramLayoutRunResult"
   },
+  {
+    "path": "program.layout.stack",
+    "namespace": "program.layout",
+    "summary": "Stack the program across **every storey** of the building — the product's *Pack in envelope* / auto-stack.",
+    "examplePrompts": [
+      "Stack the program across all floors",
+      "Auto-stack the departments into the envelope on every storey",
+      "Pack the whole building's program into its envelope\n\n# Example\n```ts\nconst { success, skippedStoreys, error } = await snaptrude.program.layout.stack()\nif (!success) throw new Error(error)\nif (skippedStoreys.length)\nconsole.warn(`No envelope on storeys: ${skippedStoreys.join(\", \")}`)\n```"
+    ],
+    "argsType": null,
+    "resultType": "PluginProgramLayoutStackResult"
+  },
   {
     "path": "program.metrics.get",
     "namespace": "program.metrics",
@@ -5686,7 +6549,7 @@
   {
     "path": "program.site.listPolygons",
     "namespace": "program.site",
-    "summary": "List the site parcels with their footprints (in scene coordinates).",
+    "summary": "List the site parcels with their footprints (world XZ plan coordinates, Snaptrude units).",
     "examplePrompts": [
       "List every site parcel",
       "Show me each plot's footprint",
@@ -5754,7 +6617,7 @@
       "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 }",
+    "argsType": "{\n    name?: string\n  }",
     "resultType": "PluginProgramSpreadsheetBindingsRefreshResult"
   },
   {
@@ -5773,12 +6636,13 @@
   {
     "path": "program.spreadsheet.export",
     "namespace": "program.spreadsheet",
-    "summary": "Export the whole report workbook to a file (xlsx, pdf, or csv).",
+    "summary": "Export the 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```"
+      "Save the report as a csv file",
+      "Export the Takeoff sheet as CSV\n\n# Example\n```ts\nconst file = await snaptrude.program.spreadsheet.export(\"xlsx\")\n// file.fileName, file.mimeType, file.dataBase64\n\n// CSV of a specific sheet:\nconst csv = await snaptrude.program.spreadsheet.export(\"csv\", { sheetName: \"Takeoff\" })\n```"
     ],
     "argsType": "PluginSpreadsheetExportFormat",
     "resultType": "PluginProgramSpreadsheetExportResult"
@@ -5793,9 +6657,23 @@
       "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 }",
+    "argsType": "{\n    limit?: number\n  }",
     "resultType": "PluginProgramSpreadsheetGetAuditLogResult"
   },
+  {
+    "path": "program.spreadsheet.getMaterialTakeoff",
+    "namespace": "program.spreadsheet",
+    "summary": "Read the material take-off dataset (surface area per material, per element type).",
+    "examplePrompts": [
+      "Get the material take-off",
+      "How much of each material is used?",
+      "Read the surface area by material",
+      "Give me the material quantities before I render them",
+      "What's in the material take-off right now?\n\n# Example\n```ts\nconst mto = await snaptrude.program.spreadsheet.getMaterialTakeoff()\nfor (const row of mto.rows) {\nconsole.log(row.objectType, row.family, row.material, row.quantity, row.unit)\n}\n```"
+    ],
+    "argsType": null,
+    "resultType": "PluginProgramSpreadsheetGetMaterialTakeoffResult"
+  },
   {
     "path": "program.spreadsheet.getProgram",
     "namespace": "program.spreadsheet",
@@ -5894,7 +6772,7 @@
       "Recompute all the formulas",
       "Recalculate the Summary sheet\n\n# Example\n```ts\nawait snaptrude.program.spreadsheet.recalculate()\n```"
     ],
-    "argsType": "{ sheetName?: string }",
+    "argsType": "{\n    sheetName?: string\n  }",
     "resultType": "PluginProgramSpreadsheetRecalculateResult"
   },
   {
@@ -5921,7 +6799,7 @@
       "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 }",
+    "argsType": "{\n    sheetName?: string\n    title?: string\n    filter?: string\n  }",
     "resultType": "PluginProgramSpreadsheetRenderResult"
   },
   {
@@ -5934,7 +6812,7 @@
       "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 }",
+    "argsType": "{\n    sheetName?: string\n    title?: string\n    filter?: string\n  }",
     "resultType": "PluginProgramSpreadsheetRenderResult"
   },
   {