@ifc-lite/viewer 1.19.0 → 1.19.1

package/src/components/mcp/playground-files.ts

@@ -0,0 +1,107 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+
+/**
+ * playground-files.ts — virtual file store for the playground.
+ *
+ * Tools that "write a file" (bcf_export, model_save, export_ifc / csv /
+ * json) DON'T trigger a browser download — that would be a surprising
+ * privacy issue and against the user's explicit "never auto-download"
+ * rule. Instead they push the artifact into this store, which a
+ * Downloads panel in the playground sidebar lists with a per-row
+ * "Download" button. The actual `Blob` → `<a download>` click only
+ * happens when the user presses that button.
+ */
+import { useEffect, useState } from 'react';
+
+export interface PlaygroundFile {
+  /** Stable id used by tools to refer back to a written artifact. */
+  id: string;
+  /** Suggested filename used when the user clicks Download. */
+  filename: string;
+  /** MIME type for the download Blob. */
+  mimeType: string;
+  /** Bytes — read once, cheap. */
+  size: number;
+  /** The data. */
+  blob: Blob;
+  /** ms since epoch. */
+  createdAt: number;
+  /** Tool that produced it (`bcf_export`, `model_save`, …). */
+  source: string;
+  /** Free-form line shown under the filename in the UI. */
+  description?: string;
+}
+
+class FileStore {
+  private files: PlaygroundFile[] = [];
+  private listeners = new Set<() => void>();
+  private nextId = 1;
+
+  add(input: Omit<PlaygroundFile, 'id' | 'createdAt'>): PlaygroundFile {
+    const file: PlaygroundFile = {
+      ...input,
+      id: `pg-file-${this.nextId++}`,
+      createdAt: Date.now(),
+    };
+    this.files = [file, ...this.files];
+    this.notify();
+    return file;
+  }
+
+  list(): PlaygroundFile[] {
+    return this.files;
+  }
+
+  remove(id: string): void {
+    this.files = this.files.filter((f) => f.id !== id);
+    this.notify();
+  }
+
+  clear(): void {
+    this.files = [];
+    this.notify();
+  }
+
+  /** User-triggered. Synthesises an <a download> click — never called by
+   *  tool code, only by the explicit Download button. */
+  download(id: string): void {
+    const file = this.files.find((f) => f.id === id);
+    if (!file) return;
+    const url = URL.createObjectURL(file.blob);
+    const a = document.createElement('a');
+    a.href = url;
+    a.download = file.filename;
+    a.style.display = 'none';
+    document.body.appendChild(a);
+    a.click();
+    a.remove();
+    // Revoke after a tick so the browser actually fetched the blob.
+    setTimeout(() => URL.revokeObjectURL(url), 1000);
+  }
+
+  subscribe(listener: () => void): () => void {
+    this.listeners.add(listener);
+    return () => this.listeners.delete(listener);
+  }
+
+  private notify(): void {
+    for (const l of this.listeners) l();
+  }
+}
+
+export const playgroundFiles = new FileStore();
+
+/** React hook for components that want to render the file list reactively. */
+export function usePlaygroundFiles(): PlaygroundFile[] {
+  const [files, setFiles] = useState<PlaygroundFile[]>(() => playgroundFiles.list());
+  useEffect(() => playgroundFiles.subscribe(() => setFiles(playgroundFiles.list())), []);
+  return files;
+}
+
+export function formatBytes(bytes: number): string {
+  if (bytes >= 1024 * 1024) return (bytes / (1024 * 1024)).toFixed(1) + ' MB';
+  if (bytes >= 1024) return (bytes / 1024).toFixed(0) + ' KB';
+  return bytes + ' B';
+}

package/src/components/mcp/playground-uploads.ts

@@ -0,0 +1,122 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+
+/**
+ * playground-uploads.ts — virtual file system for INPUTS the user attaches
+ * to a chat turn (IDS specs, side IFC files for diff, BCF imports later).
+ *
+ * Mirrors the playground-files.ts shape but for the other direction: the
+ * user drops a `.ids` (or any text file) onto the chat textarea, we cache
+ * it here, and tools that take a `*_path` argument (ids_validate,
+ * ids_explain) resolve the path through this store BEFORE asking the agent
+ * to inline the XML. That lifts the "the playground can't read disk" wart
+ * and makes the chat experience continuous.
+ */
+
+import { useEffect, useState } from 'react';
+
+export interface UploadedFile {
+  /** The original filename, used as the lookup key (paths are normalised
+   *  to the basename so the agent can pass `./foo.ids` or just `foo.ids`). */
+  name: string;
+  /** MIME type as the browser saw it. May be empty for `.ids`. */
+  mimeType: string;
+  /** Bytes — for sizing the chip and bounding what we accept. */
+  size: number;
+  /** Text content if the file is text/* — this is the path we use for
+   *  ids_validate. Binaries store an empty string here and put bytes in
+   *  `bytes` (future use; v1 only handles text). */
+  text: string;
+  /** Wall-clock when the user attached it. */
+  uploadedAt: number;
+}
+
+class UploadStore {
+  private uploads: UploadedFile[] = [];
+  private listeners = new Set<() => void>();
+
+  /** Read the file as text and stash it. Returns the entry.
+   *
+   *  We only decode known-text formats — `.bcfzip` and other binaries
+   *  are zip archives whose .text() decode would chew through tens of
+   *  megabytes on the main thread for no user benefit (the playground
+   *  has no read path for binary attachments yet). */
+  async add(file: File): Promise<UploadedFile> {
+    const name = file.name.split(/[\\/]/).pop() ?? file.name;
+    const mimeType = file.type || guessMimeType(name);
+    const text = isTextLike(name, mimeType) ? await file.text() : '';
+    const entry: UploadedFile = {
+      name,
+      mimeType,
+      size: file.size,
+      text,
+      uploadedAt: Date.now(),
+    };
+    // De-dup by basename — re-attaching with the same name overwrites.
+    this.uploads = [entry, ...this.uploads.filter((u) => u.name !== name)];
+    this.notify();
+    return entry;
+  }
+
+  /** Resolve a path-ish string to an upload. Tolerates absolute paths,
+   *  ./relative, and bare filenames. */
+  resolve(pathOrName: string): UploadedFile | null {
+    if (!pathOrName) return null;
+    const base = pathOrName.split(/[\\/]/).pop() ?? pathOrName;
+    return this.uploads.find((u) => u.name === base) ?? null;
+  }
+
+  list(): UploadedFile[] {
+    return this.uploads;
+  }
+
+  remove(name: string): void {
+    this.uploads = this.uploads.filter((u) => u.name !== name);
+    this.notify();
+  }
+
+  clear(): void {
+    this.uploads = [];
+    this.notify();
+  }
+
+  subscribe(listener: () => void): () => void {
+    this.listeners.add(listener);
+    return () => this.listeners.delete(listener);
+  }
+
+  private notify(): void {
+    for (const l of this.listeners) l();
+  }
+}
+
+export const playgroundUploads = new UploadStore();
+
+export function usePlaygroundUploads(): UploadedFile[] {
+  const [uploads, setUploads] = useState<UploadedFile[]>(() => playgroundUploads.list());
+  useEffect(() => playgroundUploads.subscribe(() => setUploads(playgroundUploads.list())), []);
+  return uploads;
+}
+
+/** Whether we should decode this attachment as text. STEP files (.ifc) and
+ *  IDS specs are text under the hood; .bcfzip / arbitrary octet-stream
+ *  attachments are zip archives we only ever surface as references. */
+function isTextLike(name: string, mimeType: string): boolean {
+  if (mimeType.startsWith('text/')) return true;
+  if (mimeType === 'application/json' || mimeType === 'application/xml' || mimeType === 'application/xhtml+xml') return true;
+  const ext = name.toLowerCase().split('.').pop();
+  return ext === 'ifc' || ext === 'ids' || ext === 'csv' || ext === 'tsv' || ext === 'xml' || ext === 'json' || ext === 'txt' || ext === 'md';
+}
+
+function guessMimeType(name: string): string {
+  const ext = name.toLowerCase().split('.').pop() ?? '';
+  switch (ext) {
+    case 'ids': return 'application/xml';
+    case 'xml': return 'application/xml';
+    case 'json': return 'application/json';
+    case 'csv': return 'text/csv';
+    case 'txt': return 'text/plain';
+    default: return 'application/octet-stream';
+  }
+}

package/src/components/mcp/types.ts

@@ -0,0 +1,65 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+
+/**
+ * Shared types for the /mcp landing page variants.
+ *
+ * The catalog shape mirrors what `node packages/mcp/dist/cli.js --dump-tools`
+ * is expected to emit. Until that script lands, the landing pages can fall
+ * back to `MOCK_CATALOG` from ./data.ts so we can iterate on visuals.
+ */
+
+export type ToolScope = 'read' | 'mutate' | 'export';
+
+export type ToolCategory =
+  | 'Discovery'
+  | 'Query'
+  | 'Geometry'
+  | 'Validation'
+  | 'Mutation'
+  | 'BCF'
+  | 'bSDD'
+  | 'Diff'
+  | 'Export'
+  | 'Viewer';
+
+export interface CatalogTool {
+  name: string;
+  description: string;
+  scope: ToolScope;
+  category: ToolCategory;
+  inputSchema: unknown;
+}
+
+export interface McpCatalog {
+  generatedAt?: string;
+  version?: string;
+  tools: CatalogTool[];
+}
+
+export type McpClientId = 'claude-desktop' | 'cursor' | 'windsurf' | 'vscode' | 'goose';
+
+export interface McpClient {
+  id: McpClientId;
+  name: string;
+  /** Short blurb shown under the button title. */
+  blurb: string;
+  /** Path to a logo image inside /public, or null if we render a glyph. */
+  logo?: string;
+  /** Optional deep-link URL scheme prefix (cursor://, windsurf://, vscode:). */
+  deepLinkPrefix?: string;
+  /** Where the user pastes the JSON snippet. */
+  configHint: string;
+}
+
+export interface McpRecipe {
+  id: string;
+  title: string;
+  /** The actual prompt the user copies. */
+  prompt: string;
+  /** Comma-separated tool names this recipe likely fans out to. */
+  uses: string[];
+  /** Visual category for grouping/coloring. */
+  family: 'audit' | 'visualize' | 'validate' | 'author' | 'compare' | 'discover';
+}

package/src/components/mcp/use-mcp-page.ts

@@ -0,0 +1,109 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+
+/**
+ * Tiny utilities shared by every landing-page variant:
+ *
+ *   • useFonts(href)   — injects a Google Fonts <link> only while a /mcp page
+ *                        is mounted, so the global app stays unbothered.
+ *   • useCopyToClipboard() — returns [copy, isJustCopied] for the install
+ *                        snippets and recipe cards.
+ *   • useDocumentMeta(title, themeColor)
+ *                      — keeps <title> / theme-color in sync per variant.
+ *
+ * None of these touch React Suspense / global state — they’re plain
+ * useEffect plumbing so the variants can be lifted out of the chooser
+ * without surprises.
+ */
+
+import { useEffect, useState } from 'react';
+
+/** Inject a stylesheet <link> while this hook is mounted. Idempotent. */
+export function useFonts(...hrefs: string[]): void {
+  useEffect(() => {
+    const tags: HTMLLinkElement[] = [];
+    for (const href of hrefs) {
+      const existing = document.head.querySelector(`link[data-mcp-font="${href}"]`);
+      if (existing) {
+        // Already injected by another variant — refcount via a data attribute.
+        const refs = Number(existing.getAttribute('data-refs') ?? '1') + 1;
+        existing.setAttribute('data-refs', String(refs));
+        tags.push(existing as HTMLLinkElement);
+        continue;
+      }
+      const link = document.createElement('link');
+      link.rel = 'stylesheet';
+      link.href = href;
+      link.setAttribute('data-mcp-font', href);
+      link.setAttribute('data-refs', '1');
+      document.head.appendChild(link);
+      tags.push(link);
+    }
+    return () => {
+      for (const tag of tags) {
+        const refs = Number(tag.getAttribute('data-refs') ?? '1') - 1;
+        if (refs <= 0) tag.parentNode?.removeChild(tag);
+        else tag.setAttribute('data-refs', String(refs));
+      }
+    };
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [hrefs.join('|')]);
+}
+
+/** Browser-safe clipboard with a 1.4s "just copied" indicator. */
+export function useCopyToClipboard(): {
+  copy: (text: string, key?: string) => Promise<void>;
+  copiedKey: string | null;
+} {
+  const [copiedKey, setCopiedKey] = useState<string | null>(null);
+  return {
+    copiedKey,
+    copy: async (text: string, key?: string) => {
+      try {
+        await navigator.clipboard.writeText(text);
+        setCopiedKey(key ?? text);
+        setTimeout(() => setCopiedKey((curr) => (curr === (key ?? text) ? null : curr)), 1400);
+      } catch {
+        // Older browsers — fall through silently. The install dialogs always
+        // show the snippet anyway so the user can manually select+copy.
+      }
+    },
+  };
+}
+
+/** Set <title> + theme-color while mounted; restore on unmount. */
+export function useDocumentMeta(title: string, themeColor?: string): void {
+  useEffect(() => {
+    const prevTitle = document.title;
+    document.title = title;
+    let prevTheme: string | null = null;
+    let prevThemeExisted = false;
+    let themeMeta: HTMLMetaElement | null = null;
+    if (themeColor) {
+      themeMeta = document.querySelector('meta[name="theme-color"]');
+      if (themeMeta) {
+        // Track existence separately so a meta tag without `content`
+        // doesn't permanently keep our temporary color after unmount.
+        prevThemeExisted = themeMeta.hasAttribute('content');
+        prevTheme = themeMeta.getAttribute('content');
+        themeMeta.setAttribute('content', themeColor);
+      }
+    }
+    return () => {
+      document.title = prevTitle;
+      if (themeMeta) {
+        if (prevThemeExisted && prevTheme !== null) themeMeta.setAttribute('content', prevTheme);
+        else themeMeta.removeAttribute('content');
+      }
+    };
+  }, [title, themeColor]);
+}
+
+/** Smooth-scroll to an in-page anchor; updates the URL hash. */
+export function scrollToAnchor(id: string): void {
+  const el = document.getElementById(id);
+  if (!el) return;
+  el.scrollIntoView({ behavior: 'smooth', block: 'start' });
+  history.replaceState(null, '', `#${id}`);
+}

package/src/components/viewer/MainToolbar.tsx

@@ -24,6 +24,7 @@ import {
   ArrowRight,
   Box,
   HelpCircle,
+  Sparkles,
   Loader2,
   Camera,
   Info,
@@ -1333,6 +1334,24 @@ export function MainToolbar({ onShowShortcuts }: MainToolbarProps = {} as MainTo
 
       {/* Right Side Actions */}
       <div className="flex items-center gap-2 ml-2 pl-2 border-l border-zinc-200 dark:border-zinc-700/60">
+        {/* /mcp cross-link — lives in the meta cluster (Settings / Theme /
+            Help) so it shares space with shell-level navigation rather
+            than competing with the modeling tools to its left. */}
+        <Tooltip>
+          <TooltipTrigger asChild>
+            <Button
+              variant="ghost"
+              size="icon"
+              className="rounded-full"
+              onClick={() => navigateToPath('/mcp')}
+              aria-label="Open ifc-lite MCP"
+            >
+              <Sparkles className="!h-[20px] !w-[20px]" />
+            </Button>
+          </TooltipTrigger>
+          <TooltipContent>Drive ifc-lite from any LLM (MCP)</TooltipContent>
+        </Tooltip>
+
         {desktopShell ? (
           <Tooltip>
             <TooltipTrigger asChild>

package/src/components/viewer/ViewportContainer.tsx

@@ -22,7 +22,7 @@ import { cacheFileBlobs, formatFileSize, getCachedFile, getRecentFiles, recordRe
 import { isTauri } from '@/lib/platform';
 import { toast } from '@/components/ui/toast';
 import { describeUnsupportedFormat } from '@/hooks/ingest/pointCloudIngest';
-import { Upload, MousePointer, Layers, Info, Command, AlertTriangle, ChevronDown, ExternalLink, Plus, Clock3 } from 'lucide-react';
+import { Upload, MousePointer, Layers, Info, Command, AlertTriangle, ChevronDown, ExternalLink, Plus, Clock3, Sparkles, ArrowUpRight } from 'lucide-react';
 import type { MeshData, CoordinateInfo, GeometryResult, PointCloudAsset } from '@ifc-lite/geometry';
 import { type IfcDataStore } from '@ifc-lite/parser';
 import { getEffectiveGeoreference } from '@/lib/geo/effective-georef';
@@ -735,10 +735,18 @@ export function ViewportContainer() {
               IFClite
             </h2>
             <p className="text-zinc-500 dark:text-[#565f89] font-mono text-sm text-center mb-8 border-b border-zinc-200 dark:border-[#3b4261] pb-4 w-full">
-              High-performance web viewer demo
+              IFC toolkit for the open web
             </p>
 
-            {/* Action */}
+            {/*
+              Two-track action area: a primary "open file" track and a
+              secondary "drive with LLM" track sit in mirrored slots — same
+              width, same vertical rhythm, each followed by its own caption
+              line. Reads as one balanced composition instead of a primary
+              CTA + a tacked-on link, while keeping the file-open path
+              visually dominant via the filled-on-hover treatment.
+            */}
+            {/* Track 1 — open / drag */}
             <button
               onClick={async () => {
                 if (!webgpu.supported) {
@@ -774,10 +782,33 @@ export function ViewportContainer() {
               <span>{webgpu.checking ? 'Checking WebGPU...' : webgpu.supported ? 'Open .ifc file' : 'WebGPU Required'}</span>
             </button>
 
-            <p className="mt-3 text-xs font-mono text-zinc-400 dark:text-[#565f89]">
+            <p className="mt-2.5 text-[11px] font-mono text-center text-zinc-400 dark:text-[#565f89]">
               {webgpu.supported ? 'or drag & drop anywhere' : 'file upload disabled'}
             </p>
 
+            {/* Subtle "or" rule — anchors the symmetry between the two tracks */}
+            <div className="mt-5 mb-5 w-full flex items-center gap-3 text-[10px] font-mono uppercase tracking-[0.22em] text-zinc-400 dark:text-[#565f89]">
+              <span className="h-px flex-1 bg-zinc-200 dark:bg-[#3b4261]" />
+              <span>or</span>
+              <span className="h-px flex-1 bg-zinc-200 dark:bg-[#3b4261]" />
+            </div>
+
+            {/* Track 2 — agent / MCP. Compact inline pill, self-centred so
+                it reads as a meta-link sibling to the primary file-open
+                CTA, not a competing full-width button. */}
+            <a
+              href="/mcp"
+              className="group inline-flex self-center items-center gap-1.5 px-3 py-1.5 font-mono text-[11px] border border-dashed border-zinc-300 dark:border-[#3b4261] text-zinc-500 dark:text-[#7a82a5] hover:border-primary hover:text-primary transition-all cursor-pointer"
+            >
+              <Sparkles className="h-3 w-3 transition-transform group-hover:-translate-y-0.5" />
+              <span>Drive with any LLM</span>
+              <ArrowUpRight className="h-2.5 w-2.5 opacity-60 transition-transform group-hover:translate-x-0.5 group-hover:-translate-y-0.5" />
+            </a>
+
+            <p className="mt-1.5 text-[10px] font-mono text-center text-zinc-400 dark:text-[#565f89]">
+              via MCP · install or try the playground
+            </p>
+
             {recentFiles.length > 0 && (
               <div className="mt-6 w-full border-t border-zinc-200 dark:border-[#3b4261] pt-4">
                 <div className="mb-3 flex items-center gap-2 text-xs font-mono uppercase tracking-[0.2em] text-zinc-400 dark:text-[#565f89]">

package/src/generated/mcp-catalog.json

@@ -0,0 +1,82 @@
+{
+  "generatedAt": "2026-05-03T09:30:00Z",
+  "version": "0.1.0",
+  "tools": [
+    { "name": "model_info",          "category": "Discovery",  "scope": "read",   "description": "Schema, entity counts, units, georeferencing — the at-a-glance summary of a loaded IFC.", "inputSchema": { "type": "object", "properties": { "model_id": { "type": "string" } } } },
+    { "name": "model_list",          "category": "Discovery",  "scope": "read",   "description": "List every model loaded in the current MCP session.", "inputSchema": { "type": "object" } },
+    { "name": "model_load",          "category": "Discovery",  "scope": "mutate", "description": "Load an additional .ifc from disk into the federated session.", "inputSchema": { "type": "object", "required": ["file_path"], "properties": { "file_path": { "type": "string" }, "model_id": { "type": "string" } } } },
+    { "name": "model_unload",        "category": "Discovery",  "scope": "mutate", "description": "Drop a model from the registry; frees memory.", "inputSchema": { "type": "object", "required": ["model_id"], "properties": { "model_id": { "type": "string" } } } },
+    { "name": "schema_describe",     "category": "Discovery",  "scope": "read",   "description": "Attributes, parent class, and inheritance for any IfcType — useful before mutating.", "inputSchema": { "type": "object", "required": ["type"], "properties": { "type": { "type": "string" }, "include_inherited": { "type": "boolean" } } } },
+
+    { "name": "query_entities",      "category": "Query",      "scope": "read",   "description": "Type + property filters with pagination. Returns expressId, GlobalId, name, type for each match.", "inputSchema": { "type": "object", "properties": { "type": { "type": "string" }, "limit": { "type": "integer" } } } },
+    { "name": "count_entities",      "category": "Query",      "scope": "read",   "description": "Group counts by type, storey, or material — histogram form, not the full set.", "inputSchema": { "type": "object", "properties": { "group_by": { "type": "string", "enum": ["type", "storey", "material"] } } } },
+    { "name": "get_entity",          "category": "Query",      "scope": "read",   "description": "Full attributes + property sets for one entity by GlobalId or expressId.", "inputSchema": { "type": "object", "properties": { "global_id": { "type": "string" }, "express_id": { "type": "integer" } } } },
+    { "name": "get_entities_bulk",   "category": "Query",      "scope": "read",   "description": "Batched get_entity for up to 200 ids at once.", "inputSchema": { "type": "object", "required": ["global_ids"], "properties": { "global_ids": { "type": "array", "items": { "type": "string" } } } } },
+    { "name": "spatial_hierarchy",   "category": "Query",      "scope": "read",   "description": "Project → site → building → storey → space tree, with element counts at each node.", "inputSchema": { "type": "object" } },
+    { "name": "containment_chain",   "category": "Query",      "scope": "read",   "description": "Walk up the spatial chain for one entity (storey + parent + grandparent…).", "inputSchema": { "type": "object", "required": ["global_id"] } },
+    { "name": "relationships",       "category": "Query",      "scope": "read",   "description": "Voids, fills, groups, connections — every IfcRel touching this entity.", "inputSchema": { "type": "object", "required": ["global_id"] } },
+    { "name": "properties_unique",   "category": "Query",      "scope": "read",   "description": "Unique values + counts for one property across a type set (perfect for filter UIs).", "inputSchema": { "type": "object", "required": ["type", "pset", "property"] } },
+    { "name": "materials_list",      "category": "Query",      "scope": "read",   "description": "Distinct materials across the model with usage counts.", "inputSchema": { "type": "object" } },
+    { "name": "classifications_list","category": "Query",      "scope": "read",   "description": "Distinct classification references (system + identification) and how often each is used.", "inputSchema": { "type": "object" } },
+    { "name": "georeferencing",      "category": "Query",      "scope": "read",   "description": "MapConversion, projected CRS, project north, true north — the geo handshake.", "inputSchema": { "type": "object" } },
+    { "name": "units",               "category": "Query",      "scope": "read",   "description": "Length unit scale + the unit assignments declared in the file.", "inputSchema": { "type": "object" } },
+
+    { "name": "geometry_bbox",       "category": "Geometry",   "scope": "read",   "description": "Per-entity axis-aligned bounding box (read from quantity sets when available).", "inputSchema": { "type": "object", "required": ["global_id"] } },
+    { "name": "geometry_volume",     "category": "Geometry",   "scope": "read",   "description": "Net/gross volume in m³ for a single entity or a type aggregate.", "inputSchema": { "type": "object", "required": ["global_id"] } },
+    { "name": "geometry_area",       "category": "Geometry",   "scope": "read",   "description": "Surface area for an entity (front/side/footprint depending on what the IFC carries).", "inputSchema": { "type": "object", "required": ["global_id"] } },
+
+    { "name": "model_audit",         "category": "Validation", "scope": "read",   "description": "Out-of-the-box health score + a list of issues (missing GlobalIds, broken refs, orphan entities).", "inputSchema": { "type": "object" } },
+    { "name": "ids_validate",        "category": "Validation", "scope": "read",   "description": "Run a buildingSMART IDS spec against the loaded model. Per-spec pass/fail with offending entities.", "inputSchema": { "type": "object", "required": ["ids_path"], "properties": { "ids_path": { "type": "string" } } } },
+    { "name": "ids_explain",         "category": "Validation", "scope": "read",   "description": "Parse + summarize an IDS file in plain language — what each spec asks for, in what order.", "inputSchema": { "type": "object", "required": ["ids_path"] } },
+
+    { "name": "entity_set_property", "category": "Mutation",   "scope": "mutate", "description": "Queue a Pset.property write on one entity. Persist later via export_ifc / model_save.", "inputSchema": { "type": "object", "required": ["pset", "name"] } },
+    { "name": "entity_delete_property", "category": "Mutation","scope": "mutate", "description": "Queue a property removal from a Pset. Reversible via mutation_undo.", "inputSchema": { "type": "object", "required": ["pset", "name"] } },
+    { "name": "entity_set_attribute","category": "Mutation",   "scope": "mutate", "description": "Set Name, Description, ObjectType, or Tag on an entity.", "inputSchema": { "type": "object", "required": ["attribute", "value"] } },
+    { "name": "entity_create",       "category": "Mutation",   "scope": "mutate", "description": "Create a new IFC entity with raw STEP attributes and get back its expressId.", "inputSchema": { "type": "object", "required": ["type"] } },
+    { "name": "entity_delete",       "category": "Mutation",   "scope": "mutate", "description": "Delete an entity by expressId/GlobalId. Caller is responsible for cascading rels.", "inputSchema": { "type": "object" } },
+    { "name": "mutation_batch",      "category": "Mutation",   "scope": "mutate", "description": "Apply N mutation ops in order, returning per-step results.", "inputSchema": { "type": "object", "required": ["operations"] } },
+    { "name": "mutation_diff",       "category": "Mutation",   "scope": "read",   "description": "Inspect every queued mutation vs the original parsed state.", "inputSchema": { "type": "object" } },
+    { "name": "mutation_undo",       "category": "Mutation",   "scope": "mutate", "description": "Pop the last N pending mutations off the queue.", "inputSchema": { "type": "object", "properties": { "n": { "type": "integer" } } } },
+    { "name": "model_save",          "category": "Mutation",   "scope": "mutate", "description": "Write the current model (with pending mutations) back to .ifc.", "inputSchema": { "type": "object", "required": ["file_path"] } },
+
+    { "name": "bcf_topic_list",      "category": "BCF",        "scope": "read",   "description": "List BCF topics in this session, optionally filtered by status.", "inputSchema": { "type": "object" } },
+    { "name": "bcf_topic_create",    "category": "BCF",        "scope": "mutate", "description": "Create a topic with title/description/priority and get the GUID for follow-ups.", "inputSchema": { "type": "object", "required": ["title"] } },
+    { "name": "bcf_topic_update",    "category": "BCF",        "scope": "mutate", "description": "Update topic fields or append a comment.", "inputSchema": { "type": "object", "required": ["guid"] } },
+    { "name": "bcf_topic_close",     "category": "BCF",        "scope": "mutate", "description": "Mark a topic resolved (status=Closed).", "inputSchema": { "type": "object", "required": ["guid"] } },
+    { "name": "bcf_viewpoint_create","category": "BCF",        "scope": "mutate", "description": "Attach a selection-based viewpoint (or full viewer state) to a topic.", "inputSchema": { "type": "object", "required": ["guid"] } },
+    { "name": "bcf_export",          "category": "BCF",        "scope": "export", "description": "Export the in-memory BCF project as a .bcfzip file.", "inputSchema": { "type": "object", "required": ["file_path"] } },
+
+    { "name": "bsdd_search",         "category": "bSDD",       "scope": "read",   "description": "Full-text search the buildingSMART Data Dictionary for classes by keyword.", "inputSchema": { "type": "object", "required": ["query"] } },
+    { "name": "bsdd_class",          "category": "bSDD",       "scope": "read",   "description": "Full bSDD class info for an IFC entity name (definition, parent, properties).", "inputSchema": { "type": "object", "required": ["ifc_type"] } },
+    { "name": "bsdd_property_sets",  "category": "bSDD",       "scope": "read",   "description": "Pset_* groups for an IFC type (Pset_WallCommon for IfcWall, etc.).", "inputSchema": { "type": "object", "required": ["ifc_type"] } },
+    { "name": "bsdd_match",          "category": "bSDD",       "scope": "read",   "description": "Suggest matching bSDD classes for an entity in the loaded model.", "inputSchema": { "type": "object" } },
+
+    { "name": "model_diff",          "category": "Diff",       "scope": "read",   "description": "Compare two loaded models. Reports added/removed entities by GlobalId and per-type count deltas.", "inputSchema": { "type": "object", "required": ["a", "b"] } },
+    { "name": "quantity_diff",       "category": "Diff",       "scope": "read",   "description": "Per-entity-type quantity comparison between two models, optionally grouped by storey.", "inputSchema": { "type": "object", "required": ["a", "b"] } },
+
+    { "name": "export_ifc",          "category": "Export",     "scope": "export", "description": "Write the model (with pending mutations) to .ifc/.ifczip on disk.", "inputSchema": { "type": "object", "required": ["file_path"] } },
+    { "name": "export_csv",          "category": "Export",     "scope": "export", "description": "Tabular property/quantity export. Columns may be Pset_X.Property paths.", "inputSchema": { "type": "object" } },
+    { "name": "export_json",         "category": "Export",     "scope": "export", "description": "Structured JSON dump of attributes/properties/quantities for a type set.", "inputSchema": { "type": "object" } },
+    { "name": "export_glb",          "category": "Export",     "scope": "export", "description": "(v0.2) Geometry export to glTF binary — needs the WASM mesh pipeline.", "inputSchema": { "type": "object" } },
+    { "name": "export_ifcx",         "category": "Export",     "scope": "export", "description": "(v0.2) Export to the new IFCx interchange format.", "inputSchema": { "type": "object" } },
+    { "name": "export_pdf_report",   "category": "Export",     "scope": "export", "description": "(v0.5) Branded PDF audit report with charts.", "inputSchema": { "type": "object" } },
+
+    { "name": "viewer_ask",          "category": "Viewer",     "scope": "read",   "description": "Suggest wording the agent can use to ask the user for permission to open the viewer.", "inputSchema": { "type": "object" } },
+    { "name": "viewer_open",         "category": "Viewer",     "scope": "read",   "description": "Boot the in-process WebGL viewer and return its URL for the user to open.", "inputSchema": { "type": "object" } },
+    { "name": "viewer_close",        "category": "Viewer",     "scope": "read",   "description": "Stop the viewer + clear its selection state.", "inputSchema": { "type": "object" } },
+    { "name": "viewer_status",       "category": "Viewer",     "scope": "read",   "description": "Report whether the viewer is open, on what port, and the current selection.", "inputSchema": { "type": "object" } },
+    { "name": "viewer_colorize",     "category": "Viewer",     "scope": "read",   "description": "Paint a set of entities with a color (hex / rgb / named).", "inputSchema": { "type": "object", "required": ["color"] } },
+    { "name": "viewer_isolate",      "category": "Viewer",     "scope": "read",   "description": "Hide everything except the picked set.", "inputSchema": { "type": "object" } },
+    { "name": "viewer_hide",         "category": "Viewer",     "scope": "read",   "description": "Hide the picked set; everything else stays.", "inputSchema": { "type": "object" } },
+    { "name": "viewer_show",         "category": "Viewer",     "scope": "read",   "description": "Show the picked set (un-hide).", "inputSchema": { "type": "object" } },
+    { "name": "viewer_reset",        "category": "Viewer",     "scope": "read",   "description": "Reset visibility + colors to the model defaults.", "inputSchema": { "type": "object" } },
+    { "name": "viewer_fly_to",       "category": "Viewer",     "scope": "read",   "description": "Frame the camera on a set of entities or a bbox.", "inputSchema": { "type": "object" } },
+    { "name": "viewer_set_section",  "category": "Viewer",     "scope": "read",   "description": "Apply an axis-aligned section plane.", "inputSchema": { "type": "object", "required": ["axis", "position"] } },
+    { "name": "viewer_clear_section","category": "Viewer",     "scope": "read",   "description": "Remove the active section plane.", "inputSchema": { "type": "object" } },
+    { "name": "viewer_color_by_storey","category": "Viewer",   "scope": "read",   "description": "Apply a per-storey overlay (built-in viewer preset).", "inputSchema": { "type": "object" } },
+    { "name": "viewer_color_by_property","category": "Viewer", "scope": "read",   "description": "Color a type set by property value, returns a legend the agent can describe.", "inputSchema": { "type": "object", "required": ["type", "pset", "property"] } },
+    { "name": "viewer_get_selection","category": "Viewer",     "scope": "read",   "description": "Return the current selection — type, expressId, GlobalId, name, attributes, materials.", "inputSchema": { "type": "object" } },
+    { "name": "viewer_describe_selection","category": "Viewer","scope": "read",   "description": "Kitchen-sink: every section (attributes, properties, quantities, classifications, materials) for the picked entity.", "inputSchema": { "type": "object" } },
+    { "name": "viewer_wait_for_selection","category": "Viewer","scope": "read",   "description": "Block until the user picks something in the viewer (or timeout).", "inputSchema": { "type": "object" } }
+  ]
+}

package/vite.config.ts

@@ -313,6 +313,12 @@ export default defineConfig({
           if (id.includes('/node_modules/apache-arrow/')) return 'arrow';
           if (id.includes('/node_modules/parquet-wasm/')) return 'parquet';
           if (id.includes('/node_modules/cesium/')) return 'cesium';
+          // three.js + addons — only the /mcp landing imports them, keep
+          // the main viewer / pages off the hook.
+          if (
+            id.includes('/node_modules/three/') ||
+            id.includes('/node_modules/.pnpm/three@')
+          ) return 'three';
           return undefined;
         },
       },

package/dist/assets/basketViewActivator-RZy5c3Td.js

@@ -1 +0,0 @@
-import{u as o}from"./index-BOi3BuUI.js";import"./cesium-DUOzBlqv.js";import"./arrow-CZ5kQ26f.js";import"./exporters-BraHBeoi.js";import"./bcf-DOG9_WPX.js";import"./zip-DBEtpeu6.js";import"./sandbox-Baez7n-t.js";import"./lens-CSASnhAL.js";import"./drawing-2d-DoxKMqbO.js";import"./server-client-BB6cMAXE.js";import"./ids-DQ5jY0E8.js";const n=700;function v(s){const e=o.getState(),i=e.basketViews.find(t=>t.id===s);if(i){if(e.setDrawing2D(null),e.setDrawing2DPanelVisible(!1),e.updateDrawing2DDisplayOptions({show3DOverlay:!1}),e.clearEntitySelection(),e.restoreBasketEntities(i.entityRefs,s),i.viewpoint){const t=i.transitionMs??n;e.cameraCallbacks.applyViewpoint?.(i.viewpoint,!0,t)}if(i.section){const t=i.section;o.setState({sectionPlane:{...t.plane},drawing2DPanelVisible:!1}),t.plane.enabled?(e.activeTool!=="section"&&e.setSuppressNextSection2DPanelAutoOpen(!0),e.setActiveTool("section")):e.activeTool==="section"&&e.setActiveTool("select")}else{const t=o.getState().sectionPlane;o.setState({sectionPlane:{...t,enabled:!1}}),e.activeTool==="section"&&e.setActiveTool("select")}}}export{v as activateBasketViewFromStore};