@snaptrude/plugin-core 0.7.0 → 0.8.0

package/CHANGELOG.md

@@ -1,5 +1,27 @@
 # @snaptrude/plugin-core
 
+## 0.8.0
+
+### Minor Changes
+
+- More additions to the APIs, infra changes.
+- Plugin API 0.8.0 — the 0.8 API wave, handle lifecycle, events, and geometry/data-integrity fixes.
+
+  - **The 0.8 API wave** — model/presentation **export** (`core.io.export`, `presentation.export`), **element editing** widenings on `design.update`/`design.edit`, **`core.camera.*`**, **storey management**, **`design.visibility.*`**, **dimensions**, **locale/user** reads (`core.user`), `design.types.list`, presentation annotate, plus completeness widenings across existing families. The discovery manifest grows from 423 to 595 method paths (including the new `core.handles.*` lifecycle below).
+  - **Events** — `model:changed` subscription contract: debounced model-change notifications delivered to the plugin worker for user and plugin edits alike (client API: `PluginWorker.subscribe`). `selection:changed`, `tool:activated`, `project:saved`, `view:changed` are reserved names, not yet emitted.
+  - **BREAKING — `program.site` footprints are world Snaptrude units.** Previously the only plan-geometry read scaled to scene metres (×0.254), so site parcels could not be overlaid on `planPoints`. Now the same world XZ plan space as every other plan read; areas and the geographic reads are unchanged.
+  - **BREAKING — real beam/column geometry.** `design.create.beam` with a horizontal direction (the documented canonical call) used to build a zero-height flat sheet; it now builds a true beam with tool-parity semantics (section X extent = width, Z extent = depth, body hangs below the authoring plane by its depth). `design.create.column` builds exactly the requested height (the silent slab-thickness deduction is gone). Degenerate extrusions (zero/diagonal/in-plane directions, zero height) throw VALIDATION errors instead of silently building corrupt solids; directions are normalized.
+  - **Data integrity** — `design.query.list*` no longer returns engine-internal shells (originals parked by instance copies, disposed phantoms), so one copy no longer doubles `listSpaces`/schedules; `design.delete.entities` orders instance copies before their source meshes so mixed batches cannot fail midway; `design.update.wall` documents that rebuilds replace the wall — re-bind from `affected[0]`.
+  - **Handle lifecycle (`core.handles.*`) + GC-backed `Handle` objects** — `Handle` is now a class wrapping the wire id (public type names unchanged): `handle.id`, `toString()` stays the bare id, `equals()` compares by id, and `toJSON()` emits the `{__h: id}` wire tag — `JSON.stringify` output containing handles changes shape. New namespace: `core.handles.release(handles[])` (batched, arena-agnostic, silent no-op on unknown/released ids), `core.handles.releaseAll(kind?)`, mint-recording scopes `beginScope()` / `endScope(scope, retain?)` (token-addressed, retain promotes to the enclosing scope), and `core.handles.stats()`. The client runs a FinalizationRegistry-backed auto-release queue, so unreferenced handles are reclaimed host-side without explicit code. `core.geom.delete.profile/contour` are retained as deprecated aliases of `core.handles.release`. Entity-style kinds (component/material/underlay/terrain/importJob) remain branded strings.
+
+## 0.7.1
+
+### Patch Changes
+
+- 8f22cb7: Expand `presentation.aiInspiration` to the full AI Inspiration surface (18 methods) and make it a required member of `PluginPresentationApi` now that the host implementation lands.
+  - New methods: `getModelCapabilities`, `getSelection`, `getPresetCatalog`, `getJob`, `cancelJob`, `listJobs`, `getWorkflowForShape`, `getSelectedBranchRerunPlan`, `rerunSelectedBranch`, `extractRecipeFromShape`, `listRecipes`, `saveRecipe`, `deleteRecipe`, `runRecipe` (plus job/workflow/recipe Zod schemas).
+  - `generate`/`refine` (and `rerunSelectedBranch`/`runRecipe`) accept `runMode: "blocking" | "job"`; `PluginAIInspirationRunResult` is accordingly loosened to `{ jobId?, output?, outputs?, metadata? }` — job-mode calls resolve with a `jobId` instead of outputs.
+
 ## 0.7.0
 
 ### Minor Changes

package/api-manifest.full.json

@@ -347,6 +347,46 @@
     "argsType": "string",
     "resultType": "PluginCoreBuildingsUpdateResult"
   },
+  {
+    "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.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",
@@ -2023,6 +2063,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 +2130,19 @@
     "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 a glTF binary\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",
@@ -3055,9 +3148,9 @@
     "namespace": "core.proposals",
     "summary": "Delete a proposal.",
     "examplePrompts": [
-      "Delete proposal prop_2",
-      "Remove this design option and everything in it",
-      "Merge prop_2's layers into prop_1 and delete prop_2\n\n# Example\n```ts\nawait snaptrude.core.proposals.delete(\"prop_2\", { deleteObjects: true })\n```"
+      "Delete proposal prop_2 and everything in it",
+      "Remove this design option and destroy its geometry",
+      "Merge prop_2's layers into prop_1 and delete prop_2\n\n# Example\n```ts\n// destroy the proposal and its exclusive geometry\nawait snaptrude.core.proposals.delete(\"prop_2\", { deleteObjects: true })\n// …or keep the geometry by transferring its buckets to prop_1 first\nawait snaptrude.core.proposals.delete(\"prop_2\", { targetProposalId: \"prop_1\" })\n```"
     ],
     "argsType": "string",
     "resultType": "PluginCoreProposalsDeleteResult"
@@ -3379,6 +3472,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",
@@ -3604,7 +3710,7 @@
       "Apply this furniture arrangement to the other offices",
       "Replicate this template into these two spaces",
       "Place this desk cluster into every meeting room",
-      "Use this room as a template for the rooms I selected but keep them visible\n\n# Example\n```ts\nconst [templateRoom, ...targets] = await snaptrude.design.query.listSpaces({ isSelected: true })\nconst result = await snaptrude.design.create.smartLayout({\ntemplateComponents: [templateRoom],\ntargets,\n})\nconsole.log(\"placed walls:\", result.created.walls.length, \"skipped:\", result.skippedWalls)\n```"
+      "Use this room as a template for the rooms I selected but keep them visible\n\n# Example\n```ts\nconst [templateRoom, ...targets] = await snaptrude.design.query.listSpaces({ isSelected: true })\nconst result = await snaptrude.design.create.smartLayout({\ntemplateComponents: [templateRoom],\ntargets,\n})\nconsole.log(\"placed walls:\", result.created.walls.length, \"skipped:\", result.skippedWalls)\n\n// …or clone a saved group by its id (from core.groups.list)\nconst { groups } = await snaptrude.core.groups.list()\nawait snaptrude.design.create.smartLayout({ templateGroup: groups[0].id, targets })\n```"
     ],
     "argsType": "PluginSmartLayoutArgs",
     "resultType": "PluginSmartLayoutResult"
@@ -3718,6 +3824,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 +4048,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 +4088,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",
@@ -4731,6 +4876,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",
@@ -4758,6 +4917,32 @@
     "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 +4969,68 @@
     "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`.",
+    "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`.",
+    "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 — the slab-family updater for roofs (shares the slab thickness command). Undoable. Thickness is in **engine units** (the `design.doors.setWidth` convention) and must be `> 0`.",
+    "examplePrompts": [
+      "Make this roof 300mm thick",
+      "Set the roof slab thickness to 250",
+      "Thicken every roof to 350\n\n# Example\n```ts\nconst [roof] = await snaptrude.design.query.listRoofs()\nawait snaptrude.design.update.roof(roof, { thickness: 300 })\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 +5044,18 @@
     "argsType": "ComponentHandle",
     "resultType": "boolean"
   },
+  {
+    "path": "design.update.slab",
+    "namespace": "design.update",
+    "summary": "Edit a **slab's** thickness — the same command the properties panel's Thickness field drives. Undoable; the slab rebuilds and dimension lines refresh. The thickness is in **engine units** (the same convention as `design.doors.setWidth`) and must be `> 0`.",
+    "examplePrompts": [
+      "Set this slab's thickness to 250mm",
+      "Make the floor slab 300 thick",
+      "Thicken every slab on level 2 to 200\n\n# Example\n```ts\nconst [slab] = await snaptrude.design.query.listSlabs()\nawait snaptrude.design.update.slab(slab, { thickness: 250 })\n```"
+    ],
+    "argsType": "ComponentHandle",
+    "resultType": "PluginDesignChangeResult"
+  },
   {
     "path": "design.update.space",
     "namespace": "design.update",
@@ -4839,6 +5098,59 @@
     "argsType": "ComponentHandle[]",
     "resultType": "PluginDesignChangeResult"
   },
+  {
+    "path": "design.update.wall",
+    "namespace": "design.update",
+    "summary": "Edit a **wall's** dimensions — its thickness and/or height — the same command the properties panel's Thickness/Height fields drive. 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",
+      "Raise all the walls on this floor to 3200 tall",
+      "Change this partition to 100mm thick and 2700 high\n\n# Example\n```ts\n// Standardise every wall on storey 1 to a 230mm thickness\nconst walls = await snaptrude.design.query.listWalls({ storeys: [1] })\nfor (const wall of walls) {\nawait snaptrude.design.update.wall(wall, { thickness: 230 })\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 +5377,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,15 +5430,29 @@
     "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"
@@ -5180,6 +5519,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",
@@ -5209,7 +5562,7 @@
   {
     "path": "presentation.import.svg",
     "namespace": "presentation.import",
-    "summary": "Import an SVG onto the current Present sheet as a true vector asset.",
+    "summary": "Import an SVG onto the current Present sheet as a vector asset.",
     "examplePrompts": [
       "Import this SVG diagram onto the present canvas",
       "Add a vector logo to my presentation board",
@@ -5478,18 +5831,6 @@
     "argsType": null,
     "resultType": "PluginProgramClassificationTypesResult"
   },
-  {
-    "path": "program.cores.create",
-    "namespace": "program.cores",
-    "summary": "Generate core geometry from a layout (thin trigger).",
-    "examplePrompts": [
-      "Generate the building cores from this layout",
-      "Place the elevator and stair cores",
-      "Create the service core shells\n\n# Example\n```ts\nawait snaptrude.program.cores.create([\n{ type: \"lift\", position: { x: 0, y: 0, z: 0 }, width: 3, depth: 4 },\n])\n```"
-    ],
-    "argsType": "PluginProgramCoreSpec[]",
-    "resultType": "PluginProgramCoresCreateResult"
-  },
   {
     "path": "program.cores.isCore",
     "namespace": "program.cores",